This document describes how to install Sublime on a Subversion server that has been configured for Active Directory or LDAP authentication using Apache.
Before you install Sublime you should make sure your server has Apache installed and configured to support LDAP or Active Directory authentication. For more information, see this
Before proceeding, configure the following points concerning Sublime support for Apache configurations.
- The username attribute must be sAMAccountName. Although mod_authnz_ldap allows you to choose which attribute should be used as the username, Sublime requires that you use sAMAccountName.
- Sublime does not yet support path-based permissions within a repository. Permissions are granted for the entire repository only. If you are currently using path-based permissions within your existing repositories you may not want to manage those repositories with Sublime until this feature is supported.
If Apache is currently listening on Port 80 you should either stop the Apache service or configure it to listen on a different port while you install Sublime. After Sublime has been installed you may change back to Port 80.
After Sublime has been installed and you have completed the final configuration steps, you should complete the following:
Sublime and Apache each need their own TCP port. The first step is to decide which port Sublime should use and which port Apache should use. This will impact the URL users use to access Sublime and the URL users use to access their repositories.
For example, if you want Sublime to use port 80 and Apache to use port 8080, users will access Sublime by navigating to
http://yourserver while repositories can be checked out from
http://yourserver:8080. Once you have chosen a port for Apache and Sublime, you can configure the Sublime website using the IIS Management Console and edit your httpd.conf file to change Apache’s listening port.
You may need to reset IIS and the Apache service after making these changes.
There are two settings that should be configured within Sublime: Repository Path and Repository Access URL. For both, open Sublime, navigate to the Administration pages, and click on the Settings tab.
Repository Path. If you have existing repositories change this path to point at the folder containing your repositories (i.e. C:\svn_repository).
Remote Access URL. Set this to match your Apache configuration for the port number and path to your repositories. For example, if Apache is set to listen on port 8080, and your repositories are hosted at the location of
/svn, you would enter
http://servername:8080/svn as your Remote Access URL.
To allow Sublime to manage permissions for your existing repositories, you must move your permission settings from the existing access file into Sublime’s authz file.
binfolder in your Sublime installation directory (i.e. C:\Program Files\Sublime\bin)
AuthzSVNAccessFile "C:/Program Files/Sublime/bin/authz")
Sublime should pick up your existing permissions at this point. You can confirm this by browsing to an existing repository in Sublime and checking which users have access.
From this point on, the authz file in your Sublime folder will be used to manage access. You may delete your old access file if you like.