snmpdx(1M) System Administration Commands snmpdx(1M)NAMEsnmpdx - Sun Solstice Enterprise Master Agent
SYNOPSIS
/usr/lib/snmp/snmpdx [-hy] [-a filename] [-c config-dir]
[-d debug-level] [-i filename] [-m GROUP -m SPLIT]
[-o filename] [-p port] [-r filename]
DESCRIPTION
The Master Agent, snmpdx, is the main component of Solstice Enterprise
Agent (SEA) technology. It runs as a daemon process and listens to User
Datagram Protocol (UDP) port 161 for SNMP requests. The Master Agent
also opens another port to receive SNMP trap notifications from various
subagents. These traps are forwarded to various managers, as determined
by the configuration file.
Upon invocation, snmpdx reads its various configuration files and takes
appropriate actions by activating subagents, determining the subtree
Object Identifier (OID) for various subagents, populating its own Man‐
agement Information Bases (MIBs), and so forth. The Master Agent
invokes subagents, registers subagents, sends requests to subagents,
receives responses from subagents, and traps notifications from sub‐
agents.
The Master Agent is invoked by the service management facility smf(5)
at boot time if svc:/application/management/snmpdx is enabled (see
NOTES) and contents of the resource configuration file
/etc/snmp/conf/snmpdx.rsrc are non-trivial.
Note -
The SMA (Systems Management Agent) is the default SNMP agent in the
Solaris operating system. snmpdx is Obsolete and may not be supported
in a future release of Solaris.
OPTIONS
The following options are supported:
-afilename Specify the full path of the access control file
used by the Master Agent. The default access
control file is /etc/snmp/conf/snmpdx.acl.
-cconfig-dir Specify the full path of the directory contain‐
ing the Master Agent configuration files. The
default directory is /etc/snmp/conf.
-ddebug-level Debug. Levels from 0 to 4 are supported, giving
various levels of debug information. The default
is 0 which means no debug information is given.
-h Help. Print the command line usage.
-ifilename Specify the full path of the enterprise-name OID
map. This file contains the PID used by the Mas‐
ter Agent for recovery after a crash. It con‐
tains tuples of the UNIX process ID, port num‐
ber, resource name, and agent name. The default
file is /var/snmp/snmpdx.st.
-m GROUP | -m SPLIT Specify the mode to use for forwarding of SNMP
requests.
GROUP Multiple variables can be included in
each request from the Master Agent to
the subagents. This results in, at
mose, one send-request per agent.
SPLIT Each variable in the incoming request
results in one send-request to each
subagent.
The default is GROUP.
-ofilename Specify the full path of the file containing the
tuple (enterprise-name, OID). For example, (Sun
Microsystems, 1.3.1.6.1.4.32). The Master Agent
uses this file as a base for look-up in the
trap-filtering and forwarding process. The
default file is /etc/snmp/conf/enterprises.oid.
-pport Specify the port number. The default port number
is 161.
-rfilename Specify the full path of the resource file to be
used by the Master Agent. This file stores
information about the subagents that the Master
Agent invokes and manages. The default resource
file is /etc/snmp/conf/snmpdx.rsrc.
-y Set a recovery indicator to invoke the recovery
module. The recovery process discovers which
subagents in the previous session are still
active; those subagents not active are re-
spawned by the Master Agent.
FILES
/etc/snmp/conf/enterprises.oid
Enterprise-name OID map
/etc/snmp/conf/snmpdx.acl
Access control file
/etc/snmp/conf/snmpdx.rsrc
Resource configuration file
/var/snmp/snmpdx.st
Master Agent status file
/var/snmp/mib/snmpdx.mib
Master Agent MIB file
EXIT STATUS
The following error values are returned:
0 Successful completion.
non-zero An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │system/management/snmp/sea │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Obsolete │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOattributes(5), smf(5)NOTES
The snmpdx service is managed by the service management facility,
smf(5), under the service identifier:
svc:/application/management/snmpdx
Administrative actions on this service, such as enabling, disabling, or
requesting restart, can be performed using svcadm(1M). The service's
status can be queried using the svcs(1) command.
SunOS 5.11 2 May 2006 snmpdx(1M)