lintian doesn't like orphan packages with uploaders...
[debian/amanda] / ReleaseNotes
1                 Release Notes for amanda-3.3.3
2
3 * amdump.X log files use timestamp instead of number, amdump and amdump.1
4   are maintained as symlink.
5 * chg-disk
6     o Use the changerfile for the statefile.
7 * s3 device
8     o support CASTOR storage
9 * amanda.conf
10     o New REPORT-USE-MEDIA and REPORT-NEXT-MEDIA.
11 * amfetchdump
12     o new --extract, --directory, --data-path and --application-property
13       arguments. It allow to do the extraction on the server.
14 * --exact-match argument to many command, and '=' prefix to expression.
15     o It diable use of expression for host, disk, level and datestamp on
16       command line argument.
17 * All changer scripts.
18     o Add LOCK-TIMEOUT property.
19 * Many bug fix.
20
21
22                 Release Notes for amanda-3.3.2
23
24 * amgtar
25     o New IGNORE-ZEROS property.
26 * amsamba
27     o Fix use of subdir for restore.
28 * s3 device
29     o New PROXY property.
30     o New PASSWORD, USERNAME, TENANT_ID, TENANT_NAME properties.
31     o New STORAGE_API property.
32     o New S3_MULTI_DELETE property
33     o New CLIENT_ID, CLIENT_SECRET and REFRESH_TOKEN properties.
34     o New CREATE-BUCKET property.
35     o New PROJECT-ID property.
36     o New REUSE-CONNECTION property.
37     o Works with swift and google storage.
38 * NDMP device
39     o Add INDIRECT property.
40 * amanda.conf
41     o Add 'max-warnings', The maximum number of warning lines in the report.
42     o Default 'columspec' changed to: HostName=0:-12:12,Disk=1:-11:11,Level=1:-1:1,OrigKB=1:-7:0,OutKB=1:-7:0,Compress=1:-6:1,DumpTime=1:-7:7,Dumprate=1:-6:1,TapeTime=1:-6:6,TapeRate=1:-6:1
43 * amadmin
44     o Add --no-default and --print-source arguments for config and
45       disklist command.
46 * amfetchdump
47     o Print progress.
48     o Add --decrypt, --no-decrypt, --server-decrypt, --client-decrypt,
49       --compress, --no-compress, --server-compress and --client-compress
50       options.
51 * fix for compilation with newer glib.
52 * fix for compilation on cigwin.
53 * Many bug fix.
54
55
56                 Release Notes for amanda-3.3.1
57
58 * amrecover
59     o New 'settransalte' command.
60 * amanda.conf
61     o new '$s' substitution in autolabel.
62     o new 'max-dle-by-volume' global option.
63     o new 'eject-volume' global option.
64 * diskfile
65     o new 'includefile' option
66 * amcheck
67     o new '--client-verbose' argument.
68 * All programs have a new '--version' argument.
69 * ampgsql can take property from server configuration.
70 * amgetconf can print one property of a section.
71 * s3 device
72     o new S3_SERVER_SIDE_ENCRYPTION property.
73     o use multiple thread to speedup deleting a volume.
74 * Many bug fix.
75
76
77                 Release Notes for amanda-3.3.0
78
79 * The default auth is changed to "bsdtcp", if you are using the default bsd
80   then you must add it to your configuration.
81     o in amanda.conf
82     o in amanda-client.conf
83     o in dumptype/disklist
84     o in xinetd (if no '-auth' argument to amandad)
85 * amdump trap crtl-c, it still send the report and do cleanup if you do
86   one crtl-c, do it more than once to abort the run.
87 * s3 device
88     o use multiple threads to speedup the transfer
89     o can connect to eucalytus.
90     o new NB_THREADS_BACKUP property
91     o new NB_THREADS_RECOVERY property
92     o new S3_HOST property
93     o new S3_SERVICE_PATH property
94     o new S3_SUBDOMAIN property
95 * chg-aggregate: new changer that use other changer sequentially.
96 * meta-volume
97 * Add meta label in tapelist file
98 * chg-disk:
99     o support for removable disk
100     o new NUM-SLOT property
101     o new AUTO-CREATE-SLOT property
102     o new REMOVABLE property
103     o new MOUNT property
104     o new UMOUNT property
105     o new UMOUNT-LOCKFILE property
106     o new UMOUNT-IDLE property
107 * new taperscan algorithm:
108     o oldest: this algorithm try to run through the volumes in the oldest
109       order
110     o lexical: this algorithm try to run through the volumes in the natural
111       order
112 * Change in amanda.conf
113     o new meta-autolabel option
114     o autolabel can include org, config, barcode, meta in the label
115     o new client-name option in appication and script.
116 * application and script in amanda-client.conf can be used to set default
117   properties for application or script.
118 * amlabel
119     o The label argument is no longer required, an autolabel can be
120       generated
121     o new --meta option
122     o new --barcode option
123     o new --assign option
124 * amgtar, amstar: The path must be specified, it will not works with a
125   device.
126 * amrecover: decompression and decryption are now done on the client if
127              compression/encryption was done on the client.
128 * amtape: inventory print the current slot
129 * amanda.conf:
130     o autoflush have value "no|yes|all"
131     o script have single-execution setting.
132     o Add pre-amcheck, post-amcheck, pre-estimate, post-estimate, pre-backup
133       and post-backup to execute-on of script.
134     o Add taperscan and interactivity section.
135     o add 'server' value in recovery-limit.
136     o add dump-limit in a dumptype.
137 * amanda-client.conf
138     o add amdump-server setting.
139 * script are searched in $APPLICATION_DIR, $CONFIG_DIR/<conf>/application
140   and $CONFIG_DIR/application
141 * amservice
142     o add -s argument
143     o is also installed on client
144 * new amdumpd server service, if enable, it allow client to start a backup
145   of itself.
146 * new amdump_client program, it is use on client to start a backup of itself
147 * implement restore command amzfs-sendrecv, it can be use with amrecover.
148
149                 Release Notes for amanda-3.2.2
150
151 * Do not restore the NUL padding bytes, some program fail with them.
152 * Fix driver doing nothing if taper crash early.
153 * Fix taperalog *FIT no going to second volume.
154 * Fix amrestore '-p' not going to next file.
155 * flush even if flush threshold are not met if it save tape space.
156 * fix crash in amtrmidx due to memory leak.
157 * amsamba use 'Use smbclient -TF' for restore.
158
159                 Release Notes for amanda-3.2.1
160
161 * barcode are added to the tapelist file.
162 * Faster 'amadmin find', improve speed on many programs.
163 * device-output-buffer-size default to a minimum of 4*block_size.
164 * ssh auth use the client-port
165 * Bug fixed
166    o "Can't opendata output stream: Connection refused" bug.
167    o Better handling of dump to tape.
168    o Corrupted 'amdump' log file, amstatus not showing correct state.
169    o Execute subprocess with the config overwrite.
170    o tape-device allow to set LEOM.
171    o Crash in robot changer.
172    o Script output property are not sent to application.
173
174                 Release Notes for amanda-3.2.0
175
176 * Support for multiple simultaneous writes to storage devices
177    o Can write to all available drives in parallel.
178    o Works only with the new changer API.
179    o Useful if two or more volumes are used in a single run.
180    o dump direct to tape can be scheduled any time during the run,
181      previously they were done sequencially after all dump to holding disk.
182    o enabled with the new 'taper-parallel-write' configuration option.
183 * Support for LEOM in storage devices
184    o allows splitting without partial parts, saving space
185    o much more efficient, since parts need not be cached on disk in most
186      cases
187 * new, simpler splitting commands in the tapetype section:
188   part-size, part-cache-type, part-cache-dir, part-cache-max-size; see
189   amanda.conf(5) for details
190 * Amanda server configuration file changes (amanda.conf)
191    o new configuration keyword:
192       + taper-parallel-write -- How many drive amanda can write to
193                                 in parallel.
194    o deprecated configuration keywords:
195       + amrecover_do_fsf
196       + amrecover_check_label
197 * the CONFIG parameter to amidxtaped is now required; this means that
198   versions of amrecover older than 2.4.3 will be unable to recover from
199   servers running Amanda-3.2 and later.
200 * The new dumptype and global parameters 'recovery-limit' can be used to
201   limit which hosts may recover from a particular DLE.  See amanda.conf(5)
202   and amanda-auth(7) for more information.
203 * Several old changers have been removed - these changers will work with
204   Amanda for the forseeable future, but are no longer included in the
205   distribution.
206    o chg-chio
207    o chg-chs
208    o chg-iomega
209    o chg-juke
210    o chg-mcutil
211    o chg-mtx
212    o chg-null (use the new "chg-null:")
213    o chg-rait (use the new "chg-rait:{dev1,dev2}")
214    o chg-rth
215    o chg-scsi-chio
216    o chg-scsi
217 * Amdump change:
218    o new '--no-taper' option to start the run in degraded mode
219 * Amvault is much improved, but still experimental:
220    o supports assembling split parts on the source volume and re-splitting
221      them on the destination
222    o supports filtering dumps with the same syntax as amfetchdump
223    o a --fulls-only option skips all incremental dumps on the source
224    o an --export option tries to move tertiary volumes to import/export
225      slots when completed
226    o command-line syntax has changed incompatibly; see manpage or
227      'amvault --help'
228 * Rewritten and improved:
229    o amoverview
230    o amcheckdump
231
232                 Release Notes for amanda-3.1.0
233
234 config
235   * The 'rawtapedev' keyword was removed, and the 'label_new_tapes' keyword
236     was deprecated.
237   * New warnings for dangerous splitting configurations
238
239 changer
240   We have many changers implementing the new changer API. The new changers are
241   faster, more reliable, and have many new features.  One new features is that
242   the changer keeps track of which label is in which slot, allowing it to
243   locate a tape faster. But with some changers (new chg-multi or chg-robot
244   without a barcode), it doesn't get automaticaly notified if you change the
245   volume in a slot. In this case, you must notify the changer of it with the
246   'amtape <conf> update' command:
247     amtape DailySet1 update 3-8
248     amtape DailySet1 update 3-8=
249     amtape DailySet1 update 3=DailySet-003
250   See amanda-changers(7) for more information.
251
252 ndmp, dvdrw
253   New Amanda devices - see amanda-devices(7) for more information.
254
255 amsamba
256   The default amandapass file for the amsamba application is
257   $CONFIG_DIR/amandapass, but it is /etc/amandapass for program GNUTAR.
258   Don't forget to move the file if you switch to the amsamba application.
259
260 ampgsql, amsuntar, amraw
261   New applications to back up PostgreSQL databases, Solaris systems, and
262   raw device files, respectively.
263
264 amtape
265   Amtape's behavior has changed; see NEWS
266
267 amrmtape
268   Rewritten with new command-line interface; see NEWS
269
270 amdevcheck
271   New --label and --properties options give more information about device
272
273 amreport
274   New, more natural command-line interface (try 'amreport $config')
275
276
277                 Release Notes for amanda-2.6.1
278
279 amgtar, amstar, amsamba, amzfs-sendrecv
280   Three new programs implementing application-api.
281   Swithching from the program "GNUTAR" to the application "amgtar" have some
282   advantage:
283    - amgtar use by default the gtar --atime-preserve=system option, you must
284      disable it if you gtar relase doesn't have that option.
285    - Can be configured to cross filesystem.
286    - Can be configured to not check the device number on newer gtar
287      (--no-check-device of gtar).
288    - You can configure error message from gtar you don't want to see in the
289      report.
290
291 amzfs-snapshot, script-email
292   Two new scripts implementing script-api.
293   The 'zfs-snapshot' script must be used only with the 'amgtar' application.
294
295 amarchiver
296   New program to manipulate file in amanda archive format.
297
298 New perl Module:
299   Application (perl utility functions for Applications)
300   Archive (Perl access to the  amanda archive library)
301   Constants (perl access to build-time configuration values)
302   MainLoop (Perl interface to the Glib MainLoop)
303   Process (interface to process), used by amcleanup.
304   Script (perl utility functions for Scripts)
305   Tapelist (Manipulate the Amanda tapelist)
306   Xfer (Xfer-api)
307
308
309                 Release Notes for amanda-2.6.0
310
311 amcheckdump
312   New program written entirely in perl, it replaces 'amverify' and
313   'amveryfyrun'
314
315 amcryptsimple, amgpgcrypt
316   New encryption plugins based on gpg.
317
318 amserverconfig, amaddclient
319   New Initial Amanda configuration tools, these tools make assumptions,
320    please see man page.
321
322 Deprecated programs
323   'amverify' and 'amveryfyrun' are deprecated -- use amcheckdump.
324   'amdd' and 'ammt' are also deprecated. If you have scripts that use
325   them, then you must rewrite them in perl using the new perl modules.
326
327 Configure options
328   --disable-shared doesn't work because perl modules require shared library.
329   Instead, use --with-static-binaries to build staticailly linked binaries.
330   --with-amlibdir, libraries are now installed in $amlibdir
331     --without-amlibdir              : amlibdir=$libdir
332     --with-amlibdir=yes             : amlibdir=$libdir/amanda  (default value)
333     --with-amlibdir=/path/to/libdir : amlibdir=/path/to/libdir
334   --with-amlibexecdir, internal programs are installed in $amlibexecdir
335     --without-amlibexecdir                  : amlibdir=$libexecdir
336     --with-amlibexecdir=yes                 : amlibdir=$libexecdir/amanda
337                                                              (default value)
338     --with-amlibexecdir=/path/to/libexecdir : amlibdir=/path/to/libexecdir
339   --with-amperldir, Where to install perl modules
340     --without-amperldir               : amperldir=$amlibdir/perl
341     --with-amperldir=yes              : amperldir= $(perl installsitelib)
342                                                                 (default value)
343     --with-amperldir=/path/to/perldir : amperldir=/path/to/perldir
344
345 Path changes
346   Libraries are installed in $amlibdir (previously $libdir)
347   Internal programs are installed in $amlibexecdir (previously $libexecdir)
348   You must change your inetd/xinetd config for the new amandad path.
349   The amandad path change affect rsh/ssh auth, amanda-2.6.0 installations
350   will need to add an 'amandad_path' parameter to configuration files in
351   order to talk to older versions of Amanda:
352      amanda-2.6.0 client -> amanda-2.5.2 or earlier server: add
353        'amandad_path "/usr/libexec/amandad"' (or the appropriate path) to
354        /etc/amanda/amanda-client.conf
355      amanda-2.5.2 or earlier client -> amanda-2.6.0 server: add
356        'amandad_path "/usr/libexec/amanda/amandad"' (or the appropriate path)
357        to /etc/amanda/amanda-client.conf
358      amanda-2.6.0 server -> amanda-2.5.2 or earlier client: add
359        'amandad_path "/usr/libexec/amandad"' (or the appropriate path) to the
360        dumptype
361      amanda-2.5.2 or earlier server -> amanda-2.6.0 client: add
362        'amandad_path "/usr/libexec/amanda/amandad"' (or the appropriate path)
363        to the dumptype
364   The amandates files is now $localstatedir/amanda/amandates, previously it
365   was /etc/amandates, this file must be created on all client.
366
367 usetimestamps
368   It now defaults to 'yes'.
369
370 Glib
371   glib is required to compile and run amanda.
372   It is free and can be downloaded form http://www.gtk.org/download/
373
374 Device API
375   The Device API is a complete rewrite of all tape-access functionality.
376   To use the Device API, all devices must be specified by their full
377   name, e.g., tape:/dev/nst0.  Existing functionality is now available
378   in the tape, file, and rait devices, and a new Amazon S3 backend named
379   's3' is also available.
380
381 Perl Module
382   Link directly to Amanda, to support writing Amanda applications in Perl
383   Available Modules:
384     Changer (Execute changer scripts)
385     Cmdline (Parse command line argument)
386     Config (Parse config files)
387     Device (device-api)
388     Debug (Write to debug files)
389     Logfile (Parse log files)
390     Tapefile (Parse tapelist file)
391   Perl modules are installed in $amperldir
392
393 local security driver (auth)
394   Allows backups of the Amanda server without any need for network
395   configuration, and similarly allows amrecover to work on the Amanda
396   server without any network configuration.
397
398 make installcheck
399   Almost 200 unit tests are available, which should be run on an installed
400   copy of Amanda.  See http://wiki.zmanda.com/index.php/Testing for more
401   information.
402
403 flush-threshold-dumped, flush-threshold-scheduled, taperflush
404   These three config options allow to better fill your tapes.
405   They are what was known as the taperstart/taperflush feature.
406
407
408                 Release Notes for amanda-2.5.2
409
410 IPv6
411
412   IPv6 support is enabled by default if your OS support it, if your OS is
413   not working correctly with IPV6, you can disable it at configure time
414   with '--without-ipv6'.
415
416 readblocksize
417
418   This option is useful only if you configured amanda with a big
419   '--with-maxtapeblocksize' and your hardware can't works with big block
420   size.
421   
422
423                 Release Notes for amanda-2.5.1
424
425
426 usetimestamps
427
428   This new feature will record all dump with timestamp instead of datestamp,
429   it will allow to do many dump in a day and recover easily anyone of them.
430
431   If you use this features, you will not be able to downgrade to 2.5.0 or
432   earlier.
433
434   see the usetimestamps section of 'man amanda.conf'
435
436
437 bsdudp/bsdtcp
438
439   These are 2 new auth, they still use bsd authentification like bsd, but
440   use less port.
441
442   bsdudp is like bsd, it use udp for connecting to client but it will use
443   only one tcp port for all data stream.
444
445   bsdtcp use tcp to connect the to client and it's the only network
446   connection use.  It doesn't have the udp packet size limit, so you can
447   have an unlimited number of DLE for a single host.
448
449 amrecover use the security-api
450
451   amrecover now use the security-api, You don't need to configure an
452   amindexd and an amidxtaped services in your xinetd.
453   amindexd and amidxtaped will be launched by amandad like any other services.
454   You must do modification to your xinetd configuration and .amandahosts toi
455   allow connection to amindexd and amidxtaped.
456
457 new format of xinetd.d/amanda
458
459   amandad get in arguments the list of services it can launch, you must add
460   theses services in the server_args options.
461
462 new format of .amandahosts
463
464   You must append to each line the services this client can launch, the
465   default is "amdump"
466
467
468 See the AUTHORIZATION section of the amanda man page and the
469 docs/howto-auth.txt
470