Cisco IOS XR System Management Command Reference for the Cisco XR 12000 Series Router, Release 4.3.x
Bulk Content Downloader (BCDL) Commands on the Cisco IOS XR Software
Downloads: This chapterpdf (PDF - 1.31MB) The complete bookPDF (PDF - 7.95MB) | 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.
  • MPLS—To download the Label Forwarding Information Base (LFIB) entries to the line card.
  • 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

Task ID

Task ID

Operations

sysmgr

read

Examples

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

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

Sun May 31 14:46:31.768 PST 
grp ipv4_rib, gid 2052, sg cnt 1, agent jid 114, node 0/5/CPU0, pulse 290, 
new m br 0 
sg  lwg fd csmr hdlr-act dnld-act susp wait-lck seq pulse-tot pulse-out 
 0 2056 17    6       no       no   no        0 363       281         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

Task ID

Task ID

Operations

sysmgr

read

Examples

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


RP/0/5/CPU0:router# show bcdl consumer ipv4_rib

Sun May 31 14:23:41.187 PST
group ipv4_rib, gsp gid 2052, 6 consumers, agent jid 114, node 0/5/CPU0
(expected 6 consumers to reply, received 6 replies)
      pid       node asg csg  lwg sus  messages       bytes  errs name
   217223   0/5/CPU0   0   0 2056   N       363       93092     0 fib_mgr
   155736   0/0/CPU0   0   0 2056   N       269       75100     0 fib_mgr
   163921   0/4/CPU0   0   0 2056   N       339       91276     0 fib_mgr
    86097   0/2/CPU0   0   0 2056   N       352       91640     0 fib_mgr
   155736   0/1/CPU0   0   0 2056   N       273       75212     0 fib_mgr
    86099   0/3/CPU0   0   0 2056   N        24       28152     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

Task ID

Task ID

Operations

sysmgr

read

Examples

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


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

Sun May 31 14:53:10.365 PST
group ipv4_rib, gsp gid 2052, 6 consumers, agent jid 114, node 0/5/CPU0
(expected 6 consumers to reply, received 6 replies)
      pid       node asg csg  lwg sus msgs_in_q  bytes_in_q  errs name
   217223   0/5/CPU0   0   0 2056   N         0           0     0 fib_mgr
    86099   0/3/CPU0   0   0 2056   N         0           0     0 fib_mgr
   155736   0/1/CPU0   0   0 2056   N         0           0     0 fib_mgr
   163921   0/4/CPU0   0   0 2056   N         0           0     0 fib_mgr
   155736   0/0/CPU0   0   0 2056   N         0           0     0 fib_mgr
    86097   0/2/CPU0   0   0 2056   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

Task ID

Task ID

Operations

sysmgr

read

Examples

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


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

Sun May 31 15:00:00.571 PST
grp ipv4_rib, gid 2052, sg cnt 1, agent jid 114, node 0/5/CPU0, pulse 290, new mbr 0
  sg  lwg fd csmr hdlr-act dnld-act susp wait-lck   seq pulse-tot pulse-out
   0 2056 17    6       no       no   no        0   363       281         0
