Table of Contents

Installing Microsoft Internet Information Services

Microsoft Windows Server 2008/Microsoft Windows 7

Run the following command in an Elevated Command Prompt:

dism /online /enable-feature /featurename:IIS-WebServerRole /featurename:IIS-WebServer /featurename:IIS-CommonHttpFeatures /featurename:IIS-Security /featurename:IIS-RequestFiltering /featurename:IIS-StaticContent /featurename:IIS-DefaultDocument /featurename:IIS-HttpErrors /featurename:IIS-HttpRedirect /featurename:IIS-ApplicationDevelopment /featurename:IIS-ISAPIExtensions /featurename:IIS-ISAPIFilter /featurename:IIS-HealthAndDiagnostics /featurename:IIS-HttpLogging /featurename:IIS-RequestMonitor /featurename:IIS-HttpTracing /featurename:IIS-Performance /featurename:IIS-HttpCompressionStatic /featurename:IIS-HttpCompressionDynamic /featurename:IIS-WebServerManagementTools /featurename:IIS-ManagementConsole /featurename:IIS-ManagementScriptingTools /featurename:WAS-WindowsActivationService /featurename:WAS-ProcessModel /featurename:WAS-ConfigurationAPI

Microsoft Windows Server 2012 and Later

Run the following command in an Elevated Command Prompt:

dism /online /enable-feature /featurename:NetFx4ServerFeatures /featurename:NetFx4 /featurename:NetFx4Extended-ASPNET45 /featurename:IIS-WebServerRole /featurename:IIS-WebServer /featurename:IIS-CommonHttpFeatures /featurename:IIS-Security /featurename:IIS-RequestFiltering /featurename:IIS-StaticContent /featurename:IIS-DefaultDocument /featurename:IIS-HttpErrors /featurename:IIS-HttpRedirect /featurename:IIS-ApplicationDevelopment /featurename:IIS-ApplicationInit /featurename:IIS-NetFxExtensibility45 /featurename:IIS-ISAPIExtensions /featurename:IIS-ISAPIFilter /featurename:IIS-ASPNET45 /featurename:IIS-HealthAndDiagnostics /featurename:IIS-HttpLogging /featurename:IIS-RequestMonitor /featurename:IIS-HttpTracing /featurename:IIS-Performance /featurename:IIS-HttpCompressionStatic /featurename:IIS-HttpCompressionDynamic /featurename:IIS-WebServerManagementTools /featurename:IIS-ManagementConsole /featurename:IIS-ManagementScriptingTools /featurename:WAS-WindowsActivationService /featurename:WAS-ProcessModel /featurename:WAS-ConfigurationAPI

When finished, confirm that the Web server works by opening up http://localhost/ in Internet Explorer.

Installing Microsoft .NET Framework

Download the appropriate installer:

• For 32-bit systems: Microsoft .NET Framework 4.0 and KB2600211
• For 64-bit systems: Microsoft .NET Framework 4.5

Follow the installer prompts. Note that a reboot might be required.

Registering ASP.NET in IIS

If you installed IIS after installing .NET Framework, there's an additional step you'll need to perform.

On a 32-bit system, run following commands in an Elevated Command Prompt:

%windir%\microsoft.net\framework\v4.0.30319\aspnet_regiis.exe -ir
iisreset

On a 64-bit system, run following commands in an Elevated Command Prompt:

%windir%\microsoft.net\framework64\v4.0.30319\aspnet_regiis.exe -ir
iisreset

Installing Microsoft SQL Server

Microsoft SQL Server 2008 Express is available free of charge and can be downloaded here. Note that there is a number of limitations for Express edition, notably:

• Constrained to a single CPU (in Microsoft SQL Server 2012 Express this limitation has been changed to "The lesser of one socket or four cores", so multi-threading is possible)
• 1 GB RAM
• 4 GB database size (raised to 10GB starting from Microsoft SQL Server 2008 R2 Express)

All of this is more than enough, though, to run HgLab and to scale it to hundreds of repositories.

Microsoft SQL Server, even Express edition, is a complex beast to install. See Installing SQL Server 2008 Express Guidance for instructions. If you have any questions, please contact HgLab Support.

You might also need to install Microsoft SQL Server 2008 Management Studio.

Creating Database

Connect to the Microsoft SQL Server instance and run the following script:

create database [hglab];
go
    
use [master]
create login [hglab] with 
    password = N'hglab', /* Be sure to change the password */
    default_database = [hglab], 
    check_expiration = off, 
    check_policy = off
go
    
use [hglab]
create user [hglab] for login [hglab]
exec sp_addrolemember N'db_datareader', N'hglab'
exec sp_addrolemember N'db_datawriter', N'hglab'
exec sp_addrolemember N'db_ddladmin', N'hglab'

Those with DBA-fu can tweak things accordingly.

Installing Mercurial

Mercurial is trivial to install. Download an MSI for Mercurial 3.6 or above from Mercurial Downloads (make sure that it matches your platform) and click through the installer.

Installing HgLab

Download HgLab Installer and follow prompts.

End-User License Agreement

The usual legalese you have to agree with to proceed with the installation.

Destination Folder

This is where HgLab will be installed. Please note that this is not where HgLab will be storing all its data, including repositories and logs.

Connection String

When setting a Connection String, stick to the following pattern:

data source={DATA-SOURCE};initial catalog={INITIAL-CATALOG};user id={USER-ID};password={PASSWORD}

• DATA-SOURCE is the hostname (or the IP address) of the machine Microsoft SQL Server is running on. (local) or . is used in case SQL Server is running on the same server with HgLab. Additionally, if you are running an Express version, you will need to specify Instance Name, which is separated by the backslash. Typical instance name for Express versions is SQLEXPRESS, so DATA-SOURCE for the Microsoft SQL Server Express running on the local machine will most likely be (local)\SQLEXPRESS.
• {INITIAL-CATALOG} is the name of the database created earlier.
• {USER-ID} and {PASSWORD} are the login and password, respectively, created earlier.

Refer to ConnectionStrings.com for more information on how to construct a connection string.

Home Directory

In addition to specifying the traditional Installation Directory, you'll also need to set HgLab Home Directory. This will be the location where HgLab will be keeping all the repositories, logs and other resources. Since HgLab does a lot of intensive disk I/O as part of its normal operation, it is advised to have the HgLab Home Directory on a reasonably fast device - ideally, on a SAS or an SSD disk.

Hg Executable Path

Web Server Configuration

This is where you decide how you would like to be accessing HgLab. Options are:

• Install HgLab as a new web site, which means that it will be hosted at a domain (i.e. http://hglab.example.com/)
• Install HgLab as a web application, meaning that it will be accessible in a "subdirectory" of an already existing domain (i.e. http://example.com/hglab/)

Either option is perfectly valid and HgLab supports both configurations equally well. Deciding on which option to pick is a matter of preference and infrastructure requirements.

After all this, it's just a matter of clicking "Next" and let the setup complete the installation.

Setting Up HgLab

When you first open up HgLab in your web browser, you will be greeted with a HgLab Setup page. Remember to get here first, because this is where the very first System Administrator user is created.

Upon completing HgLab Setup, you will then need to provide a License. You can get a full-featured 45-day Evaluation License or purchase a perpetual license.

And now you're all set.