|
|
snmpd.conf(5n) snmpd.conf(5n) Name snmpd.conf - Simple Network Management Protocol (SNMP) daemon configuration file Description The file is a configuration file that contains information used by the daemon to define the static variables whose values are not available in the kernel. It is created for you when you run the command, or you can create it manually. The system or network manager is usually responsible for maintaining it. The following are the file variables and their significance: sysDescr ID-string The variable describes the host. The ID-string is the value of the variable The default entry is of the form: hostname:machine-type:software id For example, the entry for a MicroVAX II named that is running ULTRIX Version 4.0 might read: sysDescr host1:MicroVAXII:ULTRIX V4.0 (Rev 64) System #2 interface speed name speed The variable describes a value for the Management Information Base (MIB) variable defined as: The name parameter must be an ULTRIX interface name, such as sl0. The following interfaces have default interface speeds and types: de, qe, ni, ln, se, scs, xna. If your system has one of these interfaces, you do not need to specify this parameter. The speed parameter is a decimal number that describes the speed of the link in bits per second. If you do not specify the speed parameter, does not return this variable and marks it as unavailable. interface type name type The variable describes a value for the MIB variable in the interface table defined as: The name parameter must be an ULTRIX interface name, such as sl0. See the sample file in the Examples section for a complete listing of the possible type specifications. If the type parameter is not specified, marks it as unavailable. tcpRtoAlgorithm algorithm-type The variable describes a value for the MIB variable in the tcp group defined as This variable defines the Retransmission Time-Out (RTO) algorithm your system uses. The algorithm-type parameter is a numeric code that represents the type of RTO algorithm you are using. The default algorithm is Van Jacobson's, which is algorithm number 4. See the sample file in the Examples section for a listing of the other algorithms. If you do not specify this parameter, does not return this variable, and marks it as unavailable. community name IP-address type The variable describes an SNMP community for the agent. The name parameter is a string that describes the name of the community. The IP-address parameter is the dot-notation Internet Protocol (IP) address for the server. Only SNMP packets coming from that address are accepted. If you specify 0.0.0.0 in the address field, the SNMP agent honors the request from any Network Management Sta- tion (NMS) having the name community. The type parameter can be one of the following: read-only Permits only monitoring of variables. read-write Permits both monitoring and setting of variables. traps Generates traps when appropriate and sends them to the specified address with the specified community name. The possible traps currently generated are cold start and authentication failure. If you do not specify any community, uses the default community with an address 0.0.0.0 and a read-only type. Invalid uses of commu- nities are logged with the command. To limit the use of a community to a finite group of machines, specify another community clause with the same community parameter name and a different address. timeout value The variable indicates the timeout value in seconds between the Agent and the Extended Agent. If the Agent does not receive a response within the allotted time, it returns an error message to the NMS. The default timeout value is 5 seconds. extension extended-agent p1 p2 p3 p4 The variable lists the pathname of the extended-agent that the Agent activates. Variables p1 through p4 are passed by the Agent to the Extended Agent; p1 is usually the process name to be given to the Extended Agent. Examples The default file contains only the following entry: community public 0.0.0.0 read-only The following is an example of an extensive file: # # snmpd.conf file # sysDescr host1:MicroVAXII:ULTRIX V4.0 System #2 # # Describe the TCP RTO algorithm you are using. Values # are listed in RFC 1066, under the TCP group variable: # tcpRtoAlgorithm # They are: # # other(1) -- None of the below # constant(2) -- constant RTO # rsre(3) -- MILSTD 1778, appendix B # vanj(4) -- Van Jacobson's algorithm # tcprtoalgorithm 4 # # Describe who can use your SNMP daemon by # defining "communities". USAGE: # # community <name><IP address><type> # # This is a limited-use community; a finite number of # hosts can use it. # Can only query from this community. # community test1 128.45.10.100 read-only community test1 128.45.10.101 read-only # # These are our wide-open, general-use communities. Specifying # 0.0.0.0 means that any address can use this community only # to monitor variables. # community public 0.0.0.0 read-only # # This is our only management community. You can set variables # as well as monitor variables with this community. It is a # wide-open community as well. # community testwrite 0.0.0.0 read-write # # This is a trap community. We send traps to these addresses # all from the same community name. Note that a 0.0.0.0 # address in a trap session is illegal and snmpd will ignore # that community definition. # community trap1 128.45.10.100 traps community trap1 128.45.10.101 traps # # The interface speed is given in bits/sec. USAGE: # # interface speed <name> <speed> # interface speed sl0 9600 # # The <name> parameter for the interface type is the # same as the <name> for the interface speed, sl0 for # this example. USAGE: # # interface type <name> <type> # # The code number for the proper interface hardware type # is specified in RFC 1066 under the ifType object # definition. # # Some possible values: # # other(1) # regular1822(2) # hdh1822(3) # ddn-x25(4) # rfc877-x25(5) # ethernet-csmacd(6) # iso88023-csmacd(7) # iso88024-tokenBus(8) # iso88025-tokenRing(9) # iso88026-man(10) # starLan(11) # Proteon-10MBit(12) # Proteon-80MBit(13) # hyperchannel(14) # fddi(15) # lapb(16) # sdlc(17) # t1-carrier(18) # cept(19) -- European equivalent of T-1 # basicIsdn(20) # primaryIsdn(21) # propPointToPointSerial(22) -- proprietary serial # interface type sl0 1 # # Timer value to time out requests to extended agents. # timeout 6 # # List of extended agents. # extension /etc/snmpextd snmpextd In this example, note the following: o Community can be monitored by either 128.45.10.100 or 128.45.10.101. o Community can be monitored by any NMS. o Community can be monitored and managed by any NMS. o When a trap is generated, it is sent to community at 128.45.10.100 or 128.45.10.101. Destination addresses must have a mechanism in place to handle the traps. See Also snmpext(3n), snmpd(8n), snmpsetup(8n) RFC 1066--Management Information Base for Network Management of TCP/IP- based Internets RFC 1067--A Simple Network Management Protocol Guide to Networking snmpd.conf(5n)