Installing IBM Fusion on Amazon Web Services

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

Before you begin

  • Ensure you complete all the prerequisites before you proceed with the installation. For the prerequisites, see Prerequisites.
  • 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}
  • Configure image pull secrets. For more information about pull secret prerequisite, see Creating image pull secret.

Procedure

  1. If you have not configured the IBM Operator Catalog, see Adding the IBM operator catalog.
  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 Spectrum Fusion.
  5. Click IBM spectrum Fusion.
    The Version, Capability level, and Provider Type of IBM Fusion is available.
  6. Click Install.
    It opens the Install Operator page for IBM Spectrum 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. In the Update approval, select Automatic or Manual approval 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 - ready for use

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

  13. Open the IBM Fusion user interface. In the OpenShift Container Platform web console, click the Applications icon in the title bar and select IBM Fusion.
    The License agreement page gets displayed.
  14. Go through the license agreement and click Accept license.
    If you want to download the license agreement copy to your local, click Download a copy.
    The Welcome to IBM Spectrum Fusion dialog box gets displayed.
  15. Click Set up services to set up the services right away or click Skip for now to do it later.

What to do next

  1. For steps to verify the success of the installation, see Validating IBM Fusion installation.
  2. To know more about the user interface of IBM Fusion, see Knowing your IBM Fusion user interface.
  3. If you encounter installation errors, see Installation and upgrade issues.