You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@allura.apache.org by jo...@apache.org on 2014/01/06 16:18:17 UTC
[27/50] git commit: [#5424] start configuration doc changes
[#5424] start configuration doc changes
Project: http://git-wip-us.apache.org/repos/asf/incubator-allura/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-allura/commit/62213428
Tree: http://git-wip-us.apache.org/repos/asf/incubator-allura/tree/62213428
Diff: http://git-wip-us.apache.org/repos/asf/incubator-allura/diff/62213428
Branch: refs/heads/cj/6992
Commit: 62213428e5d2df120fcd1048c0412c886aa9fc27
Parents: f839811
Author: Dave Brondsema <db...@slashdotmedia.com>
Authored: Tue Nov 19 18:31:22 2013 -0500
Committer: Tim Van Steenburgh <tv...@gmail.com>
Committed: Thu Jan 2 20:22:33 2014 +0000
----------------------------------------------------------------------
Allura/docs/installation.rst | 15 ++++++++++-----
1 file changed, 10 insertions(+), 5 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-allura/blob/62213428/Allura/docs/installation.rst
----------------------------------------------------------------------
diff --git a/Allura/docs/installation.rst b/Allura/docs/installation.rst
index 48d4eef..aaa6de6 100644
--- a/Allura/docs/installation.rst
+++ b/Allura/docs/installation.rst
@@ -18,15 +18,21 @@
Installation
=================
-Installation
----------------
+Install
+-------
Our step-by-step setup instructions are in our INSTALL.markdown file. You can read it online at https://forge-allura.apache.org/p/allura/git/ci/master/tree/INSTALL.markdown You should be able to get Allura up and running in well under an hour by following those instructions.
For a faster and easier setup, see our `Vagrant/VirtualBox installation guide <https://forge-allura.apache.org/p/allura/wiki/Install%20and%20Run%20Allura%20-%20Vagrant/>`_
+Configuring Optional Features
+-----------------------------
+
+The `development.ini` file has many options you can explore and configure. It is geared towards development, so you will want to review
+carefully and make changes for production use.
+
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::
@@ -37,9 +43,8 @@ By default this uses port 8825. Depending on your mail routing, you may need to
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 INSTALL, run these commands
to install rabbitmq and set it up::