This is an archive version of the document. To get the most up-to-date information, see the current version.

Installing Veeam Agent for Linux

Installing Veeam Agent for Linux NOTE

To make UEFI systems with Secure Boot work with the pre-built veeamsnap kernel module, Veeam Agent requires the Veeam public key enrolled to the MOK list. The key is available in the veeamsnap-ueficert-5.0.2.4567-1.noarch package residing on the Veeam software repository. Veeam Agent requests the key enrollment during the package installation. After that, you must reboot computer to enroll the key into the UEFI database.

After the package installation, you can check that the key enrollment is planned for the next reboot with the following command: mokutil -N. If the command output shows that the key enrollment is not planned, you can do the following:

  1. Request the enrollment of the public key manually with the following command: mokutil --import veeamsnap-ueficert.crt.
  2. Reboot the Veeam Agent computer to enroll the key into the UEFI database.
  3. Check that the key is successfully enrolled with the following command: mokutil -l.

To install Veeam Agent for Linux:

  1. Download the Veeam software repository installation package (veeam-release) from the this Veeam webpage, and save the downloaded package on the computer where you plan to install the product.

 

Installing Veeam Agent for Linux TIP

If the computer where you want to install Veeam Agent for Linux is not connected to the internet, you can download and install Veeam Agent for Linux packages manually. To learn more, see Installing Veeam Agent for Linux in Offline Mode.

  1. Navigate to the directory where you have saved the veeam-release package and install the package with the following commands:

For CentOS / RHEL / Oracle Linux / Fedora

rpm -ivh ./veeam-release* && yum check-update

For openSUSE / SLES

zypper in ./veeam-release* && zypper refresh

For Debian / Ubuntu

dpkg -i ./veeam-release* && apt-get update

  1. Install Veeam Agent for Linux packages from the Veeam software repository. To install Veeam Agent for Linux, you can use a package manager of your choice that works with software packages in your Linux distribution. For example, use the following commands:

For Fedora

yum install veeam

For CentOS / RHEL

yum install kmod-veeamsnap veeam

With this command, the non-DKMS version of the veeamsnap kernel module will be installed from the pre-built kmod-veeamsnap binary package.

Installing Veeam Agent for Linux NOTE

Alternatively, if the dkms package is already installed in the OS, you can install Veeam Agent with the following command:

yum install veeam

With this command, the veeamsnap kernel module will be installed from the source RPM package using dkms.

For Oracle Linux

yum install veeamsnap
yum install veeam

For openSUSE Tumbleweed

zypper in veeam

For openSUSE Leap 15.3

zypper in veeamsnap-kmp-default
zypper in veeam

For SLES with Default kernel

zypper in veeamsnap-kmp-default
zypper in veeam

For SLES with Trace kernel

zypper in veeamsnap-kmp-trace
zypper in veeam

For SLES with Xen kernel

zypper in veeamsnap-kmp-xen
zypper in veeam

For SLES with PAE kernel

zypper in veeamsnap-kmp-pae
zypper in veeam

For SLES with Preempt kernel

zypper in veeamsnap-kmp-preempt
zypper in veeam

For Debian / Ubuntu

apt-get install veeam

 

 

Managing Package Dependencies

The following dependency packages may require special handling in case you see installation errors:

For SLES, the dkms package is not available in the Packman repository. You must use the package intended for openSUSE. To learn more, see this Veeam KB article.

  • Extended kernels, such as kernel-pae, kernel-uek and other, require appropriate kernel-devel packages to be installed, for example, kernel-pae-devel, kernel-uek-devel, and so on.

Version of the kernel-devel package must match your current kernel version. To check your current kernel version, run the uname -r command.

The kernel-devel package may also require special handling for its own dependencies. For example, the libdtrace-ctf package that is a dependency for the kernel-uek-devel package. To learn more, see this Veeam KB article.

[For RHEL and derivatives] If the yum package manager installs packages that do not match your current kernel version, you should either update your system or fetch older versions of the required packages from the CentOS Vault repository.

Installing dkms in openSUSE

In openSUSE systems, while installing the dkms package, you may see an error similar to the following:

Problem: nothing provides kernel-devel needed by dkms-2.2.0.3-14.1.noarch
Solution 1: do not install dkms-2.2.0.3-14.1.noarch
Solution 2: break dkms-2.2.0.3-14.1.noarch by ignoring some of its dependencies

To install the dkms package, do the following:

  1. Make sure that you have an appropriate kernel-devel package installed and its version matches your kernel version. For example:

root@localhost:~> rpm -qa | grep kernel-default
kernel-default-devel-3.0.101-91.1
kernel-default-3.0.101-91.1

  1. Install the dkms package ignoring dependencies:

zypper -n install --force dkms

  1. Make sure that you have allowed unsupported modules. To learn more, see this SUSE webpage.