12.4. Troubleshooting Configuration Command Reference

12.4.1. Command Hierarchies

  1. Operational Commands

12.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]
— mstat2 source [starg | ip-address | dns-name ] group {ip-address | dns-name} [destination ip-address | dns-name] [hop hop] [router router-instance | service-name vprn-service-name] [wait-time seconds]
— 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]
— mtrace2 source [starg | ip-address | dns-name ] group {ip-address | dns-name} [destination ip-address | dns-name] [hop hop-count] [router router-instance | service-name service-name] [wait-time wait-time]

12.4.2. Command Descriptions

12.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), up to 63 characters.
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.
Output 
Table 41:  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]
  10.1.1.3 -> 0.0.0.0 [1/0/pim/down/disabled]
  10.1.1.4 -> 0.0.0.0 [1/0/pim/querier/leaf]
  239.200.200.3 -> 239.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), up to 63 characters.
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) is 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 is also 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 42:  Mstat Output Fields 

Label

Description

hop

The number of hops from the source to the listed router.

router name

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

address

The address of the router for this hop.

protocol

The protocol used.

ttl

The forward TTL threshold. TTL that a packet is required to have before it is 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 239.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

mstat2

Syntax 
mstat2 source [ip-address | dns-name | starg] group {ip-address | dns-name} [destination ip-address | dns-name] [hop hop] [router router-instance | service-name vprn-service-name] [wait-time seconds]
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-prefix:
  1. a.b.c.d
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D

 

dns-name—
Specifies the DNS name (if DNS name resolution is configured), up to 63 characters.
starg—
Specifies a static (*,G) entry. This command can only be enabled if no existing source addresses for this source is specified.
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) is used. This will suffice if packet loss statistics for a particular multicast group are not needed.
Values—
ipv4-prefix:
  1. a.b.c.d
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D

 

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 is also returned to the address specified as the receiver.
Values—
ipv4-prefix:
  1. a.b.c.d
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D

 

hop—
Specifies the maximum number of hops that are traced from the receiver back toward the source.
Values—
1 to 255

 

Default—
32
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
vprn-service-name —
Specifies the service name, up to 64 characters.
seconds—
Specifies the number of seconds to wait for the response.
Values—
1 to 60

 

Default—
3
Output 
Table 43:  Mstat2 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
*A:Dut-A# mstat2 group 239.225.6.1 source 10.0.1.66
Mtrace2 from 150.0.1.66 via group 225.6.6.1 Querying full reverse path...
Waiting to accumulate statistics...Results after 10 seconds:
 Source        Response Dest    Overall     Packet Statistics For 
Traffic From
10.0.1.66      10.0.0.1         Mcast Pkt    10.10.1.66 To 239.5.6.7
      |       __/  rtt 24.0ms     Rate       Lost/Sent = Pct  Rate
      v      /                    -------     ---------------------
10.0.1.6
10.0.1.6       ?
      |     ^      ttl    2        10 pps        0/100  =  0%   10 pps
      v     |
10.0.1.4
10.10.4.4       usilhc03-hb2.ndc.lucent.com Reached RP/Core
      |     ^      ttl    3        10 pps        0/100  =  0%   10 pps
      v     |
10.10.4.2
10.0.1.2       10.1.0.110.ap.yournet.ne.jp
      |      \__   ttl    4        10 pps        0/100  =  0%   10 pps
      v         \
10.0.1.1       10.0.0.1
   Receiver      Query Source
 
*A:Dut-A# mstat2  group ff05::225:6:6:1 source 3ffe::150:0:1:66
Mtrace2 from source
<S> = 3ffe::150:0:1:66
via group
<G> = ff05::225:6:6:1
Querying full reverse path...
Waiting to accumulate statistics...Results after 10 seconds:
Destination <D> = 3ffe::120:0:1:1
Response Destination <RD> = 3ffe::1
   Source        Response Dest    Overall     Packet Statistics For 
Traffic From
<S>             <RD>            Mcast Pkt    Source <S> To Group <G>
      |       __/  rtt 23.0ms     Rate       Lost/Sent = Pct  Rate
      v      /                    -------     ---------------------
Remote Address ::
Incoming IF 4
3ffe::6 ?
Outgoing IF 3
      |     ^      ttl    2        20 pps        0/100  =  0%   10 pps
      v     |
