SNMPRTMETRIC(1) — NEWS-OS Programmer’s Manual

NAME

snmprtmetric − SNMP route metric monitor

SYNOPSIS

snmprtmetric [options] agent

DESCRIPTION

snmprtmetric is a graphical route metric monitor based on the UNIX Curses library. snmprtmetric will query an agent agent for route metric information and display the metrics for a set of networks in the form of a bar graph. agent, the IP router to be monitored, may be specified as a dot notation address such as ’128.213.1.2’ or as an Internet Domain name. The networks whose route metrics are to be monitored are specified in a configuration file (see Configuration File below). Note that in the event that agent agent does not have a route metric for a certain net that is to be monitored, the net will be indicated as unreachable on the display. Also, a net will be indicated as unreachable if no response containing metric information for that net is ever received by agent. snmprtmetric has a threshold capability - metric lines will change from having one bar ’|’ to having two bars if the current route metric is not the best known metric.

SNMP OPTIONS

-f configfile: read the networks whose route metrics are to be monitored from the configuration file configfile. This option is currently not optional.

-c community: use community id community_id when querying gateway agent. The default community id is ’public’.

-i interval: query for routing information at intervals of interval seconds. The default is 60 seconds.

-l logfile: log all changes in routing metrics to this file.

-r: reverse video display mode.

CONFIGURATION FILE

The format of the snmprtmetric configuration file is lines of the form:

net_name ipaddress

Lines beginning with ’#’ are treated as comments.

FILES

configfile config file for the application

COMMANDS

The commands are pretty much taken from vi, except for ’q’.

q: Quit.

j,+: Move the cursor down one position, scrolling if necessary.

k,-: Move the cursor up one position, scrolling if necessary.

^L: Redraw the screen.

^D: If screen is full of metric displays, then scroll display up (user’s view down) 5 lines. If the screen is not full, move the cursor down 5 lines.

^U: If screen is full of metric displays, then scroll display down (user’s view up) 5 lines. If the screen is not full, move the cursor up 5 lines.

^F: If screen is full, page forward one page, leaving the cursor at the bottom of the display. If the display is not full move the cursor to the bottom of the display.

^B: If screen is full, page backward one page, leaving the cursor at the top of the display. If the display is not full move the cursor to the top of the display.

0: Move the cursor to the top of the display.

$: Move the cursor to the bottom of the display.

o: Open up a line below the current line to add a new route metric entry to query for. The line will open up and the cursor will be in the last column of the route name column. The user then types in a name. Deleting is allowed, and the name can be larger than the width of the route name column. Typing ESC signals the end of the name. The cursor then moves to the other column. The user now types in an Internet network address. Again the delete key works. And again, ESC signals the end of the network address. The route metric will initially be unreachable (16), but will be queried during the next polling interval.

O: The same as the above ’o’ command, except the line above is opened.

BUGS

snmprtmetric is extremely RIP-centric. The metrics it displays and the MAXMETRIC constant are biased towards RIP. Furthermore, it monitors the variable corresponding to RIP metrics on P4200s, snmpd and on ciscos. There is presently no mechanism for deleting route metrics from the display, or saving one’s changes in the original or an alternate configuration file. snmprtmetric also needs to be started with a configuration file. It should be able to startup with nothing and allow the user to add entries and then save them in a file. snmprtmetric should also display the means by which the route was learned (i.e., via RIP) and possibly the age of the route.

Museum