Actions

SNMP: Difference between revisions
(Changed to global configuration)
 
(153 intermediate revisions by 14 users not shown)
Line 1: Line 1:
Simple Network Management Protocol (SNMP) is, according to Wikipedia, "used in network management systems to monitor network-attached devices for conditions that warrant administrative attention."  
The Simple Network Management Protocol (SNMP) is used in network management systems to monitor attached hardware for changes in operation activity. SNMP provides a standardized approach to monitoring and managing network systems.
 
<br/><br/>For information on configuring your TMedia product to use the SNMP protocol, see the section labeled [[SNMP#Related Tasks|"'''Related Tasks'''"]].
<br>  
<br/>
 
== TelcoBridges and SNMP  ==
== TelcoBridges and SNMP  ==
TelcoBridges offers support for SNMP versions 1, 2, and 3.  This grants users the ability to remotely poll (or GET) system variables, known as Managed Objects, which are represented in files known as MIB modules.  TelcoBridges currently offers polling on '''standard''' MIB modules (RTP, SONET, DS1, DS3, ISDN, etc...) and on the TelcoBridges '''privately defined''' module ([[TB-MIB|'''TB-MIB''']]).<br>
<br/>
== Supported SNMP MIB modules ==
#[http://tools.ietf.org/html/rfc1213 RFC 1213 MIB II (RFC1213-MIB)]
#*All tables of the RFC1213-MIB are supported, '''with the exception of''':
#**ipRouteTable
#**EGP group
#**atTable
#[http://tools.ietf.org/html/rfc1573.txt RFC 1573 Evolution of Interfaces Group of MIB-II (IF-MIB)]
#*The following tables are supported:
#**ifTable
#**ifStackTable
#[http://tools.ietf.org/html/rfc2495 RFC 2495 DS1, J1, E1, DS2, and E2 Interfaces (DS1-MIB)]
#*The following tables of the DS1-MIB are supported:
#**Dsx1ConfigTable
#**Dsx1CurrentTable
#**Dsx1IntervalTable
#**Dsx1TotalTable
#[http://tools.ietf.org/html/rfc2496 RFC 2496 - Definitions of Managed Object for the DS3/E3 Interface Type (DS3-MIB)]
#*The following tables of the DS3-MIB are supported:
#**Dsx3ConfigTable
#**Dsx3CurrentTable
#**Dsx3IntervalTable
#**Dsx3TotalTable
#[http://tools.ietf.org/html/rfc1595 RFC 1595 - Definitions of Managed Object for the SONET/SDH Interface Type (SONET-MIB)]
#*The following tables of the SONET-MIB are supported:
#**sonetMediumTable
#**sonetSectionCurrentTable
#**sonetSectionIntervalTable
#**sonetLineCurrentTable
#**sonetLineIntervalTable
#**sonetFarendLineCurrentTable
#**sonetFarendLineIntervalTable
#**sonetPathCurrentTable
#**sonetPathIntervalTable
#**sonetFarendPathCurrentTable
#**sonetFarendPathIntervalTable
#**sonetVtCurrentTable
#**sonetVtIntervalTable
#**sonetFarendVtCurrentTable
#**sonetFarendVtIntervalTable
#[http://tools.ietf.org/html/rfc2127 RFC 2127 - ISDN Management Information Base using SMIv2 (ISDN-MIB)]
#*The following tables of the ISDN-MIB are supported:
#**isdnBearerGroup
#**isdnSignalingGroup
#[[TB-MIB|Telcobridges Private MIB module (TB-MIB)]]
#*tbHwCommon
#**tbHwIdentTable (Hardware Identification)
#**tbHwVersionTable (Hardware Version)
#**tbHwTempTable (Hardware Temperature)
#**tbHwPowerSupplyTable (Hardware Power Supply)
#**tbHwFanTable (Hardware Fan)
#*tbSwCommon
#**tbFeatureTable (Software Features Supported)
#**tbSwVersionTable (Software Version)
#**tbSwPerfTable (CPU Usage)
#*tbSignaling
#**tbMtp2
#**tbM2pa
#**tbM2ua
#**tbM3ua
#**tbIua
#**tbIsdn
#**tbCas
#**tbSip
#**tbH248
#*tbCalls
#*tbNAP
#*tbHaNp1
#*tbHaApp
#*tbClock


TelcoBridges offers basic SNMP support (SNMP v1). Specifically, this is the ability to remotely poll or “GET” system variables known as Managed Objects, which are represented in files known as MIBs. TelcoBridges currently offers polling on a limited number of well-known MIBs (RTP, Sonet, Trunk etc.) as well as some proprietary MIBs (SW version, release, temperature sensors), etc.). However, SNMP 'traps' (i.e., alarms) are not supported in the current release, nor is the ability to 'SET' system variables (defined in SNMP v2).
=== SNMP IF-MIB ifTable interface type ===
 
The following table provides the interfaces type supported by TelcoBridges (IF-MIB ifTable described in [https://tools.ietf.org/html/rfc1573 RFC1573]) with their corresponding description. The ifType are described in Internet Assigned Number Authority (IANA) in [http://www.iana.org/assignments/ianaiftype-mib IANAifType-MIB]
As of September 2010, TelcoBridges is actively investigating the implementation SNMP v2 support, including GET support as well as alarms/traps at the level of Toolpack.
{| cellpadding="0" border="0" style="width: 820px;" class="wikitable"
 
|-
The list of MIBs currently exposed by the TMedia gateways are:
! IANA ifType
 
! TelcoBridges Interface description
*[http://www.ietf.org/rfc/rfc1213.txt RFC 1213 MIB II]
|-
 
| ethernetCsmacd(6)
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; With the exception of ipRouteTable, EGP group, atTable which are not implemented.
| Baseboard Ethernet interfaces
 
|-
*[http://www.ietf.org/rfc/rfc1533.txt RFC 1573]
| ds1(18)
| Trunks Line Interface
|-
| ds3(30)
| DS3 Line Interface
|-
| sonet(39)
| SONET/SDH Line Interface
|-
| sonetPath(50)
| SONET/SDH Line Service PATH (VC4/VC3/STS1/DS3)
|-
| sonetVT(51)
| SONET/SDH Line Service SECTION (VC11/VC12/VT15/VT2)
|-
| isdn(63)
| ISDN Stack
|-
| lapd(77)
| ISDN LAPD Link (Primary)
|-
| lapd(77)
| ISDN LAPD Link (Backup)
|-
| isdn(63)
| IUA Link
|-
| isdn(63)
| IUA Peer
|-
| lapd(77)
| LAPD Link
|-
| ss7SigLink (156)
| SS7 M2PA Link
|-
| ss7SigLink (156)
| SS7 M2UA Link
|-
| ss7SigLink (156)
| SS7 M2UA Peer
|-
| ss7SigLink (156)
| Ss7 M3ua Sap
|-
| ss7SigLink (156)
| Ss7 M3ua Psp
|-
| ss7SigLink (156)
| Ss7 M3ua Psrv
|-
| ss7SigLink (156)
| Ss7 Mtp2 Link
|}


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; With the exception of ipRouteTable, EGP group, atTable which are not implemented.  
=== SNMP traps ===
The '''SNMP traps''' module of TelcoBridges products monitor the operation status of some MIBS OIDs and generates notifications when the states change. The default monitoring polling period is set to 1 minute. This value can be modified in the [[SNMP#Configuration|SNMP configuration]].


*[http://www.rfc-editor.org/rfc/rfc2959.txt RFC 2959 Real-Time Transport Protocol Management Information Base]<br>
====SNMP Trap/Notification====


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; The following tables are supported: rtpSessionTable, rtpSenderTable, rtpRcvrTable.<br>
{| cellpadding="0" border="0" style="width: 1200px;" class="wikitable"
|-
! Trap Name
! MIB
! OID
! OBJECTS
! CONSIDERED AS AN ALARM
! RFC
! RELEASE
|-
| linkDown
| IF-MIB
| 1.3.6.1.6.3.1.1.5.3
| { ifIndex, ifAdminStatus, ifOperStatus, ifDescr }
| When ifAdminStatus=1 & ifOperStatus=2, In certain conditions could be critical, this trap should raise an alarm.
| RFC1573
| 2.8+
|-
| linkUp
| IF-MIB
| 1.3.6.1.6.3.1.1.5.4
| { ifIndex, ifAdminStatus, ifOperStatus, ifDescr }
| Transition from network interface Down state. Normal clear trap for linkDown alarm
| RFC1573
| 2.8+
|-
| ColdStart
| IF-MIB
| 1.3.6.1.6.3.1.1.5.1
| { OID }
| This is sent when snmp service is started. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard.
| RFC3418
| 3.2+
|-
| WarmStart
| IF-MIB
| 1.3.6.1.6.3.1.1.5.2
| { OID }
| This is sent when snmp service is restarted. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard.
| RFC3418
| 3.2+
|-
| nsNotifyStart
| NET-SNMP-MIB
| 1.3.6.1.4.1.8072.4.0.1
| { OID }
| This is sent when snmp service is started. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard.
| www.net-snmp.org
| 3.2+
|-
| nsNotifyShutdown
| NET-SNMP-MIB
| 1.3.6.1.4.1.8072.4.0.2
| { OID }
| This is sent when snmp service is stopped. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard.
| www.net-snmp.org
| 3.2+
|-
| nsNotifyRestart
| NET-SNMP-MIB
| 1.3.6.1.4.1.8072.4.0.3
| { OID }
| This is sent when snmp service is restarted. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard.
| www.net-snmp.org
| 3.2+
|}


*[http://www.rfc-editor.org/rfc/rfc2495.txt RFC 2495 DS1, E1, DS2 and E2 Interfaces]
====[[TB-MIB|TB-MIB SNMP Trap/Notification]]====


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; The following tables are supported: Dsx1ConfigTable, Dsx1CurrentTable, Dsx1IntervalTable, Dsx1TotalTable.<br>  
{| cellpadding="0" border="0" style="width: 820px;" class="wikitable"
|-
! Trap Name
! Details
! OID
! OBJECTS
! CONSIDERED AS AN ALARM
! RELEASE
|-
| tbNapAvailability
| The network access point has a new percentage of availability for calls
# For TDM networks (tbNapSignalingType='''isdn'''(1), '''ss7'''(2), '''casr2'''(6)) this means there are a percentage of channels available for calls. ss7 includes sigtran signaling type.<br/>
# For SIP networks (tbNapSignalingType='''sip'''(3)), this means the remote SIP device is answering or not SIP OPTIONS polling messages and calls can be or can`t be made to this network.<br/>
# When using H.248 (tbNapSignalingType='''tdmMedia'''(5), '''voipMedia'''(4)) this means there are TDM channels or RTP ports available or not for calls.
| 1.3.6.1.4.1.21776.1.1.2.1.0.1
| { tbNapName, tbNapSignalingType, tbNapAvailablePercent }
| When tbNapAvailablePercent=0
| 2.8+
|-
| tbPwrSupplyState
| The redundant power supply has a new state.<br/><br/>tbHwPwrSupplyStatus can be: <br/>'''good'''(0)<br/>'''failure'''(1)
| 1.3.6.1.4.1.21776.1.1.2.1.0.2
| { tbHwPwrSupplyName, tbHwPwrSupplyStatus }
| When tbHwPwrSupplyStatus=1
| 2.8+
|-
| tbNp1State
| The N+1 patch panel has a new state.<br/><br/>tbHaNp1FunctionalState can be: <br/>'''unknown'''(-1)<br/>'''fault'''(0): There is no access to the N+1 patch panel<br/>'''unprotected'''(1): Standby unit is not available<br/>'''unprotectedSwitched'''(2): Standby unit is active and replaced primary unit is not ready to take over<br/>'''healthy'''(3): N+1 unit is normal and standby unit is available<br/>'''healthySwitched'''(4): N+1 unit is switched to the standby unit and replaced primary is available
| 1.3.6.1.4.1.21776.1.1.2.1.0.3
| { tbHaNp1Name, tbHaNp1FunctionalState }
| When tbHaNp1FunctionalState=0 OR tbHaNp1FunctionalState=1 OR tbHaNp1FunctionalState=2, it is major.
| 2.8+
|-
| tbAppState
| This toolpack application has a new state.<br/><br/>tbHaAppCurrentState can be:<br/>'''unknown'''(100)<br/>'''notRunning'''(101)<br/>'''starting'''(102)<br/>'''ready'''(103)<br/>'''shuttingDown'''(104)<br/>'''goingManagement'''(105)<br/>'''fault'''(106)
| 1.3.6.1.4.1.21776.1.1.2.1.0.4
| { tbHaAppName, tbHaAppCurrentState, tbHaAppHostName }
| All tbHaAppCurrentState states are alarms except 103
| 2.8+
|-
| tbAppHaState
| This toolpack high availability application has changed state.<br/><br/>tbHaAppHaCurrentState can be:<br/>'''notPresent'''(0)<br/>'''active'''(1)<br/>'''standby'''(2)
| 1.3.6.1.4.1.21776.1.1.2.1.0.5
| { tbHaAppName, tbHaAppHaCurrentState, tbHaAppHostName }
| Normal starting process of services will begin with tbHaAppHaCurrentState with value 0 (notPresent), going to Value 2 (standby) to finally Value 1 (active). Consider as an alarm if tbHaAppHaCurrentState of services stay consistently in others states different than 1, this applies for standalone and 1+1 systems.
| 2.8+
|-
| tbClkGradeState
| The network synchronization clock from this interface has a new grade.<br/><br/>tbClockType can be:<br/>'''none'''(1)<br/>'''osc'''(2)<br/>'''trunk'''(3)<br/>'''netRef1'''(4)<br/>'''netRef2'''(5)<br/>'''ptmc1'''(6)<br/>'''ptmc2'''(7)<br/>'''ct8a'''(8)<br/>'''ct8b'''(9)<br/>'''mbl'''(10)<br/>'''bits'''(11)<br/>'''ds3'''(12)<br/>'''sonetSdh'''(13)<br/>'''holdover'''(14)<br/><br/>tbClockGrade can be:<br/>'''unqualified'''(0)<br/>'''beingQualified'''(1)<br/>'''qualified'''(2)<br/>'''qualifiedForRecovery'''(3)
| 1.3.6.1.4.1.21776.1.1.2.1.0.6
| { tbClockName, tbClockType, tbClockGrade }
| When Object 'tbClockGrade=0' or 'tbClockGrade=1' <br/>Cleared by 'tbClockGrade=2' or 'tbClockGrade=3'
| 2.8+
|-
| tbClkActiveState
| This interface has been selected or not to provide the network synchronization clock for the whole system.<br/><br/>tbClockActive can be:<br/>'''no'''(0)<br/>'''yes'''(1)
| 1.3.6.1.4.1.21776.1.1.2.1.0.7
| { tbClockName, tbClockType, tbClockActive }
| When <b>ALL OBJECTS</b> report tbClockActive=0
| 2.8+
|-
| tbIsdnDChannelState
| The signaling channel for this ISDN interface has changed.<br/><br/>tbIsdnDChannelUp can be:<br/>'''no'''(0)<br/>'''yes'''(1)
| 1.3.6.1.4.1.21776.1.1.2.1.0.8
| { tbIsdnDescription, tbIsdnDChannelUp }
| When tbIsdnDChannelUp=0
| 2.8+
|-
| tbCASPhysicalLineState
| The interface for this CAS stack has changed.<br/><br/>tbCasPhysicalLineUp can be:<br/>'''no'''(0)<br/>'''yes'''(1)
| 1.3.6.1.4.1.21776.1.1.2.1.0.9
| { tbCasDescription, tbCasPhysicalLineUp }
| When tbCasPhysicalLineUp=0
| 2.8+
|-
| tbSipState
| The SIP stack state has changed.<br/><br/>tbSipCurrentState can be:<br/>'''no'''(0)<br/>'''yes'''(1)
| 1.3.6.1.4.1.21776.1.1.2.1.0.10
| { tbSipDescription, tbSipCurrentState }
| When tbSipCurrentState=0
| 2.8+
|-
| tbH248MgcState
| The H.248 communication state between this unit and the Media Gateway Controller has changed.<br/><br/>tbH248MgcCurrentState can be:<br/>'''up'''(1)<br/>'''down'''(2)<br/>'''unknown'''(3)
| 1.3.6.1.4.1.21776.1.1.2.1.0.11
| { tbH248MgcName, tbH248MgcCurrentState }
| When tbH248MgcCurrentState=2 OR tbH248MgcCurrentState=3
| 2.8+
|-
| tbHostUpdateAvailableState
| The availability state of the host update has changed.<br/><br/>tbHostUpdateAvailable can be:<br/>'''false'''(0)<br/>'''true'''(1)<br/>'''notSupported'''(2)<br/>'''unknown'''(3)<br/>'''disabled'''(4)
| 1.3.6.1.4.1.21776.1.1.2.1.0.12
| { tbHostName, tbHostUpdateAvailable }
| '''__'''
| 2.8+
|}


*[http://www.rfc-editor.org/rfc/rfc2496.txt RFC 2496 - Definitions of Managed Object for the DS3/E3 Interface Type]
<br>Example of packet capture:
tcpdump port 162 -i mgmt0 -s 0
tcpdump: verbose output suppressed, use -v or -vv for full protocol decode
listening on mgmt0, link-type EN10MB (Ethernet), capture size 65535 bytes
14:08:51.491789 IP 10.7.0.13.37452 > 10.7.0.221.snmptrap: V2Trap(144) system.sysUpTime.0=9546160 S:1.1.4.1.0=S:1.1.5.4
interfaces.ifTable.ifEntry.ifIndex.452160.26=26 interfaces.ifTable.ifEntry.ifAdminStatus.452160.26=1
interfaces.ifTable.ifEntry.ifOperStatus.452160.26=1  S:1.1.4.3.0=E:8072.3.2.10


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; The following tables are supported: Dsx3ConfigTable, Dsx3CurrentTable, Dsx3IntervalTable, Dsx3TotalTable<br>
== Note ==
The '''ifIndex''' is a random value that can change after configuring the system, or adding new elements.  This should not be relied on as a reference value. Please use the '''ifDescr''' instead.


*[http://www.rfc-editor.org/rfc/rfc1595.txt RFC 1595 - Definitions of Managed Object for the SONET/SDH Interface Type]
=== SNMP SET ===
The '''SNMP SET''' command is not supported by TelcoBridges products. However, a [[Northbound_interface:RESTful|RESTful API]] can be used to change the configuration remotely.


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; The following tables supported: sonetMediumTable, sonetSectionCurrentTable, sonetSectionIntervalTable, sonetLineCurrentTable, sonetLineIntervalTable, sonetFarendLineCurrentTable, sonetFarendLineIntervalTable, sonetPathCurrentTable, sonetPathIntervalTable, sonetFarendPathCurrentTable, sonetFarendPathIntervalTable, sonetVtCurrentTable, sonetVtIntervalTable, sonetFarendVtCurrentTable, sonetFarendVtIntervalTable <br>  
<br/>


*[http://www.rfc-editor.org/rfc/rfc2127.txt RFC 2127 - ISDN Management Information Base using SMIv2]
== Configuration ==


&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; The following tables supported: isdnBearerGroup, isdnSignalingGroup
*[[Toolpack:System_Settings_E#SNMP|Configuring SNMP]]


*[[Media:TB-MIB.txt|Telcobridges Private MIB]]
<div class="mw-collapsible mw-collapsed" data-collapsetext="other versions" data-expandtext="Click here for other versions" style="width: 400px;">
*[[Toolpack:System_Settings_D#SNMP|Configuring SNMP for version 3.0]]
*[[Toolpack:System_Settings_C#SNMP|Configuring SNMP for version 2.10]]
*[[Toolpack:System_Settings_B#SNMP|Configuring SNMP for version 2.9]]
*[[Toolpack:System_Settings_A#SNMP|Configuring SNMP for version 2.8]]
*[[tbSnmpAgent Configuration|Configuring SNMP for version 2.7]]
''The below procedures should be used to support SNMP v1 '''ONLY''' for '''Toolpack systems previous to 2.5.80''':
*[[Installing NetSNMP from an External Host]]
*[[TMG SNMP support|How to relay SNMP on TMG products]]
<br/>
</div>


== References  ==
== Helpful resources ==
*[[Npp_tools|Notepad ++ tools for SNMP]]


*[http://en.wikipedia.org/wiki/Simple_Network_Management_Protocol Wikipedia article]  
== External Sources  ==
*[[TMG SNMP support|How to relay SNMP on TMG products]]  
*[http://en.wikipedia.org/wiki/Simple_Network_Management_Protocol Wikipedia article on SNMP]
*[[How to start NTP|How to install and start NTP on TMG products]]<br>
*[http://www.net-snmp.org/ NetSNMP implementation of the SNMP protocol]
<br/><br/>  


<br>
[[Category:Glossary]]
[[Category:Revise on Major]]


[[Category:Glossary]] [[Category:Needs_revising]]
[[category:FAQ]]

Latest revision as of 09:26, 1 October 2025

The Simple Network Management Protocol (SNMP) is used in network management systems to monitor attached hardware for changes in operation activity. SNMP provides a standardized approach to monitoring and managing network systems.

For information on configuring your TMedia product to use the SNMP protocol, see the section labeled "Related Tasks".

TelcoBridges and SNMP

TelcoBridges offers support for SNMP versions 1, 2, and 3. This grants users the ability to remotely poll (or GET) system variables, known as Managed Objects, which are represented in files known as MIB modules. TelcoBridges currently offers polling on standard MIB modules (RTP, SONET, DS1, DS3, ISDN, etc...) and on the TelcoBridges privately defined module (TB-MIB).

Supported SNMP MIB modules

  1. RFC 1213 MIB II (RFC1213-MIB)
    • All tables of the RFC1213-MIB are supported, with the exception of:
      • ipRouteTable
      • EGP group
      • atTable
  2. RFC 1573 Evolution of Interfaces Group of MIB-II (IF-MIB)
    • The following tables are supported:
      • ifTable
      • ifStackTable
  3. RFC 2495 DS1, J1, E1, DS2, and E2 Interfaces (DS1-MIB)
    • The following tables of the DS1-MIB are supported:
      • Dsx1ConfigTable
      • Dsx1CurrentTable
      • Dsx1IntervalTable
      • Dsx1TotalTable
  4. RFC 2496 - Definitions of Managed Object for the DS3/E3 Interface Type (DS3-MIB)
    • The following tables of the DS3-MIB are supported:
      • Dsx3ConfigTable
      • Dsx3CurrentTable
      • Dsx3IntervalTable
      • Dsx3TotalTable
  5. RFC 1595 - Definitions of Managed Object for the SONET/SDH Interface Type (SONET-MIB)
    • The following tables of the SONET-MIB are supported:
      • sonetMediumTable
      • sonetSectionCurrentTable
      • sonetSectionIntervalTable
      • sonetLineCurrentTable
      • sonetLineIntervalTable
      • sonetFarendLineCurrentTable
      • sonetFarendLineIntervalTable
      • sonetPathCurrentTable
      • sonetPathIntervalTable
      • sonetFarendPathCurrentTable
      • sonetFarendPathIntervalTable
      • sonetVtCurrentTable
      • sonetVtIntervalTable
      • sonetFarendVtCurrentTable
      • sonetFarendVtIntervalTable
  6. RFC 2127 - ISDN Management Information Base using SMIv2 (ISDN-MIB)
    • The following tables of the ISDN-MIB are supported:
      • isdnBearerGroup
      • isdnSignalingGroup
  7. Telcobridges Private MIB module (TB-MIB)
    • tbHwCommon
      • tbHwIdentTable (Hardware Identification)
      • tbHwVersionTable (Hardware Version)
      • tbHwTempTable (Hardware Temperature)
      • tbHwPowerSupplyTable (Hardware Power Supply)
      • tbHwFanTable (Hardware Fan)
    • tbSwCommon
      • tbFeatureTable (Software Features Supported)
      • tbSwVersionTable (Software Version)
      • tbSwPerfTable (CPU Usage)
    • tbSignaling
      • tbMtp2
      • tbM2pa
      • tbM2ua
      • tbM3ua
      • tbIua
      • tbIsdn
      • tbCas
      • tbSip
      • tbH248
    • tbCalls
    • tbNAP
    • tbHaNp1
    • tbHaApp
    • tbClock

SNMP IF-MIB ifTable interface type

The following table provides the interfaces type supported by TelcoBridges (IF-MIB ifTable described in RFC1573) with their corresponding description. The ifType are described in Internet Assigned Number Authority (IANA) in IANAifType-MIB

IANA ifType TelcoBridges Interface description
ethernetCsmacd(6) Baseboard Ethernet interfaces
ds1(18) Trunks Line Interface
ds3(30) DS3 Line Interface
sonet(39) SONET/SDH Line Interface
sonetPath(50) SONET/SDH Line Service PATH (VC4/VC3/STS1/DS3)
sonetVT(51) SONET/SDH Line Service SECTION (VC11/VC12/VT15/VT2)
isdn(63) ISDN Stack
lapd(77) ISDN LAPD Link (Primary)
lapd(77) ISDN LAPD Link (Backup)
isdn(63) IUA Link
isdn(63) IUA Peer
lapd(77) LAPD Link
ss7SigLink (156) SS7 M2PA Link
ss7SigLink (156) SS7 M2UA Link
ss7SigLink (156) SS7 M2UA Peer
ss7SigLink (156) Ss7 M3ua Sap
ss7SigLink (156) Ss7 M3ua Psp
ss7SigLink (156) Ss7 M3ua Psrv
ss7SigLink (156) Ss7 Mtp2 Link

SNMP traps

The SNMP traps module of TelcoBridges products monitor the operation status of some MIBS OIDs and generates notifications when the states change. The default monitoring polling period is set to 1 minute. This value can be modified in the SNMP configuration.

SNMP Trap/Notification

Trap Name MIB OID OBJECTS CONSIDERED AS AN ALARM RFC RELEASE
linkDown IF-MIB 1.3.6.1.6.3.1.1.5.3 { ifIndex, ifAdminStatus, ifOperStatus, ifDescr } When ifAdminStatus=1 & ifOperStatus=2, In certain conditions could be critical, this trap should raise an alarm. RFC1573 2.8+
linkUp IF-MIB 1.3.6.1.6.3.1.1.5.4 { ifIndex, ifAdminStatus, ifOperStatus, ifDescr } Transition from network interface Down state. Normal clear trap for linkDown alarm RFC1573 2.8+
ColdStart IF-MIB 1.3.6.1.6.3.1.1.5.1 { OID } This is sent when snmp service is started. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard. RFC3418 3.2+
WarmStart IF-MIB 1.3.6.1.6.3.1.1.5.2 { OID } This is sent when snmp service is restarted. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard. RFC3418 3.2+
nsNotifyStart NET-SNMP-MIB 1.3.6.1.4.1.8072.4.0.1 { OID } This is sent when snmp service is started. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard. www.net-snmp.org 3.2+
nsNotifyShutdown NET-SNMP-MIB 1.3.6.1.4.1.8072.4.0.2 { OID } This is sent when snmp service is stopped. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard. www.net-snmp.org 3.2+
nsNotifyRestart NET-SNMP-MIB 1.3.6.1.4.1.8072.4.0.3 { OID } This is sent when snmp service is restarted. tbAppState and tbAppHaState already covers this case with tbsnmpagent. Please disregard. www.net-snmp.org 3.2+

TB-MIB SNMP Trap/Notification

Trap Name Details OID OBJECTS CONSIDERED AS AN ALARM RELEASE
tbNapAvailability The network access point has a new percentage of availability for calls
  1. For TDM networks (tbNapSignalingType=isdn(1), ss7(2), casr2(6)) this means there are a percentage of channels available for calls. ss7 includes sigtran signaling type.
  2. For SIP networks (tbNapSignalingType=sip(3)), this means the remote SIP device is answering or not SIP OPTIONS polling messages and calls can be or can`t be made to this network.
  3. When using H.248 (tbNapSignalingType=tdmMedia(5), voipMedia(4)) this means there are TDM channels or RTP ports available or not for calls.
 1.3.6.1.4.1.21776.1.1.2.1.0.1 { tbNapName, tbNapSignalingType, tbNapAvailablePercent } When tbNapAvailablePercent=0 2.8+
tbPwrSupplyState The redundant power supply has a new state.

tbHwPwrSupplyStatus can be:
good(0)
failure(1) 		1.3.6.1.4.1.21776.1.1.2.1.0.2 { tbHwPwrSupplyName, tbHwPwrSupplyStatus } When tbHwPwrSupplyStatus=1 2.8+
tbNp1State The N+1 patch panel has a new state.

tbHaNp1FunctionalState can be:
unknown(-1)
fault(0): There is no access to the N+1 patch panel
unprotected(1): Standby unit is not available
unprotectedSwitched(2): Standby unit is active and replaced primary unit is not ready to take over
healthy(3): N+1 unit is normal and standby unit is available
healthySwitched(4): N+1 unit is switched to the standby unit and replaced primary is available 		1.3.6.1.4.1.21776.1.1.2.1.0.3 { tbHaNp1Name, tbHaNp1FunctionalState } When tbHaNp1FunctionalState=0 OR tbHaNp1FunctionalState=1 OR tbHaNp1FunctionalState=2, it is major. 2.8+
tbAppState This toolpack application has a new state.

tbHaAppCurrentState can be:
unknown(100)
notRunning(101)
starting(102)
ready(103)
shuttingDown(104)
goingManagement(105)
fault(106) 		1.3.6.1.4.1.21776.1.1.2.1.0.4 { tbHaAppName, tbHaAppCurrentState, tbHaAppHostName } All tbHaAppCurrentState states are alarms except 103 2.8+
tbAppHaState This toolpack high availability application has changed state.

tbHaAppHaCurrentState can be:
notPresent(0)
active(1)
standby(2) 		1.3.6.1.4.1.21776.1.1.2.1.0.5 { tbHaAppName, tbHaAppHaCurrentState, tbHaAppHostName } Normal starting process of services will begin with tbHaAppHaCurrentState with value 0 (notPresent), going to Value 2 (standby) to finally Value 1 (active). Consider as an alarm if tbHaAppHaCurrentState of services stay consistently in others states different than 1, this applies for standalone and 1+1 systems. 2.8+
tbClkGradeState The network synchronization clock from this interface has a new grade.

tbClockType can be:
none(1)
osc(2)
trunk(3)
netRef1(4)
netRef2(5)
ptmc1(6)
ptmc2(7)
ct8a(8)
ct8b(9)
mbl(10)
bits(11)
ds3(12)
sonetSdh(13)
holdover(14)

tbClockGrade can be:
unqualified(0)
beingQualified(1)
qualified(2)
qualifiedForRecovery(3) 		1.3.6.1.4.1.21776.1.1.2.1.0.6 { tbClockName, tbClockType, tbClockGrade } When Object 'tbClockGrade=0' or 'tbClockGrade=1'
Cleared by 'tbClockGrade=2' or 'tbClockGrade=3' 		2.8+
tbClkActiveState This interface has been selected or not to provide the network synchronization clock for the whole system.

tbClockActive can be:
no(0)
yes(1) 		1.3.6.1.4.1.21776.1.1.2.1.0.7 { tbClockName, tbClockType, tbClockActive } When ALL OBJECTS report tbClockActive=0 2.8+
tbIsdnDChannelState The signaling channel for this ISDN interface has changed.

tbIsdnDChannelUp can be:
no(0)
yes(1) 		1.3.6.1.4.1.21776.1.1.2.1.0.8 { tbIsdnDescription, tbIsdnDChannelUp } When tbIsdnDChannelUp=0 2.8+
tbCASPhysicalLineState The interface for this CAS stack has changed.

tbCasPhysicalLineUp can be:
no(0)
yes(1) 		1.3.6.1.4.1.21776.1.1.2.1.0.9 { tbCasDescription, tbCasPhysicalLineUp } When tbCasPhysicalLineUp=0 2.8+
tbSipState The SIP stack state has changed.

tbSipCurrentState can be:
no(0)
yes(1) 		1.3.6.1.4.1.21776.1.1.2.1.0.10 { tbSipDescription, tbSipCurrentState } When tbSipCurrentState=0 2.8+
tbH248MgcState The H.248 communication state between this unit and the Media Gateway Controller has changed.

tbH248MgcCurrentState can be:
up(1)
down(2)
unknown(3) 		1.3.6.1.4.1.21776.1.1.2.1.0.11 { tbH248MgcName, tbH248MgcCurrentState } When tbH248MgcCurrentState=2 OR tbH248MgcCurrentState=3 2.8+
tbHostUpdateAvailableState The availability state of the host update has changed.

tbHostUpdateAvailable can be:
false(0)
true(1)
notSupported(2)
unknown(3)
disabled(4) 		1.3.6.1.4.1.21776.1.1.2.1.0.12 { tbHostName, tbHostUpdateAvailable } __ 2.8+


Example of packet capture: 

tcpdump port 162 -i mgmt0 -s 0
tcpdump: verbose output suppressed, use -v or -vv for full protocol decode
listening on mgmt0, link-type EN10MB (Ethernet), capture size 65535 bytes
14:08:51.491789 IP 10.7.0.13.37452 > 10.7.0.221.snmptrap: V2Trap(144) system.sysUpTime.0=9546160 S:1.1.4.1.0=S:1.1.5.4
interfaces.ifTable.ifEntry.ifIndex.452160.26=26 interfaces.ifTable.ifEntry.ifAdminStatus.452160.26=1 
interfaces.ifTable.ifEntry.ifOperStatus.452160.26=1  S:1.1.4.3.0=E:8072.3.2.10

Note

The ifIndex is a random value that can change after configuring the system, or adding new elements. This should not be relied on as a reference value. Please use the ifDescr instead.

SNMP SET

The SNMP SET command is not supported by TelcoBridges products. However, a RESTful API can be used to change the configuration remotely.


Configuration

The below procedures should be used to support SNMP v1 ONLY for Toolpack systems previous to 2.5.80:


Helpful resources

External Sources



Retrieved from "https://docs.telcobridges.com/w/index.php?title=SNMP&oldid=34680"