IBM WebSphere DataPower Integration Appliance XI50 and XI52 and DataPower Integration Blade XI50B firmware release 4.0.2 is available. Compatibility, installation, and other getting-started issues are addressed.
The WebSphere DataPower SOA Appliances 4.0.2 product announcements are available:
- IBM Asia Pacific Hardware Announcement AG11-0172
- IBM Canada Ltd. Hardware Announcement A11-0727
- IBM Europe, Middle East, and Africa Hardware Announcement ZG11-0271
- IBM Latin America Hardware Announcement LG11-0245
- IBM United States Hardware Announcement 111-163
See the announcement for the following information:
- Detailed product description
- Product-positioning statement
- Ordering details
New features and enhancements description
WebSphere DataPower Integration Appliances release 4.0.2 offers the following new features and enhancements and resolved APARs.
For more information, see the referenced topics in the WebSphere DataPower Integration Appliances Version 4.0.2 Information Center available from the DataPower documentation portal.
Standby Control enhancements
- Supports the ability to perform Address Resolution Protocol (ARP) based takeovers, instead of MAC based takeovers, using a network setting that is enabled by default.
- Adds the ability for a newly active Application Optimization (AO) self-balancing standby control group member to rebuild the correct connection table after a standby control takeover. This allows self-balanced TCP connections to continue after a standby control takeover.
Service Level Monitors
- Supports the ability to configure a Service Level Monitor (SLM) policy to place limits on both transactional concurrency and an arbitrary resource object. This feature allows setting an SLM threshold level value to specify the number of concurrent transactions that are allowed at a time before the administrative action occurs. For more information, see the information center section on SLM and threshold interval types.
- Supports the ability to determine the return value from an SQL stored procedure when the data source is a DB2 database. The sql-execute extension element captures the integer value returned in the form of an output parameter. For more information, see the information center for the syntax of the sql-execute extension element and an example.
- On appliances with the DataGlue feature, supports 18-digit precision in both the request and response directions when processing numeric values from COBOL Copybook to XML. This 18-digit precision support is now also available with Contivo Analyst generated flat file descriptor (FFD) files. To maintain that precision inside a stylesheet, use the DataPower xs:decimal feature. For more information regarding FFD files, see Obtaining the FFD Programming Guide.
Enhanced security features
- Tivoli Security Policy Manager
Support TSPM 18.104.22.168 method of policy distribution. For more information, see "Distributing the Tivoli Security Policy Manager policy to the DataPower PDP" in the information center.
Support the use of Kerberos token for map credentials and Authorization stages of AAA. For more information, see "Resolving roles with credential mapping" in the information center.
For a list of the APARs that WebSphere DataPower Integration Appliances release 4.0.2 has resolved, see resolved APARs.
Compatibility with earlier releases
Compatibility issues with earlier firmware releases are documented as individual technotes in the Support knowledge base. The following link launches a customized query of the live Support knowledge base. The compatibility issues that are known to exist in the current release of the WebSphere DataPower Integration Appliances are provided.
View known compatibility issues for WebSphere DataPower Integration Appliances
For additional information about problems in current releases, refer to the DataPower support site .
System requirements and product compatibility
For hardware specifications, see the installation documentation for your appliance in the DataPower SOA Appliances Information Center available from the DataPower documentation portal.
Release 4.0.2 is compatible with the following products:
Support is provided for the following IBM WebSphere Application Server, Network Deployment (ND) editions for use with Application Optimization: Application Intelligence:
- ND 22.214.171.124 plus APAR PM11618
- ND 126.96.36.199 or later
- ND 188.8.131.52 plus APAR PM11618
- ND 184.108.40.206 or later
For more information, see APAR PM11618.
- VE 220.127.116.11 plus APAR PM11623, APAR PM07024, 18.104.22.168-WS-WXD-IFPK94777_XD.pak, and 22.214.171.124-WS-WXDOP-IFPM13014.pak
- VE 126.96.36.199 or greater
For more information, see APAR PM11623 and PM07024.
Secure Cloud Connector supports the following protocols:
- SSH-2 protocol defined by IETF RFC 4251
z/OS Communications Server Network Security Services server
z/OS Communications Server, V1R11
- Support for the sysplex distributor feature requires z/OS Communications Server V1R11 plus APAR PM14365 applied using SMP/E. If a PTF is not available, request a ++APAR from IBM z/OS Communications Server Level 2 support.
- For the AO option, ND 6.0 will continue to work with the ODCInfo_ND60.war application. However, this capability is limited to the Intelligent Load Distribution functions that were shipped in DataPower Firmware release 3.8.0. The extended Application Intelligence functions of Application Routing, Group Rollout, and Atomic Rollout require ND 6.1 or ND7.0.
Application and Web servers
Any server that conforms to the standards that the DataPower appliance supports.
Support provided for the following database servers:
- DB2: all supported versions up to 9.5
- Microsoft SQL Server: all supported versions up to 2008
- Oracle: all supported versions up to 11g R1 (11.1)
- Sybase: all supported versions up to 15
Information Management System
IBM Information Management System (IMS) Version 9 and 10
Any LDAP server that is compliant with the following versions:
- LDAP Version 2
- LDAP Version 3 when retrieving CRLs.
Microsoft .NET Windows Communication Foundation
Microsoft .NET Windows Communication Foundation (WCF) integration has the following requirements:
- WCF 3.5 or newer
- Windows 2003 Server or newer as the KDC if using the Kerberos token feature.
- Intel iSCSI Software Target Version 2.0.17
- SourceForge iSCSI Enterprise Target Version 0.4.15 and 188.8.131.52
Note: The Intel iSCSI Software Target Version 2.1.0 is not a supported iSCSI target.
The following SFTP clients are supported:
- SSH Secure Shell OpenVMS (V5.5) 3.2.0 - SFTP protocol V3 (Tested on OpenVMS Industry Standard 64 Operating System, Version V8.3 )
- CuteFTP Professional 8.3
- OpenSSH 3.9p1 (Red Hat Linux ES V4.8)
- OpenSSH 4.3p2 (Red Hat Linux ES V5.5)
- OpenSSH 3.8.1p1 (Windows XP)
- PuTTY PSFTP, Version 0.60
- SmartFTP, Version 4.0.
- Sun Microsystems, Sun_SSH_1.1.1
SSH File Transfer Protocol (SFTP) Support
The supported protocols are as follows:
- SSH-2 protocol defined by IETF RFC 4251
- SFTP Version 3 defined by the draft-ietf-secsh-filexfer-02.txt Internet-Draft
TIBCO Enterprise Message Service
TIBCO Enterprise Message Service (EMS), Versions 4.3, 4.4, 5.0, and 5.1
Tivoli Access Manager
IBM Tivoli Access Manager, Version 6.0 and 6.1
Tivoli Federated Identity Manager
IBM Tivoli Federated Identity Manager, Version 6.0.1, 6.1 and 6.2
Tivoli Security Policy Manager
IBM Tivoli Security Policy Manager, Version 7.0 fix pack 2 and Version 184.108.40.206
- Mozilla Firefox, Version 3.5.x and later
- Mozilla Firefox, Version 3.6.x and later
- Microsoft Internet Explorer, Version 7 or 8
WebSphere Java Message Service
IBM WebSphere Java Message Service (JMS), Version 7.0
IBM WebSphere MQ, Version 6.0 and 7.0, as a remote server.
Note: If using MQ with SSL, either upgrade MQ to use GSKit Version 8 or configure the appliance to permit insecure connections. See technote 1469498, "Firmware 4.0.0 changes the default behavior for DataPower SSL connectivity with MQ" for more information.
WebSphere Service Registry and Repository
Support is provided for the following IBM WebSphere Service Registry and Repository releases (minimum versions):
- WSRR 220.127.116.11 ("Instance prefix" installations are not supported on this firmware release. See technote 1503954, "DataPower has limited support for WSRR 7.5 shared cell topology" for more information.)
- WSRR 18.104.22.168 (which include APAR IZ71003)
- WSRR 22.214.171.124 plus APAR IZ71003
- WSRR 126.96.36.199 plus APAR IZ71003
- WSRR 188.8.131.52 (limited support for WSRR Subscriptions features. See technote 1503848, "Deprecated features in the 4.0.1 IBM WebSphere DataPower SOA products" for more information.)
- WSRR 184.108.40.206 (limited support for WSRR Subscriptions features. See technote 1503848, "Deprecated features in the 4.0.1 IBM WebSphere DataPower SOA products" for more information.)
Contact IBM WSRR Support for access to APAR IZ71003 and the recommended fixes
- Support for WSRR subscriptions' "Automatic" synchronization feature requires WSRR 220.127.116.11 (or higher)
- Support is provided for WS-Policy Attachment files authored with WSRR Policy Editor 18.104.22.168 plus APAR IZ71003 or later.
- Supports implementing Web Service Proxy configurations with WSDL files returned from a WSRR Saved Search when the WSRR server is WSRR 22.214.171.124 plus APAR IZ71003 or later.
WebSphere Transformation Extender
- To create maps or recompile existing maps to run in the recommended DPA (DataPower Appliance) mode with extended support for component rules, use WebSphere Transformation Extender Design Studio Version 126.96.36.199 or later. With Version 188.8.131.52 and later, support for component rules is extended beyond support for constant and ODO-style (OCCURS DEPENDING ON) component rules. Support for component rules has the same restrictions as map rules. With Version 184.108.40.206 or later, support for NULL value is extended to non-XML character text beyond support in binary text.
- To create maps or recompile existing maps to run in the recommended DPA mode with the more limited support for constant and ODO-style component rules, use one of the following versions of WebSphere Transformation Extender Design Studio:
- Version 220.127.116.11 or later
- Version 18.104.22.168 with IF3 or later
- IBM Integration Designer, Version 7.5 .
- Any XML tool that generates XSLT 1.0 for XML-to-XML.
- For non-XML, compatible versions of WebSphere Transformation Extender (WTX) Design Studio.
For installation instructions, see the installation documentation in the DataPower SOA Appliances Information Center available from the DataPower documentation portal.
Known problems and limitations
Known problems and limitations are documented as individual technotes in the Support knowledge base. As problems are discovered and resolved, the IBM Support team updates the knowledge base. By searching the knowledge base, you can quickly find workarounds or solutions to problems.
The following link launches a customized query of the live Support knowledge base. The limitations and problems that are known to exist in the current release of the WebSphere DataPower Integration Appliances are provided with a workaround, if available.
View known problems and limitation for WebSphere DataPower Integration Appliances
For additional information about problems in current releases, see the DataPower support site.
This section summarizes deprecated features in the product offerings comprising WebSphere DataPower SOA Appliances release 4.0.2. The following information summarizes what is deprecated. Where possible, a recommended migration action is provided.
View deprecated features for WebSphere DataPower SOA Appliances
No features were removed in this release.
Contacting IBM Support
To report a problem to IBM Support, see Contacting IBM WebSphere DataPower Appliances Support.