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