Zmanda Client for Mac OS X Manual

Version as of 21:15, 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

  1. Download and install the package dependencies available from the Zmanda Network download page when you select Mac OS X as the client platform.
  2. Download the Amanda Enterprise Edition Mac OS X client package and Amanda pre-requisites package from the Zmanda network downloads page.
  3. You will need about 80 MB disk space for Amanda and pre-requistes package.
  4. The Amanda pre-requisites package contains all open source packages that are required for Amanda. Install the pre-requisites package (Double-click on the package) and then install Amanda Enterprise client.
  5. It is good idea to have installer logs window open during installation (Click Mac Command key + L together). You will see the window as shown below.  Use drop down box (Click Mac Command Key + 3 together) to see error logs.  You can save logs in case of installation error.

Amanda-MacOSX-Client-InstallerLogs.png

  1. Amanda Enterprise client includes a README file that provides information about client configuration (creation of amandabackup user, firewall changes and other customizations)  as shown below.

Amanda-MacOSX-Client-InstallREADME.png

 

Post-installation checklist

  • Perform operations that are specified here.
  • 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

If you are restoring to Mac OS X client which has Amanda Enterprise client installed, Use Zmanda Management Console Restore pages. Provide the Mac OS X machine where backups are being restored to in the Destination Host field in Restore Where page. Do not provide Destination User Name.

If you are restoring to a machine that does not Amanda client installed, ssh will be used for restoration.  An administrative user on Mac OS X is required for this method and must be provided in Destination User Name field in Restore Where page.  The following screen shows how to create "zmanda-admin" Administrative user on Mac OS X. Rest of the restore process is similar.

Step 1: Administrative user creation on MacOS 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.x

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.