Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Command Reference, Release 4.3.x
Multicast Commands
Downloads: This chapterpdf (PDF - 1.38MB) The complete bookPDF (PDF - 4.57MB) | Feedback

Multicast Commands

Multicast Commands

This module describes the Cisco IOS XR software commands used to configure the Multicast commands for Broadband Network Gateway (BNG) on the Cisco ASR 9000 Series Router. For details regarding the related configurations, refer to the Cisco ASR 9000 Series Aggregation Services Router Broadband Network Gateway Configuration Guide.

router igmp vrf

To configure route-policy to be used to map the bandwidth profile, use the router igmp vrf command in the global configuration mode. To disable this feature, use the no form of this command.

router igmp vrf vrf_name { traffic | profile | profile_name }

no router igmp vrf vrf_name { traffic | profile | profile_name }

Syntax Description

vrf_name

Specifies the VRF name.

traffic

Configures IGMP traffic variables.

profile

Configures route-policy to be used to map the bandwidth profile.

profile_name

Specifies the profile name.

Command Default

None

Command Modes

Global configuration mode

Command History

Release Modification

Release 4.2.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 Operation

multicast

read, write

Examples

This is an example of configuring the router igmp vrf command in the global configuration mode:

RP/0/RSP0/CPU0:router # configure
RP/0/RSP0/CPU0:router(config)# router igmp vrf vrf1
RP/0/RSP0/CPU0:router(config)# router igmp vrf vrf1 traffic profile prof-name

igmp accounting

To enable accounting feature under igmp, use the igmp accounting command in the global configuration mode. To disable this feature, use the no form of this command.

igmp accounting { max-history | number_of_days }

no igmp accounting { max-history | number_of_days }

Syntax Description

max-history

Sets the maximum history for the accounting in days.

number_of_days

Specifies the number of days the history has to be retained. This value ranged from 1 to 365.

Command Default

If max-history is not specified, then the default is 0 days, which indicates that there was no history saved.

Command Modes

Global configuration mode

Command History

Release Modification

Release 4.2.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 Operation

multicast

read, write

Examples

This is an example of configuring the igmp accounting command in the global configuration mode:

RP/0/RSP0/CPU0:router # configure
RP/0/RSP0/CPU0:router(config)# router igmp accounting max-history 67

igmp explicit-tracking

To configure explicit host tracking under Internet Group Management Protocol (IGMP) Version 3, use the igmp explicit-tracking command in the dynamic-template configuration mode. To disable explicit host tracking, use the no form of this command.

igmp explicit-tracking access_list_name

no igmp explicit-tracking

Syntax Description

access_list_name

Specifies the access list tracking group range.

Command Default

None

Command Modes

Dynamic template configuration mode

Command History

Release Modification

Release 4.2.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.

Use the dynamic-template type ppp command to enter dynamic template type ppp configuration mode.

Task ID

Task ID Operation

multicast

read, write

Examples

This is an example of configuring the igmp explicit-tracking command in the dynamic-template configuration mode:

RP/0/RSP0/CPU0:router# configure 
RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ppp foo
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# igmp explicit-tracking igmp1

Related Commands

Command

Description

igmp query-interval

Configures the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages.

unicast-qos-adjust

Configures the IGMP QOS Shaper for subscriber unicast traffic.

show igmp unicast-qos-adjust statistics

Displays the internal statistics of the unicast-qos-adjusted feature.

igmp query-max-response-time

Configures the maximum response time advertised in Internet Group Management Protocol (IGMP) queries

multicast (BNG)

Configures the mode in which the multicast components will work for subscriber sessions associated with a dynamic template.

igmp query-interval

To configure the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages, use the igmp query-interval command in the dynamic-template configuration mode. To disable this feature, use the no form of this command.

igmp query-interval seconds

no igmp query-interval

Syntax Description

seconds

Specifies the frequency used to send IGMP host-query messages and ranges between 1 to 3600.

Command Default

The default query-interval value is 60s.

Command Modes

Dynamic template configuration mode

Command History

