← Back to branch summary

~loggerhead-team/loggerhead/trunk-rich

« back to all changes in this revision

Viewing changes to README.mod_wsgi

  • Committer: Toshio Kuratomi
  • Date: 2010-04-18 17:55:33 UTC
  • mto: (464.1.1 mod-wsgi)
  • mto: This revision was merged to the branch mainline in revision 465.
  • Revision ID: toshio@fedoraproject.org-20100418175533-bmrymlv9ir7v7jwg
Merge README.mod_wsgi into the installation instructions in docs/index.rst and add mod_wsgi note to NEWS

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.mod_wsgi
1
 
To deploy loggerhead via mod_wsgi, you need to add configuration for apache and
2
 
for bazaar.  Example config files are in the loggerhead doc directory as
3
 
loggerhead.conf and bazaar.conf.  You can copy them into place and use them as
4
 
a starting point if you want.
5
 
 
6
 
1) Install mod_wsgi.  On Fedora-derived distros::
7
 
     su -c yum install mod_wsgi
8
 
 
9
 
   On Debian-derived distros::
10
 
     sudo apt-get install libapache2-mod-wsgi
11
 
 
12
 
2) Copy the bazaar conf file where apache will find it (May be done for you if
13
 
   you installed loggerhead from a distribution package)::
14
 
    # install -d -o apache -g apache -m 0755 /etc/loggerhead
15
 
    # cp -p /usr/share/doc/loggerhead*/bazaar.conf /etc/loggerhead/
16
 
 
17
 
3) Create the cache directory (May be done for you if you installed loggerhead
18
 
   from a distribution package)::
19
 
    # install -d -o apache -g apache -m 0700 /var/cache/loggerhead/
20
 
 
21
 
4) Edit /etc/loggerhead/bazaar.conf.  You need to set http_root_dir to the filesystem
22
 
   path that you will find your bzr branches under.  Note that normal
23
 
   directories under that path will also be visible in loggerhead.
24
 
 
25
 
5) Install the apache conf file::
26
 
     # cp -p /usr/share/doc/loggerhead*/apache-loggerhead.conf /etc/httpd/conf.d/loggerhead.conf
27
 
 
28
 
6) Edit /etc/httpd/conf.d/loggerhead.conf to point to the url you desire to
29
 
   serve loggerhead on.  This should match with the setting for
30
 
   http_user_prefix in bazaar.conf
31
 
 
32
 
7) Restart apache and you should be able to start browsing
33
 
 
34
 
.. note:: If you have SELinux enabled on your system you may need to allow
35
 
   apache to execute files in temporary directories.  You will get a
36
 
   MemoryError traceback from python if this is the case.  This is because of
37
 
   the way that python ctypes interacts with libffi.  To rectify this, you may
38
 
   have to do several things, such as mounting tmpdirs so programs can be
39
 
   executed on them and setting this SELinux boolean::
40
 
 
41
 
       setsebool httpd_tmp_exec on
42
 
 
43
 
    This bug has information about how we might solve this issue permanently
44
 
    and links to bugs which diagnose the root cause.
45
 
    https://bugzilla.redhat.com/show_bug.cgi?id=582009