Updating agents

Agents with the following versions can be updated by using the web interface:

  • Agent for Windows, Agent for VMware (Windows), Agent for Hyper-V: version 11.9.191 and later
  • Agent for VMware (Virtual Appliance): version 12.5.23094 and later
  • Agent for Virtuozzo Hybrid Infrastructure (Virtual Appliance): version 12.5.23094 and later
  • Agent for Linux: version 11.9.179 and later
  • Other agents: any version can be updated

To find the agent version, select the machine, and then click Details.

To update from earlier agent versions, download and install the newest agent manually. To find the download links, click All devices > Add.

Prerequisites

On Windows machines, Cyber Protect features require Microsoft Visual C++ 2017 Redistributable. Please ensure that it is already installed on your machine or install it before updating the agent. After the installation, a restart may be required. The Microsoft Visual C++ Redistributable package can be found here https://support.microsoft.com/help/2999226/update-for-universal-c-runtime-in-windows.

To update an agent by using the web interface

  1. Click Settings > Agents.

    The software displays the list of machines. The machines with outdated agent versions are marked with an orange exclamation mark.

  2. Select the machines that you want to update the agents on. The machines must be online.
  3. Click Update agent.

During the update, any backups that are in progress will fail.

To update Agent for VMware (Virtual Appliance) whose version is below 12.5.23094

  1. Click Settings > Agents > the agent that you want to update > Details, and then examine the Assigned virtual machines section. You will need to re-enter these settings after the update.

    1. Make note of the position of the Automatic assignment switch.
    2. To find out what virtual machines are manually assigned to the agent, click the Assigned: link. The software displays the list of assigned virtual machines. Make note of the machines that have (M) after the agent name in the Agent column.
  2. Remove Agent for VMware (Virtual Appliance), as described in "Uninstalling agents". In step 5, delete the agent from Settings > Agents, even though you are planning to install the agent again.
  3. Deploy Agent for VMware (Virtual Appliance), as described in "Deploying the OVF template".

  4. Configure Agent for VMware (Virtual Appliance), as described in "Configuring the virtual appliance".

    If you want to reconstruct the locally attached storage, in step 7 do the following:

    1. Add the disk containing the local storage to the virtual appliance.
    2. Click Refresh > Create storage > Mount.
    3. The software displays the original Letter and Label of the disk. Do not change them.
    4. Click OK.

  5. Click Settings > Agents > the agent that you want to update > Details, and then reconstruct the settings that you made note of in step 1. If some virtual machines were manually assigned to the agent, assign them again as described in "Virtual machine binding".

    Once the agent configuration is completed, the protection plans that were applied to the old agent are re-applied automatically to the new agent.

  6. The plans with application-aware backup enabled require the guest OS credentials to be re-entered. Edit these plans and re-enter the credentials.
  7. The plans that back up ESXi configuration require the "root" password to be re-entered. Edit these plans and re-enter the password.

To update the Cyber Protection definitions on a machine

  1. Click Settings > Agents.
  2. Select the machine on which you want to update the Cyber Protection definitions and click Update definitions. The machine must be online.

To assign the Updater role to an agent

  1. Click Settings > Agents.
  2. Select the machine to which you want to assign the Updater role, click Details, then in the Cyber Protection definitions section, enable Use this agent to download and distribute patches and updates.

To clear cached data on an agent

  1. Click Settings > Agents.
  2. Select the machine on which you want to clear the cached data (outdated update files and patch management data) and click Clear cache.