| 1 | = Installing and Running Trac on Debian = |
| 2 | |
| 3 | == Notes from a debian sarge install == |
| 4 | |
| 5 | As has been previously pointed out, a Debian package does not exist, hence you need to build it yourself. This isn't ''too'' onerous if you know where you might get bitten. Hopefully the following should be of some use. |
| 6 | |
| 7 | '''Warning''': The instructions within will modify your system from the standard Debian install. Some packages will be pulled from the unstable distribution, and some packages are installed manually on your system. This may make it difficult to uninstall the software, or upgrade it in the future as Debian packages arrive. But for what it's worth, this setup seems to work fine. |
| 8 | |
| 9 | First you need the SQLite, Subversion and the related python modules. Note that you need to use the version of subversion from unstable. Don't worry as Debians unstable is not really unstable, it's about as stable as typical redhat packages. |
| 10 | |
| 11 | You might want to use apt-pinning, which is basically a way of stopping unstable dependancies from getting installed all over the place (try this [http://jaqque.sbih.org/kplug/apt-pinning.html guide for beginners]). Create or edit '''{{{/etc/apt/preferences}}}''' and insert |
| 12 | |
| 13 | {{{ |
| 14 | Package: * |
| 15 | Pin: release a=testing |
| 16 | Pin-Priority: 650 |
| 17 | |
| 18 | Package: * |
| 19 | Pin: release a=unstable |
| 20 | Pin-Priority: 600 |
| 21 | }}} |
| 22 | |
| 23 | You'll also need to add unstable to the '''{{{/etc/apt/sources.list}}}''' |
| 24 | |
| 25 | {{{ |
| 26 | deb http://security.debian.org/ stable/updates main |
| 27 | deb http://ftp.uk.debian.org/debian/ testing non-free |
| 28 | deb http://ftp.uk.debian.org/debian/ testing contrib |
| 29 | deb http://ftp.uk.debian.org/debian/ testing main |
| 30 | deb http://ftp.uk.debian.org/debian/ unstable main |
| 31 | }}} |
| 32 | |
| 33 | Thats what mine looks like |
| 34 | |
| 35 | {{{ |
| 36 | apt-get install sqlite python2.3-subversion python2.3-sqlite |
| 37 | apt-get -t unstable install subversion |
| 38 | }}} |
| 39 | |
| 40 | Clearsilver isn't available as a package so get clearsilver from http://www.clearsilver.net/ (tested [http://www.clearsilver.net/downloads/clearsilver-0.9.8.tar.gz 0.9.8]) |
| 41 | |
| 42 | {{{ |
| 43 | tar xvfz clearsilver-0.9.8.tar.gz |
| 44 | cd clearsilver-0.9.8 |
| 45 | ./configure |
| 46 | make |
| 47 | make install |
| 48 | cd python/ |
| 49 | ln -s /usr/bin/python2.3 /usr/bin/python |
| 50 | make |
| 51 | make install |
| 52 | }}} |
| 53 | |
| 54 | This should then allow you to build and initialise trac. |
| 55 | |
| 56 | Note: I found I needed to change the first line in scripts/document.py from '#!/usr/local/bin/python' to '#!/usr/bin/python' --Tom Hoffman |
| 57 | |
| 58 | When you come to running it though you'll also have to add the env_module using the following line in your '''{{{/etc/apache/modules.conf}}}''' |
| 59 | |
| 60 | {{{ |
| 61 | LoadModule env_module /usr/lib/apache/1.3/mod_env.so |
| 62 | }}} |
| 63 | |
| 64 | I then set up a trac.conf in my '''{{{/etc/apache/conf.d}}}''' folder like so |
| 65 | |
| 66 | {{{ |
| 67 | <VirtualHost local.trac> |
| 68 | alias /trac/ "/usr/share/trac/htdocs/" |
| 69 | ServerAdmin youremail@yourdomain.tld |
| 70 | DocumentRoot /home/tim/myTrac |
| 71 | ServerName local.trac |
| 72 | ErrorLog /home/tim/myTrac/logs/error.log |
| 73 | CustomLog /home/tim/myTrac/logs/access_log common |
| 74 | AddHandler cgi-script cgi |
| 75 | <Location "/cgi-bin/trac.cgi"> |
| 76 | SetEnv TRAC_DB "/home/tim/myTrac/tracdb/mydb" |
| 77 | Options FollowSymLinks +ExecCGI |
| 78 | AllowOverride None |
| 79 | </Location> |
| 80 | </VirtualHost> |
| 81 | }}} |
| 82 | Don't forget to create those log folders though (apachectl configtest doesn't warn you about that one) |
| 83 | |
| 84 | |
| 85 | |
| 86 | |