|Version 3 (modified by seccanj, 4 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:
- Download python setup tools from PyPi
- Compile and install it:
tar xvzf setuptools-0.6c11.tar.gz cd setuptools-0.6c11/ python setup.py install
- Install Trac 0.12.2 using the now available easy_install:
- Create the needed directories to host the foo project:
mkdir -p /var/lib/trac
- Create a foo trac project environment:
trac-admin /var/lib/trac/foo initenv
- 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
- Grant anonymous TRAC_ADMIN permissions:
trac-admin /var/lib/trac/foo permission add anonymous TRAC_ADMIN
- Run trac through tracd just to see everything worked:
tracd --port 8000 /var/lib/trac/foo
- 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.
- Configure apache and wsgi using exactly the info and paths Stefan provided.
- Grant everyone 777 on /var/lib/trac:
chmod -R 777 /var/lib/trac
- (Re-)start apache:
- Verify trac was up and running, with basic authentication working, using the browser.
- Download the egg files for the TestManagerForTracPlugin from sourceforge and extract the archive.
- 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.
- Install the TracGenericWorkflowPlugin the same way. This asks for a database upgrade.
- 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
- Restart apache, just to be sure its cache is updated:
- Refresh your browser (F5). The trac admin page should show the new plugin in place.
- Install TestManagerForTracPlugin the same way. This asks for another database upgrade.
- 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
- Restart apache. This time is actually required:
- Refresh your browser. The trac admin page should show the three installed plugins.
- Click on the Test Manager tab in Trac's top navigation bar to start using the new plugins.