Prerequisites for installing

Before you begin, ensure that your environment meets the prerequisites by downloading, and installing the software and interfaces that you use to install IBM® Maximo® Application Suite.

Prerequisites

You must have access to the following components:
  • A private image registry setup and running in the restricted network, and secured with certificates. Configure one of the following options:
    • A bastion host with access to product images on the internet and the restricted network and has support for running docker containers. The docker image that contains the IBM Maximo Application Suite command line utility on the bastion host.
    • A host outside the restricted network with access to product images on the internet and with support for running docker containers. The docker image that contains the Maximo Application Suite command line utility on the host. Portable disk space sufficient to store the required images. A host inside the restricted network with support for running docker containers and can access the images downloaded to the portable disk space.
  • Red Hat® OpenShift® cluster setup as an air gap cluster for disconnected installation.

    Ensure you use the Maximo Application Suite sizing calculator to estimate your Red Hat OpenShift Worker Node configuration, storage, and memory requirements.

    For more information, see Requirements and capacity planning.
  • IBM entitlement key.
  • IBM Maximo Application Suite license file.

Red Hat OpenShift cluster

A Red Hat OpenShift cluster must be configured in disconnected environment or restricted network for IBM Maximo Application Suite installation.

To install the Red Hat OpenShift in your environment, see Red Hat OpenShift Container Platform installation overview and Installing a Red Hat OpenShift cluster on any platform.

To install the Red Hat OpenShift in a disconnected or restricted network, see Mirroring images for a disconnected installation.

To convert a connected Red Hat OpenShift cluster to a disconnected cluster, see Converting a connected cluster to a disconnected cluster.

IBM entitlement key

Access the Container Software Library by using your IBM id to obtain your entitlement key.

IBM Maximo Application Suite license file

Access the IBM License Key Center to get the license key of IBM Maximo Application Suite. From Get Keys > IBM App Point Suites, select IBM MAXIMO APPLICATION SUITE AppPOINT LIC and enter the following information on the next page:

Field Content
Number of Keys Use this field to decide the number of App Points that are assigned in the license file.
Host ID Type Enter Ethernet Address.
Host ID Enter a host ID.

The host ID can be any 12-digit hexadecimal string.
Hostname Enter a hostname.

The hostname is used to associate the license file to the Red Hat OpenShift Container Platform cluster instance.
Port Enter the port number 27000.
Tip: You can retain the default values for other fields.

Generate and download the license file to your home directory in a file that is named entitlement.lic.

For more information about accessing the IBM License Key Center, see Getting started guide.

Operator catalog

Select the catalog source for your installation. For more information, see Catalog selection or contact IBM Support for guidance.

Fusion Data Foundation

The Maximo Application Suite license includes IBM Storage Fusion Advanced. The Maximo Application Suite catalog has the Fusion operator which allows you to install Fusion Data Foundation.

  1. Check installed catalogs.
    oc get catalogsources.operators.coreos.com -n openshift-marketplace
  2. Install the Maximo catalog.
    export ROLE_NAME=ibm_catalogs
ansible-playbook ibm.mas_devops.run_role
  3. Validate the updated catalogs.
    oc get catalogsources.operators.coreos.com -n openshift-marketplace
  4. Update the pull-secret.
    export IBM_ENTITLEMENT_KEY=<your entitlement key>
export CNV_ENT_KEY=$(echo -n "cp:${IBM_ENTITLEMENT_KEY}" | openssl base64 -A)
oc extract secret/pull-secret -n openshift-config --confirm        
sed -i 's/{"auths":{/&"cp.icr.io":{"auth": "'''${CNV_ENT_KEY}'''","email": "not-used"},/' .dockerconfigjson
  5. Install IBM Storage Fusion. For more information, see Data Foundation.