Contents
This is an update of this entry. for feedback, contact mihamina@rktmb.org.
Installation
$ apt-get install roundup
Overview
Installation created a /var/lib/roundup/trackers/ directory whre you are going to install all your roundup instances.
Install a first tracker: "yourtracker"
Now, we are going to install an example tracker named yourtracker
$ roundup-admin install
When prompted:
Enter tracker home: /var/lib/roundup/trackers/yourtracker
Select template [classic]: (just press Enter)
Select backend [anydbm]: sqlite
/var/lib/roundup/trackers/yourtracker/config.ini has been created during this process.
Configure "yourtracker"
Edit /var/lib/roundup/trackers/yourtracker/config.ini: Pay a special attention at tracker and mail sections.
"tracker" section
Roudup uses email notifications. This web variable will be the URL mentionned in emails. This should be correct.
"mail" section
- domain: put the domain name of your server
- host: put the hostname of the SMTP server you'll use
Initialise "yourtracker" from configuration
$ roundup-admin initialise
Enter tracker home: /var/lib/roundup/trackers/yourtracker
- Admin Password: *****
- Confirm: *****
Make the system see it
When system boots up, you may wish the roundup init.d script to launch "yourtracker".
Edit /etc/roundup/roundup-server.ini
[main] port = 8088 hostname = localhost user = roundup pidfile = /var/run/roundup/server.pid logfile = /var/log/roundup/roundup.log [trackers] yourtracker = /var/lib/roundup/trackers/yourtracker
Make the database read and writable
chmod -R 777 /var/lib/roundup/trackers/yourtracker/db
Test it
Just go to http://hostname:8088/yourtracker/ with a browser.
In case of trouble
If you get the An error occurred. Please check the server log for more infomation. message, Check /var/log/roundup/roundup.log
When I first setup my roundup instance, I left roundup-admin as admin-email. This adress did not exists, so that when roundup tried to send an email for the first launch, the SMTP connection failed. Roundup raises errors when SMTP transactions fail.