NMIS Help
Last updated 21 June 2001

Online Version

NMIS Home Page

General: Tables:

 

Extras:

 

Menu

From the menu you can access the features and functionality of NMIS, there are buttons and pulldowns which allow various ways to access NMIS items.  Many things in NMIS are clickable allowing you to drill in and around looking for information and answers.

One of NMIS key goals is to summarise the network into a single metric.  This has been achieved and allows network managers and engineers to watch this metric for problems in the network as the metric changes.  These metrics are shown on the NMIS Dashboard.  You can view a small dash or a large dash, if you prefer the large dash by default change the nmis.conf config item "show_large_menu" to "true".

Summary

This displays summary details about a node.  This includes some configuration information, a health graph and an interface table.  If you do not wish to see the uncollected interfaces set the nmis.conf config item "show_non_collected_interfaces" to "false".

Graphs are drillable.

Health

This displays more detailed graphs about the health of a device.  If available, CPU, Memory, packets switched or routed, etc.

Find

Allows you to search the NMIS data for all interfaces with the keywords in IP address, description, interface name, subnet mask.  This is a simple way to see exactly how many Gigabit interfaces you have and the IP addresses for each.

This becomes quite a powerful tool by being able to identify which routers have which IP address and IP subnet.

Current Events

Shows a list of active events in the NMIS event state table.  This is what is wrong with the network right now.  You can acknowledge and un-acknowledge events to stop them escalating.  Events can't be deleted, this is quite deliberate, without them in the log they will keep occurring.

Event Log

A list of previous events color coded and drillable.  Handy!

Reports

Produces dynamic reports and lists the snapshot reports if it has been enabled (done through the reports.pl and run-reports.sh scripts).

Outages

Add planned outages to NMIS so NMIS won't decrease your network metrics.

Links

When configured lists a set of links on NMIS and show summary information, another nice way to view the network information.

Logs 

Allows you to view color coded drillable logs of Cisco Syslog information (if configured) and other logs you might like to have on your web browser.

NMIS Log

Allows you to view NMIS log information for errors, etc.  A great place to look if things are going wrong.

Nodes

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

Links

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

Locations

You can add, edit and delete entries to the NMIS Locations table.  Allows information to be stored about locations for the network.  Links to sysLocation.  Lets map that logical to physical.

Contacts

You can add, edit and delete entries to the NMIS Contacts table.  Allows information to be stored about contacts for the network.  Links to sysContact.

Event Policy

You can add, edit and delete entries to the NMIS Event Policy table.  This controls how events are processed by NMIS, what event level each node type and role type will generate and weather or not it will send alerts.

Escalation Policy

You can add, edit and delete entries to the NMIS Escalation Policy table.  This controls how events are escalated by NMIS, what  each node type and role type will generate and weather or not and how it will escalate unacknowledged events.

IP

The IP tool allows you to view and calculate IP addressing information for IP subnetting.  Handy if you are wondering what the broadcast address is for IP address 10.24.51.193 mask 255.255.255.224

Draw Graph

Draw graph is a subroutine used by NMIS to produce graphs, you can embed this in any HTML you like and can be used to allow distributed access, just to a view HTML source on one of the web pages to see how.  Basically you call it like this:

<img border="0" alt="Device Health" 
src="http://nmis_server/cgi-nmis/nmiscgi.pl?file=nmis.conf&type=drawgraph&
node=c1000&graph=health&length=2days&start=0&end=0&width=500&height=100">

Where:

  • file is nmis config file defaults to nmis.conf
  • type must be "drawgraph"
  • node is the node name
  • graph can be health, cpu, memory, interface, etc.
  • length is AT style, ie 2days, 1day, 2hours, etc.
  • start and end default to 0 but you can start x seconds ago and end y seconds ago.
  • height and width are the requested size of the image, which will actually be the size of the graph not the resulting image.
metrics.pl

This NMIS CGI script displays a simple metric table, handy for keeping visible somewhere like an active desktop.

map.pl

This displays a map and icons of each configured group.  You edit the map.csv to control this.  You should create and entry for each Group and find a suitable Map background icon.  The colors represent the status, etc.

This is intended to put up on a screen for "at a glance" checking on the network.  Handy for a basic NOC monitoring function, ie colored icons change to represent the problem and you can drill in.

view.pl

This allow NMIS to view and edit the CSV files used to control NMIS.

summary.pl

This produces a VERY basic summary of the NMIS for group and node status, alows drill around, intended for WAP, PDA Web Browsers, dialup, etc.

event.pl

This allows integration for other systems to send events to NMIS over HTTP, by calling URL's with required information.  Quite handy to allow NMIS event and escalation subsystem to be used for this!  Ie monitoring something else, oh its down, I will tell NMIS to add it to its state table and check the policy and send an alert if required.

query.pl

This can be used to allow NMIS to be used in a distributed manner, this CGI can be called from remote machines to determine what this NMIS is monitoring and what the status and health of devices are.