Agent SVN

Binding to an Existing Subversion Project

In general, to bind to an existing Subversion project requires the project name, the repository location (i.e. the AUX Path) and the working folder to be used by the project.

The project name and repository details are combined to produce a Subversion URL for the project as follows:

Subversion Project URL = AUX Path + Project Name

The AUX Path can be defined using the Agent SVN configuration dialog.

The Agent SVN project dialog will prompt for the project name and working folder details.

IMPORTANT: Notice how the AUX Path only defines a portion of the final URL and that is because each project will have a unique URL.

This means you have to be careful in defining the AUX Path, making sure it is the portion of the URL that is common to all projects.

Any portion or the URL specific to the project should always be defined in the Project Name.

File Protocol Example

For example, with an SVN repository located here: d:/projects/svnroot/

Assume the URL displayed for a given project is something like this: file:///d:/projects/svnroot/zeus/trunk

This means the Project Name should be: zeus/trunk

The AUX Path would be: file:///d:/projects/svnroot/

If instead the URL had been: file:///d:/projects/svnroot/trunk/zeus

The AUX Path remains as: file:///d:/projects/svnroot/

But the Project Name now becomes: trunk/zeus

HTTPS Protocol Example

For example, with an SVN repository located here: https://server.com/projects/svnroot/

Assume the URL displayed for a given project is something like this: https://server.com/projects/svnroot/zeus/trunk

This means the Project Name should be: zeus/trunk

The AUX Path would be: https://server.com/projects/svnroot/

If instead the URL had been: https://server.com/projects/svnroot/trunk/zeus

The AUX Path remains as: https://server.com/projects/svnroot/

But the Project Name now becomes: trunk/zeus

Working Copy Issues

For the binding to work, the project URL defined by these details must point to a valid Subversion project and the working folder must contain a valid working copy of the project (i.e. the project must have been checked out from the repository to this folder location).

If the following dialog is displayed, the project is not using a valid working copy, meaning the project files will need to be checked out from the Subversion repository.

---