Omc-svn-access

Subversion Instructions

Browse the Subversion Tree

Browsing the Subversion tree gives you a great view into the current status of this project's code. You may also view the complete histories of any file in the repository.

• Browse Subversion Repository

Anonymous Subversion Access

To view the contents of a subversion repository you can use the ls command.

svn ls https://forgesvn1.novell.com/svn/omc

The anonymous user has the password 'anonymous'. If you have not been given commit access to this project, you can still check-out all of the files in the Subversion repository for this project through anonymous access. This can be done with the following command:

svn checkout https://forgesvn1.novell.com/svn/omc

You can check out code for a single sub-project of omc using the following command, replacing sub-project with the name of the sub-project:

svn checkout https://forgesvn1.novell.com/svn/omc/sub-project

If you want to get just the main working code, and not all tags and branches, you could optionally use:

svn checkout https://forgesvn1.novell.com/svn/omc/sub-project/trunk

Developer Subversion Access

If you have been given commit access to the panther project, you may use all of the functionality provided by Subversion. For the full documentation on Subversion, you can visit their website at http://subversion.tigris.org.

The most common things you will be doing with Subversion are importing your project (initially), checking it out, updating your local copy with the repository and checking in changes.

If you are adding a new sub-project to omc and your new sub-project's files are not yet in Subversion, you must start by importing your files into the repository. To do this, you should change to the topmost directory of your sub-project's files and enter something like the following:

svn import local_dir https://forgesvn1.novell.com/svn/omc/repo_dir

In the above command, we are telling Subversion to recursively copy everything in the local_dir directory into repo_dir directory in your repository. If repo_dir does not exist it will be created.

Note that each sub-project has its own trunk, tags, and branches directories. It is your responsibility to have this directory structure before importing the new sub-project.

Once the project has been imported, you can do the check-out, update and check-in operations anytime you deem it appropriate.

Now you can get your own private copy of all the project files in Subversion by performing the checkout command. You can do this with the following command:

svn checkout https://forgesvn1.novell.com/svn/omc/repo_dir

repo_dir could be replaced with any valid directory in the repository. If you don't want to get all tags and branches, you could optionally use:

svn checkout https://forgesvn1.novell.com/svn/omc/repo_dir/trunk

The Subversion update command is used for downloading all changes that have been made to files in the Subversion repository to your local copy. If another developer has changed a file that you have also changed in your local copy, the changes will be merged together. Sometimes a merge is required but cannot be completed. This condition produces a conflict. If there are any conflicts during the update process, they will appear in the output of the command. Under almost all conditions, an update operation must be performed before a check-in operation. If you check-in before doing an update, you run the risk of overwriting someone else's changes! To perform a Subversion update, you should change to the root directory of your local copy of the project files and issue the following command:

svn update

At some point in time, you will want to commit the changes that you have made to your local copy of the project files. This is a multi-phased process that should be as follows:

• Execute a Subversion update operation (described above).
• Fix any problems that may have surfaced from the update, such as failed merges(conflicts), etc...
• Execute the actual Subversion commit operation

When you are ready to commit your changes to the repository , change to any directory in your local copy of the project files and issue the following command:

svn commit --message "My list of changes"

This will commit all changes in the current directory and any of it's sub-directories to the remote repository.

Again, Subversion has much more functionality than what is described here. We encorage you to read the documentation on their site, http://subversion.tigris.org/.

Subversion over SSH

Subversion access is also available over SSH for developers. Both the SSH and https protocols access the same repository. Anonymous access of SSH is no longer allowed. SSH key based access is available so that developers can create automated scripts to work with their repositories. To use ssh access you will use the same commands as above is two slite changes. You will replace the https protocol with svn+ssh. You will also need to add your username to the domain name separated with an @ symbol (username@forgesvn1.novell.com).

Examples:

svn import local_dir svn+ssh://username@forgesvn1.novell.com/svn/omc/repo_dir
svn checkout svn+ssh://username@forgesvn1.novell.com/svn/omc/repo_dir

Mount your repository using Secure WebDAV

The subversion repositories can be mounted using Secure WebDAV. Linux, Mac and Windows all support mounting WebDAV folders. There could be significant issues using your repository this way, but it is available if you need it.

Nautilus

From the File menu select Connect to Server. Select Secure WebDAV as the service type. The server is forgesvn1.novell.com, the folder is /svn/omc, put in your username, and any name you want to use for the connection. An icon will appear on your desktop representing this connection after you click the Connect button.

Konqueror

In the URL bar type webdavs://forgesvn1.novell.com/svn/omc. You will be prompted for a username and password when you try to perform a write operation.

OS X

Select Connect to Server from the Finder's Go menu. Use https://forgesvn1.novell.com/svn/omc as the server address and then click Connect. This will place an icon on the desktop just like any other mounted drive.

Windows

Go to Network Places and select the option to Add a new network place. Use https://forgesvn1.novell.com/svn/omc as the URL. Supply your username and password when you are prompted for authentication. This may have problems in Windows XP. Please see the redbook for more information.

Others

There is more documentation available about other WebDAV Clients as well as general WebDAV/DeltaV information in the subversion redbook.

Subversion on Windows with TortoiseSVN

TortoiseSVN gives you the ability to perform Subversion functions directly from Windows Explorer. You can check out, update, commit, see diffs and so forth by right clicking on the file or folder. You can download TortoiseSVN from their website as http://tortoisesvn.tigris.org/. It is easy to install and use, and it works very well.