wiki:faq/setup-trac

Version 11 (modified by alfredo, 13 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.

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: See TracWiki for help on using the wiki.