Digital Diagnostic Monitoring Commands
This chapter is a reference for Digital Diagnostic Monitoring (DDM) commands:
clear ddm transceiver alarm
Use this command to clear the transceiver alarm in the DDM monitor interface.
Command Syntax
clear ddm transceiver alarm
Default
None
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#clear ddm transceiver alarm
(config-if)#exit
clear ddm transceiver alarm all
Use this command to clear the transceiver DDM alarm for all interface.
Command Syntax
clear ddm transceiver alarm all
Parameters
None
Default
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
# clear ddm transceiver alarm all
ddm monitor
Use this command to enable or disable DDM monitoring for interfaces which have a supported transceiver.
Use the no form of this command to remove DDM monitoring for all transceivers.
Command Syntax
ddm monitor (disable|enable)
no ddm monitor
Parameters
enable
Enable DDM monitoring.
disable
Disable DDM monitoring.
Default
By default, DDM monitoring is disabled.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#interface xe1
(config-if)#ddm monitor enable
(config-if)#ddm monitor disable
(config-if)#exit
(config)#interface xe1
(config-if)#no ddm monitor
(config-if)#exit
ddm monitor all
Use this command to enable DDM monitoring for all transceiver.s
Use the no form of this command to disable DDM monitoring for all transceivers.
Command Syntax
ddm monitor all
no ddm monitor all
Parameters
None
Default
By default, DDM monitoring is disabled.
Command Mode
Configuration mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ddm monitor all
(config)#no ddm monitor all
ddm monitor interval
Use this command to set the monitoring interval for the transceiver.
Use no form with this command to set the monitoring interval to its default.
Command Syntax
ddm monitor interval <60-3600>
no ddm monitor interval
Parameters
<60-3600>
Interval period in seconds.
Default
The default monitoring interval is 60 seconds.
Command Mode
Configuration mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#ddm monitor interval 60
debug ddm
Use this command to enable or disable debugging for DDM.
Command Syntax
debug ddm
no debug ddm
Parameters
None
Default
By default, debug command is not configured.
Command Mode
Configuration mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#debug ddm
(config)#no debug ddm
service unsupported-transceiver
Use this command to allow an unsupported transceiver to be enabled for DDM monitoring.
Use the no form of this command to disable DDM on an unsupported transceiver.
Command Syntax
service unsupported-transceiver
no service unsupported-transceiver
Parameters
None
Default
By default, DDM on an unsupported transceiver is disabled.
Command Mode
Configuration mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#configure terminal
(config)#service unsupported-transceiver
(config)#no service unsupported-transceiver
show controller details
Use this command to display the EEPROM details of transceivers.
Command Syntax
show interface (IFNAME|) controllers
Parameters
IFNAME
Interface name. If not specified, this command displays details of all connected transceivers.
Default
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show interface xe52/1 controllers
Port Number : 52
Vendor oui : 0x0 0x17 0x6a
Vendor name : AVAGO
Vendor part_no : AFBR-79E4Z
serial_number : QB380161
transceiver_type : QSFP OR LATER
connector_type : MPO 1x12
qsfp_transceiver_code : 1X-LX
vendor_rev : 01
date_code : 110920 (yymmddvv, v=vendor specific)
encoding : SONET
br_nominal : 103 (100 MHz)
length_km : 0
length_mtr : 50
length_50mt : 0
length_62_5mt : 0
length_cu : 0
cc_base : 0x7d
cc_ext : 0x28
DDM Support : yes
show interface frequency grid
Use this command to display channel-number and wavelength mapping.
Command Syntax
show interface (IFNAME) frequency-grid
Parameters
IFNAME
Interface name.
Default
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.1.
Example
#show interface xe7 frequency-grid
------------------------------------------------------
Channel Number Frequency (THz) Wavelength (nm)
------------------------------------------------------
1 191.40 1566.314
2 191.50 1565.496
3 191.60 1564.679
4 191.70 1563.862
5 191.80 1563.047
6 191.90 1562.233
7 192.00 1561.419
8 192.10 1560.606
9 192.20 1559.794
10 192.30 1558.983
11 192.40 1558.172
12 192.50 1557.363
13 192.60 1556.554
14 192.70 1555.746
15 192.80 1554.939
16 192.90 1554.133
17 193.00 1553.328
18 193.10 1552.524
19 193.20 1551.720
20 193.30 1550.917
21 193.40 1550.115
22 193.50 1549.314
23 193.60 1548.514
24 193.70 1547.714
25 193.80 1546.916*
26 193.90 1546.118
27 194.00 1545.321
28 194.10 1544.525
29 194.20 1543.729
30 194.30 1542.934
31 194.40 1542.141
32 194.50 1541.348
33 194.60 1540.556
34 194.70 1539.765
35 194.80 1538.974
36 194.90 1538.184
37 195.00 1537.396
38 195.10 1536.607
39 195.20 1535.820
40 195.30 1535.034
41 195.40 1534.248
42 195.50 1533.463
43 195.60 1532.679
44 195.70 1531.896
45 195.80 1531.114
46 195.90 1530.332
47 196.00 1529.551
48 196.10 1528.771
#
show interface transceiver details
Use this command to display details of transceivers and threshold violations.
Command Syntax
show interface (IFNAME|) transceiver (detail|threshold violation|)
Parameters
IFNAME
Interface name. If not specified, this command displays details of all connected transceivers.
detail
Transceiver information such as voltage, temperature, power, and current.
threshold violation
Transceiver threshold violations.
Codes
* Not Qualified By IP Infusion, ** Not Supported By Module.
Default
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
OcNOS#sh int transceiver detail
Codes: * Not Qualified By IP Infusion, ** Not Supported By Module, -- No Power, - Not Applicable
Intf DDM Temp AlertMax CritMax CritMin AlertMin
(Celsius) (Celsius) (Celsius) (Celsius) (Celsius)
---------------------------------------------------------------------------
ce0 Active* +22.52 +85.00 +80.00 -5.00 -10.00
ce2 Active +20.32 +75.00 +70.00 +0.00 -5.00
xe4 Active* +23.62 +95.00 +85.00 -40.00 -50.00
xe5 Active* +19.79 +100.00 +95.00 -35.00 -40.00
xe16 Active* +25.84 +95.00 +85.00 -10.00 -50.00
xe26 Active +19.01 +95.00 +90.00 -20.00 -25.00
Intf DDM Volt AlertMax CritMax CritMin AlertMin
(Volts) (Volts) (Volts) (Volts) (Volts)
---------------------------------------------------------------------------
ce0 Active* +3.314 +3.600 +3.500 +3.100 +2.900
ce2 Active +3.260 +3.630 +3.465 +3.135 +2.970
xe4 Active* +3.260 +3.600 +3.500 +3.100 +3.000
xe5 Active* +3.253 +3.600 +3.500 +2.900 +2.800
xe16 Active* +3.284 +3.630 +3.500 +3.030 +2.930
xe26 Active +3.289 +3.900 +3.700 +2.900 +2.700
Intf DDM Lane Curr AlertMax CritMax CritMin AlertMin
(mA) (mA) (mA) (mA) (mA)
-------------------------------------------------------------------------------------
ce0 Active* 1 +6.114 +15.000 +12.000 +2.000 +0.000
2 +6.120 +15.000 +12.000 +2.000 +0.000
3 +6.110 +15.000 +12.000 +2.000 +0.000
4 +6.116 +15.000 +12.000 +2.000 +0.000
ce2 Active 1 +7.464 +13.000 +11.000 +5.000 +3.000
2 +7.540 +13.000 +11.000 +5.000 +3.000
3 +7.444 +13.000 +11.000 +5.000 +3.000
4 +7.474 +13.000 +11.000 +5.000 +3.000
xe4 Active* - +6.100 +110.000 +100.000 +1.000 +1.000
xe5 Active* - +7.552 +15.000 +13.000 +2.000 +1.000
xe16 Active* - +5.800 +15.000 +12.000 +3.000 +2.000
xe26 Active - +7.050 +17.000 +14.000 +2.000 +1.000
Intf DDM Lane RxPwr AlertMax CritMax CritMin AlertMin
(dBm) (dBm) (dBm) (dBm) (dBm)
-------------------------------------------------------------------------------------
ce0 Active* 1 -0.185 +4.400 +3.400 -13.298 -14.306
2 +0.342 +4.400 +3.400 -13.298 -14.306
3 +0.396 +4.400 +3.400 -13.298 -14.306
4 -2.927 +4.400 +3.400 -13.298 -14.306
ce2 Active 1 +1.302 +3.400 +2.400 -11.002 -14.001
2 +1.486 +3.400 +2.400 -11.002 -14.001
3 +1.581 +3.400 +2.400 -11.002 -14.001
4 +1.594 +3.400 +2.400 -11.002 -14.001
xe4 Active* - -1.890 +2.500 +0.500 -14.401 -16.402
xe5 Active* - -40.000 +3.000 +0.000 -13.002 -16.003
xe16 Active* - -- +2.000 +1.000 -14.401 -16.402
xe26 Active - -5.933 +1.000 -1.002 -18.013 -20.000
Intf DDM Lane TxPwr AlertMax CritMax CritMin AlertMin
(dBm) (dBm) (dBm) (dBm) (dBm)
-------------------------------------------------------------------------------------
ce0 Active* 1 -0.085 +4.400 +3.400 -9.201 -10.205
2 -0.161 +4.400 +3.400 -9.201 -10.205
3 +0.217 +4.400 +3.400 -9.201 -10.205
4 +0.204 +4.400 +3.400 -9.201 -10.205
ce2 Active 1 +0.297 +5.000 +3.000 -8.000 -10.000
2 -0.078 +5.000 +3.000 -8.000 -10.000
3 +0.131 +5.000 +3.000 -8.000 -10.000
4 +0.323 +5.000 +3.000 -8.000 -10.000
xe4 Active* - -1.316 +2.500 +0.500 -8.199 -10.200
xe5 Active* - -2.299 +1.000 +0.000 -7.001 -8.000
xe16 Active* - -1.000 +2.500 +2.000 -8.199 -10.200
xe26 Active - -4.441 -2.000 -2.000 -11.024 -11.739
Intf DDM Lane Freq-Err AlertMax CritMax CritMin AlertMin
(GHz) (GHz) (GHz) (GHz) (GHz)
-------------------------------------------------------------------------------------
Intf DDM Lane Wave-Err AlertMax CritMax CritMin AlertMin
(nm) (nm) (nm) (nm) (nm)
-------------------------------------------------------------------------------------
Intf DDM Lane Tx Rx-LOS Tx-LOS
------------------------------------------------------------------------------
ce0 Active* 1 On Off Off
2 On Off Off
3 On Off Off
4 On Off Off
ce2 Active 1 On Off Off
2 On Off Off
3 On Off Off
4 On Off Off
xe4 Active* - On Off -
xe5 Active* - On On -
xe9 Inactive* - On On -
xe11 Inactive* - On On -
xe13 Inactive* - On On -
xe14 Inactive* - On On -
xe16 Active* - On On -
xe26 Active - On Off
Table 28-85 explains the output fields.
Table 28-85: show interface transceiver details output
Field | Description |
|---|
Port | The number of the transceiver port. |
Temp | Temperature in degrees Celsius of the transceiver. |
Voltage | Voltage in Volts on the transceiver. |
Current | Current in Milliamperes used by the transceiver. |
Rx Power | Power received in Decibel-milliwatts (dBm) by the transceiver. |
Tx Power | Power being transmitted in milliWatts by the transceiver. |
High Alarm | The level that is needed to be reached to trigger a high alarm. |
High Warn | The level that is needed to be reached to trigger a high warning. |
Low Warn | The level that is needed to be reached to trigger a low warning. |
Low Alarm | The level that is needed to be reached to trigger a low alarm. |
Codes * | Not Qualified By IP Infusion, ** Not Supported By Module |
show supported-transceiver
Use this command to display supported transceivers.
Command Syntax
show supported-transceiver
Parameters
None
Default
None
Command Mode
Exec mode
Applicability
This command was introduced before OcNOS version 1.3.
Example
#show supported-transceiver
-----------------------------------------------------
Transceiver DDM support list
-----------------------------------------------------
Type :SFP
Vendor Name :FINISAR CORP
Vendor Part Number :FTLF8519P2BNL
DDM Supported :Yes
Type :SFP
Vendor Name :EVERTZ
Vendor Part Number :SFP10G-TR13S
DDM Supported :Yes
Type :QSFP
Vendor Name :AVAGO
Vendor Part Number :AFBR-79E4Z
DDM Supported :Yes
tx-disable
Use this command to disable the transceiver tx-power (disable laser).
Use the no form of this command to enable tx-power (enable laser).
Command Syntax
tx-disable
no tx-disable
Default
By default, tx-disable is false.
Command Mode
Interface mode
Applicability
This command was introduced before OcNOS version 4.2.
Example
#configure terminal
(config)#interface xe1
(config-if)#tx-disable
(config-if)#exit
(config)#interface xe1
(config-if)#no tx-disable
(config-if)#exit
wavelength
Use this command to set the transceiver wavelength using the channel-number or the wavelength for interfaces having a supported transceiver.
Use the no form of this command to remove the wavelength configuration.
Command Syntax
wavelength ((channel-number <1-96>) | (update <1528773-1566723>))
Parameters
channel-number
Sets wavelength corresponding to the channel number
update
Sets wavelength value
Default
By default, the interface comes up with a random wavelength chosen by autotuning.
Command Mode
Interface mode
Applicability
This command was introduced in OcNOS version 4.1.
Example
(config)#int xe7
(config-if)#wavelength channel-number 10
(config-if)#no wavelength
(config-if)#
(config-if)#wavelength update 1528773
(config-if)#no wavelength
(config-if)#