Troubleshooting Configuration Command Reference

Command Hierarchies

Operational Commands

<GLOBAL>

mrinfo ip-address [router router-name | service]
mstat source ip-address [group grp-ip-address] [destination dst-ip-address] [hop hop] [router router-name | service] [wait-time wait-time]
mtrace source ip-address [group grp-ip-address][destination dst-ip-address] [hop hop] [router router-name | service] [wait-time wait-time]

Command Descriptions

Operational Commands

mrinfo

Syntax 
mrinfo ip-address [router router-name | service]
Context 
<GLOBAL>
Description 

This command is used to display relevant multicast information from the target multicast router. Information displayed includes adjacency information, protocol, metrics, thresholds, and flags from the target multicast router. This information can be used by network operators to determine whether bi-directional adjacencies exist.

Parameters 
ip-address—
Specify the IP address of the multicast capable target router should be entered.
router router-name
Specify the router instance that this command applies to.
Values—
management Base
service—
Specify the service instance that this command applies to.
Values—
1 to 2147483647
Output 
Table 27:  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 group grp-ip-address [destination dst-ip-address] [hop hop] [router router-name |service] [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. The mstat command adds the capability to show the multicast path in a limited graphic display and provide drops, duplicates, TTLs, and delays at each node. This information is useful to network operators because it identifies nodes with high drop and duplicate counts. Duplicate counts are shown as negative drops.

Parameters 
source ip-address
Specify the IP address of the multicast-capable source. This is a unicast address of the beginning of the path to be traced.
group group-ip-address
Specify the multicast address that will be used.
destination dst-ip-address
Specify the IP address of the unicast destination. If this parameter is omitted, the IP address of the system where the command is entered is used. The destination parameter can also be used to specify a local interface address as the destination address to send the trace query.
Values—
The default address for the destination address is the incoming IETF format for that (S,G)
hop hop
Specify the maximum number of hops that will be traced from the receiver back toward the source.
Values—
1 to 255
Values—
32 (infinity for the DVMRP routing protocol).
router router-name
Specify the router instance that this command applies to.
service—
Specify the service instance that this command applies to.
Values—
1 to 2147483647
wait-time wait-time
Specify the number of seconds to wait for the response.
Values—
1 to 60
Values—
10
Output 
Table 28:  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 2 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 the 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 group grp-ip-address [destination dst-ip-address] [hop hop] [router router-name | service] [wait-time wait-time]
Context 
<GLOBAL>
Description 

This command traces the multicast path from a source to a receiver by passing a trace query hop-by-hop along the reverse path from the receiver to the source. At each hop, information such as the hop address, routing error conditions, and packet statistics are gathered and returned to the requester. A network administrator can determine where multicast flows stop and verify the flow of the multicast stream.

Parameters 
source ip-address
Specify the IP address of the multicast-capable source. This is a unicast address of the beginning of the path to be traced.
group group-ip-address
Specify the multicast address that will be used.
destination dst-ip-address
Specify the IP address of the unicast destination. If this parameter is omitted, the IP address of the system where the command is entered is used. The destination parameter can also be used to specify a local interface address as the destination address to send the trace query.
Values—
The default address for the destination address is the incoming IETF format for that (S,G)
hop hop
Specify the maximum number of hops that will be traced from the receiver back toward the source.
Values—
1 to 255
Values—
32 (infinity for the DVMRP routing protocol).
router router-name
Specify the router instance that this command applies to.
service—
Specify the service instance that this command applies to.
Values—
1 to 2147483647
wait-time wait-time
Specify the number of seconds to wait for the response.
Values—
1 to 60
Values—
10
Output 
Table 29:  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.