allura-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [2/2] git commit: [#7316] use real path and port numbers for the vagrant box
Date Fri, 18 Apr 2014 18:37:04 GMT
[#7316] use real path and port numbers for the vagrant box

Real examples mean the vagrant users don't have to guess in this section.
Users of non-vagrant installs can derive their own values from the concrete
examples given.


Branch: refs/heads/db/7316
Commit: 547f4c62e0ba2223c7ef091edeb2edb7306b8002
Parents: 67040ad
Author: Dave Brondsema <>
Authored: Fri Apr 18 14:34:27 2014 -0400
Committer: Dave Brondsema <>
Committed: Fri Apr 18 14:36:51 2014 -0400

 Allura/docs/scm_host.rst | 31 ++++++++++++++++++++++++-------
 1 file changed, 24 insertions(+), 7 deletions(-)
diff --git a/Allura/docs/scm_host.rst b/Allura/docs/scm_host.rst
index 89c8108..386fb69 100644
--- a/Allura/docs/scm_host.rst
+++ b/Allura/docs/scm_host.rst
@@ -189,22 +189,39 @@ First, you need to ensure that mod_python is installed:
 Then, in the VirtualHost section where you proxy SCM requests to git, SVN, or Hg, add the
 access handler, e.g.:
+.. code-block:: console
+    sudo vi /etc/apache2/sites-available/default
 .. code-block:: apache
     <LocationMatch "^/(git|svn|hg)/">
         AddHandler mod_python .py
-        PythonAccessHandler /PATH/TO/allura/scripts/
+        # Change this path if needed:
+        PythonAccessHandler /home/vagrant/src/allura/scripts/
         AuthType Basic
         AuthName "SCM Access"
         AuthBasicAuthoritative off
-        PythonOption ALLURA_VIRTUALENV /PATH/TO/env-allura
-        PythonOption ALLURA_AUTH_URL
-        PythonOption ALLURA_PERM_URL
+        # Change this path if needed:
+        PythonOption ALLURA_VIRTUALENV /home/vagrant/env-allura
+        # This routes back to the allura webapp, port 8080 if running with paster server
+        # In a production environment, run allura with a real WSGI server, and
+        # change the IP address and port number as appropriate.
+        # And use https if possible, since the username and password are otherwise
+        # sent in the clear to Allura.
+        PythonOption ALLURA_AUTH_URL
+        PythonOption ALLURA_PERM_URL
-If the SCM is hosted seperately from Allura, update the URLs as appropriate.
-Even if using localhost, it is recommended to use HTTPS, since the username
-and password will be otherwise be sent in the clear to Allura.
+.. code-block:: console
+    sudo service apache2 reload
+To test that it's working, run: :command:`git ls-remote
+http://localhost/git/p/test/git/` (if using Vagrant, use :code:`localhost:8088`
+from your host machine). If there is no output, that is fine (it's an empty
+repo). If it errors, look in :file:`/var/log/apache2/error.log` for the error
 .. warning::

View raw message