IBM Cloud Docs
Why doesn't my cluster add-on work?

Why doesn't my cluster add-on work?

When you try to use a cluster add-on in IBM Cloud Satellite®, the cluster add-on does not work. For example, you installed the Kubernetes web terminal add-on but cannot open the add-on.

Add-ons might not work for several reason.

  • The add-on is not supported for clusters in a Satellite location.
  • The add-on is in an unhealthy state.
  • The add-on settings are misconfigured, such as renaming or editing a ConfigMap.
  • The add-on cannot be backed up in IBM Cloud Object Storage due to conflicting service instance and bucket endpoints.

Take the following steps to troubleshoot the add-on.

  1. Check that the add-on is supported. If not, uninstall the add-on.
  2. If the add-on is misconfigured, refresh the cluster master to restore the add-on to the default settings.
    ibmcloud oc cluster master refresh -c <cluster_name_or_ID>
    
  3. If the add-on is in critical state, review the IBM Cloud Object Storage instance and bucket that backs up the cluster data. The instance and endpoint must have matching endpoints, such as a Global instance with a Cross Region bucket (us-geo endpoint), or a Regional instance with a Regional bucket (us-east endpoint). If the endpoints do not match, you must re-create the Satellite location with matching IBM Cloud Object Storage instance and bucket endpoints.
  4. For more information, review the add-on state and statuses.