Applies To:

Show Versions Show Versions

Release Note: BIG-IP WOM version 10.2.1
Release Note

Original Publication Date: 08/27/2013


This release note documents the version 10.2.1 release of the BIG-IP® WAN Optimization Module™. To review what is new and fixed in this release, refer to New in version 10.2.1 and Fixed in version 10.2.1. For information about installing the software, refer to Installing the software.


- User documentation for this release
- Minimum system requirements and supported browsers
- Supported platforms
- Installing the software
- Upgrading from earlier versions
- New in version 10.2.1
- New in version 10.2.0
- Fixed in version 10.2.1
- Known issues

User documentation for this release

In addition to these release notes, the following user documentation is relevant to this release.

WAN Optimization Module documentation

BIG-IP system documentation

The following BIG-IP system documentation is also relevant to this release:

You can find the product documentation and the solutions database on the AskF5 web site.

[ Top ]


Minimum system requirements and supported browsers

Note: F5 Networks recommends that the BIG-IP platform on which you plan to provision the WAN Optimization Module has a minimum of 4 GB of RAM.

Note: You cannot run this software on a CompactFlash® media drive; you must use the system's hard drive.

The supported browsers for the Configuration utility and BIG-IP WAN Optimization dashboard are:

  • Microsoft® Internet Explorer®, version 6.x or version 7.0
  • Mozilla® Firefox® version 3.0x

Note: F5 Networks recommends that you leave the browser cache options at the default settings.

Important: Popup blockers and other browser add-ons or plug-ins may affect the usability of the Configuration utility. If you experience issues with navigation, we recommend that you disable these types of browser plug-ins and add-ons.

[ Top ]

Supported platforms

This release supports the following platforms:

  • 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 11050 (E106)

If you are unsure of which platform you have, refer to the sticker on the back of the chassis, which displays the platform number.

Note: The hardware and software for each unit in a redundant system configuration must match.

[ Top ]

Installing the software

This section lists only the very basic steps for installing the BIG-IP software, which includes the WAN Optimization Module. The BIG-IP® Systems: Getting Started Guide contains details and step-by-step instructions for completing an installation. F5 Networks recommends that you consult the getting started guide for all installation operations.

If the software is already installed on your hardware platform, refer to the Configuration Guide for the BIG-IP® WAN Optimization Module™.

The steps in this guide are based on the assumption that:

  • The license and service contract are already updated for this release, if applicable.
  • You downloaded the .iso file from F5 Downloads to /shared/images on the source for the operation.
    (Note that you might need to create this directory. If so, use this exact name, including capitalization.)
  • There is at least minimal partitioning on the system drives.
  • You have already configured a management port.
  • You have set the baud rate to 19200.
  • You are logged on to the management port of the system you want to upgrade.
  • You are logged on to a hard drive installation location other than the target for the operation.
  • You logged on using an account with administrative rights.
  • You have saved the user configuration set (UCS) in the /var/local/ucs directory on the source installation location, if applicable.
  • You are logged on to the standby unit in a redundant system, if applicable, and you will synchronize the configuration to the active unit.
  • You turned off mirroring, if applicable.
  • You have set provisioning for WAN Optimization Module to Minimum before upgrading.

Installation consists of the following steps.

  1. To copy the upgrade utility, run the command im (for first-time 10.x installation).
  2. To install the software and roll forward the configuration on the active installation location, use one of the following methods:
  • To format for volumes and migrate the configuration from the source to the destination (for fully 10.x environments), run the command:
    image2disk --instslot=HD<n.n> --format=volumes <downloaded_filename.iso> 

    Warning: Do not use the --nomoveconfig option described in the following procedure on systems with existing, running installations of Application Security Manager. Doing so removes all content from the associated database. Instead, ensure that the configuration on the source installation location matches the one on the destination. To do so, save the UCS configuration on the location you want to preserve, and apply that configuration to the destination before or after the installation operation.

  • To format for volumes and preserve the configuration on the destination (for fully 10.x environments), run the command:
    image2disk --instslot=HD<n.n> --nomoveconfig --format=volumes <downloaded_filename.iso>
  • To format for partitions (for mixed 9.x and 10.x environments), run the command:
    image2disk --instslot=HD<n.n> --format=partitions <downloaded_filename.iso>
  • To install from the command line without formatting (not for first-time 10.x installation), run the command:
    bigpipe software desired HD<n.n>version 10.x build <nnnn.n> product BIG-IP
  • To install from the version 10.x browser-based Configuration utility, use the Software Management screens.

