_STEP Add the first Crowd node your load balancer
3. Add the first Crowd node to your load balancer
Before you begin
You must enable clustering in Crowd first. To do that, in your shared directory edit the crowd.cfg.xml file and set the crowd.clustering.enabled
property to true
and restart Crowd.
The load balancer distributes the traffic between the nodes. If a node stops working, the remaining nodes will take over its workload, and your users won't even notice it.
- First, add your load balancer as a trusted proxy server in Crowd. See Configuring Trusted Proxy Servers.
Add the first node to the load balancer.
- Restart the node, and then try opening different pages in Crowd. If the load balancer is working properly, you should have no problems with accessing Crowd.
In Crowd, go to > Clustering. The node should be listed as part of the cluster.
If your load balancer supports health checks, configure it to perform a check on
http://<crowd-node>:8095/<context-path>/status
, where<crowd-node>
is the node's hostname or IP address, and<context-path>
is the Crowd's context path (e.g./crowd
). If the node doesn't respond with a200 OK
response within a reasonable time, the load balancer shouldn't direct any traffic to this node.- After you've added the node to the load balancer, configure the Crowd's base URL to also point to the load balancer. Go to > General, and enter the URL of your load balancer as Base URL.