Zmanda Client for Solaris Manual

Pre-installation checklist

• All Solaris packages from Zmanda Network are compressed using GNU zip (gzip). The gzip package is available from Zmanda Network.

• Check if SSH (secure shell) software is installed: the Amanda Solaris Client 10 requires Solaris package SUNWsshcu to be installed on the client machine. The SUNWsshcu Solaris package is available from your Solaris distribution.

• Install GNU tar from the Zmanda network downloads page. Solaris CSWgtar version 1.15.1 is required for Amanda client installation.

• Install any optional packages from Zmanda network downloads pages. - CSWgnupg (if GPG data encryption is required on the Amanda client), CSWstar (if Schily tar will be used as backup program on the Amanda client).

• To use Amanda SSH transport authentication, SUNWsshdr, SUNWsshdu, SUNWsshr and SUNWsshu from the Solaris distribution are required.

• Clients being restored to must also have the SUNWsshcu package installed. In addition, the following entry must be added to the $HOME/.ssh/environment configuration file:

PATH="/opt/csw/bin:/opt/sfw/bin:/usr/csw/bin:/usr/sfw/bin:/usr/bin:/usr/local/bin:/usr/sbin"

Client installation

• Amanda client installation must be performed as super user (in other words, the root user).

• Download the Amanda Enterprise Edition 3.1 Solaris client package from the Zmanda network downloads page. There are two packages - AmandaEnterpriseBackupClient and AmandaEnterpriseExtensionsClient . Both packages are required.
• Save or copy the Solaris package to the Amanda client machine, for example, to the /tmp directory.

• The Amanda client package is compressed using gzip. Uncompress the packages using the gunzip command.

# gunzip AmandaEnterpriseBackupClient-3.1-SunOS5.10-sparc.pkg.gz

• Install AmandaEnterpriseBackupClient package using pkgadd.

Example: Amanda client installation on Solaris 10

# pkgadd -d AmandaEnterpriseBackupClient-3.1-SunOS5.10-sparc.pkg
The following packages are available:
 1  AmandaEnterpriseBackupClient     Amanda Enterprise Backup Client from Zmanda
                                      (sparc) 3.1
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: all
Processing package instance <AmandaEnterpriseBackupClient> from
</tmp/AmandaEnterpriseBackupClient-3.1-SunOS5.10-sparc.pkg>
Amanda Enterprise Backup Client from Zmanda
( sparc) 3.1
Using </> as the package base directory.
## Processing package information.
## Processing system information.
## Verifying package dependencies.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
The following files are being installed with setuid and/or setgid
permissions:
 /usr/lib/amanda/calcsize <setuid root>
 /usr/lib/amanda/killpgrp <setuid root>
 /usr/lib/amanda/rundump <setuid root>
 /usr/lib/amanda/runstar <setuid root>
 /usr/lib/amanda/runtar <setuid root>
