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)