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

NAME

snmpxrtmetric − SNMP route metric monitor

SYNOPSIS

snmpxrtmetric gw [options]

DESCRIPTION

snmpxrtmetric is a graphical route metric monitor compatible with X-Windows Version 11. snmpxrtmetric 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. gw the gateway to be monitored may be specified as a dot notation address such as ’128.213.1.2’. 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. The maximum number of nets supported by any single snmpxrtmetric process is determined by the MAXNETS constant compiled into the application. Currently MAXNETS is set at 256. snmpxrtmetric has a threshold capability - metric lines will change color from green to red (if the application was compiled to display in color) or from solid to dashed (if the application was compiled to display on a monochrome device) if metrics reach MAXMETRIC (16).

SNMP OPTIONS

--f configfile: read the networks whose route metrics are to be monitored from the configuration file configfile.

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

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

X-WINDOW OPTIONS

The following are the X-window options. These options follow the X-window convention as closely as possible. -display host:display

This option allows snmpxrtmetric to be run on a remote X server. In specifying the display, use the standard X format. For example, rebel:0.0.

Using X Resources

Snmpxperf reads the command line arguments, then passes through the users $HOME/.Xdefaults file and creates a local resource database. Any command line option will take precedence over the .Xdefaults parameter. Here are a list of all settable snmpxperf parameters in .Xdefaults format, the values given are the default values if nothing is specified:

snmpxrtmetric.display:1:0.0
snmpxrtmetric.font:6x10
snmpxrtmetric.geometry:NULL (as big as font dictates)
snmpxrtmetric.borderwidth:2
snmpxrtmetric.name:snmpxrtmetric
snmpxrtmetric.reverseVideo:off
snmpxrtmetric.color:on
snmpxrtmetric.background:NavyBlue
snmpxrtmetric.foreground:white
snmpxrtmetric.bordercolor:red
snmpxrtmetric.graphcolor:white
snmpxrtmetric.badcolor:red
snmpxrtmetric.goodcolor:green
snmpxrtmetric.interval:60
snmpxrtmetric.community:"public"
snmpxrtmetric.bell:on

CONFIGURATION FILE

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

net_name ipaddress

Lines beginning with ’#’ are treated as comments.

FILES

configfile config file for the application

BUGS

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

Museum