Do you want to install these as setuid/setgid files [y,n,?,q] y
This package contains scripts which will be executed with super-user
permission during the process of installing this package.
Do you want to continue with the installation of
<AmandaEnterpriseBackupClient> [y,n,?] y
Installing Amanda Enterprise Backup Client from Zmanda as <AmandaEnterpriseBackupClient>
## Executing preinstall script.
Apr 28 2010 16:10:19: Preparing to install: AmandaEnterpriseBackupClient - Version 3.1
Apr 28 2010 16:10:19: Checking for 'amandabackup' user...
Apr 28 2010 16:10:19:
Apr 28 2010 16:10:19:  The Amanda backup software is configured to operate as the
Apr 28 2010 16:10:19:  user 'amandabackup'.  This user exists on your system and has not
Apr 28 2010 16:10:19:  been modified.  To ensure that Amanda functions properly,
Apr 28 2010 16:10:19:  please see that the following parameters are set for that
Apr 28 2010 16:10:19:  user.:
Apr 28 2010 16:10:19:
Apr 28 2010 16:10:19:  SHELL:          /bin/sh
Apr 28 2010 16:10:19:  HOME:           //var/lib/amanda
Apr 28 2010 16:10:19:  Default group:  disk
Apr 28 2010 16:10:19:
Apr 28 2010 16:10:19:
Apr 28 2010 16:10:19: === Amanda Enterprise backup client installation started. ===
##Installing part 1 of 1.
/usr/lib/amanda/amandad
/usr/lib/amanda/amcat.awk
/usr/lib/amanda/amplot.awk
/usr/lib/amanda/amplot.g
/usr/lib/amanda/amplot.gp
/usr/lib/amanda/calcsize
/usr/lib/amanda/generic-dumper
/usr/lib/amanda/gnutar
/usr/lib/amanda/killpgrp
/usr/lib/amanda/noop
/usr/lib/amanda/patch-system
/usr/lib/amanda/rundump
/usr/lib/amanda/runstar
/usr/lib/amanda/runtar
/usr/lib/amanda/selfcheck
/usr/lib/amanda/sendbackup
/usr/lib/amanda/sendsize
/usr/lib/amanda/star
/usr/lib/amanda/versionsuffix
/usr/lib/libamanda-3.1.so
/usr/lib/libamanda.a
/usr/lib/libamanda.la
/usr/lib/libamanda.so <symbolic link>
/usr/lib/libamandad-3.1.so
/usr/lib/libamandad.a
/usr/lib/libamandad.la
/usr/lib/libamandad.so <symbolic link>
/usr/lib/libamclient-3.1.so
/usr/lib/libamclient.a
/usr/lib/libamclient.la
/usr/lib/libamclient.so <symbolic link>
/usr/sbin/amcrypt-ossl
/usr/sbin/amcrypt-ossl-asym
/usr/sbin/amcryptsimple
/usr/sbin/amgpgcrypt
/usr/sbin/amoldrecover
/usr/sbin/amplot
/usr/sbin/amrecover
/usr/share/man/man5/amanda-client.conf.5
/usr/share/man/man5/amanda.conf.5
/usr/share/man/man8/amanda.8
/usr/share/man/man8/amcrypt-ossl-asym.8
/usr/share/man/man8/amcrypt-ossl.8
/usr/share/man/man8/amcryptsimple.8
/usr/share/man/man8/amgpgcrypt.8
/usr/share/man/man8/amplot.8
/usr/share/man/man8/amrecover.8
/var/lib/amanda/example/amanda-client.conf
/var/lib/amanda/example <implied directory>
/var/lib/amanda/example/inetd.conf.amandaclient
[ verifying class <none> ]
## Executing postinstall script.
Apr 28 2010 16:10:20: Installing '//etc/amandates'.
Apr 28 2010 16:10:20: Ensuring correct permissions for '//etc/amandates'.
Apr 28 2010 16:10:20: '//etc/amandates' Installation successful.
Apr 28 2010 16:10:20: Checking '//var/lib/amanda/.amandahosts' file.
Apr 28 2010 16:10:20: Checking '//etc/amanda/amanda-client.conf' file.
Apr 28 2010 16:10:20: Installing '//var/lib/amanda/.gnupg'.
Apr 28 2010 16:10:20: '//var/lib/amanda/.gnupg' will be created.
Apr 28 2010 16:10:20: The directory '//var/lib/amanda/.gnupg' created successfully.
Apr 28 2010 16:10:21: Ensuring correct permissions for '//etc/.gnupg'.
Apr 28 2010 16:10:21: '//var/lib/amanda/.gnupg' Installation successful.
Apr 28 2010 16:10:21: Creating directory '//var/lib/amanda/.ssh'.
Apr 28 2010 16:10:21: Creating ssh RSA key in '//var/lib/amanda/.ssh/id_rsa_amrecover'
Apr 28 2010 16:10:21: Setting owner and permission for '//var/lib/amanda/.ssh' and '//var/lib/amanda/.ssh/id_rsa_amrecover*'
Apr 28 2010 16:10:21: Checking for '//var/lib/amanda/.profile' and ensuring correct environment.
Apr 28 2010 16:10:21: Setting ownership and permissions for '//var/lib/amanda/.profile'
Apr 28 2010 16:10:21: === Amanda Enterprise backup client installation complete. ===
Amanda installation log can be found in '//var/log/amanda/install.log' and errors (if any) in '//var/log/amanda/install.err'.
Installation of <AmandaEnterpriseBackupClient> was successful.

• Amanda client configuration files are created during Amanda client package installation. The list of files that are modified during installation can be seen in the above installation command output.

• The logs for Amanda client package installation can be found in /var/log/amanda/install.log. If there are installation errors, messages are logged to the /var/log/amanda/install.err file.

• During the install, the amandabackup user is created if it does not already exist. Please assign a password for the amandabackup user.
• Install AmandaEnterpriseExtensionsClient package using pkgadd command.

Post-installation checklist

Note: These tasks must be performed as super user (the root user).

• Check installation log files

The Amanda installation log can be found in /var/log/amanda/install.log and errors (if any) in /var/log/amanda/install.err.
Make sure there are no errors in the log files.

• Perform the post installation steps common to all Amanda clients.
• Check xinetd configuration

Make sure the following line is in the /etc/services file on the Amanda client:

amanda       10080/tcp

Configure the Amanda xinetd service:

# inetadm |grep svc:/network/amanda/tcp |grep online

enabled   online         svc:/network/amanda/tcp:default

# svcadm restart network/amanda/tcp

 amanda stream tcp nowait amandabackup /usr/lib/amanda/amandad amandad -auth=bsdtcp amdump

# pkill -HUP inetd

Adding Client file systems in ZMC

You can add the Solaris file systems/folders to the backup set using Zmanda Management Console. Use the Backup What page in the Zmanda management console to add folders from the Solaris client. You will need to specify the client name and the directories to back up.

Extended Attributes under Advanced Options in the Backup What page should not be selected for Mac OS X file systems. Extended attributes (such as Mac OS X resource forks) are backed up by default for Mac OS X and there is no option to turn it off.

Compatibility with Amanda server

The Amanda Enterprise 3.1 Solaris client is compatible with Amanda servers running Amanda Enterprise Edition 3.1 and 3.0.x (with and without Zmanda Management Console).

Upgrading from Amanda Solaris clients (compiled on your own)

• The Amanda Enterprise Edition 3.1 source tar ball can be compiled on the Solaris platform.

• Successfully upgrading from a self-compiled version of the Amanda client to Amanda Enterprise Edition 3.1 depends on the compile-time configuration parameters. Some configuration changes may be required to compile and upgrade. Please contact [email protected] if you are interested in upgrading to the Amanda Enterprise 3.1 Solaris client.