Release Modification

Release 4.2.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.

Use the dynamic-template type ppp command to enter dynamic template type ppp configuration mode.

Task ID

Task ID Operation

multicast

read, write

Examples

This is the example of configuring the igmp query-interval command in the dynamic-template configuration mode:

RP/0/RSP0/CPU0:router# configure 
RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ppp foo
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# igmp query-interval 60

Related Commands

Command

Description

unicast-qos-adjust

Configures the IGMP QOS Shaper for subscriber unicast traffic.

igmp explicit-tracking

Configures explicit host tracking under Internet Group Management Protocol (IGMP) Version 3

igmp query-max-response-time

Configures the maximum response time advertised in Internet Group Management Protocol (IGMP) queries

multicast (BNG)

Configures the mode in which the multicast components will work for subscriber sessions associated with a dynamic template.

show igmp unicast-qos-adjust statistics

Displays the internal statistics of the unicast-qos-adjusted feature.

igmp query-max-response-time

To configure the maximum response time advertised in Internet Group Management Protocol (IGMP) queries, use the igmp query-max-response-time command in the dynamic-template configuration mode. To disable this feature, use the no form of this command.

igmp query-max-response-time seconds

no igmp query-max-response-time

Syntax Description

seconds

Specifies the maximum response time, in seconds, advertised in IGMP queries, and ranges between 1 to 12.

Command Default

The default query-max-response-time is 10 seconds.

Command Modes

Dynamic template configuration mode

Command History

Release Modification

Release 4.2.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.

Use the dynamic-template type ppp command to enter dynamic template type ppp configuration mode.

Task ID

Task ID Operation

multicast

read, write

Examples

This is the example of configuring the igmp query-max-response-time command in the dynamic-template configuration mode:

RP/0/RSP0/CPU0:router# configure 
RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ppp foo
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# igmp query-max-response-time 12

Related Commands

Command

Description

igmp query-interval

Configures the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages.

igmp explicit-tracking

Configures explicit host tracking under Internet Group Management Protocol (IGMP) Version 3

show igmp unicast-qos-adjust statistics

Displays the internal statistics of the unicast-qos-adjusted feature.

unicast-qos-adjust

Configures the IGMP QOS Shaper for subscriber unicast traffic.

multicast (BNG)

Configures the mode in which the multicast components will work for subscriber sessions associated with a dynamic template.

multicast (BNG)

To configure the mode in which the multicast components will work for subscriber sessions associated with a dynamic template, use the multicast command in the dynamic-template configuration mode. To disable this feature, use the no form of this command.

multicast[ ipv4] { qos-correlation | passive }

no multicast[ ipv4] { qos-correlation | passive }

qos-correlation

Configures multicast in a IGMP-HQOS correlation mode.

passive

Configures multicast is an passive mode.

ipv4

Optional. Specifies configuration for IPv4 address family.

Command Default

None

Command Modes

Dynamic template configuration

Command History

Release Modification

Release 4.2.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.

Use the dynamic-template type ppp command to enter dynamic template type ppp configuration mode.

Task ID

Task ID Operation

multicast

read, write

Examples

This is an example of configuring the multicast command in the dynamic-template configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# dynamic-template
RP/0/RSP0/CPU0:router(config-dynamic-template)# type ppp foo
RP/0/RSP0/CPU0:router(config-dynamic-template-type)# multicast ipv4 qos-correlation

Related Commands

Command

Description

igmp query-interval

Configures the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages.

unicast-qos-adjust

Configures the IGMP QOS Shaper for subscriber unicast traffic.

igmp explicit-tracking

Configures explicit host tracking under Internet Group Management Protocol (IGMP) Version 3

igmp query-max-response-time

Configures the maximum response time advertised in Internet Group Management Protocol (IGMP) queries

show igmp unicast-qos-adjust statistics

Displays the internal statistics of the unicast-qos-adjusted feature.

unicast-qos-adjust

To configure the IGMP QOS Shaper for subscriber unicast traffic, use the unicast-qos-adjust command in the IGMP configuration mode. To disable this feature, use the no form of this command.

