61049: Acronis Cyber Protect Cloud: mass update of Acronis Agents

use Google Translate

Last update: Mon, 2021-01-18 13:14


Using Acronis web console, you can update Acronis Agent on a remote machine or on up to 10 remote machines in one step.

If you need to update Acronis Agents on a large number of machines or/and do not want to use the web interface, use the script provided in this article.


The mass update script runs recursively through the hierarchy under the specified partner/customer/unit group, lists installed agents and

  • updates agents marked for update (if "justreporting" option is not used)
  • collects information about installed agents to ".csv" report file (if "justreporting" option is used)


  • The script cannot resume at the last place if tit failed or was terminated by user
  • Simultaneous update of agents is not limited (this can lead to a lot of requests to the server in a short time)
  • When run with user="<parent admin>", the script does not support child tenants with "Self-service" enabled
  • The script does not support tenants with two-factor authentication


  1. Install Python 3.6 or newer (https://www.python.org/downloads/)
  2. Install requests module for Rest API call:
    python -m pip install requests


  1. Download and unpack the script.
  2. Open Command Prompt.
  3. Navigate to the folder where you have downloaded the script. Use the cd command.
  4. Run the script:
    python agent_update.py --username <username> --password <password> --hostname <hostname> --group <group ID> --justreport
Short form

Long form


Value passed





USERNAME of the authorized account (Partner administrator)





PASSWORD for the authorized account (Partner administrator)





HOSTNAME of the DC where authorized account is located

May be omitted if account is located at Acronis DC




tenant UID, id of the tenant to be processed (partner/customer/unit)

May be omitted, home group of the authorized account will be used as an entry point




<empty>, no value is passed

Information about all installed agents and their version will be collected and stored to CSV report file; no update sequence will be initiated






-d --debug optional <empty>, no value is passed  

Limitations: script does not update agent on offline machines. If amount of agents to update is large (>100), the script pauses for 1 hour after each 100 updated agents.