ltm pool
ltm pool(1) BIG-IP TMSH Manual ltm pool(1)
NAME
pool - Configures load balancing pools for the Local Traffic Manager.
MODULE
ltm
SYNTAX
Modify the pool component within the ltm module using the syntax shown in the following sections.
CREATE/MODIFY
create pool [name]
modify pool [name]
options:
all
allow-nat [yes | no]
allow-snat [yes | no]
app-service [[string] | none]
autoscale-group-id [[string] | none]
description [string]
gateway-failsafe-device [string]
ignore-persisted-weight [yes | no]
ip-tos-to-client [pass-through | [integer] ]
ip-tos-to-server [pass-through | [integer] ]
link-qos-to-client [pass-through | [integer] ]
link-qos-to-server [pass-through | [integer] ]
load-balancing-mode [dynamic-ratio-member | dynamic-ratio-node |
fastest-app-response | fastest-node |
least-connections-members |
least-connections-node |
least-sessions |
observed-member | observed-node |
predictive-member | predictive-node |
ratio-least-connections-member |
ratio-least-connections-node |
ratio-member | ratio-node | ratio-session |
round-robin | weighted-least-connections-member |
weighted-least-connections-node]
members [add | delete | modify | replace-all-with] {
[ [node_name:port] ] {
options:
address [ip address]
app-service [[string] | none]
connection-limit [integer]
description [string]
dynamic-ratio [integer]
inherit-profile [enabled | disabled]
logging [enabled | disabled]
monitor [name]
priority-group [integer]
profiles [none | profile_name]
rate-limit [integer]
ratio [integer]
session [user-enabled | user-disabled]
state [ user-up | user-down ]
fqdn {
name [string]
autopopulate [enabled | disabled]
}
}
}
members none
metadata
[add | delete | modify] {
[metadata_name ... ] {
value [ "value content" ]
persist [ true | false ]
}
}
min-active-members [integer]
min-up-members [integer]
min-up-members-action [failover | reboot | restart-all]
min-up-members-checking [enabled | disabled]
monitor [name]
profiles [none | profile_name]
queue-on-connection-limit [enabled | disabled]
queue-depth-limit [integer]
queue-time-limit [integer]
reselect-tries [integer]
service-down-action [drop | none | reselect | reset]
slow-ramp-time [integer]
edit pool [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
reset-stats pool
reset-stats pool [ [ [name] | [glob] | [regex] ] ... ]
mv pool [ [[source-name] [destination-name]] | [[name] to-folder [folder-name]] | [[name...name] to-folder [folder-name]] ]
options:
to-folder
DISPLAY
list pool
list pool [ [ [name] | [glob] | [regex] ] ... ]
show running-config pool
show running-config pool [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
one-line
partition
show pool
show pool [name]
options:
all-properties
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
detail
field-fmt
DELETE
delete pool [name]
Note: You must remove all references to a pool before you can delete the pool.
DESCRIPTION
You can use this pool component to configure the pool definitions on the Local Traffic Manager. A load balancing pool is a
logical set of devices, such as Web servers, that you group together to receive and process traffic.
EXAMPLES
create pool my_pool members add { 10.2.3.11:http 10.2.3.12:http }
Creates a Local Traffic Manager pool named my_pool with two members, 10.2.3.11 and 10.2.3.12, using the default values for
the pool and pool members.
delete pool my_pool
Deletes the pool named my_pool.
show pool
Displays statistics and status for all Local Traffic Manager pools in the system configuration.
show pool all-properties
Displays statistics and status for all Local Traffic Manager pools in the system configuration.
Note that if the system includes Packet Velocity(r) ASIC (PVA) and PVA Assist capabilities, this command displays status
and statistics for that feature.
list pool my_pool
Displays properties of the pool named my_pool.
mv /ltm pool /Common/my_pool to-folder /Common/some_folder
Moves an LTM pool named my_pool and all of its Pool Members to the folder named some_folder, where some_folder has already
been created under /Common.
Please refer to the mv manual page for additional examples on how to use the mv command.
OPTIONS
all Specifies that you want to modify all of the existing components of the specified type.
allow-nat
Specifies whether the pool can load balance network address translation (NAT) connections. The default value is yes.
allow-snat
Specifies whether the pool can load balance secure network address translation (SNAT) connections. The default value
is yes.
app-service
Specifies the name of the application service to which the pool belongs. The default value is none. Note: If the
strict-updates option is enabled on the application service that owns the object, you cannot modify or delete the
pool. Only the application service can modify or delete the pool.
autoscale-group-id
Deprecated since v13.1.0. Specifies the autoscale-group id as reported by Amazon Web Services(AWS).
description
User defined description.
gateway-failsafe-device
Specifies that the pool is a gateway failsafe pool in a redundant configuration. The gateway-failsafe-device
identifies the device that depends on the gateway. If the monitor associated with the pool reports that the gateway is
down, the device goes to the standby state. The default value for this string is empty, the feature is not configured.
glob Displays the items that match the glob expression. See help glob for a description of glob expression syntax.
traffic-acceleration-status
Displays the current Traffic-Acceleration status. Indicates whether the pool is in-use by or dedicated to a virtual
server that uses a traffic-acceleration profile.
ignore-persisted-weight
Discounts the weight of connections made to pool members selected through persistence, rather than as a result of the
algorithm configured on the pool. If the connection's weight is ignored, then it is not treated as a 'pick' for that
pool member, and does not influence subsequent pool member load balancing decisions.
This option only impacts pools configured with one of the following load balancing modes: observed-member, observed-
node, predictive-member, predictive-node, ratio-least-connections-member, ratio-least-connections-node, ratio-member,
or ratio-node.
The default value is no, which results in persisted pool member connections being accounted for during load balancing
calculations.
ip-tos-to-client
Specifies the Type of Service (ToS) level to use when sending packets to a client. The default value is 65535 (pass-
through).
ip-tos-to-server
Specifies the ToS level to use when sending packets to a server. The default value is 65535 (pass-through).
link-qos-to-client
Specifies the Link Quality of Service (QoS) level to use when sending packets to a client. The default value is 65535
(pass-through).
link-qos-to-server
Specifies the Link QoS level to use when sending packets to a server. The default value is 65535 (pass-through).
load-balancing-mode
Specifies the modes that the system uses to load balance name resolution requests among the members of this pool. The
default value is round-robin.
The options are:
dynamic-ratio-member
Specifies that the system distributes connections based on various aspects of real-time server performance
analysis, such as the number of current connections per node or the fastest node response time.
This mode is similar to the dynamic-ratio-node mode, except that weights are based on continuous monitoring of
the servers and are therefore continually changing.
dynamic-ratio-node
Specifies that the system distributes connections based on various aspects of real-time server performance
analysis, such as the number of current connections per node or the fastest node response time.
This mode is similar to the dynamic-ratio-member mode, except that weights are based on continuous monitoring of
the servers and are therefore continually changing.
fastest-app-response
Specifies that the system passes a new connection based on the fastest response of all currently active nodes in
a pool. This mode might be particularly useful in environments where nodes are distributed across different
logical networks.
fastest-node
Specifies that the system passes a new connection based on the fastest response of all pools of which a server is
a member. This mode might be particularly useful in environments where nodes are distributed across different
logical networks.
least-connections-member
Specifies that the system passes a new connection to the node that has the least number of current connections in
the pool. This mode works best in environments where the servers or other equipment you are load balancing have
similar capabilities.
This dynamic load balancing mode distributes connections based on various aspects of real-time server performance
analysis, such as the current number of connections per node or the fastest node response time.
least-connections-node
Specifies that the system passes a new connection to the node that has the least number of current connections
out of all pools of which a node is a member. This mode works best in environments where the servers or other
equipment you are load balancing have similar capabilities.
This dynamic load balancing mode distributes connections based on various aspects of real-time server performance
analysis, such as the number of current connections per node, or the fastest node response time.
least-sessions
Specifies that the system passes a new connection to the node that has the least number of current sessions. This
mode works best in environments where the servers or other equipment you are load balancing have similar
capabilities.
This dynamic load balancing mode distributes connections based on various aspects of real-time server performance
analysis, such as the number of current sessions.
observed-member
Specifies that the system ranks nodes based on the number of connections. Nodes that have a better balance of
fewest connections receive a greater proportion of the connections.
This mode differs from the least-connections-member mode, which measures connections only at the moment of load
balancing, while the observed-member mode tracks the number of Layer 4 connections to each node over time and
creates a ratio for load balancing.
This dynamic load balancing mode works well in any environment, but may be particularly useful in environments
where node performance varies significantly.
observed-node
Specifies that the system ranks nodes based on the number of connections. Nodes that have a better balance of
fewest connections receive a greater proportion of the connections.
This mode differs from least-connections-node mode, which measures connections only at the moment of load
balancing, while the observed-node mode tracks the number of Layer 4 connections to each node over time and
creates a ratio for load balancing.
This dynamic load balancing method works well in any environment, but may be particularly useful in environments
where node performance varies significantly.
predictive-member
Uses the ranking method used by the observed-member mode, except that the system analyzes the trend of the
ranking over time, determining whether a node's performance is improving or declining. The nodes in the pool with
better performance rankings that are currently improving, rather than declining, receive a higher proportion of
the connections. This dynamic load balancing mode works well in any environment.
predictive-node
Uses the ranking method used by the observed-node mode, except that the system analyzes the trend of the ranking
over time, determining whether a node's performance is improving or declining. The nodes in the pool with better
performance rankings that are currently improving, rather than declining, receive a higher proportion of the
connections. This dynamic load balancing mode works well in any environment.
queue-depth-limit
Specifies the maximum number of connections that may simultaneously be queued to go to any member of this pool.
The default is zero which indicates there is no limit.
queue-on-connection-limit
Enable or disable queuing connections when pool member or node connection limits are reached. When queuing is not
enabled, new connections are reset when connection limits are met. The default value is disabled.
queue-time-limit
Specifies the maximum time, in milliseconds, a connection will remain enqueued. The default is zero which
indicates there is no limit.
ratio-least-connections-member
Specifies that the system weights connections to each pool member based on the value of the ratio weight defined
for each pool member. If a ratio weight is unspecified, it will be treated as a default value of '1'.
ratio-least-connections-node
Specifies that the system weights connections to each pool member based on the value of the ratio weight defined
for the pool member's node. If a ratio weight is unspecified, it will be treated as a default value of '1'.
ratio-member
Specifies that the number of connections that each machine receives over time is proportionate to a ratio weight
you define for each machine within the pool.
ratio-node
Specifies that the number of connections that each machine receives over time is proportionate to a ratio weight
you define for each machine across all pools of which the server is a member.
ratio-session
Specifies that the number of sessions that each machine receives over time is proportionate to a ratio weight
that you define for each machine within the pool.
round-robin
Specifies that the system passes each new connection request to the next server in line, eventually distributing
connections evenly across the array of machines being load balanced. This mode works well in most configurations,
especially if the equipment that you are load balancing is roughly equal in processing speed and memory.
weighted-least-connections-member
Specifies that the system passes a new connection to the pool member that is handling the lowest percentage of
the specified maximum number of concurrent connections allowed. This mode works best in environments where the
servers or other equipment you are load balancing have different but quantified capability limits.
This mode requires that you specify a value for the connection-limit option for all members of the pool, but does
not require all servers or other equipment you are load balancing to have similar capabilities.
weighted-least-connections-node
Specifies that the system passes a new connection to the node that is handling the lowest percentage of the
specified connection limit. This mode works best in environments where the servers or other equipment you are
load balancing have different but quantified capability limits.
This mode requires that you specify a value for the connection-limit option for all nodes, but does not require
all servers or other equipment you are load balancing to have similar capabilities.
members
Adds, deletes, or replaces a set of pool members, by specifying a node name and service port in the format [node
name/port]. If a node by the specified name does not exist, it will be created. You can configure the following
options for a pool member:
address
Specifies the IP address of a pool member if a node by the name specified does not already exist.
app-service
Specifies the name of the application service to which the pool member belongs. The default value is none. Note:
If the strict-updates option is enabled on the application service that owns the object, you cannot modify or
delete the pool member. Only the application service can modify or delete the pool member.
connection-limit
Specifies the maximum number of concurrent connections allowed for a pool member. The default value is 0 (zero).
description
User defined description.
dynamic-ratio
Specifies a range of numbers that you want the system to use in conjunction with the ratio load balancing method.
The default value is 1.
fqdn Specifies the attributes for defining a fully qualified domain name for the node.
name Specifies the fully-qualified domain name of the node.
address-family
Specifies whether the fqdn should consider IPv4, IPv6, or IP-agnostic address family.
autopopulate
Specifies whether a node defined by a fully-qualified domain name should automatically scale to the set of
IP addresses returned by the DNS query. If disabled, only one ephemeral node is generated from the first IP
address returned by DNS. The default is disabled.
interval
Specifies the interval, in seconds, to instantiate DNS queries on a fully-qualified domain name. The default
is 3600. A value of 'ttl' uses the TTL value obtained from the DNS server.
down-interval
Specifies the interval for the domain name resolution operation when a DNS query fails. The default is 5.
inherit-profile
Specifies whether the pool member inherits the encapsulation profile from the parent pool. The default value is
enabled. If you disable inheritance, no encapsulation takes place, unless you specify another encapsulation
profile for the pool member using the profiles attribute.
logging
Specifies whether the monitor applied should log its actions. Logs are stored in /var/log/monitors/ and are
regularly rotated and compressed. The default value is disabled. This option isn't a part of configuration and
will reset to disabled on load. This option doesn't sync.
monitor
Specifies the health monitors that are configured to monitor the pool member. The default value is default, the
system monitors the pool member using the monitors specified for the pool.
You can specify:
• A single monitor, for example, modify pool mypool members modify { pool_member_1:80 { monitor http } }.
• Multiple monitors, for example, modify pool mypool members modify { pool_member_1:80 { monitor http and
https } }.
• A minimum number of monitors, for example, modify pool mypool members modify { pool_member_1:80 { monitor
min 1 of { http https } } }.
• No monitor rule or remove a monitor rule, for example, modify pool mypool members modify { pool_member_1:80
{ monitor none } }.
profiles
Specifies the encapsulation profile to use for the pool member, when the inherit-profile attribute is disabled.
The default value is none.
priority-group
Specifies the priority group within the pool for this pool member. Valid values are 0 through 65535. The system
sends traffic to groups in order of priority. The default value is 0.
rate-limit
Specifies the maximum number of connections per second allowed for a pool member. The default value is
'disabled'.
ratio
Specifies the weight of the pool member for load balancing purposes. The default value is 1.
session
Establishing a session with a pool member is establishing the ability of the client to persist to the pool member
when making new connections. When a pool member is session disabled, clients that have already established
sessions with the pool member may create new connections, but a client that has not already established a session
may not create a new one (or make a connection which would create a new session). This feature is used to gently
drain connections from a node, typically as part of a maintenance operation. The default value is user-enabled.
The value of this property can be set by system or by user. If the value is set by system, the property will not
be displayed in "Edit" command. But, users can add this field in if they need to modify this property. The values
which user can set for this property are user-enabled and user-disabled.
state
user-down forces the pool member offline, overriding monitors. user-up reverts the user-down. When user-up, this
displays the monitor state.
metadata
Associates user-defined data, each of which has name and value pair and persistence. The default value is persistent,
which saves the data to the config file.
min-active-members
Specifies the minimum number of members that must be up for traffic to be confined to a priority group when using
priority-based activation. The default value is 0 (zero). An active member is a member that is up (not marked down)
and is handling fewer connections than its connection limit.
min-up-members
Specifies the minimum number of pool members that must be up; otherwise, the system takes the action specified in the
min-up-members-action option.
Use this option for gateway pools in a redundant system where a unit number is applied to the pool. This indicates
that the pool is configured only on the specified unit.
min-up-members-action
Specifies the action to take if min-up-members-checking is enabled, and the number of active pool members falls below
the number specified in the min-up-members option. The default value is failover. The options are:
reboot
Specifies that when the min-up-members-checking option is enabled, and the number of active pool members is less
than the number specified in the min-up-members option, the system restarts.
restart-all
Specifies that when the min-up-members-checking option is enabled, and the number of active pool members is less
than the number specified in the min-up-members option, the system restarts.
failover
Specifies, for a redundant system, that when the min-up-members-checking option is enabled, and the number of
active pool members is less than the number specified in the min-up-members option, the system fails over.
min-up-members-checking
Enables or disables the min-up-members feature. If you enable this feature, you must also specify a value for both the
min-up-members and min-up-members-action options.
monitor
Specifies the health monitors that the system uses to determine whether it can use this pool for load balancing. The
monitor marks the pool up or down based on whether the monitor is successful. The default value is none.
You can specify:
• A single monitor, for example, modify pool mypool monitor http.
• Multiple monitors, for example, modify pool mypool monitor http and https.
• A minimum number of monitors, for example, modify pool mypool monitor min 1 of {http and https}.
• No monitor rule or remove a monitor rule, for example, modify pool mypool monitor none.
name Specifies a unique name for the component. This option is required for the commands create, delete, and modify.
partition
Displays the administrative partition within which the pool resides.
profiles
Specifies the profile to use for encapsulation. The default value is none, which indicates no encapsulation.
regex
Displays the items that match the regular expression. The regular expression must be preceded by an at sign (@[regular
expression]) to indicate that the identifier is a regular expression. See help regex for a description of regular
expression syntax.
reselect-tries
When set to the default value of 0 (zero) the system does not attempt to load balance to another pool member after a
passive failure. A passive failure is a pool member connection failure.
When set to any other value, the system attempts to load balance to another pool member after a passive failure, and
if that attempt also results in a passive failure, the system repeats the process until the specified number of
reselection tries is reached.
reset-stats
Resets the statistics for the specified component to 0 (zero).
service-down-action
Specifies the action to take if the service specified in the pool is marked down. The options are:
drop Specifies that the system drops connections when a the service is marked down.
none Specifies that the system takes no action when a the service is marked down. This is the default value.
reselect
Specifies that the system reselects a node for the next packet that comes in on a Layer 4 connection, if the
service of the existing connection is marked down.
reset
Specifies that the system resets when a the service is marked down.
slow-ramp-time
Specifies, in seconds, the ramp time for the pool. This provides the ability to cause a pool member that has just been
enabled, or marked up, to receive proportionally less traffic than other members in the pool. The proportion of
traffic the member accepts is determined by how long the member has been up in comparison to the value of the slow-
ramp-time option for the pool.
For example, if the load-balancing-mode of a pool is round-robin and it has a slow-ramp-time of 60 seconds, when a
pool member has been up for only 30 seconds, the pool member receives approximately half the amount of new traffic as
other pool members that have been up for more than 60 seconds. After the pool member has been up for 45 seconds, it
receives approximately three quarters of the new traffic.
The slow-ramp-time option is particularly useful when used with the least-connections-member load balancing mode. The
default value is 10.
to-folder
This is used with the mv command to specify a folder in which to move the pool and its members to.
Note: pools can be moved to any folder under /Common, but dependencies upon it may restrict moving it out of /Common.
SEE ALSO
create, delete, edit, glob, list, modify, mv, ltm virtual, regex, reset-stats, show, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or by any means, electronic or mechanical, including
photocopying, recording, or information storage and retrieval systems, for any purpose other than the purchaser's personal
use, without the express written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2008, 2012-2016. All rights reserved.
BIG-IP 2018-10-17 ltm pool(1)