Setting up SVN access to the DIVA project (Mac OSX 10.5).

First you want to install the version control system (Subversion SVN):

• Download and install SVN from the Subversion website: http://subversion.tigris.org/

One convenient way of accessing this system is through svnX. svnX needs SVN to work, so make sure that you have already completed the previous step.

• Download and install svnX from the Apple website: http://www.apple.com/downloads/macosx/development_tools/svnx.html

The DIVA project is stored in a repository on the MAGIC server. To access that repository, you will need to set up a RSA key to securely access the repository.

• Before you do anything, make sure that you have a MAGIC account (user name and password) to access the MAGIC server at artisynth.magic.ubc.ca.
• Open up a terminal window and carry out the following commands (these steps were found at http://de-compile.blogspot.com/2008/03/site5-subversion-setup.html starting near the middle of the page):
  • Generate a key from your local computer.
    • ssh-keygen -t rsa -f ~/.ssh/id_rsa -C "key@local"
  • Create a similar directory on your shared host with appropriate permissions.
    • ssh <your username>@artisynth.magic.ubc.ca 'mkdir ~/.ssh;chmod 700 ~/.ssh'
  • Copy your file from your local computer to the server.
    • scp ~/.ssh/id_rsa.pub <your username>@yourhost.com:~/.ssh/authorized_keys
    • (Later, you can edit this file to add additional keys to access the shared host from different machines)
  • Now, change permissions for this file.
    • ssh <your username>@yourhost.com 'chmod 600 ~/.ssh/authorized_keys'

Now, you are ready to check out a copy of the project from the repository

• Create a directory in your local machine to store the working copy
• Checkout working copy. You can use the command line, or you can use svnX. In svnX in the repositories window, add a new repository, setting the path to:
  • svn+ssh://<your_username>@artisynth.magic.ubc.ca/ubc/magic/research/Shared/SVNRoot/Projects/DIVA
  • Leave the username field blank
  • If you do not have a password for your keys, leave that field blank (I have not tried it with a password)
  • Double click on the entry that you have added. You can now access the repository to checkout files

Troubleshooting:

• if access is denied, ensure that you are in the "magic" user group by ssh-ing to artisynth.magic.ubc.ca, and typing "groups"