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)