snmpxdmid(1m) [sunos man page]
snmpXdmid(1M) System Administration Commands snmpXdmid(1M) NAME
snmpXdmid - Sun Solstice Enterprise SNMP-DMI mapper subagent SYNOPSIS
/usr/lib/dmi/snmpXdmid -s hostname [-h] [-c config-dir] [-d debug-level] DESCRIPTION
The snmpXdmid utility is a subagent in the Solstice Enterprise Agent Desktop Management Interface package. It maps the SNMP requests for- warded by the Master Agent ( snmpdx(1M)) into one or more equivalent DMI requests. Further, it remaps the DMI response into SNMP response back to snmpdx. By default, snmpXdmid also forwards the DMI indications as SNMP traps to snmpdx. The feature is configurable and can be disabled by setting TRAP_FORWARD_TO_MAGENT=0 in the snmpXdmid configuration file, snmpXdmid.conf. This subagent runs as a daemon in the system. The subagent uses a set of .MAP files located in /var/dmi/map to map the SNMP Object Identi- fier (OID) into a corresponding DMI component. The map files are generated using the MIF-to-MIB utility, miftomib. They are read by snm- pXdmid when a corresponding MIF file gets registered with the DMI Service Provider ( dmispd(1M)). The snmpXdmid.conf file is used for configuration information. Each entry in the file consists of a keyword followed by an equal sign (=), followed by a parameter string. The keyword must begin in the first position. A line beginning with a pound sign (#) is treated as a com- ment and the subsequent characters on that line are ignored. The keywords currently supported are: "small and bold">WARNING_TIMESTAIndication subscription expiration, warning time. EXPIRATION_TIMESTAMP Indication subscription expiration timestamp. FAILURE_THRESHOLD DMISP retries before dropping indication due to comm errors. TRAP_FORWARD_TO_MAGENT 0 Drop indication at the subagent level. non-zero Forward indications as SNMP traps to snmpdx. By default, the configuration file snmpXdmid.conf is located in the /etc/dmi/conf directory. You can specify an alternative directory with the -c option. OPTIONS
The following options are supported: -c config-dir Specify the directory where snmpXdmid.conf file is located. -d debug-level Debug. Levels from 1 to 5 are supported, giving various levels of debug information. -h Help. Print the command line usage. -s hostname Specify the host on which dmispd is running. FILES
/etc/dmi/conf/snmpXdmid.conf DMI mapper configuration file ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWsadmi | +-----------------------------+-----------------------------+ SEE ALSO
dmispd(1M), snmpdx(1M), attributes(5) SunOS 5.10 17 Dec 1996 snmpXdmid(1M)
Check Out this Related Man Page
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)