Installing IQ Bot in Cluster mode

Install IQ Bot in Cluster mode for improved throughput. IQ Bot supports clustering of up to five IQ Bot installations.

Prerequisites

Ensure you have a load balancer for a cluster setup to distribute traffic to all application server nodes.

IQ Bot architecture for Cluster mode installation

Procedure

  1. Install IQ Bot on each machine in custom mode.
    • During installation, on the Load Balancer Configuration screen, type in the load balancer host name and port.
    • Select the Load Balancer can handle SSL Offloading option, if the load balancer supports is to enable SSL offloading.
    • Provide the shared output path on the Destination Folder screen.
    • During installation, use the same database server details on all the nodes.
    Installing IQ Bot in Custom mode
  2. Share the output folder with the access role Everyone.
    See Make a Shared Folder Accessible.
  3. Use Command Prompt to link each machines containing an IQ Bot installation to the primary cluster.
    See RabbitMq cluster configuration for IQ Bot.
  4. Optional: If you have set up Control Room in High Availability mode, you can set up IQ Bot in High Availability mode as well.
    High availability and disaster recovery overview
  5. Configure the firewall to have ports 4369 and 25672 open.

Next steps

For each machine containing an IQ Bot installation, verify that IQ Bot is installed, ensure the IQ Bot services are running using the healthcheck APIs, and register IQ Bot with Control Room. Postinstallation checklist
Note: When you register each installation of IQ Bot, in the URL field, enter the URL to the load balancer.
Important: In a cluster setup, if a temporary network issue occurs, the cluster breaks. To add the nodes back into the cluster, you must manually execute commands in each of the participating nodes. You also have to monitor the cluster status to know if it is healthy or broken. To avoid such issues, you can configure the cluster to automatically recover (auto-recover) from temporary network issues. See this article for information about how to enable auto-recovery: RabbitMQ Cluster Configuration with Auto-recovery (A-People login required).