After the installation finishes, you must complete the following steps before the system can pass traffic.

  1. Reboot to the new installation location.
  2. Log on to the browser-based Configuration utility.
  3. Run the Setup utility.
  4. Provision the modules.

Each of these steps is covered in detail in the BIG-IP® Systems: Getting Started Guide, and F5 Networks recommends that you refer to the guide to ensure successful completion of the installation process.

The upgrade process installs the software on the inactive installation location that you specify. This process usually takes between three 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 b software status, which runs the b software status command every two seconds. Pressing Ctrl+C stops the watch feature.

If installation fails, you can view the log file. For image2disk installations, the system logs messages to the file you specify using the --t option. For other installations, the system stores the installation log file as /var/log/liveinstall.log.

[ Top ]

Upgrading from earlier versions

The WAN Optimization Module is supported in software versions 10.1.0 and later. For information about upgrading from earlier versions, without the WAN Optimization Module, refer to Release Note: BIG-IP Local Traffic Manager and TMOS version 10.2.1.

Warning: Do not use the 10.x installation methods (the Software Management screens, the b software commands, or the image2disk utility) to install/downgrade to 9.x software or operate on partitions. Depending on the operations you perform, doing so might render the system unusable. If you need to downgrade from version 10.x to version 9.x, use the image2disk utility to format the system for partitions, and then use a version 9.x installation method described in the version 9.x release notes to install the version 9.x software.

Important: BIG-IP version 10.x introduced the ability to run multiple modules based on platform. The number and type of modules that can be run simultaneously is strictly enforced through licensing. For more information, see SOL10288: Supported product module combinations by platform for the BIG-IP version 10.x software branch.

Important: If the system you plan to upgrade has WAN Optimization Module™, WebAccelerator™, or Application Security Manager™ already provisioned or if you have a number of volumes with software installed, you might experience an upgrade failure due to insufficient space. Before you proceed, set the module provisioning to Minimal, or remove unneeded volumes and reboot the system. After installation is complete, you can set the provisioning back to its original setting.

Upgrading from earlier 10.x versions

When you upgrade from earlier 10.x software versions, you can 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, or the relevant chapters in the BIG-IP® Systems: Getting Started Guide.

[ Top ]

New in version 10.2.1

The current release introduces the following feature.

Optimized application for NetApp FlexCache
You can now set up application optimization for NetApp FlexCache by simply checking a box on the Quick Start screen. When you check the NetApp FlexCache box, the system automatically creates the necessary virtual servers with the correct optimization features enabled and tuning parameters set for this application.

[ Top ]

New in version 10.2.0

The 10.2.0 release introduced the following features.

Enhanced user interface
The new Quick Start screen gives you a quick and easy way to configure the WAN Optimization Module, all on one screen. On the same screen, you can set up application optimization by simply checking (enabling) the applications you want to optimize. Then, the system automatically creates the necessary virtual servers with the correct optimization features enabled and tuning parameters set.

iSession support for live VMware migration
The iSession connections available with the WAN Optimization Module can optimize traffic when the BIG-IP® Local Traffic Manager migrates virtual machine servers between data centers. You can configure an EtherIP tunnel to ensure that the BIG-IP system retains connections to the virtual machines during and after the live migration.

iSession support for BIG-IP Virtual Edition
The WAN Optimization Module allows the BIG-IP® Virtual Edition to perform TCP Optimization and Adaptive Compression across a WAN with up to 50Mbps of compression.

Traffic Management Shell (tmsh) support for WCCPv2
Command line support is available for Web Cache Communication Protocol (WCCPv2), a content-routing protocol developed by Cisco Systems, which provides a mechanism to redirect traffic flows in real time. The primary purpose of the interaction between WCCPv2-enabled routers and a BIG-IP® system is to establish and maintain the transparent redirection of selected types of traffic flowing through those routers.

