--- a/Makefile Thu Mar 29 16:39:04 2012 +0100
+++ b/Makefile Tue Apr 03 17:35:02 2012 +0100
@@ -17,7 +17,7 @@
setup-useradd: installfiles useradd inituser
# WARNING: this is experimental
-setup-windows: installfiles windows-add inituser-windows
+setup-windows: installfiles adduser-windows inituser-windows
installetc:
$(INSTALL) -d $(DESTDIR)$(ETCDIR)
@@ -67,13 +67,15 @@
--comment "Mercurial repositories" $(NEWUSER)
# WARNING: this is experimental
-windows-add:
- net user $(NEWUSER) foo /add
+adduser-windows:
+ net user $(NEWUSER) /add
inituser:
su -l -c "$(DESTDIR)$(LIBDIR)/init/hginit $(DESTDIR)$(LIBDIR)" $(NEWUSER)
# WARNING: this is experimental
inituser-windows:
- ssh ${NEWUSER}@localhost "sh $(DESTDIR)$(LIBDIR)/init/hginit $(DESTDIR)$(LIBDIR)"
+ mkdir /home/$(NEWUSER)
+ chmod 755 $(DESTDIR)$(LIBDIR)/init/*
+ ssh $(NEWUSER)@localhost "sh $(DESTDIR)$(LIBDIR)/init/hginit $(DESTDIR)$(LIBDIR)"
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/README-windows.txt Tue Apr 03 17:35:02 2012 +0100
@@ -0,0 +1,53 @@
+Windows setup for mercurial-server
+==================================
+
+WARNING: Windows is *not* a supported system. We've gotten this guide to work ok
+but the permissions are still broken in various ways to do with the underlying
+issues in Windows' permissions system. Unix-based systems, especially Debian and
+derivatives are still the main target. Patches to this guide to improve the
+support are welcome however!
+
+1) Install Cygwin (http://cygwin.com/) using the setup.exe from there. Tested
+against 1.7.12-1, may work with earlier versions. You'll need the base install
+plus the following additional packages:
+
+- docbook-xsl
+- libxslt
+- make
+- mercurial
+- openssh
+- python
+
+Note that even if you've already got them installed in Windows, Python and
+Mercurial still need to be installed in Cygwin.
+
+2) Open a new Cygwin terminal as Adminstrator (right click on "Cygwin Terminal"
+start menu option and pick "Run as administrator")
+
+3) Run "ssh-host-config -y" and "cygrunsrv -S sshd" to get sshd running. We need
+this because there's no proper su in Cygwin (see
+http://cygwin.com/faq-nochunks.html#faq.using.su for why this is)
+
+3) Goto the mercurial-server folder and "make setup-windows"
+
+4) Run "passwd hg" and set the password for the hg user.
+
+5) Following the example from the main mercurial-server documentation (in that the server
+is called 'jeeves', your username is 'jay' and the client is called 'spoon'),
+but with a few differences for Cygwin, we can now get you initial access. We
+assume that you've generated a key with PuTTYgen
+(http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html) and then
+copied the contents of the "public key" box into a file called my-key.
+
+jay@jeeves:~$ mkdir -p /etc/mercurial-server/keys/root/jay
+jay@jeeves:~$ cp my-key /etc/mercurial-server/keys/root/jay/spoon
+jay@jeeves:~$ chown hg /etc/mercurial-server/keys/root/jay/spoon
+jay@jeeves:~$ ssh hg@localhost /usr/share/mercurial-server/refresh-auth
+
+The rest of the instructions in the normal mercurial-server documentation should
+now work. Note that although it's possible to add keys/access info to
+/etc/mercurial-server it's much easier to do things via the hgadmin repository,
+and doing things via /etc should probably be limited to only if you mess up the
+setup in hgadmin.
+
+# vim: tw=80 fo=cqt wm=0
--- a/windows.txt Thu Mar 29 16:39:04 2012 +0100
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,12 +0,0 @@
-- base cygwin
-- mercurial (not external tortoise)
-- libxslt, docbook-xsl (xsltproc)
-- python (not external)
-- http://www.noah.org/ssh/cygwin-sshd.html
-- mkdir /home/hg
-- chmod 755 /usr/local/share/mercurial-server/init/*
-- sshd - no su! http://cygwin.com/faq-nochunks.html#faq.using.su
-- admin, make setup-windows
-- hg user password is foo
-- once key is cp'ed, chown it to hg
-