docs: updated documentation structure

docs/admin/system_admin/apache/apache-wsgi-coding.rst

@@ -0,0 +1,55 @@
+.. _apache-wsgi-ref:
+
+Apache WSGI Configuration
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+|RCE| can also be set up with Apache under ``mod_wsgi``. To configure this
+use the following steps.
+
+1. Install ``mod_wsgi`` using the following command:
+   ``aptitude install libapache2-mod-wsgi``.
+2. Enable ``mod_wsgi`` using the following command: ``a2enmod wsgi``
+3. Create a ``wsgi`` dispatch script, using the following examples.
+
+.. code-block:: bash
+
+   WSGIDaemonProcess pylons \
+   threads=4 \
+   # check the python virtual env location
+   python-path=/home/web/rhodecode/pyenv/lib/python2.6/site-packages
+   # Check the install location
+   WSGIScriptAlias / /home/web/rhodecode/dispatch.wsgi
+   WSGIPassAuthorization On
+     # user=www-data group=www-data # Enable if running Apache as root
+
+.. note::
+
+   Do not set ``processes=num`` in this configuration file. Running |RCE| in
+   multiprocess mode with Apache is not supported.
+
+The following is an example ``wsgi`` dispatch script.
+
+.. code-block:: python
+
+    import os
+    os.environ["HGENCODING"] = "UTF-8"
+    os.environ['PYTHON_EGG_CACHE'] = '/home/web/rhodecode/.egg-cache'
+
+    # Set the current dir
+    os.chdir('/home/web/rhodecode/')
+
+    import site
+    site.addsitedir("/home/web/rhodecode/pyenv/lib/python2.6/site-packages")
+
+    from paste.deploy import loadapp
+    from paste.script.util.logging_config import fileConfig
+
+    fileConfig('/home/web/rhodecode/production.ini')
+    application = loadapp('config:/home/web/rhodecode/production.ini')
+
+.. note::
+
+   When using `mod_wsgi` the same version of |hg| must be running in your
+   system's |PY| environment and on |RCE|. To check the |RCE| version,
+   on the interface go to
+   :menuselection:`Admin --> Settings --> System Info`