Fix Readme
Abstract
IBM API Connect V5.0.8.11-ifix1 is available. This update addresses a number of field APARs reported since the availability of API Connect v5.0.8.11.
Content
IBM API Connect V5.0.8.11-ifix1 is now available to address internal fixes and customer APARs reported since API Connect v5.0.8.11. We advise all users of IBM API Connect V5.0 to install this update to take advantage of the fixes.
Special Notes:
-- YOU MUST INSTALL API CONNECT V5.0.8.10-ifix2 PRIOR TO UPGRADING V5.0.8.11
-- All RSS nodes need to be removed and re-added to the cluster after the upgrade
API Connect v5.0.8.11, includes an upgrade of platform in version 5 from Bedrock to the Centos operating system. Bedrock systems were based upon RHEL6 which went out of support in Nov 2020. There are major changes in platform code specifically and involved a rebuild/fix of application packages on Centos7. Centos 7 is supported until June 2024.
In order to upgrade to 5.0.8.11, Customers MUST upgrade first to 5.0.8.10-ifix2 (as this build contains the code required for upgrade to 5.0.8.11) as a pre-requisite. The steps for upgrading from 5.0.8.10-ifix2 to 5.0.8.11 are documented here.
An important note for customers who leverage API Connect v5 analytics before upgrading to 5.0.8.11 (from a version earlier than 5087-ifix4): A one time upgrade step is required to retain analytics data during the upgrade window when updating to 5087-ifix4 or later, see the following link for details: https://www.ibm.com/support/knowledgecenter/SSMNED_5.0.0/com.ibm.apic.install.doc/prereq_5087ifix4_dpgw_certs.html
An important on migrating Developer Portal OVAs from Ubuntu V16.04 to Ubuntu V18.04: It is strongly recommended that you migrate your Developer Portal to Ubuntu V18.04 because support for Ubuntu V16.04 is being withdrawn in March 2021. To migrate your Developer Portal OVAs from Ubuntu V16.04 to Ubuntu V18.04, you need to perform a backup and restore method of migration. This method involves backing up your current Ubuntu V16.04 Developer Portal content, standing up new OVAs on Ubuntu V18.04, and then restoring the Developer Portal content onto the new OVAs. See the following link for details: https://www.ibm.com/support/knowledgecenter/SSMNED_5.0.0/com.ibm.apic.install.doc/tapim_portal_production_migrate_ubuntu18.html
Note: The Linux® distribution for the Developer Portal OVA has moved from a Debian V7 base to an Ubuntu V16.04 base. Support for the Debian V7 OVA was withdrawn in May 2018. You are encouraged to migrate your Developer Portal to the Ubuntu V16.04 base now, as support for Debian V7 upgrades was removed in May 2018.
Deprecation of IBM API Connect Micro Gateway Component on 31 March 2020:
IBM® API Connect Micro Gateway was deprecated in IBM API Connect Version 5.0.8 in favor of DataPower® Gateway. From 1 April 2020, Micro Gateway will no longer be supported.
Existing users can migrate their API definitions to IBM DataPower Gateways. For information on supported API policies, see Built-in policies.
Support lifecycle policy for IBM API Connect Version 5.0.8.11-ifix1:
IBM API Connect Version 5.0.8.x is a Long Term Supported (LTS) release and is a recommended product level for which support, including defect and security updates, will be provided through cumulative, in-place fixpacks until the effective end of support (EOS) date for IBM API Connect Version 5.0. An LTS release is intended for customers that might need a longer-term deployment for their environment.
APAR fixes
| APAR | SUMMARY |
| LI81307 | UPGRADE SERVER SSH KEY TO BE MORE THAN 1024 BITS |
| LI81768 | NOT ABLE TO CHOOSE CATALOG IN API MANAGER WHILE INVOKING API |
| LI81769 | INCREASE OAUTH INTROSPECTION METADATA SIZE TO 1024 |
| LI81773 | INVALID REQUEST PARAMETERS WILL NOT BE DETECTED AFTER DATAPOWER APAR IT32057 |
| LI81783 | APPLICATION OF FIRMWARE VERSIONS 2018.4.1.14/10.0.1.1 MAY CAUSE A DIFFERENT API ERROR FOR REQUEST PARAMETERS WITH INVALID CHARS |
| LI81820 | API SEARCH IN API MANAGER DRAFTS FAILS |
| LI81826 | WHEN THE REQUIRED FIELD IS EMPTY, THE SAVE BUTTON IS ACTIVE IN SOME POLICIES |
| LI81833 | PORTAL UPGRADE FAILS DUE TO NO INTERNET CONNECTION |
| LI81844 | DELETE RELATED SUBSCRIPTIONS FROM ALL CATALOGS WHEN DELETING AN APP |
| LI81880 | PRESERVE SELECTION OF EMAIL RECIPIENTS ACROSS PAGINATED DISPLAY OF CONSUMER ORGS IN API MANAGER |
| LI81881 | API SEARCH UTILITY IN DRAFT NOT WORK PROPERLY AFTER UPGRADE TO V 5.0.8.8 |
| LI81924 | UNABLE TO PROCESS SPECIAL CHARACTERS BEING PASSED IN MAPPING POLICY'S QUERY PARAMETER VALUE |
| LI81928 | AFTER REPLACE, SUBSCRIPTION FAILS WITH INCORRECT ERROR MESSAGE |
| LI81942 | UNABLE TO ADD DISK SPACE ON DEVELOPER PORTAL |
| LI81985 | VM CONSOLE OF PORTAL DISPLAYS- PRINT_REQ_ERROR: I/O ERROR, DEV FD0, SECTOR 0 |
| LI81994 | BACKGROUND SYNC FAILS DUE TO PXC_STRICT MODE SET TO ENFORCING |
| LI81996 | MAP POLICY IN A CATCH CONSUMING XML INPUT DOES NOT DETECT THE PROPER CONTENT TYPE |
| LI82045 | NTP CVE-2020-11868 |
| LI82046 | NTP CVE-2020-15025 |
| APAR | SUMMARY |
| LI82015 | EXAMPLE GENERATED FROM SAMPLE JSON CONTAINS ESCAPE CHARACTER |
| LI82092 | HTTP CONSOLIDATOR NODE SERVER ERRORING OUT DUE TO NODE14 UPGRADE |
Upgrade paths for API Connect:
For more information on IBM API Connect upgrade paths, see Supported Upgrade Paths.
There are specific validated upgrade paths between IBM® API Management Version 4.0 or later and IBM API Connect Version 5.0 or later. For more information, see Validated upgrade path for API Connect
In addition to the specific validated upgrade paths for the API Management appliance, you must upgrade your IBM DataPower Gateway appliance. For more information, see Upgrading your DataPower appliances
Refer to the life-cycle support page for the IBM DataPower Gateway
Downloads:
Full installation and upgrade files for IBM API Connect Version 5.0.8.11-ifix1 can be downloaded from Fix Central: IBM API Connect Version 5.0.8.11-ifix1
There may be newer fixes posted to Fix Central that do not contain APARs or any API Connect code changes but are made available as they contain updates to underlying dependent software packages.
A one time upgrade step is required to retain analytics data during the upgrade window when updating from a version prior to 5087 iFix 4 to 5087 iFix 4 or later. See the following link for details: https://www.ibm.com/support/knowledgecenter/SSMNED_5.0.0/com.ibm.apic.install.doc/prereq_5087ifix4_dpgw_certs.html
An important on migrating Developer Portal OVAs from Ubuntu V16.04 to Ubuntu V18.04: It is strongly recommended that you migrate your Developer Portal to Ubuntu V18.04 because support for Ubuntu V16.04 is being withdrawn in March 2021. To migrate your Developer Portal OVAs from Ubuntu V16.04 to Ubuntu V18.04, you need to perform a backup and restore method of migration. This method involves backing up your current Ubuntu V16.04 Developer Portal content, standing up new OVAs on Ubuntu V18.04, and then restoring the Developer Portal content onto the new OVAs. See the following link for details: https://www.ibm.com/support/knowledgecenter/SSMNED_5.0.0/com.ibm.apic.install.doc/tapim_portal_production_migrate_ubuntu18.html
Ensure that you have read and understood the upgrade and installation instructions before downloading and using the installation or upgrade files. You can find detailed installation instructions in IBM API Connect Knowledge Center -- Installing API Connect
| What is Fix Central (FC)? |
Was this topic helpful?
Document Information
Modified date:
02 September 2021
UID
ibm16429049