Imported Upstream version 3.3.0

[debian/amanda] / ReleaseNotes

                Release Notes for amanda-3.3.0

* The default auth is changed to "bsdtcp", if you are using the default bsd
  then you must add it to your configuration.
    o in amanda.conf
    o in amanda-client.conf
    o in dumptype/disklist
    o in xinetd (if no '-auth' argument to amandad)
* amdump trap crtl-c, it still send the report and do cleanup if you do
  one crtl-c, do it more than once to abort the run.
* s3 device
    o use multiple threads to speedup the transfer
    o can connect to eucalytus.
    o new NB_THREADS_BACKUP property
    o new NB_THREADS_RECOVERY property
    o new S3_HOST property
    o new S3_SERVICE_PATH property
    o new S3_SUBDOMAIN property
* chg-aggregate: new changer that use other changer sequentially.
* meta-volume
* Add meta label in tapelist file
* chg-disk:
    o support for removable disk
    o new NUM-SLOT property
    o new AUTO-CREATE-SLOT property
    o new REMOVABLE property
    o new MOUNT property
    o new UMOUNT property
    o new UMOUNT-LOCKFILE property
    o new UMOUNT-IDLE property
* new taperscan algorithm:
    o oldest: this algorithm try to run through the volumes in the oldest
      order
    o lexical: this algorithm try to run through the volumes in the natural
      order
* Change in amanda.conf
    o new meta-autolabel option
    o autolabel can include org, config, barcode, meta in the label
    o new client-name option in appication and script.
* application and script in amanda-client.conf can be used to set default
  properties for application or script.
* amlabel
    o The label argument is no longer required, an autolabel can be
      generated
    o new --meta option
    o new --barcode option
    o new --assign option
* amgtar, amstar: The path must be specified, it will not works with a
  device.
* amrecover: decompression and decryption are now done on the client if
             compression/encryption was done on the client.
* amtape: inventory print the current slot
* amanda.conf:
    o autoflush have value "no|yes|all"
    o script have single-execution setting.
    o Add pre-amcheck, post-amcheck, pre-estimate, post-estimate, pre-backup
      and post-backup to execute-on of script.
    o Add taperscan and interactivity section.
    o add 'server' value in recovery-limit.
    o add dump-limit in a dumptype.
* amanda-client.conf
    o add amdump-server setting.
* script are searched in $APPLICATION_DIR, $CONFIG_DIR/<conf>/application
  and $CONFIG_DIR/application
* amservice
    o add -s argument
    o is also installed on client
* new amdumpd server service, if enable, it allow client to start a backup
  of itself.
* new amdump_client program, it is use on client to start a backup of itself
* implement restore command amzfs-sendrecv, it can be use with amrecover.

                Release Notes for amanda-3.2.2

* Do not restore the NUL padding bytes, some program fail with them.
* Fix driver doing nothing if taper crash early.
* Fix taperalog *FIT no going to second volume.
* Fix amrestore '-p' not going to next file.
* flush even if flush threshold are not met if it save tape space.
* fix crash in amtrmidx due to memory leak.
* amsamba use 'Use smbclient -TF' for restore.

                Release Notes for amanda-3.2.1

* barcode are added to the tapelist file.
* Faster 'amadmin find', improve speed on many programs.
* device-output-buffer-size default to a minimum of 4*block_size.
* ssh auth use the client-port
* Bug fixed
   o "Can't opendata output stream: Connection refused" bug.
   o Better handling of dump to tape.
   o Corrupted 'amdump' log file, amstatus not showing correct state.
   o Execute subprocess with the config overwrite.
   o tape-device allow to set LEOM.
   o Crash in robot changer.
   o Script output property are not sent to application.

                Release Notes for amanda-3.2.0

* Support for multiple simultaneous writes to storage devices
   o Can write to all available drives in parallel.
   o Works only with the new changer API.
   o Useful if two or more volumes are used in a single run.
   o dump direct to tape can be scheduled any time during the run,
     previously they were done sequencially after all dump to holding disk.
   o enabled with the new 'taper-parallel-write' configuration option.
* Support for LEOM in storage devices
   o allows splitting without partial parts, saving space
   o much more efficient, since parts need not be cached on disk in most
     cases
* new, simpler splitting commands in the tapetype section:
  part-size, part-cache-type, part-cache-dir, part-cache-max-size; see
  amanda.conf(5) for details
* Amanda server configuration file changes (amanda.conf)
   o new configuration keyword:
      + taper-parallel-write -- How many drive amanda can write to
                                in parallel.
   o deprecated configuration keywords:
      + amrecover_do_fsf
      + amrecover_check_label
* the CONFIG parameter to amidxtaped is now required; this means that
  versions of amrecover older than 2.4.3 will be unable to recover from
  servers running Amanda-3.2 and later.
