IBM® Maximo® Health and Predict - Utilities

Maximo® Health and Predict - Utilities supports maintenance, operations, and performance of assets and networks for energy and utility companies.

Overview

By using Maximo Health and Predict - Utilities, you can configure scoring and predictive models to support the delivery of safe, reliable, and sustainable energy.

Maximo Health and Predict - Utilities is available from the Suite navigator.

If Maximo Health is deployed as part of Maximo Manage, the Maximo Health and Predict - Utilities industry solution is available at the following URL: https://<workspace_id>.manage.<mas_domain>/maximo/oslc/graphite/relengineer/index.html

If Maximo Health is not deployed as part of Maximo Manage, the Maximo Health and Predict - Utilities industry solution is available at the following URL: https://<workspace_id>.health.<mas_domain>/maximo/oslc/graphite/relengineer/index.html

For more information, see the Maximo® Health and Predict - Utilities documentation.

Deploy Maximo Health and Predict - Utilities

By deploying and activating the Maximo Health and Predict - Utilities industry solution, you make it available for use in Maximo Application Suite.

The following steps are specific to the Maximo Health and Predict - Utilities industry solution. You must complete the pre-deployment and deployment steps before you activate the industry solution. By default, the industry solution is not available to any users until the industry solution is completely activated and users are granted access.

Predeployment steps

The following components must be configured before you deploy Maximo Health and Predict - Utilities:

• IBM Watson™ Studio on Cloud Pak for Data. For more information, see Installing Watson Studio. Ensure that you create at least one project and that the notebook asset type is added to the project.
• IBM Maximo Scheduler Optimization. Maximo Scheduler Optimization is required for asset investment optimization, which you enable as part of deploying the Maximo Health dependency. For more information, see IBM Maximo Scheduler Optimization. You do not need to configure the optimization.mofapi or optimization.mofui system properties after you deploy and activate IBM Maximo Scheduler Optimization.

If you plan to use the data loader, you also must configure IBM® App Connect Enterprise 12.0.2.0-r2, and your dashboard must use an AppConnectEnterpriseProduction license. When you install the dashboard, do not select the Use Common Service option. Do not use an instance of IBM® App Connect Enterprise that is on IBM® Cloud. You must install IBM® App Connect Enterprise in a Cloud Pak for Data cluster. Maximo Application Suite includes an entitlement to IBM® App Connect Enterprise 12.0.1.0. You must update to 12.0.2.0-r2. For more information, see Configuring IBM® App Connect.

Deploying Maximo Health and Predict - Utilities

These deployment steps are completed in Maximo Application Suite.

1. In the Suite catalog, on the Industry solutions tab, click the Health and Predict - Utilities tile.
2. On the Maximo Health and Predict - Utilities catalog page, verify the information.
3. Click Continue. If there are insufficient AppPoints available to deploy this application, you can still click Continue to complete the application configuration. The application automatically deploys when the required number of AppPoints are available.
4. Determine how you want to keep the industry solution up to date by choosing one of the following options:
   • Click Channel subscription to subscribe to the upgrade channel. When new versions become available, they are added to the channel and updated in your instance either automatically or after manual approval. If you want to manually approve upgrades, turn off the Automatic approval toggle.
   • Click Manual to manually select the upgrades that you want to deploy, then choose Deploy version 8.3.0. For more information, see Upgrade methods.
5. Optionally, in the Dependencies section, for IBM® App Connect, select Configure and then specify the IBM® App Connect dashboard URL and user.
6. Deploy Maximo Health. Before you begin this step, ensure that you have deployed and configured Maximo Scheduler Optimization. If Maximo Health is not deployed, the deployment wizard walks you through Maximo Health deployment. For more information, see Deploy Maximo Health. Ensure that you complete all steps to deploy and activate the application and that you enable asset investment optimization. If you do not deploy Maximo Health as a part of Maximo Manage, you do not need to complete the system integration or use the data loader until after Maximo Health and Predict - Utilities is deployed and activated. Maximo Health and Predict - Utilities uses the same database as Maximo Health.
7. Click Deploy and then Begin deployment. Clicking Deploy does not make the industry solution available. After you click Deploy, the deployment process starts in OpenShift. The estimated time and configuration time that are listed represent the estimated time that it takes to configure and deploy the industry solution. The times include both front-end configuration work and back-end processing and configuration. You can track the deployment process on the details page or, as an administrator, log in to the OpenShift web console and from the OpenShift cluster, in the navigation menu, click Workloads > Pods. Ensure that you are reviewing either all projects or only the Maximo Health and Predict - Utilities, which is named mas-instance name-hputilities. The Maximo Health and Predict - Utilities operator supports single namespace deployment.

As the industry solution is deployed, the following events occur in the following order in the OpenShift:

1. The ibm-mas-hputilities-operator-string pod is created, and the status is changed to Running.
2. A instance name-hputilities-entitymgr-ws-string pod is created. You can open the logs for these pods to monitor the deployment. The status is changed to Running.
3. Three instance name-hputilities-model-engine-string pods are created, and the status is changed to Running.

string is a randomly generated set of numbers and letters.

After the status of all pods is Running, the industry solution is ready to be activated. You activate Maximo Health and Predict - Utilities to configure a workspace and give users access to the industry solution.

Activating Maximo Health and Predict - Utilities

If the deployment is not complete, the Activate button is inactive. The industry solution might appear in the Suite navigator but might not be ready to use. Activating the industry solution does not automatically grant your users access to the industry solution.

Complete the following steps to activate the industry solution:

1. On the Maximo Health and Predict - Utilities page, click Activate.
2. On the Watson Studio page, configure your Watson Studio instance.
   1. Specify the root URL for Watson Studio, for example, https://{rootURL}/projects/{projectID}/assets?context=icp4data.
   2. Specify the Watson Studio username.
   3. Specify the Watson Studio password.
   4. Click Show advanced settings to configure the Watson Studio project ID. To retrieve the project ID, open your project and then copy the project ID from the page URL.
   5. Save your changes.
3. Click Activate
4. On the confirmation page, click Activate. The estimated deployment time that is listed represents the estimated time that it takes to activate the industry solution. You can track the activation process on the Maximo Health and Predict - Utilities details page or review the logs for the instance name-hputilities-entitymgr-ws-string pod.

After the industry solution is completely activated, the industry solution is available in the Suite navigator and at fixed URLs.

Post-activation steps

Complete the following steps:

1. If Cloud Pak for Data is using Security Assertion Markup Language (SAML), you must also configure an API key for Watson Studio. Complete the following steps to configure the API key:
   1. As an application administrator, in Maximo Health and Predict - Utilities, click Application administration.
   2. In the System Properties application, open the hputilities.watsonstudio.apikey and specify the Watson Studio project administrator's API key. Complete the following steps to retreive the API key:
      1. Log in to Watson Studio as an administrator.
      2. Click your user icon and then click Profile and settings.
      3. Click the API key.
      4. Copy the API key value.
   3. Save the property.
   4. Select the checkbox for the property and then click Live Refresh and complete the live refresh.
2. Create an Maximo Health and Predict - Utilities administrative user and specify that user's API key in the EXTENGINEAPI system property. Complete the following steps to create and configure the API key:
   1. In Maximo Health and Predict - Utilities, from the navigation menu, select Application administration and then in the Go To section, click Administration to open the Administration Work Center.
   2. In the Administration Work Center, on the API Keys tab, click Add API Key.
   3. In the User field, select the user ID for the administrative user, ensure that the value in the Token expiry in minutes field is -1, and then click Add.
   4. On the API key card, click Copy key.
   5. From the Start Center, open the End Points application.
   6. Open the EXTENGINEAPI endpoint and in the Properties for End Point table, for the PASSWORD property, in the Encrypted Value field, specify the administrative user's API key.

