vrouter-pim-rp-show

This command is used to display information about rendezvous points (RP)s on a PIM Sparse mode vRouter.

A rendezvous point (RP) is required only in networks running Protocol Independent Multicast sparse mode (PIM-SM).

An RP is a meeting place for sources and receivers of multicast data. In a PIM-SM network, sources must send their traffic to the RP. This traffic is then forwarded to receivers down a shared distribution tree. By default, when the first hop router of the receiver learns about the source, it sends a join message directly to the source, creating a source-based distribution tree from the source to the receiver. This source tree does not include the RP unless the RP is located within the shortest path between the source and receiver.

Syntax   vrouter-pim-rp-show vrouter-name name-string rp-address ip-address group ip-address netmask netmask

vrouter-name name-string

Specify the name of the vRouter with the PIM Sparse mode configuration.

rp-address ip-address

Specify the IP address of the rendezvous point (RP).

group ip-address

Specify the IP address of the group. The default value is 224.0.0.0.

netmask netmask

Specify the netmask of the group. The default value is 4.

Formatting Options

format fields-to-display

Display output using a specific parameter. Use all to display all possible output.

parsable-delim character

Display output formatted for machine parsing using a specified delimiter.

sort-asc

Display output in ascending order.

sort-desc

Display output in descending order.

show dups

Display duplicate entries in the output.

layout vertical|horizontal

Format the output in a vertical or horizontal layout.

show-interval seconds-interval

Repeat the show command at a specified interval.

show-headers|
no-show-headers

Display column headers or not.

limit-output number

Limit the display output to a specific number of entries.

count-output

Display the number of entries in the output. This is useful with vRouter show commands.

unscaled

Display full values in the output instead of scaled approximate values.

raw-int-values

Display integer values instead of mapped values

sum-by

Aggregate output by specific parameters. If sum-by fields are specified, records that have the same value in sum-by fields are combined and displayed as one aggregate record. NOTE: This option is only available for show commands that collect statistics such as connection-stats-show.

Defaults   None

Access   CLI

History   Command introduced in Version 2.2.5.

Usage   In the first version of PIM-SM, all leaf routers, routers directly connected to sources or receivers, were required to be manually configured with the IP address of the RP. This type of configuration is also known as static RP configuration. Configuring static RPs is relatively simple in a small network, but it can be a difficult project in a large, complex network.

Examples  To display information about RPs on a PIM Sparse mode vRouter, use the following syntax:

CLI network-admin@switch > vrouter-pim-rp-show

vrouter-name rp-address    group       

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

    vr0      172.16.21.131 224.0.0.0/4

    vr1      172.16.21.131 224.0.0.0/4

    vr2      172.16.21.131 224.0.0.0/4

See Also   

vrouter-pim-rp-add

vrouter-pim-rp-remove