wiki:faq/setup-trac

Version 9 (modified by Jamie McClelland, 11 years ago) (diff)

--

Can I run a wiki and/or issue tracker/shared to do list?

May First/People Link supports a project called Trac. Trac provides both a wiki and an issue tracker (which is like a collaborative shared to do list). This support site is running Trac - so if you are using this site you have a good idea of what Trac can do.

If you would like to use Trac, please follow these directions. These directions are for users comfortable with using secure shell and the command line. If you would like help setting up your Trac instance, please open a new ticket and we'd be happy to help you out.

  • Configure your site to use suExec
  • Setup Trac (you can do this step while waiting for the suExec step to be completed). Be sure to execute this step as the same user that you used to setup suExec.

  • Choose a directory to install your trac files (your domain.org/include/ directory is a good option). Replace words in capitals with values that make sense for your site:
    mkdir /home/members/GROUPNAME/sites/DOMAIN/include/trac
    mkdir /home/members/GROUPNAME/sites/DOMAIN/include/trac/PROJECTNAME
    
  • Initialize your project (the first question asks for the name of your project, for all other questions, you can safely choose the default values)
    trac-admin /home/members/GROUPNAME/sites/DOMAIN/include/trac/PROJECTNAME initenv
    

Depending on the version of Debian you are using, the remaining steps are different. If you are not sure whether your primary host is running Debian Etch or Debian Lenny, please post a ticket and we'll help you sort it out.

Debian Lenny

  • Create the trac cgi scripts using the trac deploy
    trac-admin /home/members/GROUPNAME/sites/DOMAIN/include/trac/PROJECTNAME deploy /home/members/GROUPNAME/sites/DOMAIN/cgi-bin/trac
    
  • Change the mode of the cgi files so that they are executable:
    chmod 755 /home/members/GROUPNAME/sites/DOMAIN/cgi-bin/trac/cgi-bin/trac.*
    
  • Optionally, add an alias to your apache configuration:
    ScriptAlias /trac /home/members/GROUPNAME/sites/DOMAIN/cgi-bin/trac/cgi-bin/trac.cgi
    

Debian Etch

  • Create a wrapper script to execute trac. Place a file in your cgi-bin directory trac.cgi with the contents:
    #!/bin/bash
    
    export TRAC_ENV='/home/members/GROUPNAME/sites/DOMAIN/include/trac/PROJECTNAME'
    exec /usr/share/trac/cgi-bin/trac.cgi
    
  • Make it executable:
    chmod 755 trac.cgi
    
  • Optionally, add an alias to your apache configuration:
    ScriptAlias /trac /home/members/GROUPNAME/sites/DOMAIN/cgi-bin/trac.cgi