[Contents] [Prev] [Next] [Index] [Report an Error]

Tracing Unicast Routes from the CLI

Use the CLI traceroute command to display a list of routers between the Services Router and a specified destination host. This command is useful for diagnosing a point of failure in the path from the Services Router to the destination host, and addressing network traffic latency and throughput problems.

The Services Router generates the list of routers by sending a series of ICMP traceroute packets in which the time-to-live (TTL) value in the messages sent to each successive router is incremented by 1. (The TTL value of the first traceroute packet is set to 1.) In this manner, each router along the path to the destination host replies with a Time Exceeded packet from which the source IP address can be obtained.

Alternatively, you can use the J-Web interface. (See Tracing Unicast Routes from the J-Web Interface .)

Enter the traceroute command with the following syntax. Table 96 describes the traceroute command options.

user@host> traceroute host <interface interface-name> <as-number-lookup>
<bypass-routing> <gateway address>
<inet | inet6> <logical-router logical-router-name> <no-resolve> <routing-instance routing-instance-name>
<source source-address>
<tos number> <ttl number>
<wait seconds>

To quit the traceroute command, press Ctrl-C.

Table 96: CLI traceroute Command Options

Option	Description
host	Sends traceroute packets to the hostname or IP address you specify.
interface interface-name	(Optional) Sends the traceroute packets on the interface you specify. If you do not include this option, traceroute packets are sent on all interfaces.
as-number-lookup	(Optional) Displays the autonomous system (AS) number of each intermediate hop between the router and the destination host.
bypass-routing	(Optional) Bypasses the routing tables and sends the traceroute packets only to hosts on directly attached interfaces. If the host is not on a directly attached interface, an error message is returned. Use this option to display a route to a local system through an interface that has no route through it.
gateway address	(Optional) Uses the gateway you specify to route through.
logical-router logical-router-name	(Optional) Sends traceroute packets to this logical router.
inet	(Optional) Forces the traceroute packets to an IPv4 destination.
inet6	(Optional) Forces the traceroute packets to an IPv6 destination.
no-resolve	(Optional) Suppresses the display of the hostnames of the hops along the path.
routing-instance routing-instance-name	(Optional) Uses the routing instance you specify for the traceroute.
source address	(Optional) Uses the source address you specify in the traceroute packet.
tos number	(Optional) Sets the type-of-service (TOS) value in the IP header of the traceroute packet. Specify a value from 0 through 255.
ttl number	(Optional) Sets the time-to-live (TTL) value for the traceroute packet. Specify a hop count from 0 through 128.
wait seconds	(Optional) Sets the maximum time to wait for a response.

Following is sample output from a traceroute command:

user@host> traceroute host2

traceroute to 173.24.232.66 (172.24.230.41), 30 hops max, 40 byte packets
 1  173.18.42.253 (173.18.42.253)  0.482 ms  0.346 ms  0.318 ms
 2  host4.site1.net (173.18.253.5)  0.401 ms  0.435 ms  0.359 ms
 3  host5.site1.net (173.18.253.5)  0.401 ms  0.360 ms  0.357 ms
 4  173.24.232.65 (173.24.232.65)  0.420 ms  0.456 ms  0.378 ms
 5  173.24.232.66 (173.24.232.66)  0.830 ms  0.779 ms  0.834 ms

The fields in the display are the same as those displayed by the J-Web traceroute diagnostic tool. For information, see Traceroute Results and Output Summary.

[Contents] [Prev] [Next] [Index] [Report an Error]