← Back to branch summary

~loggerhead-team/loggerhead/trunk-rich

« back to all changes in this revision

Viewing changes to README.mod_wsgi

https://launchpad.net/bugs/740142
Improve escaping of filenames in revision views. Fixes a couple of XSS holes.

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) Edit /etc/loggerhead/bazaar.conf.  You need to set http_root_dir to the filesystem
7
 
   path that you will find your bzr branches under.  Note that normal
8
 
   directories under that path will also be visible in loggerhead.
9
 
 
10
 
2) Install mod_wsgi.  On Fedora-derived distros::
11
 
     su -c yum install mod_wsgi
12
 
 
13
 
   On Debian-derived distros::
14
 
     sudo apt-get install libapache2-mod-wsgi
15
 
 
16
 
3) Install the apache conf file::
17
 
     # cp /usr/share/doc/loggerhead-*/loggerhead.conf /etc/httpd/conf.d/
18
 
 
19
 
4) Edit /etc/httpd/conf.d/loggerhead.conf to point to the url you desire to
20
 
   serve loggerhead on.  This should match with the setting for
21
 
   http_user_prefix in bazaar.conf
22
 
 
23
 
5) Restart apache and you should be able to start browsing
24
 
 
25
 
.. note:: If you have SELinux enabled on your system you may need to allow
26
 
   apache to execute files in temporary directories.  You will get a
27
 
   MemoryError traceback from python if this is the case.  This is because of
28
 
   the way that python ctypes interacts with libffi.  To rectify this, you may
29
 
   have to do several things, such as mounting tmpdirs so programs can be
30
 
   executed on them and setting this SELinux boolean::
31
 
 
32
 
       setsebool httpd_tmp_exec on
33
 
 
34
 
    This bug has information about how we might solve this issue permanently
35
 
    and links to bugs which diagnose the root cause.
36
 
    https://bugzilla.redhat.com/show_bug.cgi?id=582009