3.4.1 Understanding the Proprietary Hardware Information (HWINF) MIB Module

The proprietary Hardware Information MIB module provides a board inventory table and general parameters regarding the Intel Dialogic system services. This module permits the monitoring of board status changes and provides board status change notification using SNMP traps. It also provides the capability to start or stop individual Intel NetStructure boards and to start or stop all boards in the system.

The Hardware MIB module contains the following groups:

• MIB Revision Group (dlgHiMibRev)
• OS Common Group (dlgHiOsCommon)
• Board Identification Group (dlgHiIdent)

3.4.1.1 MIB Revision Group (dlgHiMibRev)

This group contains general revision and condition information and is comprised of:

• major revision number (dlgHiMibRevMajor): Indicates the major revision of the HWINF MIB module. This revision will always return '1'.
• minor revision number (dlgHiMibRevMinor): Indicates the minor revision of the HWINF MIB module. This revision will always return '2'.
• dlgHiMibCondition: Indicates the MIB status for this module. It will indicate ok if the MIB module can function properly or failed otherwise. When the agent starts up, this object initially indicates failed until the agent completes self-initialization.

3.4.1.2 OS Common Group (dlgHiOsCommon)

This group contains the following scalar objects and tables:

• Common Polling Frequency (dlgHiOsCommonPollFreq): This scalar object controls the global poll frequency. The current implementation of the SNMP agents does not support this variable, and setting its value to a new frequency has no effect on the run-time state of the agents.
• Common Module Table (dlgHiOsCommonModuleTable): This table contains a row entry for installed software modules used to control boards. It has read-only attribute columns that describe the module attributes (module name, module version, module date, and module purpose/description).
• Number of Modules (dlgHiOsCommonNumberofModules): Indicates the number of rows present in the Common Module Table.
• Log Enable (dlgHiOsLogEnable): This scalar object is not implemented. Network management stations (NMS) or other SNMP managers should handle logging any trap or status changes.
• Test Trap Enable (dlgHiOsTestTrapEnable): Setting this scalar object to '1' causes the SNMP agent to send a test trap to all configured trap destinations (for instructions on how to configure trap destinations, see the Configuration Guide for the Intel NetStructure products). Reading this object always returns '0' as result.

3.4.1.3 Board Identification Group (dlgHiIdent)

This group contains the following scalar objects and tables:

• Board Identification Table (dlgHiIdentTable)
• Board Identification Table Size (dlgHiIdentNumberOfDevices)
• Service Status Object
• Service Change Date
• Global Trap Mask

The following information describes each item:

Board Identification Table (dlgHiIdentTable)

The Board Identification Table contains a row entry for each board device installed on the managed node. It has read-only attribute columns that describe the board attributes (IRQ, firmware name, serial number, etc.) and the board operational status. It has mutable columns that describe the board administrative status and that allow the user to start, stop, or cause a board to perform self-diagnostics.

The following are the columns in the Board Identification Table:

• board index (dlgHiIdentIndex): This column contains the indices for this table. All SNMP tables have one or more indices that uniquely identify the row in which they belong. Performing a get on this column should always return the same value as the row requested. For example,
  snmp get dlgHiIdentIndex.2
