traceroute
traceroute—Display the path that packets take to reach a host or IP address on the network.
Command Syntax
traceroute interface interface-name [size bytes] [options options] (hostname | ip-address)
traceroute vpn vpn-id [interface interface-name] [size bytes] [options "options"] (hostname | ip-address)
Options
- Interface
- interface interface-name
Interface through which traceroute probe should send packets. - Network Host
- (hostname | ip-address)
Hostname or IPv4 or IPv6 address of a system on the network. - Options
- options "options"
One or more options for the traceroute probe. option can be one or more of the following. Enclose the options in quotation marks (" ").
–d: Set the SO_DEBUG options to socket.
–f first-ttl: Report the traceroute probe results starting with the specified hop in the path.
–g gateway: Add an IP source route gateway to the outgoing packet.
–I (capital letter "i"): Use ICMP echo packets instead of UDP datagrams.
–i (lowercase letter "i") interface-name: Network interface from which to obtain the source IP address for outgoing traceroute probe packets.
–m maximum-ttl: Set the maximum time-to-live value, which is the maximum number of hops.
–n: Print numeric IP addresses.
–p port: Base UDP port number to use in traceroute probes. The default port is 33434.
–q probes: Number of probes to send per TTL. The default is 3.
–r: Bypass the normal route tables, and send the traceroute probe directly to a host.
–s source-ip-address: Source IP address to use in the probe packets.
–t tos: Type-of-service value to use in the probe packets. The default is 0.
–v: Display output in verbose mode.
–w wait-time: Time, in seconds, to wait for a response. The default is 3 seconds.
–z pause-time: Time, in milliseconds, to pause between probes. The default is 0 milliseconds. - Probe Packet Size
- size bytes
Size of the traceroute probe packets, in bytes. The maximum packet size is 32,768 bytes.
- VPN
- vpn vpn-id
VPN in which the network host is located.
Output Fields
The output is self-explanatory.
Example Output
vEdge-112# traceroute vpn 1 192.168.111.30
Traceroute in vpn 1
traceroute to 192.168.111.30 (192.168.111.30), 30 hops max, 46 byte packets
1 172.23.2.2 (172.23.2.2) 0.171 ms 0.196 ms 0.126 ms
2 100.100.100.11 (100.100.100.11) 0.128 ms 0.197 ms 0.127 ms
3 100.100.100.12 (100.100.100.12) 0.165 ms 0.194 ms 0.146 ms
4 172.23.111.2 (172.23.111.2) 0.218 ms 0.227 ms 0.214 ms
5 192.168.111.30 (192.168.111.30) 1.173 ms 0.824 ms 1.239 ms
vEdge# traceroute host 10.2.3.12 size 1000 vpn 1 options "-q1 -w1 -m5" Traceroute -q1 -w1 -m5 10.2.3.12 in VPN 1 traceroute to 10.2.3.12 (10.2.3.12), 5 hops max, 1000 byte packets 1 10.20.24.15 (10.20.24.15) 0.254 ms 2 10.0.5.21 (10.0.5.21) 1.318 ms 3 10.2.3.12 (10.2.3.12) 1.310 ms
Release Information
Command introduced in Viptela Software Release 14.1.
In Release 14.2, add interface, options, size, and vpn options.
In Release 16.3, add support for IPv6 host addresses.