NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options

Owned by Gladston Ribeiro (Deactivated)
Last updated: Feb 10, 2023
2 min read


This article's purpose of helping export/import bulk nodes and know how to show, create, delete, rename, dump, restore, make templates, and clean node events in a simple way to learn the CLI commands. 

What this command can do:

sudo /usr/local/nmis9/admin/node_admin.pl -h

Show all nodes name on the NMIS:

sudo /usr/local/nmis9/admin/node_admin.pl act=list

Show all nodes name and Id on the NMIS:

 sudo /usr/local/nmis9/admin/node_admin.pl act=list_uuid

Show the node headers on the NMIS: You can use this information to put on import node csv header.

  sudo /usr/local/nmis9/admin/node_admin.pl act=show node=Printer

Bulk Export all nodes on the NMIS to a file: add keep_ids=1 to export the uuid, cluster and poller.

  sudo /usr/local/nmis9/admin/node_admin.pl act=export file="/tmp/Nodes_export_keep_id.nmis" keep_ids=1

You can check cluster id, uuid, poller and node name:

 grep -E "display_name|id|poller"  Nodes_export_keep_id.nmis

You can check the only nodes name:

 grep -E "display_name"  Nodes_export_keep_id.nmis

Bulk import all nodes on the NMIS from a file: 

sudo /usr/local/nmis9/admin/node_admin.pl act=import_bulk nodes="/tmp/Nodes_export_keep_id.nmis" nmis9_format=1

OBSERVATION: If you are bulk import for a NMIS9, you will need to add the parameter nmis9_format=1. If you forgot it, it will through an error.

Bulk import all nodes from the CSV file:

This way will enable activation on NMIS:

The best way to import from NMIS8 to NMIS9 is to create a CSV file and then copy it to NMIS9 Administration GUI ==> Add node

From your NMIS8

/usr/local/nmis8/admin

sudo  ./export_nodes.pl nodes=/tmp/node_export_location2.csv

https://docs.community.firstwave.com/wiki/display/opCommon/Importing+Nodes+with+Admin+GUI

sudo ./import_nodes.pl csv=/usr/local/nmis9/admin/node.csv verbose=1 simulate=f

sudo ./import_nodes.pl csv=/usr/local/nmis9/admin/node.csv 



Copy a node info to a zip file: This only works for a single node.

 sudo /usr/local/nmis9/admin/node_admin.pl act=dump node="RokuStreamingStick" everything=1 file="/tmp/RokuStreamingStick-dump.zip"

See the node info from zip file:

 unzip RokuStreamingStick-dump.zip

Delete a node: This only works for a single node.

sudo /usr/local/nmis9/admin/node_admin.pl act=delete  node="RokuStreamingStick" confirm=YES deletedata=1

Restore a node that was delete: This only works for a single node.

 sudo /usr/local/nmis9/admin/node_admin.pl act=restore file=RokuStreamingStick-dump.zip localise_ids=1

This is an example of Delete a node and restore:

Rename a node: This only works for a single node.

 sudo /usr/local/nmis9/admin/node_admin.pl act=rename old=RokuStreamingStick new=Roku_stick

On this example you can see the new node Roku_stick: 

 sudo /usr/local/nmis9/admin/node_admin.pl act=list_uuid

Create a template node: This only works for a single node.

  sudo /usr/local/nmis9/admin/node_admin.pl act=mktemplate placeholder=1 file="/tmp/template.json"

You can see the template node:

  cat template.json

Make a copy of the template to create a new node:

 cp template.json my_new_paradise.json

Fill out the information replacing the template node (See example below): 

vim my_new_paradise.json

{
   "activated" :{
      "NMIS":1
   },
   "cluster_id" : "7c1084fe-5f66-4b3b-8a3b-6e58cc8aff4f",
   "configuration" : {
      "authkey" : "",
      "authpassword" : "",
      "authprotocol" : "md5",
      "collect" : 1,
      "community" : "nmisGig8",
      "group" : "NMIS9",
      "host" : "192.168.0.95",
      "location" : "Default Location",
      "model" : "automatic",
      "netType" : "default",
      "notes" : "",
      "ping" : 1,
      "port" : 161,
      "privkey" : "",
      "privpassword" : "",
      "privprotocol" : "des",
      "roleType" : "default",
      "threshold" :1,
      "username" : "",
      "version" : "snmpv2c"
   },
   "name" : "My_new_paradise",
   "uuid" : ""
}


Create a new node based on the modified template: remember that the node name is inside the file. In this example My_new_paradise

sudo /usr/local/nmis9/admin/node_admin.pl act=create  file="/tmp/my_new_paradise.json"

You can see the new node created:

 sudo /usr/local/nmis9/admin/node_admin.pl act=list_uuid

Clear the node events: This only works for a single node. You can clear by node name or by ID.

 sudo /usr/local/nmis9/admin/node_admin.pl act=clean-node-events node=My_new_paradise

sudo /usr/local/nmis9/admin/node_admin.pl act=clean-node-events uuid=95bc5b15-afbb-4ea0-a899-5e7026a56d4d