Version
Search
⌃K
Links

Linux Binary Installation

We recommend this installation option for advanced Linux users. It is intended for Linux-heavy centers, black sites, & air-gapped networks. The extensive CLI commands give you flexibility.
If you already have one backup server and Zmanda Management Console configured and are wanting to build another backup server for clustering purposes, you may skip the installation steps pertaining to the ZMC and only need to download and install the binaries for the Zmanda Backup Server.

Installation Steps

Step 1: Preparing the Linux system for Zmanda Installation

1.1 Update target Linux system by running one of the following commands, based on the Linux distribution.
For RPM-based systems, use dnf or yum:
sudo dnf update -y
For Debian-based systems.
sudo apt-get update -y
1.2.1 Install the dependencies required by Zmanda by running one of the two commands shown below, based on the Linux distribution (yum for RPM and apt-get for Debian)
For RPM-based systems, use dnf or yum:
sudo dnf install -y wget xinetd vim samba samba-common samba-client mtx lsscsi mt-st bind-utils libnsl
For Debian-based systems:
sudo apt-get install -y wget xinetd vim samba samba-common samba-client mtx lsscsi mt-st bind-utils libnslr
  • wget to aid file download via CDN links
  • xinetd to manage internet-based connectivity
  • samba, samba-common, and samba- client for CIFS backups
  • mt-st, mt, & mtx for tape storage
  • mlocate is a useful tool for finding specific files
  • bind-utils for DNS utilities (might be missing on some distributions)
  • libnsl nsi libary (might be missing on some distributions)
1.2.2 OPTIONALLY Install the dependencies needed to back up VMware Sources by installing the vCLI and VDDK VMware packages. Follow the steps below to get the packages from VMWare.
  1. 1.
    Download and extract vSphere CLI and VDDK packages from the corresponding links: vSphere CLI → https://code.vmware.com/web/tool/6.7/vsphere-cli VDDK → https://developer.vmware.com/web/sdk/7.0/vddk
  2. 2.
    Post extraction, run the install.pl files within each folder. This will install the package onto the server, allowing you to connect Zmanda to the vSphere instance. If the install.py file is missing, please reach out to the VMware support team to get the needed installation script.
  3. 3.
    If you run into issues with your vCLI installation, check the http_proxy and ftp_proxy environment variables to see if they are blank, if Zmanda Server has a direct connection to the internet, or if the proxy IP address is entered correctly for proxy configurations.
1.3 Depending on the Linux distribution, SELinux may come pre-enabled. If your system has SELinux enabled and set to enforcing mode, please change it to Permissive mode.
Check the SELinux mode by running getenforce command.
>getenforce
Enforcing
If the mode is set to Enforcing, execute the following commands to change it to Permissive mode:
sudo setenforce 0
sudo sed -i 's/SELINUX=enforcing/SELINUX=permissive/g' /etc/selinux/config

Step 2: Zmanda Installation:

2.1 Login to Network.Zmanda.com from a browser of your choice and select Download from the left side navigation bar. If you don't already have an account, Register Here.
2.2 Navigate to the Backup Server label in the Enterprise Server section and select your Linux distribution from the dropdown. The corresponding backup server and ZMC binaries will appear to the right of the drop-down once you select a distribution. You need to download both binaries.
Backup server binaries
2.3 A wget of the CDN link can be used to download the Zmanda installation binaries onto your target Linux system. Find the CDN links by clicking on the download icons for both the backup server and ZMC (shown above) and then by navigating to the downloads page in your browser where you can copy the link address and paste it into your SSH terminal. For most browsers, Ctrl-J will take you to the downloads page.
wget <cdn-link for AE backup server>
wget <cdn-link for ZMC>
2.4 Make both files executable by running the following commands.
// offering the installer execute permissions
chmod +x zmanda-backup-server-<version_number>.run
chmod +x zmanda-zmc-<version_number>.run
2.5 Install Zmanda by first executing the backup server binaries, and then by executing the ZMC binaries as shown below. The order is important. Both installations will give you a few simple prompts, so be sure to answer those when they appear. You may run into a few more missing libraries during the installation of these binaries, depending on your Linux system. Please install the necessary libraries and retry the installer.
// running the backup server installation
sudo ./zmanda-backup-server-<version_number>.run
// running the ZMC UI binary
sudo ./zmanda-zmc-<verion_number>.run
2.6 Verify the Zmanda installation
Enter the command setup-aee to verify that all the backup server packages are installed and all the units are running.
Enter the command setup-zmc to verify that all the zmc packages are installed and all the units are running.
NOTE: For both commands, you may see the text install-disabled tools: <list of packages>. The absence of these packages need not halt your installation - they may be installed later and are used for specific use cases. As long as you see that all the packages are installed and units are running, you will be ready to move on to the next step.
setup-aee
//OUTPUT
--------------------- Amanda Enterprise Edition Backup Server
--------------------- AEE API Version: 4.2.flr.issues.y22+0041
4/4 zmanda-backup-server packages are installed
10/10 zmanda-backup-server units are correctly running
install-disabled tools: smbclient dump xfsrestore star xfsdump gnuplot restore lpr bsdtar
setup-zmc
//OUTPUT
--------------------- ZMC Backup Portal
--------------------- ZMC API Version: 4.2.0.14
4/4 zmanda-zmc packages are installed
12/12 zmanda-zmc units are correctly running
2.7 Set the password that you will use to login to the web-based Zmanda Management Console
Enter the following command. Enter admin as the username and enter a secure password.
sudo /opt/zmanda/amanda/bin/reset-admin-password
**2.8 Zmanda requires specific ports to be open (**see below). For more information, and for commands to configure firewall rules, please see this KB Article.
  • 10080:10081
  • 8002
  • 8008
  • 800:840
Run the following command to open these ports. (ufw may not be installed depending on the Linux distribution. If not, see the next steps below)
sudo ufw allow 8008,8002,10080,10081,800:840
If your system does not have ufw installed (i.e. RHEL where adding UFW and EPEL is not an option), follow the instructions below. Execute the first command to see if the firewall is running. If the firewall is not running, you can skip the other two commands.
sudo firewall-cmd --state
sudo firewall-cmd --zone=public --add-port=10080-10081/tcp --permanent
sudo firewall-cmd --zone=public --add-port=800-840/tcp --permanent
sudo firewall-cmd --zone=public --add-port=8008/tcp --permanent
sudo firewall-cmd --zone=public --add-port=8002/tcp --permanent
sudo firewall-cmd --reload
2.9 Regenerate certificates if needed.
2.9.1 Check the validity of Zmanda certificates using the following commands. \
sudo openssl x509 -in /var/lib/amanda/.tlsv3_zmc.crt -text -noout | grep -i validity -A2
sudo openssl x509 -in /var/lib/amanda/.tlsv3_aee.crt -text -noout | grep -i validity -A2
2.9.2 If you observe that the validity of the certificates has expired (as shown in this picture), please regenerate the certificates by following the next steps.
2.9.3 Download this script. Copy the CDN link (similar to how it was done above while downloading the binaries).
2.9.4 Go to server shell. Enter wget <cdn-url copied in previous step>
2.9.5 Make the downloaded file executable by running chmod +x zmanda-cert-gen1.sh
2.9.6 Execute sudo zmanda-cert-gen1.sh

Step 3: Zmanda License Installation and Server Configuration:

3.1 Note the MAC address and ip-address of the server
Execute "ip addr" command from the shell of the Linux server and note down the mac address and IP address. See the picture below. The red box shows where you can find the mac address and the blue box shows where you can find the IP address.
ip addr
3.2 Download the license from Network.Zmanda.com
Login to Network.Zmanda.com and go to the license section. Click the Download button for your license and it will prompt you for the MAC address and a server name.
Enter the MAC address you noted down above and a server name. The server name is not validated and is for your convenience only.
With the license file downloaded, please make sure that the file name is zmanda_license with no other text appended.
3.3 Install license in Zmanda Management Console
From a browser of your choice, enter http://<server-ip-address>:8008. Enter the credentials to log in. The username will be admin, and the password will be the password that you reset during the installation steps above.
Go to Settings -> Licenses and click Upload File. Select the license file and click Upload.
3.4 Configure the backup server in ZMC
Go to Settings -> Cluster page.
Click Add Server and enter the server name, server region, IP address, and port.
Enter a backup server name and region. Again, these are for your reference purposes only.
Enter the IP of the backup server, in this case, it is the IP address of the same system, noted down from ip addr command.
The default port is 8002.
Click save to complete the addition of the backup server.\

Conclusion

Congratulations! By following these steps, you have successfully performed a binary-based installation of Zmanda and logged in for the first time. You will now be able to go through a guided tour of the console and take the next steps to protect your valuable data.