IBM Support

An updated version of IBM API Connect V2018.4.1.12 is now available

News


Abstract

IBM API Connect V2018.4.1.12 is now available. This update includes important internal development and field reported fixes.

Content

Note:  Due to an upgrade issue observed by a very limited number of customers with the June 26th version of API Connect v2018.4.1.12, files were temporarily removed from Fix Central for resolution to be assessed.  The new files listed below replace the June 26th version and subsequent update on July 3rd.  However, if you have already upgraded leveraging previous downloads, no further action is required. 

IBM API Connect 2018.x delivers enhanced capabilities for the market-leading IBM API Management solution. In addition to the ability to deploy in complex, multi-cloud topologies, this version provides enhanced experiences for developers and cloud administrators at organizations.

The API Connect v2018.4.1.12 update includes important internal development and field reported fixes.  Additionally, API Connect v2018.4.1.12 includes a tech preview for new UI search capabilities.  See the "What's New" topic in the API Connect IBM Knowledge Center for more information on this tech preview and other new features included in API Connect v2018.4.1.12.

Beginning with IBM Connect v2018.4.1.12, IBM Cloud Private customers can upgrade their installation of IBM API Connect using the apicup command file.  For more information, see the IBM Knowledge Centere here.

A special note on upgrades from prior versions of API Connect v2018.4.1.x:  API Connect v2018.4.1.5 is now a prerequisite for API Connect v2018.4.1.12 for VMWare (.OVA) deployments.  You cannot upgrade your API Connect topology to 2018.4.1.12 without first being at least at the v2018.4.1.5 level.  Again, this restriction applies only to VMWare (.OVA) deployments only of IBM API Connect v2018.4.1.9.  This is due to the level of Kubernetes deployed with the VMWare (.OVA) installation of IBM API Connect v2018.4.1.12 and restrictions around skipping levels of Kubernetes when upgrading.  Additionally, a Control Plane file is required if you are upgrading from v2018.4.1.5 or v2018.4.1.6 to v2018.4.1.12 (VMWARE .OVA only).  Reference the Upgrade Instructions page in the API Connect IBM Knowledge Center.

An additional note on upgrade procedures for DataPower Gateway high-availability clusters.

The upgrade procedure for DataPower Gateway has new steps for upgrading high-availability clusters, to ensure that a single gateway is running as primary for all gateway-peering definitions, and that the primary gateway is upgraded last.   See the "What's New" topic in the API Connect IBM Knowledge Center for more information on this and new features included in API Connect v2018.4.1.12.

API Connect v2018.4.1.12 contains the following field reported APARs:

