Manual Pages for UNIX Operating System command usage for man snmpdx

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. 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  direc-
                            tory   containing  the  Master  Agent



SunOS 5.11           Last change: 2 May 2006                    1






System Administration Commands                         snmpdx(1M)



                            configuration  files.   The   default
                            directory 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
                            is /etc/snmp/conf/enterprises.oid.




SunOS 5.11           Last change: 2 May 2006                    2






System Administration Commands                         snmpdx(1M)



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




SunOS 5.11           Last change: 2 May 2006                    3






System Administration Commands                         snmpdx(1M)



     non-zero    An error occurred.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | system/management/snmp/sea  |
    |_____________________________|_____________________________|
    | Interface Stability         | Obsolete                    |
    |_____________________________|_____________________________|


SEE ALSO
     attributes(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