SNMP monitoring
Overview
The player supports SNMP version 2c with read-only access, does not generate SNMP traps, and uses Net-SNMP 5.4 with all applicable security fixes.
The access to SNMP is disabled (closed) by default for security reasons; if needed, it can be opened for access via UDP and TCP either to a specific IPv4 address range or without restrictions (includes IPv6 addresses). This is done from Control Center on:
- the Network settings → SNMP page for DSOS players;
- the Network Settings page → SNMP tab for HMP200, HMP130, and HMP100 devices.
Starting with firmware 4.7.6, the SNMP functionality is available on DiVA players and no longer requires a Feature Set on DSOS players. Starting with DSOS 5.0.0, players provide a SpinetiX-specific MIB for retrieving the DSOS version, device serial numbers, operating mode, boot counter, and other device information in a structured format.
MIBs
The Private Enterprise Number (PEN) assigned to SpinetiX is 29888. The corresponding enterprise OID is 1.3.6.1.4.1.29888, under the standard private-enterprise prefix 1.3.6.1.4.1.
Starting with DSOS 5.0.0, players provide the following SpinetiX MIB modules in addition to the standard MIBs:
SPINETIX-SMI-MIB– defines the SpinetiX enterprise OID tree.SPINETIX-PRODUCTS-MIB– defines the product OIDs used bysysObjectID.SPINETIX-DSOS-MIB– exposes DSOS-specific device information.
The following standard MIBs are also available, classified by type of information. Where applicable, the defining RFC is indicated.:
- System uptime and identification information
- SNMPv2-MIB (RFC 3418)
- System resources information
- HOST-RESOURCES-MIB (RFC 2790)
- System uptime, identification, I/O, and general network information
- RFC1213-MIB (RFC 1213)
- UCD-DISKIO-MIB
- System-level statistics
- UCD-SNMP-MIB
- Network MIBs
- IF-MIB (RFC 2233)
- IP-MIB (RFC 4293)
- IPV6-MIB (RFC 4293)
- IP-FORWARD-MIB (RFC 4292)
- TCP-MIB (RFC 4022)
- UDP-MIB (RFC 4113)
- Additional MIBs
- MTA-MIB (RFC 2789)
- UCD-DLMOD-MIB
- DISMAN-EVENT-MIB (RFC 2981)
- NET-SNMP-AGENT-MIB
- NET-SNMP-EXTEND-MIB
- NET-SNMP-VACM-MIB
- NOTIFICATION-LOG-MIB (RFC 3014)
- SNMP-FRAMEWORK-MIB (RFC 3411)
- SNMP-MPD-MIB (RFC 3412)
- SNMP-TARGET-MIB (RFC 3413)
- SNMP-USER-BASED-SM-MIB (RFC 3414)
- SNMP-VIEW-BASED-ACM-MIB (RFC 3415)
Particular OIDs
System information
The following objects from SNMPv2-MIB provide basic player identification and system information.
sysDescr.0(1.3.6.1.2.1.1.1.0)- Contains the manufacturer and device model.
- Starting with DSOS 5.0.0, it also contains the complete DSOS version.
- Example:
SNMPv2-MIB::sysDescr.0 = STRING: SpinetiX HMP400, DSOS 5.0.0-1.0.0-ae51358f
sysObjectID.0(1.3.6.1.2.1.1.2.0)- Identifies the player model using an object defined in
SPINETIX-PRODUCTS-MIB.
| Player | MIB object | Numeric OID |
|---|---|---|
| HMP100 | SPINETIX-PRODUCTS-MIB::spinetixHmp100
|
1.3.6.1.4.1.29888.1.1
|
| HMP130 | SPINETIX-PRODUCTS-MIB::spinetixHmp130
|
1.3.6.1.4.1.29888.1.2
|
| HMP200 | SPINETIX-PRODUCTS-MIB::spinetixHmp200
|
1.3.6.1.4.1.29888.1.3
|
| HMP300 | SPINETIX-PRODUCTS-MIB::spinetixHmp300
|
1.3.6.1.4.1.29888.1.4
|
| HMP350 | SPINETIX-PRODUCTS-MIB::spinetixHmp350
|
1.3.6.1.4.1.29888.1.5
|
| DiVA | SPINETIX-PRODUCTS-MIB::spinetixDiva
|
1.3.6.1.4.1.29888.1.6
|
| DSOS on third-party hardware | SPINETIX-PRODUCTS-MIB::spinetixDsosGeneric
|
1.3.6.1.4.1.29888.1.7
|
| HMP400 | SPINETIX-PRODUCTS-MIB::spinetixHmp400
|
1.3.6.1.4.1.29888.1.8
|
| HMP400W | SPINETIX-PRODUCTS-MIB::spinetixHmp400w
|
1.3.6.1.4.1.29888.1.9
|
| iBX410 | SPINETIX-PRODUCTS-MIB::spinetixIbx410
|
1.3.6.1.4.1.29888.1.10
|
| iBX440 | SPINETIX-PRODUCTS-MIB::spinetixIbx440
|
1.3.6.1.4.1.29888.1.11
|
| iBX410W | SPINETIX-PRODUCTS-MIB::spinetixIbx410w
|
1.3.6.1.4.1.29888.1.12
|
sysName.0(1.3.6.1.2.1.1.5.0)- Contains the player hostname.
- Example:
SNMPv2-MIB::sysName.0 = STRING: spx-hmp-001d502000b2
sysServices.0(1.3.6.1.2.1.1.7.0)- Set to
72, indicating that the player is a network node providing application services.
DSOS-specific information
Starting with DSOS 5.0.0, SPINETIX-DSOS-MIB exposes DSOS-specific information under the enterprise subtree 1.3.6.1.4.1.29888.3.
All objects in this MIB are read-only scalars.
| Object | Numeric OID | Description |
|---|---|---|
dsosVersion.0
|
1.3.6.1.4.1.29888.3.1.1.0
|
Complete DSOS firmware version. |
dsosSerialNumber.0
|
1.3.6.1.4.1.29888.3.1.2.0
|
Device serial number as presented to the user. |
dsosServiceSerialNumber.0
|
1.3.6.1.4.1.29888.3.1.3.0
|
Internal serial number used for service requests. This is identical to dsosSerialNumber on models that do not have a separate user-facing serial number.
|
dsosMode.0
|
1.3.6.1.4.1.29888.3.1.4.0
|
Current operating mode: normal(1), safe(2), or recovery(3).
|
dsosBootCounter.0
|
1.3.6.1.4.1.29888.3.1.5.0
|
Counter increased by one whenever the device boots. It is reset after a model-dependent delay if no abnormal restart occurs, and when the device restarts or shuts down cleanly. |
dsosBootCounterResetDelay.0
|
1.3.6.1.4.1.29888.3.1.6.0
|
Delay, in seconds, after which dsosBootCounter is automatically reset to zero.
|
dsosBootCounterVolatile.0
|
1.3.6.1.4.1.29888.3.1.7.0
|
Indicates whether dsosBootCounter is reset to zero following a power loss: true(1) or false(2).
|
For example:
$ snmpwalk -m +ALL -M +./MIB -v2c -c public <player> spinetix
SPINETIX-DSOS-MIB::dsosVersion.0 = STRING: 5.0.0-1.0.0-ae51358f
SPINETIX-DSOS-MIB::dsosSerialNumber.0 = STRING: 001d5020001a
SPINETIX-DSOS-MIB::dsosServiceSerialNumber.0 = STRING: 001d5020001a
SPINETIX-DSOS-MIB::dsosMode.0 = INTEGER: normal(1)
SPINETIX-DSOS-MIB::dsosBootCounter.0 = INTEGER: 1
SPINETIX-DSOS-MIB::dsosBootCounterResetDelay.0 = INTEGER: 1800
SPINETIX-DSOS-MIB::dsosBootCounterVolatile.0 = INTEGER: true(1)
Without the SpinetiX MIB definitions installed on the monitoring system, the same objects can be queried using their numeric OIDs.
Note: