Maximo Application Suite Customer-managed

Updating Maximo Health and Predict - Utilities

Note:

Starting in Maximo Application Suite 8.11, Maximo Health and Predict - Utilities is no longer available as a separate industry solution. The information that is provided is applicable only to Maximo Application Suite 8.10 and earlier versions. For more information, see Upgrading IBM Maximo Application Suite. Before you upgrade to Maximo Application Suite 8.11, deactivate and delete Maximo Health and Predict - Utilities.

The Maximo Models for Electrical Distribution accelerator replaces Maximo Health and Predict - Utilities in Maximo Application Suite 8.11. For more information, see Accelerators and Installing IBM Maximo Models for Electrical Distribution.

When new versions of Maximo Health and Predict - Utilities become available as part of a Maximo Application Suite upgrade, you can update your deployed application.

The update process that you complete is determined by the update method that the industry solution uses.

Before you begin

Important:

IBM Maximo Application Suite supports Cloud Pak for Data 4.6 with Python 3.10.

Ensure that the following dependencies are also updated:

  • Maximo Health.
  • App Connect.
    • If you want to update Maximo Health and Predict - Utilities to a new version, you need to check the Maximo Health and Predict - Utilities supported App Connect version. From IBM Maximo Application Suite v8.8, App Connect 12.0.4 or later is supported. If the old version App Connect is not supported anymore, you must first upgrade App Connect to a later version by completing the following steps:
      1. Upgrade the App Connect operator. For more information, see Upgrading the IBM App Connect Operator.
      2. If you customized the App Connect instance, review the Upgrade considerations for IBM App Connect instances.
      3. Upgrade the App Connect instance. For more information, see Upgrading your instances.
      4. Upgrade your integration servers to a newer version. You also need to update the corresponding license for this version. For more information, see Licensing reference for IBM App Connect Operator.
      5. Ensure that before you set Use Common Service to false, there is no apikey or credentials in IBM App Connect dashboard. If the apikey or credentials already exist, delete them from IBM App Connect and add them back after enabling authentication. For more information, see Editing the settings for a deployed integration server and Configuration reference.
    • If you have a new App Connect dashboard URL, you must also configure the new URL. For more information, see Configuring IBM App Connect.
  • IBM Watson® Studio on Cloud Pak for Data.

About this task

If automatic updates are not configured for the channel subscription, you must complete a few steps to update the application.

Procedure

  1. To update Maximo Health and Predict - Utilities in a channel subscription, complete the following steps:
    1. On the Suite administration page, select Applications.
    2. Click Update available for .

      Information about the latest version is displayed. Multiple updates available is displayed instead of the Update available when both a version and channel update are available.

    3. Select a different supported version to deploy and apply your changes.

      The application update process might require software downloads and more configuration steps. The estimated update time is an estimate based on typical network speeds and processing performance.

      Important: During the deployment of the new versions, users might temporarily lose access to the applications while they are being updated.
  2. To manually update Maximo Health and Predict - Utilities, complete the following steps:
    1. On the Suite administration page, select Applications and for Health and Predict - Utilities, click Update available. Information about the latest version is displayed.
    2. From the Version drop-down menu, you can select a different supported version to deploy.
    3. Optional: To deploy a version that is not listed, such as a specific fix, from the Version drop-down menu, select Other version. In the Other version number field, specify the version number. The fix version information is provided by your IBM representative.
    4. Click Deploy version to start the deployment process. The application update process might require software downloads and more configuration steps. The estimated update time is an estimate based on typical network speeds and processing performance.
      Important: During the deployment of the new versions, users might temporarily lose access to the applications while they are being updated.

      You can also manually upgrade and edit the configuration from the Overview tab for the application. To upgrade, from the Actions menu, click Application versions.

  3. With Cloud Pak for Data 4.6, the IBM Runtime 22.1 on Python 3.9 works well. If you want to use IBM Runtime 22.2 on Python 3.10 for existing notebook, stop its kernel and then change the environment.
    1. To stop the kernel, click the overflow menu and then click Stop Kernel.
    2. To change the environment, click the overflow menu and then click Change Environment . Select IBM Runtime 22.2 on Python 3.10 (1 vCPU and 2 GB RAM) and then click Associate.
  4. Existing notebooks that are deployed or edited must be updated to use the latest versions of Python that is supported by Cloud Pak for Data. Refer to the following steps to edit the notebooks:
    1. Update the healthlib file name in cell 1 
      for f in ['IBM-Transformers-Tap-Changers-DGA-4.0.0.cfg', 'healthlibv4-1.0.0-cp38-cp38-linux_x86_64.whl']:
      
for f in ['IBM-Transformers-Tap-Changers-DGA-4.0.0.cfg', 'healthlibv7-1.0.0-cp310-cp310-linux_x86_64.whl']:s
    2. Update healthlib file name in cell 3 
      !pip install healthlibv4-1.0.0-cp38-cp38-linux_x86_64.whl

      
!pip install healthlibv7-1.0.0-cp310-cp310-linux_x86_64.whl
    3. Update healthib in cell 6 
      import healthlibv4 as healthlib
from healthlibv4 import context
from healthlibv4 import maximo_function

      import healthlibv7 as healthlib
from healthlibv7 import context
from healthlibv7 import maximo_function
    4. Update cell 9 
      healthlib.set_asset_query(select="assetid,assetnum,siteid,orgid,location,installdate,assetmeter{lastreading,metername},assetspec{alnvalue,numvalue,assetattrid}}", page_size=100)
      healthlib.set_asset_query(select="assetid,assetnum,siteid,orgid,location,installdate,status,assetmeter{lastreading,metername},assetspec{alnvalue,numvalue,assetattrid}}", page_size=100
    5. Update cell 10 
      healthlib.set_location_query(select="locationsid,location,siteid,orgid,installdate,locationmeter{lastreading,metername},locationspec{alnvalue,numvalue,assetattrid},rel.activeasset{assetid,assetnum,siteid,orgid,installdate,rel.assetspec{alnvalue,numvalue,assetattrid},rel.assetmeter{lastreading,metername}}", page_size=100)
      healthlib.set_location_query(select="locationsid,location,siteid,orgid,installdate,status,locationmeter{lastreading,metername},locationspec{alnvalue,numvalue,assetattrid},rel.activeasset{assetid,assetnum,siteid,orgid,installdate,rel.assetspec{alnvalue,numvalue,assetattrid},rel.assetmeter{lastreading,metername}}", page_size=100)
    6. To save the file, click File > Save. To save the version, click File > Save Version.
  5. On the Job tab, you can edit the job running environment
    1. Click Edit configuration
    2. Select IBM Runtime 22.2 on Python 3.10
    3. Click Next, then Review and Save to the edit to the job.