Easy Setup

Our easy setup instructions are in our README.rst file. You can read it online at https://sourceforge.net/p/allura/git/#readme

You should be able to get Allura up and running in well under an hour by following those instructions.

Enabling inbound email

Allura can listen for email messages and update tools and artifacts. For example, every ticket has an email address, and emails sent to that address will be added as comments on the ticket. To set up the SMTP listener, run:

(anvil)~/src/forge/Allura$ nohup paster smtp_server development.ini > ~/logs/smtp.log &

By default this uses port 8825. Depending on your mail routing, you may need to change that port number. And if the port is in use, this command will fail. You can check the log file for any errors. To change the port number, edit development.ini and change forgemail.port to the appropriate port number for your environment.

Enabling RabbitMQ

For faster notification of background jobs, you can use RabbitMQ. Assuming a base setup from the README, run these commands to install rabbitmq and set it up:

(anvil)~$ sudo aptitude install rabbitmq-server
(anvil)~$ sudo rabbitmqctl add_user testuser testpw
(anvil)~$ sudo rabbitmqctl add_vhost testvhost
(anvil)~$ sudo rabbitmqctl set_permissions -p testvhost testuser ""  ".*" ".*"
(anvil)~$ pip install amqplib==0.6.1 kombu==1.0.4

Then edit Allura/development.ini and change amqp.enabled = false to amqp.enabled = true and uncomment the other amqp settings.

If your paster taskd process is still running, restart it:

(anvil)~/src/forge/Allura$ pkill -f taskd
(anvil)~/src/forge/Allura$ nohup paster taskd development.ini > ~/logs/taskd.log &