mtrace v2 ipv6
Use mtrace v2 ipv6 to trace an IPv6 multicast path through mtrace2.
Syntax
mtrace v2 ipv6 [ vpn-instance vpn-instance-name ] { source-address | group-address } * [ destination address | port number | wait-time time | max-hop count ] * [ verbose ]
Views
Any view
Predefined user roles
network-admin
mdc-admin
Parameters
vpn-instance vpn-instance-name: Specifies an MPLS L3VPN instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify a VPN instance, this command traces an IPv6 multicast path on the public network.
source-address: Specifies an IPv6 multicast source by its IPv6 address.
group-address: Specifies an IPv6 multicast group by its IPv6 address. The value range for this argument is FFxy::/16 (excluding FFx1::/16 and FFx2::/16), where "x" and "y" represent any hexadecimal numbers from 0 to F.
destination address: Specifies the destination address of IPv6 mtrace. The default destination address is FF02::2.
port number: Specifies a UDP port number for IPv6 mtrace, in the range of 1024 to 49151. The default value is 10240.
wait-time time: Specifies the length of time that the client waits for a Reply message. The value range for the time argument is 1 to 65535 seconds and the default value is 10 seconds. If the client does not receive a Reply message within the waiting time, the client initiates a hop-by-hop IPv6 mtrace.
max-hop count: Specifies the maximum number of the hops to be traced. The value range for the count argument is 1 to 255 and the default value is 255. If the maximum number of hops is reached on a device, the device directly sends a Reply message to the client and the mtrace is terminated.
verbose: Displays detailed information about IPv6 mtrace. If you do not specify this keyword, the command displays brief information about IPv6 mtrace.
Usage guidelines
To perform a non-group-specific mtrace, specify an IPv6 multicast source and a destination. The mtrace starts from the destination and ends at the device directly connected to the source.
To perform a non-source-specific mtrace, specify an IPv6 multicast group and a destination. The mtrace starts from the destination and ends at the RP associated with the group.
To perform a source-and-group-specific mtrace, specify both an IPv6 multicast source and an IPv6 multicast group. If you also specify a destination, the mtrace starts from the destination and ends at the device directly connected to the source. If you do not specify a destination, the mtrace starts from the upstream device of the client and ends at the device directly connected to the source.
An IPv6 mtrace process stops if the maximum number of the hops to be traced is reached.
If the client does not receive a Reply message within the waiting time, the client initiates a hop-by-hop mtrace to determine which device on the path encountered an error. It sends a Query message with the hops field set to 1 and waits for a Reply message. If the client receives a Reply message within the waiting time, it sends a Query message with the hops field value increased by 1 and waits for a Reply message. This process continues until the client does not receive a Reply message within the waiting time any more.
Examples
# Use mtrace2 to trace the path along which IPv6 multicast data of group FF1E::1 travels from source 10::7 to destination 50::5 and display brief mtrace information.
<Sysname> mtrace v2 ipv6 10::7 ff1e::1 destination 50::5 Mtrace from 10::7 to 50::5 via group ff1e::1, 255 hops at most, press CTRL_C to break. Querying full reverse path... Hop Local address Protocol Time Fwd code 0 50::1 PIM-SM(OSPF) 50 s NO_ERROR -1 40::1 PIM-SM(OSPF) 40 s NO_ERROR -2 30::1 PIM-SM(OSPF) 60 s NO_ERROR -3 20::1 PIM-SM(OSPF) 55 s NO_ERROR -4 10::1 PIM-SM(OSPF) 30 s NO_ERROR
Table 108: Command output
Field | Description |
---|---|
Hop | Number of the hop. 0 represents the last hop, -1 represents the hop before the last hop, and so on. |
Local address | IPv6 address of this hop on the traced path. |
Protocol | Multicast routing protocol used between this device and the previous-hop device:
Unicast routing protocol used between this device and the previous-hop device:
|
Time | Length of time used to transmit an mtrace message between this device and the previous-hop device, in seconds. |
Fwd code | Forwarding code or error code:
|
# Use mtrace2 to trace the path along which IPv6 multicast data of group FF1E::1 travels from source 10::7 to destination 50::5 and display detailed mtrace information.
<Sysname> mtrace v2 ipv6 10::7 ff1e::1 destination 50::5 verbose Mtrace from 10::7 to 50::5 via group ff1e::1, 255 hops at most, use query ID 12345, client port 50001, press CTRL_C to break. Querying full reverse path... 0: Incoming interface ID: 1501 Outgoing interface ID: 1502 Local address: 50::1 Remote address: FE80::A27B:99FF:FECB:207 Input multicast packets: 111 Output multicast packets: 111 Forwarded packets for the (S, G) pair: 22 Multicast protocol in use: PIM-SM Unicast protocol in use: OSPF Forwarding code: NO_ERROR Time used (s): 50 -1: Incoming interface ID: 1601 Outgoing interface ID: 1602 Local address: 40::1 Remote address: FE80::A27B:99FF:FECB:206 Input multicast packets: 111 Output multicast packets: 111 Forwarded packets for the (S, G) pair: 22 Multicast protocol in use: PIM-SM Unicast protocol in use: OSPF Forwarding code: NO_ERROR Time used (s): 50
Table 109: Command output
Field | Description |
---|---|
n | Number of the hop. 0 represents the last hop, -1 represents the hop before the last hop, and so on. |
Incoming interface ID | Index of the incoming interface of the IPv6 multicast data. |
Outgoing interface ID | Index of the outgoing interface of the IPv6 multicast data. |
Local address | IPv6 address of this hop on the traced path. |
Remote address | IPv6 address of the upstream device. |
Input multicast packets | Statistics of packets received on the incoming interface of the IPv6 multicast data. |
Output multicast packets | Statistics of packets forwarded through the outgoing interface of the IPv6 multicast data. |
Forwarded packets for the (S, G) pair | Statistics of forwarded (S, G) packets. |
Multicast protocol in use | Multicast routing protocol running on the incoming interface of the multicast data. |
Unicast protocol in use | Unicast routing protocol running on the incoming interface of the multicast data. |
Forwarding code | Forwarding code or error code:
|
Time used (s) | Length of time for transmitting the mtrace message from the previous-hop device to this device. |
Related commands
ipv6 mtrace-service port