[[TranslatedPages]] = Can I run a wiki and/or issue tracker/shared to do list? = May First/People Link supports a project called [http://trac.edgewall.com 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 [wiki:secure_shell using secure shell and the command line]. If you would like help setting up your Trac instance, please [/newticket open a new ticket] and we'd be happy to help you out. You might want to read [wiki:intro_to_MFPL_hosting 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. * Setup Trac. Be sure to execute this command as the same user that is the "Execute as user" in your web configuration (see the Web Config tab in your hosting order in the [https://members.mayfirst.org/cp members control panel]). * 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 }}} == Install Different Trac Version and Trac Plugins == '''Note:''' The below instructions were found on [http://blog.mornati.net/2011/09/06/install-trac-0-12-in-shared-host/ this blog]. Once logged into your server issue the following command to create the necessary directories: {{{ mkdir -p ~/.local/lib/python2.6/site-packages }}} '''Next install Genshi:''' {{{ easy_install-2.6 --install-dir $HOME/.local/lib/python2.6/site-packages/ Genshi }}} Example output: {{{ 0 rosstrac@buffy:~$ easy_install-2.6 --install-dir $HOME/.local/lib/python2.6/site-packages/ Genshi install_dir /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages/ Searching for Genshi Best match: Genshi 0.6 Adding Genshi 0.6 to easy-install.pth file Using /usr/lib/pymodules/python2.6 Processing dependencies for Genshi Finished processing dependencies for Genshi 0 rosstrac@buffy:~$ }}} '''Next install Babel:''' {{{ easy_install-2.6 --install-dir $HOME/.local/lib/python2.6/site-packages/ Babel }}} Example output: {{{ 0 rosstrac@buffy:~$ easy_install-2.6 --install-dir $HOME/.local/lib/python2.6/site-packages/ Babel install_dir /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages/ Searching for Babel Reading http://pypi.python.org/simple/Babel/ Reading http://babel.edgewall.org/ Reading http://babel.edgewall.org/wiki/Download Best match: Babel 0.9.6 Downloading http://pypi.python.org/packages/2.6/B/Babel/Babel-0.9.6-py2.6.egg#md5=e66698fb97c8dc0a7c6b7b86c91d62be Processing Babel-0.9.6-py2.6.egg creating /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages/Babel-0.9.6-py2.6.egg Extracting Babel-0.9.6-py2.6.egg to /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages Adding Babel 0.9.6 to easy-install.pth file Installing pybabel script to /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages/ Installed /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages/Babel-0.9.6-py2.6.egg Processing dependencies for Babel Finished processing dependencies for Babel 0 rosstrac@buffy:~$ }}} '''Finally install Trac==VERSION_NUMBER''' {{{ easy_install-2.6 --install-dir $HOME/.local/lib/python2.6/site-packages/ Trac==1.0 }}} Example output: {{{ 0 rosstrac@buffy:~$ easy_install-2.6 --install-dir $HOME/.local/lib/python2.6/site-packages/ Trac==1.0 install_dir /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages/ Searching for Trac==1.0 Reading http://pypi.python.org/simple/Trac/ Reading http://trac.edgewall.org/ Reading http://trac.edgewall.org/wiki/TracDownload Reading http://trac.edgewall.com/ Reading http://projects.edgewall.com/trac Reading http://projects.edgewall.com/trac/wiki/TracDownload Best match: Trac 1.0 Downloading http://pypi.python.org/packages/source/T/Trac/Trac-1.0.zip#md5=3dd2e883179879c8fa5b98c984f15058 Processing Trac-1.0.zip Running Trac-1.0/setup.py -q bdist_egg --dist-dir /tmp/easy_install-6Ver0k/Trac-1.0/egg-dist-tmp-uX_TB1 catalog 'trac/locale/el/LC_MESSAGES/messages.po' is marked as fuzzy, skipping catalog 'trac/locale/hy/LC_MESSAGES/messages.po' is marked as fuzzy, skipping catalog 'trac/locale/pl/LC_MESSAGES/messages.po' is marked as fuzzy, skipping catalog 'trac/locale/tr/LC_MESSAGES/messages.po' is marked as fuzzy, skipping catalog 'trac/locale/ko/LC_MESSAGES/messages.po' is marked as fuzzy, skipping catalog 'trac/locale/fa/LC_MESSAGES/messages.po' is marked as fuzzy, skipping catalog 'trac/locale/vi/LC_MESSAGES/messages.po' is marked as fuzzy, skipping Adding Trac 1.0 to easy-install.pth file Installing trac-admin script to /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages/ Installing tracd script to /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages/ Installed /home/members/ross/sites/trac.ross.mayfirst.org/users/rosstrac/.local/lib/python2.6/site-packages/Trac-1.0-py2.6.egg Processing dependencies for Trac==1.0 Finished processing dependencies for Trac==1.0 0 rosstrac@buffy:~$ }}} Next change your ~/.bashrc file to use the newly downloaded executable. Add the following line to your .bashrc file: {{{ export PATH="$HOME/.local/lib/python2.6/site-packages:$PATH" }}} ''Then run:''' {{{ source ~/.bashrc }}} '''Now run''' {{{ which trac-admin }}} You should see the correct local path to trac-admin. Now you should be able to follow the steps from earlier: * 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.* }}} * Add an alias to your apache configuration: {{{ ScriptAlias /trac /home/members/GROUPNAME/sites/DOMAIN/cgi-bin/trac/cgi-bin/trac.cgi }}}