gtm wideip a
gtm wideip a(1) BIG-IP TMSH Manual gtm wideip a(1)
NAME
a - Configures a wide IP that accepts A queries.
MODULE
gtm wideip
SYNTAX
Configure the wideip a component within the gtm module using the syntax
shown in the following sections.
CREATE/MODIFY
create wideip a [name]
modify wideip a [name]
options:
aliases [name...name]
app-service [[string] | none]
description [string]
[disabled | enabled]
failure-rcode [formerr | noerror | notimpl | nxdomain | refused | servfail]
failure-rcode-ttl [integer]
failure-rcode-response [disabled | enabled]
last-resort-pool [type name]
load-balancing-decision-log-verbosity [[pool-member-selection | pool-member-traversal | pool-selection | pool-traversal] | none]
minimal-response [disabled | enabled]
metadata none
metadata
[add | delete | modify | replace-all-with] {
[metadata_name ... ] {
persist [ true | false ]
value [ "value content" ]
}
}
persistence [disabled | enabled]
persist-cidr-ipv4 [integer]
persist-cidr-ipv6 [integer]
pool-lb-mode [global-availability | ratio | round-robin | topology]
pools none
pools
[add | delete | modify | replace-all-with] {
[pool name]...
}
pools-cname none
pools-cname
[add | delete | modify | replace-all-with] {
[pool name]...
}
rules none
rules {
[rule name]
...
}
topology-prefer-edns0-client-subnet [disabled | enabled]
ttl-persistence [integer]
edit wideip a [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
reset-stats wideip a
reset-stats wideip a [ [name] | [glob] | [regex] ] ... ]
DISPLAY
list wideip a
list wideip a [ [name] | [glob] | [regex] ] ... ]
show running-config wideip a
show running-config wideip a [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
one-line
partition
show wideip a
show wideip a [ [ [name] | [glob] | [regex] ] ... ]
options:
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
(detail | global)
field-fmt
DELETE
delete wideip a [all | [name] ]
DESCRIPTION
You can use the wideip component to create, modify, display, or delete
a wide IP that responds to A queries. An A wide IP is a mapping of a
fully-qualified domain name (FQDN) to a set of IPv4 virtual servers
that host the domain's content, such as a web site or an e-commerce
site.
EXAMPLES
create wideip a www.my_wide_ip.com
Creates a wide IP named www.my_wide_ip.com.
delete wideip a www.my_wide_ip.com
Deletes the wide IP named www.my_wide_ip.
OPTIONS
aliases
Specifies alternate domain names for the web site content you are
load balancing. You can use two different wildcard characters,
asterisk (*) and question mark (?), to represent one or more
characters. The default value is none.
app-service
Specifies the name of the application service to which this wide
ip belongs. The default value is none. Note: If the strict-updates
option is enabled on the application service that owns the object,
you cannot modify or delete this wide ip. Only the application
service can modify or delete this wide ip.
description
User defined description. Note: Advanced search on the GUI's
Wideip list page can be turned on/off by modifying the DB variable
ui.advancedsearch via the tmsh command "modify sys db
ui.advancedsearch value true/false". This will result in a new
description column and the inclusion of that field in the search.
[disabled | enabled]
Specifies whether the wide IP and its resources are available for
load balancing.
failure-rcode
Specifies the DNS RCODE used when failure-rcode-response is
enabled. Default is noerror. Options include noerror (no type
exists at this name), formerr (format error in query), servfail
(unable to process query), nxdomain (name does not exist), notimpl
(no support for this kind of query), and refused (refuse to
process based on policy). If failure-rcode-ttl is non-zero, only
the Authority section of the noerror or nxdomain response will
include a SOA record.
failure-rcode-response
When enabled, specifies that the system returns a RCODE response
to Wide IP requests after exhausting all load-balancing methods.
This response is an authoritative empty answer from the system to
A record requests. With this option enabled, the system responds
faster to A requests for which it does not have A records
configured. The default value is disabled.
failure-rcode-ttl
Specifies the negative caching TTL of the SOA for the RCODE
response. The default is 0, meaning no SOA is included (i.e. no
caching).
glob Displays the items that match the glob expression. See help glob
for a description of glob expression syntax.
last-resort-pool
Specifies a last resort pool to use when load balancing requests
for this wide IP. Any A or CNAME pool type is allowed. The default
value is none.
load-balancing-decision-log-verbosity
Specifies the amount of detail logged when making load balancing
decisions. This is used for debugging purpose only. Performance
will be affected if the value is not none. Please reset it back to
none after done debugging. With the option pool-selection, the log
will contain pool load balancing algorithm details. This includes
common actions taken to a set of pools (for example, whether all
pools reset the ratio counter during the algorithm) and the result
of the load balancing algorithm (for example, whether a pool is
finally selected and the reason if applicable). With the option
pool-traversal, the log will contain details of all pools
traversed during load balancing. With the option pool-member-
selection, the log will contain pool member load balancing
algorithm details. This includes common actions taken to a set of
pool members and the result of the load balancing algorithm. With
the option pool-member-traversal, the log will contain details of
all pool members traversed during load balancing. The default
value is none.
minimal-response
Specifies GTM will form the smallest allowable DNS response to a
query. Typically, this will be a single resource record in the
answer section. When set to disabled, GTM will attempt to chase
CNAME chains, if required, to obtain the ultimate answer, and it
will attempt to add address resource records to the additional
section of the response for each answer when needed. The default
value is enabled.
metadata
Specifies user-defined data to associate with a server. By default
the persist attribute is set to true. This means the data is saved
into the configuration file.
name Specifies a unique name for the component. This option is required
for the commands create and modify.
partition
Displays the administrative partition within which the component
resides.
persistence
When enabled, specifies that when a local DNS server makes
repetitive requests on behalf of a client, the system reconnects
the client to the same resource as previous requests. The default
value is disabled.
persist-cidr-ipv4
Specifies a mask used to group IPv4 LDNS addresses. This feature
allows one persistence record to be shared by LDNS addresses that
match within this mask.
persist-cidr-ipv6
Specifies a mask used to group IPv6 LDNS addresses. This feature
allows one persistence record to be shared by LDNS addresses that
match within this mask.
pools
Configures the pools the system uses when load balancing requests
for this wide IP. The default value is none.
pools-cname
Configures the CNAME pools the system uses when load balancing
requests for this wide IP. The default value is none.
pool-lb-mode
Specifies the load balancing method used to select a pool in this
wide IP. This option is relevant only when multiple pools are
configured for this wide IP. The default value is round-robin.
The available load balancing methods are:
global-availability
Specifies that the system selects a pool by following the
order of the Pool list. The system repeatedly selects the
first pool in the list for as long as its status is
available. If the pool becomes unavailable for any reason,
the system then repeatedly selects the next pool in the list,
and so on.
ratio
Specifies that the system selects a pool based on the ratio
that you assign to the pool.
round-robin
Specifies that the system selects pools sequentially.
topology
Specifies that the system selects a pool based on topology
information in the incoming LDNS request. Note that this load
balancing method works only if you have configured a topology
statement.
regex
Displays the items that match the regular expression. The regular
expression must be preceded by an at sign (@[regular expression])
to indicate that the identifier is a regular expression. See help
regex for a description of regular expression syntax.
rules
Specifies the iRules(r) that this wide IP uses for load balancing
decisions. 'when' clauses for each event are grouped across all
iRules(r) on this wide IP. For each event, clauses are evaluated
in the listed rules order. The default value is none.
ttl-persistence
Specifies, in seconds, the length of time for which a persistence
entry is valid. This value can range from 0 through 4294967295
seconds. The default value is 3600.
topology-prefer-edns0-client-subnet
Specifies, when set to enabled, that this wide IP should use the
edns0 client subnet option (if one exists) instead of the source
address when using topology load balancing. When this option is
set to disabled or if the query did not contain a client subnet
option, the system will fall back to the source address.
This setting has no effect when the global setting, configured
under gtm global-settings load-balancing
topology-prefer-edns0-client-subnet [disabled | enabled], is set
to enabled. When either setting is enabled then this feature will
be enabled.
SEE ALSO
create, delete, edit, glob, gtm pool, list, modify, regex, reset-stats,
show, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or
by any means, electronic or mechanical, including photocopying,
recording, or information storage and retrieval systems, for any
purpose other than the purchaser's personal use, without the express
written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2008-2016. All rights reserved.
BIG-IP 2017-09-28 gtm wideip a(1)