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