snmpd_files(4M) TCP/IP R4.11 snmpd_files(4M)
NAME
snmpd.conf - SNMP Agent configuration file
DESCRIPTION
Use this file to configure snmpd for your system. When snmpd is
started, it reads the configuration file and begins servicing
requests from the network.
This file replaces the three separate configuration files from
previous releases: snmpd.communities, snmpd.trapcommunities, and
snmpd.config. During setup, old files are converted into the new
file.
File Format
The file is composed of single line records. Each line begins with a
keyword that identifies the type of record. Currently there are 4
record types: community, trap, object, and subagent. A # or leading
white space at the beginning of the line identifies a comment.
Community Records
Communities are the authentication mechanism for SNMP version 1. All
SNMP messages contain a community name, which the agent uses to
control access to your system. When the agent receives a message it
validates the community specified in the message against those
configured in this file. If the community is not recognized the
request is discarded.
Each community record defines a community and consists of the
community name, host address, and access level. You should use
either the sysadm or admsnmpcommunity commands to modify these
records. Community records have the following format:
community name host access
where:
name is an ASCII string of up to 64 characters specifying a
community name to be recognized by the agent.
host is either a hostname or an Internet address,
identifying the host that can use name in a request.
Address 0.0.0.0 indicates any host.
access is one of: READ, for read-only access, WRITE, for
read-write access, or NONE for no access. Requests
using community name from host with access NONE will
not be answered.
Trap Records
Under a predefined set of conditions the agent will send unsolicited
messages to management stations. These messages are called traps.
Trap records specify the destinations for trap messages. The agent
sends each trap message to all of the trap destinations defined in
this file. A trap record consists of a community string, host
addresses, and an optional port number. You should use either the
sysadm or admsnmptrap commands to modify these records. Trap records
have the following format:
trap community host [ port ]
where:
community is an ASCII string of up to 64 characters specifying a
community name to send with the trap message. The NMS
receiving the trap should be configured to receive
messages from community from this host.
host is a hostname or Internet address specifying the
destination of the trap.
port is optional and specifies the UDP port number, which
defaults to 162.
Object Records
The snmp agent can obtain answers for most queries directly from the
system, however, for a small set of objects, some user configuration
may be necessary. For example, the agent doesn't know sysLocation --
the physical location of the system. To return a reasonable answer
the administrator needs to specify the value for sysLocation.
Object records are used to specify the values for this limited set of
objects. You should use either the sysadm or admsnmpobject commands
to modify these records. Object records have the following format:
object objectname value
where objectname may be one of: sysDescr, sysObjectID, sysContact,
sysLocation, sysName, snmpEnableAuthenTraps, dguxSnmpCacheTimeout, or
dguxUEAAllowConfigSets. The value for each object depends on the
object and should be specified as follows:
sysDescr should be a printable ASCII string, up to 255
characters, specifying the system description. The
description should include the name and revision of
the hardware, operating system, and networking
software. For example:
object sysDescr DataGeneral Aviion 9500, DG/UX
5.4R3.00 with TCP/IP.
sysObjectID should be a object ID that represents the type of
system. The default provided by the system is
adequate and is not usually modified. An object ID
may be specified by name or by number. For example:
object sysObjectID dguxOnAviion
or by number
object sysObjectID 1.3.6.1.4.1.106.2.1.2.1.1.1
sysContact should be a printable ASCII string, up to 255
characters, specifying the person who is responsible
for this system. The information should include
information on how to contact this person, such as an
e-mail address or phone number. For example:
object sysContact Greg Jones email: jonesjg@acme.com
phone: (000)123-4567
sysLocation should be a printable ASCII string, up to 255
characters, specifying the physical location of the
system. For example:
object sysLocation Building 108, Floor 1, Lab 4.
sysName should be a printable ASCII string, up to 255
characters, specifying the administratively-assigned
name for this system. By convention, this is the
node's fully qualified domain name. By default the
agent uses the value stored by hostname(1). For
example:
object sysName wyvern@acme.com
snmpEnableAuthenTraps
controls the generation of authentication traps for
requests that fail authentication. The values should
be specified as 1 to enable authentication traps (the
default), or 2 to disable traps. For Example:
object snmpEnableAuthenTraps 2
dguxSnmpCacheTimeout
specifies the maximum length of time the SNMP agent
can keep data and use it before refreshing it. The
values should be specified in seconds within the range
of 0 and 60480. For Example:
object dguxSnmpCacheTimeout 10
dguxUEAAllowConfigSets
controls whether the SNMP User Extensible Agent(UEA)
configuration data defined in the /etc/snmpd_uea.conf
file can be modified via an SNMP set request. The
values should be specified as TRUE to allow sets on
UEA configuration data or FALSE (the default) to not
allow sets on UEA configuration data. For Example:
object dguxUEAAllowConfigSets FALSE
Subagent Records
The SNMP agent supports the EMANATE extensibility mechanism created
by SNMP Research Inc.. Subagent records specify a pathname to a
shared library subagent. Administrators should not add, delete, or
modify subagent records. The subagents provided with DG/UX are
specific to DG/UX and cannot be used with any other operating system.
SEE ALSO
admsnmpcommunity(1M), admsnmpobject(1M), admsnmptrap(1M), snmpd(1M),
sysadm(1M).
Licensed material--property of copyright holder(s)