hg clone http:\/\/selenic.com\/repo\/hg<\/pre>\n<\/div>\n<\/div>\nOnce downloaded, hgwebdir.cgi is in the root of the source distribution.<\/p>\n<\/a><\/p>\n
Install IIS<\/h3>\nUnder Windows Server 2008 you can install IIS under the Server Manager and clicking “Add Roles”. Proceed through the wizard and select the “Web Server (IIS)” role.<\/p>\n<\/a><\/p>\n
Under “Role Services” ensure that you enable Basic Authentication as well as CGI extensibility.<\/p>\n
<\/a><\/p>\n
Configure Python for IIS<\/h3>\nFirst, create a new directory under the wwwroot directory (C:inetpubwwwroot). I\u2019m going to call it “hg”.<\/p>\n
In the “Handler mappings” section for this directory select “Add Script Map”:<\/p>\n<\/a><\/p>\n
Next, enter\u00a0*.cgi<\/strong>\u00a0as the Request Path and the Executable Path should be set toc:Python25python.exe -u “%s”<\/strong>. Enter “Python” as the Name.<\/p>\n
<\/a><\/p>\n
At this point, you can test whether Python is working properly by creating a simple python script:<\/p>\n
\n\nprint 'Status: 200 OK'\nprint 'Content-type: text\/html'\nprint\n\nprint ''\nprint ''\nprint 'It works!<\/h1>'\nprint ''\nprint ''<\/pre>\n<\/div>\n<\/div>\nSave this in the directory that you created (C:inetpubwwwroothg) as test.cgi. Now, when you point your browser to http:\/\/localhost\/hg\/test.cgi<\/a> you should see the following output:<\/p>\n
<\/a><\/p>\n
Enabling hgwebdir.cgi<\/h3>\nFirst, copy hgwebdir.cgi (that you downloaded in step 3) and paste it into c:inetpubwwwroothg. Open this file in a text editor and scroll down to the end. The last lines should look like this:<\/p>\n\n\napplication = hgwebdir('hgweb.config')\nwsgicgi.launch(application)<\/pre>\n<\/div>\n<\/div>\nChange the first line to explicitly specify the path to your hg directory:<\/p>\n\n\napplication = hgwebdir('c:inetpubwwwroothghgweb.config')\nwsgicgi.launch(application)<\/pre>\n<\/div>\n<\/div>\nNext, you\u2019ll need to unzip the Mercurial library into c:inetpubwwwroothg. This can be found inLibrary.zip<\/strong>\u00a0under the\u00a0c:program files (x86)Mercurial<\/strong>\u00a0directory.<\/p>\n
You\u2019ll now need to copy the hgweb templates directory into c:inetpubwwwroothg. This is located in the root of the Mercurial installation directory (C:program files (x86)Mercurial)<\/p>\n
Finally, create a file called\u00a0hgweb.config<\/strong>\u00a0in c:inetpubwwwroothg. This file can be empty for now (we\u2019ll be putting something in it shortly).<\/p>\nAt this point, visiting\u00a0http:\/\/localhost\/hg\/hgwebdir.cgi<\/a><\/strong>\u00a0will show you an empty repository page:<\/p>\n
<\/a><\/p>\n
Configuring Repositories<\/h3>\nNow you\u2019ll need to create some repositories to publish. To do this, create a directory in the root of the C: drive called “Repositories”. This is where our repositories are going to be stored.<\/p>\n
Next, I\u2019m going to create a “test” repository by issuing the following commands:<\/p>\n\n\ncd c:repositories\nmkdir test\nhg init test<\/pre>\n<\/div>\n<\/div>\nNow we have a repository created, we need to tell hgwebdir where to find it. We can do this by opening up the hgweb.config file we created earlier and adding the following lines:<\/p>\n\n\n[collections]\nC:repositories = C:repositories<\/pre>\n<\/div>\n<\/div>\nNow, visiting http:\/\/localhost\/hg\/hgwebdir.cgi<\/a> should display our “test” repository<\/p>\n
<\/a><\/p>\n
At this point it should now be possible to clone the test repository from the server with the following command:<\/p>\n
hg clone http:\/\/localhost\/hg\/hgwebdir.cgi\/test<\/pre>\n<\/a><\/p>\n
Pretty URLs<\/h3>\nPersonally, I don\u2019t like having to specify “hgwebdir.cgi” in the URLs. I\u2019d much prefer something like\u00a0http:\/\/localhost\/hg\/test<\/a><\/strong>\u00a0to access my test repository.<\/p>\n
This can be achived by using the URL rewriting extension for IIS which can be\u00a0downloaded from Microsoft.<\/a><\/p>\n
Once installed, you can access the URL rewriting settings though the “URL Rewrite” section of the IIS Manager. Select the “hg” subdirectory in the Connections pane and then select “URL Rewrite”:<\/p>\n
<\/a><\/p>\n
In the URL rewrite section add a new blank rule. The name of the rule is going to be “rewrite to hgwebdir”.<\/p>\n
Under the “Match URL” section set “Using” to “Wildcards” and set the “Pattern” to “*”<\/p>\n
Under “Conditions” we want to ensure that we do not re-write URLs to any physical files, so add a condition for “Is Not a File”:<\/p>\n
<\/a><\/p>\n
In the “Rewrite URL” box at the bottom of the screen enter hgwebdir.cgi\/{R:1}<\/p>\n
The end result will look like this:<\/p>\n
<\/a><\/p>\n
Finally, re-open your hgweb.config and add the following section:<\/p>\n
\n\n[web]\nbaseurl = \/hg<\/pre>\n<\/div>\n<\/div>\nThis will ensure that hgwebdir generates urls to \/hg rather than \/hg\/hgwebdir.cgi<\/p>\nNow, visiting http:\/\/localhost\/hg<\/a> will display our repositories page and http:\/\/localhost\/hg\/test<\/a> will show our test repository. Likewise, we can now clone repositories using this url format.<\/p>\n
Pushing Changes<\/h3>\nBy default, all repositores served via hgwebdir are read only \u2013 you cannot push changes to them. To change this, we can specify the users that should be able to push to the repositores by adding an “allow_push” section to our hgweb.config:<\/p>\n\n\n[collections]\nc:repositories = c:repositories\n\n[web]\nbaseurl = \/hg\nallow_push = Jeremy<\/pre>\n<\/div>\n<\/div>\nThis means that the user account “Jeremy” (a local user account on the server) will have push access to the repository.<\/p>\n
However, if we try and push changes we\u2019ll get an error:<\/p>\n\n\nc:projectstest>hg push\npushing to http:\/\/localhost\/hg\/hgwebdir.cgi\/test\nsearching for changes\nssl required<\/pre>\n<\/div>\n<\/div>\nFor now, we\u2019ll disable SSL by setting push_ssl to false in our hgweb.config:<\/p>\n\n\n[collections]\nc:repositories = c:repositories\n\n[web]\nbaseurl = \/hg\nallow_push = Jeremy\npush_ssl = false<\/pre>\n<\/div>\n<\/div>\nNow when we try and push we get a different error:<\/p>\n
\n\nc:projectstest>hg push\npushing to http:\/\/localhost\/hg\/hgwebdir.cgi\/test\nsearching for changes\nabort: authorization failed<\/pre>\n<\/div>\n<\/div>\nThis happens because by default IIS is serving up our site without authentication. We need to enable Basic Authentication in the Authentication area of IIS:<\/p>\n
<\/a><\/p>\n
<\/a><\/p>\n
Now you\u2019ll be prompted to enter your username and password:<\/p>\n
<\/a><\/p>\n
After specifying the credetails, the changes will be pushed up. We can view the commit in our web UI:<\/p>\n
<\/a><\/p>\n
Enabling SSL<\/h3>\nWhen you use Basic authentication, your username and password will be sent over the wire in plain text. To make this more secure we can enable SSL. For this example I\u2019m going to use a self-signed certificate, although this will also work with a real SSL certificate purchased from a provider.<\/p>\n
First, you\u2019ll need to go into the IIS manager, select “Server Certificates” and click “Create Self-Signed Certificate”<\/p>\n<\/a><\/p>\n
Now, add a binding for your Web Site for https on port 443 by right clicking on the site and selecting “Edit Bindings”.<\/p>\n
<\/a><\/p>\n
Add a new binding for https on port 443:<\/p>\n
<\/a><\/p>\n
Once this is done, you should now be able to access the hgwebdir site by using https (https:\/\/localhost\/hg<\/a>). You\u2019ll probably get an invalid certificate warning in your browser.<\/p>\n
Now you can re-clone the repository using the secure url (also be sure to remove the “push_ssl = false” line from hgweb.config)<\/p>\n
All done!<\/h3>\nAt this point, you should have successfully set up everything you need to use Mercurial in IIS7.<\/p>","protected":false},"excerpt":{"rendered":"
This guide walks you through setting up a Mercurial server under IIS7 on Windows Server 2008 R2. Not...<\/p>","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[16],"tags":[328,83,327,14,17],"class_list":["post-910","post","type-post","status-publish","format-standard","hentry","category-other","tag-hg","tag-iis","tag-mercurial","tag-server","tag-windows"],"_links":{"self":[{"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/posts\/910","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/comments?post=910"}],"version-history":[{"count":2,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/posts\/910\/revisions"}],"predecessor-version":[{"id":931,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/posts\/910\/revisions\/931"}],"wp:attachment":[{"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/media?parent=910"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/categories?post=910"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/nick.txtcc.com\/index.php\/wp-json\/wp\/v2\/tags?post=910"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}