Template:AAE Pre-installation Checks

Version as of 06:30, 16 Apr 2024

to this version.

Return to Version archive.

View current version

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.

  • Identify the hosts and filesystems to be protected using Amanda software. The list of hosts to be protected are the Amanda backup clients. The Amanda backup clients and the filesystems or directories to be backed up on each client will need to be specified during Amanda configuration.
  • Identify the Amanda backup server. The Amanda backup server should have access to the media (tape, disk, changers) where the Amanda client backups will be stored. Any Amanda client can also act as an Amanda server, and it is recommended that every Amanda server also be a backup client. In selecting your Amanda backup server machine, keep in mind that the server might use a significant amount of memory during backup runs, and that it must have good network connectivity to all Amanda clients.

    If a tape changer is the intended backup media, the backup server also requires both the mt and mtx package in addition to the platform-specific dependencies listed below. If a tape drive is the intended backup media, mt is required. Without the appropriate packages, ZMC will return an error message when you try to view these devices.

Amanda Enterprise Requirements

  • The Amanda server and clients must have the latest service packs or updates to the distribution installed.
  • Amanda server and client cannot be installed on an NFS-mounted file systems.
  • The Amanda server must have the locale set to en_* (for example, en_US.UTF-8)C, or POSIX.
  • The amandabackup user must be added to cron.allow file. This file is usually in /etc or /etc/cron.d directory. 
  • If you intend to back up an Oracle server, the amandabackup user must have permission to write to the $ORACLE_HOME directory.
  • To run the Rapid Installer, the Amanda Server requires 256MB of free memory. You should have at least 500MB of disk space, and you should not install the ZMC itself (/opt/zmanda/amanda) on an NFS partition.
  • In addition to the space required for the software itself, you should ensure that there is always 10% free in the Zmanda installation and temporary directories, defined here. If Amanda Enterprise runs out of space on either of these directories while a backup is in progress, the backup will fail with MySQL errors similar to the following:
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
If you encounter messages like this, try increasing the amount of available disk space in the relevant directories.
  • The following TCP ports must be open:
    • Amanda server: must open inbound TCP ports 11000:11040.
    • Non-Windows Amanda clients must open inbound TCP port 10080 and outbound TCP ports 11000:11040.
    • Windows clients must open inbound TCP ports 10080 and 10081, and outbound TCP ports 700:800.
  • Internal firewalls and selinux policy must not prevent PHP processes from using HTTP over the loopback address 127.0.0.1
  • Solaris with unpatched systems may experience Apache problems, which are described (along with workaround) in this Zmanda Knowledgebase article.

Requirements for Restore Clients (Linux/Solaris/Mac OS X)

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:

  • Either the restore client or the Amanda backup server are running version 2.6.3 Amanda Enterprise.
  • Secure communications are required for the restore operation.

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:

disable = yes

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.

Package Dependencies

The following packages are required on the Amanda backup server and any clients:

Linux

Solaris 10

Solaris 8 and 9 

Mac OSX 

Linux RPMs

32-bit packages are required for 32-bit Linux. 64-bit packages are required for 64-bit Linux.

The following programs are needed for Linux backup client

  • GNU tar (version 1.15.1 or greater, except Redhat/CentOS, which supports verson 1.14 or greater)
  • xinetd
  • ssh server
  • perl (version 5.6.0 or greater)

These additional programs are required on the Linux backup server

  • ssh client
  • gnuplot
  • mailx
     

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).

Linux Debian/Ubuntu

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

  • libcurl3-gnutls

AEE backup server requires these additional 32-bit version Debian packages:

  • ia32-libs (only needed by 64-bit Debian/Ubuntu platforms)
  • libreadline5
  • libglib2.0-0

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/.

Required Packages for Redhat/CentOS

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

  • curl
  • readline
  • glib2
  • termcap

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.

  • glib2.i386
  • curl.i386
  • readline.i386
  • termcap.i386
Required Packages for Suse/SLES

