← Back to branch summary

~loggerhead-team/loggerhead/trunk-rich

« back to all changes in this revision

Viewing changes to README.txt

  • Committer: Martin Pool
  • Date: 2009-03-10 01:05:08 UTC
  • mfrom: (262.2.6 loggerhead-plugin)
  • Revision ID: mbp@sourcefrog.net-20090310010508-rvs68o2223720rxn
loggerhead can now be installed as a plugin and run by 'bzr serve --http'

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.txt
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
 
39
58
 
40
59
USING A CONFIG FILE
41
60
-------------------
76
95
configuration is one way to do this::
77
96
 
78
97
    <Location "/branches/">
79
 
        ProxyPass http://127.0.0.1:8080/
80
 
        ProxyPassReverse http://127.0.0.1:8080/
 
98
        ProxyPass http://127.0.0.1:8080/branches/
 
99
        ProxyPassReverse http://127.0.0.1:8080/branches/
81
100
    </Location>
82
101
 
83
102
If Paste Deploy is installed, the 'serve-branches' script can be