= Quick startup guides for Test manager plugin

''' [ [wiki:TestManagerForTracPlugin Home] | [wiki:TestManagerForTracPluginChangeHistory Latest changes] | [wiki:TestManagerForTracPluginGallery Image gallery] | [http://www.youtube.com/watch?v=BIi3QMT0rT4 Video tutorial on Youtube] | [wiki:TestManagerForTracPluginQuickSetup Quick setup guide] | [http://sourceforge.net/projects/testman4trac Download] | [http://sourceforge.net/projects/testman4trac/files Source] | [wiki:TestManagerForTracPluginBugsFeatures 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 [http://pypi.python.org/packages/source/s/setuptools/setuptools-0.6c11.tar.gz#md5=7df2a529a074f613b509fb44feefe74e python setup tools] from !PyPi.
 2. Compile and install:
{{{#!sh
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:
{{{#!sh
easy_install Trac
}}}
 4. Create the directories to host the foo project:
{{{#!sh
mkdir -p /var/lib/trac
}}}
 5. Create a foo trac project environment:
{{{#!sh
trac-admin /var/lib/trac/foo initenv
}}}
 6. Create a password file for Apache authentication, for example with an "admin" and a "roberto" users:
{{{#!apache
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:
{{{#!sh
trac-admin /var/lib/trac/foo permission add anonymous TRAC_ADMIN
}}}
 8. Run Trac through tracd to verify everything worked:
{{{#!sh
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:
{{{#!sh
localhost:8000/foo/admin
}}}
 10. Configure Apache and wsgi as follows:[[BR]]
 Snippet for `apache2.conf`:
 {{{#!apache
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`:
 {{{#!python
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`:
{{{#!sh
chmod -R 777 /var/lib/trac
}}}
 12. (Re-)start Apache:
{{{#!sh
/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:
{{{#!sh
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:
{{{#!sh
trac-admin /var/lib/trac/foo upgrade
}}}
 18. Restart Apache to verify its cache is updated:
{{{#!sh
/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:
{{{#!sh
trac-admin /var/lib/trac/foo upgrade
trac-admin /var/lib/trac/foo wiki upgrade
}}}
 22. Restart Apache. This time is actually required:
{{{#!sh
/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.
 1. Follow the [#QuickstartupguideforLinux Quick startup guide for Linux].