Open topic with navigation

GeoCluster and GeoSite Instance Commands

Envoy provides cluster load balancing between FortiADCs running at two or more geographically distributed locations -- called GeoSites. Each GeoSite is configured with a cluster that is capable of responding to requests for the same content. A GeoCluster is a collection of GeoSites that act together to determine the “best” GeoSite to respond to a particular request.

Envoy works together with special entries in the Domain Name System (DNS) configuration of the authoritative name server for a website.

Both GeoClusters and GeoSites are top-level objects in the CLI. In general:

1. Create a GeoCluster for your website (see below).
2. Create GeoSites
3. Add GeoSite Instances to GeoClusters (see below).

Using GeoCluster commands in the global context:

Using GeoCluster Commands in the Global Context
eqcli > geocluster gcname req_cmds	:	Create geocluster (see below for cmds)
eqcli > geocluster gcname cmds	:	Modify geocluster (see below for cmds)
eqcli > no geocluster gcname	:	Delete geocluster
eqcli > show geocluster	:	Display geocluster summary
eqcli > show geocluster gcname	:	Display geocluster details
eqcli > geocluster gcname	:	Change context to “gcl-gcname"

GeoCluster context commands:

GeoCluster Context Commands
eqcli gcl-gclname> flags {[!]icmp}	:	geocluster flags
eqcli gcl-gclname> fqdnfqdn name	:	FQDN for the geocluster website
eqcli gcl-gclname> gsi gsiname	:	Change to the geosite instance context
eqcli gcl-gclname> gsi gsiname cmds	:	Execute geosite instance commands
eqcli gcl-gclname> mx	:	Set the GeoCluster Mail Exchange FQDN.
eqcli gcl-gclname> mrmax	:	Maximum number of allowable resource records that will be returned in a DNS response
eqcli gcl-gclname> policy policy	:	GeoCluster Load Balancing policy
eqcli gcl-gclname> stats	:	Display the statistics for the GeoCluster.
eqcli gcl-gclname> respv integer	:	Load balancing policy responsiveness
eqcli gcl-gclname> ttl integer	:	DNS cache lifetime for Envoy responses

Using Geosite Instance commands in the global context:

Using Geosite Instance Commands in the Global Context
eqcli > geocluster gclname gsi gsiname req_cmds	:	Create a geosite instance
eqcli > geocluster gclname gsi gsiname cmds	:	Modify a geosite instance
eqcli > no geocluster gclname gsi gsimaname	:	Delete a geosite instance
eqcli > show geocluster gsi	:	Display geosite instance summary
eqcli > show geocluster gclname gsi	:	Display geosite instance details
eqcli > cluster clname match maname	:	Change to geosite instance context

Geosite Instance context commands:

Geosite Instance Context Commands
eqcli gcl-gclname-gsi-gsiname> load_weight	:	GeoSite Instance weight (0-200)
eqcli gcl-gclname-gsi-gsiname> flags     [!]default,[!]disable,     [!]hot_spare,[!]preferred}

GeoCluster flags can be either icmp (enable ICMP triangulation) or autof (automatic fallback). [The autof option is not yet implemented.]

Geosite Instance Flags

A flag may be turned off by prefixing with "!".