wam application
wam application(1) BIG-IP TMSH Manual wam application(1)
NAME
application - Configures application for WebAccelerator.
MODULE
wam
SYNTAX
Configure the application component within the wam module using the
syntax shown in the following sections.
CREATE/MODIFY
create application [name]
modify application [name]
options:
app-service [[string] | none]
code [number]
content-expiration-time [date and time]
description [string]
hosts [add | delete | modify | replace-all-with] {
[ [host name] | [glob] ] {
options:
app-service [[string] | none]
code [number]
subdomain-number-of-http [number]
subdomain-number-of-https [number]
subdomain-prefix [string]
}
}
ibr-adaptive-lifetime [number]
ibr-default-lifetime [number]
ibr-prefix [string]
info-header [none | standard | debug]
multibox [disabled | farm | symmetric]
policy [name]
perf-monitor [enabled | disabled]
perf-monitor-data-retention-period [number]
collect-roi-statistics [ enabled | disabled ]
send-metadata [never | always | uncompressed]
roi-report-email-addresses { string }
roi-report-frequency [ every-month | every-week ]
roi-report-name [string]
roi-report-next-time [date and time]
roi-report-smtp-config [ smtp configuration object name ]
roi-report-collect-statistics { caching-bytes-saved | client-ibred-links |
compression-bytes-saved | icc-refed-links | inlined-links |
caching-requests-saved | client-ibred-links-recd | icc-inlined-links |
image-opt-bytes-saved | minification-bytes-saved }
edit application [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
reset-stats application
reset-stats application [ [ [name] | [glob] | [regex] ] ... ]
DISPLAY
list application [name ...]
show running-config application [name ...]
options:
all-properties
non-default-properties
partition
predefined
show application
show application [name]
options:
all-properties
(default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
detail
field-fmt
DELETE
delete application [name ...]
Note: You must remove all references to an application before you can
delete it.
DESCRIPTION
You can use the application component to configure the host map, select
policies, and set application wide parameters that affect
WebAccelerator behavior.
EXAMPLES
create application my_app hosts add { host1.com host2.com } policy
my_local_policy
Creates a WebAccelerator application with a host map consisting of two
hosts, host1.com and host2.com, and a local policy set to
my_local_policy.
modify application my_app remote-policy my_remote_policy
Sets my_remote_policy as the remote policy for application my_app.
modify application my_app modify hosts { host1.com { subdomain-number-
of-http 3 subdomain-prefix abcd } }
Sets the number of subdomain hosts to 3 and the subdomain prefix to
abcd for host host1.com of WebAccelerator application my_app.
modify application my_app roi-report-name "my_report" roi-report-
frequency monthly roi-report-next-time now roi-report-email-addresses
add { someone@domain.com } roi-report-smtp-config smtp-config roi-
report-collect-statistics add { caching_bytes_saved
caching_requests_saved }
Sets the ROI report name to my_report. The ROI report is set to be sent
monthly, and the next time to send the report is set to now. The ROI
report will be mailed to someone@domain.com. The SMTP configuration
used to send the ROI report will be the predefined configuration of
name smtp-config. The ROI report will contain the statistics specified
by roi-report-collect-statistics, which in this case would be
caching_bytes_saved and caching_requests_saved.
delete application my_app
Deletes WebAccelerator application my_app.
OPTIONS
app-service
Specifies the name of the application service to which the object
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 object. Only the application
service can modify or delete the object.
code Specifies a numeric non-zero code of the application or
application host, which is used for troubleshooting and
performance reporting. Each application or application host must
have a unique code. If not supplied, it will be generated by the
system. Use the keyword generate to specify that the system
generate a new unique code.
content-expiration-time
Specifies the date and time that limits how old cached documents
can be to still be served from the cache. All documents older than
this date and time are considered expired. For example, the
following example expires all cached documents of the application
my_app:
modify application my_app content-expiration-time now
description
Specifies the object type description.
hosts
Specifies the list of domain names (host names) that might appear
in HTTP requests for your Web application. These are the same host
names that DNS has mapped to the server machine on which your
WebAccelerator system is running. To map a group or range of
requested host names to a single destination host, you can use an
asterisk (*) as a wildcard for the first part of the host name.
ibr-adaptive-lifetime
Specifies the adaptive lifetime for Intelligent Browser
Referencing in seconds. The default value is 864000 (10 days).
ibr-default-lifetime
Specifies the lifetime for Intelligent Browser Referencing in
seconds. The default value is 15724800 (6 months).
ibr-prefix
Specifies a prefix for the Intelligent Browser Referencing tag.
The default value is ";wa".
info-header
Enables and controls the appearance of HTTP header X-WA-Info: in
responses from WebAccelerator. This header can be used for
troubleshooting the WebAccelerator system and for tuning policies.
The possible values are:
debug
HTTP header X-WA-Info: is included into responses with
standard information, with some additional values to aid
WebAccelerator troubleshooting.
none HTTP header X-WA-Info: is not included into responses.
standard
HTTP header X-WA-Info: is included into responses with
standard information, such as S-code, policy, and node codes,
etc.
multibox
Specifies which type of multibox support is required for this
application, if any. Options are disabled, for deployments with an
independent WebAccelerator; farm, for farm deployments; and
symmetric, for symmetric deployments. When this is not disabled,
the application should be shared by a config sync device group
containing all devices in the deployment. It enables the broadcast
of invalidation messages to other devices in the device group,
and, when set to symmetric, also enables symmetric processing of
traffic.
partition
Displays the administrative partition within which the application
resides.
perf-monitor
Specifies whether performance monitoring for this application is
enabled. Enabling performance monitoring on many applications may
affect the overall performance of WebAccelerator. The default
value is disabled.
perf-monitor-data-retention-period
Specifies the time period in days for how long the performance
data must be preserved. The default value is 30 days.
collect-roi-statistics
Specifies whether ROI statistics collection for this application
is enabled. The default value is disabled.
roi-report-name
Specifies the name of ROI statistics report if the statistics
collection is enabled and report generation is desired.
roi-report-frequency
Specifies the frequency of ROI statistics report, if the
statistics collection is enabled and report generation is desired.
The options are every week or month.
roi-report-email-addresses
Specifies the email-addresses to which ROI statistics report will
be sent.
roi-report-next-time
Specifies the next time when the ROI statistics report will be
sent.
roi-report-smtp-config
Specifies the smtp configuration that will be used to send the
scheduled ROI report over email.
roi-report-collect-statistics
Specifies which statistics are to be included in the ROI
statistics report.
policy
Specifies the acceleration policy to which you want to assign the
new Web application.
predefined
Displays if this application is predefined.
send-metadata
Specifies when Etag HTTP headers will be included into responses.
The default value is always.
always
Etag HTTP headers will always be included into responses.
never
Etag HTTP headers will not be included into responses.
uncompressed
Metadata HTTP headers will be included only if response is
uncompressed.
subdomain-number-of-http
Specifies the number of HTTP subdomains that you want the
WebAccelerator system to generate. The WebAccelerator system uses
these additional subdomains only on embedded URLs or links that
request images or scripts. The default value is 0.
subdomain-number-of-https
Specifies the number of HTTPS subdomains that you want the
WebAccelerator system to generate. The WebAccelerator system uses
these additional subdomains only on embedded URLs or links that
request images or scripts. The default value is 0.
subdomain-prefix
Specifies the prefix that you want the system to assign to the
subdomains. The default value is wa.
For example, if the Requested Host is www.siterequest.com, and you
select 2 from the HTTP Subdomains box and type wa in the Subdomain
Prefix box, the WebAccelerator system changes the domain on
qualifying embedded URLs and links to use the following domains:
wa1.www.siterequest.com
wa2.www.siterequest.com
Note: You must configure DNS with these entries, and they must map
to the same IP address as the base origin server
(www.siterequest.com in this example).
SEE ALSO
create, delete, edit, glob, 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 2010-2014, 2016. All rights
reserved.
BIG-IP 2016-03-14 wam application(1)