IoT tool

The IoT tool provides device connectivity, data filtering and mapping, and device management tools and is required by Maximo Monitor.

Overview

The IoT tool is available from the Suite navigator or directly from the following URL:
https://<workspace_id>.iot.<mas_domain>/ibmssologin

The IoT tool APIs are available at the following URIs:

For more information, see the IoT tool section of the Maximo Monitor documentation.

Deploy IoT Tool

By deploying and activating the IoT tool, you make it available for use in Maximo Application Suite.

The following steps are specific to IoT tool. You must complete the pre-deployment and deployment steps before you activate IoT tool. The tool is not available to any users until it is activated and users are granted access.

Pre-deployment steps

The following components must be installed and configured before you deploy IoT tool:

Deploying Maximo Monitor

These deployment steps are completed in Maximo Application Suite.

  1. From the Suite catalog, from the Tools tab, select the IoT card.
  2. Click Continue.
  3. Select how you want to keep the tool 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 suite instance either automatically or after manual approval. If you want to manually approve upgrades, turn off the Automatic approval toggle.
    • Click Manual and choose the version that you want to manually install.

  4. Configure advanced configurations.
    On the Deploy application screen, if you want to provide non-default settings for storage class and deployment size, click Show advanced settings and turn off the System managed toggle for the setting that you want to configure manually.

    • Storage
      Select a storage class and size for the Persistent Volume Claims (PVCs) which is used to persist messaging data.
    • Deployment
      Specify the deployment size. Choose from Dev, Small, or Medium.

    For more information about available and tested storage classes, and for deployment size guidance, see the Monitor and IoT section of the Maximo Application Suite system requirements document.

  5. Click Deploy.
  6. Verify the deployment configuration and click Begin deployment.
    The listed estimated time and configuration time represent the estimated time that it takes to configure and deploy the application. The times include both front-end configuration work and back-end processing and configuration.

Post-deployment steps

The IoT tool requires no post-deployment steps.

Activating Maximo Monitor

A deployed tool is not immediately available. Before you can start working with IoT tool, you must activate the tool.

To activate IoT tool, from the IoT tool catalog page, click Activate. If the tool deployment is not complete, the Activate button is unavailable. It can take up to 15 minutes to activate IoT tool.

Activated tools are available from the Maximo Application Suite navigator and at fixed URLs for [IoT](manage_applications.html#iot_url.

Next steps

As an application administrator, you can now continue with the following tasks:

For other getting started steps in Maximo Application Suite, review the Getting started with Maximo Monitor.

Update IoT tool

By deploying and activating the IoT tool, you make it available for use in Maximo Application Suite.

The following steps are specific to the IoT tool and are part of the overarching application update process. You must complete the pre-update, update, and post-update steps before you start using the updated application.

Pre-update steps

The IoT tool requires no pre-update steps.

Updating Maximo Monitor

The following update steps are completed in Maximo Application Suite.

To update Maximo Monitor:

  1. From the Suite catalog, from the Tools tab, select the IoT tile.
  2. Click Update available.
  3. Information about the latest version is displayed.
    Click Select IoT to continue.
    You can also click Available versions and then select a different supported version to deploy.
    Note: To deploy a version that is not listed, such as a specific fix, click Deploy another version and then manually enter the version number in the search field.
    Fix version information is provided by your IBM representative. A complete list of application versions is also available in the product documentation.
  4. Click Deploy 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.

Post-update steps

The IoT tool requires no post-update steps.