nodes.pod

Network Management Information System

=head1 NAME

Nodes

=head1 DESCRIPTION

You can add, edit and delete entries to the NMIS Nodes table. 

Kyed by node name, names must be unique ! IP addressing allowed.
As of V3.2.x, UC letters in nodename allowed.

=head2 node

A device name or ip address.

=head2 active

set 'true|false'. If false, no information about this node will be collected or displayed. Used to deactiavte a node for a period of time.

=head2 collect

set 'true|false'. If false, do not collect any stats using SNMP. Ping only stats such as reachability are supported. Used for dumb hosts.

=head2 community

A SNMP RO community string

=head2 depend

Mutiple selectable list of nodes.
If a current 'Node Down' event is to be escalated, the list of 'depend' nodes is checked. If any of these are also reported as down,
then the event will not be escalated to the next LevelX and the subsequent notification procedure will not be run.
Default setting is 'N/A' 

=head2 devicetype

One of 'router', 'switch', 'server', or 'generic'. 
Should match the nodeType as set in the system file by the nodeType derived from the model selection table model.csv. 

=head2 group

A logical name defining a group of devices. List is pre-populated from the 'grouplist' setting in nmis.conf.
It is logical that the group name be something like the building name or city/suburb of the device.

=head2 net

Sset to 'lan|wan'. Used in reports.

=head2 role

One of  'core', 'distribution' and 'access'. 
Roles play an important part in NMIS, they allow things to be weighted for events and various other functions. 
The concept of weighting according to role is simple, if it is a core device then it is important and should be treated as such, 
if it an access device then it is less important.

=head2 runupdate

If set to 'true' at edit time via the web UI, then a 'nmis.pl type=update node=xxxx debug=true' command will be started to create this node directories and interface files. 
Debug results will be reported back to the web UI - scroll down to to the end of the node table view. 
The node 'ping' will be skipped, as the update command cannot be run with root priviliges from the web UI.

=head2 snmpport

SNMP port - 161 by default. Could set other values here if required.