Website:Subversion

Status

Pending code review, this service is ready to be considered beta, meaning we know of no reason it wouldn't be stable but it is not yet thoroughly tested.

For Users

NOTE: Should you ever get "Connection Refused" when attempting to access svn, just try again in a minute. svn has to restart somewhat often and if you happen to hit it in small window it will be down.

Configuration

To set up your subversion on UGCS:

• Make the directory ~/public/svn, if it doesn't already exist (mkdir ~/public/svn)
• Give user svn permissions on it (fs sa ~/public/svn svn rlidwka)
• Create/move repositories somewhere under ~/public/svn
• Set up users and permissions in ~/public/svn/REPOSITORY/conf [see below for help]
• Access your repository ~/public/svn/REPOSITORY at any of the following:
  • svn://svn.ugcs.caltech.edu/USERNAME/REPOSITORY
  • svn://svn.ugcs.caltech.edu/~USERNAME/REPOSITORY
  • svn://svn.ugcs.net/USERNAME/REPOSITORY
  • svn://svn.ugcs.net/~USERNAME/REPOSITORY
• NOTE: Make sure you use fsfs for the storage mechanism when creating the repository. This is currently the default, but you can pass --fs-type fsfs to svnadmin to be on the safe side. If you don't know what this means, just follow the above directions and you'll be fine.

Tutorial

• If you don't have it already, create ~/public/svn. and type: fs sa ~/public/svn svn rlidwka
• Anything in ~/public/svn will be accessible at svn://svn.ugcs.caltech.edu/USERNAME. You can also use svn://svn.ugcs.net/USERNAME. A tilde before the username is optional but not required.
• To create a new repository in less than two minutes:
  • type: cd ~/public/svn
  • type: svnadmin create REPOSITORYNAME --fs-type fsfs
  • type: cd REPOSITORYNAME/conf
  • edit the file passwd. At the bottom, in the users section, add one line per person who needs to be able to access the server. Each line is formatted like USERNAME=PASSWORD. Don't forget to include one for yourself.
  • edit the file svnserve.conf. Add the following under the [general] section:
    • anon-access = none # Can also be read or write to let anyone in the world perform that op.
    • auth-access = write # Can also be read or none to control what users in the passwd file can do. Write permission implies read permission
    • password-db = passwd
  • Done! You can access your new repository at svn://svn.ugcs.caltech.edu/USERNAME/REPOSITORYNAME
  • Note: You will need to add an entry for yourself in the passwd file as well, it is NOT the same as your ugcs password. DO NOT REUSE YOUR UGCS PASSWORD! Since you only have to enter the svn password once on your computer (svn will remember it for that repository), the first time you access the repository on a given machine, choose something strong; you can always check the passwd file later if you forget.