Advomatic - Drupal Development, Hosting, Support, and Consulting – Advomatic builds websites for good causes using the open source content management system Drupal

Advomatic has given you the power to manage your code and code history through the use of the industry standard tool, Subversion.

Subversion (SVN) is a software revisioning system.

This document will demonstrate the use and administration of the client SVN server as it pertains to adding and removing repositories.
Additionally, this document will demonstrate how to set up and administer a new repository via the Warehouse application.

Further information on specific SVN commands and the SVN command structure can be found at http://svnbook.red-bean.com/en/1.5/index.html. This is the same reference manual used by the system administrators, actually.

Getting set up

First you will need access to your SVN server and be set up as an admin in Warehouse. Please email support@advomatic.com to have your logins set up on your SVN instance.

Additionally, you will need to have an Advomatic Systems Administrator make your user an admin in Warehouse.

Repository naming

Perhaps the most difficult part of this entire task is deciding what to name your new repository.

You should coordinate with your development team to come up with a name for your repository that makes sense. The generally accepted standard is to name the repository the same as the client token that is used elsewhere on the network. For example, If you were setting up a new client for the domain 'www.advomatic.com' there exists a client token 'advo'. Create the repository with the name 'advo' and create a user named 'advo' to go along with it, and you will find future administration much easier.

For ease of use, please do not use the period '.' in your naming convention. The use of the dash '-' or underscore '_' is encouraged as a substitute.

Creating a new repository

Once inside your server that will house your SVN repository, please run the following command:

This will put you into a handy dialog interface created by Advomatic. After pressing 'Continue' will asked for the repository name. Please enter that name.

You will be asked to confirm that name. Once you have done so, the system will build your repository and install the necessary code and files for that repository to function.

As reported by the onscreen tools, your repository should have been created.

Adding a repository to Warehouse

Warehouse is a graphical tool used to administer users as well as review the commits to the Subversion Repository you have just created.

Please log into the Warehouse Admin section and click on the text where it says 'New Repository'

This will bring up a window in which you enter the information for your new
repository. When finished click the 'Save' button:

You will want to create new users. Click on the 'Members' icon and follow the steps.

Click on 'Access' and select 'New Permission'.

This is the location to add any users requiring read or read/wright access to your new repository. Be aware of who you are granting permissions to as well as what permissions you are granting.

Once you have changed their permissions, you will want to click the button titled, 'Save' and you are done.

Removing a repository from Warehouse

In the event you no longer wish to maintain a particular repository, From the admin interface simply click the little red X.

Select 'OK' and you are done.

Deleting a repository

Great care should be taken to ensure you are removing the correct repository as
there is no "undo" button in the GNU Bourne Again SHell (bash). Restoration would be from backups and may result in a Systems Administration surchage.

To delete a repository from the svn server entirely, you will need to login to that server and
remove the folder containing the repository.

Testing & Troubleshooting

You should be able to browse your new repository with Warehouse by typing its
name into your web browser 'https://svn.CLIENT.advomatic.com/REPOSITORY_NAME'.
Additionally you can visit 'https://svn.CLIENT.advomatic.com/REPOSITORY_NAME' to test
the web_dav module, which serves the svn clients through apache.

As always, if you encounter any problems while using either Warehouse or SVN, please email support@advomatic.com