Versions Compared

Key

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

Table of Contents

From Since opCharts 4.1.0, opEvents 3.1.0, opHA 3.1.0, opReports 4.1.0 and  and opConfig 4.1.0 version, the .nmis configuration files will be replaced by .json files. 

...

Status
colourGreen
titleImportant
 When migrate to one of these products versions, an upgrade of upgrading all products will be required. 

New opcommon-cli tool

...

A new tool action is available with /usr/local/omk/bin/opcommon-cli.pl to convert .nmis files to .json files if needed. 

It has the following actions: 

  • convert_json_file: Will convert .nmis file into a json file. It has 3 options
    • file: The file to convert. 
    • backup: t/f: True by default. Will move the .nmis file to the archive_converted_files directory. 
    • replace_qr: t/f: True by default. Will replace the qr// by "" reading the file content as a string. Please note, if the file has non quoted qr, the conversion to json will fail, with a message: 

      Error converting json file: encountered object '(?^:Category:\((\d+)\); User:([\w\\ ]{0,256}); (.+)$)', but neither allow_blessed ...


    • replace_nmis: t/f: True by default. Will replace the ".nmis" by ".json" reading the file content as a string
    • force: t/f: False by default. Will override the .json file if is exist previously when true. 
    • replace_copy: t/f: False by default. Will replace qr// for "//" instead of "" in copy* elements. This is a convention to know when an element is a regular expression or not, in new opEvents version using json files for EventRules.json file. 
  • convert_dir_file: Will scan a directory and convert nmis files to json files, using backup, replace_qr and replace_nmis to true but for EventActions will do an exception. This file has quoted qr so it won't need to be converted. 

File Migration

...

The installer will run the common-cli tool to convert all the .nmis files in the /conf directory into .json. 

The files will be moved to the archive directory, by default conf/archive, but it can be modified in the configuration item archive_converted_files.

JSON Tools

...

We can use a validator to check our JSON files syntax, like JSLint