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  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 from a start-up script  at  boot
     time  only  if  contents  of the resource configuration file
     /etc/snmp/conf/snmpdx.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 direc-
           tory is /etc/snmp/conf.

     -d debug-level
           Debug. Levels from 0 to 4 are supported, giving  vari-
           ous  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 Microsys-
           tems, 1.3.1.6.1.4.32). The Master Agent uses this file
           as  a  base for look-up in the trap-filtering and for-
           warding    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  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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsasnm                   |
    |_____________________________|_____________________________|

SEE ALSO

     snmpXdmid(1M), attributes(5)