diff --git a/INSTALL.txt b/INSTALL.txt
index 74a5ffffc35f661e7a2e7201884e357f64c7ebdf..f0d4eaa8416811aff7dd802ebb80635b5c23bdeb 100644 (file)
--- a/INSTALL.txt
+++ b/INSTALL.txt
roundup-admin@MAIL_DOMAIN - roundup's internal use (problems, etc)
+Note:
+We run the instance as group "issue_tracker" and add the mail and web user
+("mail" and "apache" on our RedHat 7.1 system) to that group, as well as
+any admin people.
+
+
Mail
----
Set up a mail alias called "issue_tracker" as:
- "|/usr/bin/python /home/httpd/html/roundup/roundup-mailgw <instance_home>"
+ "|/usr/bin/python /usr/local/bin/roundup-mailgw <instance_home>"
In some installations (e.g. RedHat 6.2 I think) you'll need to set up smrsh
so sendmail will accept the pipe command. In that case, symlink
-/etc/smrsh/python to /usr/bin/python and change the command to:
- "|python /home/httpd/html/roundup/roundup-mailgw <instance_home>"
+/etc/smrsh/roundup-mailgw to /usr/local/bin/roundup-mailgw and change the
+command to:
+ "|roundup-mailgw <instance_home>"
+
+To test the mail gateway on unix systems, try:
+
+ echo test |mail -s '[issue] test' issue_tracker@your.domain
+
Web Interface
1. Edit roundup-server at the top - ROUNDUP_INSTANCE_HOMES needs to know
about your instance.
2. "roundup-server [hostname port]" (hostname may be "")
- 3. Load up the page "/" using the port number you set.
+ 3. Load up the page "/<instance name>/index" where instance name is the
+ name you nominated in ROUNDUP_INSTANCE_HOMES.
Apache:
1. Make sure roundup.cgi is executable. Edit it at the top -
@@ -107,6 +120,7 @@ RewriteRule ^/roundup/roundup.cgi(.*) /home/httpd/html/roundup/roundup.cgi$1 [e=
------8<------- snip here ------8<-------
note: the RewriteRule must be on one line - no breaks
4. Re-start your apache to re-load the config
- 5. Load up the page "/roundup/roundup.cgi/"
+ 5. Load up the page "/roundup/roundup.cgi/<instance name>/index" where
+ instance name is the name you nominated in ROUNDUP_INSTANCE_HOMES.