Installation
Pre-Requisites
Before installing Sublime, make sure you have the following:
- Windows Server 2003 or 2008
- IIS and ASP.NET Installed
- .NET Framework 2.0 or higher installed
If you do not have those, the installer will not proceed.
Installation Process
The Sublime installation is designed to be simple and straight-forward. It will consist of the following steps:
- Running the Installer (which will also install Subversion if it isn’t detected)
- Finalizing the installation
- Configuring your Sublime server
The first two steps are covered in this guide. The First Time Configuration guide covers the last step.
Running the Installer
Once you have downloaded the installer from the Downloads page, simply double click the file to begin the installation. The installer will now go through the following steps:
Installing Sublime
On the welcome screen, click Next
On the next screen you may customize the location for Sublime and Subversion. If Subversion was detected on your server you will only see an option to install Sublime. To change the installation folder, simply click on the feature, and click the Browse button.
Next you are asked to enter an account for the Sublime web application to run as. This must be an existing account; the installer will not create it for you. You may use a local system account or a domain account.
Next you must choose where the Sublime web application will be hosted. You can choose to make it the root website on your server, or host it in a sub-directory beneath the default website.
If you want to use a friendly URL for your Sublime server such as http://sublime or http://code.mycompany.com, you should choose New Website at the root. After Sublime has been installed you can change the URL as described in the Advanced Website Configuration section of the Administrator Guide
Finally you will be presented with a confirmation screen. Ensure your choices are correct and then click Install.
Once the installation has been completed, you will be shown the default administrator username and password. A web browser will open and you will be asked to log in to Sublime. Log in with the default username and password shown to you by the installer. Once you log in you will continue on with the Final Configuration steps below.
Final Configuration
After logging in with the default administration account, you must complete a few final configuration steps. Each of these steps can later be changed from the administration pages if you change your mind or your server configuration changes.
Authentication Method
The first step is to choose your authentication method. The default choice is Subversion authentication using the SVNSERVE service. With this authentication method you create user accounts and manage them directly from within Sublime.
If you would like to use Active Directory or another LDAP store for authentication, you must have Apache installed and configured for LDAP authentication. Sublime will NOT configure Apache for you so only choose this option if you already have Apache configured, or are able to configure it yourself. See the Configuring Sublime with Apache section of the Administrator Guide for more information.
Subversion Install Location
The next step is to tell Sublime where you have Subversion installed. By default this is C:\Program Files\Subversion\bin. But if you have manually installed Subversion, it may be at a different path. Enter the path and click Verify.
LDAP / Active Directory Configuration
If you chose LDAP / Active Directory as your authentication type, you will now be asked to configure your LDAP settings. If you chose Subversion authentication, you can skip to the next section.
LDAP Search Root: Enter the path in your LDAP store where your user accounts are located. By default the root of your current domain is provided.
User Filter: Enter an LDAP query to further filter out objects that should not be considered valid users. The default filter will return only user accounts, excluding disabled users. You may further customize this to filter out service accounts, test accounts, etc.
Your Usersname: Enter your own domain username. You will be granted administrator access so that you may continue managing this server.
The Test Settings button will execute a query against your LDAP store using these settings and show you the user accounts returned. This can be useful for ensuring that the correct users will have access before continuing.
The View Sample Apache Config link will open a new window containing a portion of an Apache httpd.conf file based on these settings. This can be useful if you want to copy these settings into your Apache configuration file.
Summary
Next you will be presented with a summary of your choices. To confirm these choices, click the Apply button. Or you may click Back to return to the previous screens.
Once the service is online you can proceed with the rest of your configuration. The first thing you MUST do is change the administrator password. Click the Change the administrator password link to access the password change screen.
If you chose LDAP authentication, you will be prompted to log in after you click Apply. Log in with the username you entered on the LDAP configuration screen.
Final Checklist
After the server has been configured you will be presented with a final checklist of activities. Unless you are using LDAP authentication the first thing you MUST do is change the administrator password.
That’s the end of this installation document. For information on first-time server configuration, see the First Time Configuration walk-through.