Upgrading Maximo Application Suite

Upgrading Maximo Application Suite is a two-step process. First, download, and upgrade your Maximo Application Suite instance in your Red Hat® OpenShift® environment, and then you update your applications.

Note: If your IBM representative or IBM support directed you to update an application to a specific fix version, see Step 2: Update applications for more information.

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

Upgrading is a two-step process:

Before you begin

Before you can upgrade Maximo Application Suite, you must:

Step 1: Upgrade Maximo Application Suite

As new versions of Maximo Application Suite become available, you can download these versions from IBM Passport Advantage and then run the installer to upgrade your environment.

By completing the upgrade process that follows, the core Maximo Application Suite systems are upgraded and restarted as needed. These include management APIs, the user registry, the licensing server, the Suite administration page, and the Suite navigator.

To upgrade Maximo Application Suite:

  1. Log in to the OpenShift web console as an administrator.
  2. Copy the login token.
    1. Click your user account icon and select Copy Login Command.
    2. Copy the login token.
  3. 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. Maximo Application Suite.
  4. Locate and run the install.sh file.
    The install.sh file is part of the Maximo Application Suite V8.N for Multiplatform package that you downloaded from Passport Advantage.
    ./install.sh -i instance_name -d masdomain.com -c cluster_issuer
    Where:
    • instance_name is the OpenShift instance that you want to upgrade.
    • masdomain.com is the domain name for your environment.
    • cluster_issuer is the cluster issuer that was specified during the initial installation. If no cluster issuer was specified, remove the -c cluster_issuer part of the command.
  5. Accept the license terms.
    The Maximo Application Suite license terms are displayed. To continue with the upgrade, you must accept the license terms.
  6. Monitor the upgrade.
    Important: The installer downloads the Maximo Application Suite container images from IBM Entitled Registry. Depending on your network speed, this download might take up to 30 minutes.
    As the upgrader progresses, verify the successful upgrade of each component. If the Slack integration is configured, you receive progress updates to your Slack channel. The debug log file for each installation step is listed with the step result output:
    • Initialization
      Namespace entry example: mas-instance_name-core
      Debug log file example: logs/init-core.log
    • Installation
      Debug log file example: logs/install-mascore.log
      Domain example: masdomain.com
      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.
  7. Review the upgrade summary.
    After the successful completion of the Maximo Application Suite upgrade, the following information is displayed:
    • Administration dashboard URL
      Example: https://admin.masdomain.com

Important: The complete upgrade process might take around 15 minutes, if most of the pods are replaced. The pods replacement continues even after the upgrade summary displays. Ensure that the upgrade is complete before you continue. You can monitor the Pods in Workloads > Pods, or by using the following command from the OpenShift command line:
oc get pods -n mas-instance_name-core

When the upgrade is completed, you can log in to the administration page and continue with the upgrade process by installing and configuring new dependencies.

Step 2: Install and configure new dependencies

With release 8.3, Maximo Application Suite introduces Behavior Analytics Services to collect and process license and usage information.

Important: Maximo Application Suite records information that is necessary to provide you with access to the suite and to ensure that AppPoints are correctly managed based on individual user entitlements. Maximo Application Suite also records usage against different components to monitor compliance of Maximo Application Suite license terms. Register the required contact information for IBM to use to communicate about compliance and usage of this Maximo Application Suite installation. For more information, see the IBM Privacy Statement.

  1. Install the Behavior Analytics Services Operator.
    For more information about how to install the Behavior Analytics Services Operator, see the Behavior Analytics Services quick start guide for Maximo Application Suite.
    After the installation is complete, you must configure Maximo Application Suite analytics.

  2. Log in to the Suite administration page as a user with system administrator privileges.
    Example: https://admin.masdomain.com

  3. On the Suite administration page, select Configuration > Behavior Analytics Services from the menu.

  4. Click Edit.

  5. Enter the following details:

    • Hostname
      The hostname of the server where you installed the Behavior Analytics Services Operator.
    • Port
      The assigned Behavior Analytics Services Operator port.
    • API key
      The API key that is assigned to Maximo Application Suite.
    • Email
      A contact email address to use for Behavior Analytics Services communication. The email address does not have to match an existing Maximo Application Suite user.
    • Given name
      The given name of the owner of the provided contact email address that is used for Behavior Analytics Services communication.
    • Surname
      The surname of the owner of the provided contact email address that is used for Behavior Analytics Services communication.
  6. Click Save.

Step 3: Update applications

When the Maximo Application Suite upgrade is complete, updated applications are made available but are not automatically deployed.

To update your applications, follow the application update process. You must complete the pre-update, update, and post-update steps before you start using the updated application.