60137: Acronis Backup 12.5: mass deployment and update of Agents for Windows

Also read in:

use Google Translate

Applies to: 

Starting with Update 1, Acronis Backup 12.5 (both Standard and Advanced) provides a convenient tool for remote installation and update of Windows Agents on multiple machines.

Prepare a list of machines where Agent for Windows should be installed

Create a .csv file containing hostnames or IP addresses and access credentials, one machine per line:

 host1 user1 password1 unit_path1
 host2 user2 password2 unit_path2
 host3 user3 password3 unit_path3

For each of the machines, specify the credentials of an account with administrative privileges on that machine.

If a password contains a comma or a blank space, this password should be taken into quotes (for example, "pass w,ord").

For a machine which is a domain controller in an Active Directory domain, you must specify the name of that domain together with the user name. For example: MyDomain\Administrator

Unit_path parameter is supported starting from Update 4 (Build 12730)

Agents are registered according to Unit_path value. If value is empty, agents will be registered into default root organization. If Unit_path is not empty but such unit does not exist, registration fails.

There are two ways to specify Unit_path:

1) In /Organization/unit1/unit2 format - relative path to the unit where Acronis Management Server user is the administrator (in this case, Organization unit). Path is separated by slashes. If unit name has spaces, put quotes around the path

2) Using unitID (unitID can be found in unit Details). This method must be used in cases when unit name contains slashes, e.g. NewOffice/HR. 

Mass deployment

Before you start deployment, make sure that target machines meet requirements for remote installation (see the Preparation step).
Only Agent for Windows is installed on target machines.
  1. On the Windows machine where Acronis Management Server is located, open Command Prompt and navigate to the C:\Program Files\Acronis\PyShell folder:
    cd "C:\Program Files\Acronis\PyShell"
  2. Issue:
    python site-tools\agents.py -v -a <AMS_address> -p 9877 --username <username> --password <password> -i --agents <list.csv>
     
    where <AMS_address> is the hostname or the IP address of the machine with Acronis Management Server
    <username> is the name of the Acronis Management Server user and <password> is this user's password
    <list.csv> is the file containing the list of machines where Agent for Windows should be installed

Specifying units for deployment

Example 1: Organization administrator

You have a unit administrator Admin1 for Organization unit or you use default administrators of Organization

You want to install 3 Agents and register them in 3 different units:

/Organization/1/2/3/4
/Organization/unit 1/unit 2
/Organization/Unit-01 ("Unit-01" has the following unitID = 3e593003-2f14-11e9-94bc-00505697fc2a)

There are two ways to specify registration path:

1) Relative path to the unit where Admin1 is the administrator (in this case, Organization unit). Path is separated by slashes. If unit name has spaces, put quotes around the path.

2) Using unitID (unitID can be found in unit Details). This method must be used in cases when unit name contains slashes, e.g. NYoffice/HR

Create list.csv
host_1 (or IP) user_1 password_1 /Organization/1/2/3/4
host_2 (or IP) user_2 password_2 “/Organization/unit 1/unit 2”
host_3 (or IP) user_3 password_3 3e593003-2f14-11e9-94bc-00505697fc2a

On the Windows machine where Acronis Management Server is located, open Command Prompt and navigate to the C:\Program Files\Acronis\PyShell folder:
cd "C:\Program Files\Acronis\PyShell"
Issue:
.\python site-tools\agents.py -v -a <AMS_address> -p 9877 --username Admin1 --password <password> -i --agents <list.csv>

Example 2: Unit administrator

You have a user Admin2, who is a regular user on the operating system level, and is also a unit administrator for one or several units (but this user is not administrator for Organization unit)

For example, Admin2 is unit administrator for the following units:

/Organization/1/2/3/444/5
/Organization/Unit1/Unit2/Unit3
/Organization/u1/u2/u3 

And you need to register agents in the following units:

/Organization/1/2/3/444/5
/Organization/Unit1/Unit2/Unit3
/Organization/u1/u2/u3 (u3 has the following unitID = 1a2aee3b-2e60-11e9-a834-00505697fc2a)

The path should be specified relative to the unit where Admin2 is administrator.

In this case, list.csv file should look like this:

host_1 (or IP) user_1 password_1 /1/2/3/444
host_2 (or IP) user_2 password_2 /Unit1/Unit2/Unit3
host_3 (or IP) user_3 password_3 1a2aee3b-2e60-11e9-a834-00505697fc2a

On the Windows machine where Acronis Management Server is located, open Command Prompt and navigate to the C:\Program Files\Acronis\PyShell folder:
cd "C:\Program Files\Acronis\PyShell"
Issue:
.\python site-tools\agents.py -v -a <AMS_address> -p 9877 --username Admin2 --password <password_а> -i --agents <list.csv>

Mass update or upgrade

All components installed on the target machines will be updated. The feature is available for Windows machines only.
  1. On the Windows machine where Acronis Management Server is located, open Command Prompt and navigate to the C:\Program Files\Acronis\PyShell folder:
    cd "C:\Program Files\Acronis\PyShell"
  2. Get list of machines existing on Acronis Management Server for update:
    python site-tools\agents.py -a <AMS address> -p 9877 --username <username> --password <password> -l –-dump <dump file>
     
    where <AMS address> is the hostname or the IP address of the machine with Acronis Management Server
    <username> is the name of the Acronis Management Server user and <password> is this user's password
    <dump file> is the name and the location of the resulting dump file; if you do not specify it manually, by default, the dump file named dump_agent.csv is placed to the current working directory.
  3. Run update:
    python site-tools\agents.py -v -a <AMS address> -p 9877 --username <username> --password <password> -u --agents <list.csv>
     
    where <AMS_address> is the hostname or the IP address of the machine with Acronis Management Server
    <username> is the name of the Acronis Management Server user and <password> is this user's password
    <list.csv> is the file containing the list of machines where Agent for Windows should be updated

More information

Help:
python site-tools\agents.py --help

You can check the installation activity in the Activities tab: in the management console navigate to Overview -> Activities.

Tags: 

You are reporting a typo in the following text:
Simply click the "Send typo report" button to complete the report. You can also include a comment.
CAPTCHA
This question is for testing whether or not you are a human visitor and to prevent automated spam submissions.
1 + 17 =
Solve this simple math problem and enter the result. E.g. for 1+3, enter 4.