The Official AMANDA Documentation

Table of Contents

Abstract

Copyright Information

Attributions

I. 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

II. 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

III. 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

17. How to use different auth with Amanda

Introduction

BSD

BSDTCP

BSDUDP

KRB4

KRB5

RSH

SSH

For amdump:

For amrecover:

IV. Various Information

18. 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

19. Amanda FAQ

20. 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

...

21. Amanda WISHLIST

V. Technical Background

22. 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

23. 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

24. Amanda Internals

Protocols

server and amandad on client

planner and driver

driver and dumper

taper(read) and taper(write)

25. Amanda Event API

Introduction

The API

event_register

event_release

event_loop

event_wait

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

26. 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

27. Virtual Tape API

28. 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

VI. Historical files

29. Response to CPIO Security Notice Issue 11:

Affected Versions

Workaround

Acknowledgements

30. Upgrade Issues

31. 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

32. 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

33. Thoughts about a Strategy API

34. Y2K Compliancy

35. Usage of floppy tape drives on Linux

VII. Appendixes

36. 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

amanda-client.conf — Client 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

amcrypt-ossl — crypt program for Amanda symmetric data encryption using OpenSSL

amcrypt-ossl-asym — crypt program for Amanda asymmetric data encryption using OpenSSL

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

37. Web Ressources

Index