The Official AMANDA Documentation Stefan G. Weichinger and Amanda Core Team February 6, 2007 ABSTRACT Note This is the Docbook/XML-version of the official Amanda doc- umentation. Please refer to <http://www.amanda.org/docs/ AMANDA-docs.html> for the latest versions of these documents. They are available as html, ps and pdf. This is the official documentation for Amanda 2.5.0. The release 2.5.0 brings various new features: • Communication security/authentication • Data security • Enhanced possibilities for Compression • Dump images spanning multiple media volumes • Auto tape labelling • Improved code quality Feel free to contact me with corrections, additions or updates. Thank you. Stefan G. Weichinger, for the AMANDA Core Team, March 2006. [email protected] <mailto:[email protected]> 3 PREFACE Conversion to Docbook/XML by Stefan G. Weichinger, member of the Amanda Core Team. XML-Buildtree by Jelmer R. Vernooij, member of the Samba-Team. Thanks, Jelmer ... ! 5 COPYRIGHT INFORMATION Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of U.M. not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. U.M. makes no representations about the suitability of this software for any purpose. It is provided ”as is” without express or implied warranty. U.M. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, IN- CLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL U.M. BE LIABLE FOR ANY SPECIAL, INDIRECT OR CON- SEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTUOUS ACTION, ARISING OUT OF OR IN CON- NECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 7 ATTRIBUTIONS Amanda 2.5.0 - System-Specific Installation Notes • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Amanda Installation Notes • James da Silva <[email protected] <mailto:[email protected]>> (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion, Updates) Excluding • Andrew Hall (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Indexing with Amanda • Alan M. McIvor (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Backup PC hosts using Samba • Michael Zucchi <[email protected] <mailto:[email protected]. Au>> (Original text) • John R. Jackson <[email protected] <mailto:[email protected]>> (Updates) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Restore • Daniel Moore (Original text) • Alexandre Oliva <[email protected] <mailto:[email protected]>> (Sub- stantial rewriting) • Murf (Corrections and additions) • Ralf Fassel (Corrections and additions) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Amanda Tape Changer Support • James da Silva <[email protected] <mailto:[email protected]>> (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) chg-scsi • Jason X (report real name to [email protected]) (Original version) 8 Attributions 9 • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) RAIT (Redundant Array of Inexpensive Tape) Support • Marc Mengel (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Printing of Labels • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Amanda on Cygwin HOWTO • Doug Kingston (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion) How to use the Amanda file-driver • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (Original text;XML- conversion;Updates) AFS HOWTO • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) How to use a wrapper • Bert de Ridder (Original text) • Paul Bijnens (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion; Updates) How to do Amanda-server-side gpg-encrypted backups. • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (Original text) How to use different auth with Amanda • Jean-Louis Martineau <[email protected] <mailto:[email protected]. ca>> (Original text;XML-conversion;Updates) Using Amanda • John R. Jackson <[email protected] <mailto:[email protected]>> (Original text) • Gavin Henry <[email protected] <mailto:[email protected]>> (XML-conversion) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion, Updates) Amanda FAQ • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Collection of the top ten Amanda questions. And answers. 10 Attributions • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (Original text; Conversion to Docbook/XML) Amanda WISHLIST • Jean-Louis Martineau <[email protected] <mailto:[email protected]. ca>> (Additions and Updates) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion; Additions and Updates) How Amanda uses UDP and TCP ports • John R. Jackson <[email protected] <mailto:[email protected]>> (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Amanda dumper API • Alexandre Oliva <[email protected] <mailto:[email protected]>> (Orig- inal text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Amanda Internals • George Scott (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion) Amanda Event API • Mike Grupenhoff <[email protected] <mailto:[email protected]>> (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Amanda Security API • Mike Grupenhoff <[email protected] <mailto:[email protected]>> (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Virtual Tape API • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion) Using Kerberos with Amanda • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Response to CPIO Security Notice Issue 11: • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Upgrade Issues • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion) What once was new Attributions 11 • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion, Updates) Multitape support in Amanda 2.2 • James da Silva <[email protected] <mailto:[email protected]>> (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion;Updates) Thoughts about a Strategy API • Alexandre Oliva <[email protected] <mailto:[email protected]>> (Orig- inal text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion) Y2K Compliancy • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion) Usage of floppy tape drives on Linux • Albrecht Gebhardt (Original text) • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (XML-conversion,Updates) Web Ressources • Stefan G. Weichinger <[email protected] <mailto:[email protected]>> (Original text) CONTENTS Contents ABSTRACT 3 PREFACE 5 COPYRIGHT INFORMATION 7 ATTRIBUTIONS 8 Part I Installation 21 INITIAL INSTALLATION 23 Chapter 1 AMANDA 2.5.0 - SYSTEM-SPECIFIC INSTALLATION NOTES 24 1.1 Solaris 2.6 24 1.2 Solaris 24 1.3 Trusted Solaris 25 1.4 SunOS 4.x 25 1.5 Ultrix 25 1.6 HP/UX 25 1.7 Linux 26 1.8 Digital Unix 4 27 1.9 Sinix 5.43 (Reliant Unix) 27 1.10 IRIX (all) 27 1.11 IRIX 6 28 1.12 IRIX 6.5.x 28 1.13 SCO 28 1.14 FreeBSD 3.0 28 1.15 FreeBSD 4.9 29 1.16 FreeBSD 5.1 29 1.17 AIX 29 1.18 Microsoft Windows 29 1.19 Mac OS X 30 Chapter 2 AMANDA INSTALLATION NOTES 31 2.1 Before doing anything 31 2.2 Compiling the Amanda sources 31 2.2.1 Source configuration 32 2.2.2 Building and installing the binaries 34 2.3 Setting up your Amanda Configuration 35 2.3.1 Setting up the Tape Server Host 35 2.3.2 Set up the Backup Client Hosts 37 13 14 Contents Chapter 3 EXCLUDING 41 3.1 Introduction 41 3.2 Please Read 41 3.3 Before We Begin 42 3.4 Choosing an exclude mechanism 43 3.4.1 Exclude Mechanisms 43 3.4.1.1 Exclude an individual item explicitly in the dumptype 43 3.4.1.2 Utilize an Exclude List 44 3.4.1.3 Do not include the data in the disklist 45 3.5 Expression 45 3.6 Wildcard Expansion 46 3.7 Troubleshooting 46 3.8 Section 46 3.8.1 Broken gnutar? 46 3.8.2 The ps command is your friend. 47 Chapter 4 INDEXING WITH AMANDA 48 4.1 Database Format 48 4.2 Database Browsing 48 4.3 File Extraction 49 4.4 Protocol Between amindexd and amrecover 49 4.5 Installation Notes 49 4.6 Permissions 51 4.7 Changes from amindex-1.0 51 4.8 Changes from amindex-0.3 51 4.9 Changes from amindex-0.2 51 4.10 Changes from amindex-0.1 53 4.11 Changes/additions to 2.3.0 53 4.12 Known Bugs 54 Chapter 5 BACKUP PC HOSTS USING SAMBA 55 5.1 Installation 55 5.2 Setup 56 5.3 Example 57 5.4 Bugs and notes 58 Chapter 6 RESTORE 60 Part II About Tapes and Changers 63 TAPE-DRIVES AND TAPE-CHANGERS 65 Chapter 7 TAPETYPES