Manual Chapter : Managing Pool Pool Members

Applies To:

Show Versions Show Versions

BIG-IQ Centralized Management

  • 7.0.0, 6.1.0
Manual Chapter

Managing Pool & Pool Members

How do I change object settings on a managed device?

To change the object settings on a managed device, there are four tasks to perform.

This figure illustrates the workflow you perform to manage the objects on BIG-IP® devices. Changing the settings is the second step in this process.

Workflow for changing object settings on a managed device

Change managed object workflow

What pool and pool member management tasks can I perform?

There are a number of ways you can use BIG-IQ® Centralized Management to manage the pools and pool members on your managed BIG-IP devices:

  • Create a new pool or pool member.
  • Modify an existing pool or pool member.
  • View statistics for a pool.
  • Deploy the pool and pool member immediately to your managed device; for pool members, you can enable, disable, or force offline immediately.
    Note: You (or someone else) can also deploy your changes later. For more information about managing changes, look on support.F5.com in F5 BIG-IQ Centralized Management: Device for the topic: Deploying Changes.
  • Add or remove permissions for a pool or pool member and assign them to roles that have been defined on this BIG-IQ system. For more information about managing permissions, look on support.F5.com in F5 BIG-IQ Centralized Management: Authentication, Roles, and User Management.

Create a new pool

You can use the BIG-IQ Local Traffic interface to add a pool to a managed device.
Important: When revising configurations on devices that belong to a high availability cluster, it is important to let the changes synchronize to the cluster members instead of trying to make the same changes to multiple devices. If you try to replicate changes you made on one device in the cluster, the next config sync attempt could fail.
Note: This is a shared object. Shared objects do not deploy to a device unless they are attached to a device specific object. The table lists device specific and shared objects. When you create a shared object, remember that you must associate it with a device specific object before it can deploy to a device.
Device Specific Objects Shared Objects
Node Certificates and Keys
Pool Eviction Policies
SNAT Pool iRules
Virtual Server Monitors
  Profiles
  1. At the top of the screen, click Configuration, then, on the left, click LOCAL TRAFFIC > Pools .
    The screen displays the list of pools defined on this device.
  2. Click Create.
    The New Pool screen opens.
  3. In the Name field, type in a name for the pool you are creating.
  4. From the Device list, select the device on which to create the pool.
  5. Specify the additional settings needed to suit the requirements for this pool.
    The remaining parameters on this screen are optional and perform the same function as they do when you configure a pool on a BIG-IP device.
    Note: For details about the purpose or function of a particular setting, refer to the BIG-IP reference information on support.f5.com.
  6. To add a new pool member for this pool, click New Member.
    1. Specify the Node Type:
    2. If you want the new member to be an existing BIG-IP node, select Existing Node and then select the Node.
    3. If you want the new member to be identified by an IP address, select New Node and then type the Node Name and Node Address for the node.
    4. For the Port, type the service port for the pool member.
    5. Specify the additional settings needed to suit the requirements for this pool member.
      The remaining parameters on this screen are optional and perform the same function as they do when you configure a pool member on a BIG-IP device.
      Note: For details about the purpose or function of a particular setting, refer to the BIG-IP reference information on support.f5.com.
    6. When you finish specifying the settings for this pool member, click Save & Close.
    The new pool member is added to the specifications for the pool you are creating.
    Note: When you create a new pool member while creating a new pool, the new pool member is not actually created until you save the new pool. When you create a new pool member for an existing pool member, the new member is ready to use as soon as you save it.
  7. When you finish specifying the settings for this pool, click Save & Close.
    The system creates the new pool with the settings you specified.

Create a new pool member

You can use the BIG-IQ Local Traffic interface to add a pool member to a pool.
Note: This is a shared object. Shared objects do not deploy to a device unless they are attached to a device specific object. The table lists device specific and shared objects. When you create a shared object, remember that you must associate it with a device specific object before it can deploy to a device.
Device Specific Objects Shared Objects
Node Certificates and Keys
Pool Eviction Policies
SNAT Pool iRules
Virtual Server Monitors
  Profiles
  1. At the top of the screen, click Configuration, then, on the left, click LOCAL TRAFFIC > Pool Members .
    The screen displays the list of pool members defined on this device.
  2. Click the name of the pool to which you are going to add a new member.
    The properties screen for that pool opens.
  3. Near the bottom of the screen, click the New Member button.
    The New Pool screen opens.
  4. Specify the Node Type:
    • If you want the new member to be an existing BIG-IP node, select Existing Node and then select the Node.
    • If you want the new member to be identified by an IP address, select New Node and then type the Node Name and Node Address for the node.
  5. For the Port, type the service port for the pool member.
  6. Specify the additional settings needed to suit the requirements for this pool member.
    The remaining parameters on this screen are optional and perform the same function as they do when you configure a pool member on a BIG-IP device.
    Note: For details about the purpose or function of a particular setting, refer to the BIG-IP reference information on support.f5.com.
  7. When you finish specifying the settings for this pool member, click Save & Close.
  8. Click Save & Close.
    The system creates the new pool member with the settings you specified.

