Changes between Version 82 and Version 83 of TracOnUbuntu

Timestamp:

Sep 30, 2011, 4:41:54 AM (13 years ago)

Author:

anonymous

Comment:

—

TracOnUbuntu

@@ -1 +1 @@
 = Trac on Ubuntu =
+[[PageOutline]]
+= Installing Trac on Ubuntu
+This is a short recipe to install and configure virtual `Apache2` host with `Trac`
+== What are Ubuntu packages needed
+Typical procedure to install Trac under Ubuntu with its default dependencies (default - choosed by apt) is
+{{{#!sh
+apt-get install python python-babel
+apt-get install trac
+}}}
+Ensure that python version matches Trac latest, otherwise apt will install older Trac version which matches your old python package installed. Also take into account that `python-babel` should be always installed before `trac` if you wish to see it internationalized.
+=== Upgrade python packages
+Ubuntu pre-packaged python resources are not always newest, and you may consider to upgrade them with `easy_install` or `pip`
+- Upgrade with `easy_install`
+{{{#!sh
+easy_install Babel
+easy_install Trac
+}}}
+- Upgrade with `pip` (another python installer, namely `python-pip`)
+{{{#!sh
+apt-get install python-pip
+pip install --upgrade Babel
+pip install --upgrade Trac
+}}}
+== Configuring virtual host
+Here is shown sample virtual host configuration running under `apache2` (one file) with minimal, "entry level" settings. 
+Config file created at `apache2` known place for site configs (see below), and then configured site can be "enabled" to run.
 
+The following considerations used within this config, yours may vary, so adjust them below appropriately at your own 
+- `trac.local` is a hostname of virtual host
+- `/var/local/trac` is a directory (Trac project) at that host
+- `/var/local/trac/.htpasswd` is a password file created with `htpasswd` utility
+- `ru_RU.UTF8` is a locale ident
+=== Prepare configuration
+First you need to 
+- create directory for Trac project and change its access permissions to that under which `apache2` runs (`www-data` in most cases)
+- initialize `Trac` environment within that directory
+- create `apache2` htpasswd entry for authorized web user access within this directory
+- add to Trac this authorized web user with administartive privileges over Trac
+{{{#!sh
+mkir -p /var/local/trac && chown www-data: /var/local/trac
+htpasswd -c /var/local/trac/.htpasswd adminusername
+trac-admin /var/local/trac initenv
+trac-admin /var/local/trac permission add adminusername TRAC_ADMIN
+}}}
+Create config file with any text editor (`vi` in this example):
+{{{#!sh
+vi /etc/apache2/sites-available/trac
+}}}
+Enter the following copy-paste into this file:
+{{{#!text/html
+<VirtualHost *:80>
+        ServerName trac.local
+        <Location />
+           SetHandler mod_python
+           PythonInterpreter main_interpreter
+           PythonHandler trac.web.modpython_frontend
+           PythonOption TracEnv /var/local/trac
+           PythonOption TracEnvParentDir /var/local/trac
+           PythonOption TracUriRoot /
+           PythonOption TracEnv /var/local/trac
+            # PythonOption TracEnvIndexTemplate /var/local/trac/templates/index-template.html
+           PythonOption TracLocale ru_RU.UTF8
+           PythonOption PYTHON_EGG_CACHE /tmp
+           Order allow,deny
+           Allow from all
+        </Location>
+        <Location /login>
+          AuthType Basic
+          AuthName "myproject"
+          AuthUserFile /var/local/trac/.htpasswd
+          Require valid-user
+        </Location>
+</VirtualHost>
+}}}
+=== Enable prepared configuration
+{{{#!sh
+a2enmod python
+a2ensite trac
+service apache restart
+}}}
+= done.
 {{{
 #!div class=important