= 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 subversion repository if you don't already have one, for example in ''/srv/svn'': {{{ $ sudo mkdir -p /srv/svn $ sudo svnadmin create --fs-type fsfs /srv/svn }}} Next you need to decide where to store your trac project and create the directory, for example in the new directory /srv/trac: {{{ $ sudo mkdir -p /srv/trac }}} Then create a new environment using [wiki:TracAdmin trac-admin], as in this example for project ''foobar'' {{{ $ sudo trac-admin /srv/trac/foobar initenv }}} Now make it owned by apache: {{{ $ sudo chown -R apache /srv/trac $ sudo chown -R apache /srv/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): {{{ SetEnv TRAC_ENV /srv/trac/foobar SetHandler mod_python PythonHandler trac.web.modpython_frontend PythonOption TracEnv /srv/trac/foobar AuthType Basic AuthName "alexandria" AuthUserFile /opt/trac/trac.htpasswd Require valid-user }}} The example above assumes you have a trac project environment setup in ''/srv/trac/foobar/'' directory, described in step 2 and an htpasswd file at /opt/trac/trac.htpasswd for authentication purposes (see also wiki:TracModPython (too generic)). You will need to tell Apache to reload configuration after editing trac.conf: {{{ $ sudo service httpd reload }}} Verify your Trac installation by pointing your browser at the correct URL for your Trac server (e.g. http://localhost/cgi-bin/trac.cgi). Notes on the Fedora Extras Trac package: * trac.cgi and trac.fcgi are installed in /var/www/cgi-bin/ (actually, /usr/share/trac/cgi-bin for FC5). * 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/easy_enter_bug.cgi]. Be sure to check out the generic installation instructions in the [wiki:TracGuide TracGuide] == SELinux == Fedora Core 5 ships with SELinux enabled by default. You need to make the Trac and Subversion directory accessible to the webserver. See [http://fedora.redhat.com/docs/selinux-apache-fc3/] for details. {{{ $ sudo chcon -R -t httpd_sys_content_t /srv/trac $ sudo chcon -R -t httpd_sys_content_t /srv/svn }}} If you put these under {{{/srv/www/trac}}} and {{{/srv/www/svn}}} instead, the {{{restorecon}}} command will know that these attributes should be preserved. Alternatively, you can teach {{{restorecon}}} about these two directories by adding the lines: {{{ /srv/trac(/.*)? system_u:object_r:httpd_sys_content_t /srv/svn(/.*)? system_u:object_r:httpd_sys_content_t }}} to the file {{{/etc/selinux/targeted/contexts/files/filecontexts.local}}}. You may need to create this file if it is not already present.