How do I delegate pool member management tasks?

BIG-IQ® Centralized Management makes it straightforward for you to delegate users permissions (enable, disable, or force offline) that allow them to manage pool members only for the specific pools you assign to them.

To provide enable, disable, and force offline permissions for a specific set of pool members, you need to perform three tasks. For the sake of explanation, consider an example scenario in which you have 10 pools that service your Alaska clients and you want to delegate management authority for the pool members in those pools. Here are the tasks you would perform:

  1. Add a custom resource group and assign pools to it - in this task, you specify the pools that you want your delegate to manage and name the resource group (for example, Alaska Services Pools).
  2. Add a custom role - when you create a role you specify a role type and associate it with a resource group. The role type defines the permissions, and the resource group defines the objects to which those permissions apply.
    • You name the new role something intuitive (for example: Alaska Services Pool Manager).
    • You assign the built in role type named Pool Member Operator. This role has all the permissions (enable , disable, and force offline) needed, so you do not need a custom role.
    • Assign the role to the Alaska Services Pools resource group you just created.
  3. Add a custom user - Finally, you create a user and assign them the Alaska Services Pool Manager role. Users who log in with this user name will have the permissions (defined by the role type) and access scope (defined by the resource group) to manage the pool members that belong to the 10 pools in the Alaska Services Pools resource group.

For step by step guidance on each of these tasks, refer to How do I give users customized permissions to specific BIG-IP resources based on their job responsibilities? on support.f5.com

Create a new node

You can use the BIG-IQ Local Traffic interface to add a node to a managed device.

Nodes are the basis for creating a load balancing pool. For any server that you want to be part of a load balancing pool, you must first create a node, that is, designate that server as a node. After designating the server as node, you can add the node to a pool as a pool member. You can also associate a health monitor with the node, to report the status of that server.

Important: When revising configurations on devices that belong to a high availability cluster, it is important to let the changes synchronize to the cluster members instead of trying to make the same changes to multiple devices. If you try to replicate changes you made on one device in the cluster, the next config sync attempt could fail.
  1. At the top of the screen, click Configuration, then, on the left, click LOCAL TRAFFIC > Nodes .
    The screen displays the list of nodes defined on this device.
  2. Click Create.
    The New Node screen opens.
  3. In the Name field, type in a name for the node you are creating.
  4. From the Device list, select the device on which to create the node.
  5. For the Address field, type in the IP address that identifies the new node.
  6. Specify the additional settings needed to suit the requirements for this node.
    The remaining parameters on this screen are optional and perform the same function as they do when you configure a node on a BIG-IP device.
    Note: For details about the purpose or function of a particular setting, refer to the BIG-IP reference information on support.f5.com.
  7. Click Save & Close.
    The system creates the new node with the settings you specified.

Change settings for a pool

Using the BIG-IQ user interface to make revisions to your pool configurations simplifies managing your devices.
Important: If you revise configurations on devices that belong to a high availability cluster, the system synchronizes BIG-IQ cluster members automatically when you deploy the change. Do not try to make the same changes to multiple devices. If you try to replicate changes you made on one device in the cluster, the next config sync attempt could fail.
  1. At the top of the screen, click Configuration, then, on the left, click LOCAL TRAFFIC > Pools .
    The screen displays the list of pools defined on this device.
  2. Click the name of the pool that you want to change.
    If you select the check box for the pool instead of the name, you can either delete or deploy the pool, or you can view statistics for the pool.
    The Properties screen for the pool opens.
  3. Make changes to the pool properties you want to modify.
    Note: For detailed information on the impact of using a particular pool parameter value, refer to the BIG-IP Local Traffic Manager: Implementations on support.f5.com. For the most comprehensive detail, use the work flow that best matches the purpose of the pool you are configuring.
  4. You can expand the Advanced Properties area and make additional pool parameter changes.
    Note: For detailed information on the impact of using a particular pool parameter value, refer to the BIG-IP Local Traffic Manager: Implementations on support.f5.com. For the most comprehensive detail, use the work flow that best matches the purpose of the pool you are configuring.
  5. To make revisions to the permissions associated with this pool, on the left, click Permissions.
    Note: For detailed information about managing permissions, refer to How do I limit privileges for users based on their specific role in the company? or How do I give users customized permissions to specific BIG-IP resources based on their job responsibilities?? in F5 BIG-IQ Centralized Management: Authentication, Roles, and User Management on support.f5.com.
  6. When you are satisfied with the changes you have made to the pool, click Save & Close.
    The revisions you saved are made, and the Properties or Permissions screen for the pool closes.