unicast-qos-adjust { adjustment-delay | download-interval | holdoff }

no unicast-qos-adjust

Syntax Description

adjustment-delay

Configures the time to wait before programming rate in QOS.

download-interval

Configures the time before downloading a batch of interfaces to QOS.

holdoff

Configures the hold-off time before QOS clears the stale entries.

Command Default

None

Command Modes

IGMP configuration mode

Command History

Release Modification

Release 4.2.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.

Use the dynamic-template type ppp command to enter dynamic template type ppp configuration mode.

Task ID

Task ID Operation

multicast

read, write

Examples

This is an example of configuring the unicast-qos-adjust command in the IGMP configuration mode:

RP/0/RSP0/CPU0:router# configure
RP/0/RSP0/CPU0:router(config)# router igmp
RP/0/RSP0/CPU0:router(config-igmp)# unicast-qos-adjust

Related Commands

Command

Description

igmp query-interval

Configures the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages.

igmp explicit-tracking

Configures explicit host tracking under Internet Group Management Protocol (IGMP) Version 3.

show igmp unicast-qos-adjust statistics

Displays the internal statistics of the unicast-qos-adjusted feature.

igmp query-max-response-time

Configures the maximum response time advertised in Internet Group Management Protocol (IGMP) queries.

multicast (BNG)

Configures the mode in which the multicast components will work for subscriber sessions associated with a dynamic template.

show igmp unicast-qos-adjust statistics

To show the statistics of the unicast-qos-adjusted feature, use the show igmp unicast-qos-adjust statistics command in the EXEC mode.

show igmp unicast-qos-adjust statistics[ interface type interface-path-id ]

Syntax Description

interface

(Optional). Displays the interface specific information such as name of the interface, number of flows adjusted, total rate adjusted, and uptime after first adjustment, in a tabular format. If the interface is specified, then the interface specific statistics are displayed with table of 5 latest updates.

|

Specifies the output modifiers.

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 4.2.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 Operation

multicast

read

Examples

This is the sample output of the show igmp unicast-qos-adjust statistics command:

RP/0/RSP0/CPU0:router# show igmp unicast-qos-adjust statistics

The show igmp unicast-qos-adjust statistics output is as follows:

Mon Feb  4 08:47:01.640 GMT

IGMP to QoS Batch stats
Current Queue count                           : 0
Last IGMP-to-QOS Batch count                  : 0
Last IGMP-to-QOS Batch errors                 : 0
Interfaces added to queue(all batches)        : 0
Interfaces removed from queue(all batches)    : 0

IGMP to QoS message send stats
Number of Send Success                        : 1
Number of Send Error COMMS                    : 0
Number of Send Error Partial                  : 0
Time elapsed since last download              : 3w0d

Resync stats
Is RESYNC required                            : No
Is RESYNC REQUEST received                    : No
Is RESYNC START message sent                  : No
Has Mark&Sweep happened anytime               : Yes
Time elapsed since last mark and sweep        : 3w0d

This table describes the significant fields shown in the display.

Table 1 show igmp unicast-qos-adjust statistics Field Descriptions

Field

Description

IGMP to QoS Batch stats

Specifies the batch statistics details for IGMP to QoS, such as current queue count, batch counter, batch errors, number of interfaces added to the queue, and the number of interfaces removed from the queue.

IGMP to QoS message send stats

Specifies the send statistics details for IGMP to QoS, such as number of send messages that was successful, number of send messages that had errored, number of send messages that had partially errored, and time elapsed since the last download.

Resync stats

Specifies the detailed information on the resynchronization statistics, such as whether resync is required, if the resync request was received, if the resync start message was sent, if mark and sweep for the resync has taken place, and time elapsed since the last mark and sweep.

Related Commands

Command

Description

igmp query-interval

Configures the frequency at which the Cisco IOS XR Software sends Internet Group Management Protocol (IGMP) host-query messages.

unicast-qos-adjust

Configures the IGMP QOS Shaper for subscriber unicast traffic.

