wiki:TracOnWindows
Last modified 18/05/06 11:16:56

Windows Installation instructions for SVN w/TRAC

Versions used in this example (Available 2004-05-13):

  • Apache 2.0.49
  • Python 2.3.3
  • SVN 1.0.2
  • SQLite 2.8.13
  • PySQLite 0.5.0-py2.3
  • Trac 0.6.1

Email  Daragh Fitzpatrick for more info, or if you changed this page (since this Wiki does not support watch/subscription)

Note: This example installs to D:

Arm Yourself

  1. Get & Read book  http://svnbook.red-bean.com

Install SubVersioN Pre-Requisites

  1. Install Python  http://www.python.org
    Add D:\Python to path
  1. Install Apache  http://httpd.apache.org
  1. Install Subversion  http://subversion.tigris.org

Create Repository

  1. Create Repository Directory 
    D:\> md d:\svn
  1. Create Repository 
    D:\> svnadmin create d:\svn\repo1
  1. Create skeleton repository structure in d:\temp\project Example: 
    /project
  /vendor
    /tags
    /trunk
      files
  /projectname
    /branches
    /tags
    /trunk
      files
  1. Build Repository Tree 
    D:\> svn import d:\temp\project file:///d:/svn/repo1 -m "Initial Load"
  1. Create local sandbox 
    D:\> svn checkout file:///d:/svn/repo1 d:\project

Configure Apache

  1. Copy files 
    D:\> copy d:\progra~1\subver~1\httpd\*.* d:\progra~1\apache~1\apache2\modules
  1. Create password file (w/user 'admin') 
    D:\> d:\progra~1\apache~1\apache2\bin\htpasswd -cm d:\svn\.htaccess admin
  1. Configure Apache (edit httpd.conf) 12.1. Restrict access/lockdown as appropriate

12.2. Add Modules to httpd.conf

12.1.1. Uncomment: 

LoadModule dav_module modules/mod_dav.so

12.1.2. Add (after): 

# Subversion
LoadModule dav_svn_module modules/mod_dav_svn.so

12.3. Add location root for multiple repositories 

# Subversion
<Location /svn>
  DAV svn
  # any /svn/foo URL will map to a repository D:/svn/foo
  SVNParentPath D:/svn
  AuthType Basic
  AuthName "Subversion repository"
  AuthUserFile d:/svn/.htaccess
  Require valid-user
</Location>
  1. Restart your MACHINE
  1. Test your install of Subversion  http://[hostname]:80/svn/repo1

Phew! Subversion is installed and working - Grab a beverage for yourself.

Setup Users

  1. Add users to password file 
    D:\> d:\progra~1\apache~1\apache2\bin\htpasswd -m d:\svn\.htaccess user

Install TRAC Prerequisites

  1. Install Subversion Python Bindings (Get from same download page as Subversion)
    Copy libsvn and svn directories to D:\Python23\Lib
  1. Install SQLite  http://www.sqlite.org
    Copy sqlite.exe to D:\Program Files\SQLite
  1. Install PySQLite  http://pysqlite.sourceforge.net
  1. Install TRAC  http://www.edgewall.com/products/trac/

Fix a few things

  1. (BUG) Edit first line of D:\Python23\Scripts\trac-admin to have: 
    #!D:\Python23\python.exe
  1. (BUG) Edit first line of D:\Python23\share\trac\cgi-bin\trac.cgi to have: 
    #!D:\Python23\python.exe
  1. Copy CGI 
    D:\> copy d:\python23\share\trac\cgi-bin\trac.cgi d:\progra~1\apache~1\apache2\cgi-bin
  1. (BUG) not able to run trac-admin initenv... Not available in 0.6.1

Configure TRAC DB

  1. Run trac-admin 
    D:\Python23\Scripts> python trac-admin d:/svn/trac.db
  1. Initialize DB 
    Trac [d:/svn/trac.db]> initdb

      Enter project name
    Project
  Enter path to repository
    d:\svn\repo1
  Enter path to templates
    d:\Python23\share\trac\templates
  (BUG) Note error message regarding wiki-pages
  1. (BUG) Load Wiki 
    Trac [d:/svn/trac.db]> wiki load d:/python23/share/trac/wiki-default
  1. Add administrative permissions 
    Trac [d:/svn/trac.db]> permission add admin TICKET_ADMIN
Trac [d:/svn/trac.db]> permission add admin REPORT_CREATE
Trac [d:/svn/trac.db]> permission add admin REPORT_MODIFY
Trac [d:/svn/trac.db]> permission add admin REPORT_DELETE
Trac [d:/svn/trac.db]> permission add admin REPORT_ADMIN
Trac [d:/svn/trac.db]> permission add admin WIKI_DELETE
Trac [d:/svn/trac.db]> permission add admin WIKI_ADMIN
Trac [d:/svn/trac.db]> permission add admin CONFIG_VIEW
Trac [d:/svn/trac.db]> permission add admin TRAC_ADMIN

Add TRAC to Apache

  1. Edit httpd.conf: Add: (copy this - there's a typo in Edgewall's version) 
    # TRAC
Alias /trac "D:/Python23/share/trac/htdocs"
<Directory "D:/Python23/share/trac/htdocs">
  Options Indexes MultiViews
  AllowOverride None
  Order allow,deny
  Allow from all
</Directory>

<Location "/cgi-bin/trac.cgi">
  SetEnv TRAC_DB "d:/svn/trac.db"
</Location>

<Location "/cgi-bin/trac.cgi/login">
  AuthType Basic
  AuthName "Project"
  AuthUserFile D:/svn/.htaccess
  Require valid-user
</Location>
  1. Restart Apache
  1. Hold your breath, test TRAC install  http://[hostname]:80/cgi-bin/trac.cgi

Finally…

  1. Install SVN Clients as necessary (try  Rapid SVN &  Tortoise SVN)
  1. Don't forget to lock down the security on the box!
  1. Now go get a *real* drink

Email  Daragh Fitzpatrick with any questions!