Edgewall Software

Version 2 (modified by Christian Boos, 12 years ago) ( diff )

fix location of the spam-filter plugin

Trac On Windows

Last modified: 2009-11-09 17:05:28 GMT

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 (double-click on 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. Setuptools

  1. Download ez_setup.py from PEAK (Python Enterprise Application Kit) to your Python (default is C:\Python26) 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:\Python26 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.6.msi to your computer, and run it (double-click on Setup-Subversion-1.6.6.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:\Python26\Scripts and press the Return key
  3. Type easy_install -Z http://subversion.tigris.org/files/documents/15/46888/svn-python-1.6.6.win32-py2.6.exe and press the Return key
    Verify 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 (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/plugins/0.11/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 Return key
  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:\Python26\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:\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

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

Note: See TracWiki for help on using the wiki.