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