<< Back to man.ChinaUnix.net

The Official AMANDA Documentation

Edited by

Stefan G. Weichinger

Amanda Core Team


Table of Contents

Abstract
Copyright Information
Attributions
1. Installation
1. Amanda 2.5.0 - System-Specific Installation Notes
Solaris 2.6
Solaris
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
2. Amanda Installation Notes
Before doing anything
Compiling the Amanda sources
Setting up your Amanda Configuration
Setting up the Tape Server Host
Set up the Backup Client Hosts
3. Excluding
Introduction
Please Read
Before We Begin
Choosing an exclude mechanism
Exclude Mechanisms
Expression
Wildcard Expansion
Troubleshooting
Broken gnutar?
The ps command is your friend.
4. Indexing with Amanda
Database Format
Database Browsing
File Extraction
Protocol Between amindexd and amrecover
Installation Notes
Permissions
Changes from amindex-1.0
Changes from amindex-0.3
Changes from amindex-0.2
Changes from amindex-0.1
Changes/additions to 2.3.0
Known Bugs
5. Backup PC hosts using Samba
Installation
Setup
Example
Bugs and notes
6. Restore
2. About Tapes and Changers
7. Tapetypes
8. Amanda Tape Changer Support
Introduction
Specifying a tape changer in amanda.conf
Device-specific tapechanger script
Slot names and the "current" slot
Operator interface
How amdump interacts with the tape changer
Builtin tape-changers
chg-multi (formerly chg-generic)
chg-manual (formerly no-changer)
chg-mtx (formerly hp-changer)
chg-zd-mtx
chg-scsi-chio (formerly seagate-changer, then chg-chio)
chg-scsi (new interface, try to drive a robot with direct scsi commands)
chg-chio
chg-chs
chg-rth
chg-juke
chg-rait
chg-disk
chg-iomega
chg-null
9. chg-scsi
Command line options
Notes about changer.conf
Amanda's actual usage of chg-scsi
Configuration notes
Hacking notes
10. RAIT (Redundant Array of Inexpensive Tape) Support
What is a RAIT?
Using a RAIT
Disaster Recovery
11. Printing of Labels
The New Feature
Labels provided
History
How it works
3. HOWTOs
12. Amanda on Cygwin HOWTO
Install Cygwin
Other Preparation
Compile Amanda
Configure Cygwin files
Configure Windows System Files
Configure inetd to run automatically as a service
Windows 98/ME
Windows NT/2000/XP
Notes on Amanda backup options
Compression
Exclude Lists
Debugging Files
13. How to use the Amanda file-driver
Introduction
Possible Uses
Setup
Basics
Recovery
14. AFS HOWTO
15. How to use a wrapper
Bert de Ridder's suggestions
Paul Bijnens's suggestions
16. How to do Amanda-server-side gpg-encrypted backups.
Setup
Test
Plans
4. Various Information
17. Using Amanda
An Introduction
Amanda Features
Future Capabilities of Amanda
Amanda Resources
Installing Amanda
Install Related Packages
Perform Preliminary Setup
Configure the Amanda Build
Build and Install Amanda
Configuring Amanda
Decide on a Tape Server
Decide Which Tape Devices to Use
Decide Whether to Use Compression
Decide Where the Holding Space Will Be
Compute Your Dump Cycle
Copy and Edit the Default Configuration File
Configure the Holding Disk
Configure Tape Devices and Label Tapes
Configure Backup Clients
Test and Debug Setup
Operating Amanda
Run amdump
Read Amanda's Reports
Monitor Tape and Holding Disk Status
Adding Tapes at a Particular Position in the Cycle
Miscellanous Operational Notes
Advanced Amanda Configuration
Adjust the Backup Cycle
Adjust Parallelism
Monitor for Possible Improvements
Excluding Files
Restoring with Amanda
Configuring and Using amrecover
Using amrestore
Restoring Without Amanda
18. Amanda FAQ
19. Collection of the top ten Amanda questions. And answers.
Reason for starting this list.
the DLE-question
the localhost-question
the friday-tape-question
the multiple-dumps-question
the mailing-list-question
the distro-question
the index-question
the tapetype-questions
the size-question
the GUI-question
the holding-disk question
...
20. Amanda WISHLIST
5. Technical Background
21. How Amanda uses UDP and TCP ports
TCP port allocation
User TCP port range (--with-tcpportrange) summary
UDP port allocation
User UDP port range (--with-udpportrange) summary
Firewalls and NAT
22. Amanda dumper API
Introduction
The Problem
Overview of the API
The `support' command
The `selfcheck' command
The `estimate' and `estimate-parse' commands
The `backup' and `backup-parse' commands
The `index-from-output' and `index-from-image' commands
The `restore' command
The `print-command' command
Conclusion
23. Amanda Internals
Protocols
server and amandad on client
planner and driver
driver and dumper
taper(read) and taper(write)
24. Amanda Event API
Introduction
The API
event_register
event_release
event_loop
event_wakeup
Data types
event_handle_t
event_id_t
event_type_t
event_fn_t
Event Types
EV_READFD
EV_WRITEFD
EV_SIG
EV_TIME
EV_WAIT
25. Amanda Security API
Introduction
The Problem
The API
protocol packet transmission functions
stream functions
Data Types
security_driver_t
security_handle_t
security_stream_t
security_status_t
SECURITY DRIVERS
name
connect
accept
close
sendpkt
recvpkt
recvpkt_cancel
stream_server
stream_accept
stream_client
stream_close
stream_auth
stream_id
stream_write
stream_read
stream_read_cancel
26. Virtual Tape API
27. Using Kerberos with Amanda
Amanda 2.5.0 - KERBEROS v4 SUPPORT NOTES
Configuration
Installation
conf file
Amanda 2.5.0 - KERBEROS v5 SUPPORT NOTES
Building
Installation
conf file
Destination Host Permissions file
6. Historical files
28. Response to CPIO Security Notice Issue 11:
Affected Versions
Workaround
Acknowledgements
29. Upgrade Issues
30. What once was new
What's new in Amanda 2.3
Indexing backups for easier restore
Samba Support
GnuTar Support
Multiple backups in parallel from one client host
Multiple tapes in one run
Bottleneck determination
2 Gb limit removed
amadmin import/export
What's new in Amanda 2.2
Client side setup has changed
Version suffixes on executables
Kerberos
Multiple holding disks
Remote self-checks
mmap support
gzip support
Mount point names in disklist
Initial tape-changer support included
Generic tape changer wrapper script
New command amtape
Changer support added to command amlabel
Tape changer support improved
A few words about multi-tape runs
Big planner changes
Level-0 dumps allowed with no tape
31. Multitape support in Amanda 2.2
Introduction
New Planner Algorithm
Time
Full Backups
Schedule Balancing
Overwrite Detection
Taper Algorithm
Choosing a tape
End of tape handling
Tape Format Changes
Tapelist File Changes
32. Thoughts about a Strategy API
33. Y2K Compliancy
34. Usage of floppy tape drives on Linux
7. Appendixes
35. The Amanda Manual Pages.
amadmin - administrative interface to control Amanda backups
amaespipe - wrapper program for aespipe
amanda - Advanced Maryland Automatic Network Disk Archiver
amanda.conf - Main configuration file for Amanda, the Advanced Maryland Automatic Network Disk Archiver
amcheck - run Amanda self-checks
amcheckdb - check Amanda database for tape consistency
amcleanup - run the Amanda cleanup process after a failure
amcrypt - reference crypt program for Amanda symmetric data encryption
amdd - Amanda version of dd
amdump - back up all disks in an Amanda configuration
amfetchdump - extract backup images from multiple Amanda tapes.
amflush - flush Amanda backup files from holding disk to tape
amgetconf - look up amanda.conf variables
amlabel - label an Amanda tape
ammt - Amanda version of mt
amoverview - display file systems processed by Amanda over time
amplot - visualize the behavior of Amanda
amrecover - Amanda index database browser
amreport - generate a formatted output of statistics for an Amanda run
amrestore - extract backup images from an Amanda tape
amrmtape - remove a tape from the Amanda database
amstatus - display the state of an Amanda run
amtape - user interface to Amanda tape changer controls
amtapetype - generate a tapetype definition.
amtoc - generate TOC (Table Of Contents) for an Amanda run
amverify - check an Amanda tape for errors
amverifyrun - check the tapes written by the last Amanda run
36. Web Ressources
Index

List of Tables

4.1. Protocol between amindexd and amrecover

List of Examples

2.1. /etc/crontab
2.2. /etc/services
2.3. /etc/inetd.conf
2.4. /etc/xinetd.d/amandaidx
2.5. /etc/xinetd.d/amidxtape
2.6. /etc/amanda/supervise/amandaidx/run
2.7. /etc/amanda/supervise/amidxtape/run
2.8. /etc/services
2.9. /etc/inetd.conf
2.10. /etc/xinetd.d/amanda
2.11. /etc/amanda/supervise/amanda/run
15.1.
15.2.
16.1. /usr/local/libexec/amgtar
16.2. /usr/local/bin/amaespipe
16.3. bz2aespipe.patch
17.1. A C Program to Check the Amanda Service Numbers