WebLogic SNMP
Management Guide

WebLogic SNMP Command-Line Utility

WebLogic Server provides a command-line utility that offers many of the same features as an SNMP manager. You can use this utility to test and troubleshoot the configuration of your SNMP agents in a WebLogic Server domain.

The following sections describe working with the WebLogic Server SNMP command-line utility:

where WL_HOME is the directory in which you installed WebLogic Server.

The script adds a supported JDK to the shell’s PATH environment variable and adds WebLogic Server classes to the CLASSPATH variable.

Syntax and Commands for the SNMP Command-Line Utility

Invoke the SNMP command-line utility as follows:

java weblogic.diagnostics.snmp.cmdline.Manager command [-?]

where command is one of the commands described in Table 5-1 and-? outputs usage information for the specified command.

Table 5-1 SNMP Commands

Command

Description

SnmpBulkWalk [-Bm][startingOID] [endingOID]

Returns a collection of MIB object instances (MIB variables) by repeatedly invoking SnmpGetNext in a pattern that you specify.

Starting from the first OID that you specify on the command line, the command invokes the SnmpGetNext command as many times as needed to retrieve all MIB variables below the object.

The command increments the OID that you specified on the command line and repeats the pattern described in the previous paragraph.

The -Bm argument causes this command to group multiple SnmpGetNext invocations in each request that it sends to the SNMP agent. For example, -Bm 3 causes this command to issue 3 SnmpGetNext invocations in each request until it reaches the last OID in the sequence.

SnmpInform

Constructs an INFORM notification and distributes it to an SNMP manager or trap monitor.

SnmpGet

Retrieves the value of one or more MIB variables. This command does not accept OIDs for managed objects.

You can specify an optional interval at which this command repeatedly retrieves the value of the specified variable.

SnmpGetAll <columnOID>[<columnOID>...]

Walks the table columns that you specify and groups the column values for each row in the output. All specified columns must be from the same table.

SnmpGetBulk [-Bn] [-Bm] [OIDs]

Returns a collection of MIB variables by repeatedly invoking SnmpGetNext in a pattern that you specify. Use the -Bn and -Bm arguments and one or more OIDs to specify the pattern.

The -Bn (non-repeaters) argument specifies the number of OID arguments on the command line for which the command will not repeatedly perform SnmpGetNext operations. For these OIDs, the command performs an SnmpGetNext operation once and then moves on to the next OID argument on the command line. Consider using -Bn and non-repeater OIDs for scalar objects.

The -Bm (maximum repetitions) argument specifies how many times the command will perform SnmpGetNext operations for all other OIDs on the command line. Consider using -Bm and associated OIDs for tabular objects.

SnmpGetNext

Returns managed objects or MIB variables. If you specify a tabular object, this command returns the first child managed object. If you specify a scalar object, this command returns the first object variable.

Instead of the recursive listing that the SnmpWalk command provides, this command returns the description of only one managed object or variable whose OID is the next in sequence. You could string together a series of SnmpGetNext commands to achieve the same result as the SnmpWalk command.

SnmpTrap

Constructs a TRAP notification and distributes it to an SNMP manager or trap monitor.

SnmpTrapLogger

Starts a process that listens for notifications. Writes each notification that it receives to a log file.

SnmpTrapMonitor

Starts a process that listens for notifications. Prints each notification that it receives to standard out.

SnmpWalk

Returns all managed objects or variables that are below a specified node in the MIB or within a specified range.

If you specify the OID for a tabular object, the command returns all of its object variables along with all related (child) objects and variables.

Examples

The examples in this section assume that you have created an SNMP agent on the Administration Server and that you have not modified the default values for the agent. (For example, the agent listens on UDP port 161 and uses public as its community name.)

The examples use the -m and -M options to load the WebLogic Server MIB module. Loading the MIB module enables you to refer to managed objects by their display names instead of OIDs. The -M option assumes that you installed WebLogic Server in c:\bea\wlserver_10.0.