Imported Debian patch 2.4.5p1-2
[debian/amanda] / debian / amanda-server.README.Debian
1 amanda for DEBIAN
2 -----------------
3
4 To configure your server, as root do:
5
6 1. for a simple setup edit the files (see explanations there) 
7         /etc/amanda/DailySet1/amanda.conf
8         /etc/amanda/DailySet1/disklist
9         /etc/amanda/crontab
10
11 2. prepare the holding disk if you use one by 
12         chown -R backup:backup <holding disk location>
13
14 3. do 
15         crontab -u backup /etc/amanda/crontab.amanda
16
17
18 To use all of Amanda's features, you may find it necessary to put each client
19 machine's root user in the .rhosts or .amandahosts for ~backup on the server 
20 machine.  On Debian systems, this is usually linked to /etc/amandahosts, but
21 if you have clients running other operating systems you'll have to find the
22 right place yourself.
23
24
25 NOTE:  If you want to backup your server too, you need to treat it as both a
26 client *and* a server, see /usr/share/doc/amanda-client/README.Debian for 
27 more information.
28
29
30 For more complex setups, consult the manpages and the extra documents and
31 example files in /usr/share/doc/amanda-common, or look at www.amanda.org on
32 the web.
33
34 Another Note: if you use floppy tapes you have to use the sftape
35 interface for use with ftape(>=3.03).
36
37 Jean Pierre LeJacq <jplejacq@mail.quoininc.com> reports the following about
38 his experience using ftape:
39
40   I'm using ftape successfully with amanda but only after
41   struggling.  The crucial trick was to set the block size with with ftmt to 
42   be the same as used by amanda.  I've implemented this with this entry in
43   /etc/modules.conf:
44   
45     alias char-major-27 zftape
46     pre-install zftape /sbin/swapout 5
47     post-install zftape /bin/ftmt -f /dev/nzqft0 setblk 32768
48
49
50 To ease use with firewalls, Amanda has been built with options restricting the
51 use of TCP to the port range 50000-50100,  and UDP to the port range 840-860.
52
53 Sam Johnston <samj@samj.net> reported problems with an Amanda server on which
54 bastille was used with the "restrict system resources" option.  See bug
55 118616 in the Debian bug tracking system for more information.
56
57 Concerns have been expressed about the reliability of 'dump' as a backup tool
58 on live Linux systems.  Nothing can guarantee a consistent and meaningful 
59 backup of a live filesystem under all circumstances.  The tar utility is 
60 'essential' in Debian and so will always be around, is not tied to any specific
61 filesystem type, and there are entries in the default amanda.conf file 
62 defining dump types using tar.
63
64 Note that if you are using tar with amanda, and getting errors about missing
65 exclude files (particularly on upgrades from older versions), then you may
66 need to update your dumptypes definition to explicitly indicate that the 
67 exclude file is optional, as shown in this example:
68
69         define dumptype userdata-lowvalue {
70            program "GNUTAR"
71            comment "Low value user data dumped with tar"
72            options compress-fast, index
73            exclude list optional ".amandaexclude"
74            priority low
75         }
76