Page History

...

From version 8.5.12G onwards NMIS ships with a model upgrade tool and the installer offers to run it for you. If you are using NMIS 8.5.10G you can download the upgrade tool here; it is recommended that you save it as /usr/local/nmis8/admin/model_upgrade.pl.

...

If desired you can also exclude certain model or graph files from the upgrade, using the -n option (which expects a regular expression argument, like "-n Model-custom").

It is safe to run the upgrade tool multiple times.

Limitations

• 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.

...