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