Download White Paper

White Paper
SNMP Status Traps
The GNCI Multi Service Modem (MSM) can be configured to send regular periodic
status updates to an SNMP management station. These updates will be sent in the form of
SNMP traps, containing a string with MSM specific information.
SNMP traps can either be sent in SNMP version 1 or version 2 format. All SNMP traps
sent by the MSM have the following community string and OID:
Community String:
OID:
<configurable> (default: “public”)
1.3.6.1.6.3.1.1.5.4
The SNMP status trap message content is a string with MSM specific values. This string
consists of several fields, all separated by commas. Some fields may be empty depending
on how the MSM is configured and on which type of radio card is used.
There are two types of periodic status traps: Traps containing dynamic data (data that
changes frequently) and traps containing static or semi-static data.
The send interval for traps containing dynamic data can be adjusted from the MSM web
interface and ranges from once every minute to once every two hours. The send interval
for traps containing static data is fixed to once every 12 hours.
The individual fields of traps containing dynamic data can either carry information in
human readable format or in machine readable format, depending on how the MSM is
configured. Static data traps always carry information in machine readable format.
To make it easier to parse incoming traps, the trap type and trap version is indicated by a
specific string in the second field of each trap. Refer to the following tables for more
information
Dynamic Radio and Network Information Traps: Machine Readable Format
Field
1
2
3
Name
MSM Hostname
Message version
Protocol of attached
device
Description
String value
String value: “M” for machine readable, then numeric
value indicating the message version. Currently “3”
“1”: IP
“2”: BiSync
“3”: SDLC
GNCI White Paper SNMP Traps Rev 2.0
1
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Attached device
reachable by ICMP
ETH0 link status
“0”: not reachable
“1”: replies to ICMP
“0”: link down
“1”: link up
Legacy protocol layer “0”: layer 1 down
1 status
“1”: layer 1 up
Legacy protocol layer “0”: layer 2 down
2 status
“1”: layer 2 up
Legacy protocol layer “0”: layer 3 down
3 status
“1”: layer 3 up
Bytes transmitted
Bytes transmitted across the wireless link
Bytes received
Bytes received across the wireless link
Radio card type
“0”: Sony Ericsson GC75/GC75A (GPRS)
“1”: Sony Ericsson GC83 (GPRS / EDGE)
“2”: Kyocera KPC650 (EVDO)
“3”: Sierra Wireless Aircard 555 / 550 (1xRTT)
“4”: Sierra Wireless PC5220 / Aircard 580 (EVDO)
“5”: Sierra Wireless Aircard 595 (EVDO RevA)
“6”: Sierra Wireless Aircard 850 / 860 (UMTS)
“7”: Sierra Wireless Aircard 875 (UMTS / HDSPA)
“8”: Novatel V620 / S620 (EVDO)
“9”: Novatel V720 / V720 (EVDO RevA)
“10” UTStarcom PC5750
“11” Sierra Wireless Aircard 595U (EVDO RevA,
External USB)
“12” Novatel 720USB (EVDO RevA, External USB)
RSSI
Numeric value: current RSSI value in dBm
Ec/Io
Numeric value: current Ec/Io value in dBm
Channel
Numeric value: current channel
CDMA network
CDMA network coverage:
“0”: 1xRTT
“1”: EVDO
“2”: EVDO RevA
Roaming indicator
“0”: home network
“1”: roaming
Frequency band
“0”: cellular (850MHz)
“1”: PCS (1900MHz)
“2”: UMTS (2.1GHz)
CDMA SID
Numeric value: CDMA System Identifier
CDMA NID
Numeric value: CDMA Network Identifier
GSM Cell ID
Numeric value: Cell ID on GSM networks
GSM LAC
Numeric value: GSM Location Area Code
GSM MCC
Numeric value: GSM Mobile Country Code
GSM MNC
Numeric value: GSM Mobile Network Code
GSM network
GSM network coverage:
“1”: GPRS
GNCI White Paper SNMP Traps Rev 2.0
2
“2”: EDGE
“3”: UMTS
“4”: HSDPA
Dynamic Radio and Network Information Traps: Human Readable Format
Field
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Name
MSM Hostname
Message version
Description
String value
String value: “H” for human readable, then numeric value
indicating the message version. Currently “3”
Protocol of attached “Prot: IP”: IP
device
“Prot: BSC”: BiSync
“Prot: SDLC”: SDLC
Attached device
“ICMP: down”: not reachable
reachable by ICMP “ICMP: up”: replies to ICMP
ETH0 link status
“Link: down”: link down
“Link: up”: link up
Legacy protocol
“L1: down”: layer 1 down
layer 1 status
“L1: up”: layer 1 up
Legacy protocol
“L2: down”: layer 2 down
layer 2 status
“L2: up”: layer 2 up
Legacy protocol
“L3: down”: layer 3 down
layer 3 status
“L3: up”: layer 3 up
Bytes transmitted
“Tx: <Bytes transmitted across the wireless link>”
Bytes received
“Rx: <Bytes received across the wireless link>”
Radio card type
“GC75”: Sony Ericsson GC75/GC75A (GPRS)
“GC83”: Sony Ericsson GC83 (GPRS / EDGE)
“KPC650”: Kyocera KPC650 (EVDO)
“AC55x”: Sierra Wireless Aircard 555 / 550 (1xRTT)
“AC580”: Sierra Wireless PC5220 / Aircard 580 (EVDO)
“AC595”: Sierra Wireless Aircard 595 (EVDO RevA)
“AC8x0”: Sierra Wireless Aircard 850 / 860 (UMTS)
“AC875”: Sierra Wireless Aircard 875 (UMTS / HDSPA)
“NVTL620”: Novatel V620 / S620 (EVDO)
“NVTL720”: Novatel V720 / V720 (EVDO RevA)
“PC5750” UTStarcom PC5750
“AC595U” Sierra Wireless Aircard 595U (EVDO RevA,
External USB)
“NVTL720USB” Novatel 720USB (EVDO RevA,
External USB)
RSSI
“RSSI: <current RSSI value in dBm>”
Ec/Io
“Ec/Io: <current Ec/Io value in dBm>”
Channel
“Chan: <current channel>”
CDMA network
CDMA network coverage:
GNCI White Paper SNMP Traps Rev 2.0
3
16
Roaming indicator
17
Frequency band
18
19
20
21
22
23
24
CDMA SID
CDMA NID
GSM Cell ID
GSM LAC
GSM MCC
GSM MNC
GSM network
“1xRTT”: 1xRTT
“EVDO”: EVDO
“RevA”: EVDO RevA
“no roam”: home network
“ROAMING”: roaming
“Cellular”: cellular (850MHz)
“PCS”: PCS (1900MHz)
“2.1GHz”: UMTS (2.1GHz)
“SID: <CDMA System Identifier>”
“NID: <CDMA Network Identifier>”
“Cell-ID: <Cell ID on GSM networks>”
“LAC: <GSM Location Area Code>”
“MCC: <GSM Mobile Country Code>”
“MNC: <GSM Mobile Network Code>”
GSM network coverage:
“GPRS”: GPRS
“EDGE”: EDGE
“UMTS”: UMTS
“HSDPA”: HSDPA
Static Radio and Network Information Traps: Machine Readable Format
Field
1
2
Name
MSM Hostname
Message version
3
Radio card type
4
Radio firmware
version
Description
String value
String value: “S” for static information, then numeric
value indicating the message version. Currently “1”
“GC75”: Sony Ericsson GC75/GC75A (GPRS)
“GC83”: Sony Ericsson GC83 (GPRS / EDGE)
“KPC650”: Kyocera KPC650 (EVDO)
“AC55x”: Sierra Wireless Aircard 555 / 550 (1xRTT)
“AC580”: Sierra Wireless PC5220 / Aircard 580 (EVDO)
“AC595”: Sierra Wireless Aircard 595 (EVDO RevA)
“AC8x0”: Sierra Wireless Aircard 850 / 860 (UMTS)
“AC875”: Sierra Wireless Aircard 875 (UMTS / HDSPA)
“NVTL620”: Novatel V620 / S620 (EVDO)
“NVTL720”: Novatel V720 / V720 (EVDO RevA)
“PC5750” UTStarcom PC5750
“AC595U” Sierra Wireless Aircard 595U (EVDO RevA,
External USB)
“NVTL720USB” Novatel 720USB (EVDO RevA,
External USB)
String value: depends on specific radio and radio firmware
in use
GNCI White Paper SNMP Traps Rev 2.0
4
5
6
Radio hardware
version
CDMA PRL
7
CDMA ERI
8
9
CDMA MDN
CDMA MIN
10
CDMA ESN
11
12
CDMA NAI
GSM IMEI
13
GSM FSN
14
GSM IMSI
String value: depends on specific radio and radio hardware
in use
Numeric value: CDMA PRL (Preferred Roaming List)
version number
Numeric value: CDMA ERI (Enhanced Roaming
Indicator) version number
Numeric value: CDMA MDN (Mobile Directory Number)
Numeric value: CDMA MIN (Mobile Identification
Number)
Numeric or hexadecimal value: CDMA ESN (Electronic
Serial Number)
String value: CDMA NAI (Network Address Identifier)
Numeric value: GSM IMEI (International Mobile
Equipment Identity)
Numeric or hexadecimal value: GSM FSN (Factory Serial
Number)
Numeric value: GSM IMSI (International Mobile
Subscriber Identity)
GNCI White Paper SNMP Traps Rev 2.0
5