Release Notes for WebSphere Partner Gateway - Express, Version 6.0
These release notes cover release information for IBM(R) WebSphere(R) Partner Gateway - Express, Version 6.0. They contain the following sections:
Note: Important information about this product may be available in Technical Support Flashes issued after these release notes were published.
These can be found on the WebSphere Partner Gateway support Web site, http://www.ibm.com/software/integration/wspartnergateway/support. Select the component area of interest and search the flashes section.
New in this release
This section lists the new features and improvements made in this release.
- WebSphere Business Integration Connect - Express has been renamed WebSphere Partner Gateway - Express.
- Support for new operating systems has been added: Windows 2003, RedHat
Enterprise Linux 3.0, SuSE Linux Enterprise Server 9, i5/OS V5R3.
- Support for using a service daemon on a Linux system has been added.
- License inventory support has been added for IBM Tivoli License Manager
(ITLM) on Windows and Linux platforms.
- A basic authentication feature has been added to AS2 support. You can now
identify partners by the AS2 identifier or basic authentication values.
- Polling intervals and timeout values are now configurable using the properties
files.
- Enhanced security functionality has been added, including Certificate Path
Validation; Certificate Revocation List management and CRL distribution
point support; and key usage and extended key usage enforcement during
certificate upload.
Product fix history
The following problems, based on customer-reported cases for WebSphere
Business Integration Connect - Express, Version 4.2.1, have been fixed
in this release of WebSphere Partner Gateway - Express, Version 6.0.
APAR |
Description |
JR19749 |
Certificates generated incorrectly with the extension "critical". |
JR20027 |
A SocketListener exception was logged. |
JR20154 |
AS2 document failures were generated with third-party partner software. |
JR20392 |
The document viewer for WebSphere Business Integration Connect - Express
needed support for BIG5, S-JIS, and so on. |
JR20741 |
WebSphere Business Integration Connect - Express was unable to process
MDN from third-party software. |
JR20930 |
FileNotFoundException was returned on OS/400. |
Backward compatibility
WebSphere Partner Gateway - Express, Version 6.0, is functionally backward compatible for partner-to-partner integration
with its predecessor, WebSphere Business Integration Connect - Express, Version 4.2.1.
Product compatibility
WebSphere Partner Gateway - Express, Version 6.0, is eBusinessReady-certified for AS2.
Refer to http://www.ebusinessready.org for more information.
Hardware and software requirements
Hardware and software requirements are included in the product documentation. See Installation, migration, upgrade, and configuration information for links to those guides.
Installation, migration, upgrade, and configuration information
Whether you are installing the software from the CD or downloading it from
Passport Advantage and installing it from a local directory, refer to the
User Guide. The guide also includes general migration, upgrade, and configuration
information.
The following notes provide additional installation, upgrade, and configuration information:
- Certificate Revocation List distribution points are now supported in WebSphere Partner Gateway - Express, Version 6.0. To enable this, refer to the section
"Running the bcgSetCRLDP.jacl script" of the user guide.
- WebSphere Business Integration Connect - Express, Version 4.2.1, supported
RedHat Enterprise Linux (RHEL) Advanced Server, Version 2.1. WebSphere Partner Gateway - Express, Version 6.0, drops support for that Linux version,
but it includes support for RHEL 3.0.
- New properties allow configuration of the polling intervals and timeout values used in WebSphere Partner Gateway - Express, Version 6.0. Refer to the user guide for details.
Limitations
WebSphere Partner Gateway - Express, Version 6.0, uses only the Triple
DES encryption algorithm for outbound transactions.
Known problems and workarounds
The following problems have been found in this release:
- The installer for WebSphere Partner Gateway - Express does not allow you
to set the autostart property when installing as a Windows service. Set
the service properties using the Windows services controls.
Note: This problem applies only to Windows operating systems.
- Input fields in the WebSphere Partner Gateway - Express installation wizard appear with a gray background.
However, port numbers, paths, and other input requests from the installer are input-capable
and can be modified.
- The ikeyman.bat or ikeyman.sh utility in the Express_root\was\bin directory for WebSphere Partner Gateway - Express does not work
if the product is installed to a path containing space characters. If you
are installing the product to a directory whose path contains spaces, edit
the ikeyman.bat or ikeyman.sh utility as follows to add double quotation
marks around the indicated path. Change the following line:
cscript //NoLogo %WAS_HOME%\bin\GetGSKITInstallPath.vbs
to
cscript //NoLogo "%WAS_HOME%\bin\GetGSKITInstallPath.vbs"
Note: This problem does not apply to OS/400 or i5/OS
- The My Profile company address field may appear incorrect after an upgrade
and data migration from WebSphere Business Integration Connect - Express,
Version 4.2.1. Update the value using the Configuration/My Profile tab
in the WebSphere Partner Gateway - Express console.
- Incorrect keystore and truststore configuration in WebSphere Business Integration
Connect - Express, Version 4.2.1, causes WebSphere Partner Gateway - Express,
Version 6.0, startup failures after an upgrade and data migration.
If security has been fully configured for WebSphere Business Integration
Connect - Express, Version 4.2.1, this should not be a migration problem.
If security was not properly configured, WebSphere Partner Gateway - Express,
Version 6.0, does not start, and the SystemOut.log file in the bcgexpress
WebSphere Application Server profile logs directory does indicate a transport
startup failure with FileNotFoundException.
Before upgrading
To avoid this problem, check the following properties in WebSphere Business
Integration Connect - Express, Version 4.2.1, before performing the upgrade
and data migration procedures for WebSphere Partner Gateway - Express V6.0.
In the Express421_Root\config\bcg.properties file (on OS/400, the path is /QIBM/UserData/WBICExpress42/config/bcg.properties):
- bcg.connector.keystore should be set to an existing keystore file; if it is not, replace with bcg.connector.keystore=
- bcg.connector.truststore should be set to an existing truststore file; if it is not, replace with bcg.connector.truststore=
After upgrading
If you encounter this problem:
- Open the security.xml file with a text editor. Locate this file:
- On Windows and Linux: Express_root\was\profiles\bcgexpress\config\cells\DefaultNode\
- On OS/400 and i5/OS: /QIBM/UserData/WebSphere/AppServer/V6/Base/profiles/bcgexpress/config/cells/DefaultNode/
- Search for xmi:id="SecureSocketLayer_1"
- Update with the following property settings to restore the default values:
- keyFileName="${USER_INSTALL_ROOT}/etc/DummyServerKeyFile.jks"
- keyFilePassword="{xor} CDo9Hgw="
- keyFileFormat="JKS"
- trustFileName="${USER_INSTALL_ROOT}/etc/DummyServerTrustFile.jks"
- trustFilePassword="{xor} CDo9Hgw="
- trustFileFormat="JKS"
- Save the file
- Start the WebSphere Partner Gateway - Express, Version 6.0, server as directed
in the documentation.
- While uploading a certificate or keystore, if the exception message "Unsupported
keysize or algorithm parameters" is displayed, the certificate or
keystore is not compatible with the current jurisdiction policy files.
Unrestricted jurisdiction policy files can be used, if permitted.
To install unlimited jurisdiction policy files in WebSphere Partner Gateway,
follow these steps:
- Download the unlimited jurisdiction strength policy files from the IBM SDK Policy files link at http://www.ibm.com/developerworks/java/jdk/security/142/.
- Unzip the downloaded file to a temporary folder.
- In the was\java\jre\lib\security subdirectory of the WebSphere Partner
Gateway - Express installation, rename these files:
local_policy.jar
US_export_policy.jar
to
local_policy.jar.bak
US_export_policy.jar.bak
- Copy local_policy.jar and US_export_policy.jar from the temporary folder
to the was\java\jre\lib\security subdirectory of the WebSphere Partner
Gateway - Express installation.
If unrestricted policy files cannot be used, the keystore and certificates
used for the product must be compatible with the restricted policy files.
Note: For OS/400 and i5/OS, this problem is unlikely to affect you. The IBM
unrestricted policy files are shipped with the 5722-AC3 product and are
used by the 1.4.2 Java Development Kit, on which WebSphere Partner Gateway
- Express runs. If you use the restricted files for regulatory compliance,
you must assure that compatible keystore and certificates are uploaded
to the product.
- If revocation status of a certificate cannot be determined, the certificate
is considered valid. To avoid this situation, current Certificate Revocation
Lists (CRL) from the issuers should be available either in the local CRL
directory or in the CRL Distribution Point (if enabled).
- You cannot enter the system name at the OS/400 sign-on prompt during a
remote installation from Japanese, Korean, Simplified Chinese, or Traditional
Chinese workstations. To work around this, click in the User ID field and
press the Tab key until the cursor is active in the System field. You can
then enter values for all fields in the prompt.
- APAR SE19477 - OS/400 (i5/OS)
A BufferOverflowException might occur on the outbound transaction of very
large documents (those larger than 25 megabytes) from WebSphere Partner
Gateway - Express, Version 6.0. on OS/400 or i5/OS. This will be fixed
with an updated patch level of the Java Development Kit 1.4.2 for OS/400
and i5/OS. Load and apply the prescribed PTF for your operating system
version identified for the APAR.
Documentation
Product documentation is not included as part of the product package, either
by CD or electronic product distribution. The documentation for this product
can be found in the following information center:
http://www.ibm.com/software/integration/wspartnergateway/express/library/infocenter/
To obtain the product documentation, visit the Web site and download the current documentation set for the release that you are using. Follow the instructions provided on the information center page to complete the installation.
