Zmanda Client for Linux Manual

Table of contents
No headers

Version as of 15:31, 19 May 2024

to this version.

Return to Version archive.

View current version

 

Amanda Enterprise Edition Linux Client is a certified Amanda network backup software, tested and supported by Zmanda. This document has been prepared in conjunction with the Amanda Enterprise Edition Linux client 4.0 release.  

Amanda Enterprise Edition Linux client packages are available for the following distributions from theZmanda network 

  •  Red Hat Enterprise  
  • CentOS  
  • Fedora  
  • Oracle Enterprise Linux  
  • Debian  
  •  Ubuntu  
  • SLES  
  • Open Suse  

Please seesupported platform matrix for exact versions of above distributions that are supported by 4.0 release.  

This document confers about the Amanda Enterprise Edition Linux client installation, configuration and verification procedures.  

Installation  

Amanda Enterprise Edition Linux client packages are available from theZmanda networkdownload page.  

There are two packages - Amanda Enterprise Backup Client package and Amanda Enterprise Extensions Client package. Both packages are necessary.  

Pre-installation checklist  

  • Following packages should be installed on the client 

  

-GNU tar (version 1.15.1 or greater, except Red Hat/CentOS/Oracle Enterprise Linux), which supports version 1.14 or greater)  

-xinetd  

-ssh server  

-perl (version 5.8.0 or greater) - required only on the client  

-Schily tar (star 1.5a74 or greater) if extended attributes for file systems are being backed up. For selective restoration of files, star 1.5a85 or greater is required.  

  • Libraries (32bit libraries for 32bit Amanda client packages and 64bit libraries for 64bit packages) that are required are:  

-libcurl3  

-readline  

-glib2  

-termcap  

These packages are installed by default on most Linux distributions. If you need to add them, you can useyum,apt-get, oryast. 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 the new package and to keep the SLES distribution updated (which is recommended).  

 

Client installation 

 

  • Amanda client installation must be performed as super user (in other words, the root user).  
  • Download the Amanda Enterprise Edition 4.0 Linux client package from theZmanda networkdownload page.

There are two packages -amanda-enterprise-backup-clientandamanda-enterprise-extensions-client. Both packages are required.  

  • Install the packages (amanda-enterprise-backup-client followed by amanda-enterprise-extensions-client)  

  

o    Userpmordpkgcommand if you are installing client binaries for Ubuntu1204, Ubuntu1210, Ubuntu1304, Ubuntu1404, Ubuntu1604, CentOS5, CentOS6, Fedora20, Fedora21, Debian6, Debian7, SUSELinux11, SUSELinux12, Solaris10, Solaris11  

rpm -ivh <package name>  

--or--  

dpkg -i <package name>  

  

o   Useyumorapt-getcommand if you are installing client binaries for CentOS7, CentOS8, Fedora28, Fedora29, Fedora30, Fedora31, Ubuntu1604, Ubuntu1804, Ubuntu1810, Ubuntu1904, Debian 8.11, Debian9.9, Debian10.0  

yum install –y ./<package name>  

--or--  

apt-get install –y ./<package name>  

  • 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.errfile.  
  • During the install, theamandabackupuser is created, if it does not exist. Please assign a password for theamandabackupuser.  

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.logand errors (if any) in/var/log/amanda/install.err
Make sure there are no errors in the log files. 
 

  • Performthe post installation steps common to all Amanda clients. These steps are required for backup and recovery operations.  

Adding Client File Systems in ZMC  

You can add the Linux file systems/folders using Zmanda Management Console. Use the Sourcespage in the Zmanda management console, to add folders from the Linux client (SelectFile systemsfrom the menu). You will need to specify theClient Name,Host Nameand theDirectoryto back up.  

Amanda does not cross file system boundaries and thus each file system/partition should be entered as its own entry (separate DLEobject).  

 

You can exclude files, specify data deduplication, encryption and compression to be used for the directory. Special files such as device files, named pipes, sockets, etc. can cause errors from the native backup and restore tools and they should be excluded from the backup.  

Linux file systems can be backed up using different Amanda methods (Amanda Backup Client Application). The default method is usinggtar(GNUtar). Another method that is available is Schily tar (star).  

Schily tarallows the backup of extended POSIXattributes (such as SE Linux MAC labels). This application can be selected by checkingExtended AttributesunderAmanda Backup Client Application.In order to select this application requiresstarcommand to be installed on the Amanda client.  

You can specify different estimate algorithms and number of client backups that can happen in parallel (Client Max Backups). You can specify if you want only full or incremental or skip the backups of a Linux directory usingStrategyfield.  

 

Restoring Linux files  

Linux file systems can be restored using Zmanda Management Console Restorepages or usingamrecovercommand.  

The restoration process begins at ZMC Restore What page. You can select theBackup Dateentering the value or you can click the date stamp from ZMC Report Summarypage.  

  

You can select the backup image'sHost NameandDirectoryto be restored. If the Amanda indexes are available on the server, ZMCcan provide the possible values (click theEditbutton). You can performRestore All files from the image.  

Next step is specifying the conflict resolution policies and selecting where to restore to -Restore Whatpage.  

  

  

The possible Conflict Resolution Settings as shown above. If theDestination Directoryis empty, you select  Overwrite Existing files/directoriesas conflict resolution. You should specify theDestination Host Name,where backups will be restored to theDestination Directory. TheDestination Directory must be writable byamandabackupuser and must have sufficient space to hold the whole backup image.   

If theDestination Hostis not running Amanda client,sshwill be used for restoration. The ssh user and password will be required. TheDestination User Nameis used as thesshuser.  

After verifying the entered information, use the navigation to go to ZMCRestore Nowpage.  

  

  

Start the Restore process by clickingRestorebutton. The restore process will involve transferring the data to theDestination Hostand extracting the specific files.