_STEP Add the first Crowd node your load balancer

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

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.

  1. First, add your load balancer as a trusted proxy server in Crowd. See Configuring Trusted Proxy Servers.
  2. Add the first node to the load balancer.

  3. 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.
  4. In Crowd, go to > Clustering. The node should be listed as part of the cluster. 

    tip/resting Created with Sketch.

    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 a 200 OK response within a reasonable time, the load balancer shouldn't direct any traffic to this node.

  5. 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.

Last modified on Dec 16, 2020

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.