3. Verify that the components for Maximo Health and Predict - Utilities are configured.

   1. Verify that your Watson Studio project contains 20 data assets, 19 notebooks, and 18 jobs and that the job runtime is Default Python 3.8.
   2. In Maximo Health and Predict - Utilities, in the End Points application, for the EXTENGINEAPI endpoint, verify that the property value is the model engine URL.
   3. In Maximo Health and Predict - Utilities, in the System Properties application, verify that a value is specified for each of the following properties:
      • hputilities.health.endpoint
      • hputilities.watsonstudio.endpoint
      • hputilities.watsonstudio.username
      • hputilities.watsonstudio.password
      • hputilities.watsonstudio.projectid

   4. If you are going to use the data loader, for App Connect, verify that the data loader bar and configuration are uploaded.

      To verify that the data loader bar is uploaded, on the App Connect dashboard, click Bar Files and ensure that an ibm-mas-hputilities-830-string-data-loader bar exists.

      To verify that the data loader configuration is uploaded, on the App Connect dashboard, click Configurations and ensure that the following configurations are listed:

      • ibm-hputilities-string-healthurl
      • ibm-hputilities-string-keystore.p12
      • ibm-hputilities-string-https-serverconf-830
      • ibm-hputilities-string-https
      • ibm-hputilities-string-users
      • ibm-hputilities-string-store-password
      • ibm-hputilities-string-trustcert-830

Next steps

For next steps, review Getting started as an application administrator.

Update Maximo® Health and Predict - Utilities

The following steps are specific to the Maximo® Health and Predict - Utilities industry solution.You must complete the pre-update, update, and post-update steps before you start using the updated industry solution.

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

Pre-update steps

Ensure that the following dependencies are also updated:

• Maximo Health.
• IBM® App Connect Enterprise.
  • If you want to update Maximo Health and Predict - Utilities to version 8.3.0, you must first upgrade IBM® App Connect Enterprise to version 12.0.2.0-r2 by completing the following steps:
    1. Upgrade the IBM® App Connect Enterprise operator. For more information, see Upgrading the IBM App Connect Operator.
    2. If you customized the IBM® App Connect Enterprise instance, review the Upgrade considerations for IBM App Connect instances.
    3. Upgrade the IBM® App Connect Enterprise instance. For more information, see Upgrading your instances.
    4. Upgrade your integration servers to version 12.0.2.0-r2. The corresponding license for this version is L-KSBM-C87FU2. For more information, see Changing the version of a deployed integration server.
  • If you have a new IBM® App Connect Enterprise 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.

To determine the required Maximo Health version, review the following table:

To determine the required IBM® App Connect Enterprise version, review the following table:

The required version of Cloud Pak for Data is 4.0. After you update Cloud Pak for Data, you can update to the latest refresh of IBM Watson™ Studio. For more information about updating IBM Watson™ Studio, see Upgrading IBM Watson™ Studio to a newer refresh on Version 4.0.

Updating Maximo® Health and Predict - Utilities in a channel subscription

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

The following update steps are completed in Maximo Application Suite:

1. From the Suite catalog, from the Industry solutions tab, on the Health and Predict - Utilities tile, click Update available or Multiple updates available. The Multiple updates available button is displayed instead of the Update available button when both a version and channel update are available.

If you clicked Update available, proceed to step 3. If you clicked Multiple updates available, proceed to step 2.

1. On the Update notifications dialog box, for the version that you are updating to, click Review update.
2. Click Approve upgrade.

The 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 industry solution while they are being updated.

Manually updating Maximo® Health and Predict - Utilities

The following update steps are completed in Maximo Application Suite:

1. From the Suite catalog, from the Industry solutions tab, on the Health and Predict - Utilities tile, click Update available. Information about the latest version is displayed. From the Version field, you can select a different supported version to deploy. To deploy a version that is not listed, such as a specific fix, from the Version field, click Other version and then in the Other version number field, specify the version number. Fix version information is provided by your IBM representative.

2. Click Deploy version to start the deployment process. The 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 industry solution while they are being updated.

Post-update steps

The Maximo® Health and Predict - Utilities application requires no post-update steps.

Related topics

• Administering industry solutions