Zmanda Client for Mac OS X Manual

Version as of 19:54, 3 May 2024

to this version.

Return to Version archive.

View current version

Zmanda Mac OS X Client is certified Amanda network backup software, tested and supported by Zmanda. This document has been prepared in conjunction with the Amanda Enterprise Edition 3.0 release.

Amanda Enterprise Edition Mac OS X Client packages are available for the following platforms from the Zmanda network downloads page:

  • Mac OS X 10.4 Intel and PPC architecture
  • Mac OS X 10.5 Intel and PPC architecture

This document discusses the Amanda Enterprise Edition Mac OS X Client installation, configuration and verification procedures. Please refer to Amanda Enterprise Edition 3.0 ZMC User's Guide for information on how to install and configure the Amanda server. All Amanda Enterprise Edition features discussed in Amanda Enterprise Edition 3.0 ZMC User's Guide also apply to Mac OS X clients.

Installing the Zmanda Mac OS X Client

To install the client, follow these steps:

  1. Make sure the client meets the requirements described here.
  2. Become the Administrative user.
  3. Download and install the package dependencies available from the Zmanda Network download page when you select Mac OS X as the client platform.
  4. Download the Amanda Enterprise Edition Mac OS X client package from the Zmanda network downloads page.
  5. Run the installation program and follow the on-screen instructions.
  6. Follow the instructions in the Post-installation checklist.
  7. Configure the Mac OS X client, as described here.
  8. Validate the new client, as described here.

Post-installation checklist

Assign a password to the amandabackup user that was created the client install. This user on the Mac OS X client can be used for command line operations.

Adding Client file systems in ZMC

You can add the Mac OS X machine to the backup set using Zmanda Management Console. Use the Backup -> What page in the Zmanda management console to configure the Mac OSX client. You will need to specify the client name and the directories to back up.

Restoration to Mac OS X client

Log on the Amanda Mac OS X Client as root, then recover files from the backup. Run the

zmrecover

command to recover the files to a temporary directory on the Amanda client.

# zmrecover TestConfig -s Amanda_server_name -t Amanda_server_name

If the ssh method of restore is used (which will be necessary in the circumstances listed here), restoring to Mac OS X client using Zmanda Management Console requires Administrative user with privileges to write to the client.

This user name should be provided in the Restore->What page of Zmanda Management Console during the restore process. The following screen shows how to create "zmanda-admin" Administrative user on Mac OS X.

Step 1: Administrative user creation on MacOS X client

5. Compare the recovered files to the original files on the Amanda client.

6. If you find any problems, check the debug log files in /tmp/amanda directory on the Amanda Mac OS X client.

Compatibility with Amanda server

The Amanda Enterprise 3.0 Mac OS X client is compatible with Amanda servers running Amanda Enterprise Edition 3.0.

Upgrading from Amanda Mac OS X clients (compiled on your own)

Successfully upgrading from a self-compiled version of the Amanda client to Amanda Enterprise Edition 3.0 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.0 Mac OS X client.