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)