Imported Upstream version 3.2.1
[debian/amanda] / ReleaseNotes
1                 Release Notes for amanda-3.2.1
2
3 * barcode are added to the tapelist file.
4 * Faster 'amadmin find', improve speed on many programs.
5 * device-output-buffer-size default to a minimum of 4*block_size.
6 * ssh auth use the client-port
7 * Bug fixed
8    o "Can't opendata output stream: Connection refused" bug.
9    o Better handling of dump to tape.
10    o Corrupted 'amdump' log file, amstatus not showing correct state.
11    o Execute subprocess with the config overwrite.
12    o tape-device allow to set LEOM.
13    o Crash in robot changer.
14    o Script output property are not sent to application.
15
16
17                 Release Notes for amanda-3.2.0
18
19 * Support for multiple simultaneous writes to storage devices
20    o Can write to all available drives in parallel.
21    o Works only with the new changer API.
22    o Useful if two or more volumes are used in a single run.
23    o dump direct to tape can be scheduled any time during the run,
24      previously they were done sequencially after all dump to holding disk.
25    o enabled with the new 'taper-parallel-write' configuration option.
26 * Support for LEOM in storage devices
27    o allows splitting without partial parts, saving space
28    o much more efficient, since parts need not be cached on disk in most
29      cases
30 * new, simpler splitting commands in the tapetype section:
31   part-size, part-cache-type, part-cache-dir, part-cache-max-size; see
32   amanda.conf(5) for details
33 * Amanda server configuration file changes (amanda.conf)
34    o new configuration keyword:
35       + taper-parallel-write -- How many drive amanda can write to
36                                 in parallel.
37    o deprecated configuration keywords:
38       + amrecover_do_fsf
39       + amrecover_check_label
40 * the CONFIG parameter to amidxtaped is now required; this means that
41   versions of amrecover older than 2.4.3 will be unable to recover from
42   servers running Amanda-3.2 and later.
43 * The new dumptype and global parameters 'recovery-limit' can be used to
44   limit which hosts may recover from a particular DLE.  See amanda.conf(5)
45   and amanda-auth(7) for more information.
46 * Several old changers have been removed - these changers will work with
47   Amanda for the forseeable future, but are no longer included in the
48   distribution.
49    o chg-chio
50    o chg-chs
51    o chg-iomega
52    o chg-juke
53    o chg-mcutil
54    o chg-mtx
55    o chg-null (use the new "chg-null:")
56    o chg-rait (use the new "chg-rait:{dev1,dev2}")
57    o chg-rth
58    o chg-scsi-chio
59    o chg-scsi
60 * Amdump change:
61    o new '--no-taper' option to start the run in degraded mode
62 * Amvault is much improved, but still experimental:
63    o supports assembling split parts on the source volume and re-splitting
64      them on the destination
65    o supports filtering dumps with the same syntax as amfetchdump
66    o a --fulls-only option skips all incremental dumps on the source
67    o an --export option tries to move tertiary volumes to import/export
68      slots when completed
69    o command-line syntax has changed incompatibly; see manpage or
70      'amvault --help'
71 * Rewritten and improved:
72    o amoverview
73    o amcheckdump
74
75                 Release Notes for amanda-3.1.0
76
77 config
78   * The 'rawtapedev' keyword was removed, and the 'label_new_tapes' keyword
79     was deprecated.
80   * New warnings for dangerous splitting configurations
81
82 changer
83   We have many changers implementing the new changer API. The new changers are
84   faster, more reliable, and have many new features.  One new features is that
85   the changer keeps track of which label is in which slot, allowing it to
86   locate a tape faster. But with some changers (new chg-multi or chg-robot
87   without a barcode), it doesn't get automaticaly notified if you change the
88   volume in a slot. In this case, you must notify the changer of it with the
89   'amtape <conf> update' command:
90     amtape DailySet1 update 3-8
91     amtape DailySet1 update 3-8=
92     amtape DailySet1 update 3=DailySet-003
93   See amanda-changers(7) for more information.
94
95 ndmp, dvdrw
96   New Amanda devices - see amanda-devices(7) for more information.
97
98 amsamba
99   The default amandapass file for the amsamba application is
100   $CONFIG_DIR/amandapass, but it is /etc/amandapass for program GNUTAR.
101   Don't forget to move the file if you switch to the amsamba application.
102
103 ampgsql, amsuntar, amraw
104   New applications to back up PostgreSQL databases, Solaris systems, and
105   raw device files, respectively.
106
107 amtape
108   Amtape's behavior has changed; see NEWS
109
110 amrmtape
111   Rewritten with new command-line interface; see NEWS
112
113 amdevcheck
114   New --label and --properties options give more information about device
115
116 amreport
117   New, more natural command-line interface (try 'amreport $config')
118
119
120                 Release Notes for amanda-2.6.1
121
122 amgtar, amstar, amsamba, amzfs-sendrecv
123   Three new programs implementing application-api.
124   Swithching from the program "GNUTAR" to the application "amgtar" have some
125   advantage:
126    - amgtar use by default the gtar --atime-preserve=system option, you must
127      disable it if you gtar relase doesn't have that option.
128    - Can be configured to cross filesystem.
129    - Can be configured to not check the device number on newer gtar
130      (--no-check-device of gtar).
131    - You can configure error message from gtar you don't want to see in the
132      report.
133
134 amzfs-snapshot, script-email
135   Two new scripts implementing script-api.
136   The 'zfs-snapshot' script must be used only with the 'amgtar' application.
137
138 amarchiver
139   New program to manipulate file in amanda archive format.
140
141 New perl Module:
142   Application (perl utility functions for Applications)
143   Archive (Perl access to the  amanda archive library)
144   Constants (perl access to build-time configuration values)
145   MainLoop (Perl interface to the Glib MainLoop)
146   Process (interface to process), used by amcleanup.
147   Script (perl utility functions for Scripts)
148   Tapelist (Manipulate the Amanda tapelist)
149   Xfer (Xfer-api)
150
151
152                 Release Notes for amanda-2.6.0
153
154 amcheckdump
155   New program written entirely in perl, it replaces 'amverify' and
156   'amveryfyrun'
157
158 amcryptsimple, amgpgcrypt
159   New encryption plugins based on gpg.
160
161 amserverconfig, amaddclient
162   New Initial Amanda configuration tools, these tools make assumptions,
163    please see man page.
164
165 Deprecated programs
166   'amverify' and 'amveryfyrun' are deprecated -- use amcheckdump.
167   'amdd' and 'ammt' are also deprecated. If you have scripts that use
168   them, then you must rewrite them in perl using the new perl modules.
169
170 Configure options
171   --disable-shared doesn't work because perl modules require shared library.
172   Instead, use --with-static-binaries to build staticailly linked binaries.
173   --with-amlibdir, libraries are now installed in $amlibdir
174     --without-amlibdir              : amlibdir=$libdir
175     --with-amlibdir=yes             : amlibdir=$libdir/amanda  (default value)
176     --with-amlibdir=/path/to/libdir : amlibdir=/path/to/libdir
177   --with-amlibexecdir, internal programs are installed in $amlibexecdir
178     --without-amlibexecdir                  : amlibdir=$libexecdir
179     --with-amlibexecdir=yes                 : amlibdir=$libexecdir/amanda
180                                                              (default value)
181     --with-amlibexecdir=/path/to/libexecdir : amlibdir=/path/to/libexecdir
182   --with-amperldir, Where to install perl modules
183     --without-amperldir               : amperldir=$amlibdir/perl
184     --with-amperldir=yes              : amperldir= $(perl installsitelib)
185                                                                 (default value)
186     --with-amperldir=/path/to/perldir : amperldir=/path/to/perldir
187
188 Path changes
189   Libraries are installed in $amlibdir (previously $libdir)
190   Internal programs are installed in $amlibexecdir (previously $libexecdir)
191   You must change your inetd/xinetd config for the new amandad path.
192   The amandad path change affect rsh/ssh auth, amanda-2.6.0 installations
193   will need to add an 'amandad_path' parameter to configuration files in
194   order to talk to older versions of Amanda:
195      amanda-2.6.0 client -> amanda-2.5.2 or earlier server: add
196        'amandad_path "/usr/libexec/amandad"' (or the appropriate path) to
197        /etc/amanda/amanda-client.conf
198      amanda-2.5.2 or earlier client -> amanda-2.6.0 server: add
199        'amandad_path "/usr/libexec/amanda/amandad"' (or the appropriate path)
200        to /etc/amanda/amanda-client.conf
201      amanda-2.6.0 server -> amanda-2.5.2 or earlier client: add
202        'amandad_path "/usr/libexec/amandad"' (or the appropriate path) to the
203        dumptype
204      amanda-2.5.2 or earlier server -> amanda-2.6.0 client: add
205        'amandad_path "/usr/libexec/amanda/amandad"' (or the appropriate path)
206        to the dumptype
207   The amandates files is now $localstatedir/amanda/amandates, previously it
208   was /etc/amandates, this file must be created on all client.
209
210 usetimestamps
211   It now defaults to 'yes'.
212
213 Glib
214   glib is required to compile and run amanda.
215   It is free and can be downloaded form http://www.gtk.org/download/
216
217 Device API
218   The Device API is a complete rewrite of all tape-access functionality.
219   To use the Device API, all devices must be specified by their full
220   name, e.g., tape:/dev/nst0.  Existing functionality is now available
221   in the tape, file, and rait devices, and a new Amazon S3 backend named
222   's3' is also available.
223
224 Perl Module
225   Link directly to Amanda, to support writing Amanda applications in Perl
226   Available Modules:
227     Changer (Execute changer scripts)
228     Cmdline (Parse command line argument)
229     Config (Parse config files)
230     Device (device-api)
231     Debug (Write to debug files)
232     Logfile (Parse log files)
233     Tapefile (Parse tapelist file)
234   Perl modules are installed in $amperldir
235
236 local security driver (auth)
237   Allows backups of the Amanda server without any need for network
238   configuration, and similarly allows amrecover to work on the Amanda
239   server without any network configuration.
240
241 make installcheck
242   Almost 200 unit tests are available, which should be run on an installed
243   copy of Amanda.  See http://wiki.zmanda.com/index.php/Testing for more
244   information.
245
246 flush-threshold-dumped, flush-threshold-scheduled, taperflush
247   These three config options allow to better fill your tapes.
248   They are what was known as the taperstart/taperflush feature.
249
250
251                 Release Notes for amanda-2.5.2
252
253 IPv6
254
255   IPv6 support is enabled by default if your OS support it, if your OS is
256   not working correctly with IPV6, you can disable it at configure time
257   with '--without-ipv6'.
258
259 readblocksize
260
261   This option is useful only if you configured amanda with a big
262   '--with-maxtapeblocksize' and your hardware can't works with big block
263   size.
264   
265
266                 Release Notes for amanda-2.5.1
267
268
269 usetimestamps
270
271   This new feature will record all dump with timestamp instead of datestamp,
272   it will allow to do many dump in a day and recover easily anyone of them.
273
274   If you use this features, you will not be able to downgrade to 2.5.0 or
275   earlier.
276
277   see the usetimestamps section of 'man amanda.conf'
278
279
280 bsdudp/bsdtcp
281
282   These are 2 new auth, they still use bsd authentification like bsd, but
283   use less port.
284
285   bsdudp is like bsd, it use udp for connecting to client but it will use
286   only one tcp port for all data stream.
287
288   bsdtcp use tcp to connect the to client and it's the only network
289   connection use.  It doesn't have the udp packet size limit, so you can
290   have an unlimited number of DLE for a single host.
291
292 amrecover use the security-api
293
294   amrecover now use the security-api, You don't need to configure an
295   amindexd and an amidxtaped services in your xinetd.
296   amindexd and amidxtaped will be launched by amandad like any other services.
297   You must do modification to your xinetd configuration and .amandahosts toi
298   allow connection to amindexd and amidxtaped.
299
300 new format of xinetd.d/amanda
301
302   amandad get in arguments the list of services it can launch, you must add
303   theses services in the server_args options.
304
305 new format of .amandahosts
306
307   You must append to each line the services this client can launch, the
308   default is "amdump"
309
310
311 See the AUTHORIZATION section of the amanda man page and the
312 docs/howto-auth.txt
313