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 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 vari-
       ous 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 from a start-up script at boot time only if contents of the resource configuration file /etc/snmp/conf/snm-
       pdx.rsrc are non-trivial.

OPTIONS

       The following options are supported:

       -a filename	       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.

       -c config-dir	       Specify	the  full  path of the directory containing the Master Agent configuration files. The default directory is
			       /etc/snmp/conf.

       -d debug-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.

       -i filename	       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 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.

       -o filename	       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.

       -p port		       Specify the port number. The default port number is 161.

       -r filename	       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 pre-
			       vious 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 		   |
       +-----------------------------+-----------------------------+

SEE ALSO

       snmpXdmid(1M), attributes(5)

SunOS 5.10							    17 Oct 2002 							snmpdx(1M)