Fortinet white logo
Fortinet white logo

CLI Reference

config global-load-balance host

config global-load-balance host

Use this command to create host configurations. Host settings are used to form the zone configuration and resource records in the generated DNS zone used for global load balancing.

Before you begin:

  • You must have created the global virtual server pools you want to use.
  • You must have read-write permission for global load balancing settings.

After you have created a host configuration object, it can be used to form the zone and resource records in the generated DNS zone configuration.

Syntax

config global-load-balance host

edit <name>

set domain-name <string>

set host-name <string>

set response-single-record {enable|disable}

set persistence {enable|disable}

set default-feedback-ip <ip>

set default-feedback-ip6 <ip>

set load-balance-method {global availability|none|topology}

config virtual-server-pool-list

edit <No.>

set virtual-server-pool <string>

next

end

next

end

domain-name

The domain name must end with a period. For example: example.com.

host-name

The hostname part of the FQDN, such as www.

Note: You can specify the @ symbol to denote the zone root. The value substituted for @ is the preceding $ORIGIN directive.

respond-single-record

Enable/disable an option to send only the top record in response to a query. Disabled by default. By default, the response is an ordered list of records.

persistence

Enable/disable the persistence table. Disabled by default.

If you enable persistence, the client source address is recorded in the persistence table, and subsequent requests from the same network or the same host or domain are sent an answer with the virtual servers listed in the same order (unless a server becomes unavailable and is therefore omitted from the answer).

default-feedback-ip

Specify an IP address to return in the DNS answer if no virtual servers are available.

default-feedback-ip6

Specify an IPv6 address to return in the DNS answer if no virtual servers are available.

load-balance-method

Specify a virtual server pool selection method. Set to "weight" by default.

virtual-server-pool

Specify a virtual server pool configuration object to host, i.e., a virtual server pool name, location list (optional), and/or ISP (optional).

Example

FortiADC-VM # config global-load-balance host

FortiADC-VM (host) # edit www_fadc_com

Add new entry 'www_fadc_com' for node 2869

FortiADC-VM (www_fadc_com) # get

host-name :

domain-name :

respond-single-record : disable

persistence : disable

load-balance-method : weight

default-feedback-ip : 0.0.0.0

default-feedback-ip6 : ::

FortiADC-VM (www_fadc_com) # set host-name www

FortiADC-VM (www_fadc_com) # set domain-name fadc.com

FortiADC-VM (www_fadc_com) # config virtual-server-pool-list

FortiADC-VM (virtual-server~p) # edit "1"

FortiADC-VM (1) # set virtual-server-pool test

FortiADC-VM (1) # next

FortiADC-VM (virtual-server~p) # end

FortiADC-VM (www_fadc_com) # end

config global-load-balance host

config global-load-balance host

Use this command to create host configurations. Host settings are used to form the zone configuration and resource records in the generated DNS zone used for global load balancing.

Before you begin:

  • You must have created the global virtual server pools you want to use.
  • You must have read-write permission for global load balancing settings.

After you have created a host configuration object, it can be used to form the zone and resource records in the generated DNS zone configuration.

Syntax

config global-load-balance host

edit <name>

set domain-name <string>

set host-name <string>

set response-single-record {enable|disable}

set persistence {enable|disable}

set default-feedback-ip <ip>

set default-feedback-ip6 <ip>

set load-balance-method {global availability|none|topology}

config virtual-server-pool-list

edit <No.>

set virtual-server-pool <string>

next

end

next

end

domain-name

The domain name must end with a period. For example: example.com.

host-name

The hostname part of the FQDN, such as www.

Note: You can specify the @ symbol to denote the zone root. The value substituted for @ is the preceding $ORIGIN directive.

respond-single-record

Enable/disable an option to send only the top record in response to a query. Disabled by default. By default, the response is an ordered list of records.

persistence

Enable/disable the persistence table. Disabled by default.

If you enable persistence, the client source address is recorded in the persistence table, and subsequent requests from the same network or the same host or domain are sent an answer with the virtual servers listed in the same order (unless a server becomes unavailable and is therefore omitted from the answer).

default-feedback-ip

Specify an IP address to return in the DNS answer if no virtual servers are available.

default-feedback-ip6

Specify an IPv6 address to return in the DNS answer if no virtual servers are available.

load-balance-method

Specify a virtual server pool selection method. Set to "weight" by default.

virtual-server-pool

Specify a virtual server pool configuration object to host, i.e., a virtual server pool name, location list (optional), and/or ISP (optional).

Example

FortiADC-VM # config global-load-balance host

FortiADC-VM (host) # edit www_fadc_com

Add new entry 'www_fadc_com' for node 2869

FortiADC-VM (www_fadc_com) # get

host-name :

domain-name :

respond-single-record : disable

persistence : disable

load-balance-method : weight

default-feedback-ip : 0.0.0.0

default-feedback-ip6 : ::

FortiADC-VM (www_fadc_com) # set host-name www

FortiADC-VM (www_fadc_com) # set domain-name fadc.com

FortiADC-VM (www_fadc_com) # config virtual-server-pool-list

FortiADC-VM (virtual-server~p) # edit "1"

FortiADC-VM (1) # set virtual-server-pool test

FortiADC-VM (1) # next

FortiADC-VM (virtual-server~p) # end

FortiADC-VM (www_fadc_com) # end