How to install internal Replication Agents on multiple machines at once

How to install internal Replication Agents on multiple machines at once

Task

Perform mass deployment of internal Replication Agents to several machines with the same OS at once (Windows or Linux).

Solution

The PowerShell script for a Windows installation and the Ansible-playbook in case of Linux machines are available for download as a ZIP archive at:

To use the mass installation script for Windows machines:
  1. Create a CSV with the following format: HostIP;AgentURL (using ; as the delimiter).
  2. The target machines for agent installation should be in the same domain, and the script should also be executed from a machine within that domain.
  3. The authentication scheme used to access hosts is Kerberos.
  4. Run the script install_agents.ps1 with the created CSV, e.g.: install_agents.ps1 hosts.csv
To use the mass installation script for Linux machines:
  1. Install Ansible (playbook was tested with ansible==2.9.4).  
  2. Create an inventory file for all of the machines.
  3. Refer to Example 3 for cases where access is via password.
Example:
  1. centos ansible_ssh_host=172.22.14.148 ansible_ssh_user=centos
  2. ubuntu ansible_ssh_host=172.22.24.81 ansible_python_interpreter=/usr/bin/python3 ansible_ssh_user=ubuntu
  3. debian ansible_ssh_host=172.24.1.80 ansible_python_interpreter=/usr/bin/python3 ansible_ssh_user=root ansible_ssh_pass=YOUR_PASSWORD
  1. Run the playbook with the acura_host and customer_id fields specified.
Example:
  1. ansible-playbook -i hlragent-install-inventory -e "acura_host=172.22.20.8" -e "customer_id=ae8fd98e-c436-450a-bf4c-69488efbbdbd" linux_agent_install.yaml