* The new dumptype and global parameters 'recovery-limit' can be used to
  limit which hosts may recover from a particular DLE.  See amanda.conf(5)
  and amanda-auth(7) for more information.
* Several old changers have been removed - these changers will work with
  Amanda for the forseeable future, but are no longer included in the
  distribution.
   o chg-chio
   o chg-chs
   o chg-iomega
   o chg-juke
   o chg-mcutil
   o chg-mtx
   o chg-null (use the new "chg-null:")
   o chg-rait (use the new "chg-rait:{dev1,dev2}")
   o chg-rth
   o chg-scsi-chio
   o chg-scsi
* Amdump change:
   o new '--no-taper' option to start the run in degraded mode
* Amvault is much improved, but still experimental:
   o supports assembling split parts on the source volume and re-splitting
     them on the destination
   o supports filtering dumps with the same syntax as amfetchdump
   o a --fulls-only option skips all incremental dumps on the source
   o an --export option tries to move tertiary volumes to import/export
     slots when completed
   o command-line syntax has changed incompatibly; see manpage or
     'amvault --help'
* Rewritten and improved:
   o amoverview
   o amcheckdump

                Release Notes for amanda-3.1.0

config
  * The 'rawtapedev' keyword was removed, and the 'label_new_tapes' keyword
    was deprecated.
  * New warnings for dangerous splitting configurations

changer
  We have many changers implementing the new changer API. The new changers are
  faster, more reliable, and have many new features.  One new features is that
  the changer keeps track of which label is in which slot, allowing it to
  locate a tape faster. But with some changers (new chg-multi or chg-robot
  without a barcode), it doesn't get automaticaly notified if you change the
  volume in a slot. In this case, you must notify the changer of it with the
  'amtape <conf> update' command:
    amtape DailySet1 update 3-8
    amtape DailySet1 update 3-8=
    amtape DailySet1 update 3=DailySet-003
  See amanda-changers(7) for more information.

ndmp, dvdrw
  New Amanda devices - see amanda-devices(7) for more information.

amsamba
  The default amandapass file for the amsamba application is
  $CONFIG_DIR/amandapass, but it is /etc/amandapass for program GNUTAR.
  Don't forget to move the file if you switch to the amsamba application.

ampgsql, amsuntar, amraw
  New applications to back up PostgreSQL databases, Solaris systems, and
  raw device files, respectively.

amtape
  Amtape's behavior has changed; see NEWS

amrmtape
  Rewritten with new command-line interface; see NEWS

amdevcheck
  New --label and --properties options give more information about device

amreport
  New, more natural command-line interface (try 'amreport $config')


                Release Notes for amanda-2.6.1

amgtar, amstar, amsamba, amzfs-sendrecv
  Three new programs implementing application-api.
  Swithching from the program "GNUTAR" to the application "amgtar" have some
  advantage:
   - amgtar use by default the gtar --atime-preserve=system option, you must
     disable it if you gtar relase doesn't have that option.
   - Can be configured to cross filesystem.
   - Can be configured to not check the device number on newer gtar
     (--no-check-device of gtar).
   - You can configure error message from gtar you don't want to see in the
     report.

amzfs-snapshot, script-email
  Two new scripts implementing script-api.
  The 'zfs-snapshot' script must be used only with the 'amgtar' application.

amarchiver
  New program to manipulate file in amanda archive format.

New perl Module:
  Application (perl utility functions for Applications)
  Archive (Perl access to the  amanda archive library)
  Constants (perl access to build-time configuration values)
  MainLoop (Perl interface to the Glib MainLoop)
  Process (interface to process), used by amcleanup.
  Script (perl utility functions for Scripts)
  Tapelist (Manipulate the Amanda tapelist)
  Xfer (Xfer-api)


                Release Notes for amanda-2.6.0

amcheckdump
  New program written entirely in perl, it replaces 'amverify' and
  'amveryfyrun'

amcryptsimple, amgpgcrypt
  New encryption plugins based on gpg.

amserverconfig, amaddclient
  New Initial Amanda configuration tools, these tools make assumptions,
   please see man page.

Deprecated programs
  'amverify' and 'amveryfyrun' are deprecated -- use amcheckdump.
  'amdd' and 'ammt' are also deprecated. If you have scripts that use
  them, then you must rewrite them in perl using the new perl modules.

