Quick startup guides for Test manager plugin

[ Home | Latest changes | Image gallery | ​Video tutorial on Youtube | Quick setup guide | ​Download | ​Source | Bugs/Feature requests ]

Quick startup guide for Linux

This guide will help you to quickly set up an environment with Apache, modwsgi and the Test Manager plugin. Security is based on Apache password file, with basic authentication.

Run every command as root. The examples are for a freshly installed Debian machine:

1. Download ​python setup tools from PyPi.
2. Compile and install:

   tar xvzf setuptools-0.6c11.tar.gz 
   cd setuptools-0.6c11/
   python setup.py install
   

3. Install Trac 0.12.2 using the now available easy_install:

   easy_install Trac
   

4. Create the 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, for example 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 the anonymous user TRAC_ADMIN permissions:

   trac-admin /var/lib/trac/foo permission add anonymous TRAC_ADMIN
   

8. Run Trac through tracd to verify everything worked:

   tracd -r --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:

   localhost:8000/foo/admin
   

10. Configure Apache and wsgi as follows:
    Snippet for apache2.conf:

    WSGIScriptAlias /trac /var/lib/trac/foo/trac.wsgi
    <Directory /var/lib/trac/foo/apache>
       WSGIApplicationGroup %{GLOBAL}
       Order deny,allow
       Allow from all
    </Directory>
    <Location /trac>
       AuthType Basic
       AuthName "trac"
       AuthUserFile /var/lib/trac/foo/conf/passwd
       Require valid-user
    </Location>
    

    Snippet for /var/lib/trac/foo/trac.wsgi:

    import os
    
    os.environ['TRAC_ENV'] = '/var/lib/trac/foo'
    os.environ['PYTHON_EGG_CACHE'] = '/var/lib/trac/foo/eggs'
    
    import trac.web.main
    application = trac.web.main.dispatch_request
    

11. Grant everyone read, write and execute permissions on /var/lib/trac:

    chmod -R 777 /var/lib/trac
    

12. (Re-)start Apache:

    /etc/init.d/apache2 restart
    

13. Verify Trac is up and running, with basic authentication working, using the browser.
14. Download the egg files for the TestManagerForTracPlugin from sourceforge and extract the archive:

    sourceforge.net/projects/testman4trac/files/
    

15. Open your browser to the foo trac project, on the admin panel http://localhost/trac/foo/admin, 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 upgrade, open a command console as root and enter the command displayed in the browser:

    trac-admin /var/lib/trac/foo upgrade
    

18. Restart Apache to verify 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, run the same command as before. Then also issue the command to update the documentation, which is displayed at the end of the database update:

    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 (F5). 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 plugin.

Quick startup guide for Windows

1. Install Linux.
2. Follow the Quick startup guide for Linux.