Deploying the Platform UI by using the OpenShift console

Deploying the IBM Cloud Pak Platform UI allows you to deploy and manage instances from a central location. This task must be performed by a cluster administrator. For more information, see Roles and permissions.

This procedure describes how to deploy and configure the IBM Cloud Pak Platform UI using the OpenShift web console. To deploy using the CLI, see Deploying the Platform UI by using the CLI.

Troubleshooting: For a list of possible errors and solutions when performing the steps in this section, see Troubleshooting Platform UI deployment.

Prerequisites

  • You are on a supported version of Red Hat OpenShift Container Platform. For more information, see Operating environment.

  • If you have an online cluster and have not already created a secret called ibm-entitlement-key in the namespace where the instance will be created, see Finding and applying your entitlement key by using the UI (online installation).

  • An OpenShift cluster administrator has created one or more storage classes that support ReadWriteMany (RWX) and allows read and write access to non-root users. Supported storage providers include ibmc-file-gold-gid, OpenShift Data Foundation (formerly OpenShift Container Storage), Spectrum, and Portworx. For additional details about storage support and configuration, see Storage considerations.
    Tip: For OpenShift Data Foundation in a production environment, the optimal minimum deployment is 4 storage nodes, with 3 Object Storage Daemons (OSDs) on each node. This provides much greater data resiliency in the event of any OSD failures.

To deploy the Platform UI with an RWO storage class, follow the procedures in Deploying the Platform UI with RWO storage.

Deploying with the OpenShift web console

  1. Log into the OpenShift web console with your OpenShift cluster admin credentials.

  2. In the navigation pane, click Home > Overview.

  3. In the Build with guided documentation section, click View all quick starts.

  4. In the Quick Starts panel, click the tile for Getting started with the Cloud Pak for Integration.

  5. In the panel that opens, follow the procedures to deploy the Platform UI.
    Tip: If you have followed all the procedures up to this point, you can skip the Prerequisites section.

Next steps

After you complete other deployment tasks in the Platform UI, you can perform additional post-installation configuration such as:

After configuring the Platform UI, deploy IBM Cloud Pak for Integration capabilities. For more information, see Deploying instances of capabilities.