Load balancing for ManageEngine ADManager Plus
The load balancing feature in ADManager Plus enables you to distribute requests to instances running on other servers, thereby optimizing and providing a better AD management experience.
Things to remember
- The load balancing feature is only available in ADManager Plus' Professional edition.
- All the configured nodes (server) must run the same version of ADManager Plus.
- The connection between the two nodes should not be hindered by any restrictions from firewall or antivirus programs.
- One instance of ADManager Plus will act as a primary node, while all other configured nodes will be considered as secondary nodes. The secondary nodes will use the database configured in the primary node.
- Modifications to the load balancing configuration can only be made from the primary node.
- SSL certificate and session expiration time should be configured individually for each ADManager Plus node involved in the load balancing configuration.
- If you want to enable HTTPS for ADManager Plus while load balancing is enabled, make sure you enable HTTPS in all the ADManager Plus nodes involved in the load balancing configuration.
- Nodes are considered identical and the configured nodes must be made as identical as possible. This can be done by ensuring that:
- All the nodes have the same permissions and access to all the domains or domain controllers configured, or to be configured in the product.
- The time and time zone of all nodes should be the same.
- Install the MSOnline PowerShell module if you have a Microsoft 365 account configured in ADManager Plus.
- The following features will be disabled when load balancing is enabled:
- High availability
- Smart card authentication
Steps to configure load balancing in ADManager Plus
- Log in to ADManager Plus and navigate to the Admin tab.
- In the left pane, under Enterprise Essentials, click Load Balancing.
- In the Load Balancer page, click Configure Load Balancer.
- The Primary Server URL is auto-populated.
- Enter a valid port number in the Load Balancer Port field.
- Upon entering the port number, the Load Balancer Access URL field is auto-populated.
- In the Secondary Nodes section, enter the host name or IP address of the ADManager Plus instance that you would like to configure as a secondary node in the Node URL field.
- Enter the credentials of a user account with super admin privileges in the Product Admin Username and Password fields.
- Click Save.
- Click +Add New Node and repeat steps 7 and 8 to configure more secondary nodes.
Upon saving the configuration, the primary node will be automatically restarted, followed by the secondary node(s).
Steps to modify the load balancing configuration
As mentioned earlier, modifications to the load balancing configuration must be made only from the instance configured as the primary node.
To modify a server,
- Log in to ADManager Plus' primary node.
- Navigate to the Admin tab and under Enterprise Essentials, click Load Balancing.
- In the Load Balancer Summary View page, click the Edit button to modify configurations like host name, port number, etc.
- Click the x icon to remove a node from the setup.
- Click Save.
Note: You can delete the entire load balancing setup by clicking the Remove button in the Load Balancer Summary View page.
Steps to manage scheduled jobs
Scheduled jobs such as automation, report generation, database backup, etc., are run from the primary node by default. However, you can also run them from a secondary node and reduce the load on the primary node using the Manage Scheduled Jobs option.
To achieve this,
- Log in to ADManager Plus' primary node.
- Navigate to the Admin tab and under Enterprise Essentials, click Load Balancing.
- In the Load Balancer Summary View page, click Manager Scheduled Jobs option.
- Choose a node from where you would like to run the scheduler from the Run Schedulers On drop-down list.
- Click Save and restart the server.
Troubleshooting tips
1. Build number is different from the primary node.
Cause: This error will occur when the build number of the ADManager Plus instance configured as the secondary node is different from the build number of the primary node in the Load Balancing Configuration.
Solution: Make sure you update all the ADManager Plus instances configured as secondary nodes to match the build number of the ADManager Plus instance configured as the primary node. Refer to the Service Pack page to learn how to update ADManager Plus.
2. Scheduled jobs are not running. Please restart this server.
Cause: Once you modify the Manage Scheduled Jobs setting and choose a new server to run the scheduled jobs, you must restart the selected node. If the node is not restarted, this error will occur.
Solution: Restart the node to run the scheduled jobs.
3. Protocol mismatch found. Make sure all the nodes involved in load balancing use the same protocol.
Cause: This error will occur if a secondary server uses a different protocol than the one used in the primary node.
Solution: All secondary nodes involved in the load balancing configuration must use the same protocol used by the primary node. For example, if HTTPS is enabled in the primary node, you must enable HTTPS in all secondary nodes as well.
4. Communication issue. Make sure the port 7800 is not blocked by the firewall in both the primary and secondary nodes. If the problem persists, click here to troubleshoot.
Cause:
- There might be a network connection issue between the primary and secondary nodes.
- The load balancer service in the primary node will run on a port that is different from the port used by ADManager Plus. By default, the load balancer service is assigned to port 7800. If port 7800 is already in use, port 7801 will be assigned. If it is unavailable, port 7802 will be assigned, and so on. This error will occur if the default port assigned to the load balancer service is blocked by the firewall.
Solution:
- Try to ping the secondary node from the primary node and check if there is a connection issue.
- Check if the port 7800 is open and available in both primary and secondary nodes. If it is available, make sure the port is not blocked by the firewall in both the primary and secondary servers. If port 7800 is not available, try port 7801, then port 7802, and so on.
5. A node is unreachable.
Cause: This error could occur due to any of the following reasons:
- The node is down.
- There is a change in the IP address of the node.
- There is a communication error between the primary node and the problematic node.
Solution: Restart the node and check whether the issue is resolved. Also, ensure that the primary and the problematic node can communicate with each other without any hassle.
6. Error in starting the secondary node after removing it from the load balancing configuration.
Cause: This error could error occur if the node was removed when it was down or unreachable.
Solution: Navigate to <Installation Directory>\ADManager Plus\bin folder in the secondary node that you had removed from the cluster, and execute the RemoveClusterSetup.bat before starting the node.