Edgewall Software

Trac On Windows

The following instructions use 32-bit software packages. The 64-bit software packages do not yet integrate seamlessly with each other, so are not recommended.

1. Install Python

  1. Download Python-2.6.4.msi to your computer, and run it by double-clicking python-2.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 to Install for all users.
  4. Click the Next > button to use C:\Python26 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:\Python26), and C:\Python26\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:\Python26;C:\Python26\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. Setup tools

  1. Download ez_setup.py from PEAK (Python Enterprise Application Kit) to your Python directory. Default is C:\Python26.
  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:\Python26 and press the Return key.
  4. Type ez_setup.py and press the Return key
    Verify that 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 and Client

  1. Download Setup-Subversion-1.6.6.msi (Alagazam) CollabNet Subversion Edge 1.1 (for Windows 32 bit) to your computer, and run it by double-clicking on CollabNetSubversionEdge-1.1.0_setup.exe in your download folder. Warning: CollabNet Edge will install Python25 and rewrite system and env variables, as well as change registry entries.
  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:\Python26\Scripts and press the Return key.
  3. Type easy_install -Z http://subversion.tigris.org/files/documents/15/47859/svn-python-1.6.6.win32-py2.6.exe. If you get an infinite loop error, download the file and point easy_install to it. Press the Return key
    Verify that no messages containing errors appeared.

4. mod_python (optional, and only available for Python v2.5 right now)

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 by double-clicking 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, perform the following actions:

  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/plugins/0.11/spam-filter and press the Return key
    Verify that 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

To install the Genshi templating engine, perform the following actions:

  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 Return key.
  5. Type cd genshi and press the Return key.
  6. Type python setup.py install and press the Return key
    Verify that 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:\Python26\Scripts and press the Return key.
  2. Type easy_install Trac and press the Return key
    Verify that 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 that 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 that no messages containing errors appeared.

Configure Trac environment

  1. Type mkdir C:\trac and press the Return key.
  2. Type cd C:\Python26\Scripts and press the Return key.
  3. Type trac-admin \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

To install the AccountManager plugin, perform the following actions:

  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:\Python26\Scripts and press the Return key.
  3. Type easy_install http://trac-hacks.org/svn/accountmanagerplugin/trunk and press the Return key
    Verify that 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.accountmanageradminpages = 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 the OK 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, for the anonymous Subject.
  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: TracOnWindows

Last modified 3 years ago Last modified on Jan 9, 2015, 10:24:41 PM
Note: See TracWiki for help on using the wiki.