Versions Compared

Key

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

Table of Contents

Status
colourYellow
titleDRAFT

Summary

In this guide we will migrate the data from NMIS8 and OMK Applications to nmis9 and OMK Applications. 

  • Server: uburnto (ubuntu 18) →  deb-n-burn (debian 10) 
  • nmis 8.7.2 → nmis 9.2.2
  • opCharts 2.5.1 → opCharts 3
  • opConfig 3.5.2 → opConfig 4
  • opEvents 2.6.3 → opEvents 3
  • opHA 2.2.2  → opHA 3 
  • opReports 3.4.2 → opReports 4 

Status
colourYellow
titleTBR
 Please Please note that, to make use of some utility versions for the migration, at least these versions are needed:

...

We can move all the files except the Table-tablename.nmis. 

Configure

We need to make some adjustments to the Config file. 

...

Code Block
/usr/local/nmis9/bin/nmis-cli act=fixperms

Import NMIS 8 configuration Items

More information here

Review important configuration Items

More information here

Configuration Files: Option 2

...

Step 3. OMK Applications considerations

opCharts (tick)(tick)

opCharts uses the same database. 

...

Code Block
/usr/local/omk/bin/opevents-cli.pl act=setup-db debug=1

opConfig (tick)(tick)

Update database name in opCommon.json:

...

Code Block
/usr/local/nmis9/bin/nmis-cli act=fixperms

Model Files

We can move all the model customisations in the models-custom directory. We can use rsync for this again. 

NOTE Some models may need to be adjusted. Specially if they are using nmis internal functions.

Plugins

We have moved the conf/plugins directory using rsync. But the custom plugins need to be adapted to NMIS9.

Here you can find further information.

Step 6. Copy RRDs

Link to Step 3 Copy RRDs above 

Step 7: Verify

Link to Step 5 Verify above

Upgrade process Upgrade process (II): Installing apps (OMK)

...

  • The destination server is a brand new server with nmis9 installed
  • nmis9 has been running for a couple of cycles to create the inventory. Then, it should be stopped. 
  • We would need the last installers from all the products in the /tmp directory. 

Step 1. sync omk folder

We can use rsync for this:

  • the products in the /tmp directory. 

Step 1. Installers running

Run the installers for each application. All the data should be automatically migrated. 

Step 2. Customise configuration

Same steps as the other procedure. 

Step 3. opConfig data

Run the migration script:

Code Block
/usr/local/omk/bin/opconfig-cli.pl act=migrate-nodes debug=9

Step 4. opReports data

Same steps as the other procedure.

Step 5. opCharts data

Run the migration script:

Code Block
Code Block
rsync -r root@myserver.com:/usr/local/omk/bin/opcharts-cli.exe act=migrate-monitored-services dir=/usr/local/nmis8/var/service_status debug=1

Notes

  • It is important to update nmis 9 first and leave running for a couple of poll cycles so inventory is created. nmis9 will create its own inventory, as this is now saved in the db and has a specific format. These data will be used for other scripts from the apps to migrate some data. 
  • opconfig and opevents share the same database in the old version. This is because the products database name should be changed to "nmis", the old database name. 
  • nmis8 didn't use mongo. This is because opConfig has its own nodes database. We don't want to replicate information, so now opConfig will use nmisng database to get the nodes information. We would need to use the opConfig migration script to porte port some specific configurations from the internal database to nmis.