set weight

Change the weight of a server.

Description Jump to heading #

Use set weight to increase or decrease the weight assigned to a server, which affects how much traffic the load balancer sends to it.

Examples Jump to heading #

In the example below, the backend has two servers, each with an assigned weight of 100:

haproxy
backend be_servers
  server server1 127.0.0.1:8080 check weight 100
  server server2 127.0.0.1:8081 check weight 100

haproxy
backend be_servers
  server server1 127.0.0.1:8080 check weight 100
  server server2 127.0.0.1:8081 check weight 100

1. Use the get weight Runtime API command to display the current weight of a given server.

   nix
   echo "get weight be_servers/server1" | \
     sudo socat stdio tcp4-connect:127.0.0.1:9999

   nix
   echo "get weight be_servers/server1" | \
     sudo socat stdio tcp4-connect:127.0.0.1:9999

   output
   text
   100 (initial 100)

   output
   text
   100 (initial 100)

   It indicates the initial value that was set in the configuration file and the current value, which may have changed.

2. Use set weight to change the weight of a server.

   You can pass either an absolute value or a percentage.

   nix
   echo "set weight be_servers/server1 50%" | \
     sudo socat stdio tcp4-connect:127.0.0.1:9999

   nix
   echo "set weight be_servers/server1 50%" | \
     sudo socat stdio tcp4-connect:127.0.0.1:9999

   In the snippet above, we changed the server1 server’s weight to 50% of its current value.

3. Call get weight again to see the server’s updated weight:

   nix
   echo "get weight be_servers/server1" | \
     sudo socat stdio tcp4-connect:127.0.0.1:9999

   nix
   echo "get weight be_servers/server1" | \
     sudo socat stdio tcp4-connect:127.0.0.1:9999

   output
   text
   50 (initial 100)

   output
   text
   50 (initial 100)

See also Jump to heading #

• get weight