Command Reference for Cisco NCS 1000 Series
First Published: 2015-12-23
Last Modified: 2016-11-14
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS,
INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.
THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH
THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY,
CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.
The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version
of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.
NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS.
CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.
IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT
LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS
HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network
topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional
and coincidental.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: http://
www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership
relationship between Cisco and any other company. (1110R)
© 2016
Cisco Systems, Inc. All rights reserved.
CONTENTS
CHAPTER 1
Commands 1
Reference 2
cipher-suite 3
conf-offset 4
controller coherentDSP 5
controller GigECtrlr 7
controller mACSecCtrlr 9
controller optics 10
cryptographic-algorithm 14
dwdm-carrier 15
hw-module 17
key 19
key chain 20
key-server-priority 21
key-string 22
lifetime 23
macsec 24
macsec-policy 25
pm 26
security-policy 31
show alarms 32
show controllers 35
show environment 48
show hw-module 51
show inventory 55
show led 58
show platform 59
window-size 62
Command Reference for Cisco NCS 1000 Series
iii
Contents
Command Reference for Cisco NCS 1000 Series
iv
Commands
• Reference, page 2
• cipher-suite, page 3
• conf-offset, page 4
• controller coherentDSP, page 5
• controller GigECtrlr, page 7
• controller mACSecCtrlr, page 9
• controller optics, page 10
• cryptographic-algorithm, page 14
• dwdm-carrier, page 15
• hw-module, page 17
• key, page 19
• key chain, page 20
• key-server-priority, page 21
• key-string, page 22
• lifetime, page 23
• macsec, page 24
• macsec-policy, page 25
• pm, page 26
• security-policy, page 31
• show alarms, page 32
• show controllers, page 35
• show environment, page 48
• show hw-module, page 51
• show inventory, page 55
Command Reference for Cisco NCS 1000 Series
1
Commands
Reference
• show led, page 58
• show platform, page 59
• window-size, page 62
Reference
This guide describes the commands supported in Cisco NCS 1000 Series. For information on Cisco IOS XR
commands, see here.
Command Reference for Cisco NCS 1000 Series
2
Commands
cipher-suite
cipher-suite
To configure the cipher suite for encrypting traffic with MACsec, use the cipher-suite command in MACsec
policy configuration mode.
The first portion indicates the encryption method, the second portion indicates the hash or integrity algorithm,
and the third portion indicates the length of the cipher.
cipher-suite encryption_suite
Syntax Description
GCM-AES-XPN-256
GCM encryption method; AES encryption algorithm that uses Extended
Packet Numbering (XPN) of 64 bits; 256 bit encryption.
Command Default
The default cipher suite chosen for encryption is GCM-AES-XPN-256.
Command Modes
MACsec policy configuration
Command History
Examples
Release
Modification
Release 6.1.1
This command was introduced.
The following example shows how to use the cipher-suite command.
configure
macsec-policy mac_policy
cipher-suite GCM-AES-XPN-256
Command Reference for Cisco NCS 1000 Series
3
Commands
conf-offset
conf-offset
To configure the confidentiality offset for MACsec encryption, use the conf-offset command in MACsec
policy configuration mode.
conf-offset offset_value
Syntax Description
CONF-OFFSET-0
Command Default
The default value is CONF-OFFSET-0.
Command Modes
MACsec policy configuration
Command History
Examples
Release
Modification
Release 6.1.1
This command was introduced.
The following example shows how to use the conf-offset command.
configure
macsec-policy mac_policy
conf-offset CONF-OFFSET-0
Command Reference for Cisco NCS 1000 Series
4
Does not offset the encryption.
Commands
controller coherentDSP
controller coherentDSP
To configure the coherent DSP controller, use the controller coherentDSP command in the Coherent DSP
controller configuration mode.
controller coherentDSP R/S/I/P [ pm {30-sec |15-min | 24-hour} {fec | otn} {report | threshold} value]
[perf-mon { enable | disable } ] | [loopback {internal | line} ] | [ sec-admin-state maintenance] | [ shutdown
] | [tti {sent | expected} ascii string ]
Syntax Description
R/S/I/P
Rack/Slot/Instance/Port of the coherent DSP controller.
pm {30-sec | 15-min | 24-hour } Configures performance monitoring parameters for 30 second,15 minute
or 24 hour intervals.
fec
Configures FEC PM data in 30 second, 15 minute or 24 hour intervals.
otn
Configures OTN PM data in 30 second, 15 minute or 24 hour intervals.
report
Configures TCA reporting status.
threshold
Configures threshold on coherent DSP parameters.
perf-mon { enable | disable }
Enables or disables performance monitoring.
loopback [ internal | line ]
Configures the internal or line loopback mode on the controller.
sec-admin-state maintenance
Configures the administrative state of the controller indicating that the
controller is under maintenance.
shutdown
Disables the configuration of the controller.
tti sent ascii string
Configures the Trail Trace Identifier (TTI) ASCII string to be sent. SAPI,
DAPI, and operator inputs are not supported.
tti expected ascii string
Configures the expected TTI ASCII string. The TIM alarm is raised if
the received TTI string does not match the expected TTI string. SAPI,
DAPI, and operator inputs are not supported.
Command Default
None
Command Modes
Coherent DSP controller configuration
Command Reference for Cisco NCS 1000 Series
5
Commands
controller coherentDSP
Command History
Examples
Release
Modification
Release 6.0.0
This command was introduced.
The following example shows how to configure the performance monitoring parameters of the Coherent DSP
controller in 15 minute intervals.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# controller coherentDSP 0/0/0/12 pm 15-min otn threshold es-ne
The following example shows how to configure the TTI string.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# controller coherentDSP 0/0/0/12 tti sent ascii joy
Command Reference for Cisco NCS 1000 Series
6
Commands
controller GigECtrlr
controller GigECtrlr
To configure the Ethernet controller, use the controller GigECtrlr command in the Ethernet controller
configuration mode.
controller { TenGigECtrlr | HundredGigECtrlr } R/S/I/P [ pm {30-sec |15-min | 24-hour} {ether} {report
| threshold} value ] | [ perf-mon { enable | disable } ] | [loopback {internal | line} ] | [sec-admin-state
maintenance] | [shutdown ] | [laser-squelch] | [ fec { none | standard } ]
Syntax Description
R/S/I/P
Rack/Slot/Instance/Port of the Ethernet controller.
pm {30-sec |15-min | 24-hour }
Configures performance monitoring parameters for 30 second, 15
minutes, or 24 hour intervals.
ether
Configures Ethernet PM data in 30 second, 15 minute or 24 hour
intervals.
report
Configures TCA reporting status.
threshold
Configures threshold on Ethernet controller parameters.
perf-mon { enable | disable }
Enables or disables performance monitoring.
loopback [ internal | line ]
Configures the internal or line loopback mode on the controller.
sec-admin-state maintenance
Configures the administrative state of the controller indicating that the
controller is under maintenance.
shutdown
Disables the configuration of the controller.
laser-squelch
Enables laser squelching so that laser is brought down in the event of
trunk faults (LOF, LOS) and a SQUELCHED alarm is raised. For 10G
Ethernet controllers, laser squelching is supported only on LR4 and
QSFP+ pluggables.
fec { none | standard }
(Only for 100G Ethernet Controllers) Disables FEC or enables standard
(Reed-Solomon) FEC.
Command Default
None
Command Modes
Ethernet controller configuration
Command Reference for Cisco NCS 1000 Series
7
Commands
controller GigECtrlr
Command History
Examples
Release
Modification
Release 6.0.0
This command was introduced.
The following example shows how to configure the performance monitoring parameters of the Ethernet
controller in 15 minute intervals.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# controller TenGigECtrlr 0/0/0/0/1 pm 15-min ether report
1024-1518-octets enable
The following example shows how to configure the internal loopback.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# controller TenGigECtrlr 0/0/0/0/1 loopback internal
Command Reference for Cisco NCS 1000 Series
8
Commands
controller mACSecCtrlr
controller mACSecCtrlr
To configure the MACSec controller, use the controller mACSecCtrlr command in the MACSec controller
configuration mode.
controller mACSecCtrlr R/S/I/P
Syntax Description
R/S/I/P
Command Default
None
Command Modes
MACSec controller configuration
Command History
Examples
Rack/Slot/Instance/Port of the MACSec controller.
Release
Modification
Release 6.1.1
This command was introduced.
The following example shows how to configure the MACSec controller.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# controller mACSecCtrlr 0/0/0/4
Command Reference for Cisco NCS 1000 Series
9
Commands
controller optics
controller optics
To configure the optics controller, use the controller optics command in the optics controller configuration
mode.
controller optics R/S/I/P [ cd-max cd-max | cd-min cd-min | cd-low-threshold cd-low | cd-high-threshold
cd-high | dgd-high-threshold dgd-value | lbc-high-threshold lbc-value | osnr-low-threshold osnr-value
description description | rx-high-threshold rx-high | rx-low-threshold rx-low | tx-high-threshold tx-high
| tx-low-threshold tx-low | sec-admin-state maintenance | shutdown | transmit-power transmit-power |
perf-mon { enable | disable } | pm [ 30-sec |15-min | 24-hour ] optics [ report | threshold ]
controller optics R/S/I/P pm [30-sec |15-min | 24-hour] optics [report | threshold {cd | dgd | lbc | lbc-pc
| opr | opr-dbm | opt | opt-dbm | osnr | pcr | pdl | pn | sopmd]
Syntax Description
R/S/I/P
Rack/Slot/Instance/Port of the optics controller.
cd-max cd-max
(Only for trunk optics controllers) Maximum chromatic dispersion.
The range is -70000 to +70000 ps/nm when the trunk bit rate is 100G. The
range is -20000 to +20000 ps/nm when the trunk bit rate is 200G or 250G.
cd-min cd-min
(Only for trunk optics controllers) Minimum chromatic dispersion.
The range is -70000 to +70000 ps/nm when the trunk bit rate is 100G. The
range is -20000 to +20000 ps/nm when the trunk bit rate is 200G or 250G.
cd-low-threshold cd-low
(Only for trunk optics controllers) Minimum acceptable chromatic dispersion.
The CD-OOR alarm is raised if the chromatic dispersion goes below this
value.
The range is -70000 to +70000 ps/nm when the trunk bit rate is 100G. The
range is -20000 to +20000 ps/nm when the trunk bit rate is 200G or 250G.
cd-high-threshold cd-high
(Only for trunk optics controllers) Maximum acceptable chromatic dispersion.
The CD-OOR alarm is raised if the chromatic dispersion exceeds this value.
The range is -70000 to +70000 ps/nm when the trunk bit rate is 100G. The
range is -20000 to +20000 ps/nm when the trunk bit rate is 200G or 250G.
dgd-high-threshold
dgd-value
(Only for trunk optics controllers) Configures the maximum acceptable
Differential Group Delay (DGD) value. The HIGH_DGD alarm is raised if
DGD exceeds this value.
The range is 0 to 18000 (in the units of 0.01 ps).
lbc-high-threshold lbc-value Configures the high laser bias current threshold.
The range is 0 to 100%
Command Reference for Cisco NCS 1000 Series
10
Commands
controller optics
osnr-low-threshold
osnr-value
(Only for trunk optics controllers) Configures the minimum acceptable Optical
Signal to Noise ratio (OSNR) value. The LOW_OSNR alarm is raised if
OSNR goes below this value.
The range is 0 to 4000 (in the units of 0.01 db).
description description
Description of the optics controller.
rx-high-threshold rx-high
Configures high receive power threshold. The range is -400 to 300 (in the
units of 0.1 dBm).
rx-low-threshold rx-low
Configures low receive power threshold. The range is -400 to 300 (in the
units of 0.1 dBm).
tx-high-threshold tx-high
Configures high transmit power threshold. The range is -400 to 300 dBm (in
the units of 0.1 dBm).
tx-low-threshold tx-low
Configures low transmit power threshold. The range is -400 to 300 dBm (in
the units of 0.1 dBm).
sec-admin-state maintenance Configures the administrative state of the controller indicating that the
controller is under maintenance.
shutdown
Disables the configuration of the controller.
pm
Configures performance monitoring parameters for 30 second, 15 minute and
24 hour intervals.
transmit-power
transmit-power
(Only for trunk optics controllers) Configures the transmit power. The range
is -190 to 15 dBm (in the units of 0.1 dBm).
The CLI allows to configure the range between -190 to 15 dBm (in the units
of 0.1 dBm). See the appropriate CFP pluggable data sheet for the supported
range.
perf-mon { enable | disable Enables or disables performance monitoring.
}
cd
Configures the chromatic dispersion threshold.
dgd
Configures the DGD threshold.
lbc
Configures the laser bias current threshold.
lbc-pc
Configures the laser bias current threshold in percentage.
opr
Configures the optical Rx power threshold in uW.
opr-dbm
Configures the optical Rx power threshold in dBm. The unit is 0.01 dBm.
For example, if you want to configure 30.00 dBm, enter 3000.
opt
Configures the optical Tx power threshold in uW.
Command Reference for Cisco NCS 1000 Series
11
Commands
controller optics
Command Default
Command History
opt-dbm
Configures the optical Tx power threshold in dBm. The unit is 0.01 dBm.
osnr
Configures the OSNR threshold.
pcr
Configures the Polarization Change Rate (PCR) threshold.
pdl
Configures the Polarization Dependent Loss (PDL) threshold.
pn
Configures the Phase Noise (PN) threshold.
sopmd
Configures the Second Order Polarization Mode Dispersion (SOPMD)
threshold.
None
Release
Modification
Release 6.0.0
This command was introduced.
Release 6.1.1
The opr-dbm and opt-dbm were added.
Command Modes
Optics controller configuration
Usage Guidelines
The configurations for chromatic dispersion (cd-max, cd-min, cd-low-threshold, and cd-high-threshold) must
be performed only after the hw-module configuration. These configurations must be removed before the no
hw-module configuration.
Examples
The following example shows how to configure the optics controller and set the high power threshold at the
transmit and receive side.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# controller optics 0/0/0/0
RP/0/RP0/CPU0:ios(config-optics)# rx-high-threshold 200
RP/0/RP0/CPU0:ios(config-optics)# tx-high-threshold 300
The following example shows how to configure the optics controller and set the ranges for chromatic dispersion
when the trunk rate is 200G.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# controller optics 0/0/0/0
RP/0/RP0/CPU0:ios(config-optics)# cd-max 10000
RP/0/RP0/CPU0:ios(config-optics)# cd-min 2000
The following example shows how to configure the optics performance monitoring for 15 minute intervals.
RP/0/RP0/CPU0:ios# configure
Command Reference for Cisco NCS 1000 Series
12
Commands
controller optics
RP/0/RP0/CPU0:ios(config)# controller optics 0/0/0/0
RP/0/RP0/CPU0:ios(config-optics)# pm 15-min optics report cd max-tca enable
Command Reference for Cisco NCS 1000 Series
13
Commands
cryptographic-algorithm
cryptographic-algorithm
To configure the cryptographic algorithm used for authenticating a peer for MACsec encryption, use the
cryptographic-algorithm command in keychain configuration mode.
cryptographic-algorithm authentication algorithm
Syntax Description
AES-128-CMAC
Configures the 128-bit AES
encryption algorithm.
AES-256-CMAC
Configures the 256-bit AES
encryption algorithm.
Command Default
No default behavior or values.
Command Modes
Keystring configuration
Command History
Examples
Release
Modification
Release 6.1.1
This command was introduced.
The following example shows how to use the cryptographic-algorithm command for MACsec encryption.
configure
key chain mac_chain macsec
key 1234abcd5678
key-string 123456781234567812345678123456 cryptographic-algorithm aes-128-cmac
Command Reference for Cisco NCS 1000 Series
14
Commands
dwdm-carrier
dwdm-carrier
To configure the wavelength on the trunk port, use the dwdm-carrier command in optics controller
configuration mode. To return the wavelength to its default value, use the no form of this command.
dwdm-carrier {100MHz-grid frequency frequency}
dwdm-carrier {50Ghz-grid [frequency frequency |wavelength wavelength |itu-ch channel-number]}
Syntax Description
50Ghz-grid | 100MHz-grid Configures the wavelength in 50GHz grid and 100MHz (0.1GHz) grid spacing
respectively in accordance with ITU definition.
frequency frequency
Specifies the frequency for the optics controller.
In 50GHz grid spacing, enter the 5-digit frequency value in the range of 19115
to 19610 GHz. For example, enter 19580 to specify 195.8 THz. In 100MHz
grid spacing, enter the 7-digit frequency value in the range of 1911500 to
1961000 THz. For example, enter 1913501 to specify 191.3501 THz.
wavelength wavelength
Specifies the wavelength for the optics controller.
In 50GHz grid spacing, enter the 7-digit wavelength value in the range of
1528773 to 1568362 nm. For example, enter 1532290 to specify 1532.29 nm.
itu-ch channel-number
ITU channel number. The range is 1 to 100 for conventional band (C-band).
Command Default
No wavelength is configured.
Command Modes
Optics controller configuration
Command History
Usage Guidelines
Release
Modification
Release 6.0.0
This command was introduced.
The controller must be in the shutdown state before you can use the wavelength command.
Use the show controllers optics Rack/Slot/Instance/Port dwdm-carrrier-map command to display the
wavelength and channel mapping for trunk optics controllers. See the show controllers, on page 35 command
to view the DWDM carrier map table.
Examples
The following example shows how to configure the channel number.
RP/0/RP0/CPU0:ios# config
Command Reference for Cisco NCS 1000 Series
15
Commands
dwdm-carrier
RP/0/RP0/CPU0:ios(config)# controller optics 0/0/0/0
RP0/0/CPU0:ios(config-optics)# dwdm-carrier 50GHz-grid itu-ch 25
The following example shows how to configure the frequency in 50GHz grid spacing.
RP/0/RP0/CPU0:ios# config
RP/0/RP0/CPU0:ios(config)# controller optics 0/0/0/0
RP0/0/CPU0:ios(config-optics)# dwdm-carrier 50GHz-grid frequency 19265
The following example shows how to configure the frequency in 100MHz grid spacing.
RP/0/RP0/CPU0:ios# config
RP/0/RP0/CPU0:ios(config)# controller optics 0/0/0/0
RP0/0/CPU0:ios(config-optics)# dwdm-carrier 100MHz-grid frequency 1911501
The following example shows how to configure the wavelength in 50GHz grid spacing.
RP/0/RP0/CPU0:ios# config
RP/0/RP0/CPU0:ios(config)# controller optics 0/0/0/0
RP0/0/CPU0:ios(config-optics)# dwdm-carrier 50GHz-grid wavelength 1560200
Command Reference for Cisco NCS 1000 Series
16
Commands
hw-module
hw-module
To provision the slice with traffic on the client and trunk ports, use the hw-module command in IOS XR
configuration mode.
The slice can be provisioned to send encrypted traffic with client bitrate as 100G and trunk bitrate as 200G.
hw-module location location slice [slice_number | all{drop-lldp| client bitrate [10G | 40G | 100G] trunk
bitrate [100G | 200G | 250G] fec [softdecision7 | softdecision20] [encrypted]}]
Syntax Description
Command Default
location location
Specifies the location of the optics
controller. The location is
0/RP0/CPU0.
slice [slice_number | all ]
Specifies the slice number that is
provisioned or all the slices. The
range of slice number is 0 to 3.
Each slice is a group of five client
ports and two trunk ports.
drop-lldp
Enables LLDP drop on the
specified slice.
client bitrate [10G | 40G | 100G]
Specifies the traffic rate on the
client ports.
trunk bitrate [100G | 200G | 250G]
Specifies the traffic rate on the
trunk ports.
fec [softdecision7 | softdecision20]
Specifies the FEC to configure on
the trunk ports.
encrypted
Provisions the slice to send
encrypted traffic.
No slice is configured.
You must configure the slice before enabling LLDP drop.
Command Modes
Command History
Cisco IOS XR Configuration
Release
Modification
Release 6.0.0
This command was introduced.
Command Reference for Cisco NCS 1000 Series
17
Commands
hw-module
Release
Modification
Release 6.0.1
40G client bit rate was introduced.
Release 6.1.1
encrypted keyword was added.
Release 6.1.2
drop-lldp keyword was added.
Usage Guidelines
When each slice is configured with a specific client bitrate and trunk bitrate, the no hw-module location
location slice all command cannot be used to remove all the slice configurations. Use the no hw-module
location location slice slice_number command for each slice to remove the slice configuration. Use the no
hw-module location location {slice slice_number | all} drop-lldp command to disable LLDP drop the on
the configured slice.
Examples
The following example shows how to configure slice 0 with client rate as 100G and trunk rate as 200G.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# hw-module location 0/RP0/CPU0 slice 0 client bitrate 100G trunk
bitrate 200G softdecision7
The following example shows how to configure slice 1 with client rate as 100G and trunk rate as 250G.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# hw-module location 0/RP0/CPU0 slice 1 client bitrate 100G trunk
bitrate 250G softdecision20
The following example shows how to configure slice 0 to send encrypted traffic with client rate as 100G and
trunk rate as 200G.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# hw-module location 0/RP0/CPU0 slice 0 client bitrate 100G trunk
bitrate 200G softdecision7 encrypted
The following example shows how to enable LLDP drop at slice 0.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# hw-module location 0/RP0/CPU0 slice 0 client bitrate 40G trunk
bitrate 200G fec softDecision7
RP/0/RP0/CPU0:ios(config)# hw-module location 0/RP0/CPU0 slice 0 drop-lldp
Command Reference for Cisco NCS 1000 Series
18
Commands
key
key
To create or modify a keychain key, use the key command in keychain configuration mode.
key key-id
Syntax Description
key-id
Command Default
No default behavior or values.
Command Modes
Key chain configuration
Command History
64-character hexadecimal string.
Release
Modification
Release 6.1.1
This command was introduced.
Usage Guidelines
The key name must be of even number of characters and must match on both the sides.
Examples
The following example shows how to use the key command.
configure
key chain mac_chain macsec
key 1234abcd5678
Command Reference for Cisco NCS 1000 Series
19
Commands
key chain
key chain
To create or modify a keychain, use the key chain command in global configuration mode.
key chain key-chain-name
Syntax Description
key-chain-name
Command Default
No default behavior or values.
Command Modes
Global configuration
Command History
Examples
Release
Modification
R6.1.1
This command was introduced.
The following example shows how you can configure a key chain for MACsec encryption.
configure
key chain mac_chain macsec
Command Reference for Cisco NCS 1000 Series
20
Specifies the name of the keychain that can be up to 32 characters.
Commands
key-server-priority
key-server-priority
To configure the preference for a device to serve as the key server for MACsec encryption, use the
key-server-priority command in MACsec policy configuration mode.
key-server-priority value
Syntax Description
value
Indicates the priority for a device to become the key server. Lower the value, higher
the preference. The range is 0 to 255.
Command Default
The default value is 16.
Command Modes
MACsec policy configuration
Command History
Examples
Release
Modification
Release 6.1.1
This command was introduced.
The following example shows how to use the key-server-priority command.
configure
macsec-policy mac_policy
key-server-priority 0
Command Reference for Cisco NCS 1000 Series
21
Commands
key-string
key-string
To specify the text string for the key, use the key-string command in keychain configuration mode.
key-string [clear | password] key-string-text
Syntax Description
clear
Specifies the key string in clear-text form.
password
Specifies the key in encrypted form.
key-string-text
Text string for the key, which is encrypted before being saved to the configuration.
The text string has the following character limitations.
• Plain-text key strings—Minimum of 1 character and a maximum of 64
hexadecimal characters for 256-bit encryption. Minimum of 1 character and a
maximum of 32 hexadecimal characters for 128-bit encryption.
• Encrypted key strings—Minimum of 4 characters and no maximum.
Command Default
The default value is clear.
Command Modes
Key chain configuration
Command History
Examples
Release
Modification
Release 6.1.1
This command was introduced.
The following example shows how to use the keystring command.
configure
key chain mac_chain macsec
key 1234abcd5678
key-string 12345678123456781234567 cryptographic-algorithm aes-128-cmac
Command Reference for Cisco NCS 1000 Series
22
Commands
lifetime
lifetime
Configures the validity period for the MACsec key.
The lifetime period (validity period of the key) can be configured, with a duration in seconds, as a validity
period between two dates (for example, Jan 01 2016 to Dec 31 2016), or with infinite validity.
The key is valid from the time you configure (in HH:MM:SS format). The duration is configured in seconds.
lifetime start_time start_date { end_time end_date | duration validity | infinite }
Syntax Description
start_time
Start time in hh:mm:ss from which the key becomes valid. The range is from
0:0:0 to 23:59:59.
start_date
The date in DD month YYYY format that the key becomes valid.
end_time
End time in hh:mm:ss at which point the key becomes invalid. The range is
from 0:0:0 to 23:59:59.
end_date
The date in DD month YYYY format that the key becomes invalid.
duration validity
The key chain is valid for the duration you configure. You can configure
duration in seconds.
infinite
The key chain is valid indefinitely.
Command Default
No default behavior or values
Command Modes
Keychain configuration
Command History
Examples
Release
Modification
R6.1.1
This command was introduced.
The following example shows how to use the lifetime command.
configure
key chain mac_chain macsec
key 1234abcd5678
key-string 123456781234567812345678 cryptographic-algorithm aes-128-cmac
lifetime 05:00:00 20 july 2016 12:00:00 30 september 2016
Command Reference for Cisco NCS 1000 Series
23
Commands
macsec
macsec
To apply the MACsec key chain and policy configuration on the MACsec controller, use the macsec command
in controller configuration mode.
macsec psk-keychain key-chain-name [policy policy-name]
Syntax Description
key-chain-name
Specifies the name of the keychain
that can be up to 32 characters.
policy_name
Name of the MACsec policy for
encryption.
Command Default
No default behavior or values.
Command Modes
Controller configuration
Command History
Examples
Release
Modification
R6.1.1
This command was introduced.
The following example shows how to use the macsec psk-keychain command.
configure
controller MACSecCtrl 0/0/0/3
macsec psk-keychain mac_chain policy mac_policy
exit
commit
Command Reference for Cisco NCS 1000 Series
24
Commands
macsec-policy
macsec-policy
To create a MACsec policy for MACsec encryption, use the macsec-policy command in global configuration
mode.
macsec-policy policy_name
Syntax Description
policy_name
Command Default
No default behavior or values.
Command Modes
Global configuration
Command History
Examples
Name of the MACsec policy for encryption.
Release
Modification
R6.1.1
This command was introduced.
The following example shows how to use the macsec-policy command.
configure
macsec-policy mac_policy
Command Reference for Cisco NCS 1000 Series
25
Commands
pm
pm
To configure the performance monitoring parameters of the optics, Ethernet, and coherent DSP controllers,
use the pm command in the controller configuration mode.
pm [15-min | 24-hour] [optics | ether | fec | otn] [report | threshold] value
Syntax Description
15-min | 24-hour
Configures performance monitoring parameters for 15 minute or 24 hour
intervals.
optics | ether | fec | otn
Specifies whether to configure performance monitoring parameters for
the optics, Ethernet, or coherent DSP controllers.
report
Configures optics TCA reporting status.
threshold
Configures threshold on optics parameters.
value
Value of the reporting or threshold parameters.
Command Default
None
Command Modes
Optics controller configuration
Command History
Usage Guidelines
Release
Modification
Release 6.0.0
This command was introduced.
Release 6.0.1
The IN_DROP_OTHER, OUT-OCTET, TX_UNDERSIZED_PKT,
TX_OVERSIZED_PKT, TX_FRAGMENTS, TX_JABBER, TX_BAD_FCS
statistics were introduced.
The following table describes the optics PM parameters.
Parameter
Description
cd
Chromatic dispersion TCA reporting status or threshold
dgd
Differential group delay TCA reporting status or threshold
lbc
lbc TCA reporting status or threshold
lbc-pc
lbc percentage TCA reporting status or threshold
Command Reference for Cisco NCS 1000 Series
26
Commands
pm
Parameter
Description
opr
opr TCA reporting status or threshold
opt
opt TCA reporting status or threshold
osnr
Optical Signal to Noise Ratio TCA reporting status or threshold
pcr
Polarization Change Rate TCA reporting status or threshold
pdl
Polarization Dependent Loss TCA reporting status or threshold
pn
Phase Noise TCA reporting status or threshold
sopmd
Second Order Polarization Mode Dispersion TCA reporting status or threshold
The following table describes the OTN PM parameters.
Parameter
Description
ES-NE
Error seconds in the near end
ESR-NE
Error seconds ratio in the near end
SES-NE
Severely error seconds in the near end
SESR-NE
Severely error seconds ratio in the near end
UAS-NE
Unavailable seconds in the near end
BBE-NE
Background block errors in the near end
BBER-NE
Background block errors ratio in the near end
FC-NE
Failure counts in the near end
ES-FE
Error seconds in the far end
ESR-FE
Error seconds ratio in the far end
SES-FE
Severely error seconds in the far end
SESR-FE
Severely error seconds ratio in the far end
UAS-FE
Unavailable seconds in the far end
BBE-FE
Background block errors in the far end
BBER-FE
Background block errors ratio in the far end
Command Reference for Cisco NCS 1000 Series
27
Commands
pm
Parameter
Description
FC-FE
Failure counts in the far end
The following table describes the Ethernet PM parameters.
Note
You can view details of the undersized and fragmented packets that are dropped in the ingress side in the
100G mode in the STAT-UNDERSIZED-PKT and IN_ERROR_FRAGMENTS ingress counters. These
details are not available on the egress counters such as TX_UNDERSIZED_PKT and TX_FRAGMENTS.
All the dropped packets are counted as part of the IN_DROP_OTHER drop counter.
Parameter
Description
RX-UTIL
Bandwidth utilization of port at the ingress side in percentage.
TX-UTIL
Bandwidth utilization of port at egress side in percentage.
RX-PKT
Number of received packets
STAT-PKT
Status of received packets
OCTET-STAT
Total number of octets of data received in the network
OVERSIZE-PKT
Total number of packets received that were longer than 1518 octets and were
otherwise well formed
JABBER-STATS
Total number of packets received that were longer than 1518 octets (excluding
framing bits, but including FCS octets), and had either a bad FCS with an
integral number of octets (FCS Error) or a bad FCS with a non-integral number
of octets (Alignment Error)
IN_PKT_64_OCTET
Total number of packets received that were 64 octets in length
IN_PKT_65_127_OCTET Total number of packets received that were between 65 and 127 octets in length
IN_PKT_128_255_OCTET Total number of packets received that were between 128 and 255 octets in
length
IN_PKT_256_511_OCTET Total number of packets received that were between 256 and 511 octets in
length
IN_PKT_512_1023_OCTET Total number of packets received that were between 512 and 1023 octets in
length
IN_PKT_1024_1518_OCTET Total number of packets received that were between 1024 and 1518 octets in
length
IN-UCAST
Command Reference for Cisco NCS 1000 Series
28
Total number of unicast frames received error-free
Commands
pm
Parameter
Description
IN-MCAST
Total number of multicast frames received error-free
IN-BCAST
Total number of broadcast frames received error-free
OUT-UCAST
Total number of unicast frames transmitted error-free
OUT-BCAST
Total number of broadcast frames transmitted error-free
OUT-MCAST
Total number of multicast frames transmitted error-free
TX-PKT
Number of transmitted packets
OUT-OCTET
Total number of octets transmitted out of the interface, including framing
characters
STAT-MULTICAST-PKT Status of multicast packets
STAT-BROADCAST-PKT Status of broadcast packets
STAT-UNDERSIZED-PKT Number of good packets received that are shorter than 64 bytes.
IN_ERROR_FRAGMENTS Number of bad packets received that are shorter than 64 bytes.
IN_DROP_OTHER
Total number of packets dropped. In the 100 G mode, undersized and
fragmented packets are dropped
OUT-OCTET
Total number of bytes transmitted
TX_UNDERSIZED_PKT Total number of packets transmitted that are shorter than 64 bytes.
TX_OVERSIZED_PKT
Total number of oversized packets transmitted.
TX_FRAGMENTS
Total number of fragmented packets transmitted.
TX_JABBER
Total number of Jabber packets transmitted.
TX_BAD_FCS
Total number of bad FCS packets transmitted.
The following table describes the FEC PM parameters.
Parameter
Description
ec-bits
Number of bit errors that are corrected by the system
uc-words
Number of words that are not corrected by the system
Command Reference for Cisco NCS 1000 Series
29
Commands
pm
Examples
The following example shows how to set the maximum TCA reporting status for the chromatic dispersion.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# controller optics 0/0/0/0 pm 15-min optics report cd max-tca
enable
The following example shows how to set the maximum threshold for the chromatic dispersion.
RP/0/RP0/CPU0:ios# configure
RP/0/RP0/CPU0:ios(config)# controller optics 0/0/0/0 pm 15-min optics threshold cd max
Command Reference for Cisco NCS 1000 Series
30
Commands
security-policy
security-policy
To configure the type of data (encrypted data or all data) that is allowed through the controller configured
with MACsec, use the security-policy command in MACsec policy configuration mode.
security-policy {should-secure | must-secure}
Syntax Description
should-secure
Configures the controller on which the MACsec policy is applied, to permit
all data.
must-secure
Configures the controller on which the MACsec policy is applied, to permit
only MACsec encrypted data.
Command Default
The default value is must-secure that indicates unencrypted packets cannot be transmitted or received except
MKA control protocol packets.
Command Modes
MACsec policy configuration
Command History
Examples
Release
Modification
R6.1.1
This command was introduced.
The following example shows how to use the security-policy command.
configure
macsec-policy mac_policy
security-policy must-secure
Command Reference for Cisco NCS 1000 Series
31
Commands
show alarms
show alarms
To display alarms in brief or detail, use the show alarms command in XR EXEC mode or Administration
EXEC mode.
show alarms brief [card [ location location ] | rack | system ] [ active | history ] ]
show alarms detail [card [ location location ]| rack | system ] [ active | clients | history | stats ] ]
Syntax Description
brief
Displays alarms in brief.
card
Displays card scope alarms related data.
rack
Displays rack scope alarms related data.
system
Displays system scope alarms related data.
location location
Specifies the target location in the rack/slot notation.
active
Displays active alarms.
history
Displays alarm history.
detail
Displays alarms in detail.
clients
Displays clients associated with the service.
stats
Displays service statistics.
Command Default
None
Command Modes
XR EXEC
Administration EXEC
Command History
Usage Guidelines
Release
Modification
Release 6.0 .0
This command was introduced.
This command displays the alarms in brief or detail. The command displays only the administration alarms
in admin EXEC mode and all the alarms in XR EXEC mode.
Command Reference for Cisco NCS 1000 Series
32
Commands
show alarms
Task ID
Examples
Task ID
Operation
fault
read
The following example shows the output of the show alarms command.
sysadmin-vm:0_RP0# show alarms
Thu Dec
17 02:15:12.873 UTC
----------------------------------------------------------------------------------------------------------------Active Alarms
----------------------------------------------------------------------------------------------------------------Location
Severity
Group
Set time
Description
----------------------------------------------------------------------------------------------------------------0/PM0
major
environ
12/16/15 21:43:19
Power Module
Output Disabled
(PM_OUTPUT_EN_PIN_HI)
0
major
environ
12/16/15 21:43:19
Power Shelf
redundancy lost
RP/0/RP0/CPU0:ios# show alarms brief card location 0/RP0/CPU0 active
Thu Dec 17 02:20:34.592 UTC
-------------------------------------------------------------------------------Active Alarms (Brief) for 0/RP0
-------------------------------------------------------------------------------Location
Severity
Group
Set Time
Description
-------------------------------------------------------------------------------0/0
Minor
Controller
12/16/2015 21:45:42
Optics0/0/0
/2 - Optics Low Receive Power
-------------------------------------------------------------------------------History Alarms (Brief) for 0/RP0
-------------------------------------------------------------------------------Location
Severity
Group
Set Time
Description
Clear Time
-------------------------------------------------------------------------------0/0
Minor
Controller
12/16/2015 21:45:42
Optics0/0/0
/12 - Optics High Differential Group Delay
12/16/2015 21:45:53
0/0
Minor
Controller
12/16/2015 21:45:42
/12 - Optics Out of Range Chromatic Dispersion
Optics0/0/0
RP/0/RP0/CPU0:ios# show alarms brief card location 0/RP0/CPU0 active
Mon Oct 24 11:57:16.591 UTC
-----------------------------------------------------------------------------------Active Alarms
-----------------------------------------------------------------------------------Location
Severity
Group
Set Time
Description
-----------------------------------------------------------------------------------0/RP0/CPU0
Minor
Power
10/24/2016 11:56:46 UTC
patch-panel power
redundancy lost
Command Reference for Cisco NCS 1000 Series
33
Commands
show alarms
RP/0/RP0/CPU0:ios# show alarms brief card location 0/RP0/CPU0 active
Mon Oct 24 11:58:45.596 UTC
-----------------------------------------------------------------------------------Active Alarms
-----------------------------------------------------------------------------------Location
Severity
Group
Set Time
Description
-----------------------------------------------------------------------------------0/RP0/CPU0
Minor
Software
10/24/2016 11:58:25 UTC
Not able to
communicate with patch-panel
Command Reference for Cisco NCS 1000 Series
34
Commands
show controllers
show controllers
To display status and configuration information about the interfaces on a specific node, use the show controllers
command in XR EXEC mode.
show controllers controllertype R/S/I/P [headless-stats] | [dwdm-carrrier-map] | [pm {current | history}
{15-min | 24-hour} {optics | ether} linenumber {otn | fec} ] | [lldp-snoop] | [stats] | [summary]
Syntax Description
controllertype
Type of the controller. The possible values are HundredGigECtrlr, TenGigECtrlr,
maCSecCtrlr, CoherentDSP, and Optics.
R/S/I/P/L
Rack/Slot/Instance/Port/Lane number of the controller.
If the controller type is TenGigECtrlr, include the lane number after the port
number.
headless-stats
Displays the statistics collected during the last headless operation. The collected
statistics is preserved for a slice until the hw-module configuration is removed or
changed on that slice or until the next headless operation. The statistics is also
preserved across process restarts.
dwdm-carrrier-map
(only for trunk optics controllers) Displays the wavelength and channel mapping.
pm
Displays performance monitoring parameters for the controller.
current
Displays the current performance monitoring data in 15 minute and 24 hour
intervals.
history
Displays the historical performance monitoring data in 15 minute and 24 hour
intervals.
optics | ether
optics to display the PM data for Optics controller and ether to display the PM
data for Ethernet controller.
linenumber
Line number to display performance monitoring data. The range is 1 to 12.
otn | fec
Displays OTN PM data or FEC PM data for CoherentDSP controller.
lldp-snoop
Displays the MAC address and other details about the LLDP neighbor from Release
6.0.1. Verify that the MAC address displayed is same as the MAC address of the
traffic generating port.
stats
Displays the cumulative statistics of the controller port.
summary
Displays brief information about MACSecCtrlrs in a tabular format. This parameter
cannot be used with the stats parameter.
Command Reference for Cisco NCS 1000 Series
35
Commands
show controllers
Usage Guidelines
Statistics are not preserved across Cisco IOS XR or system reloads. Up to five seconds of data is lost when
the mxp-driver process restarts. The stats output also includes the statistics collected when the system is in
headless mode.
Command Default
The status and configuration information of all the interfaces is displayed.
Command Modes
XR EXEC
Command History
Release
Modification
6.0.0
This command was introduced.
6.0.1
The display for LLDP snooping
was expanded to include more
details about the LLDP neighbor.
A new keyword stats was
introduced to display the
cumulative statistics of the Ethernet
controller port.
Usage Guidelines
6.1.1
MACSecCtrlr was introduced as
one of the controller types.
6.1.2
The output of lldp-snoop keyword
is updated.
• For QSFP-40G-SR-BD pluggable, the output of show controllers optics command does not display the
transmit and receive optics parameters such as transmit and receive power.
• When breakout patch panel is used, the output of show controllers TenGigECtrlr command displays
the LED status of the patch panel instead of LED status of the physical port. When breakout patch panel
is not used, the output displays the alarm status of the Ethernet layer or controller.
Examples
RP/0/RP0/CPU0:ios# show controllers coherentDSP 0/0/0/13
Tue Feb 13 15:42:38.708 UTC
Port
Controller State
Secondary State
Derived State
Loopback mode
BER Thresholds
Performance Monitoring
Command Reference for Cisco NCS 1000 Series
36
:
:
:
:
:
:
:
CoherentDSP 0/0/0/13
Up
Normal
In Service
None
SF = 1.0E-5 SD = 1.0E-7
Enable
Commands
show controllers
Alarm Information:
LOS = 1 LOF = 0 LOM = 1
OOF = 0 OOM = 0 AIS = 0
IAE = 0 BIAE = 0
SF_BER = 0
SD_BER = 0
BDI = 0 TIM = 0
FECMISMATCH = 0 FEC-UNC = 0
Detected Alarms
OTU TTI Sent
OPERATOR SPECIFIC
ASCII
:
:
: 00000000000000000000000000000000
: 00000000000000000000000000000000
OPERATOR SPECIFIC HEX
OTU TTI Received
OPERATOR SPECIFIC
ASCII
:
:
: 20202020202020202020202020202020
: 00000000000000000000000000000000
OPERATOR SPECIFIC HEX
OTU TTI Expected
OPERATOR SPECIFIC
: None
ASCII
:
:
:
:
:
:
OPERATOR SPECIFIC HEX
FEC mode
Network SRLG values
00000000000000000000000000000000
00000000000000000000000000000000
Soft-Decision 7
Not Configured
The table below describes the significant fields shown in the above example.
Field
Description
Port
Rack/Slot/Instance/Port of the coherent DSP controller.
Controller State
State of the controller that can be one of the following:
• Admin Down
• Down
• Up
Secondary State
Secondary state of the controller that can be one of the following:
• Normal
• Maintenance
Derived State
Derived state of the controller that can be one of the following:
• Out Of Service
• In Service
• Maintenance
Loopback mode
Loopback mode of the controller that can be one of the following:
• None
• Line
• Internal
Command Reference for Cisco NCS 1000 Series
37
Commands
show controllers
Field
Description
BER Thresholds
Bit Error Rate (BER) that can be one of the following:
• SD_BER—Signal Degrade Bit Error Rate (SD-BER) threshold
• SF_BER—Signal Fail-Bit Error Rate threshold
Performance Monitoring
Specifies if performance monitoring is enabled or not:
• Disable
• Enable
Alarm Information
Summarizes the alarm details:
• LOS—Loss of Signal
• LOF—Loss of Frame
• LOM—Loss of MultiFrame
• BDI—Backward Defect Indication
• TIM—Trace Identifier Mismatch
• SF_BER—SF BER alarm
• SD_BER—SD BER alarm
• FECUNC—FEC Uncorrected Word
Detected Alarms
Summarizes the detected alarms:
• None
• LOS—Loss of Signal
• LOF—Loss of Frame
• LOM—Loss of MultiFrame
• BDI—Backward Defect Indication
• TIM—Trace Identifier Mismatch
• SF_BER—SF BER alarm
• SD_BER—SD BER alarm
• FECUNC—FEC Uncorrected Word
OTU TTI Sent
Specifies the sent OTU Trail Trace Identifier (TTI)
OTU TTI Received
Specifies the received OTU TTI.
OTU TTI Expected
Specifies the expected OTU TTI.
Command Reference for Cisco NCS 1000 Series
38
Commands
show controllers
Field
Description
FEC mode
Specifies the FEC mode:
• Soft-Decision 7
• Soft-Decision 20
Network SRLG
Shared Risk Link Groups (SRLGs). Not supported on NCS 1002
RP/0/RP0/CPU0:ios# show controllers optics 0/0/0/0
Thu Dec 17 02:37:28.029 UTC
optics: Driver is not sending wave channel number and grey wavelength.
Controller State: Up
Transport Admin State: In Service
Laser State: Off
LED State: Off
Optics Status
Optics Type:
Grey optics
Alarm Status:
------------Detected Alarms: None
LOS/LOL/Fault Status:
Alarm Statistics:
HIGH-RX-PWR = 0
HIGH-TX-PWR = 0
HIGH-LBC = 0
OOR-CD = 0
WVL-OOL = 0
IMPROPER-REM = 0
LOW-RX-PWR = 0
LOW-TX-PWR = 0
HIGH-DGD = 0
OSNR = 0
MEA = 0
Performance Monitoring: Enable
Rx Low Threshold = -12.0 dBm
Rx High Threshold = 4.9 dBm
Tx Low Threshold = -10.1 dBm
Tx High Threshold = 3.5 dBm
Configured Tx Power = 0.00 dBm
LBC High Threshold = 98 percentage
Polarization parameters not supported by optics
Lane
---1
2
3
4
Laser Bias
---------0.0 %
0.0 %
0.0 %
0.0 %
TX Power
RX Power
---------- ----------40.00 dBm -10.58 dBm
-40.00 dBm
-9.76 dBm
-40.00 dBm -11.80 dBm
-40.00 dBm
-9.42 dBm
Network SRLG values:
Not Configured
Command Reference for Cisco NCS 1000 Series
39
Commands
show controllers
RP/0/RP0/CPU0:ios# show controllers hundredGigECtrlr 0/0/0/7 headless-stats
Mon Apr 18 19:49:44.536 UTC
Started in Stateful mode: Yes
Headless Start Time: Mon Apr 18 17:57:04 2016
Headless End
Time: Mon Apr 18 18:07:32 2016
Ethernet Headless Statistics
RxPktsOverSized
: 0
RxPktsBadFcs
: 0
RxErrorJabbers
: 0
RxPktsMulticast
: 0
RxPktsBroadcast
: 0
RxPktsUnicast
: 0
RxPktsUnderSized
: 0
RxPkts
: 0
RxBytesGood
: 0
RxPktsGood
: 0
RxRecvFragments
: 0
RxPkts64Bytes
: 0
RxPkts65To127Bytes
: 0
RxPkts128to255Bytes
: 0
RxPkts256To511Bytes
: 0
RxPkts512To1023Bytes
: 0
RxPkts1024To1518Bytes : 0
RxTotalBytes
: 0
RxPktsDrop
: 0
TxPkts
: 0
TxTotalBytes
: 0
TxPktsUndersized
: 0
TxPktsOversized
: 0
TxPktsFragments
: 0
TxPktsJabber
: 0
TxPktsBadFcs
: 0
RP/0/RP0/CPU0:ios# show controllers optics 0/0/0/11 dwdm-carrrier-map
Thu Aug 27 15:59:00.385 UTC
DWDM Carrier Band:: C-Band
MSA ITU channel range supported: 1~97
DWDM Carrier Map table
---------------------------------------------------ITU Ch
G.694.1
Frequency
Wavelength
Num
Ch Num
(THz)
(nm)
---------------------------------------------------1
60
196.10
1528.773
---------------------------------------------------2
59
196.05
1529.163
---------------------------------------------------3
58
196.00
1529.553
---------------------------------------------------4
57
195.95
1529.944
---------------------------------------------------5
56
195.90
1530.334
---------------------------------------------------6
55
195.85
1530.725
---------------------------------------------------7
54
195.80
1531.116
---------------------------------------------------8
53
195.75
1531.507
---------------------------------------------------9
52
195.70
1531.898
---------------------------------------------------10
51
195.65
1532.290
---------------------------------------------------11
50
195.60
1532.681
---------------------------------------------------12
49
195.55
1533.073
---------------------------------------------------13
48
195.50
1533.465
----------------------------------------------------
Command Reference for Cisco NCS 1000 Series
40
Commands
show controllers
14
47
195.45
1533.858
---------------------------------------------------15
46
195.40
1534.250
---------------------------------------------------16
45
195.35
1534.643
---------------------------------------------------17
44
195.30
1535.036
---------------------------------------------------18
43
195.25
1535.429
---------------------------------------------------19
42
195.20
1535.822
---------------------------------------------------20
41
195.15
1536.216
---------------------------------------------------21
40
195.10
1536.609
---------------------------------------------------22
39
195.05
1537.003
---------------------------------------------------23
38
195.00
1537.397
---------------------------------------------------24
37
194.95
1537.792
---------------------------------------------------25
36
194.90
1538.186
---------------------------------------------------26
35
194.85
1538.581
---------------------------------------------------27
34
194.80
1538.976
---------------------------------------------------28
33
194.75
1539.371
---------------------------------------------------29
32
194.70
1539.766
---------------------------------------------------30
31
194.65
1540.162
---------------------------------------------------31
30
194.60
1540.557
---------------------------------------------------32
29
194.55
1540.953
---------------------------------------------------33
28
194.50
1541.349
---------------------------------------------------34
27
194.45
1541.746
---------------------------------------------------35
26
194.40
1542.142
---------------------------------------------------36
25
194.35
1542.539
---------------------------------------------------37
24
194.30
1542.936
---------------------------------------------------38
23
194.25
1543.333
---------------------------------------------------39
22
194.20
1543.730
---------------------------------------------------40
21
194.15
1544.128
---------------------------------------------------41
20
194.10
1544.526
---------------------------------------------------42
19
194.05
1544.924
---------------------------------------------------43
18
194.00
1545.322
---------------------------------------------------44
17
193.95
1545.720
---------------------------------------------------45
16
193.90
1546.119
---------------------------------------------------46
15
193.85
1546.518
---------------------------------------------------47
14
193.80
1546.917
---------------------------------------------------48
13
193.75
1547.316
---------------------------------------------------49
12
193.70
1547.715
---------------------------------------------------50
11
193.65
1548.115
Command Reference for Cisco NCS 1000 Series
41
Commands
show controllers
---------------------------------------------------51
10
193.60
1548.515
---------------------------------------------------52
9
193.55
1548.915
---------------------------------------------------53
8
193.50
1549.315
---------------------------------------------------54
7
193.45
1549.715
---------------------------------------------------55
6
193.40
1550.116
---------------------------------------------------56
5
193.35
1550.517
---------------------------------------------------57
4
193.30
1550.918
---------------------------------------------------58
3
193.25
1551.319
---------------------------------------------------59
2
193.20
1551.721
---------------------------------------------------60
1
193.15
1552.122
---------------------------------------------------61
0
193.10
1552.524
---------------------------------------------------62
-1
193.05
1552.926
---------------------------------------------------63
-2
193.00
1553.329
---------------------------------------------------64
-3
192.95
1553.731
---------------------------------------------------65
-4
192.90
1554.134
---------------------------------------------------66
-5
192.85
1554.537
---------------------------------------------------67
-6
192.80
1554.940
---------------------------------------------------68
-7
192.75
1555.343
---------------------------------------------------69
-8
192.70
1555.747
---------------------------------------------------70
-9
192.65
1556.151
---------------------------------------------------71
-10
192.60
1556.555
---------------------------------------------------72
-11
192.55
1556.959
---------------------------------------------------73
-12
192.50
1557.363
---------------------------------------------------74
-13
192.45
1557.768
---------------------------------------------------75
-14
192.40
1558.173
---------------------------------------------------76
-15
192.35
1558.578
---------------------------------------------------77
-16
192.30
1558.983
---------------------------------------------------78
-17
192.25
1559.389
---------------------------------------------------79
-18
192.20
1559.794
---------------------------------------------------80
-19
192.15
1560.200
---------------------------------------------------81
-20
192.10
1560.606
---------------------------------------------------82
-21
192.05
1561.013
---------------------------------------------------83
-22
192.00
1561.419
---------------------------------------------------84
-23
191.95
1561.826
---------------------------------------------------85
-24
191.90
1562.233
---------------------------------------------------86
-25
191.85
1562.640
----------------------------------------------------
Command Reference for Cisco NCS 1000 Series
42
Commands
show controllers
87
-26
191.80
1563.047
---------------------------------------------------88
-27
191.75
1563.455
---------------------------------------------------89
-28
191.70
1563.863
---------------------------------------------------90
-29
191.65
1564.271
---------------------------------------------------91
-30
191.60
1564.679
---------------------------------------------------92
-31
191.55
1565.087
---------------------------------------------------93
-32
191.50
1565.496
---------------------------------------------------94
-33
191.45
1565.905
---------------------------------------------------95
-34
191.40
1566.314
---------------------------------------------------96
-35
191.35
1566.723
---------------------------------------------------97
-36
191.30
1567.133
----------------------------------------------------
RP/0/RP0/CPU0:ios# show controllers hundredGigECtrlr 0/0/0/14
Tue Feb 13 15:40:30.389 UTC
Operational data for interface HundredGigECtrlr0/0/0/14:
State:
Administrative state: enabled
Operational state: Up
LED state: Red On
Maintenance: Disabled
AINS Soak: None
Phy:
Alarms:
Current:
Loss of Signal
Autonegotiation disabled.
Operational values:
Speed: 100Gbps
Duplex: Full Duplex
Flowcontrol: None
RP/0/RP0/CPU0:ios# show controllers TenGigECtrlr0/0/0/1/* | inc LED
Tue Oct
LED
LED
LED
LED
25:40:30.389 UTC
state: Red On
state: Green On
state: Green On
state: Green On
RP/0/RP0/CPU0:ios# show controllers optics 0/0/0/1 pm current 15-min optics 1
Fri Aug 21 09:28:57.608 UTC
Optics in the current interval [ 9:15:00 - 09:28:57 Fri Aug 21 2015]
Optics current bucket type : Valid
MIN
AVG
MAX
LBC[% ]
OPT[dBm]
OPR[dBm]
: 0.0
: -inf
: -inf
0.0
-inf
-inf
0.0
-inf
-inf
Threshold TCA
(min)
(enable)
0.0
NO
0.00
NO
0.00
NO
Threshold TCA
(max)
(enable)
0.0
NO
0.00
NO
0.00
NO
Command Reference for Cisco NCS 1000 Series
43
Commands
show controllers
Last clearing of "show controllers OPTICS" counters never
RP/0/RP0/CPU0:ios# show controllers coherentDSP 0/0/0/13 pm current 15-min otn
Tue Feb 13 15:43:00.173 UTC
g709 OTN in the current interval [15:30:00 - 15:43:00 Tue Feb 13 2001]
OTN current
ES-NE
ESR-NE
SES-NE
SESR-NE
UAS-NE
BBE-NE
BBER-NE
FC-NE
ES-FE
ESR-FE
SES-FE
SESR-FE
UAS-FE
BBE-FE
BBER-FE
FC-FE
bucket type
: 0
: 0.00000
: 0
: 0.00000
: 0
: 0
: 0.00000
: 0
: Valid
Threshold
Threshold
Threshold
Threshold
Threshold
Threshold
Threshold
Threshold
:
:
:
:
:
:
:
:
500
0.00000
500
0.00000
500
10000
0.00000
10
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
:
:
:
:
:
:
:
:
YES
NO
YES
NO
YES
YES
NO
YES
:
:
:
:
:
:
:
:
Threshold
Threshold
Threshold
Threshold
Threshold
Threshold
Threshold
Threshold
:
:
:
:
:
:
:
:
500
0.00000
500
0.00000
500
10000
0.00000
10
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
TCA(enable)
:
:
:
:
:
:
:
:
YES
NO
YES
NO
YES
YES
NO
YES
0
0.00000
0
0.00000
0
0
0.00000
0
Last clearing of "show controllers OTU" counters never
RP/0/RP0/CPU0:ios# show controllers coherentDSP 0/0/0/13 pm current 15-min fec
Tue Feb 13 15:43:05.054 UTC
g709 FEC in the current interval [15:30:00 - 15:43:05 Tue Feb 13 2001]
FEC current bucket type : Valid
EC-BITS
: 407265375460
Threshold : 903330
UC-WORDS : 0
Threshold : 5
TCA(enable)
TCA(enable)
: YES
: YES
Last clearing of "show controllers OTU" counters never
The following example shows the details about the LLDP neighbor. These details are available from Release
6.0.1.
RP/0/RP0/CPU0:ios# show controllers FortyGigECtrlr 0/0/0/0 lldp-snoop
Thu Apr 28 09:49:20.684 UTC
Capability codes:R) Router, (B) Bridge, (T) Telephone, (C) DOCSIS Cable Device
(W) WLAN Access Point, (P) Repeater, (S) Station, (O) Other
LLDP Neighbor Snoop Data
Local Controller:
FortyGigECtrlr0/0/0/0
Source MAC Address:
0010.9400.0044
Chassis ID:
50.1.1.10
Port ID:
0010.9400.0044
Port Description:
Spirent Port ROSCO
System Name:
Spirent Test CenterROSCO1111111111111
System Description:
Spirent Test Center ddddddddddddd
Hold Time(TTL):
20 seconds
System Capabilities: R
Enabled Capabilities: R
Management Address:
IPv4 address: 50.1.1.10
LLDP Packet Drop enabled: TRUE
RX LLDP Packet Count : 0
Command Reference for Cisco NCS 1000 Series
44
Commands
show controllers
The following example shows the PM data for Ethernet controller in Release 6.0.1.
RP/0/RP0/CPU0:ios# show controllers hundredGigECtrlr 0/0/0/7 pm current 15-min ether
Mon Apr 18 19:22:10.782 UTC
ETHER in the current interval [19:15:00 - 19:22:10 Mon Apr 18 2016]
ETHER current bucket type : Valid
RX-UTIL[%]:
0.00 Threshold : 0.00
TCA(enable) : NO
TX-UTIL[%]:
0.00 Threshold : 0.00
TCA(enable) : NO
RX-PKT :
0 Threshold :
0 TCA(enable) : NO
STAT-PKT :
0 Threshold :
0 TCA(enable) : NO
OCTET-STAT :
0 Threshold :
0 TCA(enable) : NO
OVERSIZE-PKT :
0 Threshold :
0 TCA(enable) : NO
FCS-ERR :
0 Threshold :
0 TCA(enable) : NO
LONG-FRAME :
0
Threshold :
0 TCA(enable) : NO
JABBER-STATS :
0 Threshold :
0 TCA(enable) : NO
64-OCTET :
0 Threshold :
0 TCA(enable) : NO
65-127-OCTET :
0 Threshold :
0 TCA(enable) : NO
128-255-OCTET :
0 Threshold :
0 TCA(enable) : NO
256-511-OCTET :
0 Threshold :
0 TCA(enable) : NO
512-1023-OCTET :
0 Threshold :
0 TCA(enable) : NO
1024-1518-OCTET :
0 Threshold :
0 TCA(enable) : NO
IN-UCAST :
0 Threshold :
0 TCA(enable) : NO
IN-MCAST :
0 Threshold :
0 TCA(enable) : NO
IN-BCAST :
0 Threshold :
0 TCA(enable) : NO
OUT-UCAST :
0 Threshold :
0 TCA(enable) : NO
OUT-BCAST :
0 Threshold :
0 TCA(enable) : NO
OUT-MCAST :
0 Threshold :
0 TCA(enable) : NO
TX-PKT :
0 Threshold :
0 TCA(enable) : NO
OUT-OCTET :
0 Threshold :
0 TCA(enable) : NO
IFIN-ERRORS :
0 Threshold :
0 TCA(enable) : NO
IFIN-OCTETS :
0 Threshold :
0 TCA(enable) : NO
STAT-MULTICAST-PKT : 0 Threshold :
0 TCA(enable) : NO
STAT-BROADCAST-PKT : 0 Threshold :
0 TCA(enable) : NO
STAT-UNDERSIZED-PKT: 0 Threshold :
0 TCA(enable) : NO
IN_GOOD_BYTES :
0
Threshold :
0 TCA(enable) : NO
IN_GOOD_PKTS :
0
Threshold :
0 TCA(enable) : NO
IN_DROP_OTHER :
0
Threshold :
0 TCA(enable) : NO
IN_ERROR_FRAGMENTS :
0
Threshold :
0 TCA(enable) : NO
IN_PKT_64_OCTET :
0
Threshold :
0 TCA(enable) : NO
IN_PKTS_65_127_OCTETS :
0
Threshold :
0 TCA(enable) : NO
IN_PKTS_128_255_OCTETS :
0
Threshold :
0 TCA(enable) : NO
IN_PKTS_256_511_OCTETS :
0
Threshold :
0 TCA(enable) : NO
IN_PKTS_512_1023_OCTETS : 0
Threshold :
0 TCA(enable) : NO
IN_PKTS_1024_1518_OCTETS : 0
Threshold :
0 TCA(enable) : NO
TX_UNDERSIZED_PKT :0
Threshold :
0 TCA(enable) : NO
TX_OVERSIZED_PKT :0
Threshold :
0 TCA(enable) : NO
TX_FRAGMENTS :0
Threshold :
0 TCA(enable) : NO
TX_JABBER :0
Threshold :
0 TCA(enable) : NO
TX_BAD_FCS :0 Threshold :
0 TCA(enable) : NO
The following example shows the cumulative statistics for the Ethernet controller in Release 6.0.1.
RP/0/RP0/CPU0:ios#show controllers hundredGigECtrlr 0/0/0/24 stats
Wed Mar 23 06:43:30.450 UTC
Statistics for interface HundredGigECtrlr0/0/0/24 (cached values):
Ingress:
Input total bytes
Input good bytes
Input
Input
Input
Input
Input
Input
Input
Input
Input
Input
total packets
802.1Q frames
pause frames
pkts 64 bytes
pkts 65-127 bytes
pkts 128-255 bytes
pkts 256-511 bytes
pkts 512-1023 bytes
pkts 1024-1518 bytes
pkts 1519-Max bytes
Input good pkts
Input unicast pkts
Input multicast pkts
= 4802100516736
= 4802100516736
=
=
=
=
=
=
=
=
=
=
37516410287
0
0
0
0
37516410287
0
0
0
0
= 37516410287
= 37516410287
= 0
Command Reference for Cisco NCS 1000 Series
45
Commands
show controllers
Input broadcast pkts
= 0
Input
Input
Input
Input
Input
Input
drop
drop
drop
drop
drop
drop
=
=
=
=
=
=
0
0
0
0
0
0
Input
Input
Input
Input
Input
Input
Input
Input
error
error
error
error
error
error
error
error
=
=
=
=
=
=
=
=
0
0
0
0
0
0
0
0
overrun
abort
invalid VLAN
invalid DMAC
invalid encap
other
giant
runt
jabbers
fragments
CRC
collisions
symbol
other
Input MIB giant
Input MIB jabber
Input MIB CRC
Egress:
Output total bytes
Output good bytes
= 0
= 0
= 0
= 4802100500352
= 0
Output
Output
Output
Output
Output
Output
Output
Output
Output
Output
total packets
802.1Q frames
pause frames
pkts 64 bytes
pkts 65-127 bytes
pkts 128-255 bytes
pkts 256-511 bytes
pkts 512-1023 bytes
pkts 1024-1518 bytes
pkts 1519-Max bytes
=
=
=
=
=
=
=
=
=
=
37516410159
0
0
0
0
0
0
0
0
0
Output
Output
Output
Output
good pkts
unicast pkts
multicast pkts
broadcast pkts
=
=
=
=
0
0
0
0
Output drop underrun
Output drop abort
Output drop other
= 0
= 0
= 0
Output error other
= 0
The following example shows the output for the MACsec controller in Release 6.1.1.
RP/0/RP0/CPU0:ios# show controllers maCSecCtrlr 0/0/0/4
Mon Nov 14 12:08:24.391 IST
Port:
MACSecCtrlr0/0/0/4
------------------------------------Interface Status
------------------------------------Controller state
: Up
ReplayWindowSize
: 64
MustSecure
: TRUE
------------------------------------Encrypted Secure Channel Status
------------------------------------ProtectionEnabled
: TRUE
SecureChannelID
: 0x4000000c8e22a04
ConfidentialityOffset : 0
Command Reference for Cisco NCS 1000 Series
46
Commands
show controllers
CipherSuite
MaxPacketNumber
RecentPacketNumber
:
:
:
GCM-AES-XPN-256
18446744073709551615
0
------------------------------------Encrypted Active Associations
------------------------------------AssociationNumber
: 0
ShortSecureChannelID
: 2
------------------------------------Decrypted Secure Channel Status
------------------------------------ProtectionEnabled
: TRUE
SecureChannelID
: 0xb000000c8e22a04
ConfidentialityOffset : 0
CipherSuite
: GCM-AES-XPN-256
MaxPacketNumber
: 18446744073709551615
RecentPacketNumber
: 0
------------------------------------Decrypted Active Associations
------------------------------------AssociationNumber
: 0
ShortSecureChannelID
: 1
Command Reference for Cisco NCS 1000 Series
47
Commands
show environment
show environment
To display environmental monitor parameters for the system, use the show environment command in
administration EXEC mode.
show environment [ all | fan | power | voltages | current | trace | temperatures ] [ location | location ]
Syntax Description
all
(Optional) Displays information for all the environmental monitor parameters.
fan
(Optional) Displays information about the fans.
power
(Optional) Displays power supply voltage and current information.
voltages
(Optional) Displays system voltage information.
current
(Optional) Displays current sensor information.
temperatures
(Optional) Displays system temperature information.
trace
(Optional) Displays trace data for environment monitoring.
location | location
(Optional) Enter the location for which the environmental information needs
to be displayed.
Command Default
All environmental monitor parameters are displayed.
Command Modes
Administration EXEC
Command History
Usage Guidelines
Task ID
Release
Modification
Release 6.0.0
This command was introduced.
The show environment command displays information about the hardware that is installed in the system,
including fans, power supply voltage, current information, and temperatures.
Task ID
Operation
system
read
Command Reference for Cisco NCS 1000 Series
48
Commands
show environment
Examples
The following example shows sample output from the show environment command with the fan keyword.
sysadmin-vm:0_RP0# show environment fan
Thu Nov 12 02:39:46.390 UTC
=====================================
Fan speed (rpm)
Location
FRU Type
FAN_0
------------------------------------0/FT0
NCS1K-FTA
4800
0/FT1
NCS1K-FTA
4800
0/FT2
NCS1K-FTA
4920
0/PM1
NCS1K-2KW-AC
9152
The following example shows sample output from the show environment command with the temperatures
keyword.
sysadmin-vm:0_RP0# show environment temperatures location 0/RP0
Tue Feb 27 10:32:38.967 UTC
================================================================================
Location
TEMPERATURE
Value
Crit Major Minor Minor Major Crit
Sensor
(deg C)
(Lo) (Lo) (Lo) (Hi) (Hi)
(Hi)
-------------------------------------------------------------------------------0/RP0
Thermistor 1
27
-10
0
0
55
55
85
Thermistor 2
28
-10
0
0
55
55
85
Hot Spot Temperature
26
-10
0
0
55
55
85
The following example shows sample output from the show environment command with the power keyword.
sysadmin-vm:0_RP0# show environment power
Thu Nov 12 02:42:40.177 UTC
================================================================================
CHASSIS LEVEL POWER INFO: 0
================================================================================
Total output power capacity (Group 0 + Group 1) :
0W +
2000W
Total output power required
:
225W
Total power input
:
575W
Total power output
:
538W
Power Group 1:
================================================================================
Power
Supply
------Input---------Output--Status
Module
Type
Volts
Amps
Volts
Amps
================================================================================
0/PM1
2kW-AC
230.0
2.5
12.0
44.8
OK
Total of Power Group 1:
575W/
2.5A
538W/ 44.8A
================================================================================
Location
Card Type
Power
Power
Status
Allocated
Used
Watts
Watts
================================================================================
0/0
NCS1002
70
RESERVED
0/RP0
NCS1K-CNTLR-K9
35
ON
0/FT0
NCS1K-FTA
40
ON
0/FT1
NCS1K-FTA
40
ON
0/FT2
NCS1K-FTA
40
ON
The following example shows sample output from the show environment command with the voltages
keyword.
Command Reference for Cisco NCS 1000 Series
49
Commands
show environment
sysadmin-vm:0_RP0# show environment voltages location 0/RP0
Thu Nov 12 02:45:49.213 UTC
================================================================================
Location VOLTAGE
Value
Crit Minor Minor Crit
Sensor
(mV)
(Lo) (Lo) (Hi)
(Hi)
-------------------------------------------------------------------------------0/RP0
VP1P0_CPU
996
900
950 1050 1100
CPU_CORE_VCC
889
400
450 1350 1400
CPU_CORE_VNN
979
400
450 1350 1400
VP1P1
1067
990 1050 1160 1210
VP1P2
1194
1080 1140 1260 1320
VP1P35_DDR
1344
1220 1280 1420 1490
VP1P35
1338
1220 1280 1420 1490
VP1P5
1495
1350 1430 1580 1650
VP1P8_CPU
1793
1620 1710 1890 1980
VP3P3_STBY
3305
2970 3140 3470 3630
VP3P3
3334
2970 3140 3470 3630
VP5P0
4936
4500 4750 5250 5500
VP12P0
11897 10800 11400 12600 13200
VREF
1216
1190 1200 1240 1250
12V Input Voltage
11178
8000 10000 14000 16000
Command Reference for Cisco NCS 1000 Series
50
Commands
show hw-module
show hw-module
To display the details of the slice and the Field Programmable Devices (FPDs), use the show hw-module in
XR EXEC or administration EXEC mode.
show hw-module {slice [slicenumber | all ] | fpd}
Syntax Description
slice slicenumber
Displays information for a slice. The slice number is from 0 to 3.
all
Displays information for all the slices.
fpd
Displays the status of FPDs installed.
Command Default
None
Command Modes
XR EXEC
Administration EXEC
Command History
Usage Guidelines
Release
Modification
Release 6.0.0
This command was introduced.
Release 6.0.1
The output of show hw-module
fpd and show hw-module slice
were updated.
Release 6.1.1
The output of show hw-module
slice was updated.
Release 6.1.2
The output of show hw-module
slice was updated.
If the ISO image has new version of FPD, the Status column in show hw-module fpd command shows NEED
UPGD. If the upgrade is required, use the upgrade hw-module location all fpd fpd_device_name command
to start the upgrade. When the upgrade starts, the Status column in show hw-module fpd command sequentially
shows UPGD PREP, UPGRADING, and the percentage of upgrade completion. After the upgrade is completed,
the Status column shows RLOAD REQ if the ISO image requires reload; otherwise the Status column shows
CURRENT.
If reload is required:
Command Reference for Cisco NCS 1000 Series
51
Commands
show hw-module
If the FPGA location is 0/RP0, use the admin hw-module location 0/RP0 reload command. This command
reboots only the CPU. Hence, the traffic is not impacted. If the FPGA location is 0/0, use the admin hw-module
location all reload command. This command reboots NCS 1002. Hence, the traffic is impacted. After the
reload is completed, the new FPGA runs the current version.
The show hw-module slice slicenumber command displays the state of current slice provisioning, client and
trunk bit rate, traffic split between coherent DSPs, and version of data path FPGA. If the HW status field
displays NEED UPGD, use the upgrade hw-module slice slicenumber re-provision command. The Encryption
Supported field indicates whether the slice is provisioned with firmware that supports encryption or not.
Task ID
Examples
Task ID
Operation
system
read
You can use the show hw-module slice slicenumber command to check if the upgrade is required after the
software is installed.
RP/0/RP0/CPU0:ios# show hw-module slice 0
RP/0/RP0/CPU0:ios#show hw-module slice 0
Thu Sep 22 10:55:35.985 UTC
Slice ID:
0
Status:
Provisioned
Client Bitrate:
40
Trunk Bitrate:
200
DP FPGA FW Type:
XMG4
DP FPGA FW Version:
01.01
HW Status:
CURRENT
Encryption Supported:
FALSE
LLDP Drop Enable: TRUE
Client Port Trunk Port
CoherentDSP0/0/0/6
Traffic Split Percentage
FortyGigECtrlr0/0/0/0
100
FortyGigECtrlr0/0/0/1
100
FortyGigECtrlr0/0/0/2
100
FortyGigECtrlr0/0/0/3
100
FortyGigECtrlr0/0/0/4
100
RP/0/RP0/CPU0:ios# show hw-module slice all
Thu Aug 11 16:16:58.935 IST
Slice ID:
0
Status:
Provisioned
Client Bitrate:
100
Trunk Bitrate:
200
DP FPGA FW Type:
M100
DP FPGA FW Version:
02.00
HW Status:
CURRENT
Encryption Supported:
TRUE
Client Port Trunk Port
Traffic Split Percentage
CoherentDSP0/0/0/6
HundredGigECtrlr0/0/0/3
HundredGigECtrlr0/0/0/4
Slice ID:
Status:
Client Bitrate:
Trunk Bitrate:
DP FPGA FW Type:
DP FPGA FW Version:
Command Reference for Cisco NCS 1000 Series
52
100
100
1
Provisioned
100
200
M100
02.00
Commands
show hw-module
HW Status:
CURRENT
Encryption Supported:
TRUE
Client Port Trunk Port
Traffic Split Percentage
CoherentDSP0/0/0/13
HundredGigECtrlr0/0/0/10
HundredGigECtrlr0/0/0/11
Slice ID:
Status:
Client Bitrate:
Trunk Bitrate:
DP FPGA FW Type:
DP FPGA FW Version:
HW Status:
100
100
2
Provisioned
100
200
M100
02.00
CURRENT
Encryption Supported:
TRUE
Client Port Trunk Port
Traffic Split Percentage
CoherentDSP0/0/0/20
HundredGigECtrlr0/0/0/17
HundredGigECtrlr0/0/0/18
Slice ID:
Status:
Client Bitrate:
Trunk Bitrate:
DP FPGA FW Type:
DP FPGA FW Version:
HW Status:
100
100
3
Provisioned
100
200
M100
02.00
CURRENT
Encryption Supported:
TRUE
Client Port Trunk Port
Traffic Split Percentage
CoherentDSP0/0/0/27
HundredGigECtrlr0/0/0/24
HundredGigECtrlr0/0/0/25
100
100
RP/0/RP0/CPU0:ios# show hw-module fpd
Tue Apr 12 09:04:14.935 UTC
FPD Versions
=================
Location Card type
HWver FPD device ATR Status
Running Programd
-----------------------------------------------------------------------------0/0
NCS1002
2.4 CDSP_PORT_05
CURRENT
3.56 3.56
0/0
NCS1002
2.4 CDSP_PORT_06
CURRENT
3.56 3.56
0/0
NCS1002
2.4 CDSP_PORT_12
CURRENT
3.56 3.56
0/0
NCS1002
2.3 CDSP_PORT_13
NEED UPGD 3.55 3.55
0/0
NCS1002
2.4 CDSP_PORT_19
CURRENT
3.56 3.56
0/0
NCS1002
2.4 CDSP_PORT_20
CURRENT
3.56 3.56
0/0
NCS1002
2.4 CDSP_PORT_26
CURRENT
3.56 3.56
0/0
NCS1002
2.4 CDSP_PORT_27
CURRENT
3.56 3.56
0/0
NCS1002
CFP2_PORT_05
NOT READY
0/0
NCS1002
2.0 CFP2_PORT_06
CURRENT
4.38 4.38
0/0
NCS1002
CFP2_PORT_12
NOT READY
0/0
NCS1002
CFP2_PORT_13
NOT READY
0/0
NCS1002
CFP2_PORT_19
NOT READY
0/0
NCS1002
2.1 CFP2_PORT_20
CURRENT
5.19 5.19
0/0
NCS1002
CFP2_PORT_26
NOT READY
0/0
NCS1002
CFP2_PORT_27
NOT READY
0/0
NCS1002
0.1 CTRL_BKP_LOW B
CURRENT
1.22
0/0
NCS1002
0.1 CTRL_BKP_UP
B
CURRENT
1.22
0/0
NCS1002
0.1 CTRL_FPGA_LOW
CURRENT
1.22 1.22
0/0
NCS1002
0.1 CTRL_FPGA_UP
CURRENT
1.22 1.22
0/RP0 NCS1K-CNTLR-K9
0.1 BIOS_Backup
BS
CURRENT
13.10
0/RP0 NCS1K-CNTLR-K9
0.1 BIOS_Primary
S
CURRENT
13.10 13.10
0/RP0 NCS1K-CNTLR-K9
0.1 Daisy_Duke_BKP BS
CURRENT
0.15
0/RP0 NCS1K-CNTLR-K9
0.1 Daisy_Duke_FPGA S
CURRENT
0.15 0.15
Command Reference for Cisco NCS 1000 Series
53
Commands
show hw-module
sysadmin-vm:0_RP0# show hw-module fpd
Tue Apr 12 09:28:22.879 UTC
FPD Versions
===============
Location Card type
HWver
FPD device
ATR
Status
Run Programd
------------------------------------------------------------------------------0/0
NCS1002
0.1
CTRL_BKP_LOW
B
CURRENT
1.22
0/0
NCS1002
0.1
CTRL_BKP_UP
B
CURRENT
1.22
0/0
NCS1002
0.1
CTRL_FPGA_LOW
CURRENT
1.22 1.22
0/0
NCS1002
0.1
CTRL_FPGA_UP
CURRENT
1.22 1.22
0/RP0
NCS1K-CNTLR-K9 0.1
BIOS_Backup
BS
CURRENT
13.10
0/RP0
NCS1K-CNTLR-K9 0.1
BIOS_Primary
S
CURRENT
13.10 13.10
0/RP0
NCS1K-CNTLR-K9 0.1
Daisy_Duke_BKP
BS
CURRENT
0.15
0/RP0
NCS1K-CNTLR-K9 0.1
Daisy_Duke_FPGA
S
CURRENT
0.15 0.15
0/PM0
NCS1K-2KW-AC
0.0
PO-PriMCU
NEED UPGD
0.00 0.00
0/PM1
NCS1K-2KW-AC
0.0
PO-PriMCU
NEED UPGD
0.00 0.00
Command Reference for Cisco NCS 1000 Series
54
Commands
show inventory
show inventory
To retrieve and display the physical inventory information, use the show inventory command in XR EXEC
or administration EXEC mode.
XR EXEC Mode
show inventory [all | oid | raw | location location ]
Administration EXEC Mode
show inventory [all | chassis | fan | power | raw | location location ]
Syntax Description
all
(Optional) Displays inventory information for all the physical entities.
fan
(Optional) Displays inventory information for the fans.
power
(Optional) Displays inventory information for the power supply.
raw
(Optional) Displays raw information about the chassis for diagnostic purposes.
chassis
(Optional) Displays inventory information for the entire chassis.
location location
(Optional) Displays inventory information for a specific node, or for all nodes
in the chassis.
oid
(Optional) Displays inventory information along with oid.
Command Default
All hardware inventory information is displayed.
Command Modes
XR EXEC
Administration EXEC
Command History
Usage Guidelines
Release
Modification
Release 6.0.0
This command was introduced.
Release 6.0.1
The output was updated to include 40G pluggables.
Enter the show inventory command with the raw keyword to display every RFC 2737 entity installed in NCS
1002, including those without a PID, unique device identifier (UDI), or other physical identification. The raw
keyword is primarily intended for troubleshooting problems with the show inventory command itself.
Command Reference for Cisco NCS 1000 Series
55
Commands
show inventory
Task ID
Examples
Task ID
Operations
system
read
The following examples show sample output from the show inventory command in both EXEC and
Administration EXEC modes.
The output of show inventory command does not include the details of breakout patch panel.
sysadmin-vm:0_RP0# show inventory
Tue Feb 13 15:27:30.159 UTC
NAME: "0/0", DESCR: "Network Convergence System 1000 Controller"
PID: NCS1002
, VID: V01, SN: CHANGE-MENAME: "0/0-PORT-6", DESCR: "Cisco 100GE CFP2 Pluggable Optics"
PID: ONS-CFP2-WDM
, VID: N/A, SN: OUK1936005W
NAME: "0/0-PORT-11", DESCR: "Cisco 40G QSFP+ CSR4 Pluggable Optics Module"
PID: QSFP-40G-CSR4
, VID: V02 , SN: AVP1834S18A
NAME: "0/0-PORT-14", DESCR: "Cisco 100G QSFP28 SR4 Pluggable Optics Module"
PID: QSFP-100G-SR4-S
, VID: ES1 , SN: AVF1933G116
NAME: "0/0-PORT-16", DESCR: "Cisco 100G QSFP28 SR4 Pluggable Optics Module"
PID: QSFP-100G-SR4-S
, VID: ES1 , SN: AVF1933G16A
NAME: "0/0-PORT-18", DESCR: "Cisco 100G QSFP28 SR4 Pluggable Optics Module"
PID: QSFP-100G-SR4-S
, VID: ES1 , SN: AVF1934G04U
NAME: "0/0-PORT-21", DESCR: "Cisco QSFP-100G-LR4-S Pluggable Optics Module"
PID: QSFP-100G-LR4-S
, VID: V01 , SN: ECL19250052
NAME: "0/RP0", DESCR: "Network Convergence System 1000 Controller"
PID: NCS1002--RP
, VID: V01, SN: CHANGE-MENAME: "0/FT0", DESCR: "Network Convergence System 1000 Fan"
PID: NCS1K-FTA
, VID: V01, SN: N/A
NAME: "0/FT1", DESCR: "Network Convergence System 1000 Fan"
PID: NCS1K-FTA
, VID: V01, SN: N/A
NAME: "0/FT2", DESCR: "Network Convergence System 1000 Fan"
PID: NCS1K-FTA
, VID: V01, SN: N/A
RP/0/RP0/CPU0:ios# show inventory
NAME: "0/0", DESCR: "Network Convergence System 1000 Controller"
PID: NCS1002
, VID: V01, SN: CHANGE-MENAME: "0/0-PORT-27", DESCR: "Cisco 100GE CFP2 Pluggable Optics"
PID: ONS-CFP2-WDM
, VID: N/A, SN: OUK19360056
NAME: "0/0-PORT-7", DESCR: "Cisco 100G QSFP28 CWDM4 Pluggable Optics Module"
PID: QSFP-100G-CWDM4-S , VID: ES1 , SN: MF1170500002-A
NAME: "0/0-PORT-8", DESCR: "Cisco 100G QSFP28 CWDM4 Pluggable Optics Module"
PID: QSFP-100G-CWDM4-S , VID: ES1 , SN: MF1150500020-A
NAME: "0/0-PORT-10", DESCR: "Cisco 100G QSFP28 SR4 Pluggable Optics Module"
PID: QSFP-100G-SR4-S
, VID: ES1 , SN: AVF1933G167
NAME: "0/0-PORT-11", DESCR: "Cisco 100G QSFP28 SR4 Pluggable Optics Module"
PID: QSFP-100G-SR4-S
, VID: ES1 , SN: AVF1917G017
Command Reference for Cisco NCS 1000 Series
56
Commands
show inventory
NAME: "0/0-PORT-23", DESCR: "Cisco 100G QSFP28 CWDM4 Pluggable Optics Module"
PID: QSFP-100G-CWDM4-S , VID: ES1 , SN: MF2170500030-A
NAME: "0/0-PORT-24", DESCR: "Cisco 100G QSFP28 SR4 Pluggable Optics Module"
PID: QSFP-100G-SR4-S
, VID: ES1 , SN: AVF1916G028
NAME: "0/RP0", DESCR: "Network Convergence System 1000 Controller"
PID: NCS1K-CNTLR-K9
, VID: V01, SN: CHANGE-MENAME: "Rack 0", DESCR: "Network Convergence System 1000 Controller"
PID: NCS1002
, VID: V01, SN: CHANGE-MENAME: "0/FT0", DESCR: "Network Convergence System 1000 Fan"
PID: NCS1K-FTA
, VID: V01, SN: N/A
NAME: "0/FT1", DESCR: "Network Convergence System 1000 Fan"
PID: NCS1K-FTA
, VID: V01, SN: N/A
NAME: "0/FT2", DESCR: "Network Convergence System 1000 Fan"
PID: NCS1K-FTA
, VID: V01, SN: N/A
NAME: "0/PM1", DESCR: "N/A"
PID: NCS1K-2KW-AC
, VID: V99, SN: POG19280011
Command Reference for Cisco NCS 1000 Series
57
Commands
show led
show led
To display the status of various LEDs present in NCS 1002, use the show led command in administration
EXEC mode.
show led [ location location ]
Syntax Description
location location
(Optional) Displays LED information for a specific location.
Command Default
The status of all the LEDs present in NCS 1002 is displayed.
Command Modes
Administration EXEC
Command History
Release
Modification
Release 6.0.0
This command was introduced.
Usage Guidelines
Enter the show LED command in administration EXEC mode to display the status of all the LEDs present
in NCS 1002.
Examples
The following example shows sample output from the show led command.
sysadmin-vm:0_RP0# show led
Wed Dec 16 22:39:47.779 UTC
=============================================================
Location LED Name
Mode
Color
=============================================================
0/0
0/0-Power Status LED
WORKING
RED
0/0-Fan Status LED
WORKING
GREEN
0/RP0
0/RP0-Status LED
WORKING
AMBER
0/RP0-Attention LED
WORKING
OFF
0/PM0
0/PM0-Status LED
WORKING
AMBER
0/PM1
0/PM1-Status LED
WORKING
GREEN
Command Reference for Cisco NCS 1000 Series
58
Commands
show platform
show platform
To display information and status for each node in the system, use the show platform command in XR EXEC
or administration EXEC mode.
Administration EXEC Mode
show platform [{detail | location | slices} location]
XR EXEC Mode
show platform [vm | 0/RP0 ]
Syntax Description
detail
(Optional) Displays the details of node type and state.
location
(Optional) Displays the location of node.
slices
(Optional) Displays the summary information of each slice in the node.
location
(Optional) Node location such as 0/FT0, 0/RP0.
vm
(Optional) Displays the virtual machine information of node.
Command Default
The status and information are displayed for all the nodes in the system.
Command Modes
XR EXEC
Administration EXEC
Command History
Usage Guidelines
Task ID
Release
Modification
Release 6.0.0
This command was introduced.
Enter the show platform command in administration EXEC mode to display the output for the entire system.
Task ID
Operations
system
read
Command Reference for Cisco NCS 1000 Series
59
Commands
show platform
Examples
The following example shows sample output from the show platform command.
sysadmin-vm:0_RP0# show platform
Wed Dec 16 22:51:27.789 UTC
Location Card Type
HW State
SW State
Config State
---------------------------------------------------------------------------0/0
NCS1002
OPERATIONAL
N/A
NSHUT
0/RP0
NCS1K-CNTLR-K9
OPERATIONAL
OPERATIONAL
NSHUT
0/FT0
NCS1K-FTA
OPERATIONAL
N/A
NSHUT
0/FT1
NCS1K-FTA
OPERATIONAL
N/A
NSHUT
0/FT2
NCS1K-FTA
OPERATIONAL
N/A
NSHUT
The following example shows sample output from the show platform detail command.
sysadmin-vm:0_RP0# show platform detail
Wed Dec
16 22:52:25.551 UTC
Platform Information
PID :
Description :
VID/SN :
HW Oper State :
SW Oper State :
Configuration :
HW Version :
Last Event :
Last Event Reason :
for 0/0
NCS1002
"Network Convergence System 1000 Controller"
V01
OPERATIONAL
N/A
"NSHUT RST"
0.1
HW_EVENT_OK
"HW Event OK"
Platform Information
PID :
Description :
VID/SN :
HW Oper State :
SW Oper State :
Configuration :
HW Version :
Last Event :
Last Event Reason :
for 0/RP0
NCS1K-CNTLR-K9
"Network Convergence System 1000 Controller"
V01
OPERATIONAL
OPERATIONAL
"NSHUT RST"
0.1
HW_EVENT_OK
"HW Event OK"
Platform Information
PID :
Description :
VID/SN :
HW Oper State :
SW Oper State :
Configuration :
HW Version :
Last Event :
Last Event Reason :
for 0/FT0
NCS1K-FTA
"Network Convergence System 1000 Fan"
V01
OPERATIONAL
N/A
"NSHUT RST"
0.1
HW_EVENT_OK
"HW Operational"
Platform Information
PID :
Description :
VID/SN :
HW Oper State :
SW Oper State :
Configuration :
HW Version :
Last Event :
Last Event Reason :
for 0/FT1
NCS1K-FTA
"Network Convergence System 1000 Fan"
V01
OPERATIONAL
N/A
"NSHUT RST"
0.1
HW_EVENT_OK
"HW Operational"
Platform Information
PID :
Description :
VID/SN :
HW Oper State :
for 0/FT2
NCS1K-FTA
"Network Convergence System 1000 Fan"
V01
OPERATIONAL
Command Reference for Cisco NCS 1000 Series
60
Commands
show platform
SW Oper State :
Configuration :
HW Version :
Last Event :
Last Event Reason :
N/A
"NSHUT RST"
0.1
HW_EVENT_OK
"HW Operational"
RP/0/RP0/CPU0:ios# show platform
Wed Dec 16 22:56:35.515 UTC
Node name
Node type
Node state
Admin state
Config state
--------------------------------------------------------------------------------------0/RP0
NCS1K-CNTLR
OPERATIONAL
UP
NSHUT
Command Reference for Cisco NCS 1000 Series
61
Commands
window-size
window-size
To configure the replay protection window size, use the window-size command in MACsec policy configuration
mode.
The replay protection window size indicates the number of out-of-sequence frames that can be accepted at
the controller configured with MACsec, without being dropped.
window-size value
Syntax Description
value
Number of out-of-sequence frames that can be accepted at the controller without being
dropped. The range is 0 to 1024.
Command Default
The default value is 64.
Command Modes
MACsec policy configuration
Command History
Examples
Release
Modification
R6.1.1
This command was introduced.
The following example shows how to use the window-size command.
configure
macsec-policy mac_policy
window-size 64
Command Reference for Cisco NCS 1000 Series
62