Versions Compared

Key

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

Table of Contents

Summary

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

Requirements to upgrade

...

Upgrading NMIS 9 compatible applications

Upgrade requirements

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

...

ApplicationVersion
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


Check our products release notes

Check compatibility with other OMK apps

...

Verify a successful upgrade

  • Load the applications and verify the basic operations firsts as login, load process and data displayed. 
  • Review the specific application log for errors (opEvents.log, opCharts.log, etc)
  • The installer saves a log of all actions taken, files copied etc. in the installation directory as install.log, ie. normally it'll be in /usr/local/omk/install.log. Subsequent upgrades or installations of other Opmantek products will add to that logfile, so you may very well want to remove or clear the install.log file before upgrading or adding extra software.

    Unless this is the very first installation of an Opmantek product on this system, the installer will offer taking a backup of all affected files before the installation commences. This backup will be saved in the root user's home directory as omk-backup-YYYY-MM-DD.tgz. The backup includes:

    • all the directories that the installer will later copy files to,
    • the conf directory,
    • the old software manifest,
    • and the old install.log.

Restoring from backup


How to restore from a failed upgrade

...

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
/usr/local/omk/bin/checkomkdaemons.sh 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

 
service opeventsd start
service opconfigd start
service opchartsd start
service omkd start
 
# confirm that the Opmantek services are all running
/usr/local/omk/bin/checkomkdaemons.sh status

Ref: Restore Backup after Install

Info

IMPORTANT STEP:

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

 service opeventsd start
service opconfigd start
service opchartsd start
service omkd start
 

Ref: Restore Backup after Install

A couple things to remember -

...