Alisdair Craik

Alisdair Craik

10 February 2014

PowerShell script for installing Mercurial 2.9 on IIS 8.5 / 2012 R2

So, I really like Mercurial. It's my source control tool of choice, but setting it up on IIS can be a pain. There aren't a whole heap of docs out there (at least not that I found), so you're left mostly piecing together blog posts from various older versions until you can build up a working config.

Having said that, John Yeary on his Java Evangelist blog has done the hard work for the 2.x versions. The following script is based on his post about setting up Mercurial 2.5.2 on IIS 7.5. Basically, I've scripted the manual steps he takes (reworked slightly for Merurial 2.9), which should give you a relatively pain free setup.

The following script will take you from blank server to a working hg host in a couple of minutes. I've only tested it on IIS 8.5 / 2012 R2, but it should work on previous versions. It gets you up to the point of an open server - to enable AD integration, SSL and the like, you'll want to jump over to John Yeary's blog to finish off the config. Anyway, here it is:

$VerbosePreference = 'Continue'

### Amend these URLs to swap out Mercurial / Python versions ###
$mercurialurl = ''
$pythonurl = ''
$exeurl = ''
$rewriteurl = ''

### Amend these paths to change default locations ###
$repoPath = 'C:\repos'
$parentSite = 'Default Web Site'
$virtualDirectory = 'hg'

$hgpath = 'C:\Python27\Lib\site-packages\mercurial\hgweb'
$testRepo = ([IO.Path]::Combine($repoPath, 'test'))
$location = '{0}/{1}' -f $parentSite, $virtualDirectory

$hgweb = @'
#!/usr/bin/env python
# See also
# Path to repo or hgweb config to serve (see 'hg help hgweb')
config = "{0}"

# Uncomment and adjust if Mercurial is not installed system-wide
# (consult "installed modules" path from 'hg debuginstall'):
#import sys; sys.path.insert(0, "/path/to/python/lib")

# Uncomment to send python tracebacks to the browser if an error occurs:
#import cgitb; cgitb.enable()

from mercurial import demandimport; demandimport.enable()
from mercurial.hgweb import hgweb, wsgicgi
application = hgweb(config)
'@ -f ([IO.Path]::Combine($hgPath, 'hgweb.config'))

$hgconfig = @'
encoding = UTF-8
allow_push = *
push_ssl = False
allowzip = True

test = {0}
'@ -f ([IO.Path]::Combine($repoPath, 'test'))

Function DownloadFileToTemp

    $fileName = []::GetFileName($url)
    $tmpFilePath = []::Combine($env:TEMP, $fileName)

    $wc = new-object System.Net.WebClient
    $wc.DownloadFile($url, $tmpFilePath)

    return $tmpFilePath

Write-Verbose ("Downloading Mercurial from '{0}'." -f $mercurialurl)
$mercurialmsi = DownloadFileToTemp $mercurialurl

Write-Verbose ("Downloading Python from '{0}'." -f $pythonurl)
$pythonmsi = DownloadFileToTemp $pythonurl

Write-Verbose ("Downloading Mercurial source installer from '{0}'." -f $exeurl)
$mixedexe = DownloadFileToTemp $exeurl

Write-Verbose 'Getting local WMI installer class.'
$installer = [wmiclass]"\\.\root\cimv2:Win32_Product"

Write-Verbose ("Installing Python MSI from '{0}'." -f $pythonmsi)
[void]($installer.Install($pythonmsi, 'TARGETDIR=C:\Python27', $true))

Write-Verbose ("Installing Mercurial MSI from '{0}'." -f $mercurialmsi)
[void]($installer.Install($mercurialmsi, $null, $true))

Write-Verbose 'Starting Mercurial source installer (Next, next, next)...'
Start-Process $mixedexe -PassThru | Wait-Process

Write-Verbose 'Installing IIS and required features, if missing.'
[void](Add-WindowsFeature @("Web-CGI", "Web-ISAPI-Ext", "Web-ISAPI-Filter", "Web-Filtering", "Web-Basic-Auth", "Web-Windows-Auth") -IncludeManagementTools)

