When new versions of Opqo are released, they require Opqo to make supporting Maximo configuration changes.


These configuration changes may be:


  • Mandatory - the new version of Opqo requires the configuration changes to operate, and you cannot use the new version until the configuration changes have been made.  Opqo will automatically trigger the upgrade process when you login.
  • Optional - the new version can be used, but some features/fixes may not be present.  To apply the configuration changes, the upgrade process must be manually triggered.


Typically the configuration changes are Mandatory.  In the case where the changes are Optional, the release notes will document this, and document the feature/fixes that are disabled without them.


The process of applying the configuration changes is identical to the initial installation process.  In both cases, they must be performed by a user with Maximo administrator permissions.



Releases with Mandatory configuration changes


The recommended upgrade process is as follows:

  1. Install the new version of Opqo on a device to be used by the Maximo administrator performing the upgrade
  2. Ensure Opqo is configured to connect to your upgraded Maximo environment, and ensure the device can connect to the Maximo server.
  3. Log in using a Maximo account that is in the system administrators group.
  4. After a successful login, Opqo will enter the installation process.  Follow the prompts and wait until the installation is complete.
  5. Once the upgrade is complete, the new version can be installed and used by all users.


Typically, older versions of Opqo are compatible with newer configurations.  This means that users can continue to user the previous version until they can upgrade to the new version.  This compatibility is noted in the release notes.



Releases with Optional configuration changes


In this case, the upgrade process must be manually triggered by a Maximo administrator.


To manually trigger the upgrade process:


Note that Opqo will not be able to be used after performing step 1, until step 2 is completed.


  1. In Maximo:
    1. Log in using a Maximo account that is in the system administrators group
    2. Go to the Automation Scripts application
    3. Search for and delete the STAUTOSCRIPT.STAMVERSION automation script.

  2. In Opqo:
    1. Ensure Opqo is configured to connect to your upgraded Maximo environment, and ensure the device can connect to the Maximo server.
    2. Log in using a Maximo account that is in the system administrators group.
    3. After a successful login, Opqo will enter the installation process.  Follow the prompts and wait until the installation is complete.



Note: When the Opqo installation/upgrade process is run using the above processes, any Opqo configurations that you have made will be retained, including members of Opqo security groups.



If you have any questions about this process, please do not hesitate to contact us or create a support ticket if you have questions or require our assistance.