Unitrends protects most Linux distributions, including CentOS, Debian, Fedora, Red Hat, SUSE, and Ubuntu. Before adding a Linux asset to the Unitrends appliance, you must install an agent.
Once the agent is installed, you can update to a newer agent version using these same installation procedures. It is not necessary to remove the old agent. If an agent is already installed, you have the option to save any custom agent settings during installation.
Use the procedures in this section to install or update the Linux agent:
Unitrends provides several Linux agent installers. Unitrends recommends using the RPM-based or dpkg-based installers when possible, so that needed dependencies are automatically installed with the agent. If these installers are not supported for your Linux distribution, use the GZEXE installers. With the GZEXE installers, you might need to install dependencies before installing the agent.
See the table Linux distributions and agent installers to determine which installer to use for your Linux asset. You can download the agent installers from the Latest Agent Releases page on the Unitrends website. You might not see an agent for the particular Linux distribution that you are using, but if it is a supported distribution listed in the Unitrends Compatibility and Interoperability Matrix, the standard Linux agent will work with your machine. For Oracle Linux assets, use the CentOS or Red Hat agent.
Linux distributions |
Agent installers |
|||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
RPM-based installers. Automatically installs dependencies. |
|||||||||
|
GZEXE installers |
|||||||||
|
dpkg-based installers. Automatically installs dependencies. |
When using GZEXE installers, you might need to install additional libraries. If this is the case, the installer stops the installation and lists the required dependencies. The dependencies it lists are the resources needed and not the name of the package you must install. The table below identifies the packages containing the commonly needed dependencies.
The following dependencies are required to protect Red Hat Linux environments. These dependencies replace XINETD, which was a dependency for earlier versions.
Operating System |
Dependencies |
||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Red Hat 5 i386 |
Packages are located on the installation media. |
||||||||||||||||||
Red Hat 5 x86_64 |
Packages are located on the installation media. |
||||||||||||||||||
Red Hat 6 i386 |
Packages are located on the installation media. |
||||||||||||||||||
Red Hat 6 x86_64 |
The following packages might need to be updated to match the version of a new dependency.
Packages are located on the installation media. |
Samba is only used to protect Oracle with application backups. The Samba packages listed below only need to be installed if you wish to protect Oracle data.
For assistance with these packages, you can download the Oracle Dependency plug-in from the Latest Agent Releases page on the Unitrends website. You must install the Linux agent before you can install this plug-in. Depending on your Linux distribution, use the Oracle Dependency for CentOS or Red Hat.
The table below provides details about the Samba packages needed for Oracle protection.
Dependency |
Package name |
||||||
---|---|---|---|---|---|---|---|
mount.cifs |
|
Installation procedures for the Linux agent vary by Linux distribution. See the following topics for instructions:
This section explains how to install the agent using GZEXE installers, which are available for all supported Linux distributions. If the agent requires dependencies, the installer stops the installation and lists the required dependencies.
1 | Save the appropriate agent installer on the Linux machine that you want to add to the Unitrends appliance. You can download the installer from the Latest Agent Releases page on the Unitrends website. |
2 | Open a terminal, and log in as root user. |
3 | Change directories to the location where you have saved the agent installer, and run the command ls -l to view the installer file and determine whether you have execute permission. If necessary, add execute permission using the command: |
# chmod +x <file_name>
4 | Perform one of the following depending on whether you are using a 32-bit or 64-bit installer: |
• | For a 32-bit installer, run the command: |
# ./lnx32_cnt
• | For a 64-bit installer, run the command: |
# ./lnx64_cnt
5 | If necessary, install any required dependencies. The installer notifies you of any dependencies the agent needs. The dependencies listed are the resources needed and not the name of the package that you must install. For more about locating and installing dependencies, see About Linux agent dependencies. |
Run the appropriate command from step 4 after installing the dependencies.
6 | (Optional) To protect Oracle databases, install the Oracle Dependency from the Latest Agent Releases page. |
7 | Enter the hostname for the backup appliance that will protect the asset. |
8 | If you are using a firewall, configure it to allow the Unitrends appliance to communicate with the Linux machine. For details, see Configuring a Linux firewall to communicate with the Unitrends appliance. Add the Linux asset to your Unitrends backup appliance to begin protecting it. For instructions, see To add an asset. |
For CentOS, Oracle Linux, and Red Hat assets, you can use RPM-based installers that often automatically install the necessary dependencies if connected to a remote repository.
1 | Save the appropriate agent installer on the Linux machine that you want to add to the Unitrends appliance. You can download the installer from the Latest Agent Releases page on the Unitrends website. |
Note: For Oracle Linux assets, download the CentOS or Red Hat agent installer.
2 | Open a terminal, and log in as root user. |
3 | Change directories to the location where you have saved the agent installer. |
4 | Perform one of the following depending on whether you are using a 32-bit or 64-bit installer: |
• | For a 32-bit asset, run the command: |
# yum localinstall --nogpgcheck unitrends-linux-agent-<release>.<build_date>.i386.rpm
• | For a 64-bit asset, run the command: |
# yum localinstall --nogpgcheck unitrends-linux-agent-<release>.<build_date>.x86_64.rpm
5 | Install any required dependencies. The installer notifies you of any dependencies the agent needs. The dependencies listed are the resources needed and not the name of the package that you must install. For more about locating and installing dependencies, see About Linux agent dependencies. |
6 | (Optional) To protect Oracle databases, install the Oracle Dependency from the Latest Agent Releases page. |
7 | If you are using a firewall, configure it to allow the Unitrends appliance to communicate with the Linux machine. For details, see Configuring a Linux firewall to communicate with the Unitrends appliance. |
8 | Add the Linux asset to your Unitrends backup appliance to begin protecting it. For instructions, see To add an asset. |
For Ubuntu assetts, you can use dpkg-based installers that often automatically install all necessary dependencies if connected to a remote repository. You can choose to install the agent using core utilities or the GDebi tool. If you install using core utilities, you must run two commands if the necessary dependencies have not been installed on your Ubuntu machine. If you use the GDebi tool, one command installs the agent and all necessary dependencies.
For instructions, see the following topics:
For Ubuntu assets, you can use dpkg-based installers that install all necessary dependencies.
Note: This procedure might require you to run two commands. The first command installs the agent if the necessary dependencies are already installed on the asset. If the agent requires dependencies, the second command in this procedure installs them and then installs the agent. If you have installed the GDebi tool on the asset, you can use it to install the agent using only one command. For details, see To install the Linux agent on Ubuntu using GDebi.
1 | Save the appropriate agent installer on the Linux machine that you want to add to the Unitrends appliance. You can download the installer from the Latest Agent Releases page on the Unitrends website. |
2 | Open a terminal and change directories to the location where you saved the agent installer. |
3 | Perform one of the following: |
• | For the 32-bit installer, run the command: |
# sudo dpkg -i unitrends-linux-agent-<release>-<build_date>.i386.deb
• | For the 64-bit installer, run the command: |
# sudo dpkg -i unitrends-linux-agent-<release>-<build_date>.amd64.deb
4 | If the installer stopped because the agent requires dependencies, run the following command to install them: |
# sudo apt-get install -f
5 | If you are using a firewall, configure it to allow the Unitrends appliance to communicate with the Linux machine. For details, see Configuring a Linux firewall to communicate with the Unitrends appliance. |
6 | Add the Linux asset to your Unitrends backup appliance to begin protecting it. For instructions, see To add an asset. |
To install the agent with this procedure, you must have installed the GDebi package on your Ubuntu assets. Installation of the agent using GDebi requires only one command. To install the agent using core utilities, see To install the Linux agent on Ubuntu using core utilities.
1 | Save the appropriate agent installer on the Linux machine that you want to add to the Unitrends appliance. You can download the installer from the Latest Agent Releases page on the Unitrends website. |
2 | Open a terminal and change directories to the location where you saved the agent installer. |
3 | Perform one of the following depending on whether you are using a 32-bit or 64-bit installer: |
• | To install the 32-bit agent, run the following command: |
# sudo gdebi unitrends-linux-agent-<release>-<build_date>.i386.deb
• | To install the 64-bit agent, run the following command: |
# sudo gdebi unitrends-linux-agent-<release>-<build_date>.amd64.deb
4 | If you are using a firewall, configure it to allow the Unitrends appliance to communicate with the Linux machine. For details, see Configuring a Linux firewall to communicate with the Unitrends appliance. |
5 | Add the Linux asset to your Unitrends backup appliance to begin protecting it. For instructions, see To add an asset. |
If you are protecting a Linux machine with a firewall, you must configure the firewall to allow communication with the Unitrends appliance before you can add the Linux machine as an asset.
To configure the Linux firewall
1 | Modify the Linux machine’s firewall settings to allow ports 1743 and 1745. |
2 | Open a terminal or text editor with root access and log in as user root. |
3 | Run the following command: |
# /usr/bp/bin/bputil -p “Configuration Options” data 1745 /usr/bp/bpinit/master.ini