Known issues in foundational services

Get a quick overview of the known issues for the available foundational services. There might be intermittent login failure in Platform UI console when you upgrade the foundational services version 3.22 or version 3.23 to foundational services version 4.x.x and then configure the multiple LDAPs.

Known issues

You can find information about known issues and customer reported issues.

Table 1. The list of known issues
Issue ID Service Impacted version Fixed version Description and symptoms
DT469679 Identity Management (IM) All Continuous Delivery (CD) and Support Cycle-2 (SC-2) versions CD 4.19.2 If you use SCIM with Entra ID-IM integration or OKTA-IM integration to manage users and groups for anIBM Cloud Pak®, the SCIM user API is limited to fifty users, and IM does not support pagination. For more information, seeDT469679.
DT495259, 69720 Installer 4.x.x 4.19.2 During the initial deployment of an IBM Cloud Pak, the common-service-db PostgreSQL cluster fails to become fully operational. The cluster remains in a Setting up primary state because its associated Persistent Volume Claims (PVCs) are stuck in the Pending state. For more information, see DT495259.
DT467023, 69108 IM 4.17.0 and later 4.19.0 If Liberty debug tracing is enabled to troubleshoot authentication issues, it might cause the platform-auth-service pod to enter a CrashLoopBackOff state because of excessive log generation. The "liberty-logs-vol" exceeds the limit set "150Mi" message appears for the container. For more information, see DT467023.
DT460797, 68608 IM 4.15.0 CD 4.19.0 Cognos client registration URL customization is reverted afterIBM Cloud Pak for AIOps 4.12 withfoundational services 4.15 is upgraded from the previous version. For more information, see DT460797.
DT464220 IM Foundational services versions before CD 4.19.0 CD 4.19.0 and SC-2 4.6.22 Even if you set theldap_ignorecase value totrue, the LDAP allowlist remains case-sensitive. Treat the allowlist as case-sensitive to help prevent user matching and authentication issues. For more information, see DT464220.
DT451967 IM Upgradingfoundational services from an older version tofoundational services 4.14.0 and later CD 4.17.0 WhenIBM Cloud Pak foundational services operators are upgraded to version 4.14.0 or later, if thecp-console hostname is customized, the hostname is reverted to default values. For more information about a workaround, see DT451967.
DT454152, 68104 IM Foundational services versions before SC-2 4.6.18 and CD 4.15 CD 4.16.0 and later and SC-2 4.6.20 and later If the BindDN password contains spaces, the LDAP connection fails when theplatform-auth-services pods are restarted. For more information, see DT454152.
DT453825, 67945 Installer Foundational services versions before CD 4.16 and SC-2 4.6.19 CD 4.16 and SC-2 4.6.19 Due to a missing network policy, the operators can't be installed under a restricted namespace when the catalog sources are configured under an IBM Cloud Pak namespace. The catalog source fails with the TRANSIENT_FAILURE error. For more information, see DT453825.
DT461836, 67821 IM CD 4.x.x versions earlier than 4.15 4.15 AnIBM Cloud Pak® upgrade fails because of acommon-service database migration failure when theTABLE platformdb.users_attributes table is alerted to add theCONSTRAINT fk_useratt_fk constraint. Review theauthentication.operator example-authentication custom resource (CR) for any pending database migrations and any status not in theReady state. For more information, see DT461836.
DT472935, 68492 IM Versions 4.19.x and earlier The platform-identity-management pods might restart if the common-services-db PostgreSQL cluster becomes temporarily inaccessible. The SequelizeConnectionRefusedError: connect ECONNREFUSED <IP address>:5432 error appears. For more information, see DT472935.
DT457948, 68389 IM 4.14.0 and later In an upgraded environment, thecommon-services-db instance logs contain this repeated message:
"error":"while updating database owner password: wrong username 'cpadmin' in secret, expected 'im_user'"
This message doesn't affect the database function. As a workaround, you can delete thecommon-service-db-app secret. For more information, see DT457948.
DT458696, 68446 IM 4.14.0 and earlier CD 4.15.0 and SC-2 4.6.21 ZenService is stuck at 71% complete while it waits for theAuthentication Ready status, and theoidc-client-registration job runs indefinitely. To resolve the issue, run the following command to restart theoidc-client-registration job:
oc -n delete job oidc-client-registration
For more information, see DT458696.
66949 Installer 4.13 or 4.6.15 and earlier 4.6.16 and 4.14 Invalid value error when updating the CommonService CR by using the setup_tenant.sh script
DT443847,66162 IAM Foundational services SC-2 4.6.14 and earlier andFoundational services CD 4.13 and earlier Foundational services SC-2 4.6.15 and CD 4.14.x If you log out of anIBM Cloud Pak that includes a Keycloak integration, you can log out of theconsole. However, the Keycloak session might not be logged out, and if you try to log in again, you might log in automatically without any prompting for your user credentials. Configure SLO so that when you log out of a single session, you are automatically logged out of all related sessions that were established during single sign-on (SSO). For more information, see Configuring single logout (SLO) with SAML. For SC-2 versions 4.6.14 and earlier or CD versions 4.13 and earlier, log out of the Keycloak identity provider (IdP), delete or clear the cookies from your browser, and restart the browser.
DT435741, 65990 IM CD 4.13 and earlier and SC-2 4.6.13 and earlier CD 4.14 and SC-2 4.6.14 Intermittently, the SAML login fails to authenticate, and the console URL loops between the SAML provider andcp-console before it times out. For more information, see DT435741.
DT461019, 68553 IM 4.12.0 4.13.0 An error occurs if you try to collect identity management pod and Liberty container logs, and container logs are not collected. For more information about the issue, see Collect identity management pod and Liberty container logs. For more information about a workaround, see DT461019.
KI-DT437215 66519 Installer CD 4.10, 4.11, 4.12 and SC-2 4.6.10, 4.6.11, 4.6.12, 4.6.13 CD 4.13 and SC-2 4.6.14 IBMplatform-xxx pods and theusermgmt pod are re-created every 2 to 3 hours because of Operand Deployment Lifecycle Manager (ODLM). ODLM periodically updates the deployment and causes the pods to restart. For more information, see IBM platform-xxx pods and the usermgmt pod are recreated every 2-3 hours due to ODLM updating deployment.
68739 Installer, IM 4.11.0 and later This issue is planned to be fixed in a future release. If theibm-iam-operator operator crashes during certificate authority (CA) rotation, PostgreSQL connection fails. For more information, see Database connection fails after CA certificate rotation.
DT446290, 67286 IM 4.6.x and later CD 4.12 and SC-2 4.6.14 TheIBM Cloud Pak upgrade hangs, waiting for the IAM operator to complete the upgrade if theibm-mongodb services are not cleaned up from a previous successfulfoundational services upgrade. The existence of theibm-mongodb service in the same namespace triggers the IAM operator to restart the database migration, and it fails when it can no longer locate the MongoDB instances. For more information, see DT446290.
65867 IM 4.11 and earlier 4.12 Display name and email are displayed as undefined undefined for IBM Security Verify
67413 IAM CD 4.11 and earlier and SC-2 4.6.11 and earlier CD 4.12 and later and SC-2 4.6.12 and later After the platform-auth-service pod restarts, an incorrect entityID appears in the SAML metadata file.
62301 and 65320 IM v4.10 and earlier v4.11 SAML IdP registration fails due to size of the idp_metadata. The following error message is displayed when you uploadidp_metadata:

