How to install internal Replication Agents on multiple machines at once

Installing 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:
https://hystax-eu-fra.s3.eu-central-1.amazonaws.com/AcuraTools/mass_agents_installation.zip


To use the mass installation script for Windows machines:
  1. Create a CSV file with the following format: HostIP;AgentURL (using ; as the delimiter by default. The script also supports other delimiters.
  2. Ensure the target machines for agent installation are in the same domain, and that the script is executed from a machine within that domain.
  3. The authentication scheme used to access the hosts is Kerberos.
  4. Run the script install_agents.ps1 with the created CSV file. Example: install_agents.ps1 hosts.csv.
Note: To specify a different delimiter (e.g., comma), use: 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