~loggerhead-team/loggerhead/trunk-rich

« back to all changes in this revision

Viewing changes to README.txt

  • Committer: Michael Hudson
  • Date: 2008-09-12 04:36:49 UTC
  • mfrom: (222 trunk)
  • mto: This revision was merged to the branch mainline in revision 223.
  • Revision ID: michael.hudson@canonical.com-20080912043649-cyvkx902q1iy3n62
merge test fix from trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
13
13
 
14
14
Loggerhead depends on 
15
15
1) SimpleTAL for templating.
16
 
   on Ubuntu package `sudo apt-get install python-simpletal`
 
16
   on ubuntu package `sudo apt-get install python-simpletal`
17
17
   or download from http://www.owlfish.com/software/simpleTAL/download.html
18
18
2) Paste for the server. (You need version 1.2 or newer of Paste.) 
19
 
   on Ubuntu package `sudo apt-get install python-paste`
 
19
   on ubuntu package `sudo apt-get install python-paste`
20
20
   or use `easy_install Paste`
21
21
3) Paste Deploy  (optional, needed when proxying through Apache)
22
 
   on Ubuntu package `sudo apt-get install python-pastedeploy`
 
22
   on ubuntu package `sudo apt-get install python-pastedeploy`
23
23
   or use `easy_install PasteDeploy`
24
24
 
25
25
Then simply run the 'serve-branches' with the branch you want to
36
36
Loggerhead will notice and refresh, and Bazaar uses its own branch
37
37
locking to prevent corruption.
38
38
 
39
 
To run loggerhead as a linux daemon: 
40
 
1) Copy loggerheadd to /etc/init.d
41
 
2) Edit the file to configure where your loggerhead is installed, and which
42
 
   serve-branches options you would like.
43
 
3) Register the service
44
 
   cd /etc/init.d
45
 
   a) on upstart based systems like Ubuntu run: 
46
 
      update-rc.d loggerheadd defaults
47
 
   b) on Sysvinit based systems like Centos or SuSE run:
48
 
      chkconfig --add loggerheadd
49
 
 
50
 
 
51
 
LOGGERHEAD AS A BAZAAR PLUGIN
52
 
-----------------------------
53
 
 
54
 
This branch contains experimental support for using Loggerhead as a Bazaar
55
 
plugin.  To use it, place the top-level Loggerhead directory (the one
56
 
containing this file) at ``~/.bazaar/plugins/loggerhead``.
57
 
 
58
39
 
59
40
USING A CONFIG FILE
60
41
-------------------
95
76
configuration is one way to do this::
96
77
 
97
78
    <Location "/branches/">
98
 
        ProxyPass http://127.0.0.1:8080/branches/
99
 
        ProxyPassReverse http://127.0.0.1:8080/branches/
 
79
        ProxyPass http://127.0.0.1:8080/
 
80
        ProxyPassReverse http://127.0.0.1:8080/
100
81
    </Location>
101
82
 
102
83
If Paste Deploy is installed, the 'serve-branches' script can be