Payload Too Large

Invalid JSON input
 
The issue is reported infoundational services v4.10 and fixed in v4.11. To resolve the issue, upgrade thefoundational services to v4.11.
DT412187DT421436 IM CD 4.9.0 and earlier and SC-2 4.6.8 and earlier CD 4.10.0 and later and SC-2 4.6.9 and later The Identity Management (IM) component fails for authentication and authorization operations, and theplatform-identity-management pod logs contain the[SequelizeConnectionError]: 00D8C999997F0000:error:0A003415:SSL routines:ssl3_read_bytes:sslv3 alert certificate expired error. For more information, see Expired certificates result in authentication and authorization issues.
67043 IM 4.6.x versions before 4.6.16 4.6.16 When you upgrade from foundational services v3.19 to v4.6.x, forwarding IM audit logs is prevented
DT195734, 61918 IM 4.x.x CD 4.14.0 and later and SC-2 4.6.14 and later If the foundational services profile is large, an Internal Server Error might occur in the platform-auth-service pod. To avoid this error, upgrade to foundational services version 4.6.14 or later. For more information, see Intermittent looping occurs in large profiles.
DT437128, 66558 cert-manager 3.25.5 4.6.0 Cert-manager 3.x in theOpenShift Container Platform cluster can cause the pods to restart when they are initially deployed even if the certificates aren't refreshed.
DT461017, 68553 IM All CD versions The behavior is intended. For more information about a workaround, see DT461017. LDAP authentication fails if the plus sign (+) character is included in a username, for example,john+doe. For more information, see DT461017.
DT452215, 67853 Installer CD 4.11.0 and later During the upgrade, although the CommonService custom resource (CR) is configured to skip the installation of the EDB PostgresSQL operator, it is still being created under theIBM Cloud Pak operator namespace during the CommonService upgrade. The PostgresSQLuserManaged: true property is missing briefly in the new OperandRegistry until it is updated by the CommonService operator. For more information, see DT452215.
66424 Installer 4.11 This issue is planned to be fixed in a future release. Foundational services cannot be upgraded (failed mirroring) because the EDB PostgreSQL and Events images are in incorrect format.
66023 IM 4.11 Fromfoundational services v4.11, IM operator requires the TLS certificate verification for external EDB PostgreSQL connections. To resolve the issue, see IM pods cannot be deployed when foundational services is configured with external EDB PostgreSQL.
DT465245, 68899 IM 4.6.x and later During database initialization, the IM database migration job,ibm-im-db-migration, tries to connect to the external PostreSQL server by using SSL. If the PostgreSQL server certificate doesn't include the database server hostname or IP address in thesubjectAltName (SAN) field, the database initialization fails with the message,tls: failed to verify certificate: x509: cannot validate certificate for https://pgserver.xyx.com because it doesn't contain any IP SANs","stacktrace". For more information, see DT465245.
DT433546 OpenSearch 4.6 and newer New pods cannot join the cluster during or after upgrade from Elasticsearch to OpenSearch.

