Skip to content

General

Backup

Please make sure you have a current backup of your Maximo Database as changes will be made to it.

Check with updatedb

Before changing the installation please run updatedb.bat to check the health of installation. Updatedb.bat must not finish with error or exception.

  • Stop the MXServer in your application server

  • Enter to directory:

    > C:\IBM\SMP\maximo\tools\maximo\

Execute: updatedb.bat

Extract files

Extract insight-maximo-connector.zip to C:\IBM\SMP\maximo

REST Session Timeout

Increase the Session-Timeout of the Maximo REST-API from 3 minutes (default) to at least 30 minutes. Web and mobile clients will need to relogin after being inactive for that amount of time.

Edit SMP/maximo/applications/maximo/maxrestweb/webmodule/WEB-INF/web.xml:

Find the following line:

    <session-config>
      <session-timeout>3</session-timeout>
    </session-config>

New setting, in minutes:

    <session-config>
      <session-timeout>30</session-timeout>
    </session-config>

Optional: In Maximo, session cookies have no expire date. This causes new logins after each app restart. On iOS and Android, the app is closed when it is too long in the background. This can be fixed when all cookies have got a expiery date. The JSESSIONID can be configured in the Websphere admin console:

Go to Servers -> Server Types -> WebSphere Application Servers -> MXServer -> Container Settings -> Session management-> Enable Cookies, check the box and click on the link.

On the opened site the cookie lifetime can be configured in seconds. Use a high value to be logged in as long as the maximo session is valid. The server checks the session anyway.

insight/web and Maximo UI Login

Since Maximo 7.6.1.x property mxe.webclient.allowUrlLogin is set to 0 by default.

If your Maximo system is configured without LDAP-Authentication: - set mxe.webclient.allowUrlLogin to 1 in your Maximo System Properties - disable skipping Maximo Ui-Login - set skipMaximoUiLogin=false in config.js

See also https://www.ibm.com/support/pages/how-allow-user-login-maximo-url

There is nothing to do for Maximo 7.6.0.x

Update Maximo system properties and database objects

Please run updatedb.bat for integrating insight into maximo

  • Stop the MXServer in your application server

  • Enter to directory:

    > C:\IBM\SMP\maximo\tools\maximo\

Execute: updatedb.bat

Build & Deploy

Work in Progress

Execute the all steps to build and deploy Maximo into your application server. Start the application afterwards and make sure it is running as expected.

Systemproperties

Only on Maximo 7.5 set the following property in the system-properties of maximo:

  • webclient.useabsoluteimagepath: true

Registering Insight OSLC Route

Maximo Versions: 7.6.1, 8.10.0

This should be done after deploying the Insight Connector into Maximo.

  • Login to Maximo
  • open app Integrations/Object Structures
  • select Add/Modify API Route
  • move the existing insight route by:
  • creating a new one with the same class/settings
  • removing the old one
  • create a new route:
  • Name: insight
  • Method: GET
  • Description: Rodias Insight Handler
  • Route Implementation Class: gis.maximo.insight.oslc.provider.InsightOslcHandler
  • create another one but with Method: POST

Migration of URLs, insight.properties

  • /maxrest/rest/insight -> /maximo/oslc/insight
  • /maximo/rest/insight -> /maximo/oslc/insight