Configure options
  --disable-shared doesn't work because perl modules require shared library.
  Instead, use --with-static-binaries to build staticailly linked binaries.
  --with-amlibdir, libraries are now installed in $amlibdir
    --without-amlibdir              : amlibdir=$libdir
    --with-amlibdir=yes             : amlibdir=$libdir/amanda  (default value)
    --with-amlibdir=/path/to/libdir : amlibdir=/path/to/libdir
  --with-amlibexecdir, internal programs are installed in $amlibexecdir
    --without-amlibexecdir                  : amlibdir=$libexecdir
    --with-amlibexecdir=yes                 : amlibdir=$libexecdir/amanda
                                                             (default value)
    --with-amlibexecdir=/path/to/libexecdir : amlibdir=/path/to/libexecdir
  --with-amperldir, Where to install perl modules
    --without-amperldir               : amperldir=$amlibdir/perl
    --with-amperldir=yes              : amperldir= $(perl installsitelib)
                                                                (default value)
    --with-amperldir=/path/to/perldir : amperldir=/path/to/perldir

Path changes
  Libraries are installed in $amlibdir (previously $libdir)
  Internal programs are installed in $amlibexecdir (previously $libexecdir)
  You must change your inetd/xinetd config for the new amandad path.
  The amandad path change affect rsh/ssh auth, amanda-2.6.0 installations
  will need to add an 'amandad_path' parameter to configuration files in
  order to talk to older versions of Amanda:
     amanda-2.6.0 client -> amanda-2.5.2 or earlier server: add
       'amandad_path "/usr/libexec/amandad"' (or the appropriate path) to
       /etc/amanda/amanda-client.conf
     amanda-2.5.2 or earlier client -> amanda-2.6.0 server: add
       'amandad_path "/usr/libexec/amanda/amandad"' (or the appropriate path)
       to /etc/amanda/amanda-client.conf
     amanda-2.6.0 server -> amanda-2.5.2 or earlier client: add
       'amandad_path "/usr/libexec/amandad"' (or the appropriate path) to the
       dumptype
     amanda-2.5.2 or earlier server -> amanda-2.6.0 client: add
       'amandad_path "/usr/libexec/amanda/amandad"' (or the appropriate path)
       to the dumptype
  The amandates files is now $localstatedir/amanda/amandates, previously it
  was /etc/amandates, this file must be created on all client.

usetimestamps
  It now defaults to 'yes'.

Glib
  glib is required to compile and run amanda.
  It is free and can be downloaded form http://www.gtk.org/download/

Device API
  The Device API is a complete rewrite of all tape-access functionality.
  To use the Device API, all devices must be specified by their full
  name, e.g., tape:/dev/nst0.  Existing functionality is now available
  in the tape, file, and rait devices, and a new Amazon S3 backend named
  's3' is also available.

Perl Module
  Link directly to Amanda, to support writing Amanda applications in Perl
  Available Modules:
    Changer (Execute changer scripts)
    Cmdline (Parse command line argument)
    Config (Parse config files)
    Device (device-api)
    Debug (Write to debug files)
    Logfile (Parse log files)
    Tapefile (Parse tapelist file)
  Perl modules are installed in $amperldir

local security driver (auth)
  Allows backups of the Amanda server without any need for network
  configuration, and similarly allows amrecover to work on the Amanda
  server without any network configuration.

make installcheck
  Almost 200 unit tests are available, which should be run on an installed
  copy of Amanda.  See http://wiki.zmanda.com/index.php/Testing for more
  information.

flush-threshold-dumped, flush-threshold-scheduled, taperflush
  These three config options allow to better fill your tapes.
  They are what was known as the taperstart/taperflush feature.


                Release Notes for amanda-2.5.2

IPv6

  IPv6 support is enabled by default if your OS support it, if your OS is
  not working correctly with IPV6, you can disable it at configure time
  with '--without-ipv6'.

readblocksize

  This option is useful only if you configured amanda with a big
  '--with-maxtapeblocksize' and your hardware can't works with big block
  size.
  

                Release Notes for amanda-2.5.1


usetimestamps

  This new feature will record all dump with timestamp instead of datestamp,
  it will allow to do many dump in a day and recover easily anyone of them.

  If you use this features, you will not be able to downgrade to 2.5.0 or
  earlier.

  see the usetimestamps section of 'man amanda.conf'


bsdudp/bsdtcp

  These are 2 new auth, they still use bsd authentification like bsd, but
  use less port.

  bsdudp is like bsd, it use udp for connecting to client but it will use
  only one tcp port for all data stream.

  bsdtcp use tcp to connect the to client and it's the only network
  connection use.  It doesn't have the udp packet size limit, so you can
  have an unlimited number of DLE for a single host.

amrecover use the security-api

  amrecover now use the security-api, You don't need to configure an
  amindexd and an amidxtaped services in your xinetd.
  amindexd and amidxtaped will be launched by amandad like any other services.
  You must do modification to your xinetd configuration and .amandahosts toi
  allow connection to amindexd and amidxtaped.

new format of xinetd.d/amanda

  amandad get in arguments the list of services it can launch, you must add
  theses services in the server_args options.

new format of .amandahosts

  You must append to each line the services this client can launch, the
  default is "amdump"


See the AUTHORIZATION section of the amanda man page and the
docs/howto-auth.txt