This guide assumes you already have a Trac instance running. Please see our About Trac page if you want to learn about Trac or request an instance.

Frequently referenced terms in this guide:

username : the Maseeh College username of the person in charge of the Trac instance.
projectname: the name by which the Trac instance and subversion repository are referred to.

NOTE: The trac-admin command is only available on linux boxes such as linux.cecs.pdx.edu or CS Linux Lab boxes.

NOTE: Trac and Subversion are both located out of your home directory so they will not count against your quota. Our space is not unlimited so please don't store binary or other large files in your repository.

Quick Overview of locations and files you'll need to know to manage and access Trac and Subversion:

Trac
Web default URL: https://projects.cecs.pdx.edu/~username/projectname/
Filesystem Location: /www/trac/projectname
Permissions file for Trac and its matching subversion repository: /www/trac/projectname/htpasswd

Subversion
Web URL: https://projects.cecs.pdx.edu/svn/projectname

Trac
Your Trac website will be installed with a default set of pages. The front page will give you a guide to get started.

Trac and the subversion repository both share the same username/password file for simplicity (/www/trac/projectname/htpasswd)

Things you'll probably want to do...

• Add users (and yourself!) to your htpasswd file...
  • the htpasswd file stores usernames and passwords for Trac and your subversion repository
  • You'll need to add at least one user before you can import code into subversion
  • htpasswd -m /www/trac/projectname/htpasswd newusername
  • check out the manpage for htpasswd for more information.

• Edit permissions and configuration for your Trac site...
  • trac-admin /www/trac/projectname
  • Details on trac-admin
  • Read all about Trac

• Import code into subversion...
  • svn import mytree https://projects.cecs.pdx.edu/svn/projectname
  • Get familiar with Subversion and check out the Subversion Book

Subversion
We set up subversion repositories with a default set of permissions that only allows those in the htpasswd file to read/write to the repository and allows anyone to read/view the repository. If you require stricter permissions, we can set it up to only let those in the htpasswd file in. Just email support@cat.pdx.edu with your request. You can limit who can browse the repository from the Trac site by setting the BROWSER_VIEW to certain (or just to authenticated) users using trac-admin.

Advanced Options you may want to try once you know your way around

• Edit trac.ini ( /www/trac/projectname/conf/trac.ini ) where you can change... (carefully...)
  • banner link
  • project url
  • footer
  • project name
  • ...more

• Change the Trac templates
  • copy site template defaults from /usr/share/trac/templates to /www/trac/projectname/templates and point templates variable in /www/trac/projectname/conf/trac.ini to /www/trac/projectname/templates. Then you can edit the templates and it will use your project ones instead of the defaults.