Imported Upstream version 2.4.5
[debian/amanda] / docs / systemnotes.txt
diff --git a/docs/systemnotes.txt b/docs/systemnotes.txt
new file mode 100644 (file)
index 0000000..bd3f678
--- /dev/null
@@ -0,0 +1,325 @@
+
+Chapter 1. AMANDA 2.4.x - System-Specific Installation Notes
+Prev  Part I. Installation                              Next
+
+-------------------------------------------------------------------------------
+
+Chapter 1. AMANDA 2.4.x - System-Specific Installation Notes
+
+
+AMANDA Core Team
+
+Original text
+AMANDA Core Team
+
+Stefan G. Weichinger
+
+XML-conversion;Updates
+AMANDA Core Team
+<sgw@amanda.org>
+Table of Contents
+
+
+  Solaris_2.6
+
+  Trusted_Solaris
+
+  SunOS_4.x
+
+  Ultrix
+
+  HP/UX
+
+  Linux
+
+  Digital_Unix_4
+
+  Sinix_5.43_(Reliant_Unix)
+
+  IRIX_(all)
+
+  IRIX_6
+
+  IRIX_6.5.x
+
+  SCO
+
+  FreeBSD_3.0
+
+  FreeBSD_4.9
+
+  FreeBSD_5.1
+
+  AIX
+
+  Microsoft_Windows
+
+  Mac_OS_X
+
+
+Note
+
+Refer to http://www.amanda.org/docs/systemnotes.html for the current version of
+this document.
+Please read the notes that correspond to the architectures you are installing
+for. If you find additional gotchas, or anything incorrect in these notes,
+please send your updates to mailto://amanda-hackers@amanda.org after checking
+that they are not known/fixed problems in the AMANDA patches page: http://
+www.amanda.org/patches/.
+
+ Solaris 2.6
+
+You may have compilation errors on statfs.c if you're running, on a Solaris 2.6
+host, a gcc that was not build on a Solaris 2.6 host. This happens because gcc
+stores fixed copies of some Solaris header files on an internal directory. You
+must rebuild gcc if you get this kind of trouble. Note, however, that gcc
+2.7.2.3 does not support Solaris 2.6, you should upgrade to 2.8.0 or higher, or
+egcs.
+
+ Trusted Solaris
+
+According to Julian Stevens <julian.stevens@baedsl.co.uk>, the format of inetd
+on Trusted Solaris 1.2 is a bit different. Just before the user name, you
+should insert the word `untrusted':
+
+  amanda dgram udp wait untrusted amuser /usr/local/libexec/amandad amandad
+       
+
+The patch-system script is *NOT* aware of this detail; you must fix it
+yourself.
+
+ SunOS 4.x
+
+A bug in GNUtar 1.12 causes it to miscalculate (in fact, to misreport) the size
+of filesystems. A patch for GNUtar is available in the patches directory.
+
+ Ultrix
+
+The Ultrix dump program contains an explicit check that it is being run by
+root. This defeats the usual practice of a non-root "operator" userid for
+dumps. For this reason, the rundump program (a setuid-root wrapper for dump) is
+enabled by default. If you find rundump is not necessary for you, just run
+
+  configure --without-rundump
+
+The Ultrix restore program will fail if it is not connected to a tty. Since the
+restore program is invoked in the clients in order to create index files, and
+it the client is not connected to a tty, index creation will fail. Using GNUTAR
+instead of DUMP is an option. Thanks to Edwin Wiles
+<ewiles@mclean.sterling.com> for the investigation. Another alternative
+proposed by Martyn Johnson <Martyn.Johnson@cl.cam.ac.uk> is to use a modified
+restore program: use a binary program editor and replace `/dev/tty' with `/dev/
+nul', for instance, and link /dev/nul to /dev/null. Note that the chosen file
+name must be exactly 8 bytes long, otherwise you'll break the restore program.
+A nice one-liner perl script by Martyn Johnson will do the trick (make sure you
+preserve a copy of the original restore program, it will be rewritten by
+running this script!):
+
+  perl -pi -e 'BEGIN { $/ = "/dev/tty" } s-$/-/dev/nul-' restore
+       
+
+The Ultrix C compiler seems to be too broken to compile AMANDA. You are likely
+to need gcc or egcs.
+
+ HP/UX
+
+You may run into an internal /bin/sh limit when running the configure script.
+The error message is:
+
+  ./configure: sh internal 2K buffer overflow
+       
+
+Using /bin/posix/sh usually works around the problem. Another solution is to
+install GNU bash and use it instead of /bin/sh.
+If `configure' complains about not finding `lex', you'll have to get `flex'
+installed. Look for its URL in Amanda_Installation_Notes.
+If you use logical volumes, you may refer to mountpoints or full device
+pathnames instead of device names in the disk list file.
+According to Stan Brown <stanb@awod.com>, amverify won't work with HP/UX's
+stock mt. The work-around is to install GNU cpio, that contains an
+implementation of mt, and edit amverify so that MT points to GNU mt and MTOPT
+is `-f', or reconfigure and rebuild amanda from scratch, making sure it finds
+GNU mt before the stock mt in the PATH.
+If you have vxfs filesystems to back up, AMANDA will pick vxdump automatically.
+GNU tar 1.12 will incorrectly report the size of backups. There's a patch in
+the patches directory that fixes this problem.
+The use of `amhpfixdevs' is deprecated, since you can list mount-points or full
+device names in the disklist. The script may be removed in future releases of
+AMANDA.
+Sometimes you may get the error message `Link severed' from an HP/UX client.
+This is just a cute name the developers of HP/UX found for `Network error'.
+Reported by Michael Brehl <mbr@condor.de>
+
+ Linux
+
+Linux hosts intended to back up efs partitions with dump should install the
+dump package, as it is not installed by default on most Linux distributions. It
+is possible to find compiled versions of dump on most Linux sites and CD-ROMs.
+Note, however, that DUMP for Linux has been quite unreliable, sometimes being
+unable to perform backups, producing weird error messages such as `master/slave
+protocol botched', and sometimes creating unrestorable dump images, especially
+of active filesystems. The first problem can sometimes be fixed by cleaning up
+outdated entries in /etc/dumpdates, but your best bet is probably GNU tar.
+Make sure the user that runs configure has permission to run the dump program,
+otherwise configure may misdetect an ability of dump to accept a -E (for
+estimates) switch.
+GNUtar 1.11.8, distributed with some Linux versions, will cause index failures
+(Index returned -1). Upgrading to GNUtar 1.12 fixes this problem. This is not a
+Linux-specific problem, but it is quite common in this platform.
+AMANDA now supports the ftape driver version 3.04d. It adjusts the blocksize
+automatically to 32k and supports QIC volume tables. More details con be found
+in the file ZFTAPE in this directory.
+Some releases of dump for Linux, such as the one distributed with Debian 2.0,
+have modified dump so that it stores dumpdates in /var/lib. If this is your
+case, you should create a link to it in /etc. Suggested by David Wolfskill
+<dhw@whistle.com>
+
+ Digital Unix 4
+
+According to Michael Galloway <mgx@spruce.lsd.ornl.gov>, the stock DUX4 dump is
+broken. There is a patch available at ftp://ftp.service.digital.com/public/
+dunix/v4.0b/duv40bas00005-19970926.README
+When both dump and vdump are available, AMANDA will use vdump for backing up
+advfs filesystems only, and dump will be used for the rest. If you'd rather
+back up all filesystems with vdump, #undef DUMP in config/config.h after
+running configure.
+Unfortunately, the output of `dump -E' incorrectly matches a line of output
+from SAMBA, which gets AMANDA's estimate process confused. client-src/
+sendsize.c will refuse to compile if both HAVE_DUMP_ESTIMATE and SAMBA_CLIENT
+are defined in config/config.h. AMANDA will work correctly if you undefine
+HAVE_DUMP_ESTIMATE in config/config.h; if you prefer to have incorrect
+estimates for SAMBA backups, follow the instructions in client-src/sendsize.c
+on removing the compile-time error.
+According to Oren Laadan <orenl@cs.huji.ac.il>, DEC compiler version "DEC C
+V5.2-033 on Digital UNIX V4.0 (Rev. 564)" (obtained with "cc -V") does not
+build AMANDA properly, in particular, taper.c. Using gcc is OK.
+
+ Sinix 5.43 (Reliant Unix)
+
+The use of `amsinixfixdevs' is deprecated, since you can list mount-points or
+full device names in the disklist. The script may be removed in future releases
+of AMANDA.
+Sinix port originally by Michael Schmitz <mschmitz@iname.com>.
+
+ IRIX (all)
+
+When setting the tape device name in either amanda.conf or one of the changer
+configuration files, make sure you specify the "variable" device name, which
+has a 'v' on the end. If not, IRIX will write 4KByte blocks instead of the
+32KByte blocks AMANDA tells it to. This apparantly works OK unless you take the
+tape to a non-IRIX system, where amrestore will complain about a short (4096)
+read.
+If you do end up in this situation, the dd command to use to pipe into your
+system restore program is:
+
+  dd if=/dev/whatever bs=4k skip=8 | ...
+       
+
+Jean-Francois Malouin <Jean-Francois.Malouin@bic.mni.mcgill.ca> reports that,
+if you are going to use an IRIX host as the tape server, you *must* patch your
+system with *all* kernel and scsi rollup patches, otherwise you may end up with
+useless tapes, due to tape rewinding after short periods of inactivity. See
+http://www-viz.tamu.edu/~sgi-faq/ for more details.
+Some unpatched version of xfsdump are reported as not printing estimates. This
+causes estimates to take much longer than they had to, because backups are
+always performed twice. According to Mike Acar <mike@kentinfoworks.com>, patch
+2333 for IRIX 5.3 and 6.1 will fix this problem.
+
+ IRIX 6
+
+Seems like SGI make program is a bit broken, in a way that causes it to rebuild
+some files if doesn't have to if you happen to run make again. Using GNU make
+fixes this problem.
+If you have xfs filesystems to back up, AMANDA will pick xfsdump automatically.
+
+ IRIX 6.5.x
+
+Luc Lalonde <Luc.Lalonde@polymtl.ca> contributed the following notes:
+If you use a jukebox, you must set the ownership of the robot-changer device to
+the AMANDA operator:group in /etc/ioperms. Here's my configuration:
+
+  /etc/ioperms: /dev/scsi/sc8d6l0 0600 amanda backup
+
+Otherwise the ownership:group is changed to "root:sys" after each reboot. When
+you do upgrades, check the file /var/sysgen/master.d/scsi to see if it has
+changed. Otherwise your jukebox could be rendered unuseable. In particular,
+check if it has been replaced by a new version and renamed to "./scsi.O/.".
+If you use the AMANDA package provided by freeware.sgi.com, you are not
+affected by the first question since at compile time the AMANDA operator is
+"root:sys".
+
+ SCO
+
+Jens Krause <jens@transcom.de> has reported some problems with GNUtar 1.12 on
+SCO Release 5. Although the `sparse' files patch was applied, GNU tar would
+consistently crash. GNUtar had to be built linked with malloc-libraries, and
+the `--sparse' switches had to be removed from client-src/sendbackup-gnutar.c
+and client-src/sendsize.c.
+
+ FreeBSD 3.0
+
+chg-scsi was not updated to support the new camlib.h-dependent chio.h, so chg-
+scsi will be automatically disabled if camlib.h is found. You may use chg-chio
+instead.
+
+ FreeBSD 4.9
+
+Sep. 28th, 2004: Jason Miller <jwm@interlinc.net> reported problems with
+setting up the AMANDA-client on FreeBSD 4.9. He wrote:
+Due to the need for read permissions for AMANDA-client the default user and
+group for this on FreeBSD 4.9 is "operator:operator" which I found a write up
+on that as well. Just a note the port wanted to install it with these user
+permissions by default and I initially changed them to match my Redhat 9.0
+install. So just doing a
+make distclean uninstall install AMANDA_SERVER=servername
+fixed that for me. Then I just followed the below instructions and everything
+was good to go.
+Refer to this link for more details: http://www.freebsd.org/cgi/query-
+pr.cgi?pr=59302.
+
+ FreeBSD 5.1
+
+Nicolas Ecarnot <nicolas.ecarnot@accim.com> discovered that for FreeBSD 5.1
+(maybe earlier, and surely further), you have to set the net.inet.udp.maxdgram
+TCP/IP variable to 65535. The default is 9216, and this is a problem when
+trying to backup a large number of clients as indicated by errors in during
+amcheck or the estimate phase.
+You can just run the command:
+sysctl net.inet.udp.maxdgram=63535
+but this won't last until the next reboot.
+To make it permanent, just add this line:
+
+  net.inet.udp.maxdgram=65535
+       
+
+in the file /etc/sysctl.conf.
+
+ AIX
+
+sendsize is reported to coredump on AIX 4.3.3, this is a linking problem, try
+configuring AMANDA with the option "--disable-shared".
+
+ Microsoft Windows
+
+Although AMANDA won't run standalone on MS-Windows hosts, it is possible to use
+it to back up their disks, by using SAMBA. Please read Backup_PC_hosts_using
+Samba for more information.
+SAMBA may be unable to back up some files due to file locking restrictions.
+Particularly, paging and registry files usually present problems. Backing up
+page files is pointless, but registry files are quite important to back up. It
+is possible to create regular files that contain registry information by using
+the Regback utility, from the Windows NT Resource Kit. Unfortunately, it is not
+part of the Windows NT standard distribution, you have to purchase it
+separately. Thanks to Ernie Oporto <ernie_oporto@mentorg.com> for the tip.
+
+ Mac OS X
+
+For notes on how to setup AMANDA under Apple's OS X, please refer to http://
+web.brandeis.edu/pages/view/Bio/AmandaMacOSXCompileNotes, written by Steven
+Karel<karel@brandeis.edu>. Thanks to Jose L.Hales-Garcia <jose@stat.ucla.edu>
+for the tip.
+-------------------------------------------------------------------------------
+
+Prev                   Up                                   Next
+Part I. Installation  Home  Chapter 2. AMANDA Installation Notes
+