igmp explicit-tracking

Configures explicit host tracking under Internet Group Management Protocol (IGMP) Version 3

igmp query-max-response-time

Configures the maximum response time advertised in Internet Group Management Protocol (IGMP) queries

multicast (BNG)

Configures the mode in which the multicast components will work for subscriber sessions associated with a dynamic template.

show igmp vrf (BNG)

To show the igmp vrf specific information, use the show igmp vrf command in the EXEC mode.

show igmp vrf vrf_name { groups | interface | nsf | ranges | ssm | summary | traffic | unicast-qos-adjusted }

Syntax Description

vrf

Shows the vrf information for igmp unicast qos shaper.

vrf_name

Specifies the vrf name.

groups

Shows the igmp group membership information.

interface

Shows igmp interface information.

nsf

Shows igmp nsf status.

ranges

Shows igmp group-map ranges.

ssm

Shows ssm related information.

summary

Shows igmp summary information.

traffic

Show igmp traffic counters.

unicast-qos-adjusted

Shows igmp unicast qos shaper.

Command Default

None

Command Modes

EXEC

Command History

Release Modification

Release 4.2.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 Operation

multicast

read

Examples

This is the sample output of the show igmp vrf command:

RP/0/RSP0/CPU0:router#show igmp vrf vrf1 summary

The show igmp vrf vrf1 summary output is as follows:

Thu Feb  7 10:02:24.457 GMT
Robustness Value 2
No. of Group x Interfaces 10
Maximum number of Group x Interfaces 50000

Supported Interfaces   : 2
Unsupported Interfaces : 0
Enabled Interfaces     : 2
Disabled Interfaces    : 0

MTE tuple count        : 0

Interface                       Number  Max #
                                          Groups  Groups
BVI1                                       7       10
Loopback1001                    3       25000

RP/0/RSP0/CPU0:router#show igmp vrf vrf1 interface bvi1

Thu Feb  7 10:02:48.231 GMT

BVI1 is up, line protocol is up
  Internet address is 172.16.251.1/30
  IGMP is enabled on interface
  Current IGMP version is 3
  IGMP query interval is 60 seconds
  IGMP querier timeout is 125 seconds
  IGMP max query response time is 10 seconds
  Last member query response interval is 1 seconds
  IGMP activity: 26 joins, 19 leaves
  IGMP querying router is 172.16.251.1 (this system)
  Time elapsed since last query sent 00:00:41
  Time elapsed since IGMP router enabled 3w3d
  Time elapsed since last report received 00:00:32

This table describes the significant fields shown in the display.

Table 2 show igmp vrf Field Descriptions

Field

Description

Supported Interfaces

Specifies the number of supported interfaces.

Unsupported Interfaces

Specifies the number of unsupported interfaces.

Enabled Interfaces

Specifies the number of interfaces that are enabled.

Disabled Interfaces

Specifies the number of interfaces that are disabled.

clear igmp unicast-qos-adjust

To clear IGMP unicast rate adjustment database, use the clear igmp unicast-qos-adjust command in the EXEC mode.

clear igmp unicast-qos-adjust { rate | statistics } interface { type | interface_path_id }

Syntax Description

rate

Specifies the rate programmed in QoS.

statistics

Specifies the unicast rate adjustment statistics.

interface

Specifies the interface specific rate.

type

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

interface-path-id

Either a physical interface instance or a virtual interface instance as follows:

  • Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.
    • rack: Chassis number of the rack.
    • slot: Physical slot number of the modular services card or line card.
    • module: Module number. A physical layer interface module (PLIM) is always 0.
    • port: Physical port number of the interface.
    Note   

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

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

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

Command Default

Clears all unicast qos adjust parameters.

Command Modes

EXEC

Command History

Release Modification

Release 4.2.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 the proper task IDs. If you suspect user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

multicast

exec

Examples

This is an example of using the clear igmp unicast-qos-adjust command:


RP/0/RSP0/CPU0:router# clear igmp unicast-qos-adjust rate interface Loopback 1