[ Top

Fixed in version 10.2.1

The current release includes the fixes and enhancements from previous releases, plus the following.

CIFS-related wocplugin core when accessing large files through the WAN Optimization Module on a congested network. (ID 339140, C726495-1)
Code updates fixed an issue with the wocplugin writing out a core file when the WAN Optimization Module accessed large CIFS files on a congested network.

[ Top ]

Known issues

Traffic blocked if self IP Port Lockdown is set to Allow Default (CR109093)
If you are using a self IP address for the WAN Optimization Module and the Port Lockdown setting of the self-IP address on the server-side endpoint is set to Allow Default (the default value), certain types of TCP and UDP traffic are blocked; for TCP: SSH, domain, SNMP, HTTPS, and 4353; and for UDP: domain, SNMP, EFS, 1026, and 4353. You must set the self IP address to Allow None (the command line default) to successfully optimize all types of traffic.

No warning when advertised routes conflict with remote routes (CR109097)
The system does not log a warning if local advertised routes conflict with advertised routes on remote endpoints. Having two systems with conflicting routes is most likely a configuration error.

Using dashboard with Internet Explorer 6 (CR109099)
When you are using Internet Explorer 6 to display the dashboard, the system may display a message about mixed https and http on the page. This is a known issue in version 6, and Microsoft has fixed it in Internet Explorer 7. You may ignore the message. All communications remain secure.

Compression configuration changes may require clearing RAM cache (CR114972)
If you change the compression or deduplication options for the iSession profile on a BIG-IP® system that is running both the WAN Optimization Module and the WebAccelerator system, you must also clear the RAM cache from the command line. To clear the RAM cache, use the b profile http <http profilename> ramcache entry all delete command. If you do not clear the RAM cache after changing these options, the WebAccelerator system may not accelerate the HTTP traffic as expected.

Problem opening dashboard with Firefox (CR 125095)
If you are using a Firefox version earlier than v3.0 and a Flash plug-in earlier than version 9, Firefox issues a shockwave flash error when you attempt to launch the dashboard. To avoid this problem, install the latest version of Firefox.

Deleted remote endpoint remains on dashboard (CR 128182)
If you remove all remote endpoints from a configuration, any active dashboard continues to show the last remote endpoint as connected. To refresh the screen, close the dashboard and then reopen it.

CIFS read optimization not working with smbclient (CR 128965)
If you use the smbclient (version 3.2 or later) program to get a file, CIFS read optimization does not occur.

FTP data ports changed (CR 129753)
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. In both cases, the data transfers are successful.

Creating a new folder on mapped drive is taking too long (CR 130507)
If you map a network drive and create a new folder, it takes more than 10 seconds for the folder to appear in the directory and does now allow you to name the folder. To name the folder, right-click it and select rename.

Statistics not reset (CR 131638)
Using the bigpipe command b profile tcp all stats reset fails to reset the statistics for woctunnel_tcp.

Datastor cache size is limited to 4096 MB (CR 131957)
The size of the datastor cache may not be sufficient to support some configurations.

Provisioning the WAN Optimization Module with another module and disk mode disabled results in a datastor size of 0 (CR 132785)
If the datastor disk mode is disabled when you provision the WAN Optimization Module along with any other module and then you enable the datastor disk, you must restart the system to show the correct datastor size.

Dashboard graphs for Bandwidth Gain display random peaks of double bandwidth (CR 132950-1)
When the BIG-IP system is under a heavy load, you may see occasional spikes on the Bandwidth Gain graphs on the WAN Optimization dashboard. A system delay in reporting the statistics to the dashboard causes the delay, which is usually about twice the average amount.

Rate shaping with packet filters fails (ID 334135 and ID 334136)
Using packet filters for rate shaping on the server side WAN Optimization Module may fail in some cases. Alternatively, use packet filters on the WAN side with endpoint addresses and traffic types, or use iRules®.

Deduplication connection error with removal of peer (ID 342251)
If you are trying to remove the WOM connection between two peers, you must delete the remote endpoint before you delete the local endpoint to prevent reconnection. If you are using the browser interface, the procedure is as follows:

  1. On the Dynamic Discovery screen, disable the settings Allow Remote Endpoints to Discover This Endpoint and Automatically save discovered Remote Endpoints.
  2. On the Remote Endpoints screen, select the remote endpoint and click Delete.
  3. On the Local Endpoint screen, click Delete.

[ Top

Contacting F5 Networks

  Phone: (206) 272-6888
Fax: (206) 272-6802

For additional information, please visit

Was this resource helpful in solving your issue?

NOTE: Please do not provide personal information.

Incorrect answer. Please try again: Please enter the words to the right: Please enter the numbers you hear:

Additional Comments (optional)