Updating Veeam Backup Agents in Offline Mode

In this article

    If none of the computers that host Veeam backup agents has connection to the Internet, or you do not want to fetch the Veeam backup agent setup file from the Veeam Installation Server, you can perform offline update. In this update scenario, the Veeam backup agent setup file is placed to a folder on a computer that hosts the master agent, or to a network share. During update, the master agent uploads this setup file to client computers, and initiates the software update.

    The update procedure depends on the method that you used to install Veeam backup agents:

    Before You Begin

    Before you start the update procedure, make sure that:

    • Client computers on which you plan to update Veeam backup agents are powered on.
    • [For Microsoft Windows computers] Client computers are configured to allow upload of a Veeam backup agent setup file: the File and Printer Sharing (SMB-In) firewall rule must allow inbound traffic.
    • [For Linux and macOS computers] You have the root account or any user account with super user privileges on all client computers.

    Required Privileges

    To perform this task, a user must have one of the following roles assigned: Portal Administrator, Site Administrator, Portal Operator.

    Updating Veeam Backup Agents Installed with Discovery Rules

    To update Veeam backup agents installed with a discovery rule:

    1. Download a new version of the Veeam backup agent setup file.
    2. Place the Veeam backup agent setup file to a folder on a computer that hosts the master agent, or to a network share.

    The master agent must have access to this folder. Make sure that the account under which the master agent service runs has Read/Write permissions on the folder.

    1. Log on to a computer that hosts the master agent and specify the path to the Veeam backup agent setup file:
    1. Open the Registry Editor.
    2. In the Registry Editor, navigate to the HKEY_LOCAL_MACHINE\SOFTWARE\Veeam\VAC\Agent path.
    3. Create a new registry key value with the following settings:

    Specify Path to Setup File

    1. Open the Services console, and restart Veeam Management Agent Service.

    Restart Master Agent Service

    1. Log in to Veeam Service Provider Console.

    For details, see Accessing Veeam Service Provider Console.

    1. In the menu on the left, click Discovery.
    2. Open the Backup Agents tab.
    3. Select one or more Veeam backup agents in the list.
    4. At the top of the list, click Backup Agent and choose Update.

    After you initiate the update procedure, the value in the Backup Agent Version column will change to Updating. You can click the Updating link to track the progress of the update procedure.

    1. Check the value in the Backup Agent Version column.

    After the update procedure completes, the value in this column will be set to Up-to-date.

    In some cases, after update you might need to perform additional operations. For example, if the setup detects a pending computer reboot, the Backup Agent Version column will display a warning notifying that reboot is required. To complete the update procedure, you can initiate computer reboot in Veeam Service Provider Console. For details, see Rebooting Remote Computers.

    Updating Veeam Backup Agents Installed with 3rd Party Tools or Manually

    To update Veeam backup agents installed using 3rd party automation tools (like GPO) or manually, you will require to include in the update scope a computer that runs a master agent. The role of a master agent is normally assigned to a computer in a company location whose management agent was the first one to register in Veeam Service Provider Console. To learn how to check what computer runs a master agent, see Checking Management Agent Role.

    To update Veeam backup agents installed using 3rd party automation tools (like GPO) or manually:

    1. Download a new version of the Veeam backup agent setup file.
    2. Place the Veeam backup agent setup file to a folder on a computer that hosts the master agent, or to a network share.

    The master agent must have access to this folder. Make sure that the account under which the master agent service runs has at least Read/Write permissions on the folder.

    1. Log on to a computer that hosts the master agent and specify the path to the Veeam backup agent setup file:
    1. Open the Registry Editor.
    1. In the Registry Editor, navigate to the HKEY_LOCAL_MACHINE\SOFTWARE\Veeam\VAC\Agent path.
    1. Create a new registry key value with the following settings:
    • Type: String value
    • Value name: VawLink
    • Value data: path to the Veeam backup agent setup file

    Specify Path to Setup File

    1. Open the Services console, and restart Veeam Management Agent Service.

    Restart Master Agent Service

    1. In the master agent settings, specify credentials of an account that will be used to upload the setup file to client computers.
    1. Log on to a computer that hosts the master agent.
    2. In the icon tray, right-click the master agent icon and choose Agent Settings.
    3. In the Veeam Management Agent Settings window, click the Remote computer discovery user account link.
    4. In the Discovery Account window, select the Specify local administrator credentials for the remote computers check box.
    5. In the Username and Password fields, specify credentials of an account that will be used to upload the Veeam backup agent setup file to client computers.

    The account must have local Administrator permissions on all computers in the update scope — that is, computers that run Veeam backup agents that must be updated.

    1. Click OK.
    2. In the Veeam Management Agent Settings window, click Close.

    Specify Administrator Credentials

    1. Log in to Veeam Service Provider Console.

    For details, see Accessing Veeam Service Provider Console.

    1. In the menu on the left, click Discovery.
    2. Open the Backup Agents tab.
    3. Select one or more Veeam backup agents in the list.
    4. At the top of the list, click Backup Agent and choose Update.

    After you initiate the update procedure, the value in the Backup Agent Version column will change to Updating. You can click the Updating link to track the progress of the update procedure.

    1. Check the value in the Backup Agent Version column.

    After the update procedure completes, the value in this column will be set to Up-to-date.

    In some cases, after update you might need to perform additional operations. For example, if the setup detects a pending computer reboot, the Backup Agent Version column will display a warning notifying that reboot is required. To complete the update procedure, you can initiate computer reboot in Veeam Service Provider Console. For details, see Rebooting Remote Computers.

    Updating Veeam Agent for Linux and Veeam Agent for Mac

    To update Veeam backup agents installed on computers running Linux or macOS operating systems:

    1. Download a new version of the Veeam backup agent setup file.
    2. [For Veeam Agent for Linux] Obtain the ValPackageIndex.xml file from the C:\Program Files\Veeam\Availability Console\ApplicationServer\LinuxPackages\ValPackages folder on a machine where Veeam Service Provider Console Server component runs.
    3. Place the Veeam backup agent setup file and the ValPackageIndex.xml file (for Veeam Agent for Linux) to a folder on a computer that hosts the master agent.

    The master agent must have access to this folder. Make sure that the account under which the master agent service runs has Read/Write permissions on the folder.

    The default folder for upgrade files is /var/lib/veeamma/upgrade.

    1. Run the following command:

    veeamconsoleconfig --update_backup <...>

    where:

    <...> — path to a folder where you have saved the setup file and the ValPackageIndex.xml file.

    or, if you have saved the setup file and the ValPackageIndex.xml file to the /var/lib/veeamma/upgrade folder:

    veeamconsoleconfig --update_backup

    Wait for the agent to update.

    1. Log in to Veeam Service Provider Console.

    For details, see Accessing Veeam Service Provider Console.

    1. In the menu on the left, click Discovery.
    2. Open the Backup Agents tab.
    3. Select the necessary Veeam backup agent in the list.
    4. Check the value in the Backup Agent Version column.

    After the update procedure completes, the value in this column will be set to Up-to-date.

    In some cases, after update you might need to perform additional operations. For example, if the setup detects a pending computer reboot, the Backup Agent Version column will display a warning notifying that reboot is required. To complete the update procedure, you can initiate computer reboot in Veeam Service Provider Console. For details, see Rebooting Remote Computers.