Show Commands

show hw-module fpd

To display field-programmable device (FPD) compatibility for all modules or a specific module, use the show hw-module fpd command in XR EXEC mode.

show hw-module [ fpd | location node-id fpd | location node-id fpd fpd-name | location all fpd fpd-name ]

Syntax Description

location{node-id | all}

Specifies the location of the module. The node-id argument is expressed in the rack/ slot notation. Use the all keyword to indicate all nodes.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

sysmgr

read

root-lr

read

Examples

The following example shows the output of show hw-module fpd command:

Router#show hw-module fpd
Wed Apr 5 17:46:55.067 UTC

Auto-upgrade:Enabled
Attribute codes: B golden, P protect, S secure, A Anti Theft aware
FPD Versions
==============
Location   Card type       HWver FPD device       ATR Status   Running Programd  Reload Loc
-------------------------------------------------------------------------------------------
0/RP0/CPU0 8201            0.2   Bios             S   CURRENT    1.27    1.27    0/RP0/CPU0
0/RP0/CPU0 8201            0.2   BiosGolden       BS  CURRENT            1.20    0/RP0/CPU0
0/RP0/CPU0 8201            0.2   IoFpga               CURRENT    1.11    1.11    0/RP0
0/RP0/CPU0 8201            0.2   IoFpgaGolden     B   CURRENT            1.01    0/RP0
0/RP0/CPU0 8201            0.2   x86Fpga          S   CURRENT    1.06    1.06    0/RP0
0/RP0/CPU0 8201            0.2   x86FpgaGolden    BS  CURRENT            1.01    0/RP0
0/RP0/CPU0 8201            0.2   x86TamFw         S   CURRENT    5.13    5.13    0/RP0
0/RP0/CPU0 8201            0.2   x86TamFwGolden   BS  CURRENT            5.06    0/RP0
0/PM0      PSU1.4KW-ACPE   0.0   DT-PrimMCU           CURRENT    3.01    3.01    NOT REQ
0/PM0      PSU1.4KW-ACPE   0.0   DT-SecMCU            CURRENT    2.02    2.02    NOT REQ
0/PM1      PSU1.4KW-ACPE   0.0   DT-PrimMCU           CURRENT    3.01    3.01    NOT REQ
0/PM1      PSU1.4KW-ACPE   0.0   DT-SecMCU            CURRENT    2.02    2.02    NOT REQ

The following example shows how to display FPD compatibility for specific location module in the router:

Router#show hw-module location 0/RP0/CPU0 fpd
Wed Apr 5 17:47:01.104 UTC

Auto-upgrade:Enabled
Attribute codes: B golden, P protect, S secure, A Anti Theft aware
FPD Versions
==============
Location   Card type       HWver FPD device       ATR Status   Running Programd  Reload Loc
-------------------------------------------------------------------------------------------
0/RP0/CPU0 8201            0.2   Bios             S   CURRENT    1.27    1.27    0/RP0/CPU0
0/RP0/CPU0 8201            0.2   BiosGolden       BS  CURRENT            1.20    0/RP0/CPU0
0/RP0/CPU0 8201            0.2   IoFpga               CURRENT    1.11    1.11    0/RP0
0/RP0/CPU0 8201            0.2   IoFpgaGolden     B   CURRENT            1.01    0/RP0
0/RP0/CPU0 8201            0.2   x86Fpga          S   CURRENT    1.06    1.06    0/RP0
0/RP0/CPU0 8201            0.2   x86FpgaGolden    BS  CURRENT            1.01    0/RP0
0/RP0/CPU0 8201            0.2   x86TamFw         S   CURRENT    5.13    5.13    0/RP0
0/RP0/CPU0 8201            0.2   x86TamFwGolden   BS  CURRENT            5.06    0/RP0

The following example shows the output of show hw-module location 0/RP0/CPU0 fpd Bios command:

Router#show hw-module location 0/RP0/CPU0 fpd Bios
Wed Apr 5 17:47:04.255 UTC

Auto-upgrade:Enabled
Attribute codes: B golden, P protect, S secure, A Anti Theft aware
FPD Versions
==============
Location   Card type       HWver FPD device       ATR Status   Running Programd  Reload Loc
-------------------------------------------------------------------------------------------
0/RP0/CPU0 8201            0.2   Bios             S CURRENT      1.27    1.27    0/RP0/CPU0

The following example shows how to display FPD compatibility for all modules in the router:

Router#show hw-module fpd all
Tue Apr  4 08:55:32.545 UTC

Auto-upgrade:Disabled
Attribute codes: B golden, P protect, S secure, A Anti Theft aware
                                                                         FPD Versions
                                                                        ==============
Location   Card type       HWver FPD device       ATR Status   Running Programd  Reload Loc
-------------------------------------------------------------------------------------------
0/RP0/CPU0 8201            0.30  Bios                 NEED UPGD  7.01    7.01    0/RP0/CPU0
0/RP0/CPU0 8201            0.30  BiosGolden       B   NEED UPGD          7.01    0/RP0/CPU0
0/RP0/CPU0 8201            0.30  IoFpga               NEED UPGD  7.01    7.01         0/RP0
0/RP0/CPU0 8201            0.30  IoFpgaGolden     B   NEED UPGD          7.01         0/RP0
0/RP0/CPU0 8201            0.30  SsdIntelS3520        NEED UPGD  7.01    7.01         0/RP0
0/RP0/CPU0 8201            0.30  x86Fpga              NEED UPGD  7.01    7.01         0/RP0
0/RP0/CPU0 8201            0.30  x86FpgaGolden    B   NEED UPGD          7.01         0/RP0
0/RP0/CPU0 8201            0.30  x86TamFw             NEED UPGD  7.01    7.01         0/RP0
0/RP0/CPU0 8201            0.30  x86TamFwGolden   B   NEED UPGD          7.01         0/RP0
0/PM0      PSU2KW-ACPI     0.0   PO-PrimMCU           NEED UPGD  7.01    7.01       NOT REQ
0/PM1      PSU2KW-ACPI     0.0   PO-PrimMCU           NEED UPGD  7.01    7.01       NOT REQ

The following example shows the output of show hw-module location all fpd IoFpga command:

Router#show hw-module location all fpd IoFpga
Wed Apr 5 17:47:10.752 UTC

Auto-upgrade:Enabled
Attribute codes: B golden, P protect, S secure, A Anti Theft aware
FPD Versions
==============
Location   Card type       HWver FPD device       ATR Status   Running Programd  Reload Loc
-------------------------------------------------------------------------------------------
0/RP0/CPU0 8201            0.2   IoFpga           CURRENT        1.11    1.11    0/RP0

show install active

To display active packages, use the show install active command in XR EXEC mode.

show install active [ all [ location { node-id | all } ] | summary ]

Syntax Description

all location

Displays all the active packages.

location node-id

location all

Displays all packages in a specified location or all locations.

summary

Displays a summary of active packages along with a list of optional packages.

Command Default

The command without the all keyword just displays the currently active XR packages. It does not display all packages on the system such as OS packages.

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Examples

This example shows how to view all active packages:

Router#show install active all
Wed Mar  8 04:57:35.230 UTC

Software Hash: bf46f5add2ea3cd85c91c647a2ca043e1a829c49e5c290baec0c89c937a17429
Package                                                                  Version
---------------------------------------------------- ---------------------------
8000-boot-scripts                                             7.8.1.34Iv1.0.0-r0
8000-cpa-setup-x86                                            7.8.1.34Iv1.0.0-r0
8101-32h-cpa-sb-x86                                           7.8.1.34Iv1.0.0-r0
8102-64h-cpa-sb-x86                                           7.8.1.34Iv1.0.0-r0
8111-32eh-cpa-sb-x86                                          7.8.1.34Iv1.0.0-r0
8201-32fh-cpa-sb-x86                                          7.8.1.34Iv1.0.0-r0
8201-cpa-sb-x86                                               7.8.1.34Iv1.0.0-r0
8202-32fh-m-cpa-sb-x86                                        7.8.1.34Iv1.0.0-r0
8202-cpa-sb-x86                                               7.8.1.34Iv1.0.0-r0
8203-88h16fh-m-cpa-sb-x86                                     7.8.1.34Iv1.0.0-r0
8212-cpa-sb-x86                                               7.8.1.34Iv1.0.0-r0
8608-fb-data-cpa-sb-x86                                       7.8.1.34Iv1.0.0-r0
8608-mpa-crevalle-cpa-sb-x86                                  7.8.1.34Iv1.0.0-r0
8608-mpa-narwhal-cpa-sb-x86                                   7.8.1.34Iv1.0.0-r0
8608-mpa-pinafore-cpa-sb-x86                                  7.8.1.34Iv1.0.0-r0
8608-mpa-tiber-cpa-sb-x86                                     7.8.1.34Iv1.0.0-r0
8804-fc-data-cpa-sb-x86                                       7.8.1.34Iv1.0.0-r0
acl                                                                 2.2.52-r0.61
argon                                                         7.8.1.34Iv1.0.0-r0
 --More--

