Configuration file (snmpd.cnf)
- Organization of this page
Format
snmpTargetAddrEntry <CONFIG_NAME> transportDomainUdpIpv6 \ [<IPv6_ADDRESS>]:0 0 0 TrapConf <v1TrapParams | v2cTrapParams> readOnly \ [ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff]:0 2048 snmpEnableAuthenTraps {1 | 2} MAX_SUBAGENTS maximum-number-of-connected-subagents MAX_THREADS maximum-number-of-threads-concurrently-generated-by-master-agent sysName local-host-name
Overview
This file defines the following settings:
-
IPv6 trap destination
-
Settings for the sending of authentication failure traps
-
Maximum number of connected subagents
-
Maximum number of threads concurrently generated by the master agent
-
sysName value
Location
HP-UX (IPF), Solaris, AIX, and Linux: /etc/srconf/agt/snmpd.cnf
Detailed description
- snmpTargetAddrEntry
-
This definition specifies an IPv6 trap destination.
-
CONFIG_NAME: Specify any name as the configuration name.
If multiple IPv6 trap destinations are set, give each a unique configuration name. The configuration name cannot exceed 32 characters, and can contain only alphanumeric characters, including underscores.
-
transportDomainUdpIpv6: To specify an IPv6 address without a scope ID, specify transportDomainUdpIpv6.
To specify an IPv6 address with a scope ID, enter transportDomainUdpIpv6z.
-
IPv6_ADDRESS: Specify an IPv6 address for the IPv6 trap destination. A host name cannot be specified. For both SNMPv1 traps and SNMPv2c traps, you need to enclose the IPv6 address in square brackets ([ ]). Be careful not to omit these.
-
v1TrapParams | v2cTrapParams: Specify the protocol version for the SNMP trap.
- For SNMPv1 traps
-
Specify v1TrapParams.
- For SNMPv2c traps
-
Specify v2cTrapParams.
-
- snmpEnableAuthenTraps {1 | 2}
-
Indicates whether the SNMP Agent process is permitted to send authentication-failure traps. The default value is 1.
-
1: Sends authentication failure traps.
-
2: Sending of authentication failure traps is disabled.
-
- MAX_SUBAGENTS maximum-number-of-connected-subagents
-
This value is the maximum number of connected subagents. The minimum value and the default value of MAX_SUBAGENTS is 22. The maximum value depends on the maximum number of threads that the OS can generate in a process.
- MAX_THREADS maximum-number-of-threads-concurrently-generated-by-master-agent
-
This value is the maximum number of threads that can be concurrently generated by the master agent. The minimum value and the default value of MAX_THREADS is 22. The maximum value depends on the maximum number of threads that the OS can generate in a process.
- sysName local-host-name
-
This option specifies the local host name that becomes the sysName value. By default, no value is set.
Definition examples
-
Below is a sample configuration for sending SNMPv1 traps to interface number 1 at IP address fec0::1111:2222:3333:4444:5555. The configuration name is Trapsend_SNMPv1_IPv6. Note that when a %scope-ID is specified, you must write transportDomainUdpIpv6z.
snmpTargetAddrEntry Trapsend_SNMPv1_IPv6 transportDomainUdpIpv6z \ [fec0::1111:2222:3333:4444:5555%1]:0 0 0 TrapConf v1TrapParams readOnly \ [ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff]:0 2048
-
Below is a sample configuration for sending SNMPv2c traps to IP address fec0::1111:2222:3333:4444:5555, with no %scope-ID specified. The configuration name is Trapsend_SNMPv2c_IPv6.
snmpTargetAddrEntry Trapsend_SNMPv2c_IPv6 transportDomainUdpIpv6 \ [fec0::1111:2222:3333:4444:5555]:0 0 0 TrapConf v2cTrapParams readOnly \ [ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff]:0 2048
-
Below is a sample configuration for sending SNMPv2c traps to IP address fec0::1111:2222:3333:4444:5555 and IP address fec0::aaaa:bbbb:cccc:dddd:eeee, with no %scope-ID specified. The configuration names are NNM_1 and NNM_2. Note that when multiple trap destinations are set, each must be given a unique configuration name.
snmpTargetAddrEntry NNM_1 transportDomainUdpIpv6 \ [fec0::1111:2222:3333:4444:5555]:0 0 0 TrapConf v2cTrapParams readOnly \ [ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff]:0 2048 snmpTargetAddrEntry NNM_2 transportDomainUdpIpv6 \ [fec0::aaaa:bbbb:cccc:dddd:eeee]:0 0 0 TrapConf v2cTrapParams readOnly \ [ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff]:0 2048
-
To suppress the sending of authentication failure traps:
snmpEnableAuthenTraps 2
-
Changing the maximum number of connected subagents
For details about how to change the maximum number of connected subagents, see 3.5 Changing the maximum number of connected subagents.
-
Procedure for changing the sysName host name
For details about how to use a new host name as the sysName value after you have installed SNMP Agent and renamed the host, see 3.7.4 Notes about renaming a host.