Deployment Procedure for Linux Computers
Before You Begin
Hotfixes released by Veeam for Veeam Agent for Linux can contain updated packages for all or selected components of the Veeam Agent architecture:
- If the hotfix affects all Veeam Agent for Linux packages, follow the general procedure of deploying a hotfix for Veeam Agent for Linux. The general procedure instructions are further illustrated with Example 1.
- If the hotfix contains only an updated kernel module package, editing of the Veeam Agent for Linux package index file (Step 3 of the general procedure) is not required. The simplified procedure of hotfix deployment is illustrated in Example 2.
General Procedure for Deploying Hotfix on Linux Computers
To deploy a hotfix on Linux computers included in a protection group, perform the following steps:
- Obtain the hotfix from Veeam Customer Support. To do this, open a support case.
- Save Veeam Agent for Linux packages and their manifest files to the following folder on the Veeam backup server:
For 32-bit RHEL / Oracle Linux
C:\ProgramData\Veeam\Agents\val\x86\rpm |
For 64-bit CentOS / RHEL / Oracle Linux / Fedora / openSUSE / SLES
C:\ProgramData\Veeam\Agents\val\x64\rpm |
For Debian / Ubuntu
C:\ProgramData\Veeam\Agents\val\x64\deb |
- Replace the names of the Veeam Agent for Linux packages in the index file:
- Open the ValPackageIndex.xml file that is located in the following folder on the Veeam backup server:
C:\ProgramData\Veeam\Agents\val |
- In the ValPackageIndex.xml file, locate packages that you want to update. Replace their names with names of Veeam Agent for Linux packages you saved in Step 2. After that, save changes and close the index file. For more information on deploying a hotfix for Veeam Agent for Linux version 6.0, see Example 1.
- Rescan the protection group:
- Open the Inventory view.
- In the inventory pane, expand the Physical Infrastructure node.
- In the inventory pane, select the necessary protection group and click Rescan on the ribbon or right-click the protection group and select Rescan.
During the rescan, Veeam Backup & Replication will use updated packages specified in the index file to install Veeam Agent for Linux version with the hotfix on protected computers.
Example 1: Deploying a Hotfix for Veeam Agent for Linux Using General Procedure
In this example, Veeam issued a hotfix for Veeam Agent for Linux 6.0 for 64-bit RHEL 9 and you want to deploy it on your Veeam Agent computers.
The hotfix consists of the following Veeam Agent packages:
- blksnap-6.0.3.1228-1.noarch.rpm
- blksnap-6.0.3.1228-1.noarch.rpm.manifest.xml
- veeam-6.0.3.1228-1.el9.x86_64.rpm
- veeam-6.0.3.1228-1.el9.x86_64.rpm.manifest.xml
- kmod-blksnap-6.0.3.1228-1.el9.x86_64.rpm
- kmod-blksnap-6.0.3.1228-1.el9.x86_64.rpm.manifest.xml
To deploy the hotfix, you need to do the following:
- Obtain all updated Veeam Agent for Linux packages from Veeam Customer Support. To do this, open a support case.
- Save the packages and their manifest files to the following folder on the Veeam backup server:
C:\ProgramData\Veeam\Agents\val\x64\rpm |
You do not need to delete obsolete Veeam Agent for Linux packages you want to update.
- Edit the index file located in the following folder on the Veeam backup server:
C:\ProgramData\Veeam\Agents\val |
- Open the ValPackageIndex.xml file.
- Locate the packages that you want to update and replace their version and names with version and names of the packages you saved in step 2.
Usually, the packages that are available as a hotfix have a build version that is different from the obsolete packages. In this scenario, obsolete packages have the 6.0.3.1221 build version and the updated packages have the 6.0.3.1228 build version.
In the example below, replaced package version and names are highlighted in green:
... <Distribution id="RHEL" displayName="Red Hat"> ... <!-- EL9 --> <Version majorVersions="9"> <Packages version="6.0.3.1228" arch="x64"> <driver_noarch value="blksnap-6.0.3.1228-1.noarch.rpm"/> <driver_uefi_cert value="veeamsnap-ueficert-6.0.3.1221-1.noarch.rpm"/> <driver_bin value="kmod-blksnap-6.0.3.1228-1.el9.x86_64.rpm"/> <veeam value="veeam-6.0.3.1228-1.el9.x86_64.rpm"/> </Packages> </Version> </Distribution> .... |
- Save changes and close the index file.
- Rescan the protection group.
Example 2: Deploying a Hotfix for Veeam Agent for Linux Using Simplified Procedure
In this example, Veeam issued a hotfix for Veeam Agent for Linux 6.1 for 64-bit RHEL 9 and you want to deploy it on your Veeam Agent computers.
The hotfix consists of the following Veeam Agent packages:
- kmod-blksnap-patch-6.1.0.1498-1.el9.x86_64.rpm
- kmod-blksnap-patch-6.1.0.1498-1.el9.x86_64.rpm.manifest.xml
To deploy the hotfix, you need to do the following:
- Obtain all updated Veeam Agent for Linux packages from Veeam Customer Support. To do this, open a support case.
- Save the package and its manifest file to the following folder on the Veeam backup server:
C:\ProgramData\Veeam\Agents\val\x64\rpm |
- Rescan the protection group.