Cisco ASR 14000 Series Management Command Reference

Download

Cisco Confidential - Beta Review R3.7.1

Cisco ASR 14000 Series Router System Management Command Reference

Cisco IOS XR Software Release 3.7.1

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

Text Part Number: OL-17231-01

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 BELI EVED 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 LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALIN G, 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.

CCDE, CCENT, Cisco Eos, Cisco Lum in, Cisco Nexus, Cisco StadiumVision, Cisco TelePresence, the Cisco logo, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco

Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing,

Cisco FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQ Expertise, the iQ logo, iQ LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the

logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

WebEx

All other trademarks mentioned in this document o r Website 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. (0807R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

Cisco ASR 14000 Series Router System Management Command Reference

Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems,

Net Readiness Scorecard, iQuick Study, IronPort, the IronPort logo,

IMPLIED, INCLUDING, WITHOUT

Cisco Confidential - Beta Review R3.7.1

Preface

This reference describes the Cisco IOS XR system management commands available on the Cisco

ASR 14000 Series Router. This module contains the following sections:

• Changes to This Document, page iii

• Obtaining Documentation and Submitting a Service Request, page iii

Changes to This Document

Table 1 lists the technical changes made to this document since it was first printed.

Ta b l e 1 Changes to This Document

Revision Date Change Summary

OL-17231-01 October 2008 Initial release of this document.

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What’s revised Cisco

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to the What’s New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.

technical documentation, at:

New in Cisco Product Documentation, which also lists all new and

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

iii

Cisco Confidential - Beta Review R3.7.1

Preface

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Cisco Confidential - Beta Review R3.7.1

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

The Bulk Content Downloader (BCDL) provides the Cisco IOS XR software with high-performance downloading capabilities. This capability is used by the following internal applications:

• IPv4 and IPv6 unicast routing protocols—to provide the ability to download forwarding information

from the router Global Routing Information Base (GRIB) to the line cards.

• IPv4 and IPv6 multicast routing protocols—to download the Multicast Routing Information Base

(MRIB) entries to consumers managing the Multicast Forwarding Information Base (MFIB) on the various line cards and route processors (RPs).

• Multiprotocol Label Switching (MPLS)—to download the Label Forwarding Information Base

(LFIB) entries to the line card.

• Local Packet Transport Services (LPTS)—to maintain the Internal Forwarding Information Base

(IFIB) table on all nodes that do IP forwarding to and from the RPs.

• Fabric Management—to update memberships for individual fabric group IDs (FGIDs) to selected

portions of the fabric hardware.

• Context Distribution Service (CDS).

There is no configuration necessary for the BCDL. This module describes the available show commands that you can use to see the status of the BCDL process.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-1

show bcdl

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

To display Bulk Content Downloader (BCDL) information, use the show bcdl command in EXEC mode.

show bcdl [group_name]

Syntax Description

group_name (Optional) Displays information for a specific BCDL group.

Defaults No default behavior or values

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Tas k ID

Task ID Operations

sysmgr read

Examples The following example shows sample output from the show bcdl command:

RP/0/RP0/CPU0:router# show bcdl ipv4_rib

grp ipv4_rib, gid 2052, sg cnt 1, agent jid 112, node 0/RP0/CPU0, pulse 23930, new mbr 0 sg lwg fd csmr hdlr-act dnld-act susp wait-lck seq pulse-tot pulse-out 0 2053 16 6 no no no 0 23950 23926 0

Table 2 describes the significant fields shown in the display.

Ta b l e 2 show bcdl Field Descriptions

Field Description

group ipv4_rib Type of download and the Group Services Protocol (GSP) group name.

gid 2052 Heavyweight group (HWG) in the GSP. This is the group that a consumer

initially joins. It is used by the BCDL agent to send control updates.

sg count Number of subgroups for this particular download type.

agent jid 112 Job identifier of the BCDL agent. The JID is numerical identifier for a

particular process and remains the same across process restarts.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-2

OL-17231-01

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Table 2 show bcdl Field Descriptions (continued)

Field Description

node 0/RP0/CPU0 Node, expressed in the rack/slot/module notation, in which the agent is

running.

pulse 23930 Pulse code used by the producer to pulse the BCDL agent.

new mbr 0 Number of new consumers that have not yet been assigned a subgroup.

sg Subgroups number.

lwg Lightweight group in GSP. This is a type of child group of the HWG. The

BCDL agent tells the consumers to join this group to receive data.

fd The connection handle between the producer and the BCDL agent.

csmr Number of consumers.

hdlr-act Specifies if there is a download in progress.

dnld-act Indicates whether the convergence flag has been sent or not.

susp Indicates whether the download is suspended due to the queue filling up.

wait-lck If non-zero, some thread is waiting for other thread to take control of this

subgroup.

seq Sequence number of the last message sent on this subgroup.

pulse-tot Total number of pulses sent by the producer to the BCDL agent.

pulse-out Total number of outstanding pulses that have not yet been processed by the

BCDL agent.

show bcdl

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-3

show bcdl consumers

Cisco Confidential - Beta Review R3.7.1

show bcdl consumers

To display Bulk Content Downloader (BCDL) consumer information, use the show bcdl consumers command in EXEC mode.

show bcdl consumers [group_name]

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

Syntax Description

group_name (Optional) Displays information for a specific BCDL group.

Defaults No default behavior or values

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Tas k ID

Task ID Operations

sysmgr read

Examples The following example shows sample output using the show bcdl consumers command:

RP/0/RP0/CPU0:router# show bcdl consumers ipv4_rib

group ipv4_rib, gsp gid 2029, 3 consumers, agent jid 113, node 0/5/CPU0 (expected 3 consumers to reply, received 3 replies) pid node asg csg lwg sus messages bytes errs name 823389 0/5/CPU0 0 0 2030 N 20559 1518476 0 fib_mgr 45129 0/1/CPU0 0 0 2030 N 1922 222892 496 fib_mgr 45129 0/3/CPU0 0 0 2030 N 1922 222892 498 fib_mgr

Table 3 describes the significant fields shown in the display that are not described in Tab l e 2.

Ta b l e 3 show bcdl consumers Field Descriptions

Field Description

PID Process indentifier.

node Consumer node, expressed in the rack/slot/module notation.

asg Subgroup to which the BCDL agent thinks this consumer belongs.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-4

OL-17231-01

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Table 3 show bcdl consumers Field Descriptions (continued)

Field Description

csg Subgroup to which the consumer thinks it belongs.

messages Number of messages processed by this particular consumer.

bytes Bytes processed by this particular consumer.

errors Errors encountered by the consumer. This field indicates the number of times

the connection was reset.

name Name of the consumer process.

show bcdl consumers

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-5

show bcdl queues

Cisco Confidential - Beta Review R3.7.1

show bcdl queues

To display the Bulk Content Downloader (BCDL) queue information, use the show bcdl queues command in EXEC mode.

show bcdl queues [group_name]

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

Syntax Description

group_name (Optional) Displays information for a specific BCDL group.

Defaults No default behavior or values

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Tas k ID

Task ID Operations

sysmgr read

Examples The following example shows sample output from the show bcdl queue command:

RP/0/RP0/CPU0:router# show bcdl queues ipv4_rib

group ipv4_rib, gsp gid 2052, 6 consumers, agent jid 112, node 0/RP0/CPU0 (expected 6 consumers to reply, received 6 replies) pid node asg csg lwg sus msgs_in_q bytes_in_q errs name 417925 0/RP0/CPU0 0 0 2053 N 0 0 0 fib_mgr 209029 0/RP1/CPU0 0 0 2053 N 0 0 0 fib_mgr 106595 0/4/CPU0 0 0 2053 N 0 0 0 fib_mgr 114785 0/4/CPU1 0 0 2053 N 0 0 0 fib_mgr 82008 0/6/CPU0 0 0 2053 N 0 0 0 fib_mgr 82008 0/1/CPU0 0 0 2053 N 0 0 0 fib_mgr

Table 3 and Table 2 describe the significant fields shown in the display.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-6

OL-17231-01

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

show bcdl tables

To display Bulk Content Downloader (BCDL) table information, use the show bcdl tables command in EXEC mode.

show bcdl tables [group_name]

show bcdl tables

Syntax Description

group_name (Optional) Displays information for a specific BCDL group.

Defaults No default behavior or values

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Tas k ID

Task ID Operations

sysmgr read

Examples The following example shows sample output using the show bcdl tables command:

RP/0/RP0/CPU0:router# show bcdl tables ipv4_rib

grp ipv4_rib, gid 2052, sg cnt 1, agent jid 112, node 0/RP0/CPU0, pulse 26587, new mbr 0 sg lwg fd csmr hdlr-act dnld-act susp wait-lck seq pulse-tot pulse-out 0 2053 16 6 no no no 0 26607 26583 0 sgs: 1, table_cnt: 1, table_mid_cnt: 6, buf size: 124 Showing table info for 1 subgroups sg 0: has 1 tables (messages: 0, bytes: 0) table 0xe0000000: 6 members, dnld act: 0, messages: 26607, bytes: 3447976 cnsmr 0: pid 417925 on node 0/RP0/CPU0 cnsmr 1: pid 82008 on node 0/6/CPU0 cnsmr 2: pid 82008 on node 0/1/CPU0 cnsmr 3: pid 209029 on node 0/RP1/CPU0 cnsmr 4: pid 106595 on node 0/4/CPU0 cnsmr 5: pid 114785 on node 0/4/CPU1

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

SMR-7

show bcdl tables

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Table 4 describes the significant fields shown in the display that are not described in Ta ble 2 or Ta ble 3.

Ta b l e 4 show bcdl tables Field Descriptions

Field Description

sgs Number of subgroups.

table_cnt Number of tables in this subgroup.

sg Specific subgroup for which information is provided.

has 1 tables Number of tables in this subgroup.

messages Messages sent that are not associated with a particular table ID.

bytes Bytes sent that are not associated with a particular table ID.

table Specific table ID for which information is provided.

6 members Number of consumers associated with this table.

dnld act Indicates whether the convergence flag has been sent or not

messages Number of messages sent for a particular table.

bytes Number of bytes sent for a particular table.

cnsmr 0: pid 419725 on node 0/RP0/CPU0

Process ID and node information for each consumer in the specified table.

SMR-8

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

show bcdl trace

To display Bulk Content Downloader (BCDL) trace information, use the show bcdl trace command in EXEC mode.

show bcdl trace [group_name] [event] [grpsnd] [hexdump] [last n] [reverse] [stats] [tailf]

[unique] [verbose] [wrapping] [file filename original] [location [node-id | all]]

show bcdl trace

Syntax Description

Defaults No default behavior or values

group_name (Optional) Displays information for a specific BCDL group.

event Displays event trace entries.

grpsnd Displays group send trace entries.

hexdump Displays traces in hexidecimal format.

last n Displays the last n number of traces only.

reverse Displays the most recent traces first.

stats Displays execution path statistics.

tailf Displays new traces as they are added.

unique Displays unique entries only, along with the count of the number of times

this entry appears.

verbose Displays additional internal debugging information.

wrapping Displays wrapping entries.

file filename original Specifies the filename of the file to display.

location node-id Specifies the RP node for which to display the execution path monitoring

information. The node-id argument is expressed in rack/slot/module notation.

all Displays mirroring information for all RP nodes in the router.

Command Modes EXEC

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Tas k ID

OL-17231-01

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

Task ID Operations

sysmgr read

Cisco ASR 14000 Series Router System Management Command Reference

SMR-9

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

show bcdl trace

Cisco Confidential - Beta Review R3.7.1

Examples The following example shows sample output using the show bcdl trace command:

RP/0/RP0/CPU0:router# show bcdl trace ipv4_rib location 0/0/cpu0 | inc /a/

Jul 7 09:02:25.658 bcdl/a/ipv4_rib 0/0/CPU0 t1 E bytes critical 524288, normal 262144, max suspend 60 Jul 7 09:02:25.658 bcdl/a/ipv4_rib 0/0/CPU0 t1 E buffer size set to 65200 Jul 7 09:02:25.981 bcdl/a/ipv4_rib 0/0/CPU0 t1 E group_create bcdl_ipv4_rib returns 0, gid is 2055 Jul 7 09:02:30.806 bcdl/a/ipv4_rib 0/0/CPU0 t3 E queuing new consumer: pid 172153, node 0/0/CPU0 Jul 7 09:02:30.807 bcdl/a/ipv4_rib 0/0/CPU0 t3 E add new member: pid 172153, node 0/0/CPU0 nmc 0 -> 1 Jul 7 09:02:31.812 bcdl/a/ipv4_rib 0/0/CPU0 t5 E attempt open producer connection sg 0 Jul 7 09:02:31.895 bcdl/a/ipv4_rib 0/0/CPU0 t5 E bind sg 0 to producer, fd 14, handle 0x48230e08 Jul 7 09:02:31.895 bcdl/a/ipv4_rib 0/0/CPU0 t5 E sbe: gid 2055, lwg_s: 0, lwg 2056, node 0/0/CPU0, ent 1, rc 11, rr 1 Jul 7 09:02:31.895 bcdl/a/ipv4_rib 0/0/CPU0 t5 E send_bcdl_event: sending BCDL_EVENT, rc 11(connection init), entries 1 Jul 7 09:02:31.942 bcdl/a/ipv4_rib 0/0/CPU0 t3 E processing table request Jul 7 09:02:31.943 bcdl/a/ipv4_rib 0/0/CPU0 t3 E add 1 table tags, first tag 0xe0000000 Jul 7 09:02:31.945 bcdl/a/ipv4_rib 0/0/CPU0 t3 E create_table_entry: create 0xe0000000, in sg 0, with pid 172153, node 0/0/CPU0 Jul 7 09:02:31.945 bcdl/a/ipv4_rib 0/0/CPU0 t3 E Call p_t_f to add table 0xe0000000 to sg 0 inherit FALSE

SMR-10

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Cisco Confidential - Beta Review R3.7.1

Boot Commands on Cisco IOS XR Software

This chapter describes the commands used to boot or reset Cisco IOS XR software.

For more information about boot tasks, see Cisco ASR 14000 Series Routers Getting Started Guide.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-11

config-register

Cisco Confidential - Beta Review R3.7.1

config-register

To define the configuration register boot value, use the config-register command in administration EXEC mode.

config-register value [location {node-id | all}]

Boot Commands on Cisco IOS XR Software

Syntax Description

Defaults By default, the configuration register value is 0x102 after a TURBOBOOT.

Command Modes Administration EXEC

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

value Hexadecimal or decimal value that represents the 16-bit configuration

For information about common configuration register settings, see

Table 5.

location {node-id | all} Specifies the node in a multishelf system. The all keyword specifies

all RP nodes.

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

SMR-12

The configuration register setting is a 16-bit, user-configurable value that determines how the route processor (RP) functions during initialization. The configuration register can cause the RP to boot normally from the default configuration, or to enter ROMMON mode during a reload. Configuration register settings can also be used to perform tasks such as password recovery.

The config-register command is entered in administration EXEC mode, on the designated system controller (DSC). The DSC is the primary RP of the router. When setting the configuration register value for the

• If both the primary and standby DSC are up and running when the configuration register value is set,

• By contrast, if only the primary DSC is up and running when the configuration register value is set

Note To display the current configuration settings, use the command show variables boot.

Cisco ASR 14000 Series Router System Management Command Reference

config-register command, note the following conditions:

the configuration register value applies to both the primary and standby DSC.

and the standby DSC is introduced into the router at a later time, the router does not attempt to synchronize the configuration register value for the standby RP to that of the active RP; in this situation, the configuration register setting applied to the standby DSC is determined by the configuration register value set in ROMMON mode.

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Enter the command config-register value to set the configuration register setting for the DSC.

The most commonly used configuration register settings are described in Tab le 5.

Ta b l e 5 Common Configuration Register Settings

Valu e Description

0x0 RP enters ROMMON mode (rommon B1>) on the next system boot.

0x2 RP loads the Cisco IOS XR software and default configuration on the

0x102 Router loads the Cisco IOS XR software with the console break key

0x40 Router enters the password recovery mode on the next system boot.

config-register

next system boot. After logging in, the user can access EXEC mode.

disabled on the next system boot.

Tas k ID

Task ID Operations

root-lr read, write

Examples The following example shows how to set the configuration register on the DSC to 0x2. Setting the

configuration registration to 0x2 causes the router to boot the Cisco

IOS XR software and enter EXEC

mode during a router reload.

RP/0/RP0/CPU0:router(admin)# config-register 0x2

Successfully set config-register to 0x2 on node 0/RP0/CPU0 Successfully set config-register to 0x2 on node 0/RP1/CPU0

Related Commands

Command Description

reload Performs a reload of the route processor.

show variables boot Displays the configuration register setting and boot file setting for the

RPs in the system.

show version Displays information about the Cisco IOS XR software.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-13

mirror

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

To configure disk mirroring on a node, use the mirror command in global configuration mode. To disable disk mirroring, use the no form of this command.

mirror location [preconfigure] node-id primary-device:secondary-device:

no mirror location node-id

Syntax Description

Defaults No default behavior or values

Command Modes Global configuration

Command History

primary-device: Specifies the primary boot device used to store installation packages

secondary-device: Storage device on the same RP as the primary-device, to where critical

preconfigure Enables you to specify a node that is not yet installed.

node-id Node in a multishelf system. It can be a node that is not yet installed

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

and configuration files. Supported devices are disk0: and disk1: (if installed).

data is replicated.

• Supported devices are the same as for primary-device:, but

secondary-device: must be different than the primary-device:.

if the keyword preconfigure is used.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

The mirror command replicates all critical data contained in the primary partition of the primary boot device, onto a second storage device on the same RP. Therefore, if the primary boot device fails, applications continue to be serviced transparently by the secondary device, without having to switch control to a standby RP.

Before the mirror command can be used, the secondary storage device must be partitioned using the format command. If the primary boot device is not partitioned, once mirroring is enabled and all data on the primary boot device is replicated to the secondary device, the primary boot device is partitioned automatically. This guarantees that only critical data on the primary boot device is mirrored to the secondary device. Noncritical data, such as logging data, should not be mirrored and should, therefore, be saved to the secondary partition on the storage device.

To temporarily suspend disk mirroring without changing the configuration, use the mirror pause command in EXEC mode.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-14

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

mirror

Tas k ID

Task ID Operations

root-lr read, write

Examples The following example shows how to configure disk mirroring from the primary boot device (disk0:) to

the secondary storage device (disk1:):

RP/0/RP0/CPU0:router(config)# mirror location 0/rp0/cpu0 disk0: disk1:

Related Commands

Command Description

format Formats a file system.

mirror pause Temporarily pauses disk mirroring on a node.

mirror resume Resumes disk mirroring on a node after it has been temporarily

stopped.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-15

mirror pause

To temporarily pause disk mirroring on a node, use the mirror pause command in EXEC or administration EXEC mode.

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

mirror pause [location {node-id | all}]

Syntax Description

Defaults If no node is specified, disk mirroring is paused on the active RP.

Command Modes EXEC

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

location {node-id | all} Specifies the RP node in a multishelf system. The all keyword

specifies all RP nodes.

Administration EXEC

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

The mirror pause command temporarily pauses the mirroring of the primary boot device. This command is primarily useful during an installation operation to prevent significant performance degradation on single CPU boards. The mirror pause command does not change the configured state of mirroring, but rather causes the mirroring to be suspended until the mirror resume command is used.

The mirror pause command has no affect if the mirror configuration command is not enabled.

Tas k ID

Examples The following example shows how to pause disk mirroring on the active RP:

Related Commands

Cisco ASR 14000 Series Router System Management Command Reference

SMR-16

Task ID Operations

root-lr read, write

RP/0/RP0/CPU0:router# mirror pause

Command Description

mirror Configures disk mirroring on a node.

mirror resume Resumes disk mirroring on a node after it has been temporarily stopped.

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

mirror resume

To resume disk mirroring on a node after it has been temporarily stopped, use the mirror resume command in EXEC or administration EXEC mode.

mirror resume [location {node-id | all}]

mirror resume

Syntax Description

Defaults If no node is specified, disk mirroring is enabled on the active RP.

Command Modes EXEC

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

location {node-id | all} Specifies the RP node in a multishelf system. The all keyword

specifies all RP nodes.

Administration EXEC

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

The mirror resume command resumes the mirroring of the primary boot device after it has been temporarily paused with the mirror pause command.

The mirror resume command has no affect if the mirror configuration command is not enabled and the mirror pause command has not been used.

Tas k ID

Examples The following example shows how to resume disk mirroring on the active RP:

Related Commands

OL-17231-01

Task ID Operations

root-lr read, write

RP/0/RP0/CPU0:router# mirror resume

Command Description

mirror Configures disk mirroring on a node.

mirror pause Temporarily pauses disk mirroring on a node.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-17

mirror verify

To verify disk synchronization for disk mirroring on a node, use the mirror verify command in EXEC or administration EXEC mode.

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

mirror verify [location node-id]

Syntax Description

location node-id Specifies the RP node in a multishelf system.

Defaults If no node is specified, the verification is done on the active RP.

Command Modes EXEC

Administration EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

The mirror verify command verifies the synchronization consistency between the primary and secondary media devices being used in mirroring. The command verifies that the full contents are identical between the mirrored devices and reports any inconsistencies found.

Tas k ID

Task ID Operations

root-lr read, write

Examples The following example shows how to verify the disk mirroring on the active RP:

RP/0/RP0/CPU0:router# mirror verify

Mirror Verify Information for 0/0/CPU0. ======================================================== Primary device and secondary device are fully synchronized.

Related Commands

Command Description

mirror Configures disk mirroring on a node.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-18

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

reload

To reload the designated secure domain router system controller (DSDRSC), use the reload command in EXEC mode.

reload

Syntax Description This command has no arguments or keywords.

Defaults No default behavior or values

Command Modes EXEC

reload

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Caution If a standby RP is not installed or is not in the ready state, then the router experiences a loss of service

Releases Modifications

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

Use the reload command to cause the DSDRSC to reload the Cisco IOS XR software according to the configuration register setting (for example, 0x0 to enter ROMMON mode and 0x2 to reload the RP to EXEC mode). If a standby DSDRSC is in the ready redundancy state, the reload command also causes the router to fail over to the standby DSDRSC. Use the show redundancy command in EXEC mode to display the status of the standby RP.

When the reload command is used and a failover occurs, the running (active) software configuration is automatically maintained during failover.

while the active RP is reloading the Cisco the show redundancy command in EXEC mode.

If you use the reload command and there is no available standby node, you are prompted to continue with the reload:

RP/0/RP0/CPU0:router# reload Standby card not present or not Ready for failover. Proceed?[confirm]

IOS XR software. To view the status of the standby RP, issue

Tas k ID

OL-17231-01

Task ID Operations

root-lr execute

Cisco ASR 14000 Series Router System Management Command Reference

SMR-19

Boot Commands on Cisco IOS XR Software

reload

Cisco Confidential - Beta Review R3.7.1

Examples The following example shows how to reload the active RP. If a standby RP is in the ready state, then the

router fails over to the standby RP. If the standby RP is not installed or is not in the ready state, then the router enters ROMMON mode and routing operations stop.

RP/0/RP0/CPU0:router# reload

Updating Commit Database. Please wait...[OK] Proceed with reload? [confirm] y PCI0 device[7]: Vendor ID 0x10ee

PCI0 device[7]: Device ID 0x300e

PCI1 device[7]: Device ID 0x1100 PCI1 device[7]: Vendor ID 0x1013 PCI1 device[8]: Device ID 0x649 PCI1 device[8]: Vendor ID 0x1095 PCI1 device[9]: Device ID 0x5618 PCI1 device[9]: Vendor ID 0x14e4 PCI1 device[10]: Device ID 0x5618 PCI1 device[10]: Vendor ID 0x14e4 System Bootstrap, Version 1.15(20040120:002852) , Copyright (c) 1994-2004 by cisco Systems, Inc. Board type is 0x100000 (1048576) Enabling watchdog

Broadcom 5618 #0 Found on PCI Broadcom 5618 #1 Found on PCI No. of BCM 56xx switches found 2 . BCM Switch #0 initialisation complete. BCM Switch #1 initialisation complete G4(7450-SMP-GT64260_A) platform with 2048 Mb of main memory

rommon B1 >

Related Commands Command Description

config-register Defines the configuration register setting in administration EXEC mode.

reload (administration

Performs a reload of a single node or all nodes in the system.

EXEC)

show redundancy Displays the redundancy status of the RPs.

SMR-20

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

reload (administration EXEC)

To reload a node or all nodes on the router, use the reload command in administration EXEC mode.

reload [location {node-id | all} | rack rack-number]

reload (administration EXEC)

Syntax Description

location Specifies which node to reload.

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

all Reloads all the nodes in the system.

rack Reloads all the nodes on a specified chassis.

rack-number Rack number of the line card chassis or fabric chassis.

Defaults No default behavior or values

Command Modes Administration EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Note Before reloading nodes on a Cisco ASR 14000 Series Router router, we recommend using the cfs check

command to check the sanity of the configuration file system and attempt to recover from internal inconsistencies.

• To reload a specific node on the router, specify the reload command with the location node-id

keyword and argument. The node-id is expressed as rack/slot/module.

• To ensure a graceful reload and ensure the sanity of the configuration file system, enter the cfs check

command on each SDR that has nodes impacted by the reload.

Tas k ID

Task ID Operations

root-system execute

Examples The following example shows how to reload all the nodes on the router:

RP/0/RP0/CPU0:router(admin)# reload location all

Graceful reload of all nodes not supported Assuming 'force'

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

SMR-21

reload (administration EXEC)

Cisco Confidential - Beta Review R3.7.1

Operation may result in file corruptions or loss of config. Proceed [Y/N]? Y

Note To ensure the sanity of the configuration file system, enter the cfs check command on the router.

Related Commands Command Description

cfs check Verifies the Configuration File System (CFS).

config-register Defines the configuration register setting in administration EXEC mode.

reload Performs a reload of the route processor.

show redundancy Displays the redundancy status of the RPs.

Boot Commands on Cisco IOS XR Software

SMR-22

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

show epm trace boot

To display execution path monitoring traces, use the show epm trace boot command in administration EXEC mode.

show epm trace boot [hexdump] [last n] [reverse] [stats] [tailf] [unique] [verbose] [wrapping]

[file filename original] [location node-id]

show epm trace boot

Syntax Description

Defaults No default behavior or values

Command Modes Administration EXEC

hexdump Displays traces in hexidecimal format.

last n Displays the last n number of traces only.

reverse Displays the most recent traces first.

stats Displays execution path statistics.

tailf Displays new traces as they are added.

unique Displays unique entries only, along with the count of the number of

verbose Displays additional internal debugging information.

wrapping Displays wrapping entries.

file filename original Specifies the filename of the file to display.

location node-id Specifies the RP node for which to display the execution path

all Displays mirroring information for all RP nodes in the router.

times this entry appears.

monitoring information. The node-id argument is expressed in rack/slot/module notation.

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Tas k ID

OL-17231-01

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

The show epm trace boot command provides a simple way of tracking and time-stamping critical events to clearly understand their temporal relationship to one another and the amount of time spent performing critical operations.

Task ID Operations

basic services read

Cisco ASR 14000 Series Router System Management Command Reference

SMR-23

Boot Commands on Cisco IOS XR Software

show epm trace boot

Cisco Confidential - Beta Review R3.7.1

Examples The following is sample output from the show epm trace boot command:

RP/0/RP0/CPU0:router(admin)# show epm trace boot

8 wrapping entries (1024 possible, 0 filtered, 8 total) Jul 12 21:17:36.229 epm/boot 0/RP0/CPU0 t1 @ 00:00:14 - [init] start Jul 12 21:17:54.746 epm/boot 0/RP0/CPU0 t1 @ 00:00:32 - [sysmgr] start Jul 12 21:17:55.315 epm/boot 0/RP0/CPU0 t7 @ 00:00:33 - [sysmgr] start-level: start Jul 12 21:17:59.899 epm/boot 0/RP0/CPU0 t9 @ 00:00:37 - [sysmgr] start-level: admin Jul 12 21:20:13.564 epm/boot 0/RP0/CPU0 t15 @ 00:02:51 - [sysmgr] start-level: infra Jul 12 21:21:47.562 epm/boot 0/RP0/CPU0 t11 @ 00:04:25 - [sysmgr] start-level: active Jul 12 21:22:09.132 epm/boot 0/RP0/CPU0 t6 @ 00:04:47 - [sysmgr] start-level: final Jul 12 21:22:17.475 epm/boot 0/RP0/CPU0 t9 @ 00:04:55 - [sysmgr] lr-plane-up

In this sample output, the time stamp following the @ sign is the elapsed time in the format hh:mm:ss since the execution phase started (for example, since node start, in the case of a boot).

SMR-24

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

show mirror

To display disk mirroring information, use the show mirror command in EXEC or administration EXEC mode.

show mirror [location {all | node-id}]

show mirror

Syntax Description

location node-id Specifies RP node for which to display the mirroring information.

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

all Displays mirroring information for all RP nodes in the router.

Defaults No default behavior or values

Command Modes EXEC

Administration EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Tas k ID

Task ID Operations

filesystem read

Examples The following is sample output from the show mirror command:

RP/0/RP0/CPU0:router# show mirror

Mirror Information for 0/0/CPU0. ======================================================== Mirroring Enabled Configured Primary: disk0: Configured Secondary: disk1:

Current Mirroring State: Syncing Files Current Physical Primary: disk1: Current Physical Secondary: disk0:

Mirroring Logical Device: disk0:

Physical Device State Flags

------------------------------------------------------- disk0: Available Enabled Formatted

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

SMR-25

show mirror

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

disk1: Available Enabled Formatted compactflash: Not Present disk0a: Available Formatted disk1a: Available Formatted compactflasha: Not Present

Mirroring Rommon Variable BOOT_DEV_SEQ_CONF = disk0:;disk1: BOOT_DEV_SEQ_OPER = disk1: MIRROR_ENABLE = Y

Syncing Files Number Left: 5735 Current file: asr14k-base-3.6.0.10I/schema/l2protocols_srp_action.schema Current state: File is Syncing

Table 6 describes the significant fields shown in the display.

Ta b l e 6 show mirror Field Descriptions

Field Description

Mirroring Enabled Indicates whether mirroring is enabled or disabled.

Configured Primary If mirroring is enabled, the configured primary disk for

mirroring.

Configured Secondary If mirroring is enabled, the configured secondary disk for

mirroring.

Current Mirroring State Current status of mirroring. Possible values are as follows:

Syncing files—Files are being synchronized between the primary and secondary disks.

Not Configured—Mirroring is not configured.

Mirroring Paused—In this state no mirroring is being done to the secondary device and the disk redundancy has been removed. The values of the BOOT_DEV_SEQ_OPER and MIRROR_ENABLE variables reflect this.

Redundant—The primary and secondary disks are totally in synchronization. Any read or write failure on the primary device results in disk redundancy failover such that all operations are performed on the secondary device.

Current Physical Primary Current primary disk.

Current Physical Secondary Current secondary disk.

Mirroring Logical Device Device name used by the mirroring process to intercept all

application requests to that named device before passing them through to one of the mirrored physical devices.

Physical Device Physical disk in router.

State Status of the disk. Possible values are as follows:

Available—Disk exists in router and is available.

Not present—Disk does not exist in router. “a” partitions of disks are only available after the disk has been formatted with the partition keyword.

SMR-26

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Table 6 show mirror Field Descriptions (continued)

Field Description

Flags Enabled—Disk mirroring has been enabled on this device

BOOT_DEV_SEQ_CONF= ROM Monitor environmental variable for the boot disk

BOOT_DEV_SEQ_OPER= ROM Monitor environmental variable that reflects the state

MIRROR_ENABLE ROM Monitor environmental variable whose value reflects

show mirror

and the device is part of the mirroring process.

Repaired—During the boot, some minor inconsistencies were discovered on the disk and were repaired to make the file system consistent.

Formatted—Disk was formatted before mirroring was enabled.

sequence. This variable is is set when mirroring is enabled through the mirror configuration command. The devices in this ROMMON variable declare the primary and the secondary devices of the mirroring process. The first device is the primary device and the second device is the secondary device in the mirroring process.

Note This variable is also shared by the disk backup

feature. This variable can also be set or unset using the system boot-sequence command of the disk backup feature. But the use of system boot-sequence and system backup commands is blocked, if mirroring is enabled.

of the disk redundancy status. When mirroring is enabled and the state is redundant, this variable is set to the primary device followed by the secondary device. When mirroring is not in the redundancy state, then this variable is updated to contain only the primary device.

the mirroring status. If it is set to Y, then mirroring is enabled. If it is set to P, then mirroring is paused. If empty, mirroring is not enabled.

Related Commands

OL-17231-01

Command Description

mirror Configures disk mirroring on a node.

mirror verify Verifies disk synchronization for disk mirroring on a node.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-27

show reboot

Cisco Confidential - Beta Review R3.7.1

show reboot

To display reboot information for a node, use the show reboot command in EXEC or administration EXEC mode.

Boot Commands on Cisco IOS XR Software

show reboot {[first | last] {crashinfo | syslog | trace} | graceful | history [ reverse] | pcds} location

node-id

Syntax Description

Defaults No default behavior or values

Command Modes EXEC

first Displays information about the first ungraceful reboot.

last Displays information about the last ungraceful reboot.

crashinfo Displays crash information for an ungraceful reboot.

syslog Displays the syslogs related to an ungraceful reboot.

trace Displays trace information for an ungraceful reboot.

graceful Displays information about the last graceful reboot.

history Displays the reboot history of a specific node.

reverse Displays the reboot history information in reverse chronological

pcds Displays PCDS critical information about the last ungraceful

location node-id Specifies which node to reload. The node-id argument is expressed

Administration EXEC

order.

reboot.

in rack/slot/module notation.

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Tas k ID

Cisco ASR 14000 Series Router System Management Command Reference

SMR-28

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

The history keyword for the show reboot command displays all reboot causes stored for previous node resets.

Crash information (crashinfo), syslog, and kernel dumper ltrace (trace) can be displayed for the first or last reboot if it is an ungraceful reboot.

Task ID Operations

system read

OL-17231-01

Boot Commands on Cisco IOS XR Software

show reboot

Cisco Confidential - Beta Review R3.7.1

Examples The following is sample output from the show reboot command with the history keyword:

RP/0/RP0/CPU0:router# show reboot history location 0/rp0/cpu0

No Time Cause Code Reason

-------------------------------------------------------------------------------01 Thu Jul 19 00:25:03 2007 0x00000001 Cause: User Initiated reload Process: reload Traceback: fc1941a0 fc194290 fc0 42d90 48200624 48202120 0 02 Thu Jul 19 20:32:57 2007 0x21000010 Cause: Missed deadline, client: sc-reddrv-main, timeout: 5 Process: wd-critical-mon Traceback: fc1941a0 fc194290 482 00738 482013cc 48201c04 fc1d4fb0 03 Thu Jul 19 22:21:05 2007 0x00000000 04 Thu Jul 19 22:44:37 2007 0x00000045 Cause: Non-dSC node booted with composite image Process: insthelper Traceback: fc1941a0 fc194290 fc6 1e4a0 4820f928 48210654 48201cc0 05 Thu Jul 19 22:52:19 2007 0x00000045 Cause: Non-dSC node booted with composite image Process: insthelper Traceback: fc1941a0 fc194290 fc6 204a0 4820f928 48210654 48201cc0 06 Fri Jul 20 02:10:51 2007 0x00000001 Cause: User Initiated reload Process: reload Traceback: fc15a1a0 fc15a290 fc0 45d90 48200624 48202120 0 07 Mon Jul 23 19:39:49 2007 0x00000045 Cause: RP cold booted with incorrect software Process: insthelper Traceback: fc1941a0 fc194290 fc6 1a4a0 4820f8b0 48210fc8 48201cc0 08 Mon Jul 23 19:54:45 2007 0x00000002 Cause: User Initiated Reboot Process: reboot Traceback: fc1941a0 fc194290 482 00154 48201468 0 0

The following is sample output from the show reboot command with the first crashinfo keywords:

RP/0/RP0/CPU0:router# show reboot first crashinfo location 0/rp0/cpu0

Crashinfo Timestamp: Thu Jul 19 20:32:57 2007

20070719 20:32:57

Crash Reason: Cause code 0x21000010 Cause: Missed deadline, client: sc-reddrv-main, timoeut: 5 Process: wd-critical-mon Traceback: fc1941a0 fc194290 48200738 482013cc 48201c04 fc1d4fb0 Timezone UTC0

Exception at 0xfc1944c8 signal 5 c=1 f=3

Active process(s): pkg/bin/wd-critical-mon Thread ID 1 on cpu 0 pkg/bin/l3test Thread ID 0 on cpu 1

REGISTER INFO r0 r1 r2 r3 R0 01000000 4817e8c0 4820e208 000000de r4 r5 r6 r7 R4 fc1b4856 7fffffff 4817e738 fc1b4856 r8 r9 r10 r11 R8 00000000 602cf522 00000000 00000000 r12 r13 r14 r15 R12 602cf51c 4820e1a0 00000000 00000000

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-29

show reboot

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

r16 r17 r18 r19 R16 00000000 00000000 00000000 00000000 r20 r21 r22 r23 R20 00000000 00000000 48200000 48200000 r24 r25 r26 r27 R24 48200000 48200000 48200000 48200000 r28 r29 r30 r31 R28 00000028 00000001 21000010 6029b000 cnt lr msr pc R32 00000000 fc194290 0002d932 fc1944c8 cnd xer R36 44000094 20000006

SUPERVISOR REGISTERS

Memory Management Registers

Instruction BAT Registers Index # Value IBAT0U # 0x1ffe IBAT0L # 0x12 IBAT1U # 0 IBAT1L # 0 IBAT2U # 0x30000ffe IBAT2L # 0xf0000032 IBAT3U # 0xfffc0003 IBAT3L # 0x40011

Data BAT Registers Index # Value DBAT0U # 0x1ffe DBAT0L # 0x12 DBAT1U # 0 DBAT1L # 0x10000012 DBAT2U # 0x30000ffe DBAT2L # 0xf000006a DBAT3U # 0xfffc0003 DBAT3L # 0x40011

Segment Registers Index # SR-Value 0 # 0 1 # 0 2 # 0 3 # 0 4 # 0 5 # 0 6 # 0 7 # 0 8 # 0 9 # 0 10 # 0 11 # 0 12 # 0 13 # 0 14 # 0 15 # 0

SMR-30

Exception Handling Registers Data Addr Reg # DSISR 0x602cf440 # 0x42000000 SPRG0 # SPRG1 # SPRG2 # SPRG3 0x1 # 0x21000010 # 0x6029b000 # 0 SaveNRestore SRR0 # SaveNRestore SRR1

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

0xfc1944c4 # 0x2d932

Miscellaneous Registers Processor Id Reg # 0 HID0 # 0x8410c0bc HID1 # 0x9001ac80

MSSCR0 # 0x88000 MSSSR0 # 0

STACK TRACE #0 0xfc194290 #1 0x48200738 #2 0x482013cc #3 0x48201c04 #4 0xfc1d4fb0

Related Commands Command Description

reload Performs a reload of the route processor.

show reboot

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-31

show system backup

Cisco Confidential - Beta Review R3.7.1

show system backup

To display the system backup details and history, use the show system backup command in EXEC or administration EXEC mode.

show system backup [target-device] [details | diff] [verify] [location {all | node-id}]

Boot Commands on Cisco IOS XR Software

Syntax Description

Defaults Enter the show system backup command without keywords or arguments to display the date, time and

Command Modes EXEC

target-device (Optional) Displays the backup details and history for the specified device.

Supported devices are disk0: and disk1: (if installed).

details (Optional) Lists the software packages and configurations stored on the

specified backup device.

diff (Optional) Displays the differences between the software packages and

configuration files on the backup device, with the packages and configuration files on the current boot device.

verify (Optional) Verifies the software packages and configuration files stored on

the specified backup device.

location node-id (Optional) Displays information for a designated RP node.

location all (Optional) Displays information for all RP nodes.

status of the last backup for the current designated secure domain router system controller (DSDRSC). This command also displays the configured primary and secondary boot devices.

Administration EXEC

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Cisco ASR 14000 Series Router System Management Command Reference

SMR-32

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

Use the show system backup command to display details of the current system backup on a local storage device.

• Use the show system backup command to display information about the backup performed for the

active RP to which you are logged in, including the date, time, and status of the last backup.

• Use the target-device argument command to display backup information for a specified device on a

RP node.

• Use the details keyword to list information about the software packages and configuration files

stored on the backup device.

• Use the diff keyword to display the differences between the software and configurations on the

backup device and the software and configurations on the currently active boot disk.

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

• Use the location node-id keyword and argument to display information for a backup on a specific

node. Use the location all keywords to display information for backups on all nodes in the system.

show system backup

Tas k ID

Task ID Operations

root-lr execute

Examples In the following example, the show system backup command displays the status of the last system

backup:

RP/0/RP0/CPU0:router# admin RP/0/RP0/CPU0:router(admin)# show system backup

System Backup information for node0_0_CPU0 on disk1: ======================================================= Last Backup Successful Backup started at Sat Jun 24 12:22:10 2006 ended at Sat Jun 24 12:42:11 2006 Verify started at Sat Jun 24 12:42:12 2006 ended at Sat Jun 24 12:48:47 2006 BOOT_DEV_SEQ_CONF=disk0:;disk1: BOOT_DEV_SEQ_OPER=disk0:;disk1:

In the following example, the show system backup command is entered with the details keyword to display additional information about the configuration and software package files stored on the backup device. Because this command is entered in administration EXEC mode, the backup information for both the administration and SDR configurations is displayed.

RP/0/RP0/CPU0:router(admin)# show system backup details

SDR configuration last commit record on disk1: Device Commitid Time Stamp disk1: 1000000030 11:56:43 UTC Thu Jun 22 2006

Active software packages on disk1: asr14k-os-mbi-3.4.0 asr14k-base-3.4.0 asr14k-admin-3.4.0 asr14k-fwdg-3.4.0 asr14k-lc-3.4.0 asr14k-rout-3.4.0 asr14k-diags-3.4.0 asr14k-k9sec-3.4.0 asr14k-mcast-3.4.0 asr14k-mgbl-3.4.0 asr14k-sbc-3.4.0

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-33

show system backup

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

asr14k-mpls-3.4.0 No Inactive software packages on disk1:

Table 7 describes the significant fields shown in the display.

Ta b l e 7 show system backup Field Descriptions

Field Description

BOOT_DEV_SEQ_CONF= ROM Monitor environmental variable for the boot disk

sequence. This variable is defined by the

boot-sequence command. The first disk is the primary

device; the second disk is the backup (secondary) device. The value listed in the secondary device is also used as the default backup target device for the

system backup command.

BOOT_DEV_SEQ_OPER= ROM Monitor environmental variable for the boot disks

currently in use by the system.

system

Related Commands

Command Description

system boot-sequence Defines the order of boot devices used to bring up a router. The secondary

device argument also defines the default backup target device used by the

system backup command.

system backup Performs a backup of software and configuration files.

SMR-34

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

show variables boot

To display the configuration register setting and boot file setting for the route processors (RPs) in the system, use the show

show variables boot [location {all | node-id}]

show variables boot

variables boot command in administration EXEC mode.

Syntax Description

location node-id Specifies the node to reload. The node-id argument is expressed in

rack/slot/module notation.

all Reloads all the nodes in the system.

Defaults No default behavior or values

Command Modes Administration EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Use the show variables boot command to display system boot variables for the router. This command displays the configuration register setting and boot file setting for the RPs in the system. Use the location node-id keyword and argument to display the configuration register setting for a specific card.

The configuration register setting is set with the command config-register. The boot variable is set in ROM Monitor mode.

Tas k ID

Task ID Operations

root-lr read

Examples The following is sample output from the show variables boot command:

RP/0/RP0/CPU0:router# show variables boot

Node 0/RP0/CPU0: BOOT variable = disk0:asr14k-os-mbi-3.3.30/mbiasr14k-rp.vm,1; CONFREG variable = 0x2

Node 0/RP1/CPU0: BOOT variable = disk0:asr14k-os-mbi-3.3.30/mbiasr14k-rp.vm,1; CONFREG variable = 0x2

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

SMR-35

show variables boot

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

config-register Defines the configuration register setting in administration EXEC

mode.

show variables system Displays internal system environmental variables set on the router.

show version Displays information about the Cisco IOS XR software.

Boot Commands on Cisco IOS XR Software

SMR-36

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

show variables system

To display internal system environmental variables set on the router, use the show variables system command in EXEC mode.

show variables system

Syntax Description This command has no arguments or keywords.

Defaults No defaults behavior or values

Command Modes EXEC

show variables system

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Use the show variables system command to display system environmental variables for the router.

Tas k ID

Task ID Operations

basic-services read

Examples The following is sample output from the show variables system command. The output is meant to be

interpreted by Cisco personnel.

RP/0/RP0/CPU0:router# show variables system

TERM=vt220 GDB_PDEBUG=-P1 TERM=vt100 DIR_PREFIX=. LOADPATH=/pkg LD_LIBRARY_PATH=/pkg/lib PATH=/pkg/bin BFM_CONFIG_PATH=/pkg/bfm/config BGP_PATH=/pkg/bgp CONFIGS_PATH=/pkg/configs CRAFT_PATH=/pkg/cwi CTF_PATH=/pkg/ctf DM_RULES_PATH=/pkg/dm/rules ETC_PATH=/pkg/etc FPD_PATH=/pkg/fpd IM_RULES_PATH=/pkg/rules

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-37

show variables system

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

INIT_STARTUP_PATH=/pkg/init.d INSTHELPER_PATH=/pkg/other MAN_PATH=/pkg/man MIB_LIBRARY_PATH=/pkg/lib/mib MIB_PATH=/pkg/mib NETIO_SCRIPT_PATH=/pkg/script PARSER_PATH=/pkg/parser PARTITIONS_PATH=/pkg/partitions QOS_PATH=/pkg/qos SCHEMA_PATH=/pkg/schema STARTUP_PATH=/pkg/startup TCL_LIBRARY=/pkg/lib/tcl UCODE_PATH=/pkg/gsr/ucode UCODE_ROOT_PATH=/pkg/ucode VCM_RULES_PATH=/pkg/vcmrules JOB_ID=0 INSTANCE_ID=1 SYSMGR_TUPLE= SYSMGR_NODE=node0_RP0_CPU0 EXIT_STATUS=0 SYSMGR_RESTART_REASON=0 AAA_USER=egran EXEC_PID=18280619 TASKID_MAP_SIZE=72 HOME=/disk0:/usr TMPDIR=/disk0:/var/tmp PWD=/disk0:/usr

Related Commands Command Description

config-register Defines the configuration register setting in administration EXEC

mode.

show variables boot Displays the configuration register setting and boot file setting for

the RPs in the system.

show version Displays information about the Cisco IOS XR software.

SMR-38

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

system backup

To back up the system software and configurations to a backup disk, use the system backup command in EXEC or administration EXEC mode.

system backup [target-device] [format] [synchronous | asynchronous] [location {all | node-id}]

system backup

Syntax Description

target-device (Optional) Specifies the storage device used for the system backup. If a

target device is not specified, then the secondary device defined with the

system boot-sequence command is used. If a target device is not specified

with either command, then the system backup command returns an error.

• The target device cannot be the current boot device.

• The target device must be large enough to store the current software set

and configuration.

• The supported storage devices are disk0: and disk1: (if installed).

format (Optional) Formats a target disk that already contains a system backup.

By default, the system backup command formats the target disk if that target disk does not contain a previous system backup. If the target disk already contains a backup, then the disk is not formatted again. The format keyword forces a format of the target device even if it contains a previous system backup.

location node-id (Optional) Specifies an alternative node location for the backup target disk,

such as the standby DSDRSC.

By default, the backup files are copied to the target device in the current DSDRSC. Use the location node-id keyword and argument to specify an alternative node for the backup files, such as the standby DSDRSC.

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

location all (Optional) Backs up the software and configuration files to all RPs in the

router. Each RP must contain a disk in the specified target device location, such as disk1.

asynchronous (Optional) Performs the command in asynchronous mode. In asynchronous

mode, the command runs in the background, and the EXEC prompt is returned as soon as possible.

synchronous (Optional) Performs the command in synchronous mode. This mode allows

the installation process to finish before the prompt is returned. This is the default mode.

Defaults The operation is performed in synchronous mode.

The backup files are copied to the secondary device defined with the system boot-sequence command. The backup files are copied to the target device on the current secure domain router system controller (DSDRSC).

Command Modes EXEC

Administration EXEC

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

SMR-39

system backup

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Target Device for the Backup

Use the system backup command with the target-device argument to specify the local storage device for backup software and configuration files. The target-device argument is optional and applies only to the current backup operation.

• If a target storage device is not specified, then the files are backed up to the secondary storage device

defined with the

• If a target device is not specified with either the system backup command or the system

system boot-sequence command.

boot-sequence command, then the backup operation is not allowed.

The target-device can be any local storage device except the current boot device, and must be large enough to store the current software set and configuration. The supported storage devices are disk0: and disk1: (if installed).

Location Node of the Target Device

By default, the backup is created on the specified target device of the active DSDRSC where the command is executed.

• To specify an alternate node for the system backup, such as the standby DSDRSC, use the system

backup command with the location node-id keyword and argument.

• To perform the backup on all router processors (RPs) installed in a router, use the system backup

command with the location all keywords in EXEC mode.

Note Each RP impacted by the system backup command must contain the specified target device. For

example, if the system backup command is executed for disk1 on all RPs in the system, then a flash disk must be installed in disk1 of each RP.

Command Modes

• Use the system backup command in administration EXEC mode to back up the administration plane

configuration, including software and configurations for all SDRs in the system.

• Use the system backup command in the EXEC mode of an SDR to back up the software and

configurations for a specific SDR.

Commit and Installation Operations Not Allowed During Backup

• Configuration changes are not allowed during the backup process. Any attempts to commit

configuration changes are rejected until the backup operation is complete.

• The backup process cannot be performed during an installation operation. If an installation

operation is performed while a backup is in process, the backup operation terminates.

Displaying the Current Backup Information

Enter the show system backup command to display information about the current backup files. If no backup exists, an error message is displayed.

SMR-40

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

system backup

Tas k ID

Task ID Operations

root-lr read, write

Examples The following example shows how to back up the software and configuration files.

• The command is run in administration EXEC mode, which backs up both the administration and

SDR configurations.

• The target device is defined as disk1.

• Because this is the first backup on the device, the disk is formatted.

RP/0/RP0/CPU0:router# admin RP/0/RP0/CPU0:router(admin)# system backup disk1:

Info: node0_0_CPU0: formatting target device Info: node0_0_CPU0: copying admin configuration Info: node0_0_CPU0: copying SDR configuration Info: node0_0_CPU0: copying installed software Info: node0_0_CPU0: backup complete. Info: node0_0_CPU0: verifying admin configuration Info: node0_0_CPU0: verifying installed software Info: node0_0_CPU0: verify complete. Info: node0_0_CPU0: command succeeded.

Related Commands

Command Description

show system backup Displays the system backup settings and history.

system boot-sequence Defines the order of boot devices used to bring up a router. The secondary

device argument also defines the default backup target device used by the

system backup command.

system backup Performs a backup of software and configuration files.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-41

system boot-sequence

Cisco Confidential - Beta Review R3.7.1

system boot-sequence

To define the order of local storage devices used to boot a router, use the system boot-sequence command in EXEC or administration EXEC mode.

system boot-sequence {primary-device [secondary-device] | disable} [location {all | node-id}]

Boot Commands on Cisco IOS XR Software

Syntax Description

Defaults The primary device is disk0:. The (optional) secondary boot device is not defined.

Command Modes EXEC

primary-device Default device where software packages are installed and run. This device is

also the default location for router configurations. The value of the

primary-device argument is normally disk0:.

secondary-device Secondary (backup) boot device, used by the system backup command to

back up system software and configurations.

• The supported storage devices are disk0: and disk1: (if installed).

Note The value of the secondary-device argument must be different from

the value of the primary-device argument.

disable Temporarily disables the automatic recovery mechanism.

location node-id Defines the boot sequence on any RP in the router. The node-id argument is

expressed in rack/slot/module notation.

location all Defines the boot sequence on all RPs in the router.

Administration EXEC

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Cisco ASR 14000 Series Router System Management Command Reference

SMR-42

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

Use the system boot-sequence command to define the local storage devices used to boot a router. You can define two devices with this command:

• The value of the primary-device argument defines the default device where software packages are

installed and run. This device is also the default location for router configurations.

• The value of the secondary-device argument defines the device used by the system backup

command To back up system software and configurations. This field is optional.

• The secondary device can also be temporarily defined when the system backup command is

executed with the target-device argument. Use the system boot-sequence command with the secondary-device argument to permanently define the secondary (backup) device.

OL-17231-01

Boot Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Note The primary and secondary device definitions remain in effect until the system boot-sequence command

is entered again.

General Usage Guidelines

• The value of the secondary-device argument must be different from the value of the primary-device

argument.

• We recommend disk0 as the primary boot device in the boot sequence, and disk1 as the secondary

boot device.

• The boot device specified with the system boot-sequence command must be installed in the card,

or the command is rejected.

Command Modes

??is there a difference

• Use the system boot-sequence command in administration EXEC mode to define the boot sequence

for all secure domain routers (SDRs) in the system.

• Use the system boot-sequence command in EXEC mode to define the boot sequence for a specific

SDR.

system boot-sequence

Location Node

• Use the location node-id keyword and argument to define the boot sequence for a specific route

processor (RP).

• Use the location all keywords to define the boot sequence for all RPs in the router.

Disabling Automatic Recovery

Use the system boot-sequence command with the disable keyword to disable the automatic recovery.

Displaying the Current Boot Sequence Settings

Enter the show system backup command to display the currently configured boot sequence devices.

Tas k ID

Task ID Operations

root-lr read, write

Examples The following example shows how to define the primary and secondary boot device for the

active

RP (DSC). In this example, the default location for software and configurations is disk0. The

location for backups of software and configurations is disk1.

RP/0/RP0/CPU0:router# admin RP/0/RP0/CPU0:router(admin)# system boot-sequence disk0: disk1:

OL-17231-01

Info: node0_0_CPU0: command succeeded.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-43

system boot-sequence

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

system backup Performs a backup of software and configuration files.

show system backup Displays the system backup settings and history.

Boot Commands on Cisco IOS XR Software

SMR-44

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Cisco Confidential - Beta Review R3.7.1

CDP Commands on Cisco IOS XR Software

This chapter describes the Cisco IOS XR software commands for monitoring the networking device and network using Cisco Discovery Protocol (CDP).

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-47

cdp

Cisco Confidential - Beta Review R3.7.1

cdp

To enable the Cisco Discovery Protocol (CDP) globally or on a interface, use the cdp command in the appropriate configuration mode. To disable CDP globally or on an interface, use the no form of this command.

cdp

no cdp

Syntax Description This command has no arguments or keywords.

Defaults CDP is disabled.

Command Modes Global configuration

Interface configuration

CDP Commands on Cisco IOS XR Software

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

By default, CDP is disabled globally. To enable CDP, CDP must be enabled globally and then enabled for each interface.

To enable CDP globally, use the cdp command in global configuration mode. To disable CDP globally, use the no form of this command in global configuration mode.

To enable CDP on a specific interface, use the cdp command in interface configuration mode. To disable CDP on a specific interface, use the no form of this command in interface configuration mode.

Tas k ID

Task ID Operations

cdp read, write

Examples The following example shows how to globally enable CDP:

RP/0/RP0/CPU0:router(config)# cdp

SMR-48

The following example shows how to enable CDP on Packet-over-SONET/SDH (POS) interface 0/0/0/1:

RP/0/RP0/CPU0:router(config)# interface POS 0/0/0/1 RP/0/RP0/CPU0:router(config-if)# cdp

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

The following example shows how to disable CDP on Packet-over-SONET/SDH (POS) interface 0/0/0/1:

RP/0/RP0/CPU0:router(config)# interface POS 0/0/0/1 RP/0/RP0/CPU0:router(config-if)# no cdp

Related Commands Command Description

show cdp Displays global CDP information, including timer and holdtime

information.

cdp

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-49

cdp advertise v1

Cisco Confidential - Beta Review R3.7.1

cdp advertise v1

To change the version of Cisco Discovery Protocol (CDP) that is used to communicate with neighboring devices to version 1 (CDPv1), use the cdp advertise v1 command in global configuration mode. To remove the cdp advertise v1 command from the configuration file and restore the system to its default condition with respect to this command, use the no form of this command.

cdp advertise v1

no cdp advertise [v1]

Syntax Description This command has no arguments or keywords.

Defaults Version 2 is enabled.

CDP Commands on Cisco IOS XR Software

Command Modes Global configuration

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Tas k ID

Examples The following example shows how to set a networking device to send and receive only CDPv1

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

CDPv2 packets are sent by default. CDP also sends and receives CDPv1 packets if the device with which CDP is interacting does not process CDPv2 packets.

CDPv2 adds device information over CDPv1. The additional information that is contained in the CDPv2 messages relates to Native VLAN, VLAN Trunking Protocol (VTP) Management Domain, Ethernet Duplex, and other features.

Task ID Operations

cdp read, write

advertisements:

RP/0/RP0/CPU0:router(config)# cdp advertise v1

SMR-50

The following example shows how to restore the default condition (sending and receiving CDPv2 advertisements):

RP/0/RP0/CPU0:router(config)# no cdp advertise

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

cdp Enables CDP on a supported interface.

show cdp Displays global CDP information, including timer and holdtime

information.

cdp advertise v1

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-51

cdp holdtime

Cisco Confidential - Beta Review R3.7.1

cdp holdtime

To specify the time for which the receiving device should hold a Cisco Discovery Protocol (CDP) packet from your networking device before discarding it, use the cdp holdtime command in global configuration mode. To remove the cdp holdtime global configuration command from the configuration file and restore the system to its default condition with respect to this command, use the no form of this command.

CDP Commands on Cisco IOS XR Software

cdp holdtime seconds

no cdp holdtime

Syntax Description

Defaults seconds: 180

Command Modes Global configuration

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

seconds Holdtime to be sent in the CDP update packets. Range is 10 seconds to 255

seconds.

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

CDP packets are sent with a time-to-live value, or holdtime, that is nonzero after an interface is enabled.

The CDP holdtime must be set to a higher number of seconds than the time between CDP transmissions, which is set using the

cdp timer command.

Tas k ID

Examples The following example shows how to specify that the CDP packets sent from the networking device are

Cisco ASR 14000 Series Router System Management Command Reference

SMR-52

Task ID Operations

cdp read, write

held by the receiving device for 60 seconds before being discarded. You might want to set the holdtime lower than the default setting of 180 seconds if information about your networking device changes often and you want the receiving devices to purge this information more quickly.

RP/0/RP0/CPU0:router(config)# cdp holdtime 60

The following example shows how to use the no form of the command to set the holdtime to the default of 180 seconds:

RP/0/RP0/CPU0:router(config)# no cdp holdtime

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

cdp timer Specifies how often the software sends CDP updates.

show cdp Displays global CDP information, including timer and holdtime

information.

cdp holdtime

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-53

cdp log adjacency changes

Cisco Confidential - Beta Review R3.7.1

cdp log adjacency changes

To log changes to the Cisco Discovery Protocol (CDP) adjacency table, use the cdp log adjacency changes command in global configuration mode. To disable the logging, use the no form of this

command.

cdp log adjacency changes

no cdp log adjacency changes

Syntax Description This command has no arguments or keywords.

Defaults CDP adjacency table logging is disabled.

Command Modes Global configuration

CDP Commands on Cisco IOS XR Software

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

When CDP adjacency table logging is enabled, a syslog is generated each time a CDP neighbor is added or removed.

Tas k ID

Task ID Operations

cdp read, write

Examples The following example shows how to enable CDP adjacency table logging:

RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# cdp log adjacency changes

When CDP adjacency table logging is enabled, a syslog is generated each time a CDP neighbor is added or removed. The following is an example of the log entry:

LC/0/5/CPU0:Jun 5 10:51:18.081 : cdp[109]: %L2-CDP-6-DELETED_NEIGHBOR : CDP Neighbour TBA04110127 on interface GigabitEthernet0/5/0/0 has been deleted, remote interface 3/2

SMR-54

LC/0/5/CPU0:Jun 5 10:51:33.120 : cdp[109]: %L2-CDP-6-NEW_NEIGHBOR : New CDP neighbor TBA04110127 detected on interface GigabitEthernet0/5/0/0, remote interface 3/2

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

show cdp Displays global CDP information, including timer and holdtime

information.

cdp log adjacency changes

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-55

cdp timer

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

To specify how often the software sends Cisco Discovery Protocol (CDP) updates, use the cdp timer command in global configuration mode. To remove the cdp timer global configuration command from the configuration file and restore the system to its default condition with respect to this command, use the no form of this command.

cdp timer seconds

no cdp timer

Syntax Description

Defaults seconds: 60 seconds

Command Modes Global configuration

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Tas k ID

seconds Frequency with which the Cisco IOS XR software sends CDP updates.

Range is 5 to 254 seconds. The default is 60 seconds.

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

A lower timer setting causes CDP updates to be sent more frequently.

Task ID Operations

cdp read, write

Examples The following example shows how to set the CDP timer to 80 seconds, which is less frequent than the

default setting of 60 seconds:

RP/0/RP0/CPU0:router(config)# cdp timer 80

Related Commands

Cisco ASR 14000 Series Router System Management Command Reference

SMR-56

Command Description

cdp holdtime Specifies the time for which the receiving device should hold a CDP packet

sent by your networking device before discarding it.

show cdp Displays global CDP information, including timer and holdtime

information.

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

clear cdp counters

To reset Cisco Discovery Protocol (CDP) traffic counters to zero (0), use the clear cdp counters command in EXEC mode.

clear cdp counters location node-id

clear cdp counters

Syntax Description

location node-id Clears CDP traffic counters for the designated node. The node-id argument

is entered in the rack/slot/module notation.

Defaults The counters are set to zero.

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Tas k ID

Task ID Operations

cdp read, write

Examples The following example shows how to clear CDP counters. The show cdp traffic output shows that all

traffic counters have been reset to zero (0).

RP/0/RP0/CPU0:router# clear cdp counters RP/0/RP0/CPU0:router# show cdp traffic

CDP counters: Packets output: 0, Input: 0 Hdr syntax: 0, Chksum error: 0, Encaps failed: 0 No memory: 0, Invalid packet: 0, Truncated: 0 CDP version 1 advertisements output: 0, Input: 0 CDP version 2 advertisements output: 0, Input: 0 Unrecognize Hdr version: 0, File open failed: 0

Related Commands

Command Description

clear cdp table Clears and resizes the table that contains CDP information about neighbors.

show cdp traffic Displays traffic information between devices gathered using CDP.

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

SMR-57

clear cdp table

Cisco Confidential - Beta Review R3.7.1

clear cdp table

To clear and automatically resize the table that contains Cisco Discovery Protocol (CDP) information about neighbors, use the clear

clear cdp table location node-id

CDP Commands on Cisco IOS XR Software

cdp table command in EXEC mode.

Syntax Description

location node-id Clears and resizes the CDP table for the designated node. The node-id

argument is entered in the rack/slot/module notation.

Defaults No default behavior or values

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Use the clear cdp table command to clear and resize the CDP table that contains the neighbor entries. The new table size is calculated according to the recommended hash table size, as seen in the show cdp command output.

Tas k ID

Task ID Operations

cdp read, write

Examples The following example shows how to clears and resize the CDP table. The output of the show cdp

neighbors command before and after use of the clear cdp table command shows that all information

has been deleted from the table:

RP/0/RP0/CPU0:router# show cdp neighbors

Capability Codes: R - Router, T - Trans Bridge, B - Source Route Bridge S - Switch, H - Host, I - IGMP, r - Repeater

Device ID Local Intrfce Holdtme Capability Platform Port ID TBA04341195(15la Mg0/RP1/CPU0/0 171 T S WS-C2924 0/1

RP/0/RP0/CPU0:router# clear cdp table RP/0/RP0/CPU0:router# show cdp neighbors

Capability Codes: R - Router, T - Trans Bridge, B - Source Route Bridge S - Switch, H - Host, I - IGMP, r - Repeater

Cisco ASR 14000 Series Router System Management Command Reference

SMR-58

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Device ID Local Intrfce Holdtme Capability Platform Port ID

The show cdp command shows that the table has been resized:

RP/0/RP0/CPU0:router# show cdp

Global CDP information: Sending CDP packets every 60 seconds Sending a holdtime value of 180 seconds Sending CDPv2 advertisements is enabled

Related Commands Command Description

show cdp Displays global CDP information, including timer and holdtime

information.

show cdp neighbors Displays information about neighboring devices discovered by CDP.

clear cdp table

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-59

show cdp

Cisco Confidential - Beta Review R3.7.1

show cdp

To display global Cisco Discovery Protocol (CDP) information, including CDP version, timer, and holdtime information, use the show cdp command in EXEC mode.

show cdp

Syntax Description This command has no arguments or keywords.

Command Modes EXEC

CDP Commands on Cisco IOS XR Software

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Use the show cdp command to display CDP version, timer, and holdtime information relative to CDP operations.

Tas k ID

Task ID Operations

cdp read

Examples The following example shows how to use the show cdp command to verify the CDP global settings:

RP/0/RP0/CPU0:router# show cdp

Global CDP information: Sending CDP packets every 20 seconds Sending a holdtime value of 30 seconds Sending CDPv2 advertisements is not enabled

Table 8 describes the significant fields shown in the display.

SMR-60

Ta b l e 8 show cdp Field Descriptions

Field Definition

Sending CDP packets every 20 seconds Interval between transmissions of CDP advertisements.

This field is controlled by the

Cisco ASR 14000 Series Router System Management Command Reference

cdp timer command.

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Table 8 show cdp Field Descriptions (continued)

Field Definition

Sending a holdtime value of 30 seconds Time for which the device directs the neighbor to hold a

Sending CDPv2 advertisements is not enabled

show cdp

CDP advertisement before discarding it. This field is controlled by the

cdp holdtime command.

State of being enabled or disabled for the transmission of CDP version 2-type advertisements. This field is controlled by the

cdp advertise v1 command.

Related Commands

Command Description

cdp advertise v1 Changes the version of CDP that is used to communicate with neighboring

devices to CDPv1.

cdp holdtime Specifies the time for which the receiving device should hold a CDP packet

sent by your networking device before discarding it.

cdp timer Specifies how often the software sends CDP updates.

clear cdp table Clears and resizes the table that contains CDP information about neighbors.

show cdp entry Displays information about a specific neighboring device or all neighboring

devices discovered using CDP.

show cdp interface Displays information about the interfaces on which CDP is enabled.

show cdp neighbors Displays information about neighboring devices discovered by CDP.

show cdp traffic Displays traffic information between devices gathered using CDP.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-61

show cdp entry

Cisco Confidential - Beta Review R3.7.1

show cdp entry

To display information about a specific neighboring device or all neighboring devices discovered using Cisco Discovery Protocol (CDP), use the show

show cdp entry {* | entry-name} [protocol | version]

CDP Commands on Cisco IOS XR Software

cdp entry command in EXEC mode.

Syntax Description

* Displays all CDP neighbors.

entry-name Name of a neighbor about which you want information.

protocol (Optional) Displays protocol information associated with CDP neighbor

entries.

version (Optional) Displays version information associated with CDP neighbor

entries.

Defaults This command displays information about a particular device that has been discovered by CDP.

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Tas k ID

Task ID Operations

cdp read, write

Examples The following is sample output from the show cdp entry command. Information about device ID,

address, platform, interface, holdtime, and version is displayed.

RP/0/RP0/CPU0:router# show cdp entry TBA04341195

------------------------Device ID: TBA04341195(sys-235) SysName : sys-235 Entry address(es): IP address: 172.16.23.9 Platform: WS-C6006, Capabilities: Trans-Bridge Switch Interface: MgmtEth0/RP1/CPU0/0 Port ID (outgoing port): 4/18 Holdtime : 157 sec

Version :

Cisco ASR 14000 Series Router System Management Command Reference

SMR-62

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

advertisement version: 2 VTP Management Domain: 'sys' Native VLAN: 125 Duplex: full

Table 9 describes the significant fields shown in the display.

Ta b l e 9 show cdp entry Field Descriptions

Field Description

Device ID ID code assigned during installation of the router.

Entry address(es) Addresses of the platform, selected interface, and

Platform Platform name.

Capabilities Special functions that the platform can perform

Interface Interface location expressed as

Port ID (outgoing port) Location of the port in use by the interface.

Holdtime Time (in seconds) for which the device directs the

Ve rs i o n Software version.

advertisement version Version number of the advertising protocol.

VTP Management Domain VLAN Trunking Protocol (VTP) domain name of

Native VLAN VLAN ID.

Duplex Duplex setting: half or full.

show cdp entry

port ID.

(in this case the platform is a trans-bridge switch).

rack/slot/module/port.

neighbor to hold a CDP advertisement before discarding it. This field is controlled by the cdp holdtime command.

neighbor device.

Related Commands

OL-17231-01

Command Description

show cdp Displays global CDP information, including timer and holdtime

information.

show cdp interface Displays information about the interfaces on which CDP is enabled.

show cdp neighbors Displays information about neighboring devices discovered by CDP.

show cdp traffic Displays traffic information between devices gathered using CDP.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-63

show cdp interface

Cisco Confidential - Beta Review R3.7.1

show cdp interface

To display information about the interfaces on which Cisco Discovery Protocol (CDP) is enabled, use the show cdp interface command in EXEC mode.

show cdp interface [type interface-id | location node-id]

CDP Commands on Cisco IOS XR Software

Syntax Description

Defaults This command displays information about the interfaces on which CDP has been enabled.

Command Modes EXEC

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

function.

interface-id Physical interface identifier. 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.

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

location node-id (Optional) Displays detailed CDP information for the designated node. The

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

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Tas k ID

Cisco ASR 14000 Series Router System Management Command Reference

SMR-64

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

Use the show cdp interface command to display information about any CDP interfaces. When an interface is specified in the command syntax, information is displayed about the specific interface. Not specifying the interface displays information about all interfaces.

Task ID Operations

cdp read, write

OL-17231-01

CDP Commands on Cisco IOS XR Software

show cdp interface

Cisco Confidential - Beta Review R3.7.1

Examples The following is sample output from the show cdp interface command. Information about the status,

CDP timer, and holdtime settings is displayed for all interfaces on which CDP is enabled.

RP/0/RP0/CPU0:router# show cdp interface

POS0/2/0/0 is Up Encapsulation HDLC Sending CDP packets every 120 seconds Holdtime is 240 seconds POS0/2/0/1 is Up Encapsulation HDLC Sending CDP packets every 120 seconds Holdtime is 240 seconds POS0/2/0/2 is Up Encapsulation HDLC Sending CDP packets every 120 seconds Holdtime is 240 seconds POS0/2/0/3 is Up Encapsulation HDLC Sending CDP packets every 120 seconds Holdtime is 240 seconds MgmtEth0/RP1/CPU0/0 is Up Encapsulation ARPA Sending CDP packets every 120 seconds Holdtime is 240 seconds

The following is sample output from the show cdp interface command with an interface specified. Information about the status, CDP timer, and holdtime settings is displayed for Packet-over-SONET/SDH (POS) interface 0/2/0/1 only.

RP/0/RP0/CPU0:router# show cdp interface POS 0/2/0/1

POS0/2/0/1 is Up Encapsulation HDLC Sending CDP packets every 60 seconds Holdtime is 180 seconds

Table 10 describes the significant fields shown in the display.

Ta b l e 10 show cdp interface Field Descriptions

Field Description

POS0/2/0/1 is Up Current condition of POS interface 0/0/2/1.

Encapsulation HDLC Interface is encoding packets using the

Cisco

HDLC Layer 2 encapsulation.

Sending CDP packets every 60 seconds Interval between transmissions of CDP

advertisements. This field is controlled by the cdp timer command.

Holdtime is 180 seconds Time for which the device directs the neighbor to

hold a CDP advertisement before discarding it. This field is controlled by the cdp holdtime command.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-65

show cdp interface

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

show cdp Displays global CDP information, including timer and holdtime

information.

show cdp entry Displays information about a specific neighboring device or all neighboring

devices discovered using CDP.

show cdp neighbors Displays information about neighboring devices discovered by CDP

show cdp traffic Displays traffic information between devices gathered using CDP.

CDP Commands on Cisco IOS XR Software

SMR-66

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

show cdp neighbors

To display detailed information about neighboring devices discovered using Cisco Discovery Protocol (CDP), use the show cdp neighbors command in EXEC mode.

show cdp neighbors [type interface-id | location node-id] [detail]

show cdp neighbors

Syntax Description

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

function.

interface-id Physical interface identifier. 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, line card, or

SIP.

• module: Module or subslot number. A physical layer interface module

(PLIM) is always 0. A subslot specifies the secondary slot on the SIP in which the SPA is installed.

• port: Physical port number of the interface.

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

location node-id (Optional) Displays detailed CDP information for the designated node. The

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

detail (Optional) Displays detailed information about a neighbor or neighbors,

including network address, enabled protocols, holdtime, and software version. The output includes information about both IPv4 and IPv6 addresses.

Defaults No default behavior or values

Command Modes EXEC

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

OL-17231-01

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

Use the show cdp neighbors command to display information about any CDP neighbors. When a location is specified in the command syntax, information about the neighbor is displayed for the specified node. Not specifying the location displays information about the neighbor for all interfaces.

Use the show cdp neighbors command with the detail keyword to display additional information, including IPv6 neighbors.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-67

show cdp neighbors

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Tas k ID

Task ID Operations

cdp read

Examples The following is sample output from the show cdp neighbors command:

RP/0/RP0/CPU0:router# show cdp neighbors

Capability Codes: R - Router, T - Trans Bridge, B - Source Route Bridge S - Switch, H - Host, I - IGMP, r - Repeater

Device ID Local Intrfce Holdtme Capability Platform Port ID

cisco_1 Mg0/0/CPU0/0 139 T S WS-C2924M Fa0/6 cisco_2 PO0/3/0/0 173 R CRS-1 PO0/3/0/0 TBA04110127 Gi0/7/0/0 173 T S WS-C6506 3/9 cisco_3 Gi0/7/0/2 171 R ASR14K-4/ Gi0/4/0/2

Table 11 describes the significant fields shown in the display.

Ta b l e 11 show cdp neighbors Field Descriptions

Field Description

Capability Codes Type of device that can be discovered.

Device ID Name of the neighbor device.

Local Intrfce Protocol being used by the connectivity media and

the interface number.

Holdtme Remaining time, in seconds, for which the current

device holds the CDP advertisement from a sending router before discarding it.

Capability Type of the device listed in the CDP Neighbors

table. Values are as follows:

SMR-68

• R—Router

• T—Transparent bridge

• B—Source-routing bridge

• S—Switch

• H—Host

• I—Internet Group Management Protocol

(IGMP) device

• r—Repeater

Platform Product number of the device.

Port ID Protocol and port number of the device.

The following is sample output for IPv4 and IPv6 neighbors from the show cdp neighbors detail command:

RP/0/RP0/CPU0:router# show cdp neighbor detail

-------------------------

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Device ID: uut-user SysName : uut-user Entry address(es): IPv4 address: 1.1.1.1 IPv6 address: 1::1 IPv6 address: 2::2 Platform: cisco 12008/GRP, Capabilities: Router Interface: POS0/4/0/3 Port ID (outgoing port): POS0/2/0/3 Holdtime : 177 sec

advertisement version: 2

Table 12 describes the significant fields shown in the display.

Ta b l e 12 show cdp neighbors detail Field Descriptions

Field Definition

Device ID Name of the neighbor device.

Entry address(es) List of network addresses of neighbor devices. The address

Platform Product name and number of the neighbor device.

Capabilities Device type of the neighbor. This device can be a router, a

Interface Interface being used by the connectivity medium.

Port ID Port number of the port on the current device.

Holdtime Remaining time (in seconds) for which the current device

Ve rs i o n Software version of the neighbor device.

advertisement version Version number of the advertising protocol.

show cdp neighbors

can be in IP, or Connectionless Network Service

(

CLNS)

protocol conventions.

bridge, a transparent bridge, a source-routing bridge, a switch, a host, an IGMP device, or a repeater.

holds the CDP advertisement from a sending router before discarding it.

Related Commands

OL-17231-01

Command Description

show cdp Displays global CDP information, including timer and holdtime

information.

show cdp entry Displays information about a specific neighboring device or all neighboring

devices discovered using CDP.

show cdp interface Displays information about the interfaces on which CDP is enabled.

show cdp traffic Displays traffic information between devices gathered using CDP.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-69

show cdp traffic

Cisco Confidential - Beta Review R3.7.1

show cdp traffic

To display information about the traffic gathered between devices using Cisco Discovery Protocol (CDP), use the show cdp traffic command in EXEC mode.

show cdp traffic [location node-id]

CDP Commands on Cisco IOS XR Software

Syntax Description

location node-id (Optional) Displays detailed CEF information for the designated node. The

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

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Tas k ID

Task ID Operations

cdp read

Examples The following is sample output from the show cdp traffic command:

RP/0/RP0/CPU0:router# show cdp traffic

SMR-70

CDP counters : Packets output: 50662, Input: 40414 Hdr syntax: 0, Chksum error: 0, Encaps failed: 0 No memory: 0, Invalid packet: 0, Truncated: 0 CDP version 1 advertisements output: 0, Input: 0 CDP version 2 advertisements output: 50662, Input: 40414 Unrecognize Hdr version: 0, File open failed: 0

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

CDP Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Table 13 describes the significant fields shown in the display.

Ta b l e 13 show cdp traffic Field Descriptions

Field Definition

Packets output Number of CDP advertisements sent by the local device.

Input Number of CDP advertisements received by the local

Hdr syntax Number of CDP advertisements having bad headers that

Chksum error Number of times the checksum (verifying) operation failed

Encaps failed Number of times CDP failed to send advertisements on an

No memory Number of times that the local device did not have enough

Invalid packet Number of invalid CDP advertisements received and sent by

Truncated Number of times truncated CDP advertisements were sent

CDP version 1 advertisements output Number of CDP version 1 advertisements sent by the local

Input Number of CDP version 1 advertisements received by the

CDP version 2 advertisements output Number of CDP version 2 advertisements sent by the local

Input Number of CDP version 2 advertisements received by the

Unrecognize Hdr version Number of packets received from a CDP version that was

File open failed Number of times that CDP failed to connect to one of the

show cdp traffic

Note that this value is the sum of the CDP version 1 advertisements output field and the CDP version 2 advertisements output field.

device. Note that this value is the sum of the CDP version 1 advertisements input field and the CDP version 2 advertisements input field.

have been received by the local device.

on incoming CDP advertisements.

interface because of a failure caused by the bridge port of the local device.

memory to store the CDP advertisements in the advertisement cache table when the device was attempting to assemble advertisement packets for transmission and parse them when receiving them.

the local device.

because there was not enough space in the CDP packet to hold all CDP type-length-values

(

TLVs).

device.

local device.

device.

local device.

outside the current configuration.

underlying services it uses.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-71

show cdp traffic

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

show cdp Displays global CDP information, including timer and holdtime

information.

show cdp entry Displays information about a specific neighboring device or all neighboring

devices discovered using CDP.

show cdp interface Displays information about the interfaces on which CDP is enabled.

show cdp neighbors Displays information about neighboring devices discovered by CDP.

CDP Commands on Cisco IOS XR Software

SMR-72

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Cisco Confidential - Beta Review R3.7.1

Clock Commands on Cisco IOS XR Software

This chapter describes the commands used to set and display the internal clock settings in the Cisco

IOS XR software.

For more information about manually setting the router clock, see Cisco ASR 14000 Series Router Getting Started Guide.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-73

clock read-calendar

Cisco Confidential - Beta Review R3.7.1

clock read-calendar

To manually copy the hardware clock (calendar) settings into the software clock, use the clock read-calendar command in EXEC mode.

clock read-calendar

Syntax Description This command has no arguments or keywords.

Defaults Read calendar is disabled.

Command Modes EXEC

Clock Commands on Cisco IOS XR Software

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

The “calendar” clock is a hardware system clock that runs continuously, even if the router is powered off or rebooted. The hardware system clock is separate from the software clock settings, which are erased when the router is power cycled or rebooted.

Use the clock read-calendar command to manually copy the hardware clock setting into the software clock.

Tas k ID

Task ID Operations

host-services execute

Examples In the following example, the hardware clock settings are copied to the software clock with the clock

read-calendar command. The show clock command is then entered to display the new software clock

settings.

RP/0/RP0/CPU0:router# clock read-calendar RP/0/RP0/CPU0:router# show clock

Related Commands

Cisco ASR 14000 Series Router System Management Command Reference

SMR-74

14:31:57.089 PST Tue Feb 10 2005

Command Description

clock set Sets the software clock settings.

clock update-calendar Sets the calendar from the software clock.

OL-17231-01

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Command Description

show clock Displays the clock settings.

update-calendar Periodically updates the calendar from NTP.

clock read-calendar

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-75

clock set

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

To change the software clock settings, use the clock set command in EXEC mode.

clock set hh:mm:ss {day month year | month day year}

Syntax Description

hh:mm:ss Current time in hours (24-hour format), minutes, and seconds. Colons are

required between values.

day Current day (by date) in the month.

month Current month (by name).

year Current year (no abbreviation). Enter a valid four-digit year.

Defaults Clock is not set.

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Generally, if the system is synchronized by a valid outside timing mechanism, such as a Network Time Protocol (NTP) clock source, or if you have a networking device with calendar capability, you need not set the software clock. Use the clock set command if no other time sources are available. The time specified in this command is relative to the configured time zone.

Tas k ID

Task ID Operations

host-services execute

Examples Setting the Software Clock

This example shows how to set the software clock using the clock set hh:mm:ss day month year form of the command:

RP/0/RP0/CPU0:router# clock set 14:12:00 10 feb 2005

14:12:00.114 JST Fri Feb 10 2005

This example shows how to set the software clock using the clock set hh:mm:ss month day year form of the command:

RP/0/RP0/CPU0:router# clock set 14:38:00 feb 10 2005

14:38:00.069 PST Tue Feb 10 2005

Cisco ASR 14000 Series Router System Management Command Reference

SMR-76

OL-17231-01

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Displaying the Clock Settings

This example shows how to display the settings of the software clock:

RP/0/RP0/CPU0:router# show clock

14:38:11.292 PST Tue Feb 10 2005

Displaying the Available Months

This example shows how to display the available months using the online help (?) system:

RP/0/RP0/CPU0:router# clock set 06:10:00 12 ?

january Month of the Year february march april may june july august september october november december

clock set

Related Commands Command Description

clock summer-time Configures the system to switch automatically to summer time (daylight

saving time).

clock timezone Sets the time zone for display.

show clock Displays the clock settings.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-77

clock summer-time

Cisco Confidential - Beta Review R3.7.1

clock summer-time

To configure the system to switch automatically to summer time (daylight saving time), use the clock summer-time command in global configuration mode. To remove the clock summer-time setting, use the no form of this command.

clock summer-time zone {recurring week day month hh:mm week day month hh:mm [offset] | date

{date month year hh:mm date month year hh:mm | month date year hh:mm month date year hh:mm} [offset]}

no clock summer-time

Clock Commands on Cisco IOS XR Software

Syntax Description

Defaults Summer time is not configured.

zone Name of the time zone (for example, PDT) to be displayed when summer

time is in effect. for the zone argument.

recurring Indicates that summer time should start and end on the corresponding

specified days every year.

week Week of the month (values are 1 to 5, first or last).

day Day of the week.

month Month.

hh:mm Time (24-hour format) in hours and minutes.

offset (Optional) Number of minutes to add during summer time. The default is 60

minutes (1 hour).

date Indicates that summer time should start on the first specific date listed in the

command and end on the second specific date in the command.

date Date of the month.

year Year (no abbreviation).

offset: 60 minutes

Table 14 on page 80 lists common time zone acronyms used

Command Modes Global configuration

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Cisco ASR 14000 Series Router System Management Command Reference

SMR-78

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

OL-17231-01

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Use the clock summer-time command if you want the system to switch automatically to summer time (for display only):

• Use the recurring form of the command to apply the rules on the configured day each year. If clock

summer-time zone recurring is specified without parameters, the summer time rules default to

United States standards. The default for the offset argument is 60 minutes.

• Use the date form to specify a start and end date for summer time if you cannot use the first form.

In both forms of the command, the first part of the command specifies when summer time begins, and the second part specifies when it ends. All times are relative to the local time zone. The start time is relative to standard time. The end time is relative to summer time. If the starting month is after the ending month, the system assumes that you are in the Southern Hemisphere.

clock summer-time

Tas k ID

Task ID Operations

host-services read, write

Examples The following example specifies that summer time starts on the first Sunday in April at 02:00 and ends

on the last Sunday in October at 02:00. The recurring keyword indicates that the rules apply every year.

RP/0/RP0/CPU0:router(config)# clock summer-time PDT recurring 1 Sunday April 2:00 last Sunday October 2:00

If you live where summer time does not follow the pattern in the first example, you could set it to start on October 12, 2005 at 02:00 and end on April 26, 2006 at 02:00, with the following example. The date keyword indicates that the rules apply for the current year only.

RP/0/RP0/CPU0:router(config)# clock summer-time PDT date 12 October 2005 2:00 26 April 2006 2:00

Related Commands

Command Description

clock set Sets the software clock settings.

clock timezone Sets the time zone for display.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-79

clock timezone

Cisco Confidential - Beta Review R3.7.1

clock timezone

To set the time zone for display, use the clock timezone command in global configuration mode. To remove the clock timezone setting, use the no form of this command.

clock timezone zone hours-offset [minutes-offset]

no clock timezone

Clock Commands on Cisco IOS XR Software

Syntax Description

Defaults UTC

Command Modes Global configuration

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

zone Name of the time zone to be displayed when standard time is in effect.

hours-offset Hours offset from Coordinated Universal Time (UTC). Range is from –23 to

+23.

minutes-offset (Optional) Minutes offset from UTC.

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

Use the clock timezone command only to display the time zone when setting the time manually. The system keeps time internally in UTC.

Table 14 lists common time zone acronyms used for the zone argument.

SMR-80

Ta b l e 14 Common Time Zone Acronyms

Acronym Time Zone Name and UTC Offset

Europe

GMT Greenwich Mean Time, as UTC.

BST British Summer Time, as UTC plus 1 hour.

IST Irish Summer Time, as UTC plus 1 hour.

WET Western Europe Time, as UTC.

WEST Western Europe Summer Time, as UTC plus 1 hour.

CET Central Europe Time, as UTC plus 1 hour.

CEST Central Europe Summer Time, as UTC plus 2 hours.

EET Eastern Europe Time, as UTC plus 2 hours.

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Table 14 Common Time Zone Acronyms (continued)

Acronym Time Zone Name and UTC Offset

EEST Eastern Europe Summer Time, as UTC plus 3 hours.

MSK Moscow Time, as UTC plus 3 hours.

MSD Moscow Summer Time, as UTC plus 4 hours.

United States and Canada

AST Atlantic Standard Time, as UTC minus 4 hours.

ADT Atlantic Daylight Time, as UTC minus 3 hours.

ET Eastern Time, either as EST or EDT, depending on

EST Eastern Standard Time, as UTC minus 5 hours.

EDT Eastern Daylight Saving Time, as UTC minus 4

CT Central Time, either as CST or CDT, depending on

CST Central Standard Time, as UTC minus 6 hours.

CDT Central Daylight Saving Time, as UTC minus 5 hours.

MT Mountain Time, either as MST or MDT, depending on

MST Mountain Standard Time, as UTC minus 7 hours.

MDT Mountain Daylight Saving Time, as UTC minus 6

PT Pacific Time, either as PST or PDT, depending on

PST Pacific Standard Time, as UTC minus 8 hours.

PDT Pacific Daylight Saving Time, as UTC minus 7 hours.

AKST Alaska Standard Time, as UTC minus 9 hours.

AKDT Alaska Standard Daylight Saving Time, as UTC

HST Hawaiian Standard Time, as UTC minus 10 hours.

Australia

clock timezone

place and time of year.

hours.

place and time of year.

hours.

place and time of year.

minus 8 hours.

OL-17231-01

WST Western Standard Time, as UTC plus 8 hours.

CST Central Standard Time, as UTC plus 9.5 hours.

EST Eastern Standard/Summer Time, as UTC plus 10

hours (plus 11 hours during summer time).

Table 15 lists an alternative method for referring to time zones, in which single letters are used to refer

to the time zone difference from UTC. Using this method, the letter Z is used to indicate the zero meridian, equivalent to UTC, and the letter J (Juliet) is used to refer to the local time zone. Using this method, the International Date Line is between time zones M and Y.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-81

clock timezone

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Ta b l e 15 Single-Letter Time Zone Designators

Letter Designator Word Designator Difference from UTC

Y Yank ee UTC minus 12 hours.

X Xray UTC minus 11 hours.

W Whiskey UTC minus 10 hours.

V Victor UTC minus 9 hours.

U Uniform UTC minus 8 hours.

T Tango UTC minus 7 hours.

S Sierra UTC minus 6 hours.

R Romeo UTC minus 5 hours.

Q Quebec UTC minus 4 hours.

P Papa UTC minus 3 hours.

O Oscar UTC minus 2 hours.

N November UTC minus 1 hour.

Z Zulu Same as UTC.

A Alpha UTC plus 1 hour.

B Bravo UTC plus 2 hours.

C Charlie UTC plus 3 hours.

D Delta UTC plus 4 hours.

E Echo UTC plus 5 hours.

F Foxtrot UTC plus 6 hours.

G Golf UTC plus 7 hours.

H Hotel UTC plus 8 hours.

I India UTC plus 9 hours.

K Kilo UTC plus 10 hours.

L Lima UTC plus 11 hours.

M Mike UTC plus 12 hours.

Tas k ID

Task ID Operations

host-services read, write

Examples The following example shows how to set the time zone to PST and offset 8 hours behind UTC:

RP/0/RP0/CPU0:router(config)# clock timezone PST -8

The following example shows how to set the time zone to Atlantic Time (AT) for Newfoundland, Canada, which is 3.5 hours behind UTC:

RP/0/RP0/CPU0:router(config)# clock timezone AT -3 30

Cisco ASR 14000 Series Router System Management Command Reference

SMR-82

OL-17231-01

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

clock set Sets the software clock settings.

clock summer-time Configures the system to switch automatically to summer time (daylight

saving time).

clock timezone Sets the time zone for display.

show clock Displays the clock settings.

clock timezone

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-83

clock update-calendar

Cisco Confidential - Beta Review R3.7.1

clock update-calendar

To copy the software clock settings to the hardware clock (calendar), use the clock update-calendar command in EXEC mode.

clock update-calendar

Syntax Description This command has no arguments or keywords.

Command Modes EXEC

Clock Commands on Cisco IOS XR Software

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

Tas k ID

Examples The following example shows how to copy the current time from the software clock to the hardware

Related Commands

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

task IDs.

The hardware clock (calendar) runs continuously, even if the router is powered off or rebooted. If the software clock and calendar are not synchronized and the software clock is more accurate, use this command to update the hardware calendar clock to the correct date and time.

Task ID Operations

host-services execute

clock:

RP/0/RP0/CPU0:router# clock update-calendar

Command Description

clock read-calendar Copies the hardware (calendar) clock settings into the software clock.

SMR-84

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

locale country

To set the default country of use, use the locale country command in global configuration mode. To remove the locale country setting, use the no form of this command.

locale country country

no locale country

locale country

Syntax Description

country Country, where country is a two-character country code. Case is not

important.

Defaults No default behavior or values

Command Modes Global configuration

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Note This command is not fully supported at this time.

To display a complete listing of the available country codes, use the online help (?) function:

RP/0/RP0/CPU0:router(config)# locale country ?

OL-17231-01

AD Andorra AE United Arab Emirates AF Afghanistan AG Antigua and Barbuda AI Anguilla AL Albania AM Armenia AN Netherlands Antilles AO Angola AQ Antarctica AR Argentina AS American Samoa AT Austria AU Australia AW Aruba AZ Azerbaijan BA Bosnia and Herzegovina BB Barbados BD Bangladesh BE Belgium

Cisco ASR 14000 Series Router System Management Command Reference

SMR-85

locale country

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

--More--

Tas k ID

Task ID Operations

host-services read, write

Examples The following example shows how to set the country of use to Australia:

RP/0/RP0/CPU0:router(config)# locale country au

Related Commands

Command Description

locale language Sets the default language of use.

SMR-86

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

locale language

To set the default language of use, use the locale language command in global configuration mode. To remove the locale language setting, use the no form of this command.

locale language language

no locale language

locale language

Syntax Description

language Specifies the language, where language is a two-character code. Case is not

important.

Defaults No default behavior or values

Command Modes Global configuration

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Note This command is not fully supported at this time.

To display a complete listing of the available language codes, use the online help (?) function:

RP/0/RP1/CPU0:router(config)# locale language ?

aa Afar ab Abkhazian af Afrikaans am Amharic ar Arabic as Assamese ay Aymara

--More--

Tas k ID

Task ID Operations

host-services read, write

Examples The following example shows how to set the language of use to English:

RP/0/RP0/CPU0:router(config)# locale language en

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

SMR-87

locale language

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

locale country Sets the default country of use.

Clock Commands on Cisco IOS XR Software

SMR-88

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Clock Commands on Cisco IOS XR Software

Cisco Confidential - Beta Review R3.7.1

show clock

To display the system clock, use the show clock command in EXEC mode.

show clock [detail]

show clock

Syntax Description

detail (Optional) Indicates the time source and the current summer time setting (if any).

Command Modes EXEC

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

The system clock keeps an “authoritative” flag that indicates whether the time is authoritative (believed to be accurate). If the system clock has been set by a timing source, such as system calendar or Network Time Protocol (NTP), the flag is set. If the time is not authoritative, it is used only for display. Until the clock is authoritative and the “authoritative” flag is set, the flag prevents peers from synchronizing to the clock when the peers have invalid times.

Table 16 describes the leading symbols that precede the show clock display.

Ta b l e 16 show clock Display Leading Symbol Descriptions

Symbol Description

* Time is not authoritative.

(blank) Time is authoritative.

. Time is authoritative, but NTP is not synchronized.

Tas k ID

Task ID Operations

basic-services read

Examples The following sample output shows the current clock settings:

RP/0/RP0/CPU0:router# show clock

16:18:28.927 PST Tue Feb 10 2005

The following sample output shows the current clock detail, including the time source:

RP/0/RP0/CPU0:router# show clock detail

16:18:07.164 PST Tue Feb 10 2005 Timezone: PST8PST Timesource: User configured

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

SMR-89

show clock

Cisco Confidential - Beta Review R3.7.1

Related Commands Command Description

clock set Sets the software clock settings.

Clock Commands on Cisco IOS XR Software

SMR-90

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Cisco Confidential - Beta Review R3.7.1

Configuration Management Commands on Cisco IOS XR Software

This chapter describes the Cisco IOS XR software commands used to manage your basic configuration.

For detailed information about configuration management concepts, tasks, and examples, see

Cisco

ASR 14000 Series Router Getting Started Guide.

OL-17231-01

Cisco ASR 14000 Series Router System Management Command Reference

SMR-91

abort

To terminate a configuration session and discard all uncommitted changes without system confirmations, use the abort command in any configuration mode.

abort

Syntax Description This command has no arguments or keywords.

Defaults No default behavior or values

Command Modes Any configuration mode

Configuration Management Commands on Cisco IOS XR Software

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Use the abort command to terminate a configuration session and return to EXEC mode from any configuration mode. This command causes all uncommitted configuration changes to be discarded. You will not be prompted to commit the changes.

Tas k ID This command requires the task ID for the feature or configuration submode impacted by the command.

Examples The following example shows how to use the abort command to discard all changes made during a

configuration session:

RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# interface pos 0/2/0/0 RP/0/RP0/CPU0:router(config-if)# ipv4 address 1.1.1.1 255.0.0.0 RP/0/RP0/CPU0:router(config-if)# abort RP/0/RP0/CPU0:router#

Related Commands

Cisco ASR 14000 Series Router System Management Command Reference

SMR-92

Command Description

clear (global) Discards changes to the target configuration that have not yet been committed,

without exiting the configuration session.

end Terminates a session and returns the router to EXEC mode from any configuration

mode.

exit Exits from the current configuration mode to the next higher command mode or logs

out of the terminal session.

OL-17231-01

Configuration Management Commands on Cisco IOS XR Software

admin

To enter administration EXEC mode, use the admin command in EXEC mode.

admin

Syntax Description This command has no arguments or keywords.

Defaults No default behavior or values

Command Modes EXEC

admin

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Use the admin command to enter administration EXEC mode. Administration EXEC mode is used to execute various administration plane commands.

Note Administration commands can be run only by entering administration mode and not by prefixing the

command with the admin keyword in EXEC mode.

Tas k ID

Task ID Operations

admin read, write, execute

Examples The following example shows how to enter administration EXEC mode:

RP/0/RP0/CPU0:router# admin RP/0/RP0/CPU0:router(admin)#

Related Commands

OL-17231-01

To use administration configuration mode, use the configure command in administration EXEC mode:

RP/0/RP0/CPU0:router# admin RP/0/RP0/CPU0:router(admin)# configure RP/0/RP0/CPU0:router(admin-config)#

Command Description

configure Enters global configuration mode.

Cisco ASR 14000 Series Router System Management Command Reference

SMR-93

alias

Configuration Management Commands on Cisco IOS XR Software

To create a command alias, use the alias command in global configuration mode. To delete an alias, use the no form of this command.

alias alias-name [(param1, param2, ..., paramx)] content1 [;content2; ...; contentx]

no alias alias-name

Syntax Description.

alias-name Name of the command alias. Alias names can be a single word or multiple

words joined by a hyphen (-) or an underscore (_).

param1, paramx (Optional) Parameters assigned to the alias. These parameters are filled in at

execution time.

content1, contentx Original command syntax. Valid abbreviations of the original command

syntax can be entered for the content argument.

Defaults No command aliases are configured.

Command Modes Global configuration

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Cisco IOS XR software supports generic alias definitions for various entities. Any physical or logical entity can have an alias as a reference. For example, an alias can refer to a command, a partial command, a group of commands, a location, or an IP address.

SMR-94

An alias must first be defined. The alias can then be used in command lines in place of the defined entity.

Following is a list of properties for an alias:

• An alias can be used anywhere, in any mode or submode.

• An alias can have zero, one, or many parameters.

• An alias can refer to those parameters with the $ sign.

• If an alias refers to more than one command, the commands must be separated by a semicolon (;).

• The size of the alias command is limited to 1024 characters.

The alias command can be used anywhere. If the content referenced by the alias is invalid or inappropriate in that context or submode, the system issues a warning message containing the substituted content.

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Configuration Management Commands on Cisco IOS XR Software

An alias name should not be a subset of the keywords that it represents as alias. Substitution is done only when the entered input match fails completely. For instance, the attempt to define an alias with config as the alias name fails, as shown here:

RP/0/RP0/CPU0:router# (config)# alias config set_host hostname router RP/0/RP0/CPU0:router# (config)# show configuration

alias set_host hostname router

Use the show aliases command to display all command aliases or the command aliases in a specified mode.

alias

Tas k ID

Task ID Operations

logging read, write

Examples The following example shows how to create an alias named ipbr for the show ipv4 interface brief

command, commit the configuration, enter EXEC mode, and then enter the configured alias:

RP/0/RP0/CPU0:router# configure RP/0/RP0/CPU0:router(config)# alias ipbr show ipv4 interface brief RP/0/RP0/CPU0:router(config)# show configuration

Building configuration... alias ipbr show ipv4 interface brief end RP/0/RP0/CPU0:router(config)# commit

RP/0/RP0/CPU0:Feb 21 04:42:57.017 : config[65689]: %MGBL-LIBTARCFG-6-COMMIT : Co nfiguration committed by user 'lab'. Use 'show configuration commit changes 1000000022' to view the changes. RP/0/RP0/CPU0:router(config)# end

RP/0/RP0/CPU0:Mar 27 22:19:05 : config[65739]: %SYS-5-CONFIG_I : Configured from console by lab RP/0/RP0/CPU0:router# ipbr RP/0/RP0/CPU0:router# show ipv4 interface brief

Interface IP-Address Status Protocol Loopback0 1.1.1.1 Up Up Loopback999 unassigned Up Up MgmtEth0/0/CPU0/0 12.29.56.21 Up Up RP/0/RP0/CPU0:router#

OL-17231-01

The following example shows how to define an alias, cisco’s-pos, for interface POS1/0/2/3 and then how to use that alias to shut down the interface:

RP/0/RP0/CPU0:router(config)# alias cisco's-pos POS1/0/2/3 RP/0/RP0/CPU0:router(config)# interface cisco's-pos RP/0/RP0/CPU0:router(config-if)# shutdown RP/0/RP0/CPU0:router(config-if)# exit RP/0/RP0/CPU0:router(config)#

The following example shows the use of a parameter name in an alias definition:

RP/0/RP0/CPU0:router(config)# alias shint (intname) show interface $intname

The following example shows an alias defined with one parameter and two commands:

Cisco ASR 14000 Series Router System Management Command Reference

SMR-95

alias

RP/0/RP0/CPU0:router(config)# alias shint_both (intname) show interface $intname;show run interface $intname

The following example shows the use of the alias shint_both in EXEC mode:

RP/0/RP0/CPU0:router(exec)# shint_both(POS1/2/3/4)

Two commands are issued, as follows:

RP/0/RP0/CPU0:router(exec)# show interface POS1/2/3/4; show run interface POS1/2/3/4

Related Commands Command Description

show aliases Displays a summary of all command aliases.

Configuration Management Commands on Cisco IOS XR Software

SMR-96

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Configuration Management Commands on Cisco IOS XR Software

apply-template

To apply a template to the target configuration, use the apply-template command in global configuration mode.

apply-template {template-name1 [template-name2 [template-name3 [template-name4

[template-name5]]]]}

apply-template

Syntax Description

template-name1, template-name2...

Name of the template to be applied to the running configuration. Use the template command to define a template.

Defaults No templates are applied to the target configuration.

Command Modes Global configuration

Command History

Release Modification

Release 3.7.1 This command was introduced on the Cisco ASR 14000 Series Router.

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper

task IDs.

Use the apply-template command to apply a template to the target configuration. Templates allow you to create a template name that represents a group of configuration commands.

Use the template command to define a template. Use the end-template command to exit template configuration mode and return to global configuration mode. Use the show running-config command with the optional template keyword and template-name argument to display the contents of a template.

Tas k ID

Task ID Operations

config-services read, write

Examples The following example shows how to define a template and then apply the template to the target

configuration:

RP/0/RP0/CPU0:router(config)# template hostname-template RP/0/RP0/CPU0:router(config-TPL)# hostname asr14000 RP/0/RP0/CPU0:router(config-TPL)# end-template RP/0/RP0/CPU0:router(config)# apply-template hostname-template

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

SMR-97

apply-template

Related Commands Command Description

end-template Exits template configuration mode.

show running-config Displays the current running (active) configuration.

template Defines a template.

Configuration Management Commands on Cisco IOS XR Software

SMR-98

Cisco ASR 14000 Series Router System Management Command Reference

OL-17231-01

Cisco ASR 14000 Series Management Command Reference

Specifications and Main Features

Frequently Asked Questions

User Manual

Cisco ASR 14000 Series Router System Management Command Reference

Preface

Changes to This Document

Obtaining Documentation and Submitting a Service Request

Bulk Content Downloader (BCDL) Commands on Cisco IOS XR Software

show bcdl

show bcdl consumers

show bcdl queues

show bcdl tables

show bcdl trace

Boot Commands on Cisco IOS XR Software

config-register

mirror

mirror pause

mirror resume

mirror verify

reload

reload (administration EXEC)

show epm trace boot

show mirror

show reboot

show system backup

show variables boot

show variables system

system backup

system boot-sequence

CDP Commands on Cisco IOS XR Software

cdp advertise v1

cdp holdtime

cdp log adjacency changes

cdp timer

clear cdp counters

clear cdp table

show cdp

show cdp entry

show cdp interface

show cdp neighbors

show cdp traffic

Clock Commands on Cisco IOS XR Software

clock read-calendar

clock set

clock summer-time

clock timezone

clock update-calendar

locale country

locale language

show clock

Configuration Management Commands on Cisco IOS XR Software

abort

admin

alias

apply-template