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

2. Install Python ​http://www.python.org
   Add D:\Python to path

3. Install Apache ​http://httpd.apache.org

4. Install Subversion ​http://subversion.tigris.org

Create Repository

5. Create Repository Directory

   D:\> md d:\svn
   

6. Create Repository

   D:\> svnadmin create d:\svn\repo1
   

7. Create skeleton repository structure in d:\temp\project Example:

   /project
     /vendor
       /tags
       /trunk
         files
     /projectname
       /branches
       /tags
       /trunk
         files
   

8. Build Repository Tree

   D:\> svn import d:\temp\project file:///d:/svn/repo1 -m "Initial Load"
   

9. Create local sandbox

   D:\> svn checkout file:///d:/svn/repo1 d:\project
   

Configure Apache

10. Copy files

    D:\> copy d:\progra~1\subver~1\httpd\*.* d:\progra~1\apache~1\apache2\modules
    

11. Create password file (w/user 'admin')

    D:\> d:\progra~1\apache~1\apache2\bin\htpasswd -cm d:\svn\.htaccess admin
    

12. 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>

13. Restart your MACHINE

14. Test your install of Subversion ​http://[hostname]:80/svn/repo1

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

---

Setup Users

15. Add users to password file

    D:\> d:\progra~1\apache~1\apache2\bin\htpasswd -m d:\svn\.htaccess user
    

Install TRAC Prerequisites

16. Install Subversion Python Bindings (Get from same download page as Subversion)
    Copy libsvn and svn directories to D:\Python23\Lib

17. Install SQLite ​http://www.sqlite.org
    Copy sqlite.exe to D:\Program Files\SQLite

18. Install PySQLite ​http://pysqlite.sourceforge.net

19. Install TRAC ​http://www.edgewall.com/products/trac/

Fix a few things

20. (BUG) Edit first line of D:\Python23\Scripts\trac-admin to have:

    #!D:\Python23\python.exe
    

21. (BUG) Edit first line of D:\Python23\share\trac\cgi-bin\trac.cgi to have:

    #!D:\Python23\python.exe
    

22. Copy CGI

    D:\> copy d:\python23\share\trac\cgi-bin\trac.cgi d:\progra~1\apache~1\apache2\cgi-bin
    

23. (BUG) not able to run trac-admin initenv... Not available in 0.6.1

Configure TRAC DB

24. Run trac-admin

    D:\Python23\Scripts> python trac-admin d:/svn/trac.db
    

25. 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
    

26. (BUG) Load Wiki

    Trac [d:/svn/trac.db]> wiki load d:/python23/share/trac/wiki-default
    

27. 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

28. 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>
    

29. Restart Apache

30. Hold your breath, test TRAC install ​http://[hostname]:80/cgi-bin/trac.cgi

Finally…

31. Install SVN Clients as necessary (try ​Rapid SVN & ​Tortoise SVN)

32. Don't forget to lock down the security on the box!

33. Now go get a *real* drink

---

Email Daragh Fitzpatrick with any questions!

---