Remote Address fe80::a248:1ff:fe01:2
Incoming IF 2
3ffe::5 ? Reached RP/Core
Outgoing IF 3
      |     ^      ttl    3        20 pps        0/100  =  0%   10 pps
      v     |
Remote Address fe80::a246:1ff:fe01:1
Incoming IF 3
3ffe::3 ?
Outgoing IF 2
      |      \__   ttl    4        30 pps        0/100  =  0%   10 pps
      v         \
<D>             <RD>
   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.
wait-time—
Specifies the time, in seconds, to wait for the response.
Values—
1 to 60

 

Output 
Table 44:  Mtrace Output Fields  

Label

Description

hop

The number of hops from the source to the listed router.

router name

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

address

The address of the router for this hop

protocol

The protocol used

ttl

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

forwarding code

The forwarding information/error code for this hop

Output Sample
A:Dut-F# mtrace source 10.10.16.9 group 239.5.6.7
 
Mtrace from 10.10.16.9 via group 239.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.

mtrace2

Syntax 
mtrace2 source [ip-address | dns-name | starg] group {ip-address | dns-name} [destination ip-address | dns-name] [hop hop-count] [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-prefix:
  1. a.b.c.d
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D

 

dns-name—
Specifies the DNS name (if DNS name resolution is configured), up to 63 characters.
starg—
Specifies a static (*,G) entry. This command can only be enabled if no existing source addresses for this source is specified.
group ip-address—
Specifies the multicast address or DNS name of the group that resolves to the multicast group address that is used. If the group is not specified, address 224.2.0.1 (the MBone audio) is used. This suffices if packet loss statistics for a particular multicast group are not needed.
Values—
ipv4-prefix:
  1. a.b.c.d
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D

 

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 is 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 is returned to the address specified as the receiver.
Values—
ipv4-prefix:
  1. a.b.c.d
ipv6-address:
  1. x:x:x:x:x:x:x:x (eight 16-bit pieces)
  2. x:x:x:x:x:x:d.d.d.d
  3. x: [0 to FFFF]H
  4. d: [0 to 255]D

 

hop-count—
Specifies the maximum number of hops that are 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.
wait-time—
Specifies the number of seconds to wait for the response.
Values—
1 to 60

 

Output 
Table 45:  Mtrace2 Output Fields  

Label

Description

hop

The number of hops from the source to the listed router

router name

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

address

The address of the router for this hop

protocol

The protocol used

ttl

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

forwarding code

The forwarding information/error code for this hop

Output Sample
*A:Dut-A# mtrace2 group 239.225.6.1 source 192.0.1.66
Mtrace2 from 192.0.1.66 via group 239.225.6.1 Querying full reverse path...
   0  1.1.0.110.ap.yournet.ne.jp (110.0.1.1)
  -1  2.1.0.110.ap.yournet.ne.jp (110.0.1.2)  rtg=ospf mrtg=pimSparseMode  thresh^ 1
  No Error
  -2  usilhc03-hb2.ndc.lucent.com(10.10.4.4)rtg=ospf mrtg=pimSparseMode thresh^ 1 Reached RP/ Core
  -3  ? (10.0.1.6)  rtg=local mrtg=pimSparseMode  thresh^ 1  No Error
  -4  ? (10.0.1.66)
Round trip time 23.3 ms; total ttl of 3 required.
 
*A:Dut-A# mtrace2 group ff05::225:2:6:1 source 3ffe::255:0:1:66
Mtrace2 from source
<S> = 3ffe::255:0:1:66
via group
<G> = ff05::225:6:6:1
Querying full reverse path...
   0  ? (3ffe::120:0:1:1)
  -1  ? (3ffe::3)  IIF=3 OIF=2  rtg=ospf mrtg=pimSparseMode thresh^ N/A No Error
  -2  ? (3ffe::5)  IIF=2 OIF=3  rtg=ospf mrtg=pimSparseMode thresh^ N/A Reached RP/
Core
  -3  ? (3ffe::6)  IIF=4 OIF=3  rtg=local mrtg=pimSparseMode thresh^ N/A  No Error
  -4  ? (3ffe::150:0:1:66)
Round trip time 46.5 ms; total ttl of 3 required.