comparison doc/FAQ.txt @ 2338:d9a6918aafd5

simpler proxy instructions
author Richard Jones <richard@users.sourceforge.net>
date Tue, 18 May 2004 22:15:22 +0000
parents f804d466ed91
children 87dc03fa9d80
comparison
equal deleted inserted replaced
2336:258cfa16f63c 2338:d9a6918aafd5
1 =========== 1 ===========
2 Roundup FAQ 2 Roundup FAQ
3 =========== 3 ===========
4 4
5 :Version: $Revision: 1.16 $ 5 :Version: $Revision: 1.17 $
6 6
7 .. contents:: 7 .. contents::
8 8
9 9
10 Installation 10 Installation
30 30
31 31
32 How do I put Roundup behind Apache 32 How do I put Roundup behind Apache
33 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 33 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
34 34
35 We have a project (foo) running on ``foohost.com:8888``. 35 We have a project (foo) running on ``tracker.example:8080``.
36 We want ``http://foohost.com/FooIssues`` to use the roundup server, so we 36 We want ``http://tracker.example/issues`` to use the roundup server, so we
37 set that up on port 8888 on ``foohost.com`` with the ``config.py`` line:: 37 set that up on port 8080 on ``tracker.example`` with the ``config.py`` line::
38 38
39 TRACKER_WEB = 'http://foohost.com/FooIssues/' 39 TRACKER_WEB = 'http://tracker.example/issues/'
40 40
41 We have a "foo_issues" tracker and we run the server with:: 41 We have a "foo_issues" tracker and we run the server with::
42 42
43 roundup-server -p 8888 foo_issues=/home/roundup/trackers/foo_issues 43 roundup-server -p 8080 issues=/home/roundup/trackers/issues
44 44
45 Then, on the Apache machine (eg. redhat 7.3 with apache 1.3), in 45 Then, on the Apache machine (eg. redhat 7.3 with apache 1.3), in
46 ``/etc/httpd/conf/httpd.conf`` uncomment:: 46 ``/etc/httpd/conf/httpd.conf`` uncomment::
47 47
48 LoadModule proxy_module modules/libproxy.so 48 LoadModule proxy_module modules/libproxy.so
49 49
50 and:: 50 and::
51 51
52 AddModule mod_proxy.c 52 AddModule mod_proxy.c
53 53
54 Then add:: 54 Then add
55 55
56 # roundup stuff (added manually) 56 # roundup stuff (added manually)
57 <IfModule mod_proxy.c> 57 <IfModule mod_proxy.c>
58 58 # proxy through one tracker
59 RewriteEngine on 59 ProxyPass /issue/ http://tracker.example:8080/issues/
60 60 # proxy through all tracker(*)
61 # General Roundup 61 #ProxyPass /roundup/ http://tracker.example:8080/
62 RewriteRule ^/Roundup$ Roundup/ [R]
63 RewriteRule ^/Roundup/(.*)$ http://foohost.com:8888/$1 [P,L]
64
65 # Handle Foo Issues
66 RewriteRule ^/FooIssues$ FooIssues/ [R]
67 RewriteRule ^/FooIssues/(.*)$ http://foohost.com:8888/foo_issues/$1 [P,L]
68
69 </IfModule> 62 </IfModule>
70 63
71 Then restart Apache. Now Apache will proxy the request on to the 64 Then restart Apache. Now Apache will proxy the request on to the
72 roundup-server. 65 roundup-server.
73 66
74 You need to add the last 3 RewriteRule lines for each tracker that you have. 67 Note that if you're proxying multiple trackers, you'll need to use the
68 second ProxyPass rule described above. It will mean that your TRACKER_WEB
69 will change to::
75 70
76 You can now firewall off port 8888 from the rest of the world. 71 TRACKER_WEB = 'http://tracker.example/roundup/issues/'
72
73 Once you're done, you can firewall off port 8080 from the rest of the world.
77 74
78 75
79 Roundup runs very slowly on my XP machine when accessed from the Internet 76 Roundup runs very slowly on my XP machine when accessed from the Internet
80 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 77 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
81 78

Roundup Issue Tracker: http://roundup-tracker.org/