11.4. Troubleshooting Configuration Command Reference

11.4.1. Command Hierarchies

  1. Operational Commands

11.4.1.1. Operational Commands

<GLOBAL>

— mrinfo {ip-address | dns-name} [router router-instance | service-name service-name]
— mstat source [ip-address | dns-name] group {ip-address | dns-name} [destination ip-address | dns-name] [hop hop] [router router-instance | service-name service-name] [wait-time wait-time]
— mtrace source [ip-address | dns-name] group {ip-address | dns-name} [destination ip-address | dns-name] [hop hop] [router router-instance | service-name service-name] [wait-time wait-time]

11.4.2. Command Descriptions

11.4.2.1. Operational Commands

mrinfo

Syntax 
mrinfo {ip-address | dns-name} [router router-instance | service-name service-name]
Context 
<global>
Description 

This command is used to print relevant multicast information from the target multicast router. Information displayed includes adjacency information, protocol, metrics, thresholds, and flags from the target multicast route.

Parameters 
ip-address—
Specifies the IP address of the multicast-capable target router.
Values—
ipv4 unicast address (a.b.c.d)

 

dns-name—
Specifies the DNS name (if DNS name resolution is configured). 63 characters maximum.
router-instance—
Specifies the router name or service ID for the router instance.
Values—
router-name: Base
vprn-service-id: 1 to 2147483647

 

Default—
Base
service-name—
Specifies the service name up to 64 characters in length.
Output 
Table 36:  Mrinfo Output Fields 

Label

Description

General flags

version

Indicates software version on queried router.

prune

Indicates that router understands pruning.

genid

Indicates that router sends generation IDs.

mtrace

Indicates that the router handles mtrace requests.

Neighbors flags

1

Metric

0

Threshold (multicast time-to-live)

pim

PIM enabled on interface.

down

Operational status of interface.

disabled

Administrative status of interface.

leaf

No downstream neighbors on interface.

querier

Interface is IGMP querier.

tunnel

Neighbor reached via tunnel.

Output Sample
A:dut-f# mrinfo 10.1.1.2
 
10.1.1.2  [version 3.0,prune,genid,mtrace]:
  10.1.1.2 -> 10.1.1.1 [1/0/pim]
  16.1.1.1 -> 0.0.0.0 [1/0/pim/down/disabled]
  17.1.1.1 -> 0.0.0.0 [1/0/pim/querier/leaf]
  200.200.200.3 -> 200.200.200.5 [1/0/tunnel/pim]... 

mstat

Syntax 
mstat source [ip-address | dns-name] group {ip-address | dns-name} [destination ip-address | dns-name] [hop hop] [router router-instance | service-name service-name] [wait-time wait-time]
Context 
<global>
Description 

This command traces a multicast path from a source to a receiver and displays multicast packet rate and loss information.

Parameters 
source ip-address—
Specifies the ip-address of the multicast capable target router.
Values—
ipv4 address (a.b.c.d)

 

dns-name—
Specifies the DNS name (if DNS name resolution is configured). 63 characters maximum.
group ip-address—
Specifies the multicast address or DNS name of the group that resolves to the multicast group address that will be used. If the group is not specified, address 224.2.0.1 (the MBone audio) will be used. This will suffice if packet loss statistics for a particular multicast group are not needed.
destination ip-address—
Specifies either the IP address or the DNS name of the unicast destination. If this parameter is omitted the IP address of the system where the command is entered will be used. The receiver parameter can also be used to specify a local interface address as the destination address for sending the trace query. The response will also be returned to the address specified as the receiver.
hop—
Specifies the maximum number of hops that will be traced from the receiver back toward the source.
Values—
1 to 255

 

Default—
32 hops (infinity for the DVMRP routing protocol)
router-instance—
Specifies the router name or service ID used to identify the router instance.
Values—

router-name:

Base

service-id:

1 to 2147483647

 

Default—
Base
service-name —
Specifies the service name up to 64 characters in length.
wait-time—
Specifies the number of seconds to wait for the response.
Values—
1 to 60

 

Output 
Table 37:  Mstat Output Fields 

Label

Description

hop

Number of hops from the source to the listed router.

router name

Name of the router for this hop or “?” when not reverse DNS translated.

address

