User guide

configure server
ExtremeWarePx1 1.2 Command Reference Guide 123
You can conÞgure a number of servers at contiguous IP addresses, all of which use the same port. When
you specify a range of IP addresses, the speciÞed index is used for the Þrst server and incremented for
each conÞgured server.
You must use the build command to commit the conÞguration changes made by this command.
Adding a Server. The Þrst time you conÞgure a particular combination of index, IP address, and port
number, you add the speciÞed server to the system. The switch associates the server index with the real
server that has the indicated IP address and port number.
If a given real server has already been added to the system, you may not assign that same server to a
different index. An error will be reported if you attempt to do so. For examples:
SummitPx1::2 # config server index 100 ipaddress 10.1.1.1 port 80
* SummitPx1::3 # config server index 102 ipaddress 10.1.1.1 port 80
ERROR: server ip and port have already been configured in server index 100
Command Failed
Setting Server Properties. Adding a server to the system initializes the serverÕs properties:
¥ The maximum number of connections for the server
¥ The serverÕs weight for use by weighted load-balancing algorithms
¥ A cookie string that uniquely identiÞes the server (relevant only for servers that will be used in a
layer 7 virtual service that uses the self-identifying cookie persistence mode)
When you conÞgure a single server, you can specify values for any of these properties. When you
conÞgure a number of servers in a single command, you can specify values for the Þrst two properties,
but not the cookie string.
When the number of connections to a particular server equals its maximum number of connections, no
more connections are sent to that server until some of its open connections have been closed. If the
configure server command does not specify the value for a serverÕs maximum number of connections
or weight, the global default value is used. The global default value for the maximum number of
connections is initially 10,000; the global default for weight is initially 1. You can change the global
default values with the configure server default command.
If the configure server command does not specify the value for a serverÕs cookie string, and that
server is used in a layer 7 virtual service that uses the self-identifying cookie persistence mode, a
default cookie string is constructed. A serverÕs default cookie string is a 7-character ASCII string
containing the serverÕs index with leading zeros. For example, a server with index 25 has the default
cookie string of "0000025".
Changing the Real Server at an Index. Once you have added a server to the system, if you later
issue the configure server command, specifying the serverÕs index number but a different IP address
and port number, you replace the real server associated with that server index. The real server
previously associated with the speciÞed index is removed from the system (because it no longer has an
associated index number).
Changing Server Properties. You can change the properties of an existing server by issuing the
configure server command, specifying the index number, IP address, and port number of the server,
and a new value for the any of the serverÕs properties.