David Thomas Baker » Web » Installing SVN & Trac on a Plesk host

Some notes incase I need to do it again:

• create new domain in plesk to host my svn + trac install. chose php safe mode.
• setup ftp

• as root on the server install subversion and subversion-tools (using debian: apt-get install subversion subversion-tools libapache2-svn)
• as root create a new svn repo in the sites directory (ie: the one above httpdocs/)
  # cd /var/www/vhosts/mysite.com/
  # mkdir svn
  # svnadmin create svn/my_repo
• enable mod dav:
  # a2enmod dav
  # a2enmod dav_svn
  # /etc/init.d/apache2 restart
• time to edit the apache config for this site
  add the below to /var/www/vhosts/labs.webitor.com.au/conf/vhost.conf
  

           <Location /svn>
                   DAV svn
                   SVNParentPath /var/www/vhosts/mysite.com/svn/
                   AuthType Basic
                   AuthName "SVN"
                   AuthUserFile /var/www/vhosts/mysite.com/svn.password
                   Require valid-user
           </Location>

• Create the htpassword:
  # htpasswd -c /var/www/vhosts/mysite.com/svn.password username
• Update plesk to install your vhost.conf file
  #  /usr/local/psa/admin/sbin/websrvmng -u --vhost-name=mysite.com
• Now you should be right with svn, visit mysite.com/svn, enter your username/password and you should see a list of your repositories.

install trac

• download trac to server wget http://ftp.edgewall.com/pub/trac/Trac-0.11.tar.gz
• tar zxvf Trac-0.11.tar.gz
• cd Trac-0.11
• less INSTALL << read it
• apt-get install python
• apt-get install python-genshi
• apt-get install python-sqlite
• apt-get install libapache2-mod-python
• a2enmod mod_python
• /etc/init.d/apache2 restart
• apt-get install python-setuptools
• run the trac installer, tell it the path to your svn repo above
• python ./setup.py install
• trac-admin /var/www/vhost/mysite.com/trac/myproject initenv
• chown www-data: /var/www/vhost/mysite.com/trac -R
• vi conf/vhost.conf
  add these:
  <Location /trac/webitor>
     SetHandler mod_python
     PythonInterpreter main_interpreter
     PythonHandler trac.web.modpython_frontend
     PythonOption TracEnv /var/www/vhosts/mysite.com/trac/myproject
     PythonOption TracUriRoot /trac/webitor
  </Location>
  <Location /trac/webitor/login>
    AuthType Basic
    AuthName "trac"
    AuthUserFile /var/www/vhosts/mysite.com/svn.password 
  Require valid-user
  </Location>
• apt-get install python-subversion
• /etc/init.d/apache2 force-reload
• now hit mysite.com/trac/myproject and  you should see it! woot!

configure trac

• as root: 
  # trac-admin /var/www/vhosts/mysite.com/trac/myproject permission add myusername TRAC_ADMIN
• the above will give you a new "ADMIN" tab in the trac environment, so you can use the web based system to control settings instead of `trac-admin`

svn stuff

• you need to import you code into svn initially, like this:
  # cd /path/to/my/code/
  # svn import -m "initial import" http://mysite.com/svn/my_repo/project_name
      enter username/password for svn and away it goes
• after you have imported your code into svn, you have to "check out" a copy of the code again in order to work on it and have svn manage everything.
• two ways to get code out of svn, "check out" and "export.
• you use "check out" when you want to modify code and check it back in to svn.
• you use "export" when you want to grab a copy of the code to for example deploy on a server
• like this:
  # cd /path/to/where/i/want/to/edit/code
  # svn co http://mysite.com/svn/my_repo/project_name
• code will be checked out into a folder called "project_name" in the current directory.
• if you look in there you will see a bunch of .svn folders, they store all the svn repo details, dont change them :P
• after you modify some code, type
  # svn commit
• it will give you a list of all the changes you have made, and commit them back to the svn repo
• you can then use trac to browse through the source code and the revision history.