APAR Summary
LI81058 THE TEXT CURSOR MOVES TO THE END AUTOMATICALLY AFTER USER ENTERS ONE CHARACTER WHEN EDTING API/PRODUCT IN APIM
LI81259 THE LIST OF PRODUCT PLANS AVAILABLE FOR SUBSCRIPTION  MAY APPEAR INACCURATE IN THE API MANAGER UI
LI81352 API MANAGER ASSEMBLE TEST TOOL DOES NOT SUPPORT + CHARACTER IN THE OAUTH PASSWORD FIELD
LI81438 A PUBLISH WITH AN INVALID XML CHARACTER IN SOME CATALOG OR API METADATA COULD INVALIDATE THE ENTIRE CATALOG AT THE GATEWAY
LI81447 INVOKE POLICY FAILS IF RESPONSE HAS A CONTENT TYPE FOR AN XLSX DOCUMENT
LI81452 GATEWAYSCRIPT CODE WITH AN ESCAPED BACKSLASH IN SOURCE WILL     HAVE THE CODE CHANGED TO ELIMINATE ONE OF THOSE BACKSLASHES
LI81459 ERROR REMOVING TRUSTSTORE FROM TLS SERVER PROFILE IN CMC
LI81463 UNABLE TO SAVE SOAP PROXY API AFTER RENAMING
LI81467 STOP THE DB-LOG VOLUME GETTING FULL
LI81480 UI ISSUE FOR API LISTING IN PRODUCT
LI81488 CONSUMER ORGANIZATION MANAGE GROUP FOR SUBSCRIBABILITY DOES NOT HONOR THE GROUP
LI81495 AFTER UPDATING THE APPLICATIONS E.G. REPLACING THE CREDENTIALS ONLY ONE SUBSCRIBED PRODUCT IS LISTED UNDER SUBSCRIPTIONS
LI81508 SELECTING CORG WITH 20+ CONSUMER ORGS CAUSES UNEXPECTED APP CREATION
LI81510 PORTAL EXEC COMMANDS NOT PRINTING ANY DATA DURING A SITE RESTORE, THEREFORE CAUSING THE REQUEST TO TIMEOUT
LI81522 DRUPAL SA-CORE-2020-002
LI81529 PRODUCT NOT REMOVED FROM ONE OF THE CONFIGURED GATEWAY SERVICES
LI81531 API CONNECT CVE-2020-4452
LI81539 DATAPOWER OAUTH ACCESS CODE FLOW DOES NOT PROVIDE A LIST OF SCOPES FOR THE USER TO APPROVE
LI81547 COMPATABILITY MODULE APIM.JS SETVARIABLE FUNCTION MUST SET THE  MESSAGE CONTENT-TYPE HEADER TO UNKNOWN
LI81584 CROSS-SITE REQUEST FORGERY(CVE-2020-13663)
LI81585 DRUPAL (CVE-2020-13664, CVE-2020-13665)
LI81611 CROSS-SITE SCRIPTING XFORCE ID 180875
LI81612 MYSQL UPDATE
LI81647 BROWSERS GO BLANK BY CLICKING "CONSUMER-ORG" IN API MANAGER UI AFTER LOGIN AS DEVELOPER
*** Please note that links to some security related APARs may not be available in the table above.  This is intentional for security purposes. ***

Database technology used in this release:

IBM API Connect relies on SQL and no-SQL database technology to provide persistent storage of objects required for the function of the product.  Database technology requires fast and reliable storage and in the case of a highly available configuration, the database must perform adequately in a clustered configuration.  

GlusterFS: Testing of IBM API Connect when using GlusterFS has shown that GlusterFS does not provide the speed or reliability for any of the database technologies used in IBM API Connect and thus should not be considered for use as the clustered storage facility with this product.

AWS EBS: IBM API Connect deployed on Kubernetes in EC2 instances on AWS should make use of the AWS EBS storage solution with GP2 or IO1 type.

We advise all users of prior version of API Connect v2018.x to install this update to take advantage of the fixes.

For more information about this release, see API Connect Knowledge Center: What's new in this release.

Important notes on upgrading to 2018.4.1.12:

When upgrading to Version 2018.4.1.12, you must complete a manual backup just before starting the upgrade. The manual backup is required because the upgrade can take an extended period of time. See Requirements for upgrading on VMware and Requirements for upgrading on Kubernetes.

Starting with IBM API Connect Version 2018.4.1.11, writable LDAP user registries can be used only for onboarding and authenticating Developer Portal users. A writable LDAP user registry cannot be used to authenticate Cloud Manager and API Manager users.  If you already have a writable LDAP user registry for use with the Cloud Manager or the API Manager, you must update the registry to be read-only by changing the User Managed property to be false.

Starting with IBM API Connect Version 2018.4.1.9iFix1, after completion of the upgrade, some tasks may have stopped running. See Requirements for upgrading on VMware and Requirements for upgrading on Kubernetes describing action to take.

Finally,  a Control Plane file is required if you are upgrading from v2018.4.1.5 or v2018.4.1.6 to v2018.4.1.12 (VMWARE .OVA only).  Reference the Upgrade Instructions page in the API Connect IBM Knowledge Center.

Support lifecycle policy for IBM API Connect Version 2018.4.1.12:

IBM API Connect 2018.4.1.12 is fix pack to a Long-Term Supported (LTS) release.  API Connect 2018.4.1.12 is a recommended product level for which support, including defect and security updates, will be provided through cumulative, in-place fix packs until the effective end of service (EOS) date for IBM API Connect 2018.4.1.x.  An LTS release is intended for customers that may need a longer-term deployment for their environment. For more information, see IBM API Connect v2018.x Support Lifecycle.

Downloads:

Full installation files for IBM API Connect 2018.4.1.12 and the IBM API Connect 2018.4.1.12 Toolkit files can be downloaded from Fix Central :

Description – Filename Date Published
IBM API Connect Management V2018.4.1.12 Containers
10 July 2020
IBM API Connect Developer Portal V2018.4.1.12 Containers
10 July 2020
IBM API Connect Analytics V2018.4.1.12 Containers
10 July 2020
IBM API Connect Management V2018.4.1.12 for VMWare
10 July 2020
IBM API Connect Developer Portal V2018.4.1.12 for VMWare
10 July 2020
IBM API Connect Analytics V2018.4.1.12 VMWare
10 July 2020
IBM API Connect Installation Assist V2018.4.1.12 for Linux®
10 July 2020
IBM API Connect Installation Assist V2018.4.1.12 for Mac
10 July 2020
IBM API Connect Installation Assist V2018.4.1.12 for Windows
10 July 2020
IBM API Connect Toolkit V2018.4.1.12 for Linux®
10 July 2020
IBM API Connect Toolkit V2018.4.1.12 for Mac
10 July 2020
IBM API Connect Toolkit V2018.4.1.12 for Windows
10 July 2020
IBM API Connect Toolkit Designer with Loopback V2018.4.1.12 for Linux®
10 July 2020
IBM API Connect Toolkit Designer with Loopback V2018.4.1.12 for Mac
10 July 2020
IBM API Connect Toolkit Designer with Loopback V2018.4.1.12 for Windows
10 July 2020
IBM API Connect V2018.4.1.12 Analytics.OVA Upgrade File
10 July 2020
IBM API Connect V2018.4.1.12 Management Server.OVA Upgrade File
10 July 2020
IBM API Connect V2018.4.1.12 Developer Portal.OVA Upgrade File
10 July 2020
IBM DataPower Gateway for Docker Production Edition v2018.4.1.12
idg_dk20184112.lts.prod.tar.gz
26 June 2020
IBM DataPower Gateway for Docker Non-Production Edition v2018.4.1.12
idg_dk20184112.lts.nonprod.tar.gz
26 June 2020
Kubernetes DataPower Monitor v2018.4.1.12
26 June 2022

Ensure that you have read and understood the installation instructions for OVAs and Containers before downloading and by using the installation files. You can find detailed installation instructions in IBM API Connect Knowledge Center -- Installing API Connect

IBM API Connect Control Plane for OVA upgrades

When upgrading from v2018.4.1.5 through v2018.4.1.8, on VMWare only, one or more Control Plane files must be downloaded and installed to bring Kubernetes to a supported release level.  For more details, see Step 5 of the Upgrade Instructions in the API Connect IBM Knowledge Center.

Description – Filename Date Published
IBM API Connect 1.14.0 Control Plane File for OVA (optional)
2 March 2020
IBM API Connect 1.15.0 Control Plane File for OVA (optional)
2 March 2020

IBM API Connect Local Test Environment is now available

The IBM API Connect Local Test Environment allows you to test APIs on your local machine, without the need to connect to an API Connect management server.  For more details, see the IBM Knowledge Center

Description – Filename Date Published
IBM API Connect Local Test Environment
apic-lte-2018.4.12-54.zip
26 June 2020
ICP Upgrade for IBM API Connect v2018.4.1.12
Users of IBM API Connect in an IBM Cloud Private environment can now upgrade their environment using the apicup file for their installation platform found in the download table above.  For more details an instructions on migrating an IBM Cloud Private catalog install to apicup, please see the IBM Knowledge Center document here.

What is Fix Central (FC)?

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSMNED","label":"IBM API Connect"},"ARM Category":[{"code":"a8m50000000L0rvAAC","label":"API Connect"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Version(s)","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
27 October 2020

UID

ibm16238386