System Administration Commands snmpdx(1M)
NAME
snmpdx - 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 pro-
cess 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 Management 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
subagents.
The Master Agent is invoked by the service management facil-
ity 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. See netsnmp(5).
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.
SunOS 5.11 Last change: 2 May 2006 1
System Administration Commands snmpdx(1M)
-cconfig-dir Specify the full path of the direc-
tory containing the Master Agent con-
figuration files. The default direc-
tory is /etc/snmp/conf.
-ddebug-level Debug. Levels from 0 to 4 are sup-
ported, 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 Master
Agent for recovery after a crash. It
contains tuples of the UNIX process
ID, port number, resource name, and
agent name. The default file is
/var/snmp/snmpdx.st.
-m GROUP -m SPLIT Specify the mode to use for forward-
ing 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 incom-
ing 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
SunOS 5.11 Last change: 2 May 2006 2
System Administration Commands snmpdx(1M)
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
SunOS 5.11 Last change: 2 May 2006 3
System Administration Commands snmpdx(1M)
The following error values are returned:
0 Successful completion.
non-zero An error occurred.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWsasnm
Interface Stability Obsolete
SEE ALSO
attributes(5), netsnmp(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 Last change: 2 May 2006 4
|
