-- -- Copyright (c) 2003, 2011, Oracle and/or its affiliates. All rights reserved. -- -- U.S. Government Rights - Commercial software. Government users are subject to -- the Sun Microsystems, Inc. standard license agreement and applicable -- provisions of the FAR and its supplements. -- -- -- This distribution may include materials developed by third parties. Sun, Sun -- Microsystems, the Sun logo and Solaris are trademarks or registered -- trademarks of Sun Microsystems, Inc. in the U.S. and other countries. -- -- ------------------------------------------------ -- Systems Management Agent (SMA) SEA Proxy MIB ------------------------------------------------ SUN-SEA-PROXY-MIB DEFINITIONS ::= BEGIN IMPORTS DisplayString FROM SNMPv2-TC products FROM SUN-MIB; sunSeaProxyMIB MODULE-IDENTITY LAST-UPDATED "200309180000Z" ORGANIZATION "Sun Microsystems, Inc." CONTACT-INFO "Customer support" DESCRIPTION "The MIB used to manage the snmpdx master agent daemon " ::= { products 15 } -- -- ********** Global Master agent Information ****** -- sunSeaProxyMIBStatusFile OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "This file stores the process id's of all the sub agents that are invoked by the master agent. The purpose of this file is for Master Agent recovery in case the Master Agent dies or is killed. When the Master Agent restarts, the entries in this file will indicate which subagents are spawned by it previously and what were their port numbers." ::= { sunSeaProxyMIB 1 } sunSeaProxyMIBResourceConfigFile OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "This file is exclusively used by the Master Agent. When the Master Agent comes up, it reads this file. This files stores information for all those agents that can be managed by the Master Agent. Each entry in the configuration file also includes the methods for invoking these subagents. It is also possible for a subagent not to have an entry in this configuration file. Such a subagent can dynamically come up and register with the Master Agent when it comes up." ::= { sunSeaProxyMIB 2 } sunSeaProxyMIBConfigurationDir OBJECT-TYPE SYNTAX DisplayString ACCESS read-only STATUS mandatory DESCRIPTION "This is the directory that contains the configuration files for the Master Agent." ::= { sunSeaProxyMIB 3 } sunSeaProxyMIBTrapPort OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This is the port that master agent opens to receive SNMP trap notifications from various subagents. The master agent forwards these traps to the managers appropriately." ::= { sunSeaProxyMIB 4 } sunCheckSubAgentName OBJECT-TYPE SYNTAX DisplayString ACCESS read-write STATUS mandatory DESCRIPTION "This variable is of use to the sub agents only. It is used by the sub agents to check with the master to check for duplicate sub agent names." ::= { sunSeaProxyMIB 5 } sunSeaProxyMIBPollInterval OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This variable speicifies the time interval after which the Master Agent will perform activities other than receiving/sending of SNMP messages. The other activities include trying to find out if there is a change in the resource file, discover if all the agents are responding, and other such routine house keeping activities. This field contains values in seconds." ::= { sunSeaProxyMIB 6 } sunSeaProxyMIBMaxAgentTimeOut OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The value of this field can be specified in microseconds. This field signifies the max allowed time-out a subagent can request during registration; e.g., when the Master Agent sends a request to a subagent. It waits for some time-out to receive the response. This time-out can be specified in the registration file or can also be set using dynamic registration. If an agent sets this time-out outrageously high, it can create problems for the Master Agent and other agents. To avoid such a problem, the Master Agent can have a policy of specifying a maximum value for which the Master Agent will wait for a response from the subagent. This maximum value of time-out is specified with this variable." ::= { sunSeaProxyMIB 7 } -- -- *********** agentTable ************** -- sunSubAgentTable OBJECT-TYPE SYNTAX SEQUENCE OF SunSubAgentEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table lists all the sub-agents that are registered with the master agent. The list contains the names of all the sub agents that are currently running on the system. Some of these sub agents could be invoked by the master agent and other's could have benn invoked by other means." ::= { sunSeaProxyMIB 8 } sunSubAgentTableIndex OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "The next available index in sunSubAgentTable." ::= { sunSeaProxyMIB 9 } -- -- ************** agentEntry(Table Entry) ************ -- sunSubAgentEntry OBJECT-TYPE SYNTAX SunSubAgentEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry in the sub-agent table." INDEX { sunSubAgentID } ::= { sunSubAgentTable 1} SunSubAgentEntry ::= SEQUENCE { sunSubAgentID INTEGER, sunSubAgentStatus INTEGER, sunSubAgentTimeout INTEGER, sunSubAgentPortNumber INTEGER, sunSubAgentRegistrationFile DisplayString, sunSubAgentAccessControlFile DisplayString, sunSubAgentExecutable DisplayString, sunSubAgentVersionNum DisplayString, sunSubAgentProcessID INTEGER, sunSubAgentName DisplayString, sunSubAgentSystemUpTime TimeTicks, sunSubAgentWatchDogTime INTEGER } sunSubAgentID OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "This is the id for each sub agent that is running and registered with the master agent." ::= { sunSubAgentEntry 1 } sunSubAgentStatus OBJECT-TYPE SYNTAX INTEGER { init(1), load(2), active(3), inactive(4), destroy(5) } ACCESS read-write STATUS mandatory DESCRIPTION "This variable provides the state of the sub-agent. When the sub-agent is started the state is 'init'. Once the sub-agent has read it's configuration files, but has not registered with the master , the state is 'load'. After the 'load' state the sub-agent goes into 'active' state. In this state the sub-agent has registered with the master agent and would respond to any requests from the master agent and can also generate traps." ::= { sunSubAgentEntry 2 } sunSubAgentTimeout OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "The max. time for which the master agent would wait for a sub-agent to complete the request. The value is specified in usec. " ::= { sunSubAgentEntry 3 } sunSubAgentPortNumber OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-write STATUS mandatory DESCRIPTION "The port number of the sub-agent on which it listens for requests from the master agent." ::= { sunSubAgentEntry 4 } sunSubAgentRegistrationFile OBJECT-TYPE SYNTAX DisplayString ACCESS read-write STATUS mandatory DESCRIPTION "This is the registration file of a sub-agent. Each sub-agent has its own registration file. This file contains information pertinent to each agent. The information includes the name of the agent, the subtree OIDs managed by the respective agent, request time out, the preferred port number, etc." ::= { sunSubAgentEntry 5 } sunSubAgentAccessControlFile OBJECT-TYPE SYNTAX DisplayString ACCESS read-write STATUS mandatory DESCRIPTION "This is a file that has the access control information for each sub agent. It stores SNMP-related community information. Every subagent and a Master Agent can have its own access control file." ::= { sunSubAgentEntry 6 } sunSubAgentExecutable OBJECT-TYPE SYNTAX DisplayString ACCESS read-write STATUS mandatory DESCRIPTION "The executable file of the sub-agent." ::= { sunSubAgentEntry 7 } sunSubAgentVersionNum OBJECT-TYPE SYNTAX DisplayString ACCESS read-write STATUS mandatory DESCRIPTION "The version number of the sub-agent." ::= { sunSubAgentEntry 8 } sunSubAgentProcessID OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "The process id of the sub-agent." ::= { sunSubAgentEntry 9 } sunSubAgentName OBJECT-TYPE SYNTAX DisplayString ACCESS read-write STATUS mandatory DESCRIPTION "The name of the sub-agent. This is assigned by the user." ::= { sunSubAgentEntry 10 } sunSubAgentSystemUpTime OBJECT-TYPE SYNTAX TimeTicks ACCESS read-write STATUS mandatory DESCRIPTION "The system up time of the sub-agent." ::= { sunSubAgentEntry 11 } sunSubAgentWatchDogTime OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "This timeout is used by the Master Agent to determine if the subagent is up or not. The Master Agent will poll the subagent only if there has been no activity between the Master Agent and the subagent for this specified interval. This interval is specified in seconds." ::= { sunSubAgentEntry 12 } -- -- ********** SubTreeConfigurationTable **************** -- sunSubTreeConfigurationTable OBJECT-TYPE SYNTAX SEQUENCE OF SunSubTreeConfigurationEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This is the table of subtree registration requests made by the sub agents. The enteries in this table also include the sub tree OID's of those agents that are invkoed by the master agent. This table thus consists of enteries as configured in the sub agent registration files. These sub tree OID's are flattened into a OID sub tree dispatch table in the master agent which is also defined in this MIB." ::= { sunSeaProxyMIB 10 } sunSubTreeConfigurationTableIndex OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The next available index in sunSubTreeConfigurationTable." ::= { sunSeaProxyMIB 11 } -- -- ************** RegTreeEntry(Table Entry) ************ -- sunSubTreeConfigurationEntry OBJECT-TYPE SYNTAX SunSubTreeConfigurationEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry for table registration." INDEX { sunSubTreeAgentID, sunSubTreeIndex } ::= { sunSubTreeConfigurationTable 1 } SunSubTreeConfigurationEntry ::= SEQUENCE { sunSubTreeIndex INTEGER, sunSubTreeAgentID INTEGER, sunSubTreeOID OBJECT IDENTIFIER, sunSubTreeStartColumn INTEGER, sunSubTreeEndColumn INTEGER, sunSubTreeStartRow INTEGER, sunSubTreeEndRow INTEGER, -- sunSubTreeView -- DisplayString, sunSubTreeStatus INTEGER } sunSubTreeIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The index of the table registration." ::= { sunSubTreeConfigurationEntry 1 } sunSubTreeAgentID OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "ID of the sub-agent." ::= { sunSubTreeConfigurationEntry 2 } sunSubTreeOID OBJECT-TYPE SYNTAX OBJECT IDENTIFIER ACCESS read-write STATUS mandatory DESCRIPTION "The oid of the subtree table that is being registered. A sub agent can have multiple sub tree oid's registered as seperate enteries." ::= { sunSubTreeConfigurationEntry 3 } sunSubTreeStartColumn OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "Starting column of the sub table." ::= { sunSubTreeConfigurationEntry 4 } sunSubTreeEndColumn OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "Ending column of the sub table." ::= { sunSubTreeConfigurationEntry 5 } sunSubTreeStartRow OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "Starting row of the sub table." ::= { sunSubTreeConfigurationEntry 6 } sunSubTreeEndRow OBJECT-TYPE SYNTAX INTEGER ACCESS read-write STATUS mandatory DESCRIPTION "Ending row of the sub table." ::= { sunSubTreeConfigurationEntry 7 } sunSubTreeStatus OBJECT-TYPE SYNTAX INTEGER { active(1), inactive(2) } ACCESS read-write STATUS mandatory DESCRIPTION "The variable allows to activate or delete the enteries in this table." ::= { sunSubTreeConfigurationEntry 8 } -- -- ********** RegTreeTable **************** -- sunSubTreeDispatchTable OBJECT-TYPE SYNTAX SEQUENCE OF SunSubTreeDispatchEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "This table lists all the OID enteries that are used by the master agent to dispatch the requests to the sub agents. This table is based on the sub-tree registration configured in the sub agents registration files." ::= { sunSeaProxyMIB 12 } sunSubTreeDispatchTableIndex OBJECT-TYPE SYNTAX INTEGER (0..65535) ACCESS read-only STATUS mandatory DESCRIPTION "The next available index in sunSubTreeDispatchTable." ::= { sunSeaProxyMIB 13 } -- -- ************** Dispatch Table ************ -- sunSubTreeDispatchEntry OBJECT-TYPE SYNTAX SunSubTreeDispatchEntry ACCESS not-accessible STATUS mandatory DESCRIPTION "An entry for tree registration." INDEX { sunSubTreeDispatchAgentID, sunSubTreeDispatchIndex } ::= { sunSubTreeDispatchTable 1 } SunSubTreeDispatchEntry ::= SEQUENCE { sunSubTreeDispatchIndex INTEGER, sunSubTreeDispatchAgentID INTEGER, sunSubTreeDispatchOID OBJECT IDENTIFIER, sunSubTreeDispatchStatus INTEGER } sunSubTreeDispatchIndex OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "The index of the dispatch table entry." ::= { sunSubTreeDispatchEntry 1 } sunSubTreeDispatchAgentID OBJECT-TYPE SYNTAX INTEGER ACCESS read-only STATUS mandatory DESCRIPTION "" ::= { sunSubTreeDispatchEntry 2 } sunSubTreeDispatchOID OBJECT-TYPE SYNTAX OBJECT IDENTIFIER ACCESS read-write STATUS mandatory DESCRIPTION "The oid of the subtree." ::= { sunSubTreeDispatchEntry 3 } sunSubTreeDispatchStatus OBJECT-TYPE SYNTAX INTEGER { active(1), inactive(2) } ACCESS read-write STATUS mandatory DESCRIPTION "The variable allows to activate or delete the enteries in this table." ::= { sunSubTreeDispatchEntry 4 } END