About Software Configuration Management with Subversion

About Software Configuration Management

Projects on this site can use the Software Configuration Management (SCM) tool for version control. SCM relies on Subversion, an open source version control tool designed to be an enhanced successor to CVS. Most CVS users can start using Subversion without difficulty. If you are new to Subversion, the best way to learn is through hands-on experience. This guide will help you to get up to speed rapidly.

Installing Subversion

Subversion is a client-server system. The Subversion repository is maintained on the project web server. Subversion clients run on users' machines and connect to the Subversion server via the Internet. You must have a Subversion client on your local machine to access the Subversion server for projects hosted on this site. Clients are available for nearly all platforms. You can download a client for your operating system from the Subversion project download page .

While some people like using the Subversion command-line client, svn during development, TortoiseSVN is a good choice for users who prefer graphical interfaces. This guide covers instructions for command-line Subversion only.

Further Subversion documentation and resources

For a step-by-step orientation, Version Control with Subversion is highly recommended. Much of the help information on this site comes from this definitive book. For more and the latest on Subversion, visit the Subversion Project website.

For a side-by-side comparison of commands in Subversion and CVS, see "Crossover" Guide for CVS Users. For helpful tips on how to get the most out of Subversion in your projects, see Subversion Best Practices.

About TortoiseSVN

Installing TortoiseSVN

  1. From the TortoiseSVN install page http://tortoisesvn.net/downloads , download the version you would like to install. The latest version is the best option.
  2. Double click the installer icon and click Next. Change the directory into which to install TortoiseSVN or accept the default.
  3. Select "Install for all users" and click Next.
  4. TortoiseSVN starts installing the required files in the path you specified.
  5. After the installation you will be asked to reboot your computer.

    The reason why a reboot is required is that TortoiseSVN integrates with the Windows Explorer, which cannot be updated without a reboot.

    Note - TortoiseSVN is an Operating System level application.

  6. For more information about the working process of TortoiseSVN, visit the help files at http://tortoisesvn.net/docs/release/TortoiseSVN_en/index.html
  7. For other information on Frequently Asked Questions, translations etc. visit http://tortoisesvn.tigris.org/.

About WebDAV

Subversion is a partial DeltaV server, meaning that it normally only accepts write-requests from DeltaV clients (such as a Subversion client). The latest version of Subversion in CEE now supports a feature called "autoversioning." When the autoversioning feature is activated, generic WebDAV clients are allowed to write directly to a Subversion repository, and the server performs the commits silently.

Depending on the type of WebDAV client used, this allows non-technical users to receive the benefits of version control without having to learn how to use a Subversion client. They can create, edit, rename, copy and delete files as usual, without realizing that they are operating against a Subversion repository.

There are a number of different WebDAV clients available, ranging from standalone applications (such as Microsoft Word or Dreamweaver) to full-blown filesystem implementations, where the repository can be mounted as a network folder. Most modern operating systems have at least limited WebDAV functionality built-in; to learn more about the different WebDAV clients available, see this section of the book.

To activate this feature for your CollabNet project:

  1. Log in as a project owner.
  2. Select "Edit project", then "Tool Configuration."
  3. In the Tool Configuration screen, check the box next to "Subversion > auto-versioning"
  4. Save Settings.

Before activating this feature, be sure to understand the side-effects of this feature as described in the Subversion book. In particular, any commits performed by WebDAV clients will have generic, non-descriptive log messages. Also, because WebDAV clients tend to do many write operations, their activity may result in a large volume of commit email.

For a full explanation of the autoversioning feature, see Appendix C in the Subversion book.

Eclipse 3.0.2 With Subversion

IDE (Integrated Development Environment)

An Integrated Development environment (IDE) can be described as an application which provides the user the opportunity to perform tasks such as compiling, testing and debugging in a single development environment. You can perform all your tasks simultaneously without having to download separate applications for every operation. An example of an Integrated Development Environment is Eclipse.                  

About Eclipse

Eclipse is a software development project which is dedicated to providing a feature rich platform to develop a highly integrated tool. Eclipse is also an open source development project. More information about Eclipse can be found at:

http://www.eclipse.org/eclipse/faq/eclipse-faq.html#about_8.

To install Eclipse:

  1. In a browser, go to http://www.eclipse.org/downloads/index.php.
  2. On the download page you will see a lot of mirror sites. Since Eclipse is free software, it is hosted in mirror download servers located in countries around the world. Select a mirror site from where you would like to download. When you do that you will see a box asking you if you would like to save the file or open it. The Eclipse package is a zipped file. Click Save. Choose the path where you would like to download Eclipse.
  3. After you finish downloading Eclipse, go to the directory where Eclipse was downloaded and double-click the Eclipse icon. A dialog box appears asking for a workspace path. A workspace stores all your files and folders.
  4. Enter the workspace path. This path stores the files when you perform a checkout. A checkout is an operation which is performed when a file in the source archive must be modified. A checkout is done using Version Control softwares. Doing a checkout prevents other users from modifying the file .

About Subclipse

Subclipse

Subclipse is a plug-in for Eclipse. Subclipse integrates Subversion with Eclipse. When you use the Subclipse plug-in, it adds all the features of Subversion into Eclipse so that you do not have to download Subversion separately. Eclipse is an open source software development project which is dedicated to provide a feature rich platform to develop a highly integrated tool.

For more information on Eclispse, go to http://www.eclipse.org/eclipse/faq/eclipse-faq.html#about_8 .

Downloading and installing Subclipse:

The plug-in can be downloaded from http://subclipse.tigris.org You can also download Subclipse using Eclipse.

  1. Go to the location where you have downloaded Eclipse, for example D:\eclipse-SDK-3.0.2-win32 to install Subclipse.
  2. Double click the Eclipse icon to open Eclipse.
  3. To download Subclipse, click Help > Software Updates > Find and Install.
  4. Select the option Search For New Features To Install.
  5. Click Next.In the window that is displayed next click the New Remote Site.You will see a small window which will have two columns Name and URL.
  6. Enter Subclipse in the name column and in the URL area enter http://subclipse.tigris.org/update.
  7. Click OK. You can see Subclipse listed on the Sites to Install section. Select Subclipse.
  8. Click Next.Select the version of Subclipse, for example 0.9.30.
  9. Click Next.You will see a window where you have to select I Accept The Terms In The License Agreements.
  10. Click Next.You will see a window which will ask you for the location to install.
  11. Click Next.You will see a verification window.
  12. Click Install.After the installation process is over,you will be asked to reboot your workspace or Apply Changes. You can either restart the workspace or click Apply Changes as they are required for a complete installation of Subclipse.

Configuring a code repository in Subclipse

Subclipse allows you to work with Subversion code repositories. The following procedure describes how to configure a version control repository in Subclipse.

To configure a code repository in Subclipse:

Once the components have been installed, go to the Eclipse main window.

  1. From the main menu go to Window > Show View and select SVN Repository.
  2. Log in to CollabNet and create a project with Subversion as the versioning component.
  3. After you create a project go to Eclipse, click Window > Open Perspective > Other > Select SVN Repository Exploring .
  4. Click Ok. You will see the SVN Repository explorer on the right hand side of the main window. Right click Repository Location.
  5. Enter the URL, for example http://firstsvn.<domainname>.net/svn/firstsvn where "firstsvn" is the project you have created inCollabNet,"domainname" is the domain name, and "firstsvn" is the project name again.
  6. Click finish.
  7. Go to the SVN Repository explorer and expand the project from the navigation menu..
  8. You can see the contents of your project listed in folders.
  9. Now select a folder, right click and select "Checkout as Project."
  10. From the right side of the main window, right click the Resources view to go to the workspace. A workspace is the place where you store all your project files, make modifications, commit files and do other tasks. For example, let the workspace be C:\Test.

To edit a file using Subclipse:

  1. From the main menu go to Window > Show View and select SVN Repositories.
  2. You will see the project you have created in the SVN Repositories window.
  3. To edit a file, select a folder and click the plus symbol on the left of the folder. The folder will expand and its contents will be displayed.
  4. To make changes to a file, select the file from the folder and open it in the edit window on the right. Make the changes and click File > Save to save the file.
  5. To save the changes you made to the file, from the navigator menu on the left, select the modified file, right click and select Team > Commit.

You can also perform other operations such as Update and Revert using Subclipse.

If you have questions about Subclipse, visit the Subclipse site at

This site has a Frequently Asked Questions section, information about updates to the plug-in and other details related to Subclipse.