1snmpdx(1M) System Administration Commands snmpdx(1M)
2
6 snmpdx - Sun Solstice Enterprise Master Agent
7
9 /usr/lib/snmp/snmpdx [-hy] [-a filename] [-c config-dir]
10 [-d debug-level] [-i filename] [-m GROUP -m SPLIT]
11 [-o filename] [-p port] [-r filename]
12
15 The Master Agent, snmpdx, is the main component of Solstice Enterprise
16 Agent (SEA) technology. It runs as a daemon process and listens to User
17 Datagram Protocol (UDP) port 161 for SNMP requests. The Master Agent
18 also opens another port to receive SNMP trap notifications from various
19 subagents. These traps are forwarded to various managers, as determined
20 by the configuration file.
21 Upon invocation, snmpdx reads its various configuration files and takes
24 appropriate actions by activating subagents, determining the subtree
25 Object Identifier (OID) for various subagents, populating its own Man‐
26 agement Information Bases (MIBs), and so forth. The Master Agent
27 invokes subagents, registers subagents, sends requests to subagents,
28 receives responses from subagents, and traps notifications from sub‐
29 agents.
30 The Master Agent is invoked by the service management facility smf(5)
33 at boot time if svc:/application/management/snmpdx is enabled (see
34 NOTES) and contents of the resource configuration file
35 /etc/snmp/conf/snmpdx.rsrc are non-trivial.
36 Note -
38 The SMA (Systems Management Agent) is the default SNMP agent in the
40 Solaris operating system. snmpdx is Obsolete and may not be supported
41 in a future release of Solaris.
42
44 The following options are supported:
45 -afilename Specify the full path of the access control file
47 used by the Master Agent. The default access
48 control file is /etc/snmp/conf/snmpdx.acl.
49 -cconfig-dir Specify the full path of the directory contain‐
52 ing the Master Agent configuration files. The
53 default directory is /etc/snmp/conf.
54 -ddebug-level Debug. Levels from 0 to 4 are supported, giving
57 various levels of debug information. The default
58 is 0 which means no debug information is given.
59 -h Help. Print the command line usage.
62 -ifilename Specify the full path of the enterprise-name OID
65 map. This file contains the PID used by the Mas‐
66 ter Agent for recovery after a crash. It con‐
67 tains tuples of the UNIX process ID, port num‐
68 ber, resource name, and agent name. The default
69 file is /var/snmp/snmpdx.st.
70 -m GROUP | -m SPLIT Specify the mode to use for forwarding of SNMP
73 requests.
74 GROUP Multiple variables can be included in
76 each request from the Master Agent to
77 the subagents. This results in, at
78 mose, one send-request per agent.
79 SPLIT Each variable in the incoming request
82 results in one send-request to each
83 subagent.
84 The default is GROUP.
86 -ofilename Specify the full path of the file containing the
89 tuple (enterprise-name, OID). For example, (Sun
90 Microsystems, 1.3.1.6.1.4.32). The Master Agent
91 uses this file as a base for look-up in the
92 trap-filtering and forwarding process. The
93 default file is /etc/snmp/conf/enterprises.oid.
94 -pport Specify the port number. The default port number
97 is 161.
98 -rfilename Specify the full path of the resource file to be
101 used by the Master Agent. This file stores
102 information about the subagents that the Master
103 Agent invokes and manages. The default resource
104 file is /etc/snmp/conf/snmpdx.rsrc.
105 -y Set a recovery indicator to invoke the recovery
108 module. The recovery process discovers which
109 subagents in the previous session are still
110 active; those subagents not active are re-
111 spawned by the Master Agent.
112
115 /etc/snmp/conf/enterprises.oid
116 Enterprise-name OID map
118 /etc/snmp/conf/snmpdx.acl
121 Access control file
123 /etc/snmp/conf/snmpdx.rsrc
126 Resource configuration file
128 /var/snmp/snmpdx.st
131 Master Agent status file
133 /var/snmp/mib/snmpdx.mib
136 Master Agent MIB file
138
141 The following error values are returned:
142 0 Successful completion.
144 non-zero An error occurred.
147
150 See attributes(5) for descriptions of the following attributes:
151 ┌─────────────────────────────┬─────────────────────────────┐
156 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
157 ├─────────────────────────────┼─────────────────────────────┤
158 │Availability │SUNWsasnm │
159 ├─────────────────────────────┼─────────────────────────────┤
160 │Interface Stability │Obsolete │
161 └─────────────────────────────┴─────────────────────────────┘
162
164 attributes(5), smf(5)
165
167 The snmpdx service is managed by the service management facility,
168 smf(5), under the service identifier:
169 svc:/application/management/snmpdx
171 Administrative actions on this service, such as enabling, disabling, or
175 requesting restart, can be performed using svcadm(1M). The service's
176 status can be queried using the svcs(1) command.
177SunOS 5.11 2 May 2006 snmpdx(1M)