18.1 Installing a Subversion Server on Windows

You can either install a Subversion server or use an existing Subversion server. Designer’s version control works with Subversion server platforms up through version 1.5.x.

This section provides a quick start for a basic Subversion server on Windows to use with Designer for Identity Manager. For more in-depth information on installing Subversion on Windows and on other platforms, see Subversion’s installation documentation at Installing Subversion.

18.1.1 Downloading and Installing the Server

  1. Go to the Tigris.org Web site and download the most recent 1.5.x version of Subversion..

  2. Run the installer and accept the license agreement.

  3. Specify the location to install Subversion.

  4. Specify a location in the Start menu.

  5. Follow the on-screen instructions to complete the installation.

18.1.2 Configuring the Server

  1. Use Windows Explorer to create a directory to contain the Subversion server repository. You will seldom open this directory manually.

  2. Run the svnadmin create command to create the repository at that directory location:

    svnadmin create [location_of_Subversion_repository]

  3. Go to the [location_of_Subversion_repository]\conf directory, which was created when you installed the Subversion server.

  4. Edit the svnserve.conf file by uncommenting the following lines in the General section (there should be no spaces at the beginning of the lines):

    Line to Uncomment

    Result

    anon-access = read

    Anonymous users can read your repository.

    auth-access = write

    Authenticated users can edit your repository.

    password-db = passwd

    Usernames and passwords are stored in a file named passwd in your conf directory.

  5. Edit the passwd file in the same directory.

  6. Remove the sample users from the Users section and add your own users.

  7. Open a command prompt and start your server by using the following command:

    svnserve --daemon --root [location_of_Subversion_repository]

  8. Open a second command prompt.

  9. Create a trunk folder in your repository with the following command:

    svn mkdir -m "Creating a trunk directory." svn://localhost/trunk

  10. Authenticate to Subversion.

    If your username is the same as your Windows username, enter your password. Otherwise, press Enter at the password prompt and enter a username when prompted.

    You can also access this server from other computers by substituting localhost for the network name of the server machine in the URL.

You are now ready to import or add projects to version control by using Designer for Identity Manager. You might want to create a more complete directory structure before adding Identity Manager projects. For more information on how to best use Subversion with Designer’s version control, see Section E.0, Version Control with Subversion and Identity Manager Designer.