gtm wideip aaaa
gtm wideip aaaa(1) BIG-IP TMSH Manual gtm wideip aaaa(1)
NAME
aaaa - Configures a wide IP that accepts AAAA queries.
MODULE
gtm wideip
SYNTAX
Configure the wideip aaaa component within the gtm module using the syntax shown in the following sections.
CREATE/MODIFY
create wideip aaaa [name]
modify wideip aaaa [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 aaaa [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
reset-stats wideip aaaa
reset-stats wideip aaaa [ [name] | [glob] | [regex] ] ... ]
DISPLAY
list wideip aaaa
list wideip aaaa [ [name] | [glob] | [regex] ] ... ]
show running-config wideip aaaa
show running-config wideip aaaa [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
one-line
partition
show wideip aaaa
show wideip aaaa [ [ [name] | [glob] | [regex] ] ... ]
options:
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
(detail | global)
field-fmt
DELETE
delete wideip aaaa [all | [name] ]
DESCRIPTION
You can use the wideip component to create, modify, display, or delete a wide IP that responds to AAAA
queries. An AAAA wide IP is a mapping of a fully-qualified domain name (FQDN) to a set of IPv6 virtual servers
that host the domain's content, such as a web site or an e-commerce site.
EXAMPLES
create wideip aaaa www.my_wide_ip.com
Creates a AAAA wide IP named www.my_wide_ip.com.
delete wideip aaaa www.my_wide_ip.com
Deletes the AAAA 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 AAAA record
requests. With this option enabled, the system responds faster to AAAA requests for which it does not
have AAAA 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 AAAA
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 aaaa(1)