Hitachi

JP1 Version 12 JP1/Extensible SNMP Agent Description, Operator's Guide and Reference


snmpdm

Organization of this page

Syntax

snmpdm  [-authfail][-Contact system-contact][-help]
        [-Location system-location]
        [-mask logmask][-n][-tcplocal]
        [-ip_proto [ipv4 | ipv4_ipv6 | ipv6]]
        [-sysDescr description][-hexdump][-vbdump]

Description

The snmpdm process handles communications for the master agent. The master agent listens for SNMP requests from the SNMP manager, and sends each message it receives to a subagent. The subagent returns a response to the master agent, and the master agent passes this response back to the SNMP manager.

The master agent provides the following MIB groups:

Location

Arguments

-authfail

Abbreviation of -authfail: -a

This option suppresses the sending of authentication failure traps from the master agent.

Usually do not use this option because it is provided for compatibility with SNMP Agents of the previous version.

To inhibit authentication failure traps, specify 2 for snmpEnableAuthenTraps in /etc/srconf/agt/snmpd.cnf and reactivate the master agent.

-Contact system-contact

Abbreviation of -Contact: -C

This option sets system-contact as the system contact of the master agent.

-help

Abbreviation of -help: -h

This option displays information about the command options of the master agent.

-Location system-location

Abbreviation of -Location: -L

This option sets system-location as the system location of the master agent.

-logfile log-file-name

Abbreviation of -logfile: -l

This option sets log-file-name as the name of the logfile for master agent logs.

-mask logmask

Abbreviation of -mask: -m

This option sets the master agent's logmask value to logmask. The logmask value can be a character string, decimal number, or hexadecimal number. The table below lists logmask values, followed by coding samples.

Type of logmask value

Log suppression

Trace log output

Warning log output

Error log output

Character string

-

FACTORY_TRACE

FACTORY_WARN

FACTORY_ERROR

Decimal number

0

8388608

268435456

536870912

Hexadecimal number

0x0

0x00800000

0x10000000

0x20000000

Legend:

-: Not applicable

Examples:

snmpdm -m FACTORY_TRACE
snmpdm -m 8388608
snmpdm -m 0x00800000
snmpdm -m FACTORY_TRACE FACTORY_WARN FACTORY_ERROR

If you specify the -m option with a character string in combination with other options, note that the -m option is the last option specified.

-n

This option specifies that the master agent does not act as a daemon.

-tcplocal

This option enables acceptance of TCP connections from the subagents.

-ip_proto [ipv4 | ipv4_ipv6 | ipv6]

Specifies the IP version of the SNMP request reception port. If -ip_proto is not specified, an IPv4 and IPv6 (ipv4_ipv6) SNMP request reception port is used.

ipv4

Only an IPv4 SNMP request reception port is used.

ipv4_ipv6

Both IPv4 and IPv6 SNMP request reception ports are used.

ipv6

Only an IPv6 SNMP request reception port is used.

-sysDescr description

Abbreviation of -sysDescr: -sys

This option sets description as the description of the master agent.

-hexdump

Displays a hexadecimal dump of the contents of an SNMP packet. For details about how to use this argument, see 7.4.1 Acquiring a master agent send/receive packet dump.

-vbdump

This option displays the contents of the VarBind lists in the SNMP packets. For details about how to use this option, see 7.4.1 Acquiring a master agent send/receive packet dump.

-apverbose

This option outputs a verbose log.

External influences

Environment variables

Specify the following environment variables in the SnmpMaster file.

SR_SNMP_TEST_PORT

This environment variable sets the master agent's SNMP reception port. If this environment variable is not specified, the master agent uses the value set in the snmp line of the /etc/services file as the SNMP reception port. Normally, you do not need to specify this environment variable. You must specify this environment variable only if you want to change the master agent's SNMP reception port.

SNMP_HTC_AUTH_LOG

This environment variable specifies whether unauthorized community names are collected.

For details about how to set the SNMP_HTC_AUTH_LOG environment variable, see 7.4.4 Collecting logs of unauthorized community names.

SR_TRAP_TEST_PORT

This environment variable sets the master agent's SNMP trap notification port.

SNMP_HTC_INIT_WAIT_TIME

This environment variable specifies a value from 0 to 300 (in seconds) as the time period from when the snmpdm process completes startup processing until a coldStart trap is sent. SNMP requests received during this period are discarded. The default is 15 seconds.

SNMP_HTC_SNMPD_LOG_SIZE

This environment variable specifies the size of the output files for logs, hexadecimal dumps, and VarBind lists as a value from 0 to 50 (in megabytes). If 0 is specified, logs, hexadecimal dumps, and VarBind lists are not output. The default is 10 megabytes.

SNMP_HTC_SNMPD_LOG_CNT

This environment variable specifies the number of output files for logs, hexadecimal dumps, and VarBind lists as a value from 1 to 10. The default is 10 files.

SR_LOG_DIR

This environment variable specifies the output directory for logs, hexadecimal dumps, and VarBind lists.

Note