From 19307ef60815e0b7aba792b56b18ecc3a34a6407 Mon Sep 17 00:00:00 2001 From: richard Date: Thu, 10 Apr 2003 11:00:44 +0000 Subject: [PATCH] edited FAQ git-svn-id: http://svn.roundup-tracker.org/svnroot/roundup/trunk@1657 57a73879-2fb5-44c3-a270-3262357dd7e2 --- doc/FAQ.txt | 139 +++++++++++++++++++++------------------------------- 1 file changed, 57 insertions(+), 82 deletions(-) diff --git a/doc/FAQ.txt b/doc/FAQ.txt index 3f143d5..da86570 100644 --- a/doc/FAQ.txt +++ b/doc/FAQ.txt @@ -2,9 +2,7 @@ Roundup FAQ =========== -:Version: $Revision: 1.12 $ - -NOTE: This is just a grabbag, most of this should go into documentation. +:Version: $Revision: 1.13 $ .. contents:: @@ -12,59 +10,48 @@ NOTE: This is just a grabbag, most of this should go into documentation. Installation ------------ -Living without a mailserver. -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Living without a mailserver +~~~~~~~~~~~~~~~~~~~~~~~~~~~ Remove the nosy reactor, means delete the tracker file -'detectors/nosyreactor.py'. - - -Rights issues (MISSING) -~~~~~~~~~~~~~~~~~~~~~~~ - -Different jobs run under different users. +``detectors/nosyreactor.py`` from your tracker home. -* Standalone roundup-server is started by whome ? -* Running cgi under apache. +The cgi-bin is very slow! +~~~~~~~~~~~~~~~~~~~~~~~~~ -* roundup-mailgw called via .forward from MTA, or running a cron job - fetching via pop. +Yep, it sure is. It has to start up Python and load all of the support +libraries for *every* request. +The solution is to use the built in server. +To make Roundup more seamless with your website, you may place the built +in server behind apache and link it into your web tree -The cgibin is very slow! -~~~~~~~~~~~~~~~~~~~~~~~~ -Yep, it sure is. It has to do database open/operation/close -_every_ request. -Solution: -* use the built in server -* place the built in server behind apache and link it into your web tree +How do I put Roundup behind Apache +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - -How do I put it behind apache -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -We have a project (foo) running on foohost.com:8888. -We want http://foohost.com/FooIssues to use the roundup server, so we -set that up on port 8888 on foohost.com with the config.py line: +We have a project (foo) running on ``foohost.com:8888``. +We want ``http://foohost.com/FooIssues`` to use the roundup server, so we +set that up on port 8888 on ``foohost.com`` with the ``config.py`` line:: TRACKER_WEB = 'http://foohost.com/FooIssues/' -We have a foo_issues project/tracker configured on roundup and we run the -server with: - ~/bin/roundup-server -p 8888 foo_issues=/home/roundup/trackers/foo_issues +We have a "foo_issues" tracker and we run the server with:: + roundup-server -p 8888 foo_issues=/home/roundup/trackers/foo_issues -Then, on the 'front end' host (redhat 7.3 with apache 1.3), in -/etc/httpd/conf/httpd.conf uncomment: +Then, on the Apache machine (eg. redhat 7.3 with apache 1.3), in +``/etc/httpd/conf/httpd.conf`` uncomment:: LoadModule proxy_module modules/libproxy.so -and + +and:: + AddModule mod_proxy.c -Then add: +Then add:: # roundup stuff (added manually) @@ -84,96 +71,83 @@ Then add: -Then restart apache. - -Now apache will proxy the request on to the roundup server. +Then restart Apache. Now Apache will proxy the request on to the +roundup-server. -Obviously you need to add the last 3 RewriteRule lines for each -project/tracker that you have. +You need to add the last 3 RewriteRule lines for each tracker that you have. You can now firewall off port 8888 from the rest of the world. - - - - Templates --------- -What is that stuff in ~/trackers/foo_issues/html/* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is the template code that roundup uses to display the various pages. - -This is bases upon the template markup language in zope. +What is that stuff in the tracker html directory? +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Have a look at: +This is the template code that Roundup uses to display the various pages. +This is based upon the template markup language in Zope called, oddly +enough "Zope Page Templates". There's documentation in the Roundup +customisation_ documentation. For more information have a look at: http://www.zope.org/Documentation/Books/ZopeBook/current/contents -chapter 5 Using Zope Page Templates -and chapter 9 Advanced Page Templates +specifically chapter 5 "Using Zope Page Templates" and chapter 9 "Advanced +Page Templates". But I just want a select/option list for .... ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Really easy... -Edit issue.item +Really easy... edit ``html/issue.item``. For 'nosy', change line 53 from:: -For 'nosy', change line 53 from: -to + +to:: + -For 'assigned to', change line 61 from: +For 'assigned to', change line 61 from:: + assignedto menu -to: - assignedto menu -get the idea? +to:: + + assignedto menu Great! But now the select/option list is too big ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Thats a little harder (but only a little ;^) -Edit issue.item +Thats a little harder (but only a little ;^) -For nosy, change line 53 from: - (see above) -to - +Again, edit ``html/issue.item``. For nosy, change line 53 from: -and then, like me, go and read about Zope templates. + +to:: + +for more information, go and read about Zope Page Templates. Using Roundup ------------- - I got an error and I cant reload it! ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -If you're using netscape/mozilla, try holding shift and pressing reload. -If you're using IE then install mozilla and try again ;^) - - -I tried changing my password and I got 'invalid one time ticket' or something -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Ok, so I said to use mozilla, well apparently it 'double requests' pages -from roundup. +If you're using Netscape/Mozilla, try holding shift and pressing reload. +If you're using IE then install Mozilla and try again ;^) -This means the first request worked (ie, your request was processed) then -mozilla/galeon/children tried again and that request failed (ie, it tried to -perform an operation using a no longer valid ticket). -Dont worry, it worked. :^) +I keep getting logged out +~~~~~~~~~~~~~~~~~~~~~~~~~ +Make sure that the TRACKER_WEB setting in your tracker's config.py is set +to the URL of the tracker. ----------------- @@ -181,4 +155,5 @@ Dont worry, it worked. :^) Back to `Table of Contents`_ .. _`Table of Contents`: index.html +.. _`customisation`: customisation.html -- 2.30.2