Subversion

What is Subversion?

Subversion is an open-source revision control software. This software is similar to CVS with added functionality. It currently runs on linux.uncc.edu on port 3690.

How do I request a repository?

You’ll need to email cci-techsupport (at) listserv.uncc.edu with the subject “Subversion Repository”. To eliminate confusion and possible fraud, please send this e-mail from your UNCC-provided e-mail address. Also, please answer the following questions in the email:

- name of the repository

- username and passwords for read/write access to the repository

- whether to allow anonymous logins to have read access or not

- the date that the repository can be deleted

Where do I find the client software for Subversion?

Some Linux distribution comes with rpm’s of the client software others you’ll have to download it from:

http://subversion.tigris.org/project_packages.html

We also have the client installed on the Linux machines in lab 335. Alternatively you can use a windows client software, one of the most popular is TortoiseSVN.

How do I use Subversion?

The best way to find out how to use subversion is read the free book at http://svnbook.red-bean.com/

Here is how to do some of the basic tasks in Subversion

For Linux:

Download for the repository

-svn checkout svn://linux01.uncc.edu:3690/swoodtest $HOME/checkout

swoodtest is the name of the repository

if you have anonymous reads turned off then you’ll also need to use --username parameter in order to supply a valid username and password

Adding a file to the repository

Assuming you downloaded with the command above:

-cd to $HOME/checkout

-create a file by using the command: echo testfile >testfile

-run the command: svn add testfile

-run the command: svn commit –m “added file testfile” --username swood3 (where swood3 is a valid user, it will then prompt you for a password)

Deleting a file from the repository

-run the command: cd $HOME/checkout

-delete the file from the local repository with the command: svn delete testfile

-commit changes to linux01 by running the command:

svn commit –m “deleted testfile” --username swood3 (it will prompt you for a password after hitting enter)

On Windows:

These instructions are for TortoiseSVN client.

Download for the repository

Right click on the Desktop->click on SVN checkout…

It will bring up the following window

This will download the swoodtest repository. After hitting OK it will then ask you if you want to create the directory if it doesn’t exist and then it will download the files.

Adding a file to the repository

Browse to the swoodtest directory you just created and create a file called testfile8.txt. Right click on the file and select Tortoise SVN->Add. You should see this:

Click OK.

Now right click the file again and SVN Commit, you should see

Add the message “Adding testfile8.txt” then click enter. It will prompt you for a valid username and password.

Deleting a file from the repository

Right click on the testfile8.txt that you created-> TortoiseSVN-> Delete.

Then right click inside the swoodtest directory and click on SVN Commit. You should see:

Type “deleted testfile8.txt” in the message file then click on OK. It will again prompt you for a valid username and password.