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:
-
System group (internet.mgmt.mib-2.system)
-
SNMP group (internet.mgmt.mib-2.snmp)
-
snmpdConf group (enterprises.hp.nm.snmp.snmpdConf)
Location
-
HP-UX (IPF), Solaris: /opt/CM2/ESA/bin
-
AIX, Linux: /usr/sbin
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
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
-
Specifying a value of less than 15 seconds as the time set in the SNMP_HTC_INIT_WAIT_TIME environment variable increases the probability that a noSuchName error will be returned in response to a request from the SNMP manager.