zondag 10 augustus 2008

Install Trac on Windows

"Trac is an enhanced wiki and issue tracking system for software development projects. Trac uses a minimalistic approach to web-based software project management. Our mission is to help developers write great software while staying out of the way. Trac should impose as little as possible on a team's established development process and policies."
source: http://trac.edgewall.org/

I'll quickly go over the different steps for installation on the Windows platform. This is a link to the installation guide.

Prerequisites


First of all you'll need a database on your system. You can use any of the following: SQLite, PostgreSQL, or MySQL. They all come with a windows installer so that should be fairly simple. I had MySQL already installed on my system so that was an easy choice for me. Next I created a database and user that Trac could use.

Trac is al written in python so that needs to be installed as well. Allthough python 2.6 s available I had to stick to 2.5 because setuptools didn't support 2.6 yet. So download a windows installer for Python 2.5 and run it. To easify using this Python install you could set the Python install folder and its Scripts folder to the windows PATH system variable.

If you are using mysql you'll also need the MySQL Python lib. For other dbms I have no clue.

Next install some required Python scripts for Trac. To begin with setuptools, again there is a windows installer for it.

Having setuptools installed you can now use it to install Genshi. That is a templating framework that Trac relies on. Execute the following command with python to get it:
easy_install Genshi

This easy_install script is in the Python Scripts folder of your install.

Trac


And now we are ready to install Trac. Even that has a windows installer available. All you need to do with these installers is point it to your Python install. You could also use setuptools again:
easy_install http://svn.edgewall.org/repos/trac/tags/trac-0.11


Start using


Now that all is installed you can configure a project with the following command:
trac-admin /path/to/myproject initenv

This script is also in the Python Scripts folder. An example of the path on a windows system is:
c://projects//project1

You will be asked for some options like projectname and database string. For MySQL this string is something like:
mysql://johndoe:letmein@localhost:3306/trac

Correct database configuration strings for other systems can be found here.
You should get a Congratulations! at the end of the script if all went well.

Next step is launch the trac system. This is done with the following command:
tracd --port 8000 /path/to/myproject
And then the system is available at http://localhost:8000/.

Have fun!

Geen opmerkingen:

Een reactie plaatsen