Changes that you make to pools or pool members are made only to the pending version. The pending version serves as a repository for changes you stage before deploying them to the managed device. Object settings for the pending version are not the same as the object settings on the actual BIG-IP device until they are deployed or discarded.
To apply the working configuration settings to the BIG-IP device, you now need to deploy the revisions.

Change settings for a pool member

Using the BIG-IQ user interface to make revisions to your pool member configurations simplifies managing your devices.
Important: If you revise configurations on devices that belong to a high availability cluster, the system synchronizes BIG-IQ cluster members automatically when you deploy the change. Do not try to make the same changes to multiple devices. If you try to replicate changes you made on one device in the cluster, the next config sync attempt could fail.
  1. At the top of the screen, click Configuration, then, on the left, click LOCAL TRAFFIC > Pool Members .
    The screen displays the list of pool members defined on this device.
  2. Click the name of the pool member that you want to change.
    If you select the check box for the pool member instead of the name, you can either enable, disable or force the pool member offline.
    The Properties screen for the pool member opens.
  3. Make changes to the pool member properties you want to modify.
    Note: For detailed information about managing permissions for this pool member, refer to How do I limit privileges for users based on their specific role in the company? or How do I give users customized permissions to specific BIG-IP resources based on their job responsibilities? in F5 BIG-IQ Centralized Management: Authentication, Roles, and User Management on support.f5.com.
  4. When you are satisfied with the changes you have made to the pool member, click Save & Close.
    The revisions you saved are made, and the Properties or Permissions screen for the pool member closes.
Changes that you make to pool members are made only to the pending version. The pending version serves as a repository for changes you stage before deploying them to the managed device. Object settings for the pending version are not the same as the object settings on the actual BIG-IP device until they are deployed or discarded.
To apply the working configuration settings to the BIG-IP device, you now need to deploy the revisions.

Make bulk changes to a set of pool members

Your must have been granted read/write access to the pool this set of pool members belongs to before you can make changes to those pool members.
Using the BIG-IQ user interface to enable, disable, or force offline a group of pool members simplifies managing your devices.
Important: If you revise configurations on devices that belong to a high availability cluster, the system synchronizes BIG-IQ cluster members automatically when you deploy the change. Do not try to make the same changes to multiple devices. If you try to replicate changes you made on one device in the cluster, the next config sync attempt could fail.
  1. At the top of the screen, click Configuration, then, on the left, click LOCAL TRAFFIC > Pool Members .
    The screen displays the list of pool members defined on this device.
  2. Select the check box for the pool members that you want to change.
  3. Click the button for the bulk action you want to take (Enable, Disable, or Force Offline).
  4. When you change the state for a pool member, a prompt displays. You have three response options to this prompt.
    • If you want the change to occur immediately, click Change Now.
    • If you want the change to occur later, click Change Later. You can then evaluate and deploy the state change at a more convenient time.
    • If you decide not to make the change at all, click Cancel.
  • When you click Change Now, it triggers an immediate deployment to the devices that house the impacted pool members.
  • When you click Change Later, changes that you make to pool members are made only to the pending version. The pending version serves as a repository for changes you stage before deploying them to the managed device. Object settings for the pending version are not the same as the object settings on the actual BIG-IP device until they are deployed or discarded.

Create a new SNAT pool

You can use the BIG-IQ Local Traffic interface to add a SNAT pool to a managed device.

Important: When revising configurations on devices that belong to a high availability cluster, it is important to let the changes synchronize to the cluster members instead of trying to make the same changes to multiple devices. If you try to replicate changes you made on one device in the cluster, the next config sync attempt could fail.
  1. At the top of the screen, click Configuration, then, on the left, click LOCAL TRAFFIC > SNAT Pools .
    The SNAT Pools screen displays a list of SNAT translation members defined on this device.
  2. Click Create.
    The New SNAT Pool screen opens.
  3. In the Name field, type a name for the SNAT pool you are creating.
  4. From the Device list, select the device on which to create the SNAT pool.
  5. In the Member List, type the IP address of the first SNAT translation member you want to include in the SNAT pool.
    Use the + button to add more members, or you can use the x button to delete a member.
  6. In the Partition field, type the name of the partition in which you want to create this SNAT pool.
    An administrative partition is a logical container that you create that contains a defined set of BIG-IP system objects. If you enter a partition name that does not exist, you get an error when you try to deploy this SNAT pool.
  7. Click Save & Close.
    The system creates the new SNAT pool with the settings you specified.