Release Notes
Abstract
The Release Notes contain information about disk space requirements, installation, new features, fixes, and known issues in IBM® Sterling B2B Integrator Version 5.2.6.3.
Content
- About this release
- Downloading IBM Sterling B2B Integrator
- What's new, changed, and removed in this release
- Disk space requirements and system requirements
- Version 5.2.6 frequently asked questions
- Installing IBM Sterling B2B Integrator
- Upgrade impacts
- Known issues
- APARs
- Contacting customer support
- Notices and trademarks
=====================================================================
1. ABOUT THIS RELEASE
=====================================================================
Sterling B2B Integrator Version 5.2.6.3 is available. For detailed information about this release, including enhancements, fixes, and known issues, see the following sections.
=====================================================================
2. DOWNLOADING IBM STERLING B2B INTEGRATOR
=====================================================================
For information on downloading Sterling B2B Integrator from IBM Passport Advantage, see the Version 5.2.6.3 download document.
=====================================================================
3. WHAT'S NEW, CHANGED, AND REMOVED IN THIS RELEASE
=====================================================================
Sterling B2B Integrator contains the following new features:
- Stack Updates:
- Removed support for the following items:
- AIX 6.1 Operating System
- MySQL DB
- Security Fixes:
- See the following security bulletins for more information:
http://www-01.ibm.com/support/docview.wss?uid=swg21995886
http://www-01.ibm.com/support/docview.wss?uid=swg21995794
http://www-01.ibm.com/support/docview.wss?uid=swg21995893
For detailed information on product enhancements and support changes, see What's New.
=====================================================================
4. DISK SPACE REQUIREMENTS AND SYSTEM REQUIREMENTS
=====================================================================
This release of Sterling B2B Integrator requires approximately 2.5 GB for the Installation wizard files, 2 GB for the Sterling B2B Integrator JAR file, and 1.5 GB for the Sterling B2B Integrator patch JAR file.
Additional installation space requirements include:
- Minimum requirement for memory spaces (RAM) 4 GB
- Minimum requirement for disk space 15 GB
The following stack updates have been made in this release:
- Removed support for the following items:
- - AIX 6.1 Operating System
- MySQL DB
For detailed information about hardware and software compatibility, see Sterling B2B Integrator V5.2.6 System Requirements.
=====================================================================
5. VERSION 5.2.6 FREQUENTLY ASKED QUESTIONS
=====================================================================
For frequently asked questions regarding this release, including information on Sterling B2B Integrator, Global High Availability Mailbox, and installation, click here.
=====================================================================
6. INSTALLING IBM STERLING B2B INTEGRATOR
=====================================================================
Check the Sterling B2B Integrator Version 5.2.6 System Requirements before installing or upgrading to ensure that your database and operating system versions are still supported, and update them as necessary. Note that only Java SE Development Kit Version 7 is allowed.
Users who are upgrading from Sterling B2B Integrator Version 5.2.x, who may be accustomed to downloading a smaller jar file to install their upgrades, must now download the large file.
As of V5.2.6.0, you must use IBM Installation Manager to install or update Sterling B2B Integrator on Windows and UNIX operating systems.
For step-by-step installation instructions, see the installation and upgrade documentation in the Knowledge Center. If you are downloading Sterling B2B Integrator from Passport Advantage, see the download document on the IBM Support Portal.
NOTE:
- While installing Sterling B2B Integrator v5.2.6.3, you may see the following exception in the InstallService.log:
Processing pre service install tasks...Running...platform_ifc_core.scripts.PreServiceInstall
Service pre process, place preinstallfiles into places
java.io.IOException: Invalid keystore format
at com.ibm.crypto.provider.JceKeyStore.engineLoad(Unknown Source)
at java.security.KeyStore.load(KeyStore.java:1238)
at com.sterlingcommerce.security.keystoreprovider.SCIKeyStore$FormattedInputStream.load(SCIKeyStore.java:430)
at com.sterlingcommerce.security.keystoreprovider.SCIKeyStore$FormattedInputStream.access$000(SCIKeyStore.java:409)
at com.sterlingcommerce.security.keystoreprovider.SCIKeyStore.engineLoad(SCIKeyStore.java:97)
at java.security.KeyStore.load(KeyStore.java:1238)
at com.sterlingcommerce.security.kcapi.PrivateKeyInfo.getCertificate(PrivateKeyInfo.java:2533)
at platform_ifc_core.scripts.PreServiceInstall.doPreInstallTasks(PreServiceInstall.java:145)
This error message is expected if you are upgrading or patching your system to Version 5.2.6.3, as the exiting Certificate keystore is automatically being converted to IBM JKS keystore. This error only happens once to indicate keystore format conversion.
- While unzipping the media using the unzip command on certain operating systems, you may see the following error:
bash-3.00# unzip Media_IM_5020603.zip
Archive: Media_IM_5020603.zip
End-of-central-directory signature not found. Either this file is not
a zipfile, or it constitutes one disk of a multi-part archive. In the
latter case the central directory and zipfile comment will be found on
the last disk(s) of this archive.
unzip: cannot find zipfile directory in one of Media_IM_5020603.zip or
Media_IM_5020603.zip.zip, and cannot find Media_IM_5020603.zip.ZIP, peri
If this occurs, use the 'tar -xvf' command to extract the media and proceed with your installation.
=====================================================================
7. UPGRADE IMPACTS
=====================================================================
None
=====================================================================
8. KNOWN ISSUES
=====================================================================
Known issues for Sterling B2B Integrator Version 5.2.6.3:
| Functionality | Known Issue | Workaround |
| REST APIs | No support for multipart file upload for file size more than 2 GB. | No work around available. |
| Non-English topics | The following topics that are newly added for Sterling B2B Integrator V5.2.6.3 are available only in English and are not translated to other languages:
IBM Sterling B2B Integrator V5.2 documentation - Services and Adapters A - L > HTTP Client DELETE Service (V5.2.6.3 or later) - Services and Adapters A - L > HTTP Client PUT Service (V5.2.6.3 or later) The following topics contain updates for Sterling B2B Integrator V5.2.6.3 that are available only in English and are not translated to other languages: IBM Sterling B2B Integrator V5.2 documentation - Services and Adapters A - L > HTTP Server Adapter (V5.2.6 or later) - Windows Cluster Environment Installation (V5.2.6 or later) > System Verification Tasks for a Windows Environment - Windows Non-Cluster Environment Installation (V5.2.6 or later) > System Verification Tasks for a Windows Environment - UNIX/Linux Cluster Environment Installation (V5.2.6 or later) > General UNIX/Linux installation information - UNIX/Linux Non-Cluster Environment Installation (V5.2.6 or later) > General UNIX/Linux installation information - UNIX/Linux Cluster Environment Upgrade (V5.2.6 or later) > General UNIX/Linux Cluster Upgrade Information - UNIX/Linux Non-Cluster Environment Upgrade (V5.2.6 or later) > General UNIX/Linux Upgrade Information IBM Sterling File Gateway V2.2 documentation - Reference > B2B REST APIs available in Sterling B2B Integrator |
Use the English version of these topics. |
| REST APIs (5.2.6.3, Interim Fix 1) | Invoking the Read CustomProtocols API using the Web Service Browser: API Reference interface of Sterling B2B Integrator does not list all the custom protocols available in the system | Use any third party REST client instead of the Web Service Browser: API Reference interface of Sterling B2B Integrator. |
| Although DeleteFGArrivedFile API is introduced in Sterling B2B Integrator V5.2.6.3 release, we recommend that you do not use this API because it is disabled in future releases starting with V5.2.6.3, Interim Fix 1. | No work around available | |
| Installation | Installation of Sterling B2B Integrator ifix 5020603_1 on Solaris fails intermittently due to environmental issue - http://www-01.ibm.com/support/docview.wss?uid=swg21998710 | |
| b2bi4meg jar is auto installed during ifix installation - Sterling B2B Integrator - http://www-01.ibm.com/support/docview.wss?uid=swg21998813 | ||
| Installation of component jars can cause hotfix jars to be removed - Sterling B2B Integrator |
Known issues for Global Mailbox:
| Functionality | Known Issue | Workaround |
| Administrator user interface | The administrator UI for Global Mailbox cannot be reached from the Sterling B2B Integrator administrator UI when all replication servers in a data center are manually suspended. Error dialogs indicate the Global Mailbox client adapter cannot be found. |
Administrative activity for Global Mailbox must be performed by directly accessing the Global Mailbox administrative UI. |
| Performance | With a tombstone grace period of 5 days (default), Global Mailbox can process 20,000 to 30,000 messages per day. If the grace period is shortened to 2 days, Global Mailbox can process 50,000 to 60,000 messages per day. | If your production environment must support a higher load of messages per day, contact IBM Support. |
| Performance | Throughput with Global Mailbox is less than that with Sterling B2B Integrator. The throughput is less than 100 messages per second. | If your production environment must support a higher load of messages per day, contact IBM Support. |
| Non-English topics | Information about firewall configuration was not translated. | Ensure that your firewalls are configured to allow connections to the ports for ZooKeeper, Cassandra, Global Mailbox Management, WebSphere MQ, and Sterling B2B Integrator nodes. |
| Non-English topics | Updated information about recovering from a planned or unplanned data center outage was not translated. | Use the English version of the topics "Restarting Cassandra nodes after data center maintenance" and "Restarting the Global Mailbox management node". |
| Non-English topics | Updated information for configuring advanced event processing was not translated. | Use the English version of the topic "Configuring WebSphere MQ advanced event management". |
| IncrementalRepairJob and NetworkPartitionRepairJob scripts | IncrementalRepairJob and NetworkPartitionRepairJob scripts are disabled, but they are still documented in languages other than English. | Do not enable the IncrementalRepairJob and NetworkPartitionRepairJob scripts. |
| Applying a fix pack to a Global Mailbox installation (V5.2.6.3 or later) | Updates were made to the "Applying a fix pack to a Global Mailbox installation (V5.2.6.3 or later)" topics after translation was complete. | Use the English version of the following topics: "Scheduling and monitoring the event history migration job", "Updating the Global Mailbox Management Node binaries (V5.2.6.3 or later)", "Configuring WebSphere MQ advanced event management", and "Scheduling a replication request migration job". |
| ASCP | ASCP frequently generates logs about session shutdown failures. | Ignore "Session shutdown failure" errors. This is a normal condition. |
| Standby queue manager | The Event Rule Adapter configuration shows an empty value for the Connection Name list rather than listing the active and standby queue managers. | Configure the Global Mailbox Event Rule Adapters in Sterling B2B Integrator to use a connection list with both the active and standby queue managers in the list. You should only list queue managers in the same datacenter as the Sterling B2B Integrator node that you are configuring. |
| Updating or Uninstalling Global Mailbox V5.2.6.3 | Error logs that say "***Operation failed: CBXSE0001E: Invalid userid or password is shown" are generated when uninstalling or updating Global Mailbox. | Before performing an update or an uninstallation, change the Global Mailbox admin password back to the default password ("password"). Once the update or uninstallation is complete, you can change the password. |
| Initial setup | When trying to start admin servers at the same time during the initial setup, a 1970 date is written into the replication_queue_ptr table in the database and files are not replicated. | Start Global Mailbox Admin servers one at a time during the initial setup (while the replication_read_ptr table is empty or after it has been truncated). After the initial setup, you can start Global Mailbox Admin servers at the same time. |
=====================================================================
9. APARs
=====================================================================
For APARs fixed in this release, click here.
=====================================================================
10. CONTACTING CUSTOMER SUPPORT
=====================================================================
Contact Customer Support at 1-800-IBM-SERV, or go to the IBM Support Portal.
=====================================================================
11. NOTICES AND TRADEMARKS
=====================================================================
This information was developed for products and services offered in the U.S.A.
IBM® may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 Japan
The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.
This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:
IBM Corporation
J46A/G4
555 Bailey Avenue
San Jose, CA 95141-1003
U.S.A.
Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.
The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.
Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.
Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.
All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only.
All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may vary.
This information is for planning purposes only. The information herein is subject to change before the products described become available.
This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental.
COPYRIGHT LICENSE:
This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application
programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. The sample
programs are provided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs.
Each copy or any portion of these sample programs or any derivative work, must include a copyright notice as follows:
© IBM 2017. Portions of this code are derived from IBM Corp. Sample Programs. © Copyright IBM Corp. 2017.
If you are viewing this information soft copy, the photographs and color illustrations may not appear.
Trademarks
IBM, the IBM logo, and ibm.com® are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” at http://www.ibm.com/legal/copytrade.shtml.
Adobe, the Adobe logo, PostScript, and the PostScript logo are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, and/or other countries.
IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Government Commerce.
Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.
Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both.
Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office.
UNIX is a registered trademark of The Open Group in the United States and other countries.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates.
Cell Broadband Engine is a trademark of Sony Computer Entertainment, Inc. in the United States, other countries, or both and is used under license therefrom.
Linear Tape-Open, LTO, the LTO Logo, Ultrium and the Ultrium Logo are trademarks of HP, IBM Corp. and Quantum in the U.S. and other countries.
Connect Control Center®, Connect:Direct®, Connect:Enterprise®, Gentran®, Gentran®:Basic®, Gentran:Control®, Gentran:Director®, Gentran:Plus®, Gentran:Realtime®, Gentran:Server®, Gentran:Viewpoint®, Sterling Commerce™, Sterling Information Broker®, and Sterling Integrator® are trademarks or registered trademarks of Sterling Commerce™, Inc., an IBM Company.
Other company, product, and service names may be trademarks or service marks of others.
Original Publication Date
20 December 2016
Was this topic helpful?
Document Information
Modified date:
10 June 2019
UID
swg27049241