2 Chapter 1. Amanda 2.5.0 - System-Specific Installation Notes
3 Prev Part I. Installation Next
5 -------------------------------------------------------------------------------
7 Chapter 1. Amanda 2.5.0 - System-Specific Installation Notes
17 XML-conversion;Updates
39 Sinix_5.43_(Reliant_Unix)
61 Please read the notes that correspond to the architectures you are installing
62 for. If you find additional gotchas, or anything incorrect in these notes,
63 please send your updates to mailto://amanda-hackers@amanda.org after checking
64 that they are not known/fixed problems in the Amanda patches page: http://
65 www.amanda.org/patches/.
69 You may have compilation errors on statfs.c if you're running, on a Solaris 2.6
70 host, a gcc that was not build on a Solaris 2.6 host. This happens because gcc
71 stores fixed copies of some Solaris header files on an internal directory. You
72 must rebuild gcc if you get this kind of trouble. Note, however, that gcc
73 2.7.2.3 does not support Solaris 2.6, you should upgrade to 2.8.0 or higher, or
78 You may get errors running make: Assure that you use the BSD-version of make,
79 usually /usr/ccs/bin/make. Add /usr/ccs/bin to the path before running
84 According to Julian Stevens <julian.stevens@baedsl.co.uk>, the format of inetd
85 on Trusted Solaris 1.2 is a bit different. Just before the user name, you
86 should insert the word `untrusted':
88 amanda dgram udp wait untrusted amuser /usr/local/libexec/amandad amandad
90 The patch-system script is *NOT* aware of this detail; you must fix it
95 A bug in GNU-tar 1.12 causes it to miscalculate (in fact, to misreport) the
96 size of filesystems. A patch for GNU-tar is available in the patches directory.
100 The Ultrix dump program contains an explicit check that it is being run by
101 root. This defeats the usual practice of a non-root "operator" userid for
102 dumps. For this reason, the rundump program (a setuid-root wrapper for dump) is
103 enabled by default. If you find rundump is not necessary for you, just run
105 configure --without-rundump
107 The Ultrix restore program will fail if it is not connected to a tty. Since the
108 restore program is invoked in the clients in order to create index files, and
109 it the client is not connected to a tty, index creation will fail. Using GNU-
110 tar instead of DUMP is an option. Thanks to Edwin Wiles
111 <ewiles@mclean.sterling.com> for the investigation. Another alternative
112 proposed by Martyn Johnson <Martyn.Johnson@cl.cam.ac.uk> is to use a modified
113 restore program: use a binary program editor and replace `/dev/tty' with `/dev/
114 nul', for instance, and link /dev/nul to /dev/null. Note that the chosen file
115 name must be exactly 8 bytes long, otherwise you'll break the restore program.
116 A nice one-liner perl script by Martyn Johnson will do the trick (make sure you
117 preserve a copy of the original restore program, it will be rewritten by
118 running this script!):
120 perl -pi -e 'BEGIN { $/ = "/dev/tty" } s-$/-/dev/nul-' restore
122 The Ultrix C compiler seems to be too broken to compile Amanda. You are likely
127 You may run into an internal /bin/sh limit when running the configure script.
128 The error message is:
130 ./configure: sh internal 2K buffer overflow
132 Using /bin/posix/sh usually works around the problem. Another solution is to
133 install GNU bash and use it instead of /bin/sh.
134 If `configure' complains about not finding `lex', you'll have to get `flex'
135 installed. Look for its URL in Amanda_Installation_Notes.
136 If you use logical volumes, you may refer to mountpoints or full device
137 pathnames instead of device names in the disk list file.
138 According to Stan Brown <stanb@awod.com>, amverify won't work with HP/UX's
139 stock mt. The work-around is to install GNU cpio, that contains an
140 implementation of mt, and edit amverify so that MT points to GNU mt and MTOPT
141 is `-f', or reconfigure and rebuild amanda from scratch, making sure it finds
142 GNU mt before the stock mt in the PATH.
143 If you have vxfs filesystems to back up, Amanda will pick vxdump automatically.
144 GNU-tar 1.12 will incorrectly report the size of backups. There's a patch in
145 the patches directory that fixes this problem.
146 The use of `amhpfixdevs' is deprecated, since you can list mount-points or full
147 device names in the disklist. The script may be removed in future releases of
149 Sometimes you may get the error message `Link severed' from an HP/UX client.
150 This is just a cute name the developers of HP/UX found for `Network error'.
151 Reported by Michael Brehl <mbr@condor.de>
155 Linux hosts intended to back up efs partitions with dump should install the
156 dump package, as it is not installed by default on most Linux distributions. It
157 is possible to find compiled versions of dump on most Linux sites and CD-ROMs.
158 Note, however, that DUMP for Linux has been quite unreliable, sometimes being
159 unable to perform backups, producing weird error messages such as `master/slave
160 protocol botched', and sometimes creating unrestorable dump images, especially
161 of active filesystems. The first problem can sometimes be fixed by cleaning up
162 outdated entries in /etc/dumpdates, but your best bet is probably GNU-tar.
163 Make sure the user that runs configure has permission to run the dump program,
164 otherwise configure may misdetect an ability of dump to accept a -E (for
166 GNU-tar 1.11.8, distributed with some Linux versions, will cause index failures
167 (Index returned -1). Upgrading to GNU-tar 1.12 fixes this problem. This is not
168 a Linux-specific problem, but it is quite common in this platform.
169 Amanda now supports the ftape driver version 3.04d. It adjusts the blocksize
170 automatically to 32k and supports QIC volume tables. More details can be found
171 in the file ZFTAPE in this directory.
172 Some releases of dump for Linux, such as the one distributed with Debian 2.0,
173 have modified dump so that it stores dumpdates in /var/lib. If this is your
174 case, you should create a link to it in /etc. Suggested by David Wolfskill
179 According to Michael Galloway <mgx@spruce.lsd.ornl.gov>, the stock DUX4 dump is
180 broken. There is a patch available at ftp://ftp.service.digital.com/public/
181 dunix/v4.0b/duv40bas00005-19970926.README
182 When both dump and vdump are available, Amanda will use vdump for backing up
183 advfs filesystems only, and dump will be used for the rest. If you'd rather
184 back up all filesystems with vdump, #undef DUMP in config/config.h after
186 Unfortunately, the output of `dump -E' incorrectly matches a line of output
187 from SAMBA, which gets Amanda's estimate process confused. client-src/
188 sendsize.c will refuse to compile if both HAVE_DUMP_ESTIMATE and SAMBA_CLIENT
189 are defined in config/config.h. Amanda will work correctly if you undefine
190 HAVE_DUMP_ESTIMATE in config/config.h; if you prefer to have incorrect
191 estimates for SAMBA backups, follow the instructions in client-src/sendsize.c
192 on removing the compile-time error.
193 According to Oren Laadan <orenl@cs.huji.ac.il>, DEC compiler version "DEC C
194 V5.2-033 on Digital UNIX V4.0 (Rev. 564)" (obtained with "cc -V") does not
195 build Amanda properly, in particular, taper.c. Using gcc is OK.
197 Sinix 5.43 (Reliant Unix)
199 The use of `amsinixfixdevs' is deprecated, since you can list mount-points or
200 full device names in the disklist. The script may be removed in future releases
202 Sinix port originally by Michael Schmitz <mschmitz@iname.com>.
206 When setting the tape device name in either amanda.conf or one of the changer
207 configuration files, make sure you specify the "variable" device name, which
208 has a 'v' on the end. If not, IRIX will write 4KByte blocks instead of the
209 32KByte blocks Amanda tells it to. This apparantly works OK unless you take the
210 tape to a non-IRIX system, where amrestore will complain about a short (4096)
212 If you do end up in this situation, the dd command to use to pipe into your
213 system restore program is:
215 dd if=/dev/whatever bs=4k skip=8 | ...
217 Jean-Francois Malouin <Jean-Francois.Malouin@bic.mni.mcgill.ca> reports that,
218 if you are going to use an IRIX host as the tape server, you *must* patch your
219 system with *all* kernel and scsi rollup patches, otherwise you may end up with
220 useless tapes, due to tape rewinding after short periods of inactivity. See
221 http://www-viz.tamu.edu/~sgi-faq/ for more details.
222 Some unpatched version of xfsdump are reported as not printing estimates. This
223 causes estimates to take much longer than they had to, because backups are
224 always performed twice. According to Mike Acar <mike@kentinfoworks.com>, patch
225 2333 for IRIX 5.3 and 6.1 will fix this problem.
229 Seems like SGI make program is a bit broken, in a way that causes it to rebuild
230 some files if doesn't have to if you happen to run make again. Using GNU make
232 If you have xfs filesystems to back up, Amanda will pick xfsdump automatically.
236 Luc Lalonde <Luc.Lalonde@polymtl.ca> contributed the following notes:
237 If you use a jukebox, you must set the ownership of the robot-changer device to
238 the Amanda operator:group in /etc/ioperms. Here's my configuration:
240 /etc/ioperms: /dev/scsi/sc8d6l0 0600 amanda backup
242 Otherwise the ownership:group is changed to "root:sys" after each reboot. When
243 you do upgrades, check the file /var/sysgen/master.d/scsi to see if it has
244 changed. Otherwise your jukebox could be rendered unuseable. In particular,
245 check if it has been replaced by a new version and renamed to "./scsi.O/.".
246 If you use the Amanda package provided by freeware.sgi.com, you are not
247 affected by the first question since at compile time the Amanda operator is
252 Jens Krause <jens@transcom.de> has reported some problems with GNU-tar 1.12 on
253 SCO Release 5. Although the `sparse' files patch was applied, GNU-tar would
254 consistently crash. GNUtar had to be built linked with malloc-libraries, and
255 the `--sparse' switches had to be removed from client-src/sendbackup-gnutar.c
256 and client-src/sendsize.c.
260 chg-scsi was not updated to support the new camlib.h-dependent chio.h, so chg-
261 scsi will be automatically disabled if camlib.h is found. You may use chg-chio
266 Sep. 28th, 2004: Jason Miller <jwm@interlinc.net> reported problems with
267 setting up the Amanda-client on FreeBSD 4.9. He wrote:
268 Due to the need for read permissions for Amanda-client the default user and
269 group for this on FreeBSD 4.9 is "operator:operator" which I found a write up
270 on that as well. Just a note the port wanted to install it with these user
271 permissions by default and I initially changed them to match my Redhat 9.0
272 install. So just doing a
273 make distclean uninstall install Amanda_SERVER=servername
274 fixed that for me. Then I just followed the below instructions and everything
276 Refer to this link for more details: http://www.freebsd.org/cgi/query-
281 Nicolas Ecarnot <nicolas.ecarnot@accim.com> discovered that for FreeBSD 5.1
282 (maybe earlier, and surely further), you have to set the net.inet.udp.maxdgram
283 TCP/IP variable to 65535. The default is 9216, and this is a problem when
284 trying to backup a large number of clients as indicated by errors in during
285 amcheck or the estimate phase.
286 You can just run the command:
287 sysctl net.inet.udp.maxdgram=63535
288 but this won't last until the next reboot.
289 To make it permanent, just add this line:
291 net.inet.udp.maxdgram=65535
293 in the file /etc/sysctl.conf.
297 sendsize is reported to coredump on AIX 4.3.3, this is a linking problem, try
298 configuring Amanda with the option "--disable-shared".
302 Although Amanda won't run standalone on MS-Windows hosts, it is possible to use
303 it to back up their disks, by using SAMBA. Please read Backup_PC_hosts_using
304 Samba for more information.
305 SAMBA may be unable to back up some files due to file locking restrictions.
306 Particularly, paging and registry files usually present problems. Backing up
307 page files is pointless, but registry files are quite important to back up. It
308 is possible to create regular files that contain registry information by using
309 the Regback utility, from the Windows NT Resource Kit. Unfortunately, it is not
310 part of the Windows NT standard distribution, you have to purchase it
311 separately. Thanks to Ernie Oporto <ernie_oporto@mentorg.com> for the tip.
315 For notes on how to setup Amanda under Apple's OS X, please refer to http://
316 web.brandeis.edu/pages/view/Bio/AmandaMacOSXCompileNotes, written by Steven
317 Karel<karel@brandeis.edu>. Thanks to Jose L.Hales-Garcia <jose@stat.ucla.edu>
322 Refer to http://www.amanda.org/docs/systemnotes.html for the current version of
324 -------------------------------------------------------------------------------
327 Part I. Installation Home Chapter 2. Amanda Installation Notes