IBM Support

Setting up push notifications from Maximo Asset Management to IBM Maximo Inspector and IBM Maximo Technician apps

How To


Summary

Push notifications allow you to send notifications from Maximo Asset Management to the IBM Maximo Inspector and IBM Maximo Technician apps. Maximo Asset Management uses Firebase Cloud Messaging (FCM) to send the notifications to the apps.

Steps

To set up push notifications from Maximo Asset Management to the IBM Maximo Inspector and IBM Maximo Technician apps, you must complete the following steps:
  1. If you are on Maximo Asset Management V7.6.1.1 or earlier, obtain and install the Maximo Asset Management fixes required for push notification support.
  2. Register Maximo Anywhere applications with Firebase Cloud Messaging (FCM).
  3. Enable the Google Cloud Messaging API for your project.
  4. Configure push notification support in Maximo Asset Management.
  5. Configure the Maximo JMS Notification Queue to add push notification capabilities to your application server.
  6. Configure Maximo Anywhere for push notification support.
  7. Build the Maximo Anywhere application native container to enable push notification support.
These steps are described in the remainder of this technote.
Obtaining and installing Maximo Asset Management fixes for push notification support (Maximo Asset Management V7.6.1.1 or earlier)
To enable push notifications support in Maximo Asset Management, you must install limited availability (la) and interim (i) fixes for both TPAE and MIF. The fixes that you need to install depend on the version of Maximo Asset Management that is installed.
 
For Maximo Version TPAE fix required MIF fix required        
7.6.0.9 La fix for push notifications LA fix for MIF
7.6.0.10
La fix for push notifications
Ifix for MIF
7.6.1
La fix for push notifications
Ifix for MIF files that were moved to Maximo Core
Ifix for MIF
7.6.1.1
La fix for push notifications
Ifix for MIF files that were moved to Maximo Core
Ifix for MIF
7.6.1.2 No fix required No fix required
To obtain the required fixes, contact IBM support.
To install and apply the push notification fixes to your Maximo Asset Management environment, complete the following steps:
  1.  Unzip the LA fix and ifix files on your Maximo administrative console.
  2.  From the command line, change to the %MAXIMO%/tools/maximo/internal directory.
  3. Run the following scripts:
    runscriptfile -cpushnotification -fV76_pushnotification_1
    runscriptfile -cpushnotification -fV76_pushnotification_2
    runscriptfile -cpushnotification -fV76_pushnotification_3
  4. Change to the %MAXIMO%/tools/maximo directory
  5. Run the following command: updatedb
  6. Start the TivoliĀ®'s process automation engine configuration tool:
    Windows: Use Start > Programs > Tivoli's process automation suite > Configuration Program
    UNIX: In the <install location>/ConfigTool directory run ConfigUI, for example, /opt/IBM/SMP/ConfigTool/ConfigUI
  7. On the home screen of IBM Tivoli's process automation suite configuration tool, select Update the database with the UpdateDB Lite feature.
  8. Run the pre-processing tasks, and click Finish.
  9. When the pre-processing tasks are complete, click Yes to continue the configuration.
  10. Run the post-processing tasks, and click Finish.
  11. When prompted, click OK to stop the application and complete the post-processing tasks.
After you install the interim and limited availability fixes, you must update the url pattern for the OSLCServlet servlet in the install_home\applications\maximo\maximouiweb\webmodule\WEB-INF\web.xml file.
  1. Open the install_home\applications\maximo\maximouiweb\webmodule\WEB-INF\web.xml/web.xml file in an editor.
  2. Locate the OSLCServlet servlet in the file.
    servlet-mapping>
    <servlet-name>OSLCServlet</servlet-name>
    <url-pattern>/oslc/*</url-pattern>
    </servlet-mapping>
  3. In the url-pattern line, replace /oslc/* with  /api/*.
  4. Save the install_home\applications\maximo\maximouiweb\webmodule\WEB-INF\web.xml.file.
Register Maximo Anywhere applications with FCM
You must create a Firebase project and register the IBM Maximo Inspector and IBM Maximo Technician apps. After you register an app, download the Firebase private key and record the project ID for the Firebase project. The private key and project ID are required in the next section: Configuring push notification support in Maximo Asset Management.
  1. Open the Google Firebase console: https://console.firebase.google.com.
  2. Create a new Firebase Cloud Messaging (FCM) project for your apps
  3. Add Firebase to each app in the Firebase console. To add Firebase to an app, you must specify a Bundle ID for an iOS app or a Package ID for an Android app. Use the bundleId value that is configured in in the maximoanywhere_home\Anywhere\MaximoAnywhere\apps\app_name\application-descriptor.xml file for both the Bundle ID and Package ID fields in the Firebase console. For example: <iphone applicationId= only "Inspection" bundleId="com.ibm.maximo.anywhere.inspection" version="7.6.4">.

    If the bundleId value is empty in the application-descriptor.xml file, you must edit the file and specify a bundleId value in the file and use that same value for the Bundle ID field when you add an iOS app or the Package ID field when you add an Android app.

    Note. If  you are adding an Android app to an FCM project and there are no iOS apps in the project, in the Package ID field,  you can specify the packageName value that is configured in the maximoanywhere_home\Anywhere\MaximoAnywhere\apps\app_name\application-descriptor.xml file if the file does not contain a bundleid value.
  4. After you register an Android app, click the Download google-services.json icon. After you register an IOS app, click Download GoogleService-Info.plist icon. The downloaded configuration files are required later when you enable and configure push notifications on Maximo Anywhere.
  5. Open the Firebase project settings and  generate a new private key.
  6. When prompted, save the JSON file that is generated. You need to use the JSON file content to configure Maximo Asset Management to connect to the Firebase project later.
  7. Open the project settings for your Firebase project.
  8. Locate the Project ID for your Firebase project and copy the field value to a text file. You need to specify the Project ID value when you configure push notifications support for Maximo Asset Management.
Enable the Google Cloud Messaging API for your FCM project
You must enable the Google Cloud  messaging API for the FCM project that you created when you registered your Maximo Anywhere applications with FCM in the previous section. To enable the Google Cloud Messaging API, open https://console.developers.google.com. Select your FCM project and enable APIs and services.
Configuring push notification support in Maximo Asset Management
For Maximo Asset Management V7.6.1.2 and later, follow the configuration steps on IBM Knowledge Center.
For Maximo Asset Management V7.6.1.1 and earlier:
To configure push notification support in Maximo Asset Management, you use the Maximo Push Notification Administration application to:
  • Add a row for each platform on which apps will receive push notifications
  • Specify the details of your Firebase project
Add a row for each platform on which apps will receive push notifications
The endpoint configuration details for the FCM push notification provider are preconfigured in the Maximo Push Notification Administration application. You must add a row in the Maximo Push Notification Administration application for each platform (Android or iOS) that you want to use the FCM provider with.
  1. Open the Maximo Asset Management Push Notification Administration application.
  2. Under Push Notification Providers, click New Row.
  3. In the Device Type field, click the search icon and select Android or IOS depending on which platform your apps are running on.
  4. In the Provider Name field, click the search icon and select Firebase Cloud Messaging (FCM). FCM is the only provider that Maximo Asset Management supports for push notifications.
  5. Click the Active check box.
  6. Repeat steps 2 to 4 to add a row for the second platform if your apps are running on both IOS and Android.
Specify the details of  your Firebase project
After  you add a row for a platform in the Push Notification Administration application, you must specify the details of the Firebase project that you configured for that platform.
  1. In the Push Notification Administration application, select a row that represents the FCM push notification provider and platform combination that you added in the previous procedure.
  2. Under FCM Push Notification Projects, click New Row.
  3. In the Project identifier field, type the project ID of your Firebase project, which you obtained in step 6 of the section: Obtaining the Firebase service account private key and the Firebase project ID
  4. In the Service Account JSON, paste the contents of your project's private key JSON file, which you downloaded in step 3 of of the section: Obtaining the Firebase service account private key and the Firebase project ID.
  5. Click the save icon to save the configuration.
Configure Maximo JMS notification queue for your application server
For information on how to configure the Maximo JMS notification queue, complete the steps in Configuring push notifications for mobile apps in IBM Knowledge Center.
Configure Maximo Anywhere for push notification support
During the installation of Maximo Anywhere, you can enable push notifications for the IBM Maximo Inspector and IBM Maximo Technician apps. If you enable push notifications when you install Maximo Anywhere, you must specify the path to the JSON files that you downloaded when you added Firebase to the apps.  If you did not enable push notifications when you installed Maximo Anywhere, complete steps 6 and 7 of Configuring push notifications for mobile apps in IBM Knowledge Center.
Build the Anywhere Application Native Container with Push Notification support.
For information on how to build the build the application native container, see Building the Maximo Anywhere application
container in IBM Knowledge Center.

 

Document Location

Worldwide

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSLKT6","label":"IBM Maximo Asset Management"},"Component":"","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"All Versions","Edition":"","Line of Business":{"code":"LOB02","label":"AI Applications"}}]

Document Information

Modified date:
06 August 2020

UID

ibm11283332