Trac and Subversion On Windows

 

1. Install Python

Although Python 2.5.x is not the latest version of Python available, it is the latest version supported by all the software components needed to run Trac.

1. Download  Python-2.5.4.msi to your computer, and run it (double-click on python-2.5.4.msi in your download folder).
2. Click the Run button in the Open File - Security Warning dialogue box, if it appears.
3. Click the Next > button to Install for all users
4. Click the Next > button to use C:/Python25 as the destination directory
5. Click the Next > button to install all of the Python components
6. Wait for the installation to complete, and then click the Finish button
7. Add the install directory (default is C:/Python25), and C:/Python25/Scripts directory to the windows %PATH% environment variable (dont worry if it doesn't exist now):
   1. Click the Windows Start button
   2. Right-click the My Computer icon
   3. Click the Properties option at the bottom of the pop-up menu
   4. Click the Advanced tab
   5. Click the Environment Variables button
   6. Scroll down the System variables listbox to the Path Variable
   7. Select the Path Variable and click the Edit button below it - DO NOT click on the edit button above
   8. Scroll to the right-hand end of the Variable value field, and type;C:/Python25;C:/Python25/Scripts
   9. Click the OK button in the Edit System Variable window
   10. Click the OK button in the Environment Variables window
   11. Click the OK button in the System Properties window

2. Setuptools

1. Download  ez_setup.py from  PEAK (Python Enterprise Application Kit) to your Python (default isC:/Python25) directory.
2. Open a command window
   1. Click the Windows Start button
   2. Click Run
      A dialogue box titled Run should appear
   3. Type cmd in to the Open drop-down field, and click the OK button
      A black window should appear
3. Type cd C:/Python25 and press the Return key
4. Type ez_setup.py and press the Return key
   Verify no messages containing errors appeared

3. Subversion (optional)

Trac can integrate with  Subversion version control software. Read more about the integration between Trac and Subversion from the wiki: TracSubversion.

Subversion Server & Client

1. Download  Setup-Subversion-1.6.4.msi to your computer, and run it (double-click on Setup-Subversion-1.6.4.msi in your download folder).
2. Click the Run button in the Open File - Security Warning dialogue box, if it appears.
3. Click the Next button on the Welcome to the Subversion Setup Wizard screen
4. Click the Next button on the Information screen
5. Click the Next button to select Binding for Apache 2.0.x
6. Type C:/Subversion/ in to the Install subversion to: field, and click the Next button
7. Click the Finish button
8. Open a command window
   1. Click the Windows Start button
   2. Click Run
      A dialogue box titled Run should appear
   3. Type cmd in to the Open drop-down field, and click the OK button
      A black window should appear
9. Type cd C:/Subversion/bin and press the Return key
10. Type mkdir C:/svnrepositories and press the Return key
11. Type svnadmin create C:/svnrepositories/myproject and press the Return key
12. Type sc create svnserver binpath= "C:/Subversion/bin/svnserve.exe --service -r c:/svnrepositories" displayname= "Subversion Server (svnserver)" depend= Tcpip start= auto and press the Return key
13. Type net start svnserver and press the Return key

Subversion Bindings

1. Open a command window
   1. Click the Windows Start button
   2. Click Run
      A dialogue box titled Run should appear
   3. Type cmd in to the Open drop-down field, and click the OK button
      A black window should appear
2. Type cd C:/Python25/Scripts and press the Return key
3. Type easy_install -Z http://subversion.tigris.org/files/documents/15/46482/svn-python-1.6.4.win32-py2.5.exe and press the Return key
   Verify no messages containing errors appeared

4. mod_python (optional)

mod_python is needed if you want to use Apache HTTP server.

1. Download  mod_python-3.3.1.win32-py2.5-Apache2.2.exe to your computer from  Apache, and run it (double-click on mod_python-3.3.1.win32-py2.5-Apache2.0.exe in your download folder).
2. Click the Run button in the Open File - Security Warning dialogue box, if it appears.
3. Click the Next > button
4. Click the Next > button to confirm the Python directory
5. Click the Next > button to install
6. Select the directory where Apache is installed
7. Click the OK button
8. Click the Finish button

5. Plug-ins (optional)

See TracPlugins for details about plugin installation. For example: to install the SpamFilter plugin

1. Open a command window
   1. Click the Windows Start button
   2. Click Run
      A dialogue box titled Run should appear
   3. Type cmd in to the Open drop-down field, and click the OK button
      A black window should appear
2. Type mkdir C:/src and press the Return key
3. Type cd C:/src and press the Return key
4. Type svn checkout http://svn.edgewall.org/repos/trac/sandbox/spam-filter/trunk spam-filter and press the Return key
   Verify no messages containing errors appeared
5. Type cd spam-filter and press the Return key
6. Type python setup.py install and press the Return key
   Verify no messages containing errors appeared

6. Genshi

1. Open a command window
   1. Click the Windows Start button
   2. Click Run
      A dialogue box titled Run should appear
   3. Type cmd in to the Open drop-down field, and click the OK button
      A black window should appear
2. Type mkdir C:/src and press the Return key
3. Type cd C:/src and press the Return key
4. Type svn checkout http://svn.edgewall.org/repos/genshi/trunk genshi and press the Returnkey
5. Type cd genshi and press the Return key
6. Type python setup.py install and press the Return key
   Verify no messages containing errors appeared

7. Trac

1. Open a command window
   1. Click the Windows Start button
   2. Click Run
      A dialogue box titled Run should appear
   3. Type cmd in to the Open drop-down field, and click the OK button
      A black window should appear
2. Choose ONE of the following options:

Option 1

1. Type cd C:/Python25/Scripts and press the Return key
2. Type easy_install Trac and press the Return key
   Verify no messages containing errors appeared

Option 2

1. Type mkdir C:/src and press the Return key
2. Type cd C:/src and press the Return key
3. Type svn checkout http://svn.edgewall.org/repos/trac/trunk trac and press the Return key
   Verify no messages containing errors appeared
4. Type cd trac and press the Return key
5. Type python setup.py install and press the Return key
   Verify no messages containing errors appeared

Configure Trac environment

1. Type mkdir C:/trac and press the Return key
2. Type cd C:/Python25/Scripts and press the Return key
3. Type trac-admin C:/trac initenv and press the Return key
4. Type in your project name (keep it succinct) and press the Return key
5. Press the Return key to select the default Database connection string
6. Press the Return key to select svn as the default Repository type
7. Type in the full path of your repository; e.g. /svnrepositories/myproject, and press the Return key
8. Verify the installation of Trac works:
   1. Type in tracd --port 8000 C:/trac to start the Trac daemon
   2. Click the Windows Start button
   3. Click Run
      A dialogue box titled Run should appear
   4. Type http://localhost:8000 
      A browser window should open to a page with Available Projects
   5. Click on your project's name, and you should be taken to your project's Trac home page.

8. Account Manager Plug-in

1. Open a command window
   1. Click the Windows Start button
   2. Click Run
      A dialogue box titled Run should appear
   3. Type cmd in to the Open drop-down field, and click the OK button
      A black window should appear
2. Type cd C:/Python25/Scripts and press the Return key
3. Type easy_install http://trac-hacks.org/svn/accountmanagerplugin/trunk and press theReturn key
   Verify no messages containing errors appeared
4. Type trac-admin C:/trac permission add anonymous TRAC_ADMIN and press the Return key
5. Click the Windows Start button
6. Click Run
   A dialogue box titled Run should appear
7. Type notepad C:/trac/conf/trac.ini in to the Open drop-down field, and click the OK button
8. Copy the block of text below

   [components]
   acct_mgr.admin.accountmanageradminpage = enabled
   acct_mgr.api.accountmanager = enabled
   acct_mgr.db.sessionstore = enabled
   acct_mgr.htfile.htdigeststore = enabled
   acct_mgr.pwhash.htdigesthashmethod = enabled
   acct_mgr.web_ui.accountmodule = enabled
   acct_mgr.web_ui.loginmodule = enabled
   acct_mgr.web_ui.registrationmodule = enabled
   trac.web.auth.loginmodule = disabled
   

9. Scroll down to the [header_logo] section, and place the cursor on the blank line above it
10. Paste the text you copied above in to the document
11. Save the file, and close notepad
12. Create an empty C:/trac/conf/passwords.txt
    1. Click the Windows Start button
    2. Click Run
       A dialogue box titled Run should appear
    3. Type notepad C:/trac/conf/passwords.txt in to the Open drop-down field, and click theOK button
    4. Save the file, and close notepad
13. Click the Windows Start button
14. Click Run
    A dialogue box titled Run should appear
15. Type http://localhost:8000/trac/admin 
    A browser window should open to an Administration page
16. Click the Configuration hyperlink under Accounts in the menu on the left-hand side of the page
17. Select 1 from the drop-down list-box next to the HtDigestStore heading
18. Select 1 from the drop-down list-box next to the SessionStore heading
19. Type C:/trac/conf/passwords.txt in to the filename: field in the HtDigestStore section
20. Type trac in to the realm: field under the HtDigestStore section
21. Click the Save button
22. Click the Users hyperlink under the Accounts section in the menu on the left-hand side of the page
23. Type a username in to the Username: field on the right-hand side of the page in the Add Account:section
24. Type a password in to the Password: field on the right-hand side of the page in the Add Account:section
25. Type the password in to the Confirm password: field on the right-hand side of the page in the Add Account: section
26. Type a name in to the Name: field on the right-hand side of the page in the Add Account: section
27. Type an e-mail address in to the Email: field on the right-hand side of the page in the Add Account:section
28. Click the Add button
29. Click the Permissions hyperlink under the General section in the menu on the left-hand side of the page
30. Type the username in to the Subject: field on the right-hand side of the page in the Grant Permissions: section (this will become your admin user)
31. Select TRAC_ADMIN from the Action: drop-down list-box
32. Click the Add button
33. Check TRAC_ADMIN in the Action section in the center of the page
34. Click the Remove selected items button

(You will need to log in as your admin user to access the admin panels from this point forward)

More information about the TracEnvironment setup, and the TracStandalone web front-end is available.

---

See also: the TracOnWindows/Advanced instructions, TracOnWindows/Rewrite for discussing improvements to this page, 0.10/TracOnWindows and Trac0.9/TracOnWindows for the previous version of this document.  Installing Trac on Windows

Attachments

• trac-0.10.3-win32-install.py  (11.7 KB) - added by cboos 3 years ago. All-in-one installer (not a graphical installer)
• Step_by_Step-installation-manual.txt  (4.1 KB) - added by anders_emajl@… 5 months ago. ATracOnWindows step by step guide to fast get up and running. This version use windows 2003 std SP2 and Trac 0.11.2.1 with Python 2.5.4. together with the webserver tracd and authentication.