Versions Compared

Old Version 24

changes.mady.by.user Keith Sinclair

Saved on

compared with

New Version Current

changes.mady.by.user Keith Sinclair

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Once you have downloaded all the applications you need, if you have not already, please review the section below above "Considerations and Guidelines for Upgrading Opmantek Applications" and consider what you need to do.

ApplicationVersion
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 3

3.0.16 or earlier version

opFlowSP 11.0.10 or earlier version

...

If you are running the versions below or greater then the upgrade is very straight forward, download the product you need and upgrade the individual product, just like you would an installation, see "Starting the Upgrade/Installation".

ApplicationVersion
opCharts 33.5.0 or later version
opConfig 3 3.5.0 or later version
opEvents 22.6.0 or later version
opHA 22.2 or later version
opReports 3 3.4.0 or later version
opFlow 3

3.1 or later version

opFlowSP 12.0.0 or later version

Starting the Upgrade/Installation

...

You are currently running NMIS 9 and the related Opmantek applications and you want to upgrade from the versions below to the newer versions.

When you install the newer version of the first commercial application, e.g. opConfig, it will move aside all the existing commercial applications and you will also need to install those.  You can download the applications from the Opmantek.com website.

Once you have downloaded all the applications you need, if you have not already, please review the section above "Considerations and Guidelines for Upgrading".

B.1 Upgrading from Older NMIS 9 Compatible applications

9.1.0G or earlier version
ApplicationVersion
ApplicationVersion
NMIS 9
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

B.2 Upgrading from Current NMIS 9 Compatible applications

If you are running the versions below or greater then the upgrade is very straight forward, download the product you need and upgrade the individual product, just like you would an installation, see "Starting the Upgrade/Installation".

ApplicationVersion
opCharts 44.2 or later version
opConfig 4 4.2 or later version
opEvents 33.2 or later version
opHA 33.2 or later version
opReports 4 4.2 or later version

Starting the Upgrade/Installation

When you are ready proceed with the upgrade as you normally would an installation.

SECTION C: Upgrading from NMIS8 compatible applications to NMIS9 compatible applications

SECTION D: Migration documentation under development

...

For further details, please contact Support

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:

  • Do you want to perform a backup of your installation directory?
    • Default answer for automated install is 'Yes'.

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

# send email to optek@ompantek.com 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/checkomkdaemons.sh 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

cd ~
mkdir temp
tar -xvf omk-backup-YYYY-MM-DD.tgz -C ~/temp
unalias cp
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.

In case of failed upgrade

If something goes wrong during the upgrade process follow these steps to roll back to your previous state.

  1. Restore Backup after Install

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.

Licences

...