This example shows how to view all active pakages in a specified location:

Router#show install active all location 0/RP0/CPU0
Wed Mar  8 04:58:25.254 UTC

Software Hash: ef055dac99b856182211deb7585c02fb812c02d6a04cd5b92b521ccf7b9c6ee5
Package                                              Architecture                         Version
---------------------------------------------------- ---------------- ---------------------------
8000-boot-scripts                                    corei7_64                 7.8.1.34Iv1.0.0-r0
8000-cpa-setup-x86                                   corei7_64                 7.8.1.34Iv1.0.0-r0
8101-32h-cpa-sb-x86                                  corei7_64                 7.8.1.34Iv1.0.0-r0
8102-64h-cpa-sb-x86                                  corei7_64                 7.8.1.34Iv1.0.0-r0
8111-32eh-cpa-sb-x86                                 corei7_64                 7.8.1.34Iv1.0.0-r0
8201-32fh-cpa-sb-x86                                 corei7_64                 7.8.1.34Iv1.0.0-r0
8201-cpa-sb-x86                                      corei7_64                 7.8.1.34Iv1.0.0-r0
8202-32fh-m-cpa-sb-x86                               corei7_64                 7.8.1.34Iv1.0.0-r0
8202-cpa-sb-x86                                      corei7_64                 7.8.1.34Iv1.0.0-r0
8203-88h16fh-m-cpa-sb-x86                            corei7_64                 7.8.1.34Iv1.0.0-r0
8212-cpa-sb-x86                                      corei7_64                 7.8.1.34Iv1.0.0-r0
8608-fb-data-cpa-sb-x86                              corei7_64                 7.8.1.34Iv1.0.0-r0
8608-mpa-crevalle-cpa-sb-x86                         corei7_64                 7.8.1.34Iv1.0.0-r0
8608-mpa-narwhal-cpa-sb-x86                          corei7_64                 7.8.1.34Iv1.0.0-r0
8608-mpa-pinafore-cpa-sb-x86                         corei7_64                 7.8.1.34Iv1.0.0-r0
8608-mpa-tiber-cpa-sb-x86                            corei7_64                 7.8.1.34Iv1.0.0-r0
8804-fc-data-cpa-sb-x86                              corei7_64                 7.8.1.34Iv1.0.0-r0
acl                                                  corei7_64                       2.2.52-r0.61
argon                                                wrlsdk_x86                7.8.1.34Iv1.0.0-r0
 --More--

This example shows how to view the summary of active pakages:

Router#show install active summary
Wed Mar  8 05:00:29.564 UTC
Active Packages:    XR: 205    All: 1465
Label:              7.8.1.34I-PROD_BUILD_7_8_1_34I_SIT_IMAGE
Software Hash:      bf46f5add2ea3cd85c91c647a2ca043e1a829c49e5c290baec0c89c937a17429

Optional Packages                                                        Version
---------------------------------------------------- ---------------------------
xr-8000-l2mcast                                                7.8.1.34Iv1.0.0-1
xr-8000-mcast                                                  7.8.1.34Iv1.0.0-1
xr-8000-netflow                                                7.8.1.34Iv1.0.0-1
xr-bgp                                                         7.8.1.34Iv1.0.0-1
xr-cdp                                                         7.8.1.34Iv1.0.0-1
xr-ipsla                                                       7.8.1.34Iv1.0.0-1
xr-is-is                                                       7.8.1.34Iv1.0.0-1
xr-k9sec                                                       7.8.1.34Iv1.0.0-1
xr-lldp                                                        7.8.1.34Iv1.0.0-1
xr-mcast                                                       7.8.1.34Iv1.0.0-1
xr-mpls-oam                                                    7.8.1.34Iv1.0.0-1
xr-netflow                                                     7.8.1.34Iv1.0.0-1
xr-ospf                                                        7.8.1.34Iv1.0.0-1
xr-perf-meas                                                   7.8.1.34Iv1.0.0-1
xr-perfmgmt                                                    7.8.1.34Iv1.0.0-1
xr-telnet                                                      7.8.1.34Iv1.0.0-1
xr-track                                                       7.8.1.34Iv1.0.0-1
 --More--

show install available

To display packages available for installation, use the show install available command in XR EXEC mode.

show install available [all]

Syntax Description

all location node-id

(Optional) Displays all packages available to be installed in a system.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Examples

The following example shows how to view the available packages:



Router# show install available all

show install committed

To display committed packages, use the show install committed command in XR EXEC mode.

show install committed { all | summary }

Syntax Description

all

Displays user-installable XR packages on all locations.

summary

Displays summary of committed packages (optional and bugfix packages only).

.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Examples

The following example shows how to view the summary of committed packages:

Router#show install committed summary
Wed Jun 28 10:34:18.792 UTC
Committed Packages: XR: 206    All: 1537
Label:              7.10.1.31I
Software Hash:      8ba19933d88a72378955c470a1e07b0742ddded043ec332a72c5640c1ec62c55

Optional Packages                                                        Version
---------------------------------------------------- ---------------------------
xr-8000-l2mcast                                               7.10.1.31Iv1.0.0-1
xr-8000-mcast                                                 7.10.1.31Iv1.0.0-1
xr-8000-netflow                                               7.10.1.31Iv1.0.0-1
xr-bgp                                                        7.10.1.31Iv1.0.0-1
xr-ipsla                                                      7.10.1.31Iv1.0.0-1
xr-is-is                                                      7.10.1.31Iv1.0.0-1
xr-lldp                                                       7.10.1.31Iv1.0.0-1
xr-mcast                                                      7.10.1.31Iv1.0.0-1
xr-mpls-oam                                                   7.10.1.31Iv1.0.0-1
xr-netflow                                                    7.10.1.31Iv1.0.0-1
xr-ops-script-repo                                            7.10.1.31Iv1.0.0-1
xr-ospf                                                       7.10.1.31Iv1.0.0-1
xr-perf-meas                                                  7.10.1.31Iv1.0.0-1
xr-perfmgmt                                                   7.10.1.31Iv1.0.0-1
xr-track                                                      7.10.1.31Iv1.0.0-1

show install fixes

To display bug fixes, use the show install fixes command in XR EXEC mode.

show install fixes { active | available | committed | deactivate } [ brief | bugids value ]

active

Display active bug fixes.

available

Display the list of available bug fixes.

committed

Display committed bug fixes

deactivate bugfix_list

Display information on how to remove a bug fix

brief

(Optional) Displays only the bug IDs and not the relevant packages.

bugids value

(Optional) Displays bug fixes for a specific bug ID. You can choose to view information for more than one bug id seperated by a space.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Examples

The following example shows how to view the list of available bug fixes:



Router# show install fixes available
Bug Id             Packages                      Repository          
-----------    -----------------------------  ----------------  
CSCxx12345     xr-8000-core-7.0.11v1.0.1-1       <repository-name> 
               xr-core-7.0.11v1.0.1-1            <repository-name> 

The following example shows how to view the information for a active bug ID:



Router# show install fixes active bugids CSCxx12345

The following example shows how to remove the DDTS CSCwc26944:

Router#show install fixes deactivate CSCwc26944

User-requested DDTSs deactivated by this command: CSCwc26944
 
All DDTSs deactivated by this command: CSCvs01738,CSCwc26944
 
