Updating protection agents

You can update all agents manually either by using the Cyber Protect console or by downloading and running the installation file.

You can configure automatic updates for the following agents:

  • Agent for Windows
  • Agent for Linux
  • Agent for Mac
  • Cyber Files Cloud Agent for File Sync & Share

Free disk space that is required for the update

Free space is required to update an agent automatically or manually, by using the Cyber Protect console.

Operating System Download location Required disk space
Linux /opt/acronis/Acroinst2/ 3 GB
Mac /Library/Application Support/Acronis/Acroinst2 2 GB
Windows

%ProgramData%\Acronis\Acroinst2\

%ProgramData%\Acronis\InstallationCache\

 2 GB

[For all agents provided in the form of a virtual appliance, including Agent for VMware, Agent for Scale Computing, Agent for Virtuozzo Hybrid Infrastructure, Agent for RHV (oVirt)]

In order to perform automatic or manual update of a virtual appliance located behind a proxy, the proxy server must be configured on each appliance as follows.

In the /opt/acronis/etc/va-updater/config.yaml file, add the following line to the bottom of the file and enter the values specific to your environment:

httpProxy: http://proxy_login:proxy_password@proxy_address:port

Configuring the default method for updating agents

You can configure the default method for updating agents - manual or automatic, for all agents on all machines or on individual machines.

The default settings for agent updates are accessible from the Cyber Protection console and Management Portal, for all user roles.

Automatic updates

To configure default settings for automatic updates for all agents in the Cyber Protect console

  1. Select Settings > Agents.
  2. In the upper-right corner, under Actions, click Edit default agent update settings.

  3. Under Update channel, select which version to use for automatic updates.

    Option Description
    Latest (selected by default) Install the latest available version of the Cyber Protection agent.
    Previous stable Install the most recent stable version of the Cyber Protection agent from previous releases.

  4. Verify that the option Automatically update agents is switched on.

    Automatic updates are only available for the following agents:

    • Cyber Protect agent versions 26986 (released in May 2021) or later.

    • Desktop Agent for File Sync & Share, version 15.0.30370 or later.

    Older agents must be updated manually to the latest version before automatic updates can take effect.

  5. Set the maintenance window.
    The default window is daily, from 23:00 to 08:00 on the machine where the agent is installed.

    Although agent updates are fast and seamless, we recommend that you choose a time frame that will cause minimum disruption for users, because users cannot prevent or postpone automatic updates.

  6. Click Save.

To configure default settings for automatic updates for selected agents in the Cyber Protect console.

  1. Select Settings > Agents.
  2. In the list of agents, select the ones for which you want to configure the automatic updates.
  3. In the upper-right corner, under Actions, click Agent update settings.

  4. Click Edit default agent update settings.

  5. Under Update channel, select which version to use for automatic updates.

    Option Description
    Latest (selected by default) Install the latest available version of the Cyber Protection agent.
    Previous stable Install the most recent stable version of the Cyber Protection agent from previous releases.

  6. Verify that the option Automatically update agents is switched on.

    Automatic updates are only available for the following agents:

    • Cyber Protect agent versions 26986 (released in May 2021) or later.

    • Desktop Agent for File Sync & Share, version 15.0.30370 or later.

    Older agents must be updated manually to the latest version before automatic updates can take effect.

  7. Set the maintenance window.
    The default window is daily, from 23:00 to 08:00 on the machine where the agent is installed.

    Although agent updates are fast and seamless, we recommend that you choose a time frame that will cause minimum disruption for users, because users cannot prevent or postpone automatic updates.

  8. Click Save.

Manual updates

We strongly recommend that you enable automatic updates for your agents. Regular updates ensure your agents stay up to date, offering improved performance, bug fixes, and enhanced protection and security features.

To configure default settings for manual updates for all agents in the Cyber Protection console

  1. Go to Settings > Agents.
  2. In the upper-right corner, under Actions, click Edit default agent update settings.

  3. Under Update channel, select which version to use for automatic updates.

    Option Description
    Latest (selected by default) Install the latest available version of the Cyber Protection agent.
    Previous stable Install the most recent stable version of the Cyber Protection agent from previous releases.

  4. Select Manually update agents.

  5. To prevent security risks, ensure access to the latest features, and minimize the technical issues caused by significantly outdated agents, enable the automated updates of agents that are older than 6 months.

    1. Select Enforce automatic updates for unsupported versions.

      If you have not enabled the automated updates of agents before the C25.02 release, this option will be enabled automatically for all tenants in your environment.

    2. Set the maintenance window.
      The default maintenance window is daily, from 23:00 to 08:00 o'clock on the machine where the agent is installed.

      Despite that the agent update processes are designed to be fast and seamless, we recommend choosing a time frame which will cause minimum disruption for users, as users cannot prevent or postpone automatic updates.

  6. Click Save.

To configure manual updates for selected agents in the Cyber Protect console.

  1. Go to Settings > Agents.
  2. In the list of agents, select the ones for which you want to configure the automatic updates.
  3. In the upper-right corner, under Actions, click Agent update settings.

  4. Click Edit default agent update settings.

  5. Under Update channel, select which version to use for automatic updates.

    Option Description
    Latest (selected by default) Install the latest available version of the Cyber Protection agent.
    Previous stable Install the most recent stable version of the Cyber Protection agent from previous releases.

  6. Select Manually update agents.

  7. To prevent security risks, ensure access to the latest features, and minimize the technical issues caused by significantly outdated agents, enable the automated updates of agents that are older than 6 months.

    1. Select Enforce automatic updates for unsupported versions.

      If you have not enabled the automated updates of agents before the C25.02 release, this option will be enabled automatically for all tenants in your environment.

    2. Set the maintenance window.
      The default maintenance window is daily, from 23:00 to 08:00 on the machine where the agent is installed.

      Although agent updates are fast and seamless, we recommend that you choose a time frame that will cause minimum disruption for users, because users cannot prevent or postpone automatic updates.

  8. Click Save.

Monitoring the agent updates

To monitor agent updates, see sections The Alerts dashboard and The Activities dashboard.