Cisco�IOS�XR System Management Command Reference for the Cisco�CRS Router, Release 4.2.x
Bulk Content Downloader (BCDL) Commands on the Cisco IOS XR Software
Downloads: This chapterpdf (PDF - 364.0KB) The complete bookPDF (PDF - 7.53MB) | Feedback

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

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

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

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 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

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 1  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.

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.

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 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

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
    
This table describes the significant fields shown in the display that are not described in Table 1.

Table 2  show bcdl consumers Field Descriptions

Field

Description

PID

Process identifier.

node

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

asg

Subgroup to which the BCDL agent thinks this consumer belongs.

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 queues

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

show bcdl queues [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 ID

Operations

sysmgr

read

Examples

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


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

Sun May 31 07:13:19.777 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 msgs_in_q  bytes_in_q  errs name
   467088 0/RP0/CPU0   0   0 2053   N         0           0     0 fib_mgr
   303249 0/RP1/CPU0   0   0 2053   N         0           0     0 fib_mgr
    94295   0/1/CPU0   0   0 2053   N         0           0     0 fib_mgr
   127074   0/4/CPU1   0   0 2053   N         0           0     0 fib_mgr
    94295   0/6/CPU0   0   0 2053   N         0           0     0 fib_mgr
   118884   0/4/CPU0   0   0 2053   N         0           0     0 fib_mgr
  
  

Table 1 and Table 1 describe the significant fields shown in the display.

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]

Syntax Description

group_name

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 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

Sun May 31 07:19:41.409 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
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: 386, bytes: 175152
   cnsmr 0: pid 467088 on node 0/RP0/CPU0
   cnsmr 1: pid 127074 on node 0/4/CPU1
   cnsmr 2: pid 118884 on node 0/4/CPU0
   cnsmr 3: pid 94295 on node 0/1/CPU0
   cnsmr 4: pid 94295 on node 0/6/CPU0
   cnsmr 5: pid 303249 on node 0/RP1/CPU0
    
The significant fields shown in the display that are not described in Table 1 or Table 1 are described in this table.

Table 3  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.

members

Number of consumers associated with this table.

dnld act

Indicates whether or not the convergence flag has been sent.

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.

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] [timing] [grpsnd] [ wrapping | unique ] [hexdump] [ last n ] [reverse] [stats] [tailf] [verbose] [ file filename original location node-id | location { node-id | all } ]

Syntax Description

group_name

(Optional) Displays information for a specific BCDL group.

event

(Optional) Displays event trace entries.

timing

(Optional) Displays timing trace entries.

grpsnd

(Optional) Displays group send trace entries.

wrapping

(Optional) Displays wrapping entries.

unique

(Optional) Displays unique entries only, along with the count of the number of times this entry appears.

hexdump

(Optional) Displays traces in hexadecimal format.

last n

(Optional) Displays the last n number of traces only.

reverse

(Optional) Displays the most recent traces first.

stats

(Optional) Displays execution path statistics.

tailf

(Optional) Displays new traces as they are added.

verbose

(Optional) Displays additional internal debugging information.

file filename original location node-id

(Optional) Specifies a filename and original location of the file to display.

location {node-id | all}

Specifies the RP node for which to display the execution path monitoring information. The node-id argument is expressed in the rack/slot/module notation. The all keyword specifies all RP nodes.

Command Default

None

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 ID

Operations

sysmgr

read

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/1/cpu0 

Sun May 31 08:28:40.346 PST
372 wrapping entries (4096 possible, 44 filtered, 372 total)
May 11 15:24:51.388 bcdl/c/ipv4_rib 0/1/CPU0 t3  
  LE bcdl_join_internal: timer_create ret 0, id is 11
May 11 15:24:52.417 bcdl/c/ipv4_rib 0/1/CPU0 t5  
  LE bcdl_join_internal: group_lookup bcdl_ipv4_rib 
  returned gid 2051
May 11 15:24:52.441 bcdl/c/ipv4_rib 0/1/CPU0 t5  
  LE join hwg 2051 returns 0
May 11 15:24:52.446 bcdl/c/ipv4_rib 0/1/CPU0 t5  
  LE bcdl_join_internal: joined group bcdl_ipv4_rib, 
  member count 5
May 11 15:24:53.458 bcdl/c/ipv4_rib 0/1/CPU0 t5  
  LE rcv gsp mtype 3: connection init sg 2 cur_seq 
  0 lwg_gid 2069 table tag 0x00000000 resend state yes
May 11 15:24:53.459 bcdl/c/ipv4_rib 0/1/CPU0 t5  
  LE pc ring high water 0 -> 1, 0 bytes
May 11 15:24:53.464 bcdl/c/ipv4_rib 0/1/CPU0 t3  
  LE c_h deliver msg_id 16 connection init, 
  table event 0 table tag 0x00000000
May 11 15:24:53.464 bcdl/c/ipv4_rib 0/1/CPU0 t3  
  LE conn init, seq 64206 -> 0, sg 65534 -> 2, 
  gid 2051, lwg gid -1 -> 2069
 ...