Applies To:

Show Versions Show Versions

Release Note: BIG-IP WOM version 10.1.0
Release Note

Updated Date: 02/21/2010


This release note documents the version 10.1.0 release of the WAN Optimization Module. To review what is new and fixed in this release, refer to New in version 10.1.0 and Fixed in version 10.1.0. 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.1.0
- Fixed in version 10.1.0
- Features introduced in version 10.0
- 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.

The supported browsers for the Configuration utility and BIG-IP Dashboard are:

  • Microsoft® Internet Explorer®, version 6.x or version 7.0
  • Mozilla® Firefox® 1.5x, version 2.0x, version 3.0x and other browsers that use the Mozilla engine

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)

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

[ 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 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.
  • If you are upgrading from 9.3.x or 9.4.x, you have run im <downloaded_filename.iso> to copy over the new installation utility.

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, use one of the following methods:
    • Run the command image2disk --instslot=HD<volume_number> <downloaded_filename.iso> (for first-time 10.x installation).
    • Run the command bigpipe software desired HD<volume_number>version 10.1.0 build <nnnn.n> product BIG-IP
    • Use the Software Management screens in the browser-based Configuration utility.

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 b software status.

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

How you upgrade from earlier versions depends on the version of software you have.

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 version 9.6.x or earlier 10.x versions

When you upgrade from software version 9.6.x or earlier 10.x 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.

Important: If you are upgrading to BIG-IP version 10.1 or later and you want to maintain a mixed 9.x and 10.x environment, you must format the drive for the larger, version 10.x partition size. The 10.1 and later versions of the software do not fit in partitions created using the version 9.x disk formatting options.

Upgrading from version 9.3.x or 9.4.x

If you plan to install this version of the software onto a system running 9.3.x or 9.4.x, you must perform a one-time upgrade procedure to make your system ready for the new installation process. When you update from software version 9.3.x or 9.4.x to 10.x, you cannot use the Software Management screens in the Configuration utility. Instead, you must run the image2disk utility on the command line. For information about using the image2disk utility, see the BIG-IP® Systems: Getting Started Guide.

[ Top ]

New in version 10.1.0

Dashboard customization
The Dashboard is a graphical interface that you use to monitor system statistics. In addition to being able to view overall performance statistics for the system and details about the WAN Optimization Module, you can now create, save, and export custom dashboard views.

Quick diagnostics screen
The user interface includes a troubleshooting screen for verifying the WAN Optimization Module configuration and diagnosing network connection problems.

Traffic Management Shell (tmsh) support
You can use the tmsh command line utility to configure the WAN Optimization Module.

Flexible CIFS optimization
The WAN Optimization Module can handle different versions Common Internet File System (CIFS) traffic and different optimization specifications.

FTP optimization
The WAN Optimization Module can now optimize File Transfer Protocol (FTP) traffic.

Deflate compression level
If you are using the Deflate compression algorithm for symmetric adaptive compression, you can now adjust the level of compression in a range that balances making more matches with taking less time.

[ Top ]


Fixed in version 10.1.0

Active FTP data connections not optimized (CR108811)
The WAN Optimization Module now supports optimizing active FTP data connections.

Disabling local endpoint on receiving side WAN Optimization Module (CR114939)
If you disable the local endpoint on the receiving (server) side WAN Optimization Module, the systems stop optimizing traffic between the two endpoints. In the previous release, disabling the local endpoint did not stop optimization.

Disabling Address Translation for virtual servers optimizing traffic (CR115250)
Disabling the Address Translation setting isno longer required for virtual servers that optimize traffic. In the previous release, if you use the command line or Local Traffic Manager to create a virtual server that optimized traffic and the virtual server had a Destination setting of type Host, the Address Translation setting defaulted to Enabled. In the previous release, F5 Networks recommended that you disable this setting.

Effect on deduplication of manually changing system time (CR115749)
Manually changing the system time to an earlier time no longer causes a restart of the WAN optimization services related to data deduplication.

[ Top ]

Features introduced in version 10.0

Performance Dashboard
The Dashboard is a graphical interface that you use to monitor system statistics. On the Performance Overview screen, you can view overall statistics for the system, including CPU and memory usage, the number of connections, and system throughput. You can view details about the WAN Optimization Module on the WAN Optimization screen.

Dynamic Discovery
Dynamic Discovery is a process through which the WAN Optimization Module identifies and adds remote endpoints automatically, saving configuration time.

TCP optimization
The WAN Optimization Module employs adaptive TCP optimization to speed up traffic using techniques such as session-level application awareness, persistent tunnels, selective acknowledgements, error correction, and optimized TCP windows.

Symmetric Data Deduplication
Symmetric Data Deduplication uses references to previously transmitted data to reduce the amount of bandwidth it takes to transfer data over the WAN.

Symmetric Adaptive Compression
Symmetric Adaptive Compression compresses data through the use of dictionary-based compression and advanced encoding schemes.

CIFS optimization
The WAN Optimization Module can optimize Common Internet File System (CIFS) traffic, resulting in faster performance during file transfer, when downloading or saving files, when opening Microsoft applications, and when browsing directories on networked drives.

MAPI optimization
The WAN Optimization Module can optimize MAPI (Messaging Application Program Interface) traffic to reduce the amount of bandwidth required to transfer email traffic over the WAN.

NAT traversal
The WAN Optimization Module supports deployments where one or both of the BIG-IP systems are behind a Network Address Translation (NAT) router.

WCCPv2 support
Web Cache Communication Protocol (WCCP) is available in the Network section of the navigation pane when the WAN Optimization Module is provisioned. The BIG-IP system supports WCCP version 2. You can use the WCCP feature in a deployment where the WAN Optimization Module is located out-of-path, that is, not inline. The benefit is that if the device fails, the WCCP feature automatically bypasses the failed device.

TOS/DSCP bits preserved
The WAN Optimization Module preserves Type of Service (TOS) priorities or Differentiated Services Codepoint (DSCP) values for traffic moving through the tunnel.

[ 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.

Disabling all compression settings on iSession profile (CR111261)
When creating an iSession profile, you need to enable at least one compression setting. If you inadvertently create an iSession profile with all compression settings disabled, you may receive a warning when you associate the profile with a virtual server that states that Method null must be enabled if all other methods are disabled. The message means if you do not want compression to occur on connections, you must enable the Null compression setting on both the local and remote endpoints. In any case, at least one compression setting must be the same on both the local and remote endpoints (even if it is Null) for any connections to be established between them.

Dashboard Overview CPU table view missing state for some CPUs (CR 113126, CR117070)
When you look at the table view of the CPU panel of the dashboard, state information may be missing for some CPUs. This occurs because more than one CPU on a multi-core system share a fan and thermometer, and the system reports the status for only one of the CPUs.

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.

Per-profile CIFS statistics missing (CR 127887)
Per-profile statistics are not available for CIFS profiles.

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.

System allows user to create local endpoint using IP address that is not a self IP address (CR 130087)
The user interface fails to validate the IP address entered for the local endpoint. When you create a local endpoint, make sure that you correctly enter an existing self IP address.

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.

Removing and then adding a CIFS virtual server may cause iSession statistics to reset (CR 130516)
If you disable a CIFS virtual server that is passing traffic, and then disable it, when you re-enable it, the iSession statistics reset to 0 (zero).

No tmsh support for WCCPv2 (CR 130580)
This release does not include Traffic Management Shell (tmsh) support for WCCPv2. Command line support for WCCPv2 is available in the bigpipe shell and through the user interface.

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.

Deduplication may restart unexpectedly after mode change (CR 131981)
After you change the deduplication mode, you must restart the system on the command line using the command bigstart restart.

FTP optimization supports NAT traversal only with port transparency enabled (CR 132112)
For FTP optimization with NAT traversal, make sure the Port Transparency setting in the iSession profile is enabled.

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.

[ 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)