Run a Traceroute Test

About this task

Run a traceroute test to determine the route packets take through a network to a destination.

Note

Note

Troubleshooting using ping and traceroute is not supported on EDM. For more information, see Fabric Engine Release Notes. As an alternative, use CLI.

Procedure

  1. From the navigation pane, expand Configuration > Serviceability > Diagnostics.
  2. Select Ping/Trace Route.
  3. Select the Trace Route Control tab.
  4. Select Insert.
  5. Configure the instance as required.
  6. Select Insert.
  7. Select an entry, and then select Start.

    Let the test run for several seconds.

  8. Select an entry, and then select Stop.
  9. View the traceroute test results.

Trace Route Control Field Descriptions

Use the data in the following table to use the Trace Route Control tab.

Name

Description

OwnerIndex

Provides access control by a security administrator using the VACM for tables in which multiple users need to independently create or modify entries.

TestName

Specifies the name of the traceroute test.

TargetAddressType

Specifies the type of host address to use on the traceroute request at the remote host. The default is IPv4.

TargetAddress

Specifies the host address used on the traceroute request at the remote host.

ByPassRouteTable

Enables bypassing of the route table. If you enable this variable, the remote host bypasses the normal routing tables and sends directly to a host on an attached network. If the host is not on a directly-attached network, an error is returned. You can use this variable to perform the traceroute operation to a local host through an interface that has no route defined. The default is disabled.

DataSize

Specifies the size of the data portion of a traceroute request in octets. The default is 1.

TimeOut

Specifies the timeout value, in seconds, for a traceroute request. The default is 3.

ProbesPerHop

Specifies the number of times to reissue a traceroute request with the same time-to-live (TTL) value. The default is 3.

Port

Specifies the UDP port to which to send the traceroute request. Specify a port that is not in use at the destination (target) host. The default is the IANA assigned port 33434.

Note:

If the traceroute action is directed to an IPv6 host address, Linux increments the UDP port on a per-TTL basis. For an IPv4 host address, Linux increments the UDP port on a per-probe basis.

Because the traceroute command sends a default of three probes, three incrementing ports will be sent for an IPv4 host address. If you use the -p parameter with a value greater than 65533, the traceroute command fails for an IPv4 host address because the maximum port number, 65535, is exceeded.

MaxTtl

Specifies the maximum time-to-live from 1–255. The default is 30.

DSField

Specifies the value to store in the Differentiated Services (DS) field in the IP packet used to encapsulate the traceroute probe. The default is 0.

SourceAddressType

Specifies the type of the source address to use at a remote host.

SourceAddress

Uses the specified IP address (which must be an IP number, not a hostname) as the source address in outgoing probe packets.

IfIndex

Directs the traceroute probes to be transmitted over the specified interface. The default is 0.

MiscOptions

Enables an application to specify implementation-dependent options.

MaxFailures

Indicates the maximum number of consecutive timeouts allowed before terminating a remote traceroute request. The default is 5.

DontFragment

Enables setting of the do not fragment (DF) flag in the IP header for a probe. The default is disabled.

InitialTtl

Specifies the initial time-to-live (TTL) value to use. The default is 1.

Frequency

Specifies the number of seconds to wait before repeating a traceroute test as defined by the value of the various objects in the corresponding row. The default is 0.

StorageType

Specifies the storage type for this row.

AdminStatus

Specifies the desired state for TraceRouteCtlEntry. The options are enabled or disabled. The default is disabled.

MaxRows

Specifies the maximum number of entries allowed in the TraceRouteProbeHistoryTable. The default is 50.

TrapGeneration

Determines when to generate a notification for this entry. The options are

  • pathChange —Generates a TraceRoutePathChange notification after the current path varies from a previously determined path.

  • testFailure —Generates a TraceRouteTestFailed notification after the full path to a target cannot be determined.

  • testCompletion —Generates a TraceRouteTestCompleted notification after the path to a target has been determined.

Descr

Describes the remote traceroute test.

CreateHopsEntries

Stores the current path for a traceroute test in the TraceRouteHopsTable on an individual hop basis when the value of this object is true. The default is false.

Type

Reports or selects the implementation method to use for performing a traceroute operation.