Amanda, The Advanced Maryland Automatic Network Disk Archiver
Copyright (c) 1991, 1995 University of Maryland at College Park
All Rights Reserved.

See the file COPYRIGHT for distribution conditions and official warranty
disclaimer.


Amanda 2.2.6 ALPHA RELEASE NOTES - Febrary 10, 1995
---------------------------------------------------

The latest version of Amanda is always available via anonymous ftp
from ftp.cs.umd.edu in the directory /pub/amanda.

PLEASE NOTE: THIS SOFTWARE IS BEING MADE AVAILABLE ``AS-IS''. UMD is making
this work available so that other people can use it.  This software is in
production use at our home site - the UMCP Department of Computer Science -
but we make no warranties that it will work for you.  Amanda development is
unfunded - the author maintains the code in his spare time.  As a result,
there is no support available other than users helping each other on the
amanda-users mailing list.  See below for information on the mailing lists.


A RELEASE??
-----------

I have been taking a break from the adding new features to Amanda 2.2 and
have instead spent some time on things that could be described as release
engineering - cleaning up the code, incorporating patches, and testing
ports to various and sundry architectures.

As a result, I think Amanda 2.2, while not perfect, is in reasonable enough
shape to be in general use, so I am cutting this as an ALPHA-quality
release and retiring 2.1.1.  If I *have* goofed up something in 2.2.6, I'll
try hard to turn around a fixed release fairly quickly.

So, I recommend that new sites and those having problems with 2.1.1 and
2.2.5 to get 2.2.6.  If you already have an older version of Amanda
installed and are happy with it, you should probably sit tight and watch
developments as they progress.

Amanda 2.2 is still weak in some areas that I have been wanting to complete
for some time, so watch out for new features in future releases (but of
course no promises or time frames!).  In particular, tar support is bound
to make it in soon, as will writing multiple tapes in one run (including
optionally splitting a dump file across tapes -- this is what is holding
this feature up).


WHAT'S NEW SINCE 2.2.5?
-----------------------

* A number of material bugs fixed.
* A lot of lint picked in the whole package.
* The documentation is now reasonably up to date.
* This version has been locally compiled and at least the client side tested
  on the following systems:
	SunOS 4.1.3	IRIX 5.2
	Solaris 2.3	BSDI BSD/386 1.1
	Ultrix 4.2	NetBSD 1.0
	DEC OSF/1 2.0	AIX 3.2
  I don't have any HP/UX machines locally to try it on, but I've tracked
  patches submitted by Neal Becker <neal@ctd.comset.com>, so I'm reasonably
  confident that 2.2.6 shouldn't be far from the mark on that platform.


WHAT'S NEW SINCE 2.1?
---------------------

Many things have changed since Amanda 2.1.  Here are the major items:

* SYSV shared memory no longer required on server side if mmap is available.
* Supports GZIP compression.
* Supports use of mount names as well as device names in disk list
  (eg "/usr" instead of "sd0g").
* Amanda now thinks in real-time - you may run it several times a day if 
  you wish, and it won't get confused.
* Supports Kerberos 4 security as well as BSD-style .rhosts, including
  encrypting files over the net.  The Kerberos support is available as a
  separate add-on package - see the file KERBEROS.HOW-TO-GET on the ftp
  site.
* Improved network protocol - faster startup, no longer dump specific,
  hooks in place for non-dump clients.
* Client-side checks in amcheck - can check sanity of all client hosts very
  quickly.
* Supports multiple holding disks, and load balances between them.

More details are available in docs/WHATS.NEW.


WHAT IS AMANDA?
---------------

This is an alpha-test release of Amanda, the Advanced Maryland Automatic
Network Disk Archiver.  Amanda is a backup system designed to archive many
computers on a network to a single large-capacity tape drive.  This release
is currently in daily use at the University of Maryland at College Park
Computer Science Department, backing up all the disks on all the
workstations in the department: currently over 70 gigabytes of data across
more than 400 filesystems on more than 146 workstations and servers, using
a single 5 Gigabyte Exabyte EXB-8500.  Here are some features of Amanda:

  * written in C, freely distributable.
  * built on top of standard backup software: BSD Unix dump/restore, and
    later GNU Tar and others.
  * will back up multiple machines in parallel to a holding disk, blasting
    finished dumps one by one to tape as fast as we can write files to
    tape.  For example, a ~2 Gb 8mm tape on a ~240K/s interface to a host
    with a large holding disk can be filled by Amanda in under 4 hours. 
  * does simple tape management: will not overwrite the wrong tape.
  * supports tape changers via a generic interface.  Easily customizable to
    any type of tape carousel, robot, or stacker that can be controlled via
    the unix command line.
  * supports Kerberos 4 security, including encrypted dumps.  The Kerberos
    support is available as a separate add-on package, see the file
    KERBEROS.HOW-TO-GET on the ftp site, and the file docs/KERBEROS in this
    package, for more details.
  * for a restore, tells you what tapes you need, and finds the proper
    backup image on the tape for you.
  * recovers gracefully from errors, including down or hung machines.
  * reports results, including all errors in detail, in email to operators.
  * will dynamically adjust backup schedule to keep within constraints: no
    more juggling by hand when adding disks and computers to network.
  * includes a pre-run checker program, that conducts sanity checks on both
    the tape server host and all the client hosts (in parallel), and will
    send an e-mail report of any problems that could cause the backups to
    fail.
  * can compress dumps before sending over net, with either compress or gzip.
  * can optionally syncronize with external backups, for those large
    timesharing computers where you want to do full dumps when the system
    is down in single-user mode (since BSD dump is not reliable on active
    filesystems): Amanda will still do your daily dumps.
  * lots of other options; Amanda is very configurable.


