Express installation
If you are installing on an internet-connected cluster using the OpenShift web console, you can follow these steps to get up-and-running quickly with IBM Cloud Pak® for Integration. Express installation covers all phases of installation up to, but not including, deploying instances of capabilities and runtimes.
- Adding online catalog sources to your OpenShift cluster if your cluster is connected to the internet.
- Installing in an air-gapped environment if your cluster is not connected to the internet.
Requirements
You can use express installation if your deployment meets the following requirements:
Cluster
- Your Red Hat OpenShift cluster has access to the internet to pull images
- You are installing with the OpenShift web console.
- You have cluster admin privileges to perform the installation.
- You are installing Cloud Pak for Integration on a cluster running on OpenShift Container Platform version 4.6 and later. If you don't already have a license to run OpenShift, you may be able to use an OpenShift trial entitlement. For more information, see Get started with OpenShift.
- The minimum install size for Cloud Pak for Integration requires the following
resources to be available on your cluster:
- 32 CPU units
- 128 GB of memory
The available resources can be spread across one or more worker nodes. If you have a trial scenario in mind, and need to size the cluster for workloads with specific capabilities, see Table 1. Note: These requirements are intentionally scaled down and simplified so that you can get started quickly. For details on sizing, see Compute resources for development environments. For details on environment requirements, see Operating environment.Note: The trial license does not entitle you to IBM support.
If you wish to use a different type of deployment (one that does not meet the requirements for this procedure), see Installation options.
Storage
The capabilities and runtimes in Cloud Pak for Integration have varying storage requirements. At a minimum, you require a storage class that supports the RWO access mode. For other capabilities in Cloud Pak for Integration (Asset Repository, Operations Dashboard, App Connect dashboard, Aspera HSTS, and MQ), you also need a storage class that supports the RWX access mode.
The recommended storage providers are:
-
OpenShift Data Foundation (formerly OpenShift Container Storage), version 4.2 or above
-
Portworx Storage, version 2.5.5 or above
-
IBM Cloud Block Storage and IBM Cloud File Storage
Adding the IBM CatalogSource
object
- Log into the OpenShift web consolewith your OpenShift cluster admin credentials.
- In the top banner, click the plus (+) icon to open the Import
YAML dialog box.Note: You do not need to select a value for Project. The YAML in the next step already includes correct value for
metadata:namespace
, which ensures that the catalog source is installed in the correct project (namespace). - Paste this resource definition into the dialog
box:
apiVersion: operators.coreos.com/v1alpha1 kind: CatalogSource metadata: name: ibm-operator-catalog namespace: openshift-marketplace spec: displayName: IBM Operator Catalog image: 'icr.io/cpopen/ibm-operator-catalog:latest' publisher: IBM sourceType: grpc updateStrategy: registryPoll: interval: 45m
- Click Create.
Installing the Cloud Pak for Integration Operator
- Log into the OpenShift web console with your OpenShift cluster admin credentials.
- Make sure you have selected the Administrator view.
- Click Operators > OperatorHub > Integration & Delivery.
- Search for and click the tile for the IBM Cloud Pak for Integration operator.
- Click Install.
- In the Install Operator pane:
- Select the latest update channel.
- Select the option to install Cloud Pak for Integration in one namespace or for all namespaces on your cluster. If in doubt, choose the All namespaces on the cluster installation mode, and accept the default Installed Namespace.
- Select the Automatic approval strategy.
- Click Install.
Obtaining your entitlement key
- Go to the Container software library.
- Click Copy key.
- Copy the entitlement key to a safe place so you can use it in Adding a pull secret to a namespace.
- (Optional) Verify the validity of the key by logging in to the IBM Entitled Registry using a
container
tool.
docker login cp.icr.io --username cp --password entitlement_key
Adding a pull secret to a namespace
To install Cloud Pak for Integration in its own namespace, create a docker registry
secret named ibm-entitlement-key
, using the following command. In the third line,
replace entitlement_key with the value of your entitlement key from the previous
section. In the last line, replace target_namespace with the name of your target
namespace:
oc create secret docker-registry ibm-entitlement-key \
--docker-username=cp \
--docker-password=entitlement_key \
--docker-server=cp.icr.io \
--namespace=target_namespace
Deploying the Cloud Pak for Integration instance
Creating the Platform Navigator instance
- Log into the OpenShift web console with your OpenShift cluster admin credentials.
- In the navigation panel, click Operators > Installed Operators.
- In the list on the Installed Operators panel, find and click IBM Cloud Pak for Integration Platform Navigator.
- Click the Platform Navigator tab.
- Click Create PlatformNavigator. The Create Platform
Navigator panel opens. The Form view is selected by
default).
- Change Project to your project name: Click the drop-down arrow and select
your project name from the list. The project name in the example screen below is
cp4i.Note: Project is the same as the Kubernetes term namespace. You may encounter both terms in the UI or in the documentation. They are interchangeable.
- In the Name field, enter a name for the new instance.
- Accept the terms of the license agreement. Click to expand the License
section:
- Set License Accept to true.
- For License LI, click the arrow to open the drop-down list, and select a license. For details about specific licenses, see the "Table of license versions" section in Licensing.
- Set License Accept to true.
- Specify the Storage class. Click the arrow to expand the
Storage pane, then click the arrow for Select Storage
Class and select a file storage class. Note: If you don't see any options in the Storage Class list, you need to create one or more storage options. See the Requirements section for more information.
- Set any other configuration values as appropriate.
- Click Create.
Your instance of Platform Navigator is added to the list of instances in the current project (namespace).
Logging into your Cloud Pak for Integration instance
When the Platform Navigator status changes to Ready
, log into IBM Cloud Pak Platform UI for the first time to create Cloud Pak for Integration
users and permissions.
- In the navigation panel of the OpenShift web console, click Operators > Installed Operators.
- Click to expand the Project list and select the project where Platform Navigator is deployed.
- In the Installed Operators pane, click IBM Cloud Pak for Integration Platform Navigator.
- Click Platform Navigator.
- In the PlatformNavigators list, click the name of the deployed instance.
- In the Endpoints section, click the link under Platform Navigator UI.
- At the login screen, click OpenShift authentication and log in with your
OpenShift cluster admin credentials.
The IBM Automation UI opens. You can now create users and permissions.
Next steps
You are now ready to begin deploying capabilities and runtimes. See Deploying capabilities and runtimes for more information.