AEE backup server and 32-bit backup client requires the following 32-bit version packages;  AEE 64-bit backup client requires the following 64-bit version packages:

  • curl
  • readline
  • glib2 

To run the Amanda Enterprise Backup Server (or a 32-bit Amanda client) on |64-bit Suse/SLES requires the following packages in 32-bit version packages:

  • glib2-i386
  • curl-i386
  • readline-i386
  • termcap-i386

Solaris 10 (Both Sparc and Intel Architectures)

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:

  1. CSWgtar gtar - GNU tape archiver
  2. CSWossl openssl - Openssl meta package
  3. CSWosslrt openssl_rt - Openssl runtime libraries
  4. CSWosslutils openssl_utils - Openssl binaries and related tools
  5. CSWcurl curl - Library and tool for common Internet protocols
  6. CSWcurlrt curlrt - Library for common Internet protocols Runtime
  7. CSWggettext ggettext - GNU gettext
  8. CSWoldaprt openldap_rt - OpenLDAP runtime libraries (oldaprt)
  9. CSWreadline readline - library to enable interactive line editing
  10. CSWglib2 glib2 - Note also that the LD_LIBRARY_PATH environment variable must be set for the amandabackup user.
  11. CSWbdb4 berkeleydb4 - Embedded database libraries and utilities.
  12. CSWcommon common - Installs some useful standard CSW filesystem symlinks and files
  13. CSWexpat expat - XML parser toolkit
  14. CSWlibiconv libiconv - Unicode support library
  15. CSWlibidn libidn  - Implementation of the Stringprep, Punycode and IDNA
  16. CSWlibnet libnet - Packet construction library
  17. CSWlibsunmath libsunmath - Sun maths library
  18. CSWopenssl_devel openssl_devel - Open SSL developer support
  19. CSWsasl sasl - Simple Authentication and Security Layer
  20. CSWzlib zlib - Data compression library

The following dependencies required only on the server:

  1. CSWfindutils findutils - A set of utilities for searching a filesystem
  2. CSWgfile fileutils - GNU file utilities
  3. CSWgcc3g++rt gcc3g++rt - GNU C++ Compiler Run Time
  4. CSWgcc3corert-3.4.5 gcc3corert-3.4.5
  5. CSWmtx mtx - SCSI Media Changer and Backup Device Control

Instructions for Solaris package installation from Blastwave:

Install pkg-get. copy http://blastwave.network.com/csw/pkg_get.pkg into /tmp/

>pkgadd -d /tmp/pkg_get.pkg all

Download the version of wget of the appropriate architecture from either http://blastwave.network.com/csw/wget-sparc.bin or http://blastwave.network.com/csw/wget-i386.bin to local /tmp/wget, and execute the following as root:

>chmod 755 /tmp/wget
>PATH=/tmp:/opt/csw/bin:/usr/sbin:/usr/bin:/usr/dt/bin:/usr/openwin/bin:/usr/ccs/bin
>export PATH

Edit the pkg-get configuration file

>vi /opt/csw/etc/pkg-get.conf

Enable http_proxy, ftp_proxy, export http_proxy ftp_proxy.

Install the wget command

>pkg-get -i wget
>rm /tmp/wget
>PATH=/opt/csw/bin:/usr/sbin:/usr/bin:/usr/openwin/bin:/usr/dt/bin:/usr/ccs/bin
>export PATH

Example command for installing gnu tar dependencies. Add all dependencies that are needed to the command line:

>/opt/csw/bin/pkg-get -i gtar

 

 

Solaris 8 and 9 (Sparc Architecture)

The dependencies are the same as listed above for Solaris 10, with the following addition:

  • CSWperl (the default version of Perl shipped with Solaris 8 will not work with Amanda Enterprise 3.0).

Mac OSX (Client only)

Download and install the package dependencies available from the Zmanda Network download page when you select Mac OSX as the client platform.

Libraries installed in non-standard locations

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.

Windows (2003 Server, XP, and Vista) clients

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.

Requirements for the amandabackup User on Solaris

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