View Source

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`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_2.png

Show all nodes name and Id on the NMIS:

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

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_3.png

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`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_5.png

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

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

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_6.png

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`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > image2023-2-10_9-43-2.png

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

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > image2023-2-10_9-52-51.png

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://community.opmantek.com/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`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > image2022-10-6_9-49-31.png

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`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_10.png

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:

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_13.png

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`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_14.png

On this example you can see the new node Roku_stick:

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

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_15.png

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"`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_16.png

You can see the template node:

`cat template.json`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_17.png

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`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_21.png

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`

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_22.png

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

NMIS > NMIS9 - Bulk Export and Import nodes from CLI and others Admin Options > node_admin_23.png