GSLB Examples

This section contains examples for GSLB (Global Server Load Balancing), which requires the BIG-IP DNS (formerly GTM) module to be licensed and provisioned.

Configuring global GSLB settings in a declaration

In this example, we show how you can configure global GSLB settings in BIG-IP DO 1.17 and later using the GSLBGlobals class. This class uses the GSLBGlobals_general properties (synchronizationEnabled synchronizationGroupName, synchronizationTimeout, and synchronizationTimeTolerance) to configure GSLB global settings on the BIG-IP.

For more details on the properties and BIG-IP DO usage, see GSLBGlobals and GSLBGlobals_general in the Schema Reference.

For information on BIG-IP DNS, see the DNS/GTM knowledge center for your BIG-IP version.

This example only includes the GSLBGlobals class, which can be used as a part of a larger BIG-IP DO declaration.

Configuring a GSLB Data Center

In this example, we show how you can configure a GSLB Data Center in BIG-IP DO 1.18 and later using the GSLBDataCenter class. This allows you to configure GSLB Data Center properties in a BIG-IP Declarative Onboarding declaration.

All of the resources on your network are associated with a data center. BIG-IP DNS consolidates the paths and metrics data collected from the servers, virtual servers, and links in the data center. BIG-IP DNS uses that data to conduct load balancing and route client requests to the best-performing resource based on different factors. For information on BIG-IP DNS, including GSLB Data Centers, see the DNS/GTM knowledge center for your BIG-IP version.

For details on the available properties and BIG-IP DO usage, see GSLBDataCenter in the Schema Reference.

This example only includes the GSLBDataCenter class, which can be used as a part of a larger BIG-IP DO declaration.

Configuring a GSLB Server

In this example, we show how you can configure a GSLB Server in BIG-IP DO 1.18 and later using the GSLBServer class. This allows you to configure GSLB Server properties in a BIG-IP Declarative Onboarding declaration.

A GSLB Server defines a physical system on the network. Servers contain the virtual servers that are the ultimate destinations of DNS name resolution requests. For information on BIG-IP DNS, including GSLB Servers, see the DNS/GTM knowledge center for your BIG-IP version.

BIG-IP DO 1.19 added support for Prober pools and GSLB virtual servers to GSLB Servers. For information on Prober pools, see Configuring a GSLB prober pool.
For information on GSLB virtual servers, see the Global Server Load Balancing chapter of the documentation. For BIG-IP DO options and usage, see GSLBServer-virtualServers.

For details on the available properties and BIG-IP DO usage, see GSLBServer in the Schema Reference.

Important

Because this example was updated to include a Prober pool and GSLB virtual servers, if you attempt to use the following declaration on a previous version of BIG-IP DO, it will fail. If you are using a version prior to 1.19, you can remove the Prober pool and virtual server lines (in yellow).

Configuring GSLB health monitors

In this example, we show how you can configure a GSLB health monitors in a BIG-IP Declarative Onboarding declaration. Health monitors verify the availability and/or performance status of a particular protocol, service, or application. You can configure HTTP, HTTPS, Gateway-ICMP, TCP, or UDP GSLB health monitors in a declaration.

For information on BIG-IP DNS, including GSLB monitors, see the DNS/GTM knowledge center for your BIG-IP version.

For details on the available properties and BIG-IP DO usage, see GSLBMonitor in the Schema Reference.

Note

GSLB Monitor has a number of built-in monitors, such as http and http_head_f5. You cannot use these names in a declaration or it will fail. These default monitors cannot be deleted.

This example includes each of the available GSLB monitors which you can use as part of a larger BIG-IP Declarative Onboarding declaration. In this declaration, the monitors are all used in the GSLB Server (see the GSLB Server example).

Configuring a GSLB prober pool

In this example, we show how you can configure a GSLB prober pool in a BIG-IP Declarative Onboarding declaration. Prober pools contain specific BIG-IP devices that probe data centers and servers.

For more information on Prober pools, including manual configuration, see K08433560: Configuring prober pools.

For details on the available properties and BIG-IP DO usage, see GSLBProberPool in the Schema Reference.