Deploying the Platform UI using the CLI

1. Log into your cluster, using your OpenShift user credentials:

   oc login

2. If you installed the operators in All namespaces on the cluster mode, you will need to use a project other than openshift-operators in which to deploy the instance.

   • If needed, create a new project for this purpose by running:

     oc new-project <project_name>

     For example:

     oc new-project integration

3. Create a PlatformNavigator YAML file. For example, you could create a file called platform-ui-instance.yaml with the following example configuration. Update the values as indicated:

   • For metadata.namespace, enter your project (namespace) name.

   • Change the value of spec.license.accept to true if you accept the Cloud Pak for Integration license agreement. For details, see Licensing.

   • For spec.storage.class, specify a storage class that supports ReadWriteMany (RWX) volumes and allows read and write access to non-root users. To get a list lf available storage classes, run the command:

   oc get storageclasses

   A list of available storage classes appears. For details about storage support and configuration, see Storage considerations.

   • Change any other configuration details as required.

     apiVersion: integration.ibm.com/v1beta1
     kind: PlatformNavigator
     metadata:
       name: integration-quickstart
       namespace: integration
     spec:
       license:
         accept: false
         license: L-RJON-CJR2RX
       mqDashboard: true
       replicas: 1
       storage:
         class: <storage_class>
       version: 2022.4.1

   If you need advanced configuration options, consult Using the Platform UI.

4. Apply the YAML file to the cluster:

   oc apply -f platform-ui-instance.yaml

5. Check the status of the Platform UI instance by running the following command in the project (namespace) where it was deployed:

   oc get platformnavigator

1. Get a list of console links for the Platform UI in the cluster:

   oc get consolelink | grep "IBM Cloud Pak for Integration"

   This returns a list of URLs, one for each instance of the Platform UI on the cluster. For example:

   NAME                                                           TEXT                                  URL                   
   integration1-console-link-ibm-integration-platform-navigator   IBM Cloud Pak for Integration [dev]   https://cpd-integration-dev.apps.cluster.com
   integration2-console-link-ibm-integration-platform-navigator   IBM Cloud Pak for Integration [uat]   https://cpd-integration-uat.apps.cluster.com
   integration3-console-link-ibm-integration-platform-navigator   IBM Cloud Pak for Integration [prod]  https://cpd-integration-prod.apps.cluster.com

2. For the instance you want to access, copy the URL into your browser.

If you are unable to log in to Platform UI with OpenShift cluster admin credentials (for example, if you are installing in a cluster using Red Hat OpenShift Service on AWS (ROSA)), run the following command to get the password:

oc -n ibm-common-services get secret platform-auth-idp-credentials -o jsonpath='{.data.admin_password}' | base64 -d && echo

The password is now printed in your command line tool.