wiki:faq/setup-trac

Version 14 (modified by Jackrabbit, 7 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. You might want to read this intro to MFPL hosting first if this is the first site you're setting up on MFPL servers.

Several of our members have successfully installed trac - to read about their experiences, please see tickets #2107 and #2582.

  • 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
    
  • 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
    

Note: If you want to install a newer version of trac, you can work with what you find on this blog. We should have a more definitive write up about how to do this specifically for our servers (coming soon?).