Applies To:
Show VersionsBIG-IP AAM
- 12.1.0
Summary:
This release note documents the version 12.1.0 release of BIG-IP Application Acceleration Manager. You can apply the software upgrade to systems running software versions 10.1.0 (or later) or 11.x/12.x.
Contents:
- Platform support
- Configuration utility browser support
- BIG-IQ – BIG-IP compatibility
- User documentation for this release
- New in 12.1.0
- Installation overview
- Upgrading from earlier versions
- Fixes in 12.1.0
- Behavior changes in 12.1.0
- Known issues
- Contacting F5 Networks
- Legal notices
Platform support
This version of the software is supported on the following platforms:
Platform name | Platform ID |
---|---|
BIG-IP 1600 | C102 |
BIG-IP 3600 | C103 |
BIG-IP 3900 | C106 |
BIG-IP 6900 | D104 |
BIG-IP 8900 | D106 |
BIG-IP 8950 | D107 |
BIG-IP 11000 | E101 |
BIG-IP 11050 | E102 |
BIG-IP 2000s, BIG-IP 2200s | C112 |
BIG-IP 4000s, BIG-IP 4200v | C113 |
BIG-IP 5000s, 5050s, 5200v, 5250v | C109 |
BIG-IP 7000s, 7050s, 7055, 7200v, 7250v, 7255 | D110 |
BIG-IP 12250v | D111 |
BIG-IP 10150s-NEBS, 10350v (AC), 10350v-NEBS (requires 12.0.0 HF1), 10350v-FIPS (requires 11.5.4 HF1) | D112 |
BIG-IP 10000s, 10050s, 10055, 10200v, 10250v, 10255 | D113 |
VIPRION B2100 Blade | A109 |
VIPRION B2150 Blade | A113 |
VIPRION B2250 Blade | A112 |
VIPRION B4200, B4200N Blade | A107, A111 |
VIPRION B4450 Blade | A114 |
VIPRION B4300, B4340N Blade | A108, A110 |
VIPRION C2200 Chassis | D114 |
VIPRION C2400 Chassis | F100 |
VIPRION C4400, C4400N Chassis | J100, J101 |
VIPRION C4480, C4480N Chassis | J102, J103 |
VIPRION C4800, C4800N Chassis | S100, S101 |
Virtual Edition (VE) | Z100 |
vCMP Guest | Z101 |
These platforms support various licensable combinations of product modules. This section provides general guidelines for module support.
Most of the support guidelines relate to memory. The following list applies for all memory levels:
- vCMP supported platforms
- VIPRION B2100, B2150, B2250, B4200
- VIPRION B4300 blades in the 4400(J100)/4480(J102) and the 4800(S100)
- BIG-IP 5200v, 5250v, 7200v, 7250v, 10200v, 10250v, 10350v, 12250v
Memory: 12 GB or more
All licensable module-combinations may be run on platforms with 12 GB or more of memory, and on VE and vCMP guests provisioned with 12 GB or more of memory. Note that this does not mean that all modules may be simultaneously provisioned on all platforms with 12 GB or more of memory. The BIG-IP license for the platform determines which combination of modules are available for provisioning.
Memory: 8 GB
The following guidelines apply to the BIG-IP 2000s, 2200s, 3900, 6900 platforms, to the VIPRION B4100 and B4100N platforms, and to VE guests configured with 8 GB of memory. (A vCMP guest provisioned with 8 GB of memory has less than 8 GB of memory actually available and thus does not fit in this category.)
- No more than three modules should be provisioned together.
- On the 2000s and 2200s, Application Acceleration Manager (AAM) can be provisioned with only one other module.
- In the case of Access Policy Manager (APM) and SWG together, no module other than LTM may be provisioned, and LTM provisioning must be set to None.
Memory: Less than 8 GB and more than 4 GB
The following guidelines apply to platforms, and to VE and vCMP guests provisioned with less than 8 GB and more than 4 GB of memory. (A vCMP guest provisioned with 8 GB of memory has less than 8 GB of memory actually available and thus fits in this category.)
- No more than three modules (not including AAM) should be provisioned together.
- Application Acceleration Manager (AAM) cannot be provisioned with any other module; AAM can only be provisioned standalone.
- Analytics (AVR) counts towards the two module-combination limit (for platforms with less than 6.25 GB of memory).
Memory: 4 GB or less
The following guidelines apply to the BIG-IP 1600 and 3600 platforms, and to VE and vCMP guests provisioned with 4 GB or less of memory.
- No more than two modules may be configured together.
- AAM should not be provisioned, except as Dedicated.
- ASM can be provisioned with this amount of memory, but a sizing exercise should be performed to ensure that it does not hit capacity issues.
VIPRION and vCMP caching and deduplication requirements
Application Acceleration Manager (AAM) supports the following functionality when configuring vCMP and VIPRION platforms.
- AAM does not support disk-based caching functionality on vCMP platforms. AAM requires memory-based caching when configuring it to run on vCMP platforms.
- AAM supports disk-based caching functionality on VIPRION chassis or blades.
- AAM does not support deduplication functionality on vCMP platforms, or VIPRION chassis or blades.
vCMP memory provisioning calculations
The amount of memory provisioned to a vCMP guest is calculated using the following formula: (platform_memory- 3 GB) x (cpus_assigned_to_guest/ total_cpus).
As an example, for the B2100 with two guests, provisioned memory calculates as: (16-3) x (2/4) ~= 6.5 GB.
- BIG-IP LTM standalone only
- BIG-IP GTM standalone only
- BIG-IP LTM and GTM combination only
Configuration utility browser support
The BIG-IP Configuration Utility supports these browsers and versions:
- Microsoft Internet Explorer 11.x
- Mozilla Firefox 27.x
- Google Chrome 32.x
BIG-IQ – BIG-IP compatibility
SOL14592: Compatibility between BIG-IQ and BIG-IP releases provides a summary of version compatibility for specific features between the BIG-IQ system and BIG-IP releases.
User documentation for this release
For a comprehensive list of documentation that is relevant to this release, refer to the BIG-IP AAM / VE 12.1.0 Documentation page.
New in 12.1.0
HTML minification
In this release, minification is now available for HTML, along with minification for JavaScript and CSS, to reduce page size and increase load speed. When minification is enabled in AAM, whitespaces and comments are stripped from HTML and XHTML pages. HTML minification will have no effect on page semantics or syntax, and is disabled by default.
Installation overview
This document covers very basic steps for installing the software. You can find complete, step-by-step installation and upgrade instructions in BIG-IP Systems: Upgrading Software, and we strongly recommend that you reference the information to ensure successful completion of the installation process.
Installation checklist
Before you begin:
- Use BIG-IP iHealth to verify your configuration file. For more information, see SOL12878: Generating BIG-IP diagnostic data using the qkview utility.
- Update/reactivate your system or vCMP host license, if needed, to ensure that you have a valid service check date. For more information, see SOL7727 - License activation may be required prior to a software upgrade for the BIG-IP or Enterprise Manager system.
- Ensure that your system is running version 10.1.0 or later and is using the volumes formatting scheme.
- Download the .iso file (if needed) from F5 Downloads to /shared/images on the source for the operation. (If you need to create this directory, use the exact name /shared/images.)
- Configure a management port.
- Set the console and system baud rate to 19200, if it is not already.
- Log on as an administrator using the management port of the system you want to upgrade.
- Boot into an installation location other than the target for the installation.
- Save the user configuration set (UCS) in the /var/local/ucs directory on the source installation location, and copy the UCS file to a safe place on another device.
- Log on to the standby unit, and only upgrade the active unit after the standby upgrade is satisfactory.
- Turn off mirroring.
- If you are running Application Acceleration Manager, set provisioning to Minimum.
- If you are running Policy Enforcement Manager, set provisioning to Nominal.
- If you are running Advanced Firewall Manager, set provisioning to Nominal.
Installing the software
Installation method | Command |
---|---|
Install to existing volume, migrate source configuration to destination | tmsh install sys software image [image name] volume [volume name] |
Install from the browser-based Configuration utility | Use the Software Management screens in a web browser. |
Sample installation command
The following command installs version 11.2.0 to volume 3 of the main hard drive.
tmsh install sys software image BIGIP-11.2.0.2446.0.iso volume HD1.3
Post-installation tasks
This document covers very basic steps for installing the software. You can find complete, step-by-step installation and upgrade instructions in BIG-IP Systems: Upgrading Software, and we strongly recommend that you reference the information to ensure successful completion of the installation process.
- Ensure the system rebooted to the new installation location.
- Use BIG-IP iHealth to verify your configuration file. For more information, see SOL12878: Generating BIG-IP diagnostic data using the qkview utility.
- Log on to the browser-based Configuration utility.
- Run the Setup utility.
- Provision the modules.
- Convert any bigpipe scripts to tmsh. (Version 11.x does not support the bigpipe utility.)
Installation tips
- The upgrade process installs the software on the inactive installation location that you specify. This process usually takes between three minutes and seven minutes. During the upgrade process, you see messages posted on the screen. For example, you might see a prompt asking whether to upgrade the End User Diagnostics (EUD), depending on the version you have installed. To upgrade the EUD, type yes, otherwise, type no.
- You can check the status of an active installation operation by running the command watch tmsh show sys software, which runs the show sys software command every two seconds. Pressing Ctrl + C stops the watch feature.
- If installation fails, you can view the log file. The system stores the installation log file as /var/log/liveinstall.log.
Upgrading from earlier versions
Your upgrade process differs depending on the version of software you are currently running.
Upgrading from version 10.1.0 (or later) or 11.x
When you upgrade from version 10.1.0 (or later) or 11.x software, you use the Software Management screens in the Configuration utility to complete these steps. To open the Software Management screens, in the navigation pane of the Configuration utility, expand System, and click Software Management. For information about using the Software Management screens, see the online help.
Upgrading from versions earlier than 10.1.0 11.x
You cannot roll forward a configuration directly to this version from BIG-IP version 4.x, or from BIG-IP versions 9.0.x through 9.6.x. You must be running version 10.1.0 software. For details about upgrading to those versions, see the release notes for the associated release.
Automatic firmware upgrades
If this version includes new firmware for your specific hardware platform, after you install and activate this version, the system might reboot additional times to perform all necessary firmware upgrades.
Fixes in 12.1.0
ID Number | Description |
---|---|
401324 | When linearizing a PDF, qpdf no longer cores when processing a document with no pages. |
476460 | Use db variable Wam.Cache.Range.MaxRanges to increase the number of max allowed sub-ranges in a HTTP range request. It defaults to a maximum of 8 sub-ranges, however it can be increased up to 32. |
486167 | Now, the GUI behavior is the same as TMSH: the GUI 'delete local endpoint operation' deletes only the endpoint. |
498302 | The new object will now be served to the client with the new Last-Modified time stamp. |
499124 | The messages created by wom_verify_config have been cleaned up. |
521455 | "Transcoded WebP images are no longer served to the Edge browser. By default, transcoded JPEG-XR is also no longer served to the Edge browser, but the db variable ccdb.allow.edge.jpegxr may be used to override this." |
523325 | WAM/AAM PDF linearization no longer corrupts password-protected PDFs. |
525787 | A leading *, *., or dot in policy extension value is now ignored, which logs an error in /var/log/tmm similar to the following: notice WAM policy error: initial '*.' in extension 'html' ignored. |
547537 | An iSession tunnel initialization defect has been corrected. |
551010 | Gracefully recover from unexpected WAM storage queue state |
552198 | This release fixes an APM App Tunnel/AM iSession connection memory leak. |
553741 | The color management library and functionality has been restored. |
562644 | TMM no longer crashes when AAM receives a pipelining HTTP request which while shutting down the connection |
Behavior changes in 12.1.0
ID Number | Description |
---|---|
553741 | Restores correct color management to WAM's image optimization feature. |
Known issues
ID Number | Description |
---|---|
222545 | In the case of an abnormal TCP connection reset, the iSession connection is terminated and reset. The iSession connection is terminated and reset. While this action is transparent to the user, this action might appear in diagnostics. This might occur when an abnormal TCP connection reset is received. Workaround: None. |
223434 | (CR129753) When optimizing FTP (passive mode) connections, the data connection's destination TCP port as chosen by the client, is different after optimization/passing through iSession/FTP on the server side. For active FTP, the system changes the data ports advertised by the server, so the client might see a different port than the one originally sent by the server. For passive FTP, the system changes the data ports advertised by the client, so the server might see a different port than the one originally sent by the client. Note that in both cases, the data transfers are successful. When optimizing FTP (passive mode) connections. Workaround: None. |
346536 | If resources for PDF linearization become unavailable while accepting a PDF file, the linearization and connection to client will abort. Linearization and connection to client will abort. Resources for PDF linearization become unavailable while accepting a PDF file Workaround: No workaround is available; however, if the origin web server supplies Content-Length headers for PDF content, this condition becomes less likely. |
348816 | When rolling forward a WebAccelerator 10.x configuration to version 11.x, access logging configuration on the acceleration policy is not rolled forward. Access logging configuration on the acceleration policy is not rolled forward. When rolling forward a WebAccelerator 10.x configuration to version 11.x. Workaround: To enable access logging for BIG-IP WebAccelerator version 11.x, please see Using the Request Logging Profile chapter in the WebAccelerator Implementations guide or in BIG-IP Acceleration: Implementations. |
356245 | A COMPRESS::enable or COMPRESS:disable command set in an HTTP_RESPONSE iRule event clause does not set a persistent state. "The next request, if served from cache, does not invoke the HTTP Response event. So only the request state can control the compression state in subsequent requests, until the object is refreshed. For objects greater than 4K in size, compression::enable in an HTTP_REQUEST event may not compress when serving from cache." An enable or disable compression command in an HTTP Response event clause in an iRule. Workaround: |
356867 | Earlier versions of the BIG-IP WebAccelerator module allowed importing of identically named acceleration policies without selecting the Overwrite existing policy of the same name check box, resulting in a number appended to the imported acceleration policy name. In this version, you must select the Overwrite existing policy of the same name check box to import identically named acceleration policies. Or you can ensure the policy you are importing has a unique name. Workaround: None. |
357320 | For iRules associated with a virtual server that has an associated Web Acceleration profile, [CACHE::disable] can only be used if there is no WebAccelerator Application enabled in the Web Acceleration profile, and [WAM::disable] can only be used if there is a WebAccelerator Application enabled in the Web Acceleration profile. Workaround: Edit the iRules to use the correct command, either CACHE::disable or WAM::disable, for the virtual server's Web Acceleration profile. |
357706 | In the BIG-IP Dashboard, in the Web Acceleration view, on the Performance pane, with the Errors tab in focus, Requests bypassed due to overload shows zero statistics because the WebAccelerator module does not bypass traffic due to resource constraints. Workaround: None. |
357712 | The stat field proxied_per_iRule, in the stat table tmctl wam_application_stat, remains at zero. Workaround: None. |
357921 | The Configuration utility should provide a specific error message when an extension or MIME type for an object type is not unique, instead of a generic error message. Workaround: None. |
358109 | Invalidation rules on a given node are only effective in invalidating one single extension. Workaround: None. |
358530 | Various matching parameters in WebAccelerator Configuration utility that contain a regular expression with a pipe symbol (|) are incorrectly formatted for display. Workaround: |
358785 | The WebAccelerator GUI displays dormant proxy rules on a node even when it is set to Always Proxy. Workaround: None. |
359062 | This version does not include query parameters in a POST body for any rules: matching, variation, proxy, or invalidation. Workaround: |
359093 | "If you want to receive an HTTP POST request and decompress it before sending it to the origin web server, and the client software sends an Expect: 100-continue header and the HTTP request-chunking mode is set to preserve, the request will not be decompressed. Specifically, the following iRule will not decompress the request in the presence of the Expect header with request-chunking set to preserve: when HTTP_REQUEST { DECOMPRESS::enable } Instead, to receive an HTTP POST request and decompress it before sending it to the origin web server, do one of the following steps: - Ensure that the client doesn't send an Expect header. - Change the request-chunking to selective, instead of preserve." Workaround: None. |
359498 | In tmsh, the WebAccelerator module can assemble hostnames that include IP addresses with MultiConnect prefixes, for example, wa1.10.0.0.1. In tmsh, specify zero (0) for the number of HTTP and HTTPS subdomains on any WebAccelerator hostnames that are IP addresses. Workaround: None. |
359835 | Deprovisioning AAM (for example, changing the provisioning level from Dedicated to None) may require a reboot, even though the reboot prompt may not be visible. Workaround: None. |
360211 | Invalidation rules that match on components not in the UCI will not invalidate content if it is first accessed without those components matching the rule before it is accessed with those components matching the rule. Workaround: None. |
360229 | If you are upgrading from 10.x to 11.x, and you receive the warning DISK MGMT REQUIRED, try unprovisioning WOM and rebooting the BIG-IP system. Some disk management may be required during upgrade. In an upgrade situation, this could be an expected/necessary state. Volumes, /usr in particular have grown from 10x to 11x which could be one reason (it needs to remove the datastor to make the re-size). In 11.x, the vg-reserved functionality should help prevent most of these issues that are frequently remedied by the need to unprovision WOM. Workaround: Free up disk space and unprovision WOM. |
360488 | Using the Configuration utility to make changes to the WebAccelerator configuration, such as deleting an Acceleration Policy or Object Type, might take up to 30 seconds to write to disk. This process can result in deleted objects reappearing in the configuration if it is reloaded immediately after making the change. Workaround: None. |
361810 | If two invalidation rules match the same path but have different extensions, one will match and one will not. Workaround: None. |
361852 | Invalidation rules that specify cached content by protocol invalidate content regardless of the protocol. Workaround: None. |
361869 | An invalidation rule that specifies Client IP as a condition for invalidation never matches. The trigger can match an IP; however, the content to invalidate cannot match. Workaround: None. |
361875 | An invalidation rule that specifies an empty or absent Query Parameter for Cached Content to Invalidate is not functional. This invalidation rule works, however, if you specify a non-empty Query Parameter value for Cached Content to Invalidate. Workaround: None. |
361982 | Some combinations of spaces and tabs, before and after HTTP header values, are not properly ignored and defeat invalidation that is based on those headers. Workaround: The workaround is to remove the leading/trailing whitespace from the values. |
362005 | A message needs to be logged when the Cache-Control header is truncated to a maximum length of 256 characters. Workaround: None. |
362275 | "Setting the Web Acceleration Profile to optimized-acceleration for a virtual server without enabling a WebAccelerator Application will result in an error message similar to the following: cache memory assigned to Web Acceleration profiles (6144 MB) exceeds the maximum amount (697 MB) defined by Ramcache.MaxMemoryPercent (50) The optimized-acceleration profile is designed for use with the WebAccelerator module. If you are not using the WebAccelerator module with your virtual server and wish to use standard cache, you should use the optimized-caching profile, or create a customized webacceleration profile that uses either the optimized-caching profile or basic webacceleration profile as the parent." Workaround: None. |
363171 | "Validation of Web Acceleration profiles can fail during a config sync when the sum of the cache sizes exceeds the Datastor volume size on the receiving BIG-IP system. For all BIG-IP systems in the Device Group: 1) Run each BIG-IP system with identical provisioning. 2) Ensure that each BIG-IP system has the same volume size for Datastor: # tmsh show sys disk application-volume datastor 3) Configure the Web Acceleration profiles. 4) Sync each BIG-IP system to the Device Group." Workaround: None. |
363402 | Specifying content to invalidate as the Referer header from the invalidation trigger (which specifies request-data-type referrer) is not functional. Workaround: None. |
363413 | Specifying content to invalidate as the User-Agent header from the invalidation trigger (which specifies request-data-type user-agent) is not functional. Workaround: None. |
363699 | "The WebAccelerator module Configuration utility incorrectly allows creation of nodes with reserved keyword names, which results in the configuration improperly loading the next time that the unit is rebooted or the configuration is loaded. This issue also causes config sync in a High Availability pair to fail. When creating WebAccelerator policy node names in the Configuration utility, avoid using the following reserved keywords. invalidations matching order proxy substitutions variation code description" Workaround: None. |
364338 | The WebAccelerator module allows the creation of Object Types that contain a space in the identifier name on the Object Types page in the Configuration utility and by using TMSH. Including a space prevents the ability to delete the object type from the Configuration utility. When you create an identifier name for an object type from the Configuration utility or in TMSH, do not include a space in the name. If you have an object whose name contains a space, you can delete it using TMSH. Workaround: None. |
364603 | For this version, in the BIG-IP Dashboard, in the Web Acceleration view, on the Cache pane, with the Entries tab in focus, the graph displays an incorrect value. The graph displays the number of cache transactions per second, instead of displaying the number of entries in cache. Workaround: |
365390 | If the BIG-IP platform you are using has hardware compression, and the intended use case is a single connection, you might see compression performance issues in some scenarios. Workaround: As a work around, F5 recommends that you disable hardware compression to achieve better single-connection performance on platforms that support hardware compression. To disable hardware compression, change the Deflate Level setting in the iSession profile to a number greater than or equal to 3, using the browser interface (click Local Traffic :: Virtual Servers :: Services :: iSession, and then click the iSession profile you are using) or the command-line interface (type tmsh modify wom profile isession isession deflate-compression-level 3). |
365600 | In the BIG-IP Dashboard, in the Web Acceleration view, reporting of statistics show spikes at irregular intervals with a magnitude of 2 to 3 times the average traffic through the WebAccelerator module. This was observed for the 5-min interval window. Workaround: None. |
368982 | Disabling any virtual server stops traffic from passing through the BIG-IP WOM device, even though other virtual servers may be enabled. To avoid this issue, you can delete the virtual server rather than disabling it. Workaround: None. |
369282 | On a BIG-IP provisioned LTM and WAM/AAM nominal, when WAM/AAM is de-provisioned back to none, the load average of the system spikes to 30+, and the system becomes unresponsive for approximately five minutes. The system becomes unresponsive for approximately five minutes. WAM/AAM is de-provisioned. Workaround: None needed. After approximately five minutes, the system appears to return to normal and the prompt status returns to REBOOT REQUIRED. |
370311 | If you create a virtual server with Type set to Reject, or change the Type setting to Reject for an existing virtual server and update the screen, when you open the screen to modify the virtual server, a second iSession Profile setting appears in the browser interface. A second iSession Profile setting appears in the browser interface. The additional setting lacks a Context field, and has no effect on the configuration. This occurs when you create a Virtual Server of Type Reject, add an iSession Profile, and then modify the Virtual Server. Workaround: None. |
381229 | When cached documents are served, the browser workarounds configuration option is ignored. Browser workarounds configuration option is ignored. This occurs when the system caches a document (one served by a newer browser that causes the document to be cached) and then attempting to access that cached document with old browsers, such as Mozilla version 4.5. Workaround: None. |
381712 | In an active/standby configuration, modifying the WAN optimization codec from SDD v2 to SDD v3, or the reverse, requires that you issue a bigstart restart command on the standby BIG-IP system for the change to take affect. Workaround: None. |
382629 | If you update or delete an iSession self IP, and then create a new self IP before deleting the associated local endpoint and iSession listener, the local endpoint becomes unmodifiable. The local endpoint becomes unmodifiable. Update or delete an iSession self IP, and then create a new self IP before deleting the associated local endpoint and iSession listener. Workaround: To avoid this issue, delete the local endpoint and associated iSession listener before creating another self IP on the same VLAN. |
382976 | Erroneously enabling image optimization on policy nodes matching HTML or CSS content causes that content to become uncacheable, and the system posts S10206 codes. Content is not cached and responses return S10206 codes. This occurs when enabling image optimization on nodes that match content that can be parsed (for example, HTML or CSS content). Workaround: None. |
383398 | Cache entries that are being constantly refreshed due to traffic cannot be cleared with wa_clear_cache if the configured lifetime is less than 4 seconds. Workaround: |
383985 | When you configure WAN optimization using the Quick Start screen, the BIG-IP system creates two virtual servers for HTTP traffic, http_optimize_client and http_optimize_client_v6, which specify a default network destination of 0.0.0.0 (all networks). If you change the destination to point to a specific subnet, and then attempt to change the IP Encapsulation Type on either the Quick Start or Local Endpoint screen, the user interface displays an error message, and the change does not take effect. Workaround: As a workaround, you can make the change using the command-line interface. For example, after you update the virtual servers to point to a specific subnet, modify the ip_encap_type attribute for the local-endpoint component by typing 'tmsh modify wom local-endpoint ip-encap-type ipsec ip-encap-profile replace-all-with {default-ipsec-policy}'. |
385722 | If a Web Acceleration profile has more than one WebAccelerator application enabled, ESI and triggered invalidations rules incorrectly invalidate content, regardless of which WebAccelerator application cached it. ESI and triggered invalidations rules incorrectly invalidate content. Web Acceleration profile has more than one WebAccelerator application enabled. Workaround: None. |
392479 | A rarely encountered issue occurs in which clicking save on the Lifetime page without making any modifications causes inheritance settings to be lost. Basically, when you click the save button on the Lifetime page for any of these nodes when no changes are made, inheritance is immediately overridden and a red 'x' appears to the right of 'WebAccelerator Cache Settings' near the top of the frame. This occurs on Pages, XML, JSON, Media, and Other Binary leaf nodes when saving the Lifetime page when no changes are made. Workaround: None. |
392549 | The Performance Monitor Data Retention Period setting for WAM application is not being recognized properly. The retention value from the most recent WAM app is used for all applications. That means that the system removes Performance Monitor data after that app's retention period, regardless of the retention setting in any older WAM applications. The issue is seen on a BIG-IP system with multiple WAM applications, each with different retention periods. Workaround: There is no workaround. |
396155 | After caching an uncompressed document, requesting a specific compressed range of the document results in either no compression and the specific range being asked for, or only the range of the original document compressed, depending on the length of the range being requested. Compression not as expected. The reason is that it only compresses the range being requested rather than the whole document, so if you only ask for 1000 bytes in the range, it falls under the compression profile's minimum. Also, upon content expiration from the cache, it seems that the uncompressed version of the document is evicted from the cache. This occurs after caching an uncompressed document and then requesting a specific compressed range of the document. Workaround: None. |
396167 | If you cache a compressed document normally, and then switch to asking for a range beyond the end of the document, you get a 416 Requested Range Not Satisfiable response from WAM, but only while the cached content has a positive lifetime. As soon as the document expires and needs re-validation with the OWS, the response from WAM is a complete bypass, with no WAM related headers at all, resulting in partial content reflecting the full uncompressed content-range. Workaround: |
401054 | The WAM perfmonitor content-type report could potentially display duplicate application-name/node-name values if an applications policy assignment is modified after passing traffic. The report does not identify the policy a node belongs to. If the newly assigned policy contains identical node names as its predecessor, the results will appear to be duplicates. VIPRION chassis with two blades installed and configured. Workaround: None. |
401922 | In a second or third request for an object (JS, CSS, Image, etc.) expected to be cached, the Content-Length header will return a larger size, causing the client to hang waiting for more data than what BIG-IP sent. Failed requests for objects from multiple clients. This is as-designed behavior that represents configuration requirements across application layers that cannot be enforced due to their complexity. LTM virtual with Web Accelerator profile configured. The http profile (LTM) must have the setting response-chunking set to other than SELECTIVE. Workaround: Change the response-chunking setting to SELECTIVE in the http profile for this virtual server. |
402303 | WAM transaction-type perfmonitor reports display empty text for application names or node names if an existing application or policy is deleted after passing traffic. The textual identifiers located in the policy or application no longer exist in the configuration after delete but the stats remain. This has no negative effect on system functionality. WAM transaction-type perfmonitor. Workaround: None. |
403350 | "WAM uses OWS response headers if it proxies a request, and format its own response headers if it serves from cache. This could result in the inconsistent Date header value if there is clock skew between the BIG-IP system and OWS. If this happens, we suggest OWS to use NTP server to sync their clock." Workaround: None. |
404830 | "You may be unable to delete acceleration policy object types from a partition other than the Common partition. Impact" "As a result of this issue, you may encounter one or more of the following symptoms: When attempting to delete a policy object type, you see an error message in the Configuration utility that appears similar to the following example: Deleting Object Type failed. When attempting to modify a policy object type, you see an error message in the Configuration utility that appears similar to the following example: The requested WAM object type (/<partition>/<object_name>) was not found." "You must change partitions to the Common partition before deleting the objects. Symptoms" Workaround: "To work around this issue, you can modify or delete objects from within the Common partition. Impact of workaround: Performing the suggested workaround should not have a negative impact on your system." |
405763 | The BIG-IP system cannot refresh cached content by querying server. Proxying the response prevents the cached data from being refreshed, with the result being that every request after max-age results in an OWS request and proxied response until the data is evicted from cache. If the OWS is IIS and has the forced compression setting enabled, the presence of the Content-Encoding: gzip header in a 304 response results in the BIG-IP proxying the response. Workaround: Write an iRule to remove the Content-Encoding header from 304 responses, or mitigate illegal OWS response by turning off forced compression. |
406301 | Small object content that expires and happens to be updated might cause resets to be sent to clients. Client can see intermittent failures, forcing client to try again. Under high concurrent request load, small object content that expires and happens to be updated can cause this behavior. Workaround: Enabling request queuing avoids the resets. |
410879 | When configured to inline content, WAM/AAM does not inline content that is not already cached or served from OWS with status 200 OK. WAM/AAM does not inline content. When configured to inline content. Workaround: None. |
415803 | Invalidation does not work for .txt documents that are too small to cache when compressed. The .txt documents are not invalidated. There is a cache minimum size specified, and the compressed text is smaller than the specified minimum. Workaround: None. |
416733 | In WebAccelerator's Symmetric Deployment mode, when configuration changes made on one device are synced to other devices in the deployment, the changes are not automatically saved to bigip.conf. Changes are not automatically saved to bigip.conf. WebAccelerator's Symmetric Deployment when configuration changes made on one device are synced to other devices. Workaround: Save the configuration manually by running the following command on all devices in the symmetric deployment after configuration changes are made: tmsh save sys config. |
419617 | Configuration error when creating several policy nodes in a single tmsh command. "Configuration error similar to the following 01070734:3: Configuration error: Configuration from primary failed validation: 01070734:3: Configuration error: Policy ""/Common/IBM Tivoli Maximo Asset Management"" node ""segment"" must have ordinal greater then its base node ordinal." "This occurs when the following conditions are met: -- B4300/B4340N and PB200/B4200 multi-bladed chassis. -- AAM licensed and provisioned. -- Edit several WAM/AAM policy nodes in a single tmsh command." Workaround: On B4300/B4340N and PB200/B4200 multi-bladed chassis, do not create several policy nodes in a single tmsh command, or, if doing so, specify correct ordinals for each node in that command. |
420954 | invalidation may be delayed when compressed and uncompressed requests are present. Old content may be served several extra times. If content is cached only uncompressed before it is invalidated and after invalidation is requested only compressed, the invalidation may be delayed by several requests. Workaround: Repeatedly request the contents until the invalidation happens. |
420957 | When static content is cached both compressed and uncompressed, they may not invalidate simultaneously. This may result in their cache ages being different. This might result in extra revalidations after invalidations and unexpected cache lifetimes. This occurs when there is a mix of compressed and uncompressed requests for static content, combined with triggered or ESI invalidations of that content. Workaround: None. |
423204 | When the small object size limits change, objects are not moved between small object cache and datastor. If tmm is running low on memory and the small object size limit has been increased, this might consume tmm memory. Reducing or increasing the small object limit in order to free up memory or move currently cached content to datastor does not have the desired effect. The small object size threshold db variable is changed from default values. Workaround: "To move content into datastor, temporarily reduce the number of cached objects. This causes all small objects to be evicted; datastor content is still available. Then increase the limit once again (this can be done immediately) and the content will be cached in datastor. There is no workaround to move currently cached content from datastor into the small object cache. Restarting datastor flushes all content including content that should remain in datastor." |
426652 | Remote Endpoints stay in 'unknown' state after iSession 'Hello' message is received. Remote Endpoints stay in 'unknown' state. Parse error related to UUID in the version reply message. Workaround: This issue has no workaround at this time. |
432072 | "It is not possible to add a web acceleration profile inheriting either directly or indirectly from the built-in profiles to a sync folder of a device group. An error message similar to the following is seen: 01070734:3: Configuration error: Invalid Devicegroup Reference. The profile_webacceleration (/testing/namewebaccel) requires profile_webacceleration (/Common/webacceleration) to be synced to the same devices" Config changes that create this condition (i.e. creating a webacceleration profile in a synced folder, or adding syncing to a folder containing a profile) will be rejected. Attempt to add a web acceleration profile inheriting from a built in profile to a devicegroup that is synced to other devices. Workaround: Edit bigip.conf to remove the /Common/webacceleration profile, then reload the config. |
435434 | When Intelligent Client cache is enabled, JS/CSS/Images are expected to be inlined. But CSS of size greater than 32 KB will not be inlined. Customer not getting the benefit of Intelligent client cache in this scenario. "* Webacceleration is attached to the virtual server. * Intelligent client cache is enabled on WAM policy. * CSS size limit is set to greater than 32 KB. * CSS optimizations are turned on - such as IBR, inlining images into CSS." Workaround: * Turn off CSS optimizations (IBR, inlining images into CSS). |
435947 | Upon WAM cache lifetime expiry, when revalidating content cached in tmm memory and receiving a 304 Not Modified response from OWS, WAM sometimes serves a response with S code 10232 (as expected) but lacking an Etag, and indicates the response came from datastor, when there is no indication of the reason this occurred. Without an Etag sent back to the client, WAM might get unnecessary load from clients that otherwise could perform a conditional GET with the Etag. WAM is configured to cache compressed static content from OWS, and OWS does not send a Last-Modified date header in the response. Workaround: Configure OWS to return the Last-Modified header for content it serves. |
436339 | The reference link in Intelligent Client Cache contains http when virtual server is https. Request using the URL in the reference link will fail. HTML page rendering appears to be nonfunctional. Request using the URL in the reference link fails. HTML page rendering appears to be nonfunctional. Virtual server is https. Requests for the HTML are from HTML5 browser and Intelligent Client Cache is enabled. Local storage element for the ICC-ed content in the browser is then deleted and the HTML page is requested again. This time the page does not render. Workaround: Although there is no specific workaround, the issue is not seen if the local storage element for ICC-ed content is not deleted. |
442124 | "When an image is optimized, the caches in which the original and the optimized versions are stored can be different. In that case, it is possible for one TMM to have a differently encoded version of the same image than another TMM." Minor, but some clients might receive the unoptimized image, while others will receive the optimized image. This condition applies on images whose size, after optimization, crosses back or forth across the 4 KB boundary that defines the size discriminator for choosing the cache. Workaround: Although no workaround is truly needed, image optimization can be disabled. |
447254 | TMM core error in a previously parked transaction Loss of service. "* Stand-in is enabled on the policy. * Request queueing is turned on in the policy * Document may have been removed from entity due to not matching policy on node." Workaround: * Disable stand-in and/or Request queueing |
456845 | WAM generated customized ETag sent to OWS. Customized WA ETag makes it to the client. Assuming the server does not generated WA ETags, the behavior would be the same irrespective of whether the ETag makes it to the server or not. The expectation is to receive a 200 OK from the server so that the content can be cached by WAM. Client has content cached and sends a conditional GET. wa_clear_cache has been issued or content has been evicted from WAM cache. The ETag sent by the client in headers is sent to the OWS. Workaround: None. |
465854 | When both CSS inline and JavaScript reordering are enabled, page rendering might be incorrect due to missing 'src' attribute in a script tag. Web pages do render correctly. Have AAM provisioned and a policy with both CSS inline and JavaScript reordering enabled and attached to a virtual server. Have a page with both CSS and JavaScript resources associated requested via the virtual server. Workaround: Disable either of the optimizations. |
465901 | Using AAM to inline a large number of JavaScripts in HTML code might result in resetting a connection and not serving the requested page to the client. When conditions are met there is a chance that the connection will be reset and the content won't be served to the client. Provision AAM and have a policy with inlining enabled for a large number of configured JavaScripts used in a single HTML page. Send a request to this page. Workaround: Reducing the number of inlining-enabled JavaScripts might result in properly serving the page. |
488013 | If cache-on-first-hit and OWS-compression are both enabled on a WA policy node, requests for uncached but cacheable documents will hang. No response returned to client "Conditions leading to this issue include: WA enabled on VIP, Cache on first hit enabled in WA policy, and OWS enabled in WA policy." Workaround: Disable either cache on first hit or OWA compression on the WA policy node. |
515861 | Some WAM/AAM policies from version 10.x might cause tmm to be killed by sod after upgrade to 11.x and applying the policy to the virtual server (through the web acceleration profile, which has the application with the associated policy). sod repeatedly kills tmm (seen as tmm crash) after the upgrade, which might eventually cause general unavailability for all virtual servers on a given BIG-IP system. The policy contains many of the following elements in the 10.x version: - regular expressions. - certain ordinal path-segment directives (including some redundant left-to-right ones which could be simplified in a single right-to-left ordinal match). Workaround: None. |
530466 | "The issue happens when MultiConnect is enabled and a resource is reloaded by a user request. If the browsers have CORS policy enforcement applied to the resource, the consequent requests for the resource are forwarded to a subdomain and a CORS header ""Origin"" is inserted into the request. In response the browser expects ""Access-Control-Allow-Origin"" header with a value allowing the subdomain as a host in the request. AAM doesn't recognize the header and just ignores it or has it passed to OWS which doesn't expect it." Lack of loading of the resource which may result in incorrect rendering of the page. An AAM policy with MultiConnect option is configured and attached to a virtual. There are resource(s) in a page are used for which CORS policy is enforced in a client browser, for example, font file for CSS. Workaround: "1) Disable MultiConnect. 2) Create an iRule to properly process Origin header." |
538309 | When a policy is changed and published, its publishing date is kept in memory and does not go into configuration file. When a configuration is reloaded with an explicit command or after reboot, it shows an incorrect policy publishing date. Reloading the configuration shows an incorrect policy publishing date, and the policy publishing history is lost. AAM is configured and has a custom policy. Workaround: None. |
Contacting F5 Networks
Phone: | (206) 272-6888 |
Fax: | (206) 272-6802 |
Web: | http://support.f5.com |
Email: | support@f5.com |
For additional information, please visit http://www.f5.com.
Additional resources
You can find additional support resources and technical documentation through a variety of sources.
- The F5 Networks Technical Support web site: http://www.f5.com/support/
- The AskF5 web site: http://support.f5.com/kb/en-us.html
- The F5 DevCentral web site: http://devcentral.f5.com/
- AskF5 TechNews
F5 Networks Technical Support
Free self-service tools give you 24x7 access to a wealth of knowledge and technical support. Whether it is providing quick answers to questions, training your staff, or handling entire implementations from design to deployment, F5 services teams are ready to ensure that you get the most from your F5 technology.
AskF5
AskF5 is your storehouse for thousands of solutions to help you manage your F5 products more effectively. Whether you want to search the knowledge base periodically to research a solution, or you need the most recent news about your F5 products, AskF5 is your source.
F5 DevCentral
The F5 DevCentral community helps you get more from F5 products and technologies. You can connect with user groups, learn about the latest F5 tools, and discuss F5 products and technology.
AskF5 TechNews
- Weekly HTML TechNews
- The weekly TechNews HTML email includes timely information about known issues, product releases, hotfix releases, updated and new solutions, and new feature notices. To subscribe, click TechNews Subscription, complete the required fields, and click the Subscribe button. You will receive a confirmation. Unsubscribe at any time by clicking the Unsubscribe link at the bottom of the TechNews email.
- Periodic plain text TechNews
- F5 Networks sends a timely TechNews email any time a product or hotfix is released. (This information is always included in the next weekly HTML TechNews email.) To subscribe, send a blank email to technews-subscribe@lists.f5.com from the email address you are using to subscribe. Unsubscribe by sending a blank email to technews-unsubscribe@lists.f5.com.