This document will highlight some key aspects of the upgrade process of the current Opmantek Applications.

Upgrade requirements

In order to be able to upgrade please ensure the following product versions are installed on your system.

Upgrading NMIS 9 compatible applications

NMIS 99.1.0G or earlier version
opCharts 44.1.3 or earlier version
opConfig 4 4.1.1 or earlier version
opEvents 33.1.0 or earlier version
opHA 33.1.2 or earlier version
opReports 4 4.1.1 or earlier version

Upgrading NMIS 8 compatible applications

NMIS 88.7.1G or earlier version
opCharts 33.4.0 or earlier version
opConfig 3 3.4.0 or earlier version
opEvents 22.5.0 or earlier version
opHA 22.1.6 or earlier version
opReports 3 3.3.0 or earlier version
opFlow 33.0.16 or earlier version

Check compatibility with other OMK apps

Has a dependency changed

Test in a non production system

Have you got custom modifications or template changes

Have you got a test plan and steps to perform a rollback in your production environment


As always, we strongly recommend to keep a backup of the current installation. This is a recommended practice and it's an important step on any software installation or upgrade.

Verify a successful upgrade

Restoring from backup

How to restore from a failed upgrade

All opModule installers create a backup of /usr/local/omk prior to the installer running PROVIDED you answered the following question early in the installation procedure in the affirmative:

This is the process to use if you need to roll back from the installer using this backup:

# send email to with advance warning before restoring from backup
service opeventsd stop
service opconfigd stop
service opchartsd stop
service omkd stop
# confirm that the required Opmantek services have stopped (Applicable to NMIS 8 compatible apps only):
/usr/local/omk/bin/ status

# confirm that the required Opmantek services have stopped (NMIS 9 compatible apps):

service opeventsd status
service opconfigd status
service opchartsd status
service omkd status

tar-xvf omk-backup-YYYY-MM-DD.tgz -C ~/temp
cp-R ~/temp/*/usr/local/omk
# at this point this error may occur:
#   cp: cannot create regular file '/usr/local/omk/bin/opchartsd.exe': Text file busy
#   cp: cannot create regular file '/usr/local/omk/bin/opflowd.exe': Text file busy
# if this happens: do
#       mv /usr/local/omk/bin/opchartsd.exe /usr/local/omk/bin/opchartsd.exe.old
#       mv /usr/local/omk/bin/opflowd.exe /usr/local/omk/bin/opflowd.exe.old
# and then: do
# cp -R ~/temp/* /usr/local/omk

#FOR NNIS 8 compatible apps only:
service opeventsd start

service opconfigd start
service opchartsd start
service omkd start
IMPORTANT STEP FOR NMIS 9 compatible applications:

You also need to run the installer for each previously application that was installed (reinstall)  in order to downgrade properly and have the initd and systemd services restored too.

Ref: Restore Backup after Install

A couple things to remember -

  1. Each run of an opModule installer creates a new backup file. However, since they all use the same name only the most recent will be maintained. If you are installing several packages you should rename each backup before running the next.
  2. This process overlays the backup into the /usr/local/omk directory and DOES NOT replace it.


There is no need to request a license update, as the licenses are continuing to be valid with this upgrade.