You are here: Linux Protection > Installing the Linux agent

Installing the Linux agent

Installation procedures for the Linux agent vary depending upon the Linux distribution. You can perform the installations using core utilities, and for Ubuntu clients, you can use also the GDebi tool for a simpler installation procedure. For details about different agent versions, see Linux agent versions.

See the following topics for instructions on installing the Linux agent:

ClosedTo install the Linux agent

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.

For CentOS, Oracle Linux, and Red Hat clients, it is recommended that you use RPM-based installers. For instructions, see To install the Linux agent for CentOS, Oracle Linux, and Red Hat clients. For Ubuntu clients, it is recommended that you use dpkg-based installers. For instructions, see Installing the Linux agent for Ubuntu clients.

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 Unitrends Downloads page (https://support.unitrends.com/go/downloads).
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

Skip to step 6 if the installation begins without prompting you to install dependencies. Proceed to step 5 if the installer prompts you to install dependencies.

5 Install dependencies if necessary. 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 necessary dependencies.

6 (Optional) If you wish to protect Oracle databases, install a Samba client. Otherwise, a Samba client is not a dependency. You can download the necessary packages from the Unitrends Downloads page (https://support.unitrends.com/go/downloads). For more information, see Needed dependencies for Oracle.
7 Enter the hostname for the backup system that will protect the client.
8 If you are using a firewall, you must configure the firewall to allow the Unitrends backup system to communicate with the Linux machine before registering it to the system. For details, see Configuring a Linux firewall to allow communication with the Unitrends backup system.
9 Register the client to your Unitrends backup system to begin protecting it. For instructions, see Working with Linux clients.
ClosedTo install the Linux agent for CentOS, Oracle Linux, and Red Hat clients

For CentOS, Oracle Linux, and Red Hat clients, 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 Unitrends Downloads page (https://support.unitrends.com/go/downloads).

Note:  For Oracle Linux clients, 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 client, run the command:

yum localinstall --nogpgcheck unitrends-linux-agent-<release>.<build_date>.i386.rpm

• For a 64-bit client, run the command:

yum localinstall --nogpgcheck unitrends-linux-agent-<release>.<build_date>.x86_64.rpm

5 Install the dependencies if necessary. See About Linux agent dependencies.
6 (Optional) If you wish to protect Oracle databases, install a Samba client. Otherwise, a Samba client is not a dependency. You can download the necessary packages from the Unitrends Downloads page (https://support.unitrends.com/go/downloads). For more information, see Needed dependencies for Oracle.
7 If you are using a firewall, you must configure the firewall to allow the Unitrends backup system to communicate with the Linux machine before registering it to the system. For details, see Configuring a Linux firewall to allow communication with the Unitrends backup system.
8 Register your machine to the backup system to begin protecting it. For instructions, see Working with Linux clients.
ClosedInstalling the Linux agent for Ubuntu clients

For Ubuntu clients, 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:

ClosedTo install the Linux agent for Ubuntu clients using core utilities

For Ubuntu clients, 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 client. 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 client, you can use it to install the agent using only one command. For details, see To install the Linux agent for Ubuntu clients 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 Unitrends Downloads page (https://support.unitrends.com/go/downloads).
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:
• 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 Skip to step 5 if the agent installed successfully. If the installer stopped because the agent requires dependencies, run the following command to install all the necessary dependencies:

sudo apt-get install -f

5 If you are using a firewall, you must configure the firewall to allow the Unitrends backup system to communicate with the Linux machine before registering it to the system. For details, see Configuring a Linux firewall to allow communication with the Unitrends backup system.
6 Register your machine to the backup system to begin protecting it. For instructions, see Working with Linux clients.
ClosedTo install the Linux agent for Ubuntu clients using GDebi

To install the agent with this procedure, you must have installed the GDebi package on your Ubuntu clients. Installation of the agent using GDebi requires only one command. To install the agent using core utilities, see To install the Linux agent for Ubuntu clients 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 Unitrends Downloads page (https://support.unitrends.com/go/downloads).
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, you must configure the firewall to allow the Unitrends backup system to communicate with the Linux machine before registering it to the system. For details, see Configuring a Linux firewall to allow communication with the Unitrends backup system.
5 Register your machine to the backup system to begin protecting it. For instructions, see Working with Linux clients.