gtm distributed-app
gtm distributed-app(1) BIG-IP TMSH Manual gtm distributed-app(1)
NAME
distributed-app - Configures a Global Traffic Manager(tm) distributed
application.
MODULE
gtm
SYNTAX
Configure the distributed-app component within the gtm module using the
syntax in the following sections.
CREATE/MODIFY
create distributed-app [name]
modify distributed-app [name]
options:
app-service [[string] | none]
dependency-level [datacenter | link | none | server | wideip]
description [string]
disabled-contexts
[add | delete | modify | replace-all-with] {
[datacenter | link | server] [name] ...
}
disabled-contexts none
persistence [enabled | disabled]
persist-cidr-ipv4 [integer]
persist-cidr-ipv6 [integer]
ttl-persistence [integer]
wideips
[add | delete | replace-all-with] {
[name] ...
}
wideips [default | none]
edit distributed-app
[ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
one-line
reset-stats distributed-app
reset-stats distributed-app
[ [ [name] | [glob] | [regex] ] ... ]
DISPLAY
list distributed-app
list distributed-app [ [ [name] | [glob] | [regex] ] ... ]
show running-config distributed-app
show running-config distributed-app
[ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
partition
show distributed-app
show distributed-app [name]
options:
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
detail
field-fmt
DELETE
delete distributed-app [name]
DESCRIPTION
You can use the distributed-app component to create, modify, display,
or delete a distributed application.
EXAMPLES
create distributed-app DA1
Creates a distributed application named DA1 with options set to the
default values.
list distributed-app DA1 all-properties
Displays all properties of the distributed application named DA1.
OPTIONS
app-service
Specifies the name of the application service to which the
distributed application 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 the distributed
application. Only the application service can modify or delete the
distributed application.
dependency-level
Specifies the resources that must be in the available state before
this distributed application is considered available. The options
are:
datacenter
All of the data centers on the member list of this
distributed application must be in an available state before
the system considers the distributed application available.
link All of the links on the member list of this distributed
application must be in an available state before the system
considers the distributed application available.
none The distributed application has no dependencies. This value
effectively disables this option. This is the default value.
server
All of the servers on the member list of this distributed
application must be in an available state before the system
considers the distributed application available.
wideip
All of the Wide IPs on the member list of this distributed
application must be in an available state before the system
considers the distributed application available.
description
User defined description.
disabled-contexts
Specifies the components that you want to add to or delete from
this distributed application as disabled-contexts. You can also
replace all of the components that are currently listed as
disabled-contexts for this distributed application with other
components. The default value is none.
The possible values are:
datacenter
Specifies the datacenters, by name, to which the system does
not send traffic from this distributed application.
link Specifies the links, by name, to which the system does not
send traffic from this distributed application.
none There are no components to which the system does not send
traffic from this distributed application. This value
effectively disables this option.
server
Specifies the servers, by name, to which the system does not
send traffic from this distributed application.
glob Displays the items that match the glob expression. See help glob
for a description of glob expression syntax.
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 this object
resides.
persistence
When enabled, if 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.
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.
ttl-persistence
Specifies, in seconds, the length of time for which the
persistence entry is valid. The default value is 3600.
wideips
Specifies the Wide IPs, by name, that you want to add to or delete
from this distributed application. You can also replace all of the
Wide IPs that are currently associated with this distributed
application with other Wide IPs. The default value is none.
A Wide IP is a collection of one or more domain names that maps to
one or more groups of virtual servers managed either by BIG-IP(r)
systems, or by host servers. The Global Traffic Manager load
balances name resolution requests across the virtual servers that
are defined in the Wide IP that is associated with the requested
domain name.
SEE ALSO
create, delete, glob, gtm link, gtm server, create, 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 2009-2010, 2012. All rights
reserved.
BIG-IP 2014-10-22 gtm distributed-app(1)