Installing IBM Fusion on Amazon Web Services

Procedure to install IBM Fusion on OpenShift® Container Platform that runs on Amazon Web Services and Amazon Web Services ROSA.

Before you begin

  • Ensure you complete all the prerequisites before you proceed with the installation. For the prerequisites, see Prerequisites
  • For more information about deployments and their supported services, see Support matrix for IBM Fusion versions.
  • Configure image pull secrets. For more information about pull secret prerequisite, see Creating image pull secret.
  • Multiple zone Amazon Web Services cluster
  • Open TCP ports on Amazon Web Services: 1191, 12345, 60000 –61000. Sample script to open these ports:
    ROSA_NAME=YOUR_ROSA_CLUSTER_NAMECLUSTER_REGION="$(rosa describe cluster -c $ROSA_NAME| grep Region | awk '{print $2}')"VPC_ID="$(aws ec2 describe-security-groups --region ${CLUSTER_REGION} | grep -A15 $ ROSA_NAME | grep VpcId | tail -1 | cut -d '"' -f4)"SG_ID="$(aws ec2 describe-security-groups --region ${CLUSTER_REGION} --filters "Name=vpc-id,Values=${VPC_ID}" "Name=tag:Name,Values=*-worker-sg" --output json --query "SecurityGroups[*].[GroupId]" | jq | grep sg | awk -F '"' '{print $2}')"aws ec2 authorize-security-group-ingress --region ${CLUSTER_REGION} --group-id "${SG_ID}" --protocol tcp --port 12345 --source-group "${SG_ID}" | jq | tee -a ${SETUP_LOG}aws ec2 authorize-security-group-ingress --region ${CLUSTER_REGION} --group-id "${SG_ID}" --protocol tcp --port 1191 --source-group "${SG_ID}" | jq | tee -a ${SETUP_LOG}aws ec2 authorize-security-group-ingress --region ${CLUSTER_REGION} --group-id "${SG_ID}" --protocol tcp --port "60000-61000" --source-group "${SG_ID}" | jq | tee -a ${SETUP_LOG}

About this task

Support is available for only one instance of IBM Fusion per OpenShift Container Platform.

Procedure

  1. If you have not configured the IBM Operator Catalog, then configure it. For the procedure to add IBM Operator catalog, see Adding the IBM operator catalog.
    Note:
    • IBM Operator Catalog is not specific to a version of IBM Fusion.
    • If you already have the IBM Maximo® software configured in your environment or have plans to configure it, use only the ibm-operator-catalog of IBM Maximo® software.
  2. Log in to Red Hat® OpenShift Container Platform web management console.
  3. Go to Operators > OperatorHub.
  4. Under Source, select IBM Operator Catalog.
    It lists all operators that are part of the IBM Operator Catalog including IBM Fusion.
  5. Click IBM Fusion.
    The Version, Capability level, Source, and Provider type of IBM Fusion is available.
  6. Click Install.
    It opens the Install Operator page for IBM Fusion operator.
  7. Select v2.0 in the update channel where the current operator is published.
    Note: You can also subscribe for updates. The subscription to the channel helps to keep the operator up to date.
  8. In the Installation mode, select A specific namespace on the cluster.
    The operator will be available in a single Namespace only.
  9. Select ibm-spectrum-fusion-ns in the Operator recommended namespace. Alternatively, use the Select a namespace option to select an existing namespace or create a new namespace.
  10. Important: Always set Update approval to Manual as IBM Fusion does not support Automatic.
    In the Update approval section, you can select either Manual or Automatic strategy.
    Always set Update approval to Manual because the Automatic option automatically upgrades the operator whenever a new version of the operator is released to the channel. This automatic upgrade might have an impact on your running workloads.
  11. Click Install.
    The installation of the operator begins.
  12. Wait for the operator to complete the installation.
    After the successful installation of the operator, the following message gets displayed: 
    Installed operator - operand required

    Generally, it completes in few minutes. If it takes more time, check whether all pods are up and running.

    Note: If you notice that installation is taking longer than usual or failed, then check the events tab on the installed-opertor or fusion-operator page. In the events tab, if you see an error waiting for deployment of serviceability-operator, ignore it and continue with the installation.
  13. From the Applications menu in the title bar of OpenShift Container Platform, click IBM Fusion.
    The License agreement page gets displayed.
  14. Go through the license agreement, click I have read and accept the license agreement, and click Continue.
    The Welcome to IBM Fusion dialog box gets displayed.
  15. In the IBM Fusion user interface, click Install services to install the services right away or click Maybe later to do it later.

What to do next

  1. For steps to verify the success of the installation, see Validating IBM Fusion installation.
  2. If you want to enable the services from the IBM Fusion user interface, see the following procedures accordingly:
    1. For IBM Data Cataloging, see Installing IBM Data Cataloging.
    2. For Data Foundation, see Installing Fusion Data Foundation.
    3. For Backup & Restore, see Install Backup & Restore.
    4. For CAS, see Installing Content-Aware Storage (CAS).
    If you want to install IBM Fusion services using OpenShift Container Platform, then see Deploying IBM Fusion services using CLI.
  3. To know more about the user interface of IBM Fusion, see Knowing your IBM Fusion user interface.