Address of the router for this hop.

protocol

Protocol used.

ttl

Forward TTL threshold. TTL that a packet is required to have before it will be forwarded over the outgoing interface.

forwarding code

Forwarding information/error code for this hop.

For each interface between two nodes a line is printed, following the same layout as other routers with an implementation derived from mrouted. Consider the following:

  1. The forwarding information/error code is only displayed when different from “No Error”.
  2. “?” means there is no reverse DNS translation.
  3. There is no “Overall Mcast Pkt Rate” available in the PE for the VPRN case.
Output Sample
  Source          Response Dest     Overall        Packet Statistics for Traffic From
10.10.16.9        10.20.1.6        Mcast Pkt       10.10.16.9 to 224.5.6.7
     |         __/  rtt   29 ms      Rate          Lost/Sent = Pct Rate
     v        /                    ---------       --------------------
10.10.16.3
10.10.2.3         ?
     |       ^      ttl   2          1pps             0/0   = --     0 pps
     v       |
10.10.2.1
10.10.1.1         ?
     |       ^      ttl   3          1pps             0/0   = --     0 pps
     v       |
10.10.1.2
10.10.4.2         ?             Reached RP/Core
     |       ^      ttl   4          1pps             0/0   = --     0 pps
     v       |
10.10.4.4
10.10.6.4         ?
     |       ^      ttl   5          1pps             0/0   = --     0 pps
     v       |
10.10.6.5
10.10.10.5        ?
     |       \__    ttl   6          1pps             0/0   = --     0 pps
     v          \
10.10.10.6       10.20.1.6
Receiver         Query Source

mtrace

Syntax 
mtrace source [ip-address | dns-name] group {ip-address | dns-name} [destination ip-address | dns-name] [hop hop] [router router-instance | service-name service-name] [wait-time wait-time]
Context 
<global>
Description 

This command traces a multicast path from a source to a receiver.

Parameters 
source ip-address—
Specifies the ip-address of the multicast capable target router.
Values—
ipv4 address (a.b.c.d)

 

dns-name—
Specifies the DNS name (if DNS name resolution is configured). 63 characters maximum.
group ip-address—
Specifies the multicast address or DNS name of the group that resolves to the multicast group address that will be used. If the group is not specified, address 224.2.0.1 (the MBone audio) will be used. This will suffice if packet loss statistics for a particular multicast group are not needed.
destination ip-address—
Specifies either the IP address or the DNS name of the unicast destination. If this parameter is omitted the IP address of the system where the command is entered will be used. The receiver parameter can also be used to specify a local interface address as the destination address for sending the trace query. The response will also be returned to the address specified as the receiver.
hop—
Specifies the maximum number of hops that will be traced from the receiver back toward the source.
Values—
1 to 255

 

Default—
32 hops (infinity for the DVMRP routing protocol)
router-instance—
Specifies the router name or service ID used the identify the router instance.
Values—

router-name:

“Base”

service-id:

1 to 2147483647

 

Default—
Base
service-name—
Specifies the service name up to 64 characters in length.
wait-time—
Specifies the number of seconds to wait for the response.
Values—
1 to 60

 

Output 
Table 38:  Mtrace Output Fields  

Label

Description

hop

Number of hops from the source to the listed router.

router name

Name of the router for this hop. If a DNS name query is not successful a “?” displays.

address

Address of the router for this hop.

protocol

Protocol used.

ttl

Forward TTL threshold. TTL that a packet is required to have before it will be forwarded over the outgoing interface.

forwarding code

Forwarding information/error code for this hop.

Output Sample
A:Dut-F# mtrace source 10.10.16.9 group 224.5.6.7
 
Mtrace from 10.10.16.9 via group 224.5.6.7
Querying full reverse path...
 
 0 ? (10.10.10.6)
-1 ? (10.10.10.5) PIM thresh^ 1 No Error
-2 ? (10.10.6.4) PIM thresh^ 1 No Error
-3 ? (10.10.4.2) PIM thresh^ 1 Reached RP/Core
-4 ? (10.10.1.1) PIM thresh^ 1 No Error
-5 ? (10.10.2.3) PIM thresh^ 1 No Error
-6 ? (10.10.16.9)
 
Round trip time 29 ms; total ttl of 5 required.