returns 2
• model name (dlgHiIdentModel): This column contains the string name of the board model for each board in the table.
• family type (dlgHiIdentType): This column indicates the CT family type for each board.
• functional description (dlgHiIdentFuncDesc): For each board, this column contains a short description of its purpose.
• serial number (dlgHiIdentSerNum): This column contains the unique serial number assigned to each board by the Intel Dialogic system release software.
• firmware name (dlgHiIdentFWName): This column contains the firmware file name for each board in the table.
• firmware version (dlgHiIdentFWVers): This column contains the firmware version for each board in the table.
• base memory address (dlgHiIdentMemBaseAddr): This column contains the memory address for each board's shared RAM space.
• base I/O address (dlgHiIdentIOBaseAddr): This column contains the I/O address for each board that supports this style of interface.
• interrupt request number (dlgHiIdentIRQ): This column contains each board's IRQ number.
• board ID (dlgHiIdentBoardID): This column contains each board's board ID. For Intel NetStructure on DM3 architecture boards, the board ID is the logical board number. For Intel NetStructure IPT series boards, the board ID is the driver board ID. For Intel Dialogic Springware boards, the board ID is the ID selected from the on-board thumbwheel or the assigned board ID for PCI boards.
• PCI slot number (dlgHiIdentPCISlotID): For each PCI board, this column contains the PCI slot number at which the board is installed. Non-PCI boards return -1 in this column.
• PCI bus number (dlgHiIdentPCIBusID): For each PCI board, this column contains the PCI bus number at which the board is installed. Non-PCI boards return -1 in this column.
• operational status (dlgHiIdentOperStatus): This column contains the operational status of each board. The operational status can indicate a failed or ok status. If this column indicates ok, then the board is working normally and has responded to all requests as expected. If this column indicates failed, then the board is not operating normally and something has caused it to enter a potentially dangerous state. Two conditions exist to cause operational status to indicate a failed status: the board has stopped responding to routine ping messages or the board was instructed to start or stop using the administrative status column, and it has failed to do so. In general, a board that is indicating a failed status, should be restarted. If the problem persists, the board should be replaced.
• administrative status (dlgHiIdentAdminStatus): Administrative status uses two groups of values. The first group is used to indicate the present condition of the board. The possible values are started, stopped, and diagnose. The state of the board is diagnose while the diagnostic is running.

  Note: If a board is in the process of starting or stopping, it will always indicate the state from which it is coming from until the operation is complete.

  The second group is made up of three values that are used to change the board state using set operations. These states are start-pending, stop-pending, and diagnose. When a board is in a stopped state, and its administrative status value is set to start-pending, the SNMP agent will attempt to start the board. When a board is in a started state, and its administrative status value is set to stop-pending, the SNMP agent will attempt to stop the board. If either operation fails, the board's operational status (see below) will indicate failed and the administrative status will stay at the old value. The diagnose state is used to cause a stopped board to run a power-on-self-test (POST). Once in the diagnose state, the board cannot be stopped or started until the POST has completed. When the diagnostics complete, the board is placed back into the stopped state, and the diagnostic results are stored in the Board Error Message column (see below).

  Note: Only Intel NetStructure boards support these read/write states. Intel Dialogic Springware boards will reject any requests to stop and start individual boards.

  All transitions in administrative status, except those that are the direct result of a set, cause a trap. So the transition from stopped to diagnose as the result of a set does not cause a trap. The transition from diagnose to stopped when the diagnostic finishes does cause a trap.

• device change date (dlgHiIdentDeviceChangeDate): This column indicates the time and date (in 7-octet format) of when the administrative status of the board last changed.
• specific group OID (dlgHiIdentSpecific): Not used in a meaningful way in this system release.
• board error message (dlgHiIdentErrorMsg): This column is used to indicate the last error message for each board. Primarily, it is used to store the results in textual format of a dm3post operation (administrative status diagnose state). Refer to the system release software Diagnostics Guide for details on dm3post.

Board Identification Table Size (dlgHiIdentNumberOfDevices)

This scalar object is type INTEGER and returns the number of boards installed and configured on the managed node. This number corresponds directly with the number of rows present in the Board Identification Table (dlgHiIdentTable). A value of zero indicates that no boards have been installed or configured.

Service Status Object

This scalar object is used to control the entire Intel Dialogic system release software run-time state (i.e., the software program is stopped or started). When it indicates stopped, the Intel Dialogic run time has not been started. When it indicates started, the Intel Dialogic run time is loaded and running.

An SNMP manager may set the value of this object to change the run time state of the Intel Dialogic system release software. When the manager sets the value to started, the Intel Dialogic system release software will start and initialize. All configured boards will be downloaded. When the manager sets the value to stopped, the Intel Dialogic system release software will be stopped and unloaded.

Service Change Date

This scalar object indicates the last time in which the system service was started or stopped though the Service Status Object (dlgHiIdentServiceStatus). The result is in 7-octet format described in the MIB specification.

Global Trap Mask

This scalar object is not implemented and setting its value has no effect.

Click here to contact Telecom Support Resources