~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:40:53 UTC
  • mto: (464.1.1 mod-wsgi)
  • mto: This revision was merged to the branch mainline in revision 465.
  • Revision ID: toshio@fedoraproject.org-20100418174053-2hnyfl74cigmwvgq
Update the setuo.py script to install the new files; update README.mod_wsgi
with all the steps when you install from source

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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