= Trac on Fedora Core =

Installing Trac On Fedora Core 4 (and higher) is easy with Yum and involves only 3 steps:

1) Verify you have configured Yum to use the Extras repository (which is enabled by default in Fedora Core 4 and higher)
and run the following command in a terminal window:

{{{
  $ sudo yum install trac
}}}

Yum will take care of all dependencies on which the Trac package depends (including the python-clearsilver package) and will fetch and install them for you automatically.

2) Create a new project environment. An environment is basically a directory that contains a human-readable configuration file and various other files and directories.

Create a subverion repository if you don't already have one, for example in ''/var/svn'':
{{{
 $ sudo mkdir -p /var/svn
 $ sudo svnadmin create  --fs-type fsfs /var/svn
}}}

Next you need to decide where to store your trac project and create the directory, for example in the new directory /var/trac:
{{{
 $ sudo mkdir -p  /var/trac
}}}

Then create a new environment using [wiki:TracAdmin trac-admin], as in this example for project ''foobar'' 
{{{
 $ sudo trac-admin /var/trac/foobar initenv
}}}

Now make it owned by apache:
{{{
 $ sudo chown -R apache /var/trac
 $ sudo chown -R apache /var/svn
}}}

3) Next, you need to edit the file ''/etc/httpd/conf.d/trac.conf'' to point to your new project
environment, as in this example (using mod_python):

{{{
 <Location /foobar>
   SetHandler mod_python
   PythonHandler trac.web.modpython_frontend
   PythonOption TracEnv /var/trac/foobar
   PythonOption TracUriRoot /foobar
 </Location>
 <Location "/foobar/login">
   AuthType Basic
   AuthName "alexandria"
   AuthUserFile /opt/trac/trac.htpasswd
   Require valid-user
 </Location>
}}}

The example above assumes you have a trac project environment setup in ''/var/trac/foobar/'' directory, described in step 2 and a htpasswd file in /opt/trac/trac.htpasswd for authentication purposes (see also wiki:TracModPython). 

You will need to restart apache after editing trac.conf:

{{{
  $ sudo service httpd restart
}}}

Verify your Trac installation by pointing your browser at the correct URL for your Trac server.

Notes on the Fedora Extras Trac package:

 * trac.cgi and trac.fcgi are installed in /var/www/cgi-bin/
 * apache webserver config file is installed in /etc/httpd/conf.d/trac.conf

If you happen to come across any packaging issues, feature requests or problems on Fedora, you can submit a bugzilla bug for the Trac package at [https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=174546].

Be sure to check out the generic installation instructions in the [wiki:TracGuide TracGuide]


Take care of permission on Fedora Core 4: it seems that the /var/trac/foobar needs to be owned by apache:apache.