Template:Subversion Instructions
Subversion Server Fingerprints
The https fingerprint is as follows:
SHA1: 1d:c7:e7:79:fc:8a:9c:f4:c4:4c:82:af:c6:ab:d9:d8:8e:a6:c5:fc MD5: de:54:53:41:4f:dc:dc:e6:8d:be:90:18:e9:3d:f5:cc
The rsa fingerprint is:
87:8b:eb:1d:55:c4:f5:05:79:35:fb:3c:03:fe:b7:b9
The dsa fingerprint is:
c9:13:75:1d:fa:20:ac:41:c7:03:ab:95:83:59:54:05
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.
Anonymous Subversion Access
To view the contents of a subversion repository you can use the ls command.
svn ls https://forgesvn1.novell.com/svn/{{{1}}}
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/{{{1}}}/trunk
Developer Subversion Access
If you have been given commit access to the {{{1}}} 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, checking it out, updating your local copy with the repository and checking in changes.
If your 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 project's files and enter something like the following:
svn import local_dir https://forgesvn1.novell.com/svn/{{{1}}}/trunk/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.
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/{{{1}}}/trunk/repo_dir
repo_dir could be replaced with any valid directory in the repository.
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/{{{1}}}/trunk/repo_dir svn checkout svn+ssh://username@forgesvn1.novell.com/svn/{{{1}}}/trunk/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/{{{1}}}, 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/{{{1}}}. 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/{{{1}}} 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/{{{1}}} 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.