ANSIBLE.BIGIP_POOL(3)           ANSIBLE MODULES          ANSIBLE.BIGIP_POOL(3)



NAME
       bigip_pool - Manages F5 BIG-IP LTM pools

DESCRIPTION
       Manages F5 BIG-IP LTM pools via iControl SOAP API

OPTIONS
       host   Pool member IP

       lb_method
              Load balancing method Choices:
              round_robin,ratio_member,least_connection_member,observed_member,predictive_member,ratio_node_address,least_connection_node_address,fastest_node_address,observed_node_address,predictive_node_address,dynamic_ratio,fastest_app_response,least_sessions,dynamic_ratio_member,l3_addr,unknown,weighted_least_connection_member,weighted_least_connection_node_address,ratio_session,ratio_least_connection_member,ratio_least_connection_node_address.
              (default: round_robin)(Added in Ansible version 1.3.)


       monitor_type
              Monitor rule type when monitors > 1 Choices:
              and_list,m_of_n.(Added in Ansible version 1.3.)


       monitors
              Monitor template name list. Always use the full path to the
              monitor.(Added in Ansible version 1.3.)


       name   Pool name(required)

       partition
              Partition of pool/pool member (default: Common)

       password
              BIG-IP password(required)

       port   Pool member port

       quorum Monitor quorum value when monitor_type is m_of_n(Added in
              Ansible version 1.3.)


       server BIG-IP host(required)

       service_down_action
              Sets the action to take when node goes down in pool Choices:
              none,reset,drop,reselect.(Added in Ansible version 1.3.)


       slow_ramp_time
              Sets the ramp-up time (in seconds) to gradually ramp up the load
              on newly added or freshly detected up pool members(Added in
              Ansible version 1.3.)


       state  Pool/pool member state Choices: present,absent. (default:
              present)

       user   BIG-IP username(required).

NOTES
       Requires BIG-IP software version >= 11

       F5 developed module 'bigsuds' required (see http://devcentral.f5.com)

       Best run as a local_action in your playbook

EXAMPLES
       ## playbook task examples:

       ---
       # file bigip-test.yml
       # ...
       - hosts: localhost
         tasks:
         - name: Create pool
           local_action: >
             bigip_pool
             server=lb.mydomain.com
             user=admin
             password=mysecret
             state=present
             name=matthite-pool
             partition=matthite
             lb_method=least_connection_member
             slow_ramp_time=120

         - name: Modify load balancer method
           local_action: >
             bigip_pool
             server=lb.mydomain.com
             user=admin
             password=mysecret
             state=present
             name=matthite-pool
             partition=matthite
             lb_method=round_robin

       - hosts: bigip-test
         tasks:
         - name: Add pool member
           local_action: >
             bigip_pool
             server=lb.mydomain.com
             user=admin
             password=mysecret
             state=present
             name=matthite-pool
             partition=matthite
             host="{{ ansible_default_ipv4["address"] }}"
             port=80

         - name: Remove pool member from pool
           local_action: >
             bigip_pool
             server=lb.mydomain.com
             user=admin
             password=mysecret
             state=absent
             name=matthite-pool
             partition=matthite
             host="{{ ansible_default_ipv4["address"] }}"
             port=80

       - hosts: localhost
         tasks:
         - name: Delete pool
           local_action: >
             bigip_pool
             server=lb.mydomain.com
             user=admin
             password=mysecret
             state=absent
             name=matthite-pool
             partition=matthite




AUTHOR
       Matt Hite

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#bigip-pool



1.4.5                             2014-02-12             ANSIBLE.BIGIP_POOL(3)