WHAT ARE THE SYSTEM REQUIREMENTS FOR AMANDA?
--------------------------------------------

Amanda requires a host that is mostly idle at night, with a large capacity
tape drive (e.g. an EXABYTE or DAT tape).  This becomes the "tape server
host".  All the computers you are going to dump are the "backup client
hosts".  The server host can also be a client host.

Amanda works best with one or more large "holding disk" partition on the
server host available to it for buffering dumps before writing to tape.
The holding disk allows Amanda to run backups in parallel to the disk, only
writing them to tape when the backup is finished.  Note that the holding
disk is not required: without it Amanda will run backups sequentially to
the tape drive.  Running it this way kills the great performance, but still
allows you to take advantage of Amanda's other features.

As a rule of thumb, for best performance the holding disk should be larger
than the dump output from your largest disk partitions.  For example, if
you are backing up some full gigabyte disks that compress down to 500 MB,
then you'll want 500 MB on your holding disk.  On the other hand, if those
gigabyte drives are partitioned into 500 MB filesystems, they'll probably
compress down to 250 MB and you'll only need that much on your holding
disk.  Amanda will perform better with larger holding disks.  We use 800 MB
for our holding disk.

Actually, Amanda will still work if you have full dumps that are larger
than the holding disk: Amanda will send those dumps directly to tape one at
a time.  If you have many such dumps you will be limited by the dump speed
of those machines.


WHAT SYSTEMS DOES AMANDA RUN ON?
--------------------------------

Amanda should run on any modern Unix system that supports dump, has sockets
and inetd, and either system V shared memory, or BSD mmap implemented.

In particular, Amanda 2.2.6 has been compiled, and the client side tested
on the following systems:
	SunOS 4.1.3	IRIX 5.2
	Solaris 2.3	BSDI BSD/386 1.1
	Ultrix 4.2	NetBSD 1.0
	DEC OSF/1 2.0	AIX 3.2
We only run the server side under SunOS 4.1.3, but it compiles on all those
platforms, and I have no reason at this time to beleive it will not work.

In addition, I have tracked patches for the following systems that we don't
run in house:
	Solaris 2.4
	DEC OSF/1 3.0
	HP/UX


HOW DO I GET AMANDA UP AND RUNNING?
-----------------------------------

    docs/INSTALL	contains general installation instructions.
    docs/SYSTEM.NOTES	contains system-specific information.
    docs/KERBEROS	explains installation under Kerberos 4.
    docs/TAPE.CHANGERS	explains how to customize the changer interface.
    docs/WHATS.NEW	details new features.


WHO DO I TALK TO IF I HAVE A PROBLEM?
-------------------------------------

I maintain the following mailing lists for those interested in Amanda:

==> To join a mailing list, DO NOT, EVER, send mail to that list.  Send
    mail to <listname>-request@cs.umd.edu, or amanda-lists@cs.umd.edu, with
    the following line in the body of the message:
	subscribe <listname> <your-email-address>


    amanda-announce
        The amanda-announce mailing list is for important announcements
        related to the Amanda Network Backup Manager package, including new
        versions, contributions, and fixes.  NOTE: the amanda-users list is
        itself on the amanda-announce distribution, so you only need to
        subscribe to one of the two lists, not both.
	To subscribe, send a message to amanda-announce-request@cs.umd.edu.

    amanda-users
        The amanda-users mailing list is for questions and general discussion
        about the Amanda Network Backup Manager.  This package and related
        files are available via anonymous FTP from ftp.cs.umd.edu in the
        pub/amanda directory.  NOTE: the amanda-users list is itself on the
        amanda-announce distribution, so you only need to subscribe to one of
        the two lists, not both.
	To subscribe, send a message to amanda-users-request@cs.umd.edu.

    amanda-hackers
        The amanda-hackers mailing list is for discussion of the
        technical details of the Amanda package, including extensions,
        ports, bugs, fixes, and alpha testing of new versions.
	To subscribe, send a message to amanda-hackers-request@cs.umd.edu.


Share and Enjoy,
Jaime
...............................................................................
:  James da Silva  :  UCMP Computer Science Dept.  :  Stand on my shoulders,  :
:  jds@cs.umd.edu  :  http://www.cs.umd.edu/~jds   :  not on my toes.         :
