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 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:
Note for 64bit Debian/Ubuntu Amanda servers: The best way to install 32-bit version library packages on 64bit Debian/Ubuntu platforms is with getlibs, which is described in more detail in this Zmanda Knowledgebase article. Alternatively, libreadline5 32bit version can be obtained by installing lib32readline5 package.
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. This dependency list is an attempt to document all direct Amanda dependencies and indirect dependencies (Amanda depends on a package that in turn depends on other packages).
SUNW packages can be found as part of Solaris distribution. Zmanda recommends that you install the CSW packages from Blastwave (http://www.blastwave.org/; detailed instructions are in the next section). Some package dependencies are pre-bundled for your convenience and are available at Zmanda network downloads page. 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:
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
index_server "localhost" # your amindexd server tape_server "localhost" # your amidxtaped server
Change "localhost" to match to the hostname of the Amanda backup server.
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.
The following browsers have been tested and verified to work with the Zmanda Management Console:
In all cases you must have JavaScript enabled. Note that if JavaScript is enabled during a session either in the browser itself or in a plug-in such as NoScript, you must log out of the ZMC and then log in again to avoid potential problems with the interface. If you are browsing over a slow connection such as dial-up, loading of the JavaScript files may time out after 15 seconds with the following error:
ZMC has not yet loaded required javascript files. Do you want to continue waiting for these files to load?
Clicking OK will cause the ZMC to try again for 60 seconds. If that fails, another error. If it takes more than 60 seconds to load the JavaScript files, logging out and then in again will usually give the browser enough time to cache all necessary JavaScript files and allow the ZMC to load.