Install IEAM

You must install and configure a management hub before you start the IBM Edge Application Manager (IEAM) node tasks.

Installation summary

Note: Upgrade from IBM Edge Application Manager 4.1 is not supported.

Prerequisites

Red Hat® OpenShift® Container Platform

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.

Browser installation process

  1. 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:

    Default Storage Class

    Note: For more information about using a non-default storage class, see the Configuration page.

  2. 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 IBM Catalog Source

  3. 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
    

    Create IBM CS Catalog Source

  4. Navigate to the Projects page and create a project where you want to install the operator:

    Create Project

  5. Define an image pull secret called ibm-entitlement-key to authenticate to the IBM Entitled Registry:

    Notes:

    Create Image Pull Secret

  6. Navigate to the OperatorHub page, click the checkbox next to IBMCS Operators and search for common-service.

  7. Click on the IBM Cloud Pak foundational services card and click Install.

  8. 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.

  9. Navigate to the OperatorHub page and search for IEAM Management Hub.

  10. Click the IEAM Management Hub card and click Install.

  11. 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.

    Install IEAM Operator

  12. 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:

    EamHub CR

  13. 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.

    Create EamHub CR 4.5

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.

What's Next

Continue setting up your new management hub by performing the steps in post installation.