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)
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 2017-05-01 wam application(1)