Mention 2.6.7.pre1.
[rsync-web.git] / nt.txt
1 From:   "Mike McHenry" <mmchen@minn.net>
2 Subject: Rsync 2.3.1 WinNT binaries and instructions available
3 Date:   Fri, 15 Oct 1999 02:53:30 +1000
4
5
6 Hello all,
7
8 I have created Windows NT binaries for rsync 2.3.1 and have decided to make
9 them available for others to download. These binaries have been tested on
10 Windows NT Server 4.0 SP5 and WILL run in daemon mode if you follow my
11 instructions below. I make no guarantees about these binaries, they have
12 however been working for me for weeks on several NT machines.
13
14 Binaries at ftp://ftp.minn.net/usr/mmchen/
15
16 Instructions for running in daemon mode:
17
18 1. You will need two files, rsync.exe and cygwin1.dll. Place rsync.exe
19 anywhere you like (I chose c:\program files\rsync\rsync.exe) and put
20 cygwin1.dll in c:\winnt\system32
21
22 2. You will need a program from the NT Server resource kit called
23 srvany.exe. This program allows you to run any executable as a service. If
24 you simply install the entire service pack it will be located in c:\ntreskit
25
26 3. Create a service for rsync by typing the following:
27   instsrv Rsync "C:\ntreskit\srvany.exe"
28
29 4. You should now have a new service called Rsync and you can verify by
30 looking in Start->Control Panel->Services DON'T START IT YET!
31
32 5. If you want to run rsync in daemon mode you will need a configuration
33 file. Here is the one I use, call it rsyncd.conf and place it in the same
34 directory as rsync (C:\Program files\rsync\rsyncd.conf)
35   use chroot = false
36   strict modes = false
37   hosts allow = *
38
39   [backup]
40      path = /
41      read only = yes
42      list = no
43
44 This example configuration will make one big anonymous anonymous rsync area
45 available, I use this to backup my NT machines from a central Unix machine.
46 This configuration might not be ideal for you, change to suit your tastes.
47 The first two lines are important for rsync to work on Windows NT however.
48
49 6. You are going to need to hack some keys in the registry to make it work.
50 Don't do this unless you are comfortable with the changes! Run regedit32 and
51 add the following keys and values (quotation marks ARE IMPORTANT):
52   HKEY_LOCAL_MACHINE->SYSTEM->CurrentControlSet->Services->Rsync
53     Edit->Add Key->  Key Name: Paramaters
54     Edit->Add Value->  Value Name: AppDirectory  Value: "C:\programfiles\rsync"
55     Edit->Add Value->  Value Name: Application  Value: "C:\programfiles\rsync\rsync.exe"
56     Edit->Add Value->  Value Name: AppParamters  Value: --config="C:\programfiles\rsync\rsyncd.conf" --daemon
57
58 7. That's it, you should be able to start and stop the rsync service at will
59 using the Services Control Panel. When running with the above configuration
60 you should be able to test by attempting to telnet to port 873 from a remote
61 machine.
62   telnet rsync.server.com 873 (replacing rsync.server.com with your own
63 server's address)
64 You should get a connection to the rsync daemon running on your NT box.
65
66 8. If you have problems you are on your own, sorry, I have enough to do :) I
67 would suggest triple-checking your spelling on EVERYTHING (filenames,
68 configs, reg keys). If you have any comments or suggestions I would be happy
69 to hear them at mmchen@minn.net.
70
71 Mike McHenry
72  Systems Administrator
73  MinnNet Communications, Inc.
74