Installing on IBM Cloud

Follow these instructions to install IBM Cloud Pak® for Integration on a Red Hat OpenShift cluster that is provided by IBM Cloud®.

Before you begin

  1. Prepare for installation by reading the guidance in the Planning section.

  2. Set up an OpenShift cluster by using the Red Hat OpenShift on IBM Cloud service.

Note: The IBM Cloud software catalog installer for Cloud Pak for Integration does not support installation in the following environments:
  • Multi-zone region (MZR) clusters in IBM Cloud Classic infrastructure
  • Clusters that are deployed in IBM Cloud VPC, in either single-zone or multi-zone topologies
These environments do not provide the storage that is required to deploy Cloud Pak for Integration in a resilient way. You can install into these environments by following a manual installation process instead. During manual installation, you can specify appropriate storage. For more information, see Storage considerations. For manual installation instructions, see "Manual installation" in Installing.

1. Obtain a license

Obtain a license if you don't already have one. You can purchase a license through IBM Passport Advantage.

Tip: You can find your container software entitlement key in the IBM Container Software and Cloud Pak Access Management library. Click Container software library in the navigation menu to get details and a full list of the container software that you own.

2. Assign a license

To assign your license, follow these steps:

  1. Sign up to, or log in to, your IBM Cloud account.

  2. In the IBM Cloud banner, click Manage > Account to open the Account page.

  3. In the navigation menu, click Licenses and entitlements under Account resources.

  4. If no licenses are available to assign, click Check IBM Passport Advantage to open the Your licenses dialog.

  5. Select the appropriate license, then click Assign.

3. Configure installation settings

Open Cloud Pak for Integration from the IBM Cloud Catalog then log in with your IBM Cloud account credentials.

In the Create tab, configure the following settings:

  1. In the Select your cluster section, select the target Red Hat OpenShift cluster. You can filter the table by entering the name of the OpenShift cluster that you created earlier (see Before you Begin) in the search field.

  2. In the Select a project section, select an existing project, or create a new one by entering a unique project name. A project is a Kubernetes cluster namespace, and the list is populated from your Red Hat OpenShift environment. This project name is used as the namespace for the Platform UI.

  3. In the Configure your workspace section, accept the default settings. Cloud Paks use a Schematics workspace to automate the installation. This workspace is used only during the installation process.

4. Install

Review the information in the Summary pane. Read and accept the Cloud Pak for Integration license agreement, then click Install.

What to do next

  1. After the installation completes, click Offering Dashboard to open the Platform UI. You can also find the host URL for the Platform UI by running the following command:

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

  2. Log in to the Platform UI with your username and password. The installation process creates temporary values for you. To find these values, run the following commands, where <namespace> is the project name that you specified in the installation settings:

    • Username:

      oc get secret integration-admin-initial-temporary-credentials -n <namespace> -o jsonpath='{.data.username}' | base64 --decode

    • Password:

      oc get secret integration-admin-initial-temporary-credentials -n <namespace> -o jsonpath='{.data.password}' | base64 --decode

  3. Use the Platform UI to create instances and integrations. For more information, see Deploying instances and Using the Cloud Pak in IBM Documentation.