add server

Add a dynamic server to a backend.

Description Jump to heading #

Instantiate a new server attached to an existing backend. Such a server may also be called a dynamic server.

The specified server name must not already be in use in the backend. The backend must be configured to use a dynamic load-balancing algorithm for the balance directive: roundrobin, leastconn, first, or random.

A dynamic server is not restored after a load balancer reload operation. If you need the server definition to persist, add it to the load balancer’s configuration file.

Dynamic servers are statically initialized with the none init-addr method. In this method, the server starts in the down state without a valid IP address.

It may be possible to reach the fd (file descriptor) limit when using a large number of dynamic servers. See also fd-hard-limit and ulimit-n in the global keyword documentation.

The following keywords are supported for configuring the new server:

Settings from the default-server statement, if any, in the backend configuration are not applied to the new server.

Servers added with this command can be deleted using the del server command.

Examples Jump to heading #

Below, we add the server server2 to backend be_test:

nix
echo "add server be_test/server2 enabled maxconn=1000" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999

nix
echo "add server be_test/server2 enabled maxconn=1000" | \
  sudo socat stdio tcp4-connect:127.0.0.1:9999

See also Jump to heading #

• del server
• disable server
• enable server
• set server