652ace49a292db886b5971af5002c2fd167766a1
[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 If you choose to use the SSH authentication method and associated transport,
58 please be aware that there may be problems if /usr/libamanda/dumper is suid.
59 You can fix this on your server with chmod u-s /usr/lib/amanda/dumper, or
60 investigate dpkg-statoverride.
61
62 Concerns have been expressed about the reliability of 'dump' as a backup tool
63 on live Linux systems.  Nothing can guarantee a consistent and meaningful 
64 backup of a live filesystem under all circumstances.  The tar utility is 
65 'essential' in Debian and so will always be around, is not tied to any specific
66 filesystem type, and there are entries in the default amanda.conf file 
67 defining dump types using tar.
68
69 Note that if you are using tar with amanda, and getting errors about missing
70 exclude files (particularly on upgrades from older versions), then you may
71 need to update your dumptypes definition to explicitly indicate that the 
72 exclude file is optional, as shown in this example:
73
74         define dumptype userdata-lowvalue {
75            program "GNUTAR"
76            comment "Low value user data dumped with tar"
77            options compress-fast, index
78            exclude list optional ".amandaexclude"
79            priority low
80         }
81
82 - - - - -
83
84 If you see backups failing with an error like:
85
86         driver: FATAL flush line 1: syntax error (skipping != FLUSH)
87
88 The problem may be that some versions of Amanda around 2.5.2 are not 
89 happy if there are unexpected contents in the holdingdisk you have
90 defined on the server.  This can occur, for example, if you are using
91 the mount point of a separate filesystem that contains a lost+found
92 directory.  The quick fix is to create a subdirectory in that partition
93 for Amanda to use that will have no such unexpected contents.  For more 
94 info on this issue see:
95
96         http://forums.zmanda.com/archive/index.php/t-591.html
97