Write-Verbose ('Creating virtual directory ({0}).' -f $virtualDirectory)
[void](New-WebVirtualDirectory -Name $virtualDirectory -Site $parentSite -PhysicalPath $hgpath)

Write-Verbose 'Adding Python Script Handler for CGI.'
[void](New-WebHandler -Name Python -Path *.cgi -PSPath IIS: -ScriptProcessor 'c:\Python27\python.exe -u %s' -Verb '*' -Modules CgiModule -ResourceType File -Location $location)

Write-Verbose 'Adding Python CGI restriction allow rule.'
[void](Add-WebConfiguration -Filter "/system.webServer/security/isapiCgiRestriction" -PSPath 'IIS:' -Value @{path = 'c:\Python27\python.exe -u %s'; allowed = 'true' })

Write-Verbose 'Creating hgweb.cgi script.'
$hgweb | Out-File ([IO.PATH]::Combine($hgpath, 'hgweb.cgi')) -Force -Encoding ASCII

Write-Verbose 'Creating hgweb.config.'
$hgconfig | Out-File ([IO.PATH]::Combine($hgpath, 'hgweb.config')) -Force -Encoding ASCII

Write-Verbose 'Checking for test repo.'
if(!(Test-Path $testRepo))
    Write-Verbose 'Creating test repo.'
    [void](md $testRepo)
    [void](& 'c:\Program Files\Mercurial\hg.exe' init $testRepo)

Write-Verbose 'Opening Mercurial on local host.'
Start-Process ('http://localhost/{0}/hgweb.cgi' -f $virtualDirectory)

One last thing - the Mercurial source installer requires you to click Next, Next Next. I couldn't figure out a way to do a silent install of the thing, so if anyone knows how I'd love to hear it.

Update: I've also scripted a section for URL rewrites. I've left it separate from the original script because it adds a bit of complexity for something that's entirely optional. If you want it, add the following lines to the end of the script above:

$rewriteurl = ''

Write-Verbose "Checking for IIS rewrite module."
if((Get-WebGlobalModule ReWriteModule) -eq $null)
    Write-Verbose ("Downloading IIS rewrite module from '{0}'." -f $rewriteurl)
    $rewritemsi = DownloadFileToTemp $rewriteurl

    Write-Verbose ("Installing IIS rewrite MSI from '{0}'." -f $rewritemsi)
    [void]($installer.Install($rewritemsi, $null, $true))

Write-Verbose "Creating hgweb.cgi rewrite rule."
Add-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST'  -filter "system.webServer/rewrite/rules" -name "." -value @{name='hgweb.cgi';patternSyntax='Wildcard'} -Location $location
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST'  -filter "system.webServer/rewrite/rules/rule[@name='hgweb.cgi']/match" -name "url" -value "*" -Location $location

Add-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST'  -filter "system.webServer/rewrite/rules/rule[@name='hgweb.cgi']/conditions" -name "." -value @{input='{REQUEST_FILENAME}';matchType='IsFile';negate='True'} -Location $location
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST'  -filter "system.webServer/rewrite/rules/rule[@name='hgweb.cgi']/action" -name "type" -value "Rewrite" -Location $location
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST'  -filter "system.webServer/rewrite/rules/rule[@name='hgweb.cgi']/action" -name "url" -value "hgweb.cgi/{R:1}" -Location $location

Write-Verbose "Amending hgweb.config for rewrite rule."
$hgconfigPath = ([IO.PATH]::Combine($hgpath, 'hgweb.config'))
$hgcontent = Get-Content $hgconfigPath
$idx = $hgcontent.IndexOf('[web]')
$amendedcontent = for($i = 0; $i -lt $hgcontent.Length; $i++){$hgcontent[$i];if($i -eq $idx){'baseurl = /hg'}}
$amendedcontent | Out-File $hgconfigPath -Encoding ascii
<< Back To The Blog