Version 3 (modified by Roberto Longobardi, 7 years ago) (diff)


Quick startup guide for Linux

This guide will help you setup a quick and dirty environment with Apache, modwsgi and the Test Manager plugin in a few minutes.

Run every command as root. The example takes into account a freshly installed Debian:

  1. Download python setup tools from PyPi
  2. Compile and install it:
    tar xvzf setuptools-0.6c11.tar.gz 
    cd setuptools-0.6c11/
    python install
  3. Install Trac 0.12.2 using the now available easy_install:
    easy_install Trac
  4. Create the needed directories to host the foo project:
    mkdir -p /var/lib/trac
  5. Create a foo trac project environment:
    trac-admin /var/lib/trac/foo initenv
  6. Create a password file for apache authentication, with an "admin" and a "roberto" users:
    htpasswd -c /var/lib/trac/foo/conf/passwd admin
    htpasswd /var/lib/trac/foo/conf/passwd roberto
  7. Grant anonymous TRAC_ADMIN permissions:
    trac-admin /var/lib/trac/foo permission add anonymous TRAC_ADMIN
  8. Run trac through tracd just to see everything worked:
    tracd --port 8000 /var/lib/trac/foo
  9. Set trace level to DEBUG in trac, and log to file, using the admin panel. The admin panel can be accessed from Trac's navigation bar.
  10. Configure apache and wsgi using exactly the info and paths Stefan provided.
  11. Grant everyone 777 on /var/lib/trac:
    chmod -R 777 /var/lib/trac
  12. (Re-)start apache:
    /etc/init.d/apache2 restart
  13. Verify trac was up and running, with basic authentication working, using the browser.
  14. Download the egg files for the TestManagerForTracPlugin from sourceforge and extract the archive.
  15. Open your browser to the foo trac project, on the admin panel, and install TracGenericClassPlugin from the first egg file. Note: the order in which you install the plugins is important.
  16. Install the TracGenericWorkflowPlugin the same way. This asks for a database upgrade.
  17. To do it, open a command console as root and fire the command displayed in the browser. It should be something like the following:
    trac-admin /var/lib/trac/foo upgrade
  18. Restart apache, just to be sure its cache is updated:
    /etc/init.d/apache2 restart
  19. Refresh your browser (F5). The trac admin page should show the new plugin in place.
  20. Install TestManagerForTracPlugin the same way. This asks for another database upgrade.
  21. From the same command console, as root, fire again the same command as before. The also issue the command to update the documentation, which is displayed at the end of the database update. They should look like the following:
    trac-admin /var/lib/trac/foo upgrade
    trac-admin /var/lib/trac/foo wiki upgrade
  22. Restart apache. This time is actually required:
    /etc/init.d/apache2 restart
  23. Refresh your browser. The trac admin page should show the three installed plugins.
  24. Click on the Test Manager tab in Trac's top navigation bar to start using the new plugins.