What's deprecated and changed for IBM Cloud Pak foundational services
Get a quick overview of what is changed, deprecated, or removed for the foundational services.
Deprecated services and features
Installer versions 1.1.0, 3.4.x, and 3.5.x are deprecated in installer version 3.16.x. You cannot upgrade to these versions.
From foundational services version 3.22, the use of the following APIs are deprecated and are subject to be removed in the future release:
|IAM API||Affected item|
|Account management APIs||
|Directory management APIs||
|User group management APIs||
|User management APIs||
|Team management APIs||
|Service ID management APIs||
|API key management APIs||
|Service policy management APIs||
|Service onboarding and RBAC APIs||
|Platform user API keys||
|Single sign-on APIs||
|Service health and version check APIs||
|LDAP management APIs||
|Identity Provider APIs (IdP V1 and IdP V2)||
IBM API Catalog service
In foundational services version 3.19 and newer, IBM API Catalog service is no longer available as an optional installable component. IBM API Catalog still exists in foundational services version 3.18 or older, but at this time is not supported to use.
Configmap watcher removed from cert-manager: In version 3.19 of foundational services, configmap-watcher is removed from cert-manager.
certmanager.k8s.io/v1alpha1in all cert-manager Custom Resources (Certificates, Issuers, and ClusterIssuers) is deprecated. apiVersion
You must define a
CatalogSource for the
IBM Cloud Pak foundational services operator. The OperatorSource is deprecated and might be removed in a future release.
- Prometheus and Grafana UI deprecation: In Platform UI version 1.8.x (foundational services version 3.21), Prometheus and Grafana UI are deprecated in OpenShift Container Platform version 4.10 and removed in OpenShift Container Platform version 4.11. When you click on the OpenShift Container Platform Grafana link from the Administration panel, you will now be redirected to the OpenShift Container Platform Observability Dashboard. For more information, see OpenShift Container Platform 4.10 release notes.
The policy controller within the Identity and Access Management (IAM) service is deprecated and might be removed in a future release.
Audit policy controller (Audit logging)
The Audit policy controller is deprecated and might be removed in a future release.
The Common header is replaced by a new header for shared use across IBM Cloud Paks.
With this header, the available toolbar options are streamlined to include only the main Menu, the User menu, a menu to switch between the installed IBM Cloud Paks and the Administration panel. In addition a link is included, which can open either the Administration panel or the Home page for the IBM Cloud Pak that is currently being accessed.Menu options for accessing the Visual Web Terminal, configuring the client, setting the Home page, and opening the IBM documentation are removed from the header.
The theme toggle is now removed. The dark theme is now the theme for the Administration panel.
Identity and Access Management
Some user management views are replaced with alternatives views. When the
ibm-zen-operator and the associated Platform UI Framework is installed, these alternative views become available to replace the previous IAM views.
The default authentication type for accessing the console is renamed to be IBM Provided credentials (admin only).
Nginx ingress (ibm-ingress-nginx-operator)
Nginx ingress is deprecated with installer version 3.10.0 and might be removed in a future release.
IBM Cloud Pak CLI (cloudctl)
In foundational services version 3.22, the
cloudctl case command is deprecated and replaced with ibm-pak plug-in. Support for the
cloudctl case command will be removed
in a future release.
Removed services and features for foundational services
The following services are now removed. If you are using earlier installer versions of foundational services or are migrating from an earlier installer version, these services can still exist on your clusters at the last version of the services that you previously installed.
journald support in
AuditLogging CR, and audit sidecar (
icp-audit-service) are removed with IBM Cloud Pak foundational services audit logging version 3.17.0. These services were deprecated in audit logging
version 3.7.0. You can use Rsyslog Sidecar or HTTPS to forward audit logs to IBM Cloud Pak foundational services
audit logging service.
IBM Cloud Pak foundational services Prometheus as a data source of Grafana is removed from foundational services version 3.8.x and later.
The deprecated Metering service is removed in IBM Cloud Pak® foundational services version 3.7.x.
The deprecated Logging service is removed in IBM Cloud Pak® foundational services version 3.7.x.
The Catalog UI service (ibm-catalog-ui-operator) was deprecated with installer version 3.4.1 and is now removed with installer version 3.6.0.
The Helm API (ibm-helm-api-operator) and Helm Repository (ibm-helm-repo-operator) services were deprecated with installer version 3.4.1 and are now removed with installer version 3.6.0.
The Helm CLI and tiller-deploy features are also removed.