Pool command, bigpipe

From NetworkCommands

A command available on all F5 BigIP platforms; used to create, modify and delete pools (collections of nodes) or display information about them.

Usage Syntax

bigpipe pool name [options]

Commonly used options include;

• action on svcdown [none | reset | drop | reselect]
• lb method [round robin | member ratio | member least conn | member observed | member predictive | ratio | least conn | fastest | observed | predictive | dynamic ratio | fastest app resp | least sessions | member dynamic ratio | l3 addr | rr | node ratio] - specify the load balancing method to be used
• members [[ip_address:port | none] | [add | delete]] - specify member(s) for a new pool or member(s) to add or delete to an existing pool, or none for no members
• min active members <number> - specify the minimum number of active members required for the pool to be considered available
• monitor all monitor_name - specify which monitor to use to monitor all pool members
• members ip_address:port limit number - specify a connection limit for connections via this pool, for the specified pool member
• members ip_address:port priority number - specify a priority within the pool for the specified pool member
• members ip_address:port ratio number - specify a ratio within the pool, for the specified pool member
• stats - display statistics for the specified pool
• stats reset - reset or clear statistics for the specified pool
• partition name - specify the administrative partition the pool will be created on

Usage Examples

b pool POOL_ONE \{ members 10.11.12.20:http 10.11.12.21:http 10.11.12.22:http monitor all http lb method round robin partition ONE \} - create, on administrative partition ONE a pool named POOL_ONE with the specified members, round robin load balancing and monitor pool members using the http monitor

b pool POOL_ONE members 10.11.12.21:http delete - delete specified member from POOL_ONE

b pool POOL_ONE members 10.11.12.21:http add - add specified member to POOL_ONE

b pool POOL_ONE members 10.11.12.21:http limit 50 - limit connections via this pool to the specified member to 50

Bigpipe Usage Notes

Don't forget to save your changes using the bigpipe save all command.

Note in most cases, the show keyword displays object status or statistics, the list keyword displays configuration.

The bigpipe command can be abbreviated to just b (e.g. b help instead of bigpipe help.) Alternatively, (from v9.4,) you can use the bigpipe shell to enter commands without prefixing them with bigpipe.

Where curly or normal brackets {} or () or quotes "" or exclamation mark ! are required as part of a command and you are not using the bigpipe shell, they must be proceeded with a back slash \ to prevent the bash shell from parsing them as system commands.

Typical Output

bigpipe pool;

POOL POOL_ONE  LB METHOD round robin   MIN/CUR ACTIVE MEMBERS 0/4
|     (cur, max, limit, tot) = (45, 114, 0, 156213)
|     (pkts,bits) in = (8.420M, 14.09G), out = (13.61M, 142.9G)
+-> POOL MEMBER POOL_ONE/10.11.12.20:http   active,up
|   |     session enabled    priority 1    ratio 1
|   |     (cur, max, limit, tot) = (13, 31, 0, 42432)
|   |     (pkts,bits) in = (2.350M, 4.003G), out = (3.795M, 39.68G)
|   |     requests (total) = 222462
+-> POOL MEMBER POOL_ONE/10.11.12.20:http   active,up
|   |     session enabled    priority 1    ratio 1
|   |     (cur, max, limit, tot) = (7, 27, 0, 37217)
|   |     (pkts,bits) in = (1.951M, 3.272G), out = (3.148M, 33.03G)
|   |     requests (total) = 177001

Related Commands

Use the bigpipe node command to create nodes which will become pool members. While not strictly necessary, this allows you to assign 'friendly' names to pool members and specify other non-pool specific parameters such as node level monitors, node state, ratio and absolute connection limit.

Command Equivalents

The Cisco CSS equivalent command is the service command

We really do appreciate all feedback so please do send your comments, suggestions or corrections to steve#networkstuff.eu (replacing the # with an @)