
Notes on installing backupd
---------------------------

There's currently no automated install script since it needs some fancy
awk or perl help to do the changes on /etc/services and /etc/inetd.conf.

However, it shouldn't take more than two minutes to install the server,
once it is compiled. Here are the step-by-step instructions:


1. Copy the server executable (backupd) to a directory of your choice.
   Two locations come to mind:

        /usr/sbin                   or
        /usr/local/sbin

2. Copy the client executable into place. This should go into

        /usr/bin                    or
        /usr/local/bin

3. Add the following line to /etc/services:

        backupd    12153/tcp

   The port number (12153) was arbitrarily choosen. But note: This is the
   default, used by the clients. If you change it, you have to recompile
   the clients, or use the -p command line switch to force them to use
   another port.

4. Add the following line to /etc/inetd.conf. Replace the path to the
   server by the one from step 1.

	# Backup-Server
       	backupd	stream tcp nowait root /usr/sbin/tcpd /usr/sbin/backupd

   This line assumes that you have the tcp wrappers installed (this is
   usually true for Linux systems and a Good Thing).

5. Create your /etc/backupd.conf. See BACKUPD.DOC for samples.

6. Adjust /etc/hosts.deny and/or /hosts.allow if needed.


That's it! If you want to test the server, try the following:

Add a test entry to /etc/backupd.conf (remember to remove it after the
test):

    [test]
    user     = "nobody"
    group    = "nobody"
    write    = "(cat > /tmp/backupd-test) 2>/dev/null"
    read     = "(cat /tmp/backupd-test) 2>/dev/null"
    lockfile = "/tmp/backupd-test.lock"
    umask    = 0022

Do a backup of some text file:

    cat /etc/services | backupc -w test

Check /var/log/messages for any error messages.

Get the file back and compare it to the original:

    backupc -r test > /tmp/test.out
    diff -v /etc/services /tmp/test.out

If diff doesn't give you any output, and there are no error messages,
you're done. Congratulations!

		      