Package changes:
  xr-8000-core-7.5.2v1.0.5 -> xr-8000-core-7.5.2v1.0.4
  xr-8000-fib-ea-7.5.2v1.0.1 -> xr-8000-fib-ea-7.5.2v1.0.0           (missing)
  xr-8000-leabaofa-7.5.2v1.0.3 -> xr-8000-leabaofa-7.5.2v1.0.2
  xr-8000-mcast-7.5.2v1.0.1 -> xr-8000-mcast-7.5.2v1.0.0             (missing)
  xr-8000-utapp-blaze-7.5.2v1.0.2 -> xr-8000-utapp-blaze-7.5.2v1.0.1
  xr-fib-7.5.2v1.0.3 -> xr-fib-7.5.2v1.0.2
  xr-mcast-7.5.2v1.0.1 -> xr-mcast-7.5.2v1.0.0                       (missing)
  xr-ncs540l-core-7.5.2v1.0.14 -> xr-ncs540l-core-7.5.2v1.0.10
  xr-ncs5700-core-7.5.2v1.0.14 -> xr-ncs5700-core-7.5.2v1.0.10
  xr-ofa-7.5.2v1.0.3 -> xr-ofa-7.5.2v1.0.1
  xr-snmp-7.5.2v1.0.1 -> xr-snmp-7.5.2v1.0.0                         (missing)
 
Example install commands:
  install source any-configured xr-8000-core-7.5.2v1.0.4 xr-8000-fib-ea-7.5.2v1.0.0 xr-8000-leabaofa-7.5.2v1.0.2 xr-8000-mcast-7.5.2v1.0.0 xr-8000-utapp-blaze-7.5.2v1.0.1 xr-fib-7.5.2v1.0.2 xr-mcast-7.5.2v1.0.0 xr-ncs540l-core-7.5.2v1.0.10 xr-ncs5700-core-7.5.2v1.0.10 xr-ofa-7.5.2v1.0.1 xr-snmp-7.5.2v1.0.0
  install package downgrade xr-8000-core-7.5.2v1.0.4 xr-8000-fib-ea-7.5.2v1.0.0 xr-8000-leabaofa-7.5.2v1.0.2 xr-8000-mcast-7.5.2v1.0.0 xr-8000-utapp-blaze-7.5.2v1.0.1 xr-fib-7.5.2v1.0.2 xr-mcast-7.5.2v1.0.0 xr-ncs540l-core-7.5.2v1.0.10 xr-ncs5700-core-7.5.2v1.0.10 xr-ofa-7.5.2v1.0.1 xr-snmp-7.5.2v1.0.0
 
IMPORTANT: The above commands cannot currently be run because there are missing packages.Put the following packages in an accessible repository.
  xr-8000-fib-ea-7.5.2v1.0.0
  xr-8000-mcast-7.5.2v1.0.0   (optional package)
  xr-mcast-7.5.2v1.0.0        (optional package)
  xr-snmp-7.5.2v1.0.0
 
IMPORTANT: If the optional packages are not available, then they can be completely removed before removing the DDTS using install package remove xr-8000-mcast-7.5.2v1.0.0 xr-mcast-7.5.2v1.0.0

show install history

To display the history of the installation process , use the show install history command in XR EXEC mode.

show install history { all [ location node-id ] [reverse] [verbose] | table [ ID number | [ last entries ] [reverse] ] }

all

Displays the history of all install operations.

last entries

Displays a last entry of the history information table

location node-id

Displays details of the specified location.

The node-id argument is entered in the rack/slot/module notation.
table

Displays a summary table of the install operations.

ID number

Specifies the table ID of the history information.

reverse

Displays entries in reverse order.

verbose

Displays detailed information.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

To identify whether a reload is required or only process restart is needed, use show install history last transaction verbose command.

When there is insufficient disk space in the root file system, the show install request command displays an error message. Use show install history last package command to view the details of the packaging operation and any errors that have occurred.

Examples

The following example shows how to view the history of the install operation:

Router# show install history table 
  Transaction             Atomic Change          Packaging Operations
–––––––––––––––––––––  ––––––––––––––––––––––––––  –––––––––––––––––––––––––––––––––--
Id   Status          Id  Method   Status      Id  Operation   Inputs Status
–––––––––––––––––––––  ––––––––––––––––––––––––––  –––––––––––––––––––––––––––––––––--
 1   In progress     1   Reload   Success      1   Upgrade        1  Success

The following example shows how to view history of last transaction:

Router# show install history last transaction verbose
2019-09-11 17:01:46 UTC    Transaction 3 started
2019-09-11 17:01:46 UTC      Atomic change 3.1 started
2019-09-11 17:01:46 UTC      Packaging operation 3.1.1 startedtion cleanup in progress
2019-09-11 17:16:46 UTC    Transaction 3 complete

The following example shows how to view the last packaging operation for a specific location:

Router# show install history last package location 0/RP0/CPU0 verbose

The following example shows how to view the complete details of the last packaging operation, including a failure:


Router# show install history last package
Wed Jan  8 13:29:51.586 UTC
2020-01-08 13:25:32 UTC        Packaging operation 3.2.1 started
2020-01-08 13:25:32 UTC        Add
2020-01-08 13:25:32 UTC         xr-telnet
2020-01-08 13:28:26 UTC        Error on 0/1/CPU0: Insufficient disk space to install packages
2020-01-08 13:28:26 UTC        Packaging operation 3.2.1 failed: Disk space check failed on nodes: 0/1/CPU0
2020-01-08 13:28:26 UTC        Packaging operation 3.2.1 aborted: Automatically recovered after failure
 
Location 0/1/CPU0
  Last event: Error (Insufficient disk space to install packages)
  Disk space pre-check failure:
     Phase: Download
     Required space: 140944B
     Available space: 110623B

show install log

To display the details of installation requests, use the show install log command in XR EXEC mode.

show install log [all] [detail] [ id number ] [ last number ] [reverse]

Syntax Description

all

(Optional) Displays a log for all install operations.

detail

(Optional) Displays details including impact to processes and nodes.

id number

(Optional) Displays the log information for the specified transaction ID.

last number

(Optional) Displays the log information for the last number of transactions.

reverse

(Optional) Displays the logs in reverse order.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Enter the show install log command with no arguments to display a summary of all installation operations, including the changes to files and the processes impacted by each request. Specify the id argument to display details for a specific operation.

Task ID

Task ID

Operations

pkg-mgmt

read

Examples

The following example shows the log information for a specific transaction ID:


Router# show install log detail id 1  

show install request

To display the current status of install requests, use the show install request command in XR EXEC mode.

show install request { brief [monitor] | location node-id [monitor] | { verbose location node-id [monitor] | monitor location node-id } }

Syntax Description

brief

Displays install request information summary.

location node-id

Displays install information for the designated node.

The node-id argument is entered in the rack/slot/module notation.

verbose

Displays detailed information about the install request.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Release 7.8.1

The keyword monitor was deprecated.

Usage Guidelines

Cisco IOS XR processes only one installation request per device at a time. The show install request command displays any incomplete request that is currently running.


Note


When the command is running asynchonously, use show install request command to monitor the progress.


If the install operation encounters a failure, the show install request command, displays an error message. Use the show install history last package command to obtain complete details of the failure.

Examples

The following example shows sample output from the show install request command:



Router# show install request 

Install operation 17 'install add /tftp://172.31.255.255/dir/19mcast' started by user
'user_b' at 14:38:45 UTC Thu Mar 30 2006. The operation is 1% complete 2,017KB
downloaded The operation can still be aborted. 
  

The following example shows sample output from the show install request command when there is insufficient disk space in the root file system. An error message is displayed to indicate the insufficient disk space .

Router#show install request
Wed Jan  8 13:29:38.086 UTC
 
User request: install replace /harddisk:/replace.iso
Operation ID: 3.2
State:        Failure since 2020-01-08 13:28:26 UTC
Disk space check failed on nodes: 0/1/CPU0. Automatically recovered after failure, ready for next user request.
 
Current activity:    Await user input
Time started:        2020-01-08 13:29:25
 
The following actions are available:
    install package add
    install package remove
    install package upgrade
    install package downgrade
    install package replace
    install package rollback
    install commit

show interfaces

To display statistics, state and other information such as mac address etc. for all interfaces configured on the router or for a specific node, use the show interfaces command in XR EXEC mode.

show interfaces [ summary | [ type interface-path-id | all | local ] [non-dynamic] [ brief | description | detail | sparse | accounting ] ] [ location node-id ]

Syntax Description

type

(Optional) Specifies the type of interface for which you want to display statistics. For more information, use the question mark (? ) online help function.

interface-path-id

Physical interface or virtual interface.

Note

 

Use the show interfaces brief command to see a list of all interfaces configured on the router.

For more information about the syntax for the router, use the question mark (? ) online help function.

all

(Optional) Displays interface information for all interfaces. This is the default.

local

(Optional) Displays interface information for all interfaces in the local card.

location node-id

(Optional) Displays information about all interfaces on the specified node. The node-id argument is entered in the rack/slot/module notation.

accounting

(Optional) Displays the number of packets of each protocol type that have been sent through the interface.

brief

(Optional) Displays brief information of each interface (one line per interface).

description

(Optional) Displays the status, protocol, and description of each interface (one line per interface).

detail

(Optional) Displays detailed information about each interface. This is the default.

summary

(Optional) Displays a summary of interface information by interface type.

sparse

(Optional) Displays sparse per interface information excluding interface statistics.

non-dynamic

(Optional) Displays interface information excluding dynamic interfaces.

Command Default

By default, executing show interface command without any option works similar as show interface all , and it displays the information for all interfaces in the system.

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 4.0.0

This command was introduced.

Release 7.4.2

The keywords sparse and non-dynamic were introduced.

Usage Guidelines

The show interfaces command displays statistics, state and other information such as mac address etc. for the network interfaces.

For example, if you type the show interfaces command without an interface type, you receive information for all the interfaces installed in the networking device. Only by specifying the interface type , slot , and port arguments can you display information for a particular interface.

If you enter a show interfaces command for an interface type that has been removed from the networking device, an error message is displayed: “Interface not found.”

The output displayed depends on the network for which an interface has been configured.


Note


Executing show interfaces command without filters obtains and displays interface statistics for all interfaces. Hence, it is recommended to execute the command with filters to select specific interfaces or interface types of interest for a faster response. Executing show interfaces with options brief or sparse excludes interface statistics thus providing a faster response.



Note


The 5-minute input and output rates should be used only as an approximation of traffic per second during a given 5-minute period. These rates are exponentially weighted averages with a time constant of 5 minutes. A period of four time constants must pass before the average is within 2 percent of the instantaneous rate of a uniform stream of traffic over that period.


Task ID

Task ID

Operations

interface

read

Examples

This example shows the output from the show interfaces command. The output displayed depends on the type and number of interface cards in the networking device.


Router# show interfaces HundredGigE 0/3/0/35 

HundredGigE0/3/0/35 is up, line protocol is up
  Interface state transitions: 1
  Hardware is HundredGigE, address is e666.9aa0.223c (bia e666.9aa0.223c)
  Description: **To RouterX Hu0/7/0/2**
  Internet address is 192.168.1.29/30
  MTU 1514 bytes, BW 100000000 Kbit (Max: 100000000 Kbit)
     reliability 255/255, txload 239/255, rxload 238/255
  Encapsulation ARPA,
  Full-duplex, 100000Mb/s, unknown, link type is force-up
  output flow control is off, input flow control is off
  Carrier delay (up) is 10 msec
  loopback not set,
  Last link flapped 3w3d
  ARP type ARPA, ARP timeout 04:00:00
  Last input 00:00:00, output 00:00:00
  Last clearing of "show interface" counters never
  30 second input rate 93725392000 bits/sec, 32528692 packets/sec
  30 second output rate 93726416000 bits/sec, 32527860 packets/sec
     68118736643563 packets input, 24783244282360579 bytes, 0 total input drops
     0 drops for unrecognized upper-level protocol
     Received 0 broadcast packets, 0 multicast packets
              0 runts, 0 giants, 0 throttles, 0 parity
     174 input errors, 174 CRC, 0 frame, 0 overrun, 0 ignored, 0 abort
     68115867305777 packets output, 24782409845763776 bytes, 0 total output drops
     Output 0 broadcast packets, 0 multicast packets
     0 output errors, 0 underruns, 0 applique, 0 resets
     0 output buffer failures, 0 output buffers swapped out
     0 carrier transitions
   

This example shows bundle member links whose link interface status is “err-disable” and line protocol state is “admin-down” after the bundle interface has been administratively shut down using the shutdown command:


Router# show interfaces brief

Thu May  6 06:30:55.797 DST

               Intf       Intf        LineP              Encap  MTU        BW
               Name       State       State               Type (byte)    (Kbps)
--------------------------------------------------------------------------------
               BE10        down        down               ARPA  1514          0
              BE100          up          up               ARPA  1514  100000000
              BE101          up          up               ARPA  1514  100000000
                Lo0          up          up           Loopback  1500          0
                Nu0          up          up               Null  1500          0
         Fo0/3/0/26  admin-down  admin-down               ARPA  1514   40000000
          Hu0/3/0/0  admin-down  admin-down               ARPA  1514  100000000
          Hu0/3/0/1  admin-down  admin-down               ARPA  1514  100000000
          Hu0/3/0/2  admin-down  admin-down               ARPA  1514  100000000
          Hu0/3/0/3  admin-down  admin-down               ARPA  1514  100000000
          Hu0/3/0/4  admin-down  admin-down               ARPA  1514  100000000
          Hu0/3/0/5  admin-down  admin-down               ARPA  1514  100000000
          Hu0/3/0/6  admin-down  admin-down               ARPA  1514  100000000
          Hu0/3/0/7  admin-down  admin-down               ARPA  1514  100000000
          Hu0/3/0/8  admin-down  admin-down               ARPA  1514  100000000
          Hu0/3/0/9  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/10  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/11  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/12  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/13        down        down               ARPA  1514  100000000
         Hu0/3/0/14          up          up               ARPA  1514  100000000
         Hu0/3/0/15          up          up               ARPA  1514  100000000
         Hu0/3/0/16  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/17  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/18          up          up               ARPA  1514  100000000
         Hu0/3/0/19          up          up               ARPA  1514  100000000
         Hu0/3/0/20  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/21  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/22  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/23  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/24          up          up               ARPA  1514  100000000
         Hu0/3/0/25  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/27  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/28  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/29  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/30  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/31  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/32  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/33  admin-down  admin-down               ARPA  1514  100000000
         Hu0/3/0/34        down        down               ARPA  1514  100000000
         Hu0/3/0/35          up          up               ARPA  1514  100000000
     Mg0/RP0/CPU0/0          up          up               ARPA  1514    1000000
     Mg0/RP1/CPU0/0          up          up               ARPA  1514    1000000
   

This example shows the output from the show interfaces interface-path-id sparse command.

Router#show interfaces gigabitEthernet 0/1/0/0 sparse
Wed Apr 5 18:05:34.000 IST

Interface name : GigabitEthernet0/1/0/0
Operational state : administratively down
Admin state : administratively down
MAC address : 02:7d:42:e9:bd:36
Burned In Address : 027d.42e9.bd36
IPv4 Address : 2.2.2.2/24
Max. Bandwidth (Kbit) : 1000000
Effective Bandwidth (Kbit) : 1000000
MTU (in bytes) : 1514
Duplexity : Full-duplex
Link type : force-up
Table 1. show interfaces Field Descriptions

Field

Description

Interface name

Displays the name of the current interface. In the example, the interface name is TenGigE0/1/0/1.

Interface state

Displays the state of the interface. In the example, the interface is in the administratively down state.

Interface state transitions

Displays the number of times the interface has changed the state.

Note

 
  • Interface state transitions command counts only if the interface stays up. If the line protocol flaps, then it is not counted.
  • Interface state transitions counts the state when the line protocol state changes the state from up to down/admin-down or admin-down/down to up. If an interface changes the state from down to admin-down or admin-down to down, the counter is not incremented.

  • Use the clear state-transitions command to clear the counter for the current or all interfaces.

line protocol state

Displays the state of the Layer 2 line protocol. This field may be different from the interface state if, for example, a keepalive failure has brought down the Layer 2.

Note

 

The line protocol state is not the same as the protocol state displayed in the show ip interfaces command, because it is the state of Layer 2 (media) rather than Layer 3 (IP protocol).

Hardware

Displays the current hardware type.

address is n.n.n.n/n

Displays the Layer 2 address (MAC address for Ethernet interfaces).

Note

 

Enter the mac-address command to configure the hardware address.

bia

Displays the burned-in address (BIA) for the interface. The BIA is the default L2 (MAC) address for the interface.

Note

 

The BIA is not configurable.

description

Displays the user-defined string that is associated with the interface.

Note

 

Enter the description command to configure the description associated with the interface.

Internet address

Displays the Layer 3 (IP) address for the interface.

Note

 

Enter the ipv4 address command to configure the internet address for the interface.

MTU

Displays the maximum transmission unit (MTU) for the interface. The MTU is the maximum packet size that can be transmitted over the interface.

Note

 

The MTU field indicates the interface MTU. Enter the mtu command to configure a lower MTU value at the Layer 3 level.

BW

Displays the bandwidth of the interface in kbps.

reliability

Displays the proportion of packets that are not dropped and do not have errors.

Note

 

The reliability is shown as a fraction of 255.

txload

Indicates the traffic flowing out of the interface as a proportion of the bandwidth.

Note

 

The txload is shown as a fraction of 255.

rxload

Indicates the traffic flowing into the interface as a proportion of the bandwidth.

Note

 

The rxload is shown as a fraction of 255.

Encapsulation

Layer 2 encapsulation installed on the interface.

CRC

Indicates the length of the cyclic redundancy check (CRC), in bytes.

Note

 

The CRC is not present for all interface types.

Note

 

Enter the pos crc command to configure the CRC.

loopback or controller loopback

Indicates whether the hardware has been configured to be looped back.

Note

 

Enter the loopback command to configure the loopback or controller loopback.

keepalive

Displays the configured keepalive value, in seconds.

Note

 

Enter the keepalive command to configure the value of the keepalive field.

Note

 

The keepalive field may not be present if it is not applicable to the interface type.

Duplexity

Displays the duplexity of the link.

Note

 

This field is present only for shared media.

Note

 

For some interface types, you can configure the duplexity by entering the full-duplex and half-duplex commands.

Speed

Speed and bandwidth of the link in Mbps. This field is present only when other parts of the media info line are also displayed (see duplexity and media type).

Media Type

Media type of the interface.

output flow control

Whether output flow control is enabled on the interface.

input flow control

See output flow control.

ARP type

Address Resolution Protocol (ARP) type used on the interface. This value is not displayed on interface types that do not use ARP.

ARP timeout

ARP timeout in hours:mins:secs. This value is configurable using the arp timeout command.

Last clearing of counters

Time since the following counters were last cleared using the clear counters exec command in hours:mins:secs.

Input rate

Average number of bits and packets received per second during the load-interval. If the interface is not in promiscuous mode, it senses network traffic that it sends and receives (rather than all network traffic).

Note

 

Load duration is based on load-interval configured under the interface. The default load duration is 5 minutes, if load-interval is not configured under the interface.

Note

 

The input rate should be used only as an approximation of traffic per second during a given load duration. This rate is exponentially weighted average with a time constant of load duration. A period of four time constants must pass before the average will be within two percent of the instantaneous rate of a uniform stream of traffic over that period.

packets input

Number of packets received on the interface that were successfully delivered to higher layers.

bytes input

Total number of bytes successfully received on the interface.

Note

 

This does not include FCS bytes.

total input drops

Total number of packets that were dropped after they were received. This includes packets that were dropped due to configured quality of service (QoS) or access control list (ACL) policies. This does not include drops due to unknown Layer 3 protocol.

drops for unrecognized upper-level protocol

Total number of packets that could not be delivered because the necessary protocol was not configured on the interface.

Received broadcast packets

Total number of Layer 2 broadcast packets received on the interface. This is a subset of the total input packet count.

Received multicast packets

Total number of Layer 2 multicast packets received on the interface. This is a subset of the total input packet count.

runts

Number of received packets that were too small to be handled. This is a subset of the input errors count.

giants

Number of received packets that were too large to be handled. This is a subset of the input errors count.

throttles

Number of packets dropped due to throttling (because the input queue was full).

parity

Number of packets dropped because the parity check failed.

input errors

Total number of received packets that contain errors and hence cannot be delivered. Compare this to total input drops, which counts packets that were not delivered despite containing no errors.

CRC

Number of packets that failed the CRC check.

frame

Number of packets with bad framing bytes.

overrun

Number of overrun errors experienced by the interface. Overruns represent the number of times that the receiver hardware is unable to send received data to a hardware buffer because the input rate exceeds the receiver's ability to handle the data.

ignored

Total number of ignored packet errors. Ignored packets are those that are discarded because the interface hardware does not have enough internal buffers. Broadcast storms and bursts of noise can result in an increased number of ignored packets.

abort

Total number of abort errors on the interface.

packets output

Number of packets received on the interface that were successfully delivered to higher layers.

bytes output

Total number of bytes successfully received on the interface.

Note

 

This does not include FCS bytes.

total output drops

Number of packets that were dropped before being transmitted

Received broadcast packets

Number of Layer 2 broadcast packets transmitted on the interface. This is a subset of the total input packet count.

Received multicast packets

Total number of Layer 2 multicast packets transmitted on the interface. This is a subset of the total input packet count.

output errors

Number of times that the receiver hardware was unable to handle received data to a hardware buffer because the input rate exceeded the receiver's ability to handle the data.

underruns

Number of underrun errors experienced by the interface. Underruns represent the number of times that the hardware is unable to transmit data to a hardware buffer because the output rate exceeds the transmitter’s ability to handle the data.

applique

Number of applique errors.

resets

Number of times that the hardware has been reset. The triggers and effects of this event are hardware-specifc.

output buffer failures

Number of times that a packet was not output from the output hold queue because of a shortage of MEMD shared memory.

output buffers swapped out

Number of packets stored in main memory when the output queue is full; swapping buffers to main memory prevents packets from being dropped when output is congested. The number is high when traffic is bursty.

carrier transitions

Number of times the carrier detect (CD) signal of a serial interface has changed state.

show inventory

To retrieve and display information about all the Cisco products that are installed in the router, use the show inventory command in XR EXEC mode.

show inventory [ node-id | all | location { node-id | all } | raw | chassis | details | fan | power | vendor-type ]

Syntax Description

node-id

(Optional) Location for which to display the specified information. The node-id argument is entered in the rack/ slot notation.

all

(Optional) Displays inventory information for all the physical entities in the chassis.

location {node-id|all}

(Optional) Displays inventory information for a specific node, or for all nodes in the chassis.

raw

(Optional) Displays raw information about the chassis for diagnostic purposes.

chassis

(Optional) Displays only information about the chassis.

details

(Optional) Displays detailed entity information.

fan

(Optional) Displays inventory information for the fans.

power

(Optional) Displays inventory information for the power supply.

vendor-type

(Optional) Displays vendor-type information.

Command Default

All inventory information for the entire chassis is displayed.

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

If a Cisco entity is not assigned a product ID (PID), that entity is not retrieved or displayed.

Enter the show inventory command with the raw keyword to display every RFC 2737 entity installed in the router, including those without a PID, unique device identifier (UDI), or other physical identification.


Note


The raw keyword is primarily intended for troubleshooting problems with the show inventory command itself.


If any of the Cisco products do not have an assigned PID, the output displays incorrect PIDs, and version ID (VID) and serial number (SN) elements may be missing.

For UDI compliance products, the PID, VID, and SN are stored in EEPROM and NVRAM. Use the show inventory command to display this information.

Examples

The following example shows partial sample output from the show inventory command with the raw keyword:

Router#show inventory raw
Tue Mar  7 07:34:48.602 UTC

NAME: "Rack 0", DESCR: "Cisco 8201 1RU Chassis"
PID: 8201              , VID: V00, SN: FOC2217JIRS

NAME: "Rack 0-Control Card Slot 0", DESCR: "8201 Route Processor Slot 0"
PID: N/A               , VID: N/A, SN: N/A

NAME: "0/RP0/CPU0", DESCR: "Cisco 8201 1RU Chassis"
PID: 8201              , VID: V00, SN: FOC2219JGLB

NAME: "0/RP0/CPU0-Mother Board", DESCR: "Mother Board"
PID: N/A               , VID: N/A, SN: N/A

NAME: "0/RP0/CPU0-Broadwell-DE (D-1530)", DESCR: "Processor Module"
PID: N/A               , VID: N/A, SN: N/A

NAME: "0/RP0/CPU0-Attention", DESCR: "LED Sensor"
PID: N/A               , VID: N/A, SN: N/A

NAME: "0/RP0/CPU0-Status", DESCR: "LED Sensor"
PID: N/A               , VID: N/A, SN: N/A

NAME: "0/RP0/CPU0-Sync", DESCR: "LED Sensor"
PID: N/A               , VID: N/A, SN: N/A

NAME: "0/RP0/CPU0-MB_RT_GB_PIN", DESCR: "Power Sensor - MB-RT_GB_ONLY_0.8VB_PIN"
PID: N/A               , VID: N/A, SN: N/A
 --More--

The following example shows the sample output from the show inventory command with the chassis keyword:

Router#show inventory chassis
Thu Apr 6 04:56:46.987 UTC

NAME: "Rack 0", DESCR: "Cisco 8808 8-slot Chassis"
PID: 8808 , VID: V00, SN: FOX224PPUDA

The following table describes the significant fields shown in the display.

Table 2. show inventory Field Descriptions

Field

Description

NAME

Hardware for which the inventory information is displayed. If you are displaying the chassis inventory, this field shows “chassis.” If you are displaying raw inventory, or all inventory information for all nodes in the chassis, this field shows the node name in partially qualified format. For a node, the NAME is expressed in rack/ slot notation.

DESCR

Describes the chassis or the node.

Chassis descriptions provide the name of the chassis and its Gbps. Node descriptions provide the type of node and its software version.

PID

Physical model name of the chassis or node.

VID

Physical hardware revision of the chassis or node.

SN

Physical serial number for the chassis or node.

show ipv4 interface

To display the usability status of interfaces configured for IPv4, use the show ipv4 interface command in XR EXEC mode.

show ipv4 interface [ type interface-path-id | brief | summary ]

Command Default

If VRF is not specified, the software displays the default VRF.

Command Modes

XR EXEC mode

Usage Guidelines

The show ipv4 interface command provides output similar to the show ipv6 interface command, except that it is IPv4-specific.

Task ID

Task ID

Operations

ipv4

read

network

read

Examples

This is the sample output of the show ipv4 interface command:


Router# show ipv4 interface

Loopback0 is Up, line protocol is Up
  Internet address is 
.0.0.1/

  Secondary address 10.0.0./8
  MTU is 1514 (1514 is available to IP)
  Multicast reserved groups joined: 10.0.0.1
  Directed broadcast forwarding is disabled
  Outgoing access list is not set
  Inbound  access list is not set
  Proxy ARP is enabled
  ICMP redirects are always sent
  ICMP unreachables are always sent
/0/0/0 is Up, line protocol is Up
  Internet address is 10.25.58.1/16
  MTU is 1514 (1500 is available to IP)
  Multicast reserved groups joined: .0..1
  Directed broadcast forwarding is disabled
  Outgoing access list is not set
  Inbound  access list is not set
  Proxy ARP is enabled
  ICMP redirects are always sent
  ICMP unreachables are always sent
/0/0/0 is Shutdown, line protocol is Down
  
  Internet protocol processing disabled

This table describes the significant fields shown in the display.

Table 3. show ipv4 interface Command Field Descriptions

Field

Description

Loopback0 is Up

If the interface hardware is usable, the interface is marked “Up.” For an interface to be usable, both the interface hardware and line protocol must be up.

line protocol is Up

If the interface can provide two-way communication, the line protocol is marked “Up.” For an interface to be usable, both the interface hardware and line protocol must be up.

Internet address

IPv4 Internet address and subnet mask of the interface.

Secondary address

Displays a secondary address, if one has been set.

MTU

Displays the IPv4 MTU1 value set on the interface.

Multicast reserved groups joined

Indicates the multicast groups this interface belongs to.

Directed broadcast forwarding

Indicates whether directed broadcast forwarding is enabled or disabled.

Outgoing access list

Indicates whether the interface has an outgoing access list set.

Inbound access list

Indicates whether the interface has an incoming access list set.

Proxy ARP

Indicates whether proxy ARP2 is enabled or disabled on an interface.

ICMP redirects

Specifies whether ICMPv43 redirects are sent on this interface.

ICMP unreachables

Specifies whether unreachable messages are sent on this interface.

Internet protocol processing disabled

Indicates an IPv4 address has not been configured on the interface.

1 MTU = maximum transmission unit
2 ARP = Address Resolution Protocoladdress resolution protocol
3 ICMPv4 = Internet Control Message Protocol internet control message protocol version 4

show ipv6 interface

To display the usability status of interfaces configured for IPv6, use the show ipv6 interface command in XR EXEC mode.

show ipv6 interface [ summary | [ type interface-path-id ] [ brief [ link-local | global ] ] ]

Syntax Description

type

(Optional) Interface type. For more information, use the question mark (?) online help function.

interface-path-id

(Optional) Either a physical interface instance or a virtual interface instance as follows:

  • Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

    • rack: Chassis number of the rack.

    • slot: Physical slot number of the modular services card or line card.

    • module: Module number. A physical layer interface module (PLIM) is always 0.

    • port: Physical port number of the interface.

    Note

     

    In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RSP0) and the module is CPU0. Example: interface MgmtEth0/RSP0 /CPU0/0.

  • Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.

brief

(Optional) Displays the primary IPv6 addresses configured on the router interfaces and their protocol and line states.

link-local

(Optional) Displays the link local IPv6 address.

global

(Optional) Displays the global IPv6 address.

summary

(Optional) Displays the number of interfaces on the router that are assigned, unassigned, or unnumbered.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 6.0

This command was introduced.

Usage Guidelines

The show ipv6 interface command provides output similar to the show ipv4 interface command, except that it is IPv6-specific.

Use the link-local or global keywords along with the brief keyword to view the link local or global IPv6 addresses.

Task ID

Task ID

Operations

ipv6

read

Examples

This is the sample output of the show ipv6 interface command:

Router#show ipv6 interface
Wed Mar  8 04:27:58.236 UTC
FourHundredGigE0/0/0/0 is Shutdown, ipv6 protocol is Down, Vrfid is default (0x60000000)
  IPv6 is disabled, link-local address unassigned
  No global unicast address is configured
FourHundredGigE0/0/0/1 is Shutdown, ipv6 protocol is Down, Vrfid is default (0x60000000)
  IPv6 is disabled, link-local address unassigned
  No global unicast address is configured
FourHundredGigE0/0/0/2 is Shutdown, ipv6 protocol is Down, Vrfid is default (0x60000000)
  IPv6 is disabled, link-local address unassigned
  No global unicast address is configured
FourHundredGigE0/0/0/3 is Shutdown, ipv6 protocol is Down, Vrfid is default (0x60000000)
  IPv6 is disabled, link-local address unassigned
  No global unicast address is configured
FourHundredGigE0/0/0/4 is Shutdown, ipv6 protocol is Down, Vrfid is default (0x60000000)
  IPv6 is disabled, link-local address unassigned
  No global unicast address is configured
FourHundredGigE0/0/0/5 is Shutdown, ipv6 protocol is Down, Vrfid is default (0x60000000)
  IPv6 is disabled, link-local address unassigned
  No global unicast address is configured
FourHundredGigE0/0/0/6 is Shutdown, ipv6 protocol is Down, Vrfid is default (0x60000000)
  IPv6 is disabled, link-local address unassigned
  No global unicast address is configured
FourHundredGigE0/0/0/7 is Shutdown, ipv6 protocol is Down, Vrfid is default (0x60000000)
  IPv6 is disabled, link-local address unassigned
 --More--

This table describes the significant fields shown in the display.

Table 4. show ipv6 interface Command Field Descriptions

Field

Description

Indicates whether the interface hardware is currently active (whether line signal is present) and whether it has been taken down by an administrator. If the interface hardware is usable, the interface is marked “Up.” For an interface to be usable, both the interface hardware and line protocol must be up.

line protocol is Up (or down)

Indicates whether the software processes that handle the line protocol consider the line usable (that is, whether keepalives are successful). If the interface can provide two-way communication, the line protocol is marked “Up.” For an interface to be usable, both the interface hardware and line protocol must be up.

IPv6 is enabled, stalled, disabled (stalled and disabled are not shown in sample output)

Indicates that IPv6 is enabled, stalled, or disabled on the interface. If IPv6 is enabled, the interface is marked “enabled.” If duplicate address detection processing identified the link-local address of the interface as being a duplicate address, the processing of IPv6 packets is disabled on the interface and the interface is marked “stalled.” If IPv6 is not enabled, the interface is marked “disabled.”

link-local address

Displays the link-local address assigned to the interface.

TENTATIVE

The state of the address in relation to duplicate address detection. States can be any of the following:

  • duplicate—The address is not unique and is not being used. If the duplicate address is the link-local address of an interface, the processing of IPv6 packets is disabled on that interface.

  • tentative—Duplicate address detection is either pending or under way on this interface.

Note

 

If an address does not have one of these states (the state for the address is blank), the address is unique and is being used.

Global unicast addresses

Displays the global unicast addresses assigned to the interface.

ICMP redirects

State of Internet Control Message Protocol (ICMP) IPv6 redirect messages on the interface (the sending of the messages is enabled or disabled).

ND DAD

State of duplicate address detection on the interface (enabled or disabled).

number of DAD attempts

Number of consecutive neighbor solicitation messages that are sent on the interface while duplicate address detection is performed.

ND reachable time

Displays the neighbor discovery reachable time (in milliseconds) assigned to this interface.

Examples

This is the sample output of the show ipv6 interface brief link-local command:

Router#show ipv6 interface brief link-local





This is the sample output of the show ipv6 interface brief global command:

Router#show ipv6 interface brief global



This is the sample output of the show ipv6 interface type interface-path-id brief link-local command:

Router#show ipv6 interface tenGigE 0/0/0/0 brief link-local

Interface                 IPv6-Address                  Status     Protocol
0/0/0/0    fe80::fe:8ff:fecb:26c5        Up         Up

This is the sample output of the show ipv6 interface type interface-path-id brief global command:

Router#show ipv6 interface tenGigE 0/0/0/0 brief global

Interface                 IPv6-Address                  Status     Protocol
0/0/0/0    2001:db8::1                   Up         Up

show logging

To display the contents of the logging buffer, use the show logging command in XR EXEC mode.

show logging [ [ alarm-location location location ] | | [ correlator options ] | local location node-id | [ location node-id ] [ start month day hh : mm : ss ] [ process name ] [ string string ] [ end month day hh : mm : ss ] [ events options ] [ files ] [ history ] [ last entries ] [ onboard entries ] [ suppress rule { rule_name | all } ] ]

Syntax Description

alarm-location trace location

(Optional) Displays alarm-location information. The trace option shows trace data for the alarm location components.

correlatoroptions

(Optional) Displays content and information about correlation buffer. Options available are:

  • buffer: Displays content of the correlation buffer.

  • info: Displays information about event correlation.

  • trace: Displays trace data for the alarm_logger component.

end month day hh : mm : ss

(Optional) Displays syslog messages with a time stamp equal to or lower than the time stamp specified with the monthday hh : mm : ss argument.

The ranges for the month day hh : mm : ss arguments are:

  • month —The month of the year. The values for the month argument are the names of the twelve months.
  • day —Day of the month. Range is from 01 to 31.
  • hh : —Hours. Range is from 00 to 23. You must insert a colon after the hh argument.
  • mm : —Minutes. Range is from 00 to 59. You must insert a colon after the mm argument.
  • ss —Seconds. Range is from 00 to 59.
events options
Displays content and information about the event buffer.The various options available are:
  • buffer: Displays content of the event buffer.
  • info: Displays information about events buffer.
  • rule: Displays specified rules.
  • ruleset: Displays rulesets.
  • trace: Displays trace data for the correlation component.
files

Show logging files and path.

history

Displays contents of logging history.

last entries

Displays last <n> entries. The number of entries can range from 1 to 500.

local location node-id

(Optional) Displays system logging (syslog) messages from the specified local buffer. The node-id argument is entered in the rack/slot/modul e notation.

location node-id

(Optional) Displays syslog messages from the designated node. The node-id argument is entered in the rack/slot/modul e notation.

onboard options
Displays on board logging.The various options available are:
  • alarm: Displays alarm data.

  • fpd: Displays FPD version data.

  • inventory: Displays inventory data.

  • npu: Displays NPU life-time data.

  • temperature: Displays temperature sensor data

  • uptime: Displays system uptime data

  • voltage: Displays voltage sensor data.

start month day hh : mm : ss

(Optional) Displays syslog messages with a time stamp equal to or higher than the time stamp specified with the month day mm : hh : ss argument.

The ranges for the month day hh : mm : ss arguments are as follows:

  • month —The month of the year. The values for the month argument are the names of the twelve months.
  • day —Day of the month. Range is from 01 to 31.
  • hh : —Hours. Range is from 00 to 23. You must insert a colon after the hh argument.
  • mm : —Minutes. Range is from 00 to 59. You must insert a colon after the mm argument.
  • ss —Seconds. Range is from 00 to 59.
process name

(Optional) Displays syslog messages related to the specified process.

string string

(Optional) Displays syslog messages that contain the specified string.

suppress rule{rule_name|all}

Displays content and information about log suppression. The rule option shows specified rules.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the show logging command to display the state of syslog error and event logging on the processor console. The information from the command includes the types of logging enabled and the size of the buffer.

Task ID

Task ID

Operations

logging

read

Examples

This is the sample output from the show logging command using both the process name keyword argument pair and location node-id keyword argument pair. Syslog messages related to the “init” process emitted from node 0/RP0/CPU0 are displayed in the sample output.

Router#show logging process init location 0/RP0/CPU0
Tue Mar  7 08:07:49.157 UTC
Syslog logging: enabled (0 messages dropped, 0 flushes, 0 overruns)
    Console logging: level warnings, 7 messages logged
    Monitor logging: level debugging, 0 messages logged
    Trap logging: level informational, 0 messages logged
    Buffer logging: level debugging, 133 messages logged

Log Buffer (2097152 bytes):

This table describes the significant fields shown in the display.

Table 5. show logging Field Descriptions

Field

Description

Syslog logging

If enabled, system logging messages are sent to a UNIX host that acts as a syslog server; that is, the host captures and saves the messages.

Console logging

If enabled, the level and the number of messages logged to the console are stated; otherwise, this field displays “disabled.”

Monitor logging

If enabled, the minimum level of severity required for a log message to be sent to the monitor terminal (not the console) and the number of messages logged to the monitor terminal are stated; otherwise, this field displays “disabled.”

Trap logging

If enabled, the minimum level of severity required for a log message to be sent to the syslog server and the number of messages logged to the syslog server are stated; otherwise, this field displays “disabled.”

Buffer logging

If enabled, the level and the number of messages logged to the buffer are stated; otherwise, this field displays “disabled.”

Examples

To find out OOR state of a router's hardware and Software Development Kit (SDK) resources, you can view the sample output from the show logging command with the output modifier as OOR. You can configure the threshold value at which a router reaches the OOR State Red or Yellow by using the oor hw threshold command. For more information, see oor hw threshold command in the chapter Logging Services Commands of System Monitoring Command Reference for Cisco 8000 Series Routers.

Router# show logging | inc OOR
Wed Jan 6 23:36:34.138 EST
LC/0/0/CPU0:Jan 6 23:01:09.609 EST: npu_drvr[278]: %PLATFORM-OFA-4-OOR_YELLOW : NPU 1, Table nhgroup, Resource stage2_lb_group
LC/0/0/CPU0:Jan 6 23:01:29.655 EST: npu_drvr[278]: %PLATFORM-OFA-4-OOR_YELLOW : NPU 1, Table nhgroup, Resource stage2_lb_member
LC/0/0/CPU0:Jan 6 23:01:38.938 EST: npu_drvr[278]: %PLATFORM-OFA-1-OOR_RED : NPU 3, Table nhgroup, Resource stage2_lb_group

show ntp status

To display the status of Network Time Protocol (NTP), use the show ntp status command in XR EXEC mode.

show ntp status [ location node-id ]

Syntax Description

location node-id

(Optional) Displays the status of NTP from the designated node. The node-id argument is entered in the rack/ slot notation.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

No specific guidelines impact the use of this command.

Task ID

Task ID

Operations

ip-services

read

Examples

This example shows sample output from the show ntp status command:


Router# show ntp status  

Clock is synchronized, stratum 3, reference is 192.168.128.5
nominal freq is 1000.0000 Hz, actual freq is 1000.0021 Hz, precision is 2**24
reference time is CC38EC6A.8FCCA1C4 (10:10:02.561 JST Tue Jul 29 2008)
clock offset is -124.051 msec, root delay is 174.060 msec
root dispersion is 172.37 msec, peer dispersion is 0.10 msec
loopfilter state is 'CTRL' (Normal Controlled Loop), drift is -0.0000021106 s/s
system poll interval is 32, last update was 19 sec ago
  
Table 6. show ntp status Field Descriptions

Field

Description

synchronized

Synchronized system to an NTP peer.

stratum

NTP stratum of this system.

reference

IPv4 address or first 32 bits of the MD5 hash of the IPv6 address of the peer to which clock is synchronized.

nominal freq

Nominal frequency in Hertz (Hz) of the system hardware clock.

actual freq

Measured frequency in Hz of the system hardware clock.

precision

Precision of the clock of this system in Hz.

reference time

Reference time stamp.

clock offset

Offset of clock to synchronized peer, in milliseconds.

root delay

Total delay along path to root clock, in milliseconds.

root dispersion

Dispersion of root path.

peer dispersion

Dispersion of synchronized peer.

loopfilter state

The state of the clock state machine transition function.

drift

Drift of the hardware clock.

system poll interval

Poll interval of the peer.

last update

Time the router last updated its NTP information.

show platform

To display information and status for each node in the system, use the show platform command in XR EXEC mode.

show platform [node-id]

Syntax Description

node-id

(Optional) Node for which to display information. The node-id argument is entered in the rack/ slot notation.

Command Default

Status and information are displayed for all nodes in the system.

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The show platform command provides a summary of the nodes in the system, including node type and status.

Enter the show platform command in EXEC mode to display output for only those nodes that belong to the SDR on which the command is executed.

Task ID

Task ID

Operations

system

read

Examples

The following example shows sample output from the show platform command:

Router#show platform
Thu Apr 6 00:56:22.922 UTC
Node              Type                     State                    Config state
--------------------------------------------------------------------------------
0/RP0/CPU0        8800-RP(Active)          IOS XR RUN               NSHUT,NMON
0/0/CPU0          8800-LC-48H              IOS XR RUN               NSHUT
0/1/CPU0          88-LC0-36FH-M            IOS XR RUN               NSHUT
0/FC0             8812-FC                  OPERATIONAL              NSHUT
0/FC1             8812-FC                  OPERATIONAL              NSHUT
0/FT0             8812-FAN                 OPERATIONAL              NSHUT
0/FT1             8812-FAN                 OPERATIONAL              NSHUT
0/FT2             8812-FAN                 OPERATIONAL              NSHUT
0/FT3             8812-FAN                 OPERATIONAL              NSHUT
0/PT0             8800-HV-TRAY             OPERATIONAL              NSHUT
0/PT1             8800-HV-TRAY             OPERATIONAL              NSHUT
0/PT2             8800-HV-TRAY             OPERATIONAL              NSHUT

The following is sample output for the show platform command with the node-id argument:

Router#show platform location 0/RP0/CPU0
Wed Mar  8 04:05:07.106 UTC
Node              Type                     State                    Config state
--------------------------------------------------------------------------------
0/RP0/CPU0        8201(Active)             IOS XR RUN               NSHUT

This table describes the significant fields shown in the display.

Table 7. show platform Field Descriptions

Field

Description

Node

Identifier of the node in the rack/ slot notation.

Type

Type of node.

State

Current state of the specified node.

Config State

Current configuration state of the specified node.

show redundancy

To display the status of route processor redundancy, use the show redundancy command in

EXEC

mode.

show redundancy [location {node-id | all} | statistics | summary]

Syntax Description

location {node-id | all}

(Optional) Specifies the node for which to display LED information. The node-id argument is expressed in the rack/ slot notation. Use the all keyword to indicate all nodes.

statistics

(Optional) Displays redundancy statistics information.

summary

(Optional) Displays a summary of all redundant node pairs in the router.

Command Default

Route processor redundancy information is displayed for all nodes in the system.

Command Modes

EXEC

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the show redundancy command to display the redundancy status of the route switch processors (RSPs). The show redundancy command also displays the boot and switchover history for the . To view the nonstop routing (NSR) status of the standby in the system, use the summary keyword.

Task ID

Task ID

Operations

system

read

basic-services

read (for statistics keyword)

Examples

The following example shows sample output from the show redundancy command:

Router# show redundancy location 0/rsp0/cpu0
Thu Jul 30 05:47:12.155 DST
Node 0/RSP0/CPU0 is in ACTIVE role
Node 0/RSP0/CPU0 has no valid partner

Reload and boot info
----------------------
A9K-RSP-4G reloaded Tue Jul 14 15:21:30 2009: 2 weeks, 1 day, 
14 hours, 25 minutes ago
Active node booted Tue Jul 14 15:21:30 2009: 2 weeks, 1 day, 
14 hours, 25 minutes ago

Active node reload "Cause: User initiated forced reload all"
 
Table 8. show redundancy Field Descriptions

Field

Description

Node */*/* is in XXX role

Current role of the primary route processor, where (*/*/*) is the route processor ID in the format rack/slot/module, and XXX is the role of the route processor (active or standby).

In the example, this field shows that the node with the ID 0/RP0/CPU0 is in active role.

Partner node (*/*/* ) is in XXX role

Current role of the secondary (or partner) route processor, where (*/*/*) is the route processor ID in the rack/slot/module format, and XXX is the role of the route processor (active or standby).

In the example, this field shows that the node with the ID 0/RP1/CPU0 is in standby role.

Standby node in (*/*/* ) is ready

Current state of the standby node, where (*/*/*) is the standby route processor ID.

In the example, the standby node is ready.

Standby node in (*/*/* ) is NSR-ready

Current state of the standby node regarding nonstop routing (NSR), where (*/*/*) is the standby route processor ID.

In the example, the standby node is NSR-ready.

Reload and boot info

General overview of the active and standby route processors’ reload and boot history.

show version

To display the software version, build information, system hardware type and uptime, use the show version command in XR EXEC mode.

show version

Syntax Description

This command has no keywords or arguments.

.

Command Default

None

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

The show version command displays a variety of system information, including hardware and software version, router uptime, and active software.

Task ID

Task ID

Operations

basic-services

read

Examples

This example shows partial output from the show version command:

Router#show version
Cisco IOS XR Software, Version 7.8.2 LNT
Copyright (c) 2013-2023 by Cisco Systems, Inc.

Build Information:
 Built By     : ingunawa
 Built On     : Wed Mar 15 16:45:19 UTC 2023
 Build Host   : iox-ucs-060
 Workspace    : /auto/srcarchive13/prod/7.8.2/8000/ws
 Version      : 7.8.2
 Label        : 7.8.2

cisco 8000 (Intel(R) Xeon(R) CPU D-1530 @ 2.40GHz)
cisco 8812 (Intel(R) Xeon(R) CPU D-1530 @ 2.40GHz) processor with 32GB of memory
R1 uptime is 7 hours, 19 minutes
Cisco 8812 12-slot Chassis

show media

To display the current state of the disk storage media, use the show media command in XR EXEC mode.

show media location { node-id | all }

Syntax Description

location{node-id | all}

(Optional) Specifies the node where the file system is located. The node-id argument is expressed in the rack/ slot notation. Use the all keyword to indicate all nodes.

Command Default

The disk storage media for the active RP is displayed.

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 7.0.12

This command was introduced.

Usage Guidelines

Use the show media command to view the status of the storage media on your system.

Task ID

Task ID

Operations

filesystem

read

Examples

This example shows output from the show media command:

Router#show media location 0/RP0/CPU0
Tue Mar  7 15:00:14.506 UTC

Media Info for Location: node0_RP0_CPU0
Partition                            Size     Used  Percent    Avail
--------------------------------------------------------------------
rootfs:                             56.9G     8.8G      15%    48.2G
data:                               80.8G     1.4G       2%    79.4G
/var/lib/docker                      6.9G      17M       1%     6.5G
disk0:                               4.0G     8.4M       1%     3.8G
log:                                 5.5G      64M       2%     5.2G
harddisk:                             63G      53M       1%      60G