Install Maximo Application Suite from IBM Passport Advantage

The installation process includes downloading the installer from IBM® Passport Advantage, acquiring your entitlement key, installing the Maximo Application Suite components on OpenShift, accessing your license on IBM.com, and configuring the core software.

Notes:

The following process discusses the installation process for a manual upgrade method. The installation instructions for a channel subscription upgrade method are in the OperatorHub Maximo Application Suite catalog entry.
The following process discusses customer-managed Maximo Application Suite. For IBM managed Maximo Application Suite, no action is required and you can go directly to Getting started.

Before you begin

Before you can install Maximo Application Suite, you must:

Download the Maximo Application Suite software and your entitlement key.
Follow the procedure that is outlined in the Maximo Application Suite download document to access and download the software and your entitlement key.
Extract the contents of the compressed installer file to your workstation.
Set up and configure your OpenShift environment and the required supporting software.
For more information, see Application dependencies.

Important: Before you run the installer, you must make sure that java-jdk is installed on your workstation. Java is required to accept the license during installation. For more information, see Workstation requirements.

Note: Multiple instances of Maximo Application Suite can be installed on a single cluster if each cluster has sufficient capacity. Each instance must be given a unique instance name and domain.

Install Maximo Application Suite

To install Maximo Application Suite, complete the following tasks:

Log in to the OpenShift web console as an administrator.
Copy the login token.
1. Click your user account icon and select Copy Login Command.
2. Copy the login token.
In your local command line, paste in the login token and press enter to log in to the OpenShift cluster.
Example:
```
 oc login --token=kiaj2_jkoasunJljsLdsqdsa787asd --server=https://api.myopenshiftcluster.com:6443
```
Note: You can also use a valid token for a service account if you are using a service account for the installation.
Set the entitlement key for the IBM Entitled Registry.
Configure the system to use the entitlement key that you obtained from the IBM Container Library as described in the Maximo Application Suite download document.
From the command line, run the following command:
export ENTITLEMENT_KEY=<your_key>
Locate and run the install-mas.sh file.
The install-mas.sh file is part of the Maximo Application Suite V8.7 for Multiplatform package that you downloaded from Passport Advantage.
Note: By default, a self-signed certificate is used. To add your custom certificate, include the following parameter when running the installer: -c <CLUSTER_ISSUER>
To understand all available options for the install script, use the -h modifier to see the installer help. Example: ./install-mas.sh -h
You can use attended or silent installation to install Maximo Application Suite:
- Attended installation.
  To run the installer with no modifications.
  1. From the command line, run the following command:
    ./install-mas.sh
  2. Accept the license terms.
    The Maximo Application Suite license terms are displayed. To continue with the installation, you must accept the license terms.
  3. When prompted, enter the domain and instance information.
    For more information, see Instance requirements.
    - Silent installation.
      To run the installer silently, run the following command:
      ./install-mas.sh -i $<instance_name> -d $<mas_domain> --accept-license
      For more information about the <instance_name> and <mas_domain> values, see Instance requirements.
Monitor the installation.
Important: The installer downloads the Maximo Application Suite container images from IBM Entitled Registry. Depending on your network speed, this download might take 30 minutes or more to complete.
As the installer progresses, verify the successful installation of each component. During the installation step, the Maximo Application Suite super user credentials are created. The super user credentials are used for the initial Suite setup and are presented at the end of the installation.
Tip: You can monitor the Maximo Application Suite initialization from the OpenShift user interface under Workloads > Pods.
Filter by namespace to locate the Maximo Application Suite pods. Note that six pods remain uninitialized until you configure MongoDB as part of the initial setup.
Review the installation summary.
After the successful completion of the Maximo Application Suite installation, the following information is displayed:
- Suite administration URL
  Example: https://admin.<mas_domain>
- Super user credentials
  Username and password in the form of two randomly generated 32-character strings.
  Important: Make a note of these credentials. If you lose them, they can be recovered only by an OpenShift administrator. For more information, see Updating the super user password
- Setup sign-in URL
  Example: https://admin.<mas_domain>/initialsetup

Next steps

At the end of the installation, you are presented with the username and password for the superuser account in the installation summary. You use these credentials to complete the Suite setup of Maximo Application Suite.