Subversion guide

Repository access

Subversion needs a server running on the repository site, but it can be setup to use ssh to connect through ssh client/server and start a server temporarily for repository access. In order for this to work you need an ssh client besides the subversion client. In order to access a repository using SSH, you need to use svn+ssh as the protocol in the repository url. E.g., for the OpenModelica repository:

svn+ssh://user@remote.ida.liu.se/home/pelab/subversion/modelica/OpenModelica/trunk

You also need the svn server in the path when logging into the repository site. The server is called svnserve. You can check whether the server works by running the ssh client with a command to check for it in the path:

ssh user@repository-site "which svnserve"

"which" may also be run as "type -p" in bash. If you don't have it in the path you have to add it to a login-script. For example, tcsh uses .cshrc. For debugging, you can add the line "echo filename" first in your different login scripts to see which of them are actually processed when running a command using ssh as above.

At IDA adding the line

module add prog/subversion

to .cshrc is sufficient.

Windows clients

SVN
TortoiseSVN (http://tortoisesvn.tigris.org/) is a nice client, integrated into Explorer in WindowsXP.
SSH
TortoiseSVN provides an ssh client, but if it doesn't find its own client after installation, you can set it manually by right-clicking in Explorer and choosing TortoiseSVN->Settings->Network->SSH Client, and selecting TortoisePlink from TortoiseSVN installation directory. For example:

"C:\Program Files\TortoiseSVN\bin\TortoisePlink.exe"

Other free Windows SSH utilities can be found at the PuTTY site (http://www.chiark.greenend.org.uk/~sgtatham/putty/). Here, you can also find a public/private key generation tool (puttygen.exe) and an SSH agent (pageant.exe) to use a key with a passphrase without entering the passphrase each time you use it. After starting pageant, you should add your public key that you use to login to the repository.

Unix (and cygwin) clients

SVN
There is a command line client in cygwin and unix, called "svn". Try "svn help" for help. For command help, type svn command help, e.g. "svn checkout help".

SSH
You can use the command line ssh client called "ssh". There is an ssh agent called "ssh-agent" which needs a command to run as a subprocess, e.g. a shell. When the agent is running a key is adding with the command "ssh-add". For example:

ssh-agent bash
ssh-add
<enter passphrase>
...

More info

Subversion book: http://svnbook.red-bean.com/
Appendix A. Subversion for CVS Users: http://svnbook.red-bean.com/en/1.0/apa.html
Subversion-FAQ: http://subversion.tigris.org/faq.html

SSH FAQs:
http://www.csua.berkeley.edu/ssh-howto.html
http://mah.everybody.org/docs/ssh
http://kimmo.suominen.com/docs/ssh/