Scenario

You have just upgraded to NMIS 8.5.6G and the installer has listed lots of differencese between the (live) models/ directory and the new data in models-install/. Naturally you would like your NMIS to perfom perfectly and benefit from the continual improvements that we make to NMIS, and this includes getting the newest models into place.

This document answers the question of how model upgrades should be handled.

NMIS ships with new models in models-install, and (with the exception of RRD structure migration special case in 8.5.6G), the installer never makes any changes to your live models/ directory. This is because you may have created complex custom models for your installation or adjusted the standard models, both of which the installer simply mustn't overwrite or damage.

Types of files in models and models-install

The models directory contains four types of files, which differ in the degree of commonality and likelihood of local changes:

• Common-X.nmis
  Common-database commonly has local adjustments if you want different RRD data retaining periods, or use a non-standard RRD directory schema.
  Common-thresholds is another likely candidate for local changes. Most of the other Common-X files rarely require local adjustments.
• Model.nmis
  This file controls the model autodetection. If you haven't created custom models then this file will not contain local changes.
• Model-Y.nmis
  These files constitute the modelling configuration for all devices NMIS knows about.

graph-Z

Tools

admin/compare_models

admin/diffconfigs