Load balancing for ADSelfService Plus

Load balancing is a technique that distributes incoming requests across many servers. This helps alleviate performance degradation resulting from heavy traffic, eliminate downtime caused by system or application failure, and provide a much better experience for end users.

Before you begin

Steps to configure load balancing

  1. Start ADSelfService Plus on all the machines.
  2. Choose the ADSelfService Plus instance you have selected as the primary node, and log in as an administrator.
  3. Go to Admin → Enterprise Essentials → Load Balancing.
  4. Click Configure Load Balancer.
  5. The Primary Node URL will be automatically populated.
  6. Enter the Load Balancer Port. This port will be used by the Load Balancer service, and it should be different from the port used by ADSelfService Plus.
  7. Once you enter the port number, the Load Balancer URL will be populated.
  8. Note: Use this URL as the Access URL in Admin → Product Settings → Connection → Configure Access URL.
  9. In the Secondary Node section, enter the hostname or IP address and the port number of ADSelfService Plus installed in another machine in the Server URL field.
  10. In the Product Admin Username and Password fields, enter the username and password of a user with the Super Admin role in the secondary ADSelfService Plus node.
  11. Click Save.
  12. If you want to add more secondary nodes, click the + icon and repeat Step 9.
  13. First, the primary node will automatically restart. Once it’s up and running, all secondary nodes will be automatically restarted.

Steps to modify the load balancing configuration

Any modification to the load balancing configuration must be performed only from the primary node.

Managing scheduled jobs after enabling load balancing

By default, scheduled jobs such as report generation, Active Directory to ADSelfService Plus synchronization, etc. will be run from the primary node once load balancing is enabled. However, you can configure scheduled jobs to be run from one of the secondary nodes to reduce the load on the primary server.

To run scheduled jobs from a particular node:

  1. Log in to the ADSelfService Plus primary node as an admin.
  2. Go to Admin → Enterprise Essentials → Load Balancing.
  3. Click Manage Scheduled Jobs.
  4. Select a server from the Run Schedulers on drop-down menu.
  5. Click Save.

Troubleshooting tips

  1. Build number is different from the primary node.
  2. Cause: If the ADSelfServcie Plus build number of a secondary node is different from the build number of the ADSelfServcie Plus instance designated as the primary node in Load Balancing Configuration, this error will occur.

    Solution: Make sure you update all the ADSelfService Plus instances designated as secondary nodes to match the build number of the ADSelfService Plus instance designated as the primary node. Refer to the Service Pack page to learn how to update ADSelfService Plus.

  3. Scheduled jobs are not running. Please restart this server.
  4. 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.

  5. Protocol mismatch found. Make sure all the nodes involved in load balancing use the same protocol.
  6. 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. Refer to this guide to learn how to enable HTTPS and install an SSL certificate in ADSelfService Plus.

  7. Communication issue. Make sure the port <7800> is not blocked by the firewall in both the primary and secondary nodes. If the problem still persists, click here to troubleshoot.
  8. Cause:

    • There may be a network connection issue between 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 ADSelfService Plus. By default, the load balancer service is assigned the port 7800. If 7800 port is already in use, 7801 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 7800 port is not available, try 7801, and so on.
  9. A node is down or is not reachable.
  10. Cause: This error could occur if there is a change in the IP address of the node.

    Solution: Restart the node and check whether the issue is resolved.

Copyright © 2023, ZOHO Corp. All Rights Reserved.