How To: Install Subversion with Trac on Windows

Version 1.7

Created: 02-12-2007

Modified: 05-16-2007

You will need the following files, download them before starting:

Install Steps:

Download the necessary files (see the list above, don't start until this is done)

1. Install and Configure Subversion.

• Create a new variable name called SVN_EDITOR set the path to c:\windows\notepad.exe
  
  If you don't know how to setup an Environment Variable see below:
  
  To create a new environment variable in windows click on start, then right click on my computer, then click on properties, next click on the advanced tab, and then click on Environment Variables. Click on new, for the variable name type SVN_EDITOR and for the variable value you would type c:\windows\notepad.exe
  

• On the Drive that you want your repository to be located, make a new folder called "tracsvn" inside this folder make another folder called "svnrepos". (Be sure to create the folder names in lowercase. I have seen issues where the directory names were not typed in the correct case.)
• From a command line run the following command: (You may have to run the command from the c:\Program files\subversion\bin directory.)

          svnadmin create --fs-type fsfs c:\tracsvn\svnrepos

• From a command line run the following command.

          sc create Subversion binpath= "\"c:\program files\subversion\bin\svnserve.exe\" --service --root e:\tracsvn\svnrepos" displayname= "Subversion Repository" depend= Tcpip

  Notes: "Subversion" is the service name "Subversion Repository" is the display name --root tells where the root of the database is and depend makes the service depend on Tcpip.
  
  If you need to delete the service type: sc delete Subversion Repository
  
  
• Go to the new service and set its startup type to automatic. Start the service if its stopped.
  

• In the repository folder "c:\tracsvn\svnrepos\conf" find the file svnserve.conf, modify the file to look like this:

          [general]
          anon-access = read
          auth-access = write
          password-db = pass
          authz-db = authz
          realm = myproject

• In the same directory create a file called "pass" it should look like this:

          [users]
          admin = password
          bob = bobspassword

  Don't forget to save the file.
  
• In the same directory create a file called authz it should look like this:

          [/]
          * =
          admin = rw
          bob = r

  Notes: This will give anonymous users no access, admin will get read and write and bob will get read only.
  

        svn mkdir svn://localhost/myproject
        svn mkdir svn://localhost/myproject/branches
        svn mkdir svn://localhost/myproject/tags
        svn mkdir svn://localhost/myproject/trunk

After you run each command notepad will automatically open. On the first line of the notepad file type a comment, then close notepad and save. This is your first commit.


Notes: branches would be the working copies of active work, tags would be the final versions of a branch, trunk is the current active work or work being coded.

This guide does not go into detail on how to use Tortoise see the Tortoise web site for help documentation.

2. Install and Configure Apache

• In the subversion bin folder (this should be c:\program files\subversion\bin) copy mod_authz_svn.so and mod_dav_svn.so files and paste to the apache modules folder. (This should be c:\program files\Apache Group\Apache2\modules)
• In the subversion bin folder copy all the dll files and paste to the apache modules folder.
  

• Cut the pass and authz files that we created in c:\tracsvn\svnrepos\conf and paste them to "c:\tracsvn"
• From a command prompt in the c:\program files\apache group\apache2\bin folder type:

          htpasswd -cm c:\tracsvn\pass.tmp admin

• Open the new pass.tmp file which was saved to c:\tracsvn and copy the admin password out and paste it to the working pass file.
  Your pass.tmp file should look something like this:

          admin:$agg$sa/.....$98eabcdUIPOKJHAZHADSKFA.

  If you open pass.tmp in notepad you will see a block character after the period, only copy to the period you don't want the block
  
• After you paste the admin password into your working pass file, the "c:\tracsvnpass" file should look like this:

          [users]
          admin:$agg$sa/.....$98eabcdUIPOKJHAZHADSKFA.

  Notes: This will create an encrypted password and now your passwords are not in plain text.
  
  Repeat the above steps for each user you want to add.
  

• Locate the httpd.conf file in c:\program files\apache group\apache2\conf directory and uncomment the following

          LoadModule dav_module modules/mod_dav.so
          LoadModule dav_fs_module modules/mod_dav_fs.so

• After the above add

          # Subversion -- Modules start
          LoadModule dav_svn_module modules/mod_dav_svn.so
          LoadModule authz_svn_module modules/mod_authz_svn.so
          # Subversion --End of modules

  You don't have to keep the # Subversion comments, however commenting helps one remember why changes were made.
  
• Uncomment the following: (If you plan to use mod_python skip this step)

          AddHandler cgi-script .cgi

        Apache -k install -n "Apache2"

• At the very end of the httpd.conf file add the text below.

          # Subversion -- Start needed for browsing subversion outside of trac
          <Location /svn>
              DAV svn
              SVNPath c:/tracsvn/svnrepos
              AuthType Basic
              AuthName "Subversion repository"
              AuthUserFile c:/tracsvn/pass
              AuthzSVNAccessFile e:/tracsvn/authz
              Require valid-user
          </Location>
          # Subversion -- END

  Notes: After you add the above, the pass and authz files that you setup in c:\tracsvn\svnrepos will not be read. This is why they were moved to "c:\tracsvn" folder
  

3. Install and configure Python23 and Python Modules

• At the end of variable name "Path" add this:

          C:\Python23

  Notes: be sure to add a ";" before the c:python23
  

• At the end of variable name "Path" add this:

          C:\Python23\Scripts

• Run the svn-python-1.4.0-py2.3.exe file.
  
  Notes: This is for subversion 1.40 and python 2.3 if you install subversion 1.42 you will have to download the correct svn and python versions. Remember the versions Must Match!!
  

• Run the pysqlite-1.1.8.win32-py2.3.exe installer using the defaults.
  

• Run clearsilver-0.9.14.win32-py2.3.exe installer using the defaults.
  

• Install mod_python-3.2.10.win32-py2.3-apache2.0.exe installer using the defaults.
• After the install is finished add the below to your httpd.conf file. I placed mine right below the mod_dav_fs.so module
  

          LoadModule python_module modules/mod_python.so

4. Install and configure Trac

• Locate the trac.cgi file (this will be in the python23\share\trac\cgi-bin folder)
• Using notepad make sure the first line reads

          #!C:\Python23\python.exe

• Copy trac.cgi to the c:\program files\apache group\apache2\cgi-bin folder
  

• From Python23 directory type

          python scripts/trac-admin c:/tracsvn/trac.db

        initenv

        MyTracSite

        c:\tracsvn\svnrepos

• While still in the trac config tool type:
  

          permission add admin TRAC_ADMIN

• Configure Apache... At the very end of the httpd.conf file add the following:

          # TRAC -- START needed for browsing subversion inside of trac
          <Location /cgi-bin/trac.cgi>
              SetEnv TRAC_ENV "c:/tracsvn/trac.db"
              SetEnv PYTHONPATH "c:/Program Files/Subversion/bin"
              # if you are running Apache as a user other than System, the TMP variable
              # needs to be set to a place where that user can write scratch files. Make
              # sure that this directory is created and writable by that user.
              #SetEnv TMP "c:/tracsvn/trac.db/TMP
          </Location>
          
          <Location /cgi-bin/trac.cgi/login>
              AuthType Basic
              AuthName "MyTracSite"
              SVNPath c:/tracsvn/svnrepos
              AuthUserFile c:/tracsvn/pass
              AuthzSVNAccessFile c:/tracsvn/authz
              Require valid-user
          </Location>
          
          <Directory "C:/Python23/share/trac/htdocs">
              Options Indexes MultiViews
              AllowOverride None
              Order allow,deny
              Allow from all
          </Directory>
          #TRAC -- END

  Be sure to restart apache after any changes you make to the conf files.
  

• Configure Apache... the last line of the httpd.conf should be "# Subversion -- END" below this add:"

          # TRAC -- START needed for browsing subversion inside of trac
          <Location /trac>
              SetHandler mod_python
              PythonHandler trac.web.modpython_frontend
              PythonOption TracEnv "c:/tracsvn/trac.db"
          </Location>
  
          <Location "/trac/login">
              AuthType Basic
              AuthName "MyTracSite"
              SVNPath c:/tracsvn/svnrepos
              AuthUserFile c:/tracsvn/pass
              AuthzSVNAccessFile c:/tracsvn/authz
              Require valid-user
          </Location>
          
          <Directory "C:/Python23/share/trac/htdocs">
              Options Indexes MultiViews
              AllowOverride None
              Order allow,deny
              Allow from all
          </Directory>
          #TRAC -- END

  Notes: if you have issues with mod_python you can add the below to the httpd.conf to test mod_python install
  

          <Location /mpinfo>
              SetHandler mod_python
              PythonHandler mod_python.testhandler
          </Location>

  The site would http://localhost/mpinfo
  
  Be sure to restart apache after any changes you make to the conf files.
  
  It would be a bad idea to keep the /mpinfo up on a production install be sure to comment out!
  

• Run the setup tools installer. (This would be file - Setuptools-0.6c5.win-py2.3.exe)
  
  Notes: to test the install of setup tools run the script below you should get a blank prompt after the command is run. run the command from "c:\python23\scripts"

              python -c "import pkg_resources"

• Copy the tracwebadmin-0.1.2dev_r4240-py2.3.egg.zip file to c:\pythyon23\scripts rename the file only taking the zip extension off the name.
• From the c:\python23\scripts folder open a command prompt and run the command below.

          easy_install TracWebAdmin-0.1.2dev_r4240-py2.3.egg

• In the trac.ini file(this file is in c:\tracsvn\trac.db\conf add the below

          [components]
          webadmin.* = enabled

• Restart the apache server
  

• The trac.ini file is in the c:\tracsvn\trac.db\conf folder. Modify the authz_file section to look like this:

      authz_file = c:\tracsvn\authz

• Restart the apache server
• Goto the trac site and login using admin. You should see a new button called "admin" on the far right hand side of the main menu.
  
  If you click on Admin and get settings then the install worked
  

5.Backup the database

    REM Reset HotCopy directory
    rmdir /S Q c:\dbBack
    mkdir c:\dbBack
    
    REM Backup The Subversion db using hotcopy
    svnadmin hotcopy c:/tracsvn/svnrepos c:\dbBack --clean-logs

Change log:

2-12-2007:

2-19-2007:

3-19-2007

5-16-2007

Credits