sgs: 1, table_cnt: 6, table_mid_cnt: 36, buf size: 644
Showing table info for 1 subgroups
 sg 0: has 6 tables (messages: 0, bytes: 0)
  table 0xe0000005: 6 members, dnld act: 0, messages: 17, bytes: 7092
   cnsmr 0: pid 217223 on node 0/5/CPU0
   cnsmr 1: pid 86097 on node 0/2/CPU0
   cnsmr 2: pid 163921 on node 0/4/CPU0
   cnsmr 3: pid 155736 on node 0/1/CPU0
   cnsmr 4: pid 155736 on node 0/0/CPU0
   cnsmr 5: pid 86099 on node 0/3/CPU0
  table 0xe0000004: 6 members, dnld act: 0, messages: 11, bytes: 2196
   cnsmr 0: pid 217223 on node 0/5/CPU0
   cnsmr 1: pid 86097 on node 0/2/CPU0
   cnsmr 2: pid 163921 on node 0/4/CPU0
   cnsmr 3: pid 155736 on node 0/1/CPU0
   cnsmr 4: pid 155736 on node 0/0/CPU0
   cnsmr 5: pid 86099 on node 0/3/CPU0
  table 0xe0000003: 6 members, dnld act: 0, messages: 11, bytes: 2196
   cnsmr 0: pid 217223 on node 0/5/CPU0
   cnsmr 1: pid 86097 on node 0/2/CPU0
   cnsmr 2: pid 163921 on node 0/4/CPU0
   cnsmr 3: pid 155736 on node 0/1/CPU0
   cnsmr 4: pid 155736 on node 0/0/CPU0
   cnsmr 5: pid 86099 on node 0/3/CPU0
  table 0xe0000002: 6 members, dnld act: 0, messages: 14, bytes: 3304
   cnsmr 0: pid 217223 on node 0/5/CPU0
   cnsmr 1: pid 86097 on node 0/2/CPU0
   cnsmr 2: pid 163921 on node 0/4/CPU0
   cnsmr 3: pid 155736 on node 0/1/CPU0
   cnsmr 4: pid 155736 on node 0/0/CPU0
   cnsmr 5: pid 86099 on node 0/3/CPU0
  table 0xe0000001: 6 members, dnld act: 0, messages: 15, bytes: 3460
   cnsmr 0: pid 217223 on node 0/5/CPU0
   cnsmr 1: pid 86097 on node 0/2/CPU0
   cnsmr 2: pid 163921 on node 0/4/CPU0
   cnsmr 3: pid 155736 on node 0/1/CPU0
   cnsmr 4: pid 155736 on node 0/0/CPU0
   cnsmr 5: pid 86099 on node 0/3/CPU0
  table 0xe0000000: 6 members, dnld act: 0, messages: 295, bytes: 74844
   cnsmr 0: pid 217223 on node 0/5/CPU0
   cnsmr 1: pid 86097 on node 0/2/CPU0
   cnsmr 2: pid 163921 on node 0/4/CPU0
   cnsmr 3: pid 155736 on node 0/1/CPU0
   cnsmr 4: pid 155736 on node 0/0/CPU0
   cnsmr 5: pid 86099 on node 0/3/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

Task ID

Task ID

Operations

sysmgr

read

Examples

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


RP/0/5/CPU0:router# show bcdl trace ipv4_rib location 0/4/cpu0

Sun May 31 16:17:23.948 PST
355 wrapping entries (4096 possible, 39 filtered, 355 total)
May 12 01:48:27.151 bcdl/c/ipv4_rib 0/4/CPU0 t4  LE 
  bcdl_join_internal: timer_create ret 0, id is 15
May 12 01:48:28.227 bcdl/c/ipv4_rib 0/4/CPU0 t6  LE 
  bcdl_join_internal: group_lookup bcdl_ipv4_rib returned gid 2052
May 12 01:48:28.267 bcdl/c/ipv4_rib 0/4/CPU0 t6  LE 
  join hwg 2052 returns 0
May 12 01:48:28.293 bcdl/c/ipv4_rib 0/4/CPU0 t6  LE 
  bcdl_join_internal: joined group bcdl_ipv4_rib, member count 4
May 12 01:48:29.292 bcdl/c/ipv4_rib 0/4/CPU0 t6  LE 
  rcv gsp mtype 3: connection init sg 2 cur_seq 0 
  lwg_gid 2079 table tag 0x00000000 resend state yes
May 12 01:48:29.293 bcdl/c/ipv4_rib 0/4/CPU0 t6  LE 
  pc ring high water 0 -> 1, 0 bytes
May 12 01:48:32.202 bcdl/c/ipv4_rib 0/4/CPU0 t4  LE 
  c_h deliver msg_id 22 connection init, table event 
  0 table tag 0x00000000
May 12 01:48:32.202 bcdl/c/ipv4_rib 0/4/CPU0 t4  LE 
  conn init, seq 64206 -> 0, sg 65534 -> 2, gid 2052, 
  lwg gid -1 -> 2079
May 12 01:48:32.202 bcdl/c/ipv4_rib 0/4/CPU0 t4  LE  
  trace instance 1 valid_msg_id 0 -> 0
May 12 01:48:32.202 bcdl/c/ipv4_rib 0/4/CPU0 t4  LE 
  drained and released 0 messages.
May 12 01:48:32.202 bcdl/c/ipv4_rib 0/4/CPU0 t4  LE 
  pid: 163921, nid: 4 send_message_depth: 0 messages, 
  0 bytes, critical: 0
May 12 01:48:32.268 bcdl/c/ipv4_rib 0/4/CPU0 t4  LE 
  join lwg 2079 returns 0
May 12 01:48:32.270 bcdl/c/ipv4_rib 0/4/CPU0 t4  LG 
  pid:163921 nid:4 libbcdl sending grpsnd msg_id 22 
  reply to gid 2052, agent (g,n,p) 2052,0/5/CPU0,221388
 ...