Open main menu

CDOT Wiki β

Trac

Trac is an open sourvce general purpose issue tracker. While Trac is well documented on its own Trac instance, a quick reference of the various configuration elements and commands are provided:

Trac Configuration files

  • /etc/httpd/conf.d/trac.conf
    • Apache Configuration
    • Handles mod_python, authentication options and splash page
  • /etc/httpd/htpasswd/trac.htpasswd
    • Users File
  • /etc/trac/trac.ini
    • Main configuration file. Options set here are applied to all instances
    • Plugins need to be controlled on an instance by instance basis
  • /var/www/html/trac/{INSTANCE_NAME/conf/trac.ini
    • Instance configuration file. Overrides option set in /etc/trac/trac.ini


Setting Up a new instance

  1. connect to mysql server
    1. CREATE DATABASE instancename DEFAULT CHARACTER SET utf8 COLLATE utf8_bin;
    2. grant all on instancename.* to 'tracuser'@'localhost' identified by 'password';
  2. On rome: run trac-admin instancename initenv
    1. connection string should be mysql://tracuser:password@localhost/instancename
  3. Profit

Handy Commands

  • Granting a user admin permissions
    • trac-admin /path/to/projenv permission add bob TRAC_ADMIN