What's new in Version 10.0.6.0

This page details the enhancements in IBM® API Connect Version 10.0.6.0 since the previous release.

What's new for Developers

New API governance add-on service: API governance is an optional add-on to IBM API Connect that can be used to validate and enforce organizational governance policies and best practices to your API development process. For more information, see Validating an API document by using API governance.
Updated schema editor design for API definitions: The Definitions section of the API editor in the API Manager and API Designer UIs is updated to improve the user experience when creating and editing schema definitions. For more information, see Defining schemas for an API.

What's new for API product managers

New API governance add-on service: API governance is an optional add-on to IBM API Connect that can be used to validate and enforce organizational governance policies and best practices to your API development process. For more information, see Configuring API governance in the Cloud Manager, and Configuring API governance in the API Manager.
Analytics long-term data: By default analytics event data is retained for up to 30 or 90 days, dependent on the deployment profile. With the new long-term data feature, event data is summarized and added to a new summary data index that has a 1 year default retention period. The summary data allows the product manager to view long-term trends. To view the summary data, the UIs have a new Reports tab, see Analytics dashboards. New REST API and toolkit CLI operations are also provided to access the summary data shown in the UI Reports tab.
Note: If you are upgrading from v10.0.5, the summary data is gathered for all new API events after upgrade to 10.0.6 is complete. Existing API event data from 10.0.5 is not added to the summary data index.
Gateway policy titles, names, and types included in assembly latency visualization: DataPower® v10.5.1.x only: To help identify where delays in API processing occur, when you click an API event in the analytics UI Discover view, the title, name, and type of gateway policies are included.

What's new for Developer Portal site administrators

New Developer Portal CLI product commands

The new product commands allow you to update the images, attachments, tags and categories for products on your Developer Portal. In IBM API Connect 10.0.6.0 the newly added product commands are:

product:add-attachment
product:set-icon
product:add-tag

For more information about the product commands and how to use them, see Using the product commands.

New Developer Portal CLI api commands

The new api commands allow you to update the images, attachments, tags, and categories for products on your Developer Portal. In IBM API Connect 10.0.6.0 the newly added api commands are:

api:add-attachment
api:set-icon
api:add-tag

For more information about the api commands and how to use them, see Using the api commands.

New Developer Portal CLI site command

The new site:login-link command is now available for use through the IBM API Connect toolkit CLI. By running this command, you receive a one-time login link for the Developer Portal site admin account.

For more information about the site commands and how to use them, see Using the site commands.

New flag for the modules and themes commands in Developer Portal CLI

The new --custom flag added to your modules:list and themes:list commands helps you find what modules and themes have been installed on your Developer Portal site after an install.

For more information about the --custom flag, see Using the themes commands and Using the modules commands.

What's new for DevOps

Migrate v5-compatible APIs to the DataPower API Gateway

If your deployment includes v5-compatible APIs, they can only be used with the DataPower v5-compatible Gateway (also known as the v5c gateway). To use the v5-compatible APIs with the DataPower API Gateway, you must migrate the APIs to the newer format. For more information, see Migrating v5-compatible APIs to API Gateway.

Direct upgrades are only supported from API Connect 10.0.5.x

API Connect 10.0.6.0 supports a direct upgrade only from versions of 10.0.5.x. If your deployment is using an older release of API Connect, you must upgrade to a 10.0.5.x release before attempting to upgrade to 10.0.6.0. For more information about upgrading, see:

Cert-manager upgraded to version 1.9.1

API Connect 10.0.6.0 uses cert-manager 1.9.1. If your environment requires a manual installation or upgrade of cert-manager, the instructions are included as part of the API Connect installation and upgrade procedures.

(Kubernetes, Red Hat OpenShift) Improved platform health status monitoring using Kubernetes events

A new feature is enabled in the IBM APIConnect operator on Kubernetes and Red Hat OpenShift to generate CR events whenever there is a change in the top-level CR (APIConnectCluster) or subsystem CRs (

ManagementCluster, GatewayCluster, AnalyticsCluster,
PortalCluster

) status conditions. Along with CR status conditions, you can monitor these events by using any third-party alerting system.

For more information, see Monitoring platform health using Kubernetes events or Monitoring platform health on Red Hat OpenShift using Kubernetes events.

Red Hat OpenShift-based deployments now manage foundational services through the API Connect operands

In previous releases of API Connect, a deployment on Red Hat OpenShift (including as a capability in Cloud Pak for Integration) managed the use of IBM Cloud Pak foundational services through dependencies that are enforced by OLM at the operator level. In API Connect 10.0.6.0, the dependency on foundational services is no longer managed at the operator level by OLM, but is instead handled at the operand level by the API Connect operator. This change provides more flexibility going forward by allowing the APIC operator to enforce the dependency only on the operands that actually require it.

This change applies only to new installations and upgrades from 10.0.5.3 (or later). For more information, see the appropriate installation instructions for your Red Hat OpenShift environment.

Upgrade checks for Postgres leader

The upgrade process on all platforms now includes checks for the condition where the original Postgres leader pod is no longer the leader, or if there is no Postgres leader pod. In both cases extra steps are required to complete the management subsystem upgrade: Postgres failover steps.

JWT security between gateway and analytics

Network communication between the gateway and analytics subsystems can now be secured with JWT instead of mTLS. For more information, see Enable JWT security instead of mTLS.

What's new for security practitioners

New API governance optional add-on service: API governance is an optional add-on to IBM API Connect that can be used to validate and enforce organizational governance policies and best practices to your API development process. For information about how to enable this add-on, see Enabling API governance on Kubernetes, and Enabling API governance on VMware.