|
Packit |
23ab03 |
Upgrading
|
|
Packit |
23ab03 |
=========
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
This file describes the process for ugprading Amanda from a previous
|
|
Packit |
23ab03 |
version. In general, the Amanda development team aims for seamless
|
|
Packit |
23ab03 |
upgrades. In the rare cases where an upgrade requires other changes
|
|
Packit |
23ab03 |
on your system, they are described in this file.
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
The file is organized from oldest to newest. Please follow all of
|
|
Packit |
23ab03 |
the directions, in order, for the range of versions over which you
|
|
Packit |
23ab03 |
are upgrading.
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
See also http://wiki.zmanda.com/index.php/Version_compatibility for notes
|
|
Packit |
23ab03 |
on the compatibility of various versions of Amanda.
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
General Notes
|
|
Packit |
23ab03 |
-------------
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
When upgrading, be careful not to allow the new version of Amanda to find
|
|
Packit |
23ab03 |
already-installed libraries from the old version. The safest way to ensure
|
|
Packit |
23ab03 |
this is to move the old libraries out of the way or remove them before
|
|
Packit |
23ab03 |
compiling the new version. There may be more effective ways to do so that are
|
|
Packit |
23ab03 |
specific to your operating system.
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
Upgrading from pre-2.4.0
|
|
Packit |
23ab03 |
------------------------
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
Amanda 2.4.0 has introduced a major incompatibility in the Amanda protocol.
|
|
Packit |
23ab03 |
This means that pre-2.4.0 clients won't interoperate with a 2.4.0 server, nor
|
|
Packit |
23ab03 |
will 2.4.0 clients interoperate with pre-2.4.0 servers. You have to upgrade
|
|
Packit |
23ab03 |
them all at the same time.
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
To ease the upgrade process Amanda has, from release 2.4.0 on, a configure flag
|
|
Packit |
23ab03 |
(--with-testing) that will cause Amanda to use alternate service names (Amanda-
|
|
Packit |
23ab03 |
test) instead of the standard ones. This allows you to keep using your old
|
|
Packit |
23ab03 |
version of Amanda while you test the new one.
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
Depending upon the version of Amanda you are upgrading from, Amanda may use a
|
|
Packit |
23ab03 |
different database library to store the backup information, and the new Amanda
|
|
Packit |
23ab03 |
may not be able to read the old Amanda database files. In this case, you will
|
|
Packit |
23ab03 |
want to do something like the following:
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
Before the upgrade (using the old version of amadmin):
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
# cd /var/AMANDA/CONFIG
|
|
Packit |
23ab03 |
# amadmin CONFIG export > zzz
|
|
Packit |
23ab03 |
# mkdir backup
|
|
Packit |
23ab03 |
# mv curinfo* backup
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
and after the upgrade (using the new version of amadmin):
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
# cd /var/AMANDA/CONFIG
|
|
Packit |
23ab03 |
# amadmin CONFIG import < zzz
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
and a month :-) after you are happy with the new version:
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
# cd /var/AMANDA/CONFIG
|
|
Packit |
23ab03 |
# rm -rf backup
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
After 2.4.0, the structure of the directory holding the index files was changed
|
|
Packit |
23ab03 |
to have three levels instead of being flat. This greatly reduces the number of
|
|
Packit |
23ab03 |
files in a given directory, which was a problem for some systems.
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
The new layout is:
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
[indexdir]/hostname/filesystem/YYYYMMDD_L.gz
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
where hostname and filesystem are "sanitized" versions of the names from
|
|
Packit |
23ab03 |
disklist, i.e. '/' characters are converted to '_' and so on. This new naming
|
|
Packit |
23ab03 |
convention matches the one used for the text formatted database.
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
A script is available to convert the flat directory structure to the new
|
|
Packit |
23ab03 |
layout:
|
|
Packit |
23ab03 |
|
|
Packit |
23ab03 |
http://www.amanda.org/2.4-conv/msg00428.html
|