You must install and configure a management hub before you start the IBM Edge Application Manager (IEAM) node tasks.
Note: Upgrade from IBM Edge Application Manager 4.1 is not supported.
Ensure that you have an appropriately sized and supported OpenShift Container Platform installation, including appropriate storage services installed and working in your cluster. For more information about installing OpenShift Container Platform, see the OpenShift documentation for the supported versions:
Note: By default, local development databases are provisioned as part of operator deployment. For more information about connecting to your own provisioned databases and other configuration options, see the Configuration page.
You are responsible for backing up or restoring your databases, see the backup and recovery page.
Log in through the OpenShift Container Platform web UI with cluster admin privileges. Navigate to the Storage page to confirm you have a supported Default storage class defined:
Note: For more information about using a non-default storage class, see the Configuration page.
Create the IBM Operator Catalog Source, which provides the capability to install the IEAM Management Hub bundle. Copy and paste this text after you select the import plus sign as shown in the following image. After you paste the text, click Create:
apiVersion: operators.coreos.com/v1alpha1 kind: CatalogSource metadata: name: ibm-operator-catalog namespace: openshift-marketplace spec: displayName: IBM Operator Catalog publisher: IBM sourceType: grpc image: docker.io/ibmcom/ibm-operator-catalog:latest updateStrategy: registryPoll: interval: 45m
Create the IBM Common Services Operator Catalog Source. This provides the suite of Common Service operators which IEAM Management Hub will additionally install. Copy and paste this text after you select the import plus sign as shown in the following image. After you paste the text, click Create:
apiVersion: operators.coreos.com/v1alpha1 kind: CatalogSource metadata: name: opencloud-operators namespace: openshift-marketplace spec: displayName: IBMCS Operators publisher: IBM sourceType: grpc image: quay.io/opencloudio/ibm-common-service-catalog:3.6 updateStrategy: registryPoll: interval: 45m
Navigate to the Projects page and create a project where you want to install the operator:
Define an image pull secret called ibm-entitlement-key to authenticate to the IBM Entitled Registry:
Navigate to the OperatorHub page, click the checkbox next to IBMCS Operators and search for common-service.
Click on the IBM Cloud Pak foundational services card and click Install.
Install the operator selecting the stable-v1 channel, and selecting A specific namespace on the cluster ensuring the selected namespace matches the project created in Step 4.
Navigate to the OperatorHub page and search for IEAM Management Hub.
Click the IEAM Management Hub card and click Install.
Install the operator, ensuring the project matches what was created in Step 4.
Note: This is the only project that the IEAM Management Hub operator watches after it is installed.
Change back to the Project created in Step 4, click EamHub in the Provided APIs column that is shown in Step 7, and click Create EamHub:
Create the EamHub Custom Resource. The EamHub Custom Resource defines and configures your management hub. See the Configuration page for customization options. Ensure the project matches what was created in Step 4.
The operator will deploy the defined workloads in the project that was specified in Step 4 and the required IBM Cloud Platform Common Services workloads in the ibm-common-services project.
Continue setting up your new management hub by performing the steps in post installation.