Automated installation 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
Prepare for installation by reading the guidance in the Planning section.
Set up a Red Hat OpenShift cluster by using the Red Hat OpenShift on IBM Cloud service.
Important: 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, begin with Adding catalog sources and mirroring images.
1. Obtain a license
If you don't already have a license, use one of the following methods to obtain one:
Purchase a license through IBM Passport Advantage
Register for a 60-day trial license of IBM Cloud Pak for Integration.
Attention: If you select the trial license, you get entitlement to Cloud Pak for Integration software only. The trial does not include support for Red Hat OpenShift Container Platform.
If you have an IBMid, log in to use your existing IBM account. If you do not log in, the form recognizes your email address and redirects you to the log in page.
If you do not have an IBMid, the registration process uses the email address that you supply to create one. You can use this ID for other IBM trials, demos, and support features that require an account. For more information, see https://www.ibm.com/account/.
When registration is complete, the form redirects you back to this page where you can continue to the next step.
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:
Sign up to, or log in to, your IBM Cloud account.
In the IBM Cloud banner, click Manage > Account to open the Account page.
In the navigation menu, click Licenses and entitlements under Account resources.
If no licenses are available to assign, click Check IBM Passport Advantage to open the Your licenses dialog.
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.
In the Create tab, configure the following settings:
In the Select your cluster section, select the target Red Hat OpenShift cluster. You can filter the table by entering the name of the Red Hat OpenShift cluster that you created earlier (see Before you Begin) in the search field.
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.
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
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"
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
Use the Platform UI to create instances and integrations. For more information, see Deploying instances and Building integrations in IBM Documentation.