IM known issues

You can perform the troubleshooting or workaround procedures to resolve the issues that are related to the IM service.

After the platform-auth-service pod restarts, an incorrect entityID appears in the SAML metadata file

After the platform-auth-service pod restarts, an incorrect entityID appears in the SAML metadata file.

  • If you use foundational services version 4.6.8 to 4.6.14, the incorrect entity is https://platform-auth-service:9443/ibm/saml20/defaultSP.
  • If you use a foundational services version before 4.6.8, or if you use version 4.6.15 and later, the incorrect entity is https://platform-auth-service:9443/idauth/ibm/saml20/defaultSP.

The spHostAndPort and createSession SAML web browser SSO configurations are not retained.

Symptoms After the platform-auth-service pod restarts, the downloaded SAML metadata file shows the entityID as https://platform-auth-service:9443/ibm/saml20/defaultSP or https://platform-auth-service:9443/idauth/ibm/saml20/defaultSP instead of the expected configured value, and SAML logins fail.

After successful SAML IdP registration, the platform-identity-provider pod creates a saml.xml file. The pod copies the file to the platform-auth-service pods in the /config/configDropins/defaults/saml.xml location. If the platform-auth-service pod crashes, the new pods read the IdP configuration from the database and re-create the same file on startup. SAML web browser SSO configurations like spHostAndPort and createSession are not written back into the file.

Resolution

Edit the SAML connection and save it without any changes.

  1. From the list of IdPs that are configured, select the SAML IdP. The View SAML connection window opens.
  2. From Connection details, click Edit.
  3. Then, click Save. The platform-identity-provider pod can rewrite and copy over the correct files on the platform-auth-service pods.

Expired certificates result in authentication and authorization issues

The common-service-db-im-tls-secret secret is refreshed every 3 months. But the operator doesn't restart the platform-identity-management pods after the im-datastore-edb-secret certificate is refreshed, and the operator encounters an expired certificate. The IM component fails for authentication and authorization operations.

Symptoms

The platform-identity-management pod logs contain the [SequelizeConnectionError]: 00D8C999997F0000:error:0A003415:SSL routines:ssl3_read_bytes:sslv3 alert certificate expired error.

Resolution

Manually restart the platform-auth-service, platform-identity-provider, and platform-identity-management identity management pods within a month of when the common-service-db-im-tls-cert certificate was last renewed. After the first expiration, other expirations occur about every 2 months.

When you upgrade from foundational services v3.19 to v4.6.x, forwarding IM audit logs is prevented

version 46x When you upgrade from foundational services v3.19 to a 4.6.x version before 4.6.16, IM audit log forwarding is prevented.

Log forwarding is supported only when Zen is installed. If Zen is installed, IM sends the audit logs to zen-audit-svc when you enable the auditing service for IM. If Zen is not installed, forwarding audit logs for IM is not supported.

For more information, see Auditing IM service.

SAML configured with cloudctl isn't retained after upgrading from foundational services 3.19.x to 4.x

version 46x If you upgrade IBM Cloud Pak foundational services from version 3.19.x to version 4.6.x, the SAML configuration might not be retained when it is configured with the cloudctl command line tool.

Symptom: Data that was previously migrated doesn't have the SAML configuration, and logging in with SAML is no longer possible.

Resolution: To resolve the issue, see SAML configured with cloudctl isn't retained after upgrading from foundational services 3.19.x to 4.x.

IM pods cannot be deployed when foundational services is configured with external EDB PostgreSQL

version 46x From foundational services version 4.6.10, IM operator requires the TLS certificate verification for external EDB PostgreSQL connections. If the existing server certificates do not contain Subject Alternative Name (SAN), replace the existing server certificate in an external EDB PostgreSQL server with the new server certificate that contains SANs. The SAN attribute values have to be DNS names that the certificate is valid for, or IP address for the server where the certificate is used. This requirement follows the modern security best practices and guidelines in RFC 9525.

Symptoms

The following error message is displayed in the IM operator log:

{"level":"info","ts":"2025-02-26T20:21:21Z","logger":"controller_authentication","msg":"Perform any pending migrations","Request.Namespace":"production","Request.Name":"example-authentication","subreconciler":"handleMigrations"}
{"level":"info","ts":"2025-02-26T20:21:21Z","logger":"controller_authentication","msg":"Retrieving change logs","Request.Namespace":"production","Request.Name":"example-authentication"}
{"level":"info","ts":"2025-02-26T20:21:21Z","logger":"controller_authentication","msg":"Connecting to PostgresDB","Request.Namespace":"production","Request.Name":"example-authentication","PostgresDB.Host":"postgres-client-auth1.fyre.ibm.com","PostgresDB.Port":"5432"}
{"level":"error","ts":"2025-02-26T20:21:21Z","logger":"controller_authentication","msg":"Failed to connect to PostgresDB","Request.Namespace":"production","Request.Name":"example-authentication","error":"failed to connect to `host=postgres-client-auth1.fyre.ibm.com user=postgres database=imcnpdb`: failed to write startup message (write failed: tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead)","stacktrace":"github.com/IBM/ibm-iam-operator/database/schema/v1.GetChangelogs\n\t/home/prow/go/src/github.com/IBM/ibm-iam-operator/database/schema/v1/tables.go:1523\ngithub.com/IBM/ibm-iam-operator/database.PlanMigrations\n\t/home/prow/go/src/github.com/IBM/ibm-iam-operator/database/migrate.go:61\ngithub.com/IBM/ibm-iam-operator/controllers/operator.(*AuthenticationReconciler).handleMigrations\n\t/home/prow/go/src/github.com/IBM/ibm-iam-operator/controllers/operator/migration.go:378\ngithub.com/IBM/ibm-iam-operator/controllers/operator.(*AuthenticationReconciler).Reconcile\n\t/home/prow/go/src/github.com/IBM/ibm-iam-operator/controllers/operator/authentication_controller.go:369\nsigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).Reconcile\n\t/home/prow/go/pkg/mod/sigs.k8s.io/controller-runtime@v0.16.1/pkg/internal/controller/controller.go:119\nsigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).reconcileHandler\n\t/home/prow/go/pkg/mod/sigs.k8s.io/controller-runtime@v0.16.1/pkg/internal/controller/controller.go:316\nsigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).processNextWorkItem\n\t/home/prow/go/pkg/mod/sigs.k8s.io/controller-runtime@v0.16.1/pkg/internal/controller/controller.go:266\nsigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).Start.func2.2\n\t/home/prow/go/pkg/mod/sigs.k8s.io/controller-runtime@v0.16.1/pkg/internal/controller/controller.go:227"}
{"level":"error","ts":"2025-02-26T20:21:21Z","logger":"controller_authentication","msg":"Failed to handle migrations","Request.Namespace":"production","Request.Name":"example-authentication","subreconciler":"handleMigrations","error":"failed to form a migration plan: failed to retrieve changelogs: failed to connect to `host=postgres-client-auth1.fyre.ibm.com user=postgres database=imcnpdb`: failed to write startup message (write failed: tls: failed to verify certificate: x509: certificate relies on legacy Common Name field, use SANs instead)","stacktrace":"github.com/IBM/ibm-iam-operator/controllers/operator.(*AuthenticationReconciler).handleMigrations\n\t/home/prow/go/src/github.com/IBM/ibm-iam-operator/controllers/operator/migration.go:381\ngithub.com/IBM/ibm-iam-operator/controllers/operator.(*AuthenticationReconciler).Reconcile\n\t/home/prow/go/src/github.com/IBM/ibm-iam-operator/controllers/operator/authentication_controller.go:369\nsigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).Reconcile\n\t/home/prow/go/pkg/mod/sigs.k8s.io/controller-runtime@v0.16.1/pkg/internal/controller/controller.go:119\nsigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).reconcileHandler\n\t/home/prow/go/pkg/mod/sigs.k8s.io/controller-runtime@v0.16.1/pkg/internal/controller/controller.go:316\nsigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).processNextWorkItem\n\t/home/prow/go/pkg/mod/sigs.k8s.io/controller-runtime@v0.16.1/pkg/internal/controller/controller.go:266\nsigs.k8s.io/controller-runtime/pkg/internal/controller.(*Controller).Start.func2.2\n\t/home/prow/go/pkg/mod/sigs.k8s.io/controller-runtime@v0.16.1/pkg/internal/controller/controller.go:227"}
{"level":"info","ts":"2025-02-26T20:21:21Z","logger":"controller_authentication","msg":"Update status before finishing loop.","Request.Namespace":"production","Request.Name":"example-authentication"}
 

Resolution

To resolve the issue, see IM pods cannot be deployed when foundational services is configured with external EDB PostgreSQL.

SAML IdP registration fails due to size of the idp_metadata

SAML IdP registration fails when the size of the idp_metadata is more than 1.5 MB.

Symptom

The following error message is displayed:

Payload Too Large
 
Invalid JSON input
 

Resolution

version 4110 From foundational services 4.11, the maximum accepted size of the metadata is 2 MB. To resolve the issue, upgrade the existing foundational services version to v4.11.

SAML with IdP initiated login failure

The SAML login fails when you configure SAML with IdP initiated login.

Symptom

The following error is displayed:

500: The SAML login attempt failed. This failure could indicate that the SAML identity provider has been misconfigured. If this is an IDP initiated SAML provider, verify that the relay state parameter is set.
 

Resolution

To resolve the issue, set the relay state in the IdP end. For more information, see SAML login fails when you configure SAML with IdP initiated login.

Display name and email are displayed as undefined undefined for IBM Security Verify

The Display name and email are displayed as undefined undefined for IBM Security Verify. The values are not retrieved when listed from the associated IdP group in Cloud Pak for Data.

Symptom

The Display name and email in the group is displayed as undefined undefined when you list the users in the group in IBM Security Verify.

The following is the sample error in IBM Security Verify:

Display name and email issue in IBM Security Verify

Resolution

This limitation is planned to be fixed in an upcoming release.

Updating default Admin username fails and returns 400 Bad request

version 46x Updating default Admin username in foundational services v4.6.3 fails and returns 400 Bad request. You need to update the Admin username manually.

Symptom

You cannot update the default admin username using the idmgmt/identity/api/v1/users/defaultAdmin API and the following error message is displayed:

400 Bad request
 

Resolution

From foundational services v4.6.4, the issue is fixed and you can update the default admin username using the idmgmt/identity/api/v1/users/defaultAdmin API.

Client registration failure in Platform UI console

Client registration fails in the Platform UI console when you upgrade foundational services version 3.22 or version 3.23 to foundational services version 4.x.x.

Symptoms

You might fail to register the client in Platform UI console in the following scenarios:

  • When you upgrade the foundational services version 3.22 or version 3.23 to foundational services version 4.x.x and migrate more than one LDAP.

  • When you have more than one LDAP before upgrading foundational services version 3.22 or version 3.23 to foundational services version 4.x.x.

Resolution

This limitation is planned to be fixed in an upcoming release. Until then, to work around the issue, see Client registration failure in Platform UI console.

Login failure in Platform UI console

Platform UI console login fails when you upgrade foundational services version 3.22 or version 3.23 to foundational services version 4.x.x.

Symptom

There might be intermittent login failure in Platform UI console when you upgrade the foundational services version 3.22 or version 3.23 to foundational services version 4.x.x and then configure the multiple LDAPs.

Resolution

This limitation is planned to be fixed in an upcoming release. Until then, to work around the issue, see Intermittent login failure in Platform UI console.

Username in the group is displayed as undefined undefined

In foundational services version 3.23 and later, the username in the group is displayed as undefined undefined when you list the users in the group in Platform UI console by using Azure SCIM integration or SAML without LDAP configuration.

Resolution

It is a known limitation. Currently, no workaround is available.

Okta user cannot log out in the Platform UI

In foundational services version 3.23, Okta user cannot log out in the Platform UI once that user login to Okta as SAML IdP (Identity provider).

It happens because the Okta user might be logging out from the Cloud Pak only, not from Okta. As a result, the Okta user still resides in the cookie of your browser and the Cloud Pak cannot log out the Okta user. You need to log out from Okta to delete the cookie from your browser. Once you log out from the Okta, you can login with new user or the same user with new session.

Login page is displayed twice when you login to Platform UI console with the SAML option

The login page is displayed again instead of the home page of the console once you provide the login details. However, the second time you don't need to provide the details in the login page, you just need to click Login and the home page of the console will be displayed. It is a known limitation. Currently, no workaround is available.

OIDC registration fails to update

Before you register the OIDC clients by using IdP V3 API, you need to login into third party ID provider. And, then you can register the OIDC clients in the application. While registering, you use application url as cp-console url and redirect URL as https://<cp-console-url>/ibm/api/social-login/redirect/<name of the oidc>. However, you might face issue while opening the cp-console browser. When you click the configured ID provider name, you might not be redirected to the authentication page of that IdP.

Resolution

To troubleshoot the issue, see OIDC registration fails to update.

LDAP user names are case-sensitive

You must use the name exactly the way it is configured in your LDAP directory.

SAML user with Platform UI administrator permission only has viewer role set in IM

You must assign roles individually to SAML users in IM.

OpenShift group synchronization issue

The OpenShift group does not synchronize when a user is added or removed from an LDAP group.

An OpenShift group is created when you add the LDAP group to teams. When a user is added or removed from an LDAP group at the LDAP server side, the OpenShift group does not update by any process or thread in IM.

Resolution

To resolve this issue, delete and re-add the LDAP group to teams to recreate the OpenShift group with the latest members.

OpenShift users are not removed when you remove them from the LDAP group

An OpenShift group is created when you add the LDAP group to teams. An OpenShift user is created when you add an LDAP user to teams, or when this LDAP user logs in to the IBM Cloud Pak console. When a user is removed from an LDAP group at the LDAP server side, the OpenShift group does not update by any process or thread in IM. An OpenShift user or group is deleted only if this user or group is deleted from teams.

Resolution To resolve this issue, delete and re-add the LDAP group to teams to recreate the OpenShift group with the latest members, and manually delete the OpenShift user. To delete the user, use the following command: oc delete user <user_id>.

SAML and LDAP authentication types are displayed in the cp-console login page

The SAML and LDAP authentication types are displayed in the cp-console login page when you migrate IM from version 3.x to 4.x with the configuration of SAML with LDAP dependency using V2 API.

Resolution

To resolve the issue, update the Identity Provider (IdP) for SAML with LDAP dependency with V3 API schema elements. For more information, see SAML with LDAP dependency using V2 API does not work correctly.

SAML identity provider is removed from the SAML configuration

version 4120 The SAML identity provider is removed from the SAML configuration when you upgrade from OCP version 4.10 to 4.12.

To resolve the issue, complete the following steps:

  1. Restart the MongoDB and auth pods.

    oc delete pod -n ibm-common-services -l app=icp-mongodb
     
  2. Verify that the pods are running.

    oc get pod -n ibm-common-services | egrep 'NAME | icp-mongodb'
     

    If the pod status shows as Running, proceed with the next step.

  3. Delete the auth pods.

    oc delete pod -n ibm-common-services -l k8s-app=auth-idp
    oc delete pod -n ibm-common-services -l k8s-app=auth-pap 
    oc delete pod -n ibm-common-services -l k8s-app=auth-pdp 
     
  4. Verify the pod status.

    oc get pod -n ibm-common-services | egrep 'NAME|auth-idp|auth-pap|auth-pdp
     

IM access token API (/idprovider/v1/auth/identitytoken) fails

IM access token API (/idprovider/v1/auth/identitytoken) fails when you upgrade IBM Cloud Pak for Data version 4.7.4 to 5.0.0.

The following error is diplayed in the log when you generate IM access token:

Failed to get access token, Liberty error: {\"error_description\":\"CWWKS1406E: The token request had an invalid client credential. The request URI was \\/oidc\\/endpoint\\/OP\\/token.\",\"error\":\"invalid_client\"}"
 

To resolve the IM access token issue, run the following command to restart the oidc-client-registration job:

oc -n <your-foundational-services-namespace> delete job oidc-client-registration
 

client_secret parameter is stored in the database with the empty value

version 480 This issue is resolved in foundational services version 4.8.x.

The value of client_secret is stored in the database with the empty value when you update the SAML ISV connection using the console.

To resolve the issue, add the secret in the Client secret field in the SCIM configuration section. For more information, see Unable to find and add the IDP users and user groups using the console .

Onboarding OpenShift user group to IM issue

You cannot onboard OpenShift user group to IM because the groups property of the user.openshift.io API is deprecated. For more information, see User [user.openshift.io/v1].

To resolve the issue, you can add the individual users manually and provide access to each user instead of managing the access as groups.

Capacity of hardware resources does not update automatically

When you update the deployment profile, for example from starterset to large, the capacity of hardware resources does not automatically update.

To resolve this problem, restart the common-service-db pods.

cp-console or cpd login fails using LDAP authentication

Unable to login to cp-console or cpd using LDAP authentication. The ClassCastException error is displayed if the ObjectClass or ObjectCategory attribute is not defined in the Liberty XML file.

Symptoms

The following error is displayed in the logs of the auth-service pods:

Exception = java.lang.ClassCastException
Source = com.ibm.ws.security.oauth20.plugins.jose4j.OidcUserClaims
probeid = 178
Stack Dump = java.lang.ClassCastException: com.ibm.wsspi.security.wim.model.Entity incompatible with com.ibm.wsspi.security.wim.model.PersonAccount
  at com.ibm.ws.security.oauth20.plugins.jose4j.OidcUserClaims.getUserinfoFromRegistryMap(OidcUserClaims.java:136)
  at com.ibm.ws.security.oauth20.plugins.jose4j.OidcUserClaims.getUserinfoFromRegistry(OidcUserClaims.java:177)
  at com.ibm.ws.security.openidconnect.web.OidcEndpointServices.getUserinfoFromRegistry(OidcEndpointServices.java:1001)
  at com.ibm.ws.security.openidconnect.web.OidcEndpointServices.userinfo(OidcEndpointServices.java:922)
  at com.ibm.ws.security.openidconnect.web.OidcEndpointServices.handleOidcRequest(OidcEndpointServices.java:281)
  at com.ibm.ws.security.openidconnect.web.OidcEndpointServlet.handleRequest(OidcEndpointServlet.java:111)
  at com.ibm.ws.security.openidconnect.web.OidcEndpointServlet.doPost(OidcEndpointServlet.java:69)
  at javax.servlet.http.HttpServlet.service(HttpServlet.java:707)
 

Resolution

From foundational services v4.6.3, IM supports the LDAP Entity type configuration for LDAP User and Group entities to define the ObjectClass or ObjectCategory attributes automatically in the Liberty XML file. For more information, see Unable to login to cp-console or cpd using LDAP authentication.

Zen reconciles multiple times to complete EDB PostgreSQL database migration

version 46x Zen reconciles multiple times to complete EDB PostgreSQL database migration when you upgrade from foundational services version 3.x to 4.6.

Symptoms

The following errors might be displayed in the ibm-zen-operator pod logs:

stderr: 'W0425 07:10:15.993498    6885 reflector.go:456] k8s.io/client-go/tools/watch/informerwatcher.go:146: watch of *unstructured.Unstructured ended with: an error on the server ("unable to decode an event from the watch stream: no kind \"Pod\" is registered for version \"v1\" in scheme \"k8s.io/client-go/dynamic/scheme.go:29\"") has prevented the request from succeeding'^[[0m^M
 
stderr: 'error: no matching resources found'^[[0m^M
 

The following error might be displayed in the ibm-iam-operator logs:

{"level":"error","ts":"2024-05-28T06:41:18Z","logger":"controller_authentication","msg":"Encountered an error while performing the current migration","Request.Namespace":"cp4ba","Request.Name":"example-authentication","subreconciler":"handleMigrations","error":"failure occurred during MongoToV1: server selection error: server selection timeout, current topology: { Type: ReplicaSetNoPrimary, Servers: [{ Addr: mongodb.ibm-common-services.svc.cluster.local:27017, Type: Unknown, Last error: dial tcp 172.30.246.180:27017: i/o timeout }, ] }","stacktrace":"github.com/IBM/ibm-iam-operator/controllers/operator.(*AuthenticationReconciler).handleMigrations\n\t/home/prow/go/src/github.com/IBM/ibm-iam-operator/controllers/operator/authentication_controller.go:432\ngithub.com/IBM/ibm-iam-operator/controllers/operator.(*AuthenticationReconciler).Reconcile\n\t/home/prow/go/src/github.com/IBM/ibm-iam-operator/controllers/operator/authentication_controller.go:850\nsigs.k8s.io/controller-runtime/pkg/internal/controller.(*Co...
 

Resolution

To resolve the issue, update the network policy of ibm-iam-operator to enable traffic for the mongo service. For more information, see Zen reconciles multiple times during EDB PostgreSQL database migration.

A login issue might occur with the unified route when running a large profile

A login issue might occur by switching to the unified route when IBM Cloud Pak® foundational services is installed with a large profile, such as if multiple replicas of pods are running.

Resolution

If you encounter this issue, deunify the route. For more information, see A login issue might occur with the unified route when running a large profile.

Installer known issues

Common-service-db EDB PostgreSQL cluster custom resource (CR) might not be successfully created

When you upgrade to IBM Cloud Pak foundational services version 4.6 or later while using EDB PostgreSQL cluster as a database, the common-service-db EDB PostgreSQL cluster custom resource (CR) might not be successfully created. This issue might occur if you apply a patch for the license key of the embedded EDB PostgreSQL database on an old version of IBM Cloud Pak foundational services.

This issue can occur when you upgrade to one of the following versions of IBM Cloud Pak foundational services: 4.6.2 to 4.6.7, 4.7.x, 4.8.x and 4.9.x. This issue is fixed in foundational services version 4.6.8, 4.10.0 and later. For more information, see EDB PostgreSQL cluster custom resource is not created during upgrade.

Status of common-service-db EDB PostgreSQL cluster custom resource (CR) is stuck in the Setting up primary state or no state

version 46x After you install or upgrade to IBM Cloud Pak foundational services version 4.6 or later while using EDB PostgreSQL cluster as a database, the status of common-service-db EDB PostgreSQL cluster custom resource (CR) is stuck in the Setting up primary state or no state.

To resolve the issue, delete the existing common-service-db EDB PostgreSQL cluster CR and re-create it. For more information, see Status of EDB PostgreSQL cluster custom resource is stuck in the Setting up primary state or no state.

OLM is unable to generate new installation plans for updates or new installations

OLM is unable to generate new installation plans for updates or new installations. For more information about the issue and the steps to resolve the issue, see OLM is unable to generate new install plans.

Operator pods are in Crashloopbackoff status

After you upgrade foundational services, you might see some of the operator pods are in Crashloopbackoff status. This is because of an Operator Lifecycle Manager (OLM) known issue. For more information about the issue and the steps to resolve the issue, see Operator upgrade fails - OLM known issue.

OpenShift user admin collides with IBM Cloud Pak foundational services default user admin

When there is an OpenShift user admin it collides with IBM Cloud Pak foundational services default user admin. To resolve the issue, rename the IBM Cloud Pak foundational services default username if an admin username exists in OpenShift. For more information, see Changing the default admin username.

Operators are in Pending, Unknown, or Can't Update status

When you install or upgrade foundational services, you might see that some of the operators are in a Pending, Unknown, or Can't Update status. This is because of an Operator Lifecycle Manager (OLM) known issue.

For more information about the issue and the steps to resolve the issue, see the following topics:

IBM Cloud Pak foundational services pods do not start on Azure environment with Azure storage

When you install foundational services on Azure environment with Azure storage, foundational services pods do not start. To resolve this issue, get the scc.uid from the installation namespace before creating the custom Azure storage class. For more information, see Using Azure File storage class.

IBM Cloud Pak foundational services operator CSV fails

version 4150 After upgrading an OpenShift cluster to OpenShift version 4.15.x via the OpenShift console, the foundational services operator CSV fails with the following message: install strategy failed: rolebindings.rbac.authorization.k8s.io "ibm-common-service-operator-service-auth-reader".

To resolve this issue, see Install strategy fails after upgrading OpenShift to 4.15.x.

ZenService fails to be in the ready status for EDB PostgreSQL

ZenService fails to be in the ready status for EDB PostgreSQL. The following error message is logged in the Zen operator log:

stderr: 'error: no matching resources found'
 

To resolve the issue, add the instana: True parameter in the ZenService custom resource. For more information, see ZenService fails to be in the ready status for EDB PostgreSQL.

Zen operator fails when you install or upgrade to Zen version 6.0.4

The zen operator fails when you install or upgrade to Zen version 6.0.4 with the external PostgreSQL database.

Symptom

The following error message is displayed in the Zen operator log:

6.0.4/roles/0010-infra has failed with error: All items completed
 

Resolution

To resolve the issue, you need to update the service resource for the zen-metastore-edb. For more information, see Zen operator fails when you install or upgrade to Zen version 6.0.4.

Hardware resources does not update automatically

When you update the deployment profile, for example from starterset to large, the capacity of hardware resources does not automatically update. To resolve this problem, restart the common-service-db pods.

ConfigMap fields are reset after an upgrade

version 4120 If you previously configured settings directly in the platform-auth-idp ConfigMap and then directly upgraded to IBM Cloud Pak® foundational services 4.12, some of those settings might be reset to their defaults. If needed, write any custom settings that were originally specified in the ConfigMap to the CommonService CR instead. For more information, see ConfigMap fields are reset after an upgrade.

Cert-manager known issues

Certificates might not be in the ready status for clusters with two cert-managers

In the cert-manager-controller pod, there are error messages that indicate there is more than one CertificateRequest for one or more Certificates. If CNCF cert-manager and foundational services cert-manager are installed in the cluster, the following output is displayed:

ibm-common-services    cert-manager-cainjector-xxx-xxx</br><br>ibm-common-services    cert-manager-controller-xxx-xxx
ibm-common-services    cert-manager-webhook-xxx-xxx</br><br>ibm-common-services    ibm-cert-manager-operator-xxx-xxx
cert-manager    cert-manager-cainjector-xxx-xxx</br><br>cert-manager    cert-manager-xxx-xxx</br><br>cert-manager cert-manager-webhook-xxx-xxx
 

For more information, see Problem when you install two different cert-managers.

Leaf certificates that use the CA certificate are not refreshed automatically

The self-signed CA certificate that is used by IBM Cloud Pak foundational services and created by the cert-manager service has a duration of 90 days. The CA certificate is refreshed by cert-manager but the leaf certificates that use the CA certificate must be manually refreshed.

Recommend that user check the expiration date for the CA certificate and refresh the CA certificate before the expiration date and renew the leaf certificates. The CA certificate duration can also be updated.

License Service Reporter

Error message is displayed when you select the Licensing menu in the IBM Cloud Pak console

After you upgrade to foundational services version 4.0 or later, the Error 404 - Not found error message is displayed when you select the Licensing menu in the IBM Cloud Pak console.

To resolve the issue, remove the ibm-license-service-reporter-bindinfo-ibm-license-service-reporter-zen configmap from the namespace where you deployed the foundational services. For more information, see Retrieving License Service Reporter console route to access the License Service Reporter console directly. -->

Platform UI known issues

Upgrade of Platform UI (zen) operand fails

Attempting to upgrade the ZenService custom resource results in the following error message that indicates the previous operation has not finished:

Requested operation is aborted as status for the current operation,
        install, is InProgress and requested version 4.5.0 is not the version of
        the previously started operation
 

To resolve this problem, see Upgrade of Platform UI (zen) operand fails. -->

Events operator known issues

Time out error in Events operator periodically during the reconciliation process

Events operator is periodically printing the following message: Failed to acquire lock during the reconciliation process, and it is timing out. This might indicate that the lock was not properly released due to an error.

Resolution

To resolve the problem, restart the Events operator to release the lock.

OpenSearch known issues

New pods cannot join the cluster during or after upgrade from Elasticsearch to OpenSearch

During the upgrade from Elasticsearch operand to OpenSearch, the highest ordinal pod in each of the role-based statefulsets cannot join the existing cluster and fails to pass the ready checks. Haproxy logs show frequent SSL handshake errors. The CA certificates on the new pods' haproxy containers fail to validate the TLS certificates that are provided by the old pods and vise versa.

Resolution

To resolve the issue, delete the pods from the old cluster. When the statefulset creates the new pods, these pods have the right certificates to join the other pods that participate in the new cluster.

For more information, see New pods cannot join the cluster during or after upgrade from Elasticsearch to OpenSearch.