Cisco IOS XR System Management Command Reference for the Cisco CRS Router, Release 5.3.x First Published: 2015-01-01 Last Modified: 2015-09-01 Americas Headquarters Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA http://www.cisco.com Tel: 408 526-4000 800 553-NETS (6387) Fax: 408 527-0883 THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental. Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com go trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R) © 2015 Cisco Systems, Inc. All rights reserved. Preface This guide describes the System Management commands. This chapter contains details on the changes made to this document. • Changes to This Document, on page iii • Obtaining Documentation and Submitting a Service Request, on page iii Changes to This Document This table lists the technical changes made to this document since it was first printed. Table 1: Changes to This Document Date Change Summary January 2015 Initial release of this document. Obtaining Documentation and Submitting a Service Request For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, see What's New in Cisco Product Documentation. To receive new and revised Cisco technical content directly to your desktop, you can subscribe to the What's New in Cisco Product Documentation RSS feed. RSS feeds are a free service. Cisco IOS XR System Management Command Reference for the Cisco CRS Router, Release 5.3.x iii Preface Obtaining Documentation and Submitting a Service Request Cisco IOS XR System Management Command Reference for the Cisco CRS Router, Release 5.3.x iv Bulk Content Downloader (BCDL) Commands This module describes the show commands that you can use to see the status of the Bulk Content Downloader (BCDL) process. The 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 distributed route processors (DRPs). • MPLS—To download the Label Forwarding Information Base (LFIB) entries to the line card. • LPTS—To maintain the Internal Forwarding Information Base (IFIB) table on all nodes that do IP forwarding to and from the DRPs. • Fabric Management—To update memberships for individual fabric group IDs (FGIDs) to selected portions of the fabric hardware. • CDS—Context Distribution Service. There is no configuration necessary for the BCDL. • show bcdl, on page 2 • show bcdl consumers, on page 4 • show bcdl queues, on page 6 • show bcdl tables, on page 7 • show bcdl trace, on page 9 Cisco IOS XR System Management Command Reference for the Cisco CRS Router, Release 5.3.x 1 Bulk Content Downloader (BCDL) Commands show bcdl show bcdl 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. Command Default No default behavior or values Command Modes EXEC Command History Release Modification Release 3.3.0 This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance. Task ID Task Operations ID sysmgr read The following example shows sample output from the show bcdl command: RP/0/RP0/CPU0:router# show bcdl ipv4_rib Sun May 31 06:57:32.153 PST grp ipv4_rib, gid 2051, sg cnt 1, agent jid 111, node 0/RP0/CPU0, pulse 343, new mbr 0 sg lwg fd csmr hdlr-act dnld-act susp wait-lck seq pulse-tot pulse-out 0 2053 15 6 no no no 0 386 338 0 Table 2: show bcdl Field Descriptions Field Description group Type of download and the Group Services Protocol (GSP) group name. gid 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. Cisco IOS XR System Management Command Reference for the Cisco CRS Router, Release 5.3.x 2 Bulk Content Downloader (BCDL) Commands show bcdl Field Description agent jid Job identifier of the BCDL agent. The JID is numerical identifier for a particular process and remains the same across process restarts. node Node, expressed in the rack/slot/module notation, in which the agent is running. pulse Pulse code used by the producer to pulse the BCDL agent. new mbr 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 nonzero, 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. Cisco IOS XR System Management Command Reference for the Cisco CRS Router, Release 5.3.x 3 Bulk Content Downloader (BCDL) Commands show bcdl consumers 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] Syntax Description group_name (Optional) Displays information for a specific BCDL group. Command Default No default behavior or values Command Modes EXEC Command History Release Modification Release 3.3.0 This command was introduced. Usage Guidelines To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance. Task ID Task Operations ID sysmgr read The following example shows sample output using the show bcdl consumers command: RP/0/RP0/CPU0:router# show bcdl consumers ipv4_rib Sun May 31 06:18:11.556 PST group ipv4_rib, gsp gid 2051, 6 consumers, agent jid 111, node 0/RP0/CPU0 (expected 6 consumers to reply, received 6 replies) pid node asg csg lwg sus messages bytes errs name 467088 0/RP0/CPU0 0 0 2053 N 386 175152 0 fib_mgr 303249 0/RP1/CPU0 0 0 2053 N 255 73844 0 fib_mgr 94295 0/1/CPU0 0 0 2053 N 379 174612 0 fib_mgr 94295 0/6/CPU0 0 0 2053 N 379 174612 0 fib_mgr 127074 0/4/CPU1 0 0 2053 N 387 175180 0 fib_mgr 118884 0/4/CPU0 0 0 2053 N 387 175180 0 fib_mgr Cisco IOS XR System Management Command Reference for the Cisco CRS Router, Release 5.3.x 4 Bulk Content Downloader (BCDL) Commands show bcdl consumers This table describes the significant fields shown in the display that are not described in Table 2: show bcdl Field Descriptions, on page 2.