This page describes the environmental requirements you should verify before running the install program. The Amanda Enterprise components required on each are described in Downloading and Installing Amanda Enterprise Components.
Throughout this document, The Amanda Client refers the system being backed up by the Amanda Enterprise Server, which also called the Amanda Server or backup server.
System Error DBD::mysql::db do failed: Incorrect key file for table '/var/tmp/#sql_24b8_0.MYI'; try to repair it at /opt/zmanda/zmc/bin/amreport_wrapper line 105. 8:51:26, Mon Mar 17, 2008:ZMC Database Query failed: mysql query failed:Incorrect key file for table '/var/tmp/#sql_24b8_0.MYI'; try to repair it
The .amandahosts file for the amandabackup user (~amandabackup/.amandahosts) on the client must authorize the Amanda server to run a backup.
There is possibly another manual step if either of the following is true:
Under either of these circumstances, ssh is the preferred mechanism for executing restores. ssh is also required when restoring to a a MacOS X/Unix/Linux system that is not running the Zmanda Client software. To force the restore process to use ssh, edit /etc/xinetd.d/zmrecover to include the following line:
Or, on MacOSX systems, run the following command: launchctl unload -w /Library/LaunchDaemons/org.amanda.zmrecover.plist. To re-enable the standard client restore mechanism, enter: launchctl load -w /Library/LaunchDaemons/org.amanda.zmrecover.plist.
Regardless of client platform, the /etc/amanda/amanda-client.conf file must be edited on the client (if the client and server do not reside on the same machine). Specifically, the following entries must be edited:
index_server "localhost" # your amindexd server tape_server "localhost" # your amidxtaped server
Change "localhost" to match to the hostname of the Amanda backup server.
The following packages are required on the Amanda backup server and any clients:
The following programs are needed for Linux backup client
These additional programs are required on the Linux backup server
In addition to these packages, some additional libraries are required (see below).
These packages are installed by default on most Linux distributions. If you need to add them, you can use yum, apt-get, or yast. Packages can be obtained from the distribution media or from a distribution repository (run either as root):
#yum install package_name
or
#apt-get install package_name
or
#yast -i package_name
In the case of yast on SLES, you can also use the YaST Online Update (YOU) to install new package and to keep the SLES distribution updated (which is recommended).
AEE backup server (32bit) and 32-bit backup client requires 32-bit version of following Debian package; AEE 64-bit backup client requires the following 64-bit version Debian package
AEE backup server requires these additional 32-bit version Debian packages:
The best way to install 32-bit version library packages on Debian/Ubuntu is with getlibs, which is described in more detail in this KB article, and at http://www.slack-tux.org/howto/resolve-dependencies-with-getlibs/.
AEE backup server and 32-bit backup client requires the following 32-bit version package; AEE 64-bit backup client requires the following 64-bit version package
To run the Amanda Enterprise Backup Server (or a 32-bit Amanda client) on 64-bit RedHat/CentOS requires these same packages in 32-bit versions, ie.
64-bit packages are required for Amanda Servers running Solaris10/Sparc; 32-bit packages are required for all Amanda clients, and servers running on Solaris/Intel. To account for inter-package dependencies, they should be installed in the order as listed. The following dependencies required on both client and server. The package names (i.e., what you specify when installing) are in boldface type.
Zmanda recommends that you install these packages from Blastwave (http://www.blastwave.org/; detailed instructions are in the next section). For the most up-to-date package dependencies pre-bundled for your convenience, go to the Zmanda network downloads page and click Select your version->Select your OS, and then download the dependencies tar ball file.
These dependencies are required on both server and client:
The following dependencies required only on the server:
Instructions for Solaris package installation from Solaris Blastwave site:
Run the following command for Solaris 10/Open Solaris (Intel and Sparc platforms)
pkgadd -d http://blastwave.network.com/csw/pkgutil_`/sbin/uname -p`.pkg
The above command will install CSWpkgutil package. This command can be used to install Solaris dependencies and indirect dependencies.
For example: The command below will install curl and its dependencies
# /opt/csw/bin/pkgutil --install curl
For more information about using pkgutil, click here.
The dependencies are the same as listed above for Solaris 10, with the following addition:
Instructions for using pkgutil on Solaris 8 and 9 is different. Please see blastwave site for instructions.
Download and install the package dependencies available from the Zmanda Network download page when you select Mac OSX as the client platform.
Some of the dependency packages listed above may change the location of runtime libraries when installed or updated. If this happens, backups may fail with a message indicating that a required library or file could not be found. If this happens, you must update the system search path so that Amanda Enterprise can find the file(s). The Solaris crle (Configure Runtime Linking Environment) provides a simple way to do this:
1. Run crle without any parameters and pipe the output to a file to save the original configuration:
crle > ld.config.old
2. Run crle with the -c and -l options to update the path. For example:
crle -c /var/ld/ld.config -l /lib:/usr/lib:/lib/secure:/usr/lib/secure:/usr/local/lib
Will update the /var/ld/ld.config to use /lib:/usr/lib:/lib/secure:/usr/lib/secure:/usr/local/lib as the search path. Running crle without parameters will display the current search paths in effect. Refer to the Solaris documentation for further details on crle.
The amandabackup user must exist, and be added to the Users, Backup Operators, and Administrators groups. Windows clients must open inbound TCP ports 10080 and 10081, and outbound TCP ports 700:800. Windows application backups (licensed as separate agents) require that the Volume Shadow Copy Service be enabled and started. To prevent excessive memory consumption on application backup clients, Zmanda also recommends that you install the following hotfix from Microsoft:
Link to Microsoft Knowledgebase
See the The Zmanda Windows Client User's Manual for further details on Windows client installation.
If installing on system that doesn't have an amandabackup user, the installation will set up that user with the correct rights (roles). If the user already exists, you may have to make these changes manually. Log in to the system as root, and type the following commands:
${BASEDIR}/usr/sbin/usermod -P "Media Backup,ZFS File System Management,ZFS Storage Management" ${amandabackup} >>${TMPFILE} 2>&1 zfs allow -ldu amandabackup mount,create,rename,snapshot,destroy,send,receive FILESYSTEM
On systems that do not support zfs allow, you can give the amandabackup user permission to manipulate ZFS filesystems by using the following command:
usermod -P "ZFS File System Management,ZFS Storage Management" amandabackup