Subversion

From Cncz
Revision as of 14:26, 30 May 2011 by Bram (talk | contribs) ([Introductie][Introduction])
Jump to: navigation, search

This page is under construction.

Introduction

Subversion

]

Subversion (SVN) is an open source version control system. It was designed to be used by software developers to be able to work on a project concurrently by providing a central repository containing the source code which is accessible over the network. SVN keeps track of all updates which are made (committed) to the files in the repository. It also prevents that an update by one of the team members overwrites the work of another member.

Although SVN focusses on the software development community it is very well possible to use it as a general purpose centralized system for sharing and maintaining information contained in all kinds of data files. And because SVN offers native support for repository access via HTTP (the communication protocol used for the World Wide Web), the repository can be browsed by any well behaved web browser. As such SVN is an easy to use file sharing tool.

Dedicated SVN [1] are available for many platforms including Windows, Mac, and Linux. With these clients all SVN features become available.

We have set up a subversion server for FNWI including an administrative interface to manage repositories and repository users. To be able to use the subversion server contact C&CZ to create a repository and appoint an owner. The owner of a repository can create additional users and grant access rights to his/her repository(ies). At the moment it is not possible to use your science account for authentication but we plan to add this possibility in the future. Therefore we urge repository owners to use science account names for users who already have a science account and to use account names starting with an underscore (_) for external users.

Getting Started

To be able to use our SVN server you need the following:

  • The URL of the repository;
  • an SVN username and password;
  • an SVN client installed on your computer.

Contact if you would like have a new SVN repository or user account.

The Repository

For remote access to our SVN repository the HTTPS protocol is used. The web address (or URL) of our repositories is typically of the form:

https://svn.science.ru.nl/repos/{repository name}

Authentication and Authorization

A subversion user can be owner of one or more repositories. Repository owners can controll user access to the repository and create new svn users if necessary. Account details such as your full name, email address and password can be changed through the web interface: https://svn.science.ru.nl

Repository Owners

From the Repository owners will create account names starting with an underscore for external users to prevent username conflicts in the future:

svn usernames
for science users external users
{science username} _{username}

Repository Users

If you have a science login name the repository owner should have created an account for you with the same account name. At the moment your SVN and science accounts are not connected, i.e. you can change the passwords of both independently. In the future this will probably change.

When you first connect to the repository your SVN client will prompt you for your account name and password. Most SVN clients will store/remember your credentials for subsequent repository access. The repository owner can change your access rights.

SVN client software

For all major platforms, the svn command line client is either available as part of the distribution or can downloaded seperately. Many clients are available, which are perhaps easier or more intuitive to use in different scenarios.

Graphical SVN clients

Suggested Graphical SVN clients
Platform Application at FNWI Description
Windows TortoiseSVN Optional for Managed PC's TortoiseSVN is a Windows shell extension, which gives feedback on the state of versioned items by adding overlays to the icons in the Windows Explorer. Repository commands can be executed from the enhanced context menu provided by Tortoise; GPL license.
Linux RadpidSVN Ubuntu systems It's a while since the latest release. Still one of the easiest to use open source SVN gui's for Linux and OSX; GPL license.
Mac OSX -

Using SVN

A great resource for learning svn is the book "Version Control with Subversion" wich is published online! Some basic usage is explained in the introduction section.

FAQ

How do I login to the Administrative Interface?

Visit https://svn.science.ru.nl/; Click 'Authenticate'.

I forgot my password, how can I reset it?

If you forgot your password you can reset it with the Forgot password? option. You have to specify your login name and the exact e-mail address as registered in the SVN database. You'll recieve an email with a new password. If this fails, please contact C&CZ.