snmpdx(1M)						  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 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 sub-
       tree 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 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. 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.

       -cconfig-dir	      Specify  the  full  path	of the directory containing 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 Master Agent for recov-
			      ery 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 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 previ-
			      ous 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		     |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  ser-
       vice's status can be queried using the svcs(1) command.

SunOS 5.11							    2 May 2006								snmpdx(1M)