20.1 Installing a Subversion Server

You can either install a Subversion server or use an existing Subversion server. Designer’s version control works with all supported Subversion server platforms.

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

20.1.1 Downloading and Installing the Server

  1. Download the most recent version of subversion file:

  2. Run the installer and accept the license agreement.

  3. Specify the location to install Subversion.

  4. For Windows, specify a location in the Start menu.

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

20.1.2 Configuring the Server

  1. Create a directory to contain the Subversion server repository.

  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 are using Windows, and 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 about how to best use Subversion with Designer’s version control, see Section E.0, Version Control with Subversion and Identity Manager Designer.

IMPORTANT:Designer is shipped with the SVN client version 1.5. You can use an use newer versions of the SVN server, because the SVN servers are backward compatible. However, if you are using the newer version of the SVN server, the client must communicate with the server using the svn:// or http:// protocols.

If you create a SVN repository on the local file system using an external client such as Tortoise SVN and then access the SVN repository through designer using file:/// protocol, Designer fails to work.