Installation
=================

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 &