Page History

...

It is safe to run the upgrade tool multiple times.

Limitations

• As of version 8.6.0G, the installer instructs the upgrade tool to not handle Common-database.nmis, because of the possibility that an rrd location migration might be required.
  This would be the case if your current NMIS version is below 8.5.6G. In this situation, the adding of missing entries is left to the rrd migration tool (which is described further in the upgrade notes).
• The upgrade tool compares the model file states against an embedded list of older releases and cannot upgrade models that are older than these known releases.
  For version 8.5.10G the upgrade tool was primed with states for releases 8.4.X and 8.5.X.
• The upgrade tool will identify a file as 'locally modified' if you make any changes to it, and will not overwrite it under any circumstances.
  Changing a text field like '42' to the number 42 is considered a change. Adding white space outside of a string is not detected as change.
  Changing comments is not a change, nor is reordering items in a hash structure.
  All "locally modified" files will be left as-is by the upgrade tool.
• The upgrade tool requires a complete and uptodate directory of "new" models.
  If you modify files in models-install the tool will refuse to work with these because of the state that is inconsistent with its embedded knowledge.
• The upgrade tool is version specific and cannot  upgrade your models to any version but the one it was primed for and shipped with.
  I.e. the current tool targetting version 8.5.10G will be of no use to you if you want to upgrade to an older version of NMIS.

...

• Common-X.nmis
  Common-database commonly has local adjustments if you want different RRD data retaining periods, or if you use a non-standard RRD directory schema, or if you have custom models with extra RRD databases.
  Common-thresholds is another likely candidate for local changes. Most of the other Common-X files rarely require local adjustments, unless you are customizing your models.
• Model.nmis
  This file controls the model autodetection. If you haven't created custom models and added them to the model autodetection, then this file will not contain local changes.
• Model-Y.nmis
  These files constitute the modelling configuration for all device types that NMIS knows about. Local changes  would be present if you extended or adjusted existing models in-place.
• Graph-Z.nmis
  These files contain the graph definitions for NMIS's graphs. Local modifications are possible but not especially likely.

...