This MIB contains information about the traceroute (tracert) utility defined by RFC 4560 and the traceroute notifications. The traceroute utility is implemented by NQA UDP traceroute operations.

Root object

iso(1).org(3).dod(6).internet(1).mgmt(2).mib-2(1).traceRouteMIB(81)

Scalar objects

traceRouteMaxConcurrentRequests (1.3.6.1.2.1.81.1.1)

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteMaxConcurrentRequests (1.3.6.1.2.1.81.1.1)	read-write	Unsigned32	Standard MIB values.	Maximum number of concurrent active traceroute requests that are allowed within an agent implementation.	Only read is supported.

Tabular objects

traceRouteCtlTable

About this table

Use this table to define probe parameters for a traceroute operation.

Support for operations

Create	Edit/Modify	Delete	Read
· When create a traceroute operation entry, the default value of traceRouteCtlType is traceRouteUsingUdpProbes. At present, the traceRouteCtlType object supports only traceRouteUsingUdpProbes. · When create a traceroute operation entry, the values of the traceRouteCtlOwnerIndex and traceRouteCtlTestName objects must be different than the pingCtlOwnerIndex and pingCtlTestName objects.	· Modifying any object in the traceRouteCtlTable except the following objects will clear the corresponding probe results, history records, and statistics information: ¡ traceRouteCtlTrapGeneration. ¡ traceRouteCtlDescr. ¡ traceRouteCtlMaxRows. If the new value for this object is lower than the previous value, the system deletes the excessive history records. · You must specify traceRouteCtlTargetAddressType and traceRouteCtlTargetAddress in pairs in an SNMP request. · You must specify traceRouteCtlSourceAddressType and traceRouteCtlSourceAddress in pairs in an SNMP request. · When traceRouteCtlAdminStatus is enabled, you cannot change the configuration in the traceRouteCtlTable.	Supported	Supported

Create

Edit/Modify

Delete

Read

· When create a traceroute operation entry, the default value of traceRouteCtlType is traceRouteUsingUdpProbes. At present, the traceRouteCtlType object supports only traceRouteUsingUdpProbes.

· When create a traceroute operation entry, the values of the traceRouteCtlOwnerIndex and traceRouteCtlTestName objects must be different than the pingCtlOwnerIndex and pingCtlTestName objects.

· Modifying any object in the traceRouteCtlTable except the following objects will clear the corresponding probe results, history records, and statistics information:

¡ traceRouteCtlTrapGeneration.

¡ traceRouteCtlDescr.

¡ traceRouteCtlMaxRows. If the new value for this object is lower than the previous value, the system deletes the excessive history records.

· You must specify traceRouteCtlTargetAddressType and traceRouteCtlTargetAddress in pairs in an SNMP request.

· You must specify traceRouteCtlSourceAddressType and traceRouteCtlSourceAddress in pairs in an SNMP request.

· When traceRouteCtlAdminStatus is enabled, you cannot change the configuration in the traceRouteCtlTable.

Supported

Columns

The table indexes are traceRouteCtlOwnerIndex and traceRouteCtlTestName.

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteCtlOwnerIndex (1.3.6.1.2.1.81.1.2.1.1)	not-accessible	SnmpAdminString	OCTET STRING (0..32)	Administrator name.	For the set operation, the uppercase letters in the value will be converted to lowercase letters. The value cannot contain a minus sign (-) or question mark (?).
traceRouteCtlTestName (1.3.6.1.2.1.81.1.2.1.2)	not-accessible	SnmpAdminString	OCTET STRING (0..32)	Operation tag.	For the set operation, the uppercase letters in the value will be converted to lowercase letters. The value cannot contain a minus sign (-) or question mark (?).
traceRouteCtlTargetAddressType (1.3.6.1.2.1.81.1.2.1.3)	read-create	InetAddressType	Standard MIB values.	Destination address type.	Supports only ipv4(1), dns(16), and unknown(0).
traceRouteCtlTargetAddress (1.3.6.1.2.1.81.1.2.1.4)	read-create	InetAddress	Standard MIB values.	Destination address.	If the value for the traceRouteCtlTargetAddressType object is ipv4(1), the value for this object must be an IPv4 address. If the value for the traceRouteCtlTargetAddressType object is dns(16), the value for this object can be a host name. If the value for the traceRouteCtlTargetAddressType object is unknown(0), the value for this object must be a zero-length string.
traceRouteCtlByPassRouteTable(1.3.6.1.2.1.81.1.2.1.5)	read-create	TruthValue	Standard MIB values.	Whether to bypass the routing table.	As per the MIB.
traceRouteCtlDataSize (1.3.6.1.2.1.81.1.2.1.6)	read-create	Unsigned32	Unsigned32 (0..65507)	Size of the data portion of a traceroute request, in octets.	Value range: 20 to 65507 octets. Default: 100 octets.
traceRouteCtlTimeOut (1.3.6.1.2.1.81.1.2.1.7)	read-create	Unsigned32	Unsigned32 (1-60)	Timeout time for waiting for a response to a probe request..	Same as the standard MIB file.
traceRouteCtlProbesPerHop (1.3.6.1.2.1.81.1.2.1.8)	read-create	Unsigned32	Unsigned32 (1-10)	Number of times to reissue a traceroute request with the same time-to-live (TTL) value.	Same as the standard MIB file..
traceRouteCtlPort (1.3.6.1.2.1.81.1.2.1.9)	read-create	Unsigned32	Unsigned32 (1-65535)	Destination port number.	Same as the standard MIB file.
traceRouteCtlMaxTtl (1.3.6.1.2.1.81.1.2.1.10)	read-create	Unsigned32	Unsigned32 (1-255)	Maximum TTL value.	Same as the standard MIB file.
traceRouteCtlDSField (1.3.6.1.2.1.81.1.2.1.11)	read-create	Unsigned32	Unsigned32 (0-255)	Service type.	As per the MIB.
traceRouteCtlSourceAddressType (1.3.6.1.2.1.81.1.2.1.12)	read-create	InetAddressType	Standard MIB values.	Source address type.	Supports only ipv4(1) and unknown(0). Default: unknown(0).
traceRouteCtlSourceAddress (1.3.6.1.2.1.81.1.2.1.13)	read-create	InetAddress	Standard MIB values.	Source address.	If the value for the traceRouteCtlSourceAddressType object is ipv4(1), the value for this object must be an IPV4 address. If the value for the traceRouteCtlSourceAddressType object is unknown(0), the value for this object must be a zero-length string.
traceRouteCtlIfIndex (1.3.6.1.2.1.81.1.2.1.14)	read-create	InterfaceIndexOrZero	Standard MIB values.	Output interface index.	Same as the standard MIB file.
traceRouteCtlMaxFailures (1.3.6.1.2.1.81.1.2.1.16)	read-create	Unsigned32	Unsigned32 (0-255)	Maximum number of consecutive timeouts allowed before a remote traceroute request is terminated.	Same as the standard MIB file.
traceRouteCtlDontFragment (1.3.6.1.2.1.81.1.2.1.17)	read-create	TruthValue	Standard MIB values.	Whether to enable setting of the don't fragment flag (DF) in the IP header.	Same as the standard MIB file.
traceRouteCtlInitialTtl (1.3.6.1.2.1.81.1.2.1.18)	read-create	Unsigned32	Unsigned32 (1..255)	Initial TTL value.	Same as the standard MIB file.
traceRouteCtlFrequency (1.3.6.1.2.1.81.1.2.1.19)	read-create	Unsigned32	Standard MIB values.	Interval between two consecutive traceroute probes.	Value range: 0 to 604800 seconds. The return value for the read operation is not accurate if the value is not set to integer seconds at the CLI. For example, if the value configured at the CLI is 1050 milliseconds, the return value for the read operation will be 2 seconds. Default: 0 seconds.
traceRouteCtlAdminStatus (1.3.6.1.2.1.81.1.2.1.21)	read-create	INTEGER	enabled(1) disabled(2)	Operation status.	As per the MIB.
traceRouteCtlDescr (1.3.6.1.2.1.81.1.2.1.22)	read-create	SnmpAdminString	OCTET STRING (0..255)	Description string for the remote traceroute operation.	Value range: 0 to 200 characters. The value cannot start with a space.
traceRouteCtlMaxRows (1.3.6.1.2.1.81.1.2.1.23)	read-create	Unsigned32	Standard MIB values.	Maximum number of history records.	Value range: 0 to 50.
traceRouteCtlTrapGeneration (1.3.6.1.2.1.81.1.2.1.24)	read-create	BITS	BITS { pathChange(0), testFailure(1), testCompletion(2) }	Conditions to generate notifications.	As per the MIB.
traceRouteCtlCreateHopsEntries(1.3.6.1.2.1.81.1.2.1.25)	read-create	TruthValue	Standard MIB values.	Whether to generate the hop table.	As per the MIB.
traceRouteCtlType (1.3.6.1.2.1.81.1.2.1.26)	read-create	OBJECT IDENTIFIER	Standard MIB values.	Traceroute operation type.	This object cannot be edited after creation.
traceRouteCtlRowStatus (1.3.6.1.2.1.81.1.2.1.27)	read-create	RowStatus	Standard MIB values.	Row status.	Supports only active(1), createAndgo(4), and destroy(6).

traceRouteResultsTable

About this table

This table contains information about traceroute probe results.

Support for operations

Create	Edit/Modify	Delete	Read
Not supported	Not supported	Not supported	Supported

Columns

The table indexes are traceRouteCtlOwnerIndex and traceRouteCtlTestName.

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteResultsOperStatus (1.3.6.1.2.1.81.1.3.1.1)	read-only	INTEGER	enabled(1) , disabled(2), completed(3)	Operation status of a remote traceroute operation.	As per the MIB.
traceRouteResultsCurHopCount (1.3.6.1.2.1.81.1.3.1.2)	read-only	Gauge32	Standard MIB values.	Current TTL value for the traceroute request.	As per the MIB.
traceRouteResultsCurProbeCount (1.3.6.1.2.1.81.1.3.1.3)	read-only	Gauge32	Standard MIB values.	Current probe count for the remote traceroute operation.	As per the MIB.
traceRouteResultsIpTgtAddrType (1.3.6.1.2.1.81.1.3.1.4)	read-only	InetAddressType	Standard MIB values.	Type of address stored in the corresponding traceRouteResultsIpTgtAddr object.	As per the MIB.
traceRouteResultsIpTgtAddr (1.3.6.1.2.1.81.1.3.1.5)	read-only	InetAddress	Standard MIB values.	IP address associated with a traceRouteCtlTargetAddress value when the destination address is specified as a DNS name.	As per the MIB.
traceRouteResultsTestAttempts (1.3.6.1.2.1.81.1.3.1.6)	read-only	Gauge32	Standard MIB values.	Current number of probe attempts.	As per the MIB.
traceRouteResultsTestSuccesses (1.3.6.1.2.1.81.1.3.1.7)	read-only	Gauge32	Standard MIB values.	Current number of succeeded probe attempts.	As per the MIB.
traceRouteResultsLastGoodPath (1.3.6.1.2.1.81.1.3.1.8)	read-only	DateAndTime	Standard MIB values.	Date and time when the last complete path was determined.	As per the MIB.

traceRouteProbeHistoryTable

About this table

Use this table to obtain history information about each probe in a traceroute operation.

Support for operations

Create	Edit/Modify	Delete	Read
Not supported	Not supported	Not supported	Supported

Columns

The table indexes are traceRouteCtlOwnerIndex, traceRouteCtlTestName, traceRouteProbeHistoryIndex, traceRouteProbeHistoryHopIndex, and traceRouteProbeHistoryProbeIndex.

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteProbeHistoryIndex (1.3.6.1.2.1.81.1.4.1.1)	not-accessible	Unsigned32	Unsigned32 (1..'ffffffff'h)	History record index of a traceroute operation.	As per the MIB.
traceRouteProbeHistoryHopIndex (1.3.6.1.2.1.81.1.4.1.2)	not-accessible	Unsigned32	Unsigned32 (1-255)	Index of a hop in the record.	As per the MIB.
traceRouteProbeHistoryProbeIndex (1.3.6.1.2.1.81.1.4.1.3)	not-accessible	Unsigned32	Unsigned (1-10)	Index of a probe for the hop in the traceroute path.	As per the MIB.
traceRouteProbeHistoryHAddrType(1.3.6.1.2.1.81.1.4.1.4)	read-only	InetAddressType	Standard MIB values.	Type of address for the hop in the traceroute path.	As per the MIB.
traceRouteProbeHistoryHAddr (1.3.6.1.2.1.81.1.4.1.5)	read-only	InetAddress	Standard MIB values.	Address of the hop in the traceroute path.	As per the MIB.
traceRouteProbeHistoryResponse (1.3.6.1.2.1.81.1.4.1.6)	read-only	Unsigned32	Standard MIB values.	Amount of time measured in milliseconds from when the probe was sent to when its response was received or when it timed out.	As per the MIB.
traceRouteProbeHistoryStatus (1.3.6.1.2.1.81.1.4.1.7)	read-only	OperationResponseStatus	Standard MIB values.	Probe result.	As per the MIB.
traceRouteProbeHistoryLastRC (1.3.6.1.2.1.81.1.4.1.8)	read-only	Integer32	Standard MIB values.	The last implementation-method-specific reply code received.	As per the MIB.
traceRouteProbeHistoryTime (1.3.6.1.2.1.81.1.4.1.9)	read-only	DateAndTime	Standard MIB values.	Time when the probe result was determined.	As per the MIB.

traceRouteHopsTable

About this table

This table contains information about each hop in a traceroute path.

Support for operations

Create	Edit/Modify	Delete	Read
Not supported	Not supported	Not supported	Supported

Columns

The table indexes are traceRouteCtlOwnerIndex, traceRouteCtlTestName, and traceRouteHopsHopIndex.

Object (OID)	Access	Syntax	Value range	Description	Implementation
traceRouteHopsHopIndex (1.3.6.1.2.1.81.1.5.1.1)	not-accessible	Unsigned32	Unsigned32 (1..4294967295)	Hop index.	As per the MIB.
traceRouteHopsIpTgtAddressType (1.3.6.1.2.1.81.1.5.1.2)	read-only	InetAddressType	Standard MIB values.	Destination address type.	As per the MIB.
traceRouteHopsIpTgtAddress (1.3.6.1.2.1.81.1.5.1.3)	read-only	InetAddress	Standard MIB values.	Destination address.	As per the MIB.
traceRouteHopsMinRtt (1.3.6.1.2.1.81.1.5.1.4)	read-only	Unsigned32	Standard MIB values.	Minimum bidirectional delay.	As per the MIB.
traceRouteHopsMaxRtt (1.3.6.1.2.1.81.1.5.1.5)	read-only	Unsigned32	Standard MIB values.	Maximum bidirectional delay.	As per the MIB.
traceRouteHopsAverageRtt (1.3.6.1.2.1.81.1.5.1.6)	read-only	Unsigned32	Standard MIB values.	Average bidirectional delay	As per the MIB.
traceRouteHopsRttSumOfSquares (1.3.6.1.2.1.81.1.5.1.7)	read-only	Unsigned32	Standard MIB values.	Sum of squares for delay.	As per the MIB.
traceRouteHopsSentProbes (1.3.6.1.2.1.81.1.5.1.8)	read-only	Unsigned32	Standard MIB values.	Number of sent probe packets.	As per the MIB.
traceRouteHopsProbeResponses (1.3.6.1.2.1.81.1.5.1.9)	read-only	Unsigned32	Standard MIB values.	Number of received probe reply packets.	As per the MIB.
traceRouteHopsLastGoodProbe (1.3.6.1.2.1.81.1.5.1.10)	read-only	DateAndTime	Standard MIB values.	Date and time when the last probe reply packet was received.	As per the MIB.

Notifications

OID (object name)	Description	Index nodes	Type	Value range
1.3.6.1.2.1.81.1.2.1.3 (traceRouteCtlTargetAddressType)	Destination address type.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.2.1.4 (traceRouteCtlTargetAddress)	Destination address.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddress	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.4 (traceRouteResultsIpTgtAddrType)	Destination address type in the probe result.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.5 (traceRouteResultsIpTgtAddr)	Destination address in the probe result.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddress	Standard MIB values.

traceRouteTestFailed

Basic information

OID	Event	Type	Severity	Recovery notification	Default status
1.3.6.1.2.1.81.0.2	A traceroute operation failed.	Informational	Warning	N/A	OFF

Notification triggers

This notification is generated when a traceroute operation fails. The following might be operation failure reasons:

· The destination address does not exist.

· The destination address exists but is unreachable.

· The destination address exists and is reachable. However, the number of hops for probe packets of the traceroute operation to reach the destination address exceeds the maximum number of hops that the probe packets can traverse.

· The network latency is large and the round-trip time of packets is larger than the specified timeout time.

System impact

No impact on the system.

Status control

ON

CLI: Use the reaction trap test-failure [ accumulate-probe-failures ] command.

OFF

CLI: Use the undo reaction trap test-failure [ accumulate-probe-failures ] command.

Objects

OID (object name)	Description	Index nodes	Type	Value range
1.3.6.1.2.1.81.1.2.1.3 (traceRouteCtlTargetAddressType)	Destination address type.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.2.1.4 (traceRouteCtlTargetAddress)	Destination address.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddress	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.4 (traceRouteResultsIpTgtAddrType)	Destination address type in the probe result.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.5 (traceRouteResultsIpTgtAddr)	Destination address in the probe result.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddress	Standard MIB values.

Recommended action

1. In NQA operation view, execute the display this command to identify whether the destination address is configured correctly.

¡ If the destination address is correct, go to step 2.

¡ If the destination address is incorrect, execute the destination ip command to change the destination address, and then perform the traceroute operation again.

- If no notification is generated, the issue is cleared.

- If the notification is generated, go to step 2.

2. In NQA operation view, execute the ping command to identify whether the destination address is reachable.

¡ If the destination address is reachable, go to step 3.

¡ If the destination address is unreachable, locate routing issues. For example, execute the display ip routing-table command to verify routing table information.

3. In NQA operation view, execute the display this command to display the maximum number of hops that the probe packets can traverse. You can execute the ttl command to change the maximum number as needed. Then, perform the traceroute operation again.

¡ If no notification is generated, the issue is cleared.

¡ If the notification is generated, go to step 4.

4. In NQA operation view, execute the probe timeout command to set the probe timeout time, and then perform the traceroute operation again.

¡ If no notification is generated, the issue is cleared.

¡ If the notification is generated, go to step 5.

5. Verify that the settings are correct on the destination device and the intermediate devices between the source and destination devices.

¡ IPv4:

- Enable sending ICMP time exceeded messages on the intermediate devices between the source and destination devices. If the intermediate devices are H3C devices, use the ip ttl-expires enable command.

- Enable sending ICMP destination unreachable messages on the destination device. If the destination device is an H3C device, use the ip unreachables enable command.

¡ IPv6:

- Enable sending ICMPv6 time exceeded messages on the intermediate devices between the source and destination devices. If the intermediate devices are H3C devices, use the ipv6 hoplimit-expires enable command.

- Enable sending ICMPv6 destination unreachable messages on the destination device. If the destination device is an H3C device, use the ipv6 unreachables enable command.

6. If the issue persists, collect alarm information and configuration data, and then contact H3C Support for help.

traceRouteTestCompleted

Basic information

OID	Event	Type	Severity	Recovery notification	Default status
1.3.6.1.2.1.81.0.3	A traceroute operation completed.	Informational	Warning	N/A	OFF

Notification triggers

This notification is generated when a traceroute operation completes successfully.

System impact

No impact on the system.

Status control

ON

CLI: Use the reaction trap test-complete command.

OFF

CLI: Use the undo reaction trap test-complete command.

Objects

OID (object name)	Description	Index nodes	Type	Value range
1.3.6.1.2.1.81.1.2.1.3 (traceRouteCtlTargetAddressType)	Destination address type.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.2.1.4 (traceRouteCtlTargetAddress)	Destination address.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddress	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.4 (traceRouteResultsIpTgtAddrType)	Destination address type in the probe result.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddressType	Standard MIB values.
1.3.6.1.2.1.81.1.3.1.5 (traceRouteResultsIpTgtAddr)	Destination address in the probe result.	traceRouteCtlOwnerIndex traceRouteCtlTestName	InetAddress	Standard MIB values.

Recommended action

No action is required.

21-Network Management and Monitoring

traceRouteMaxConcurrentRequests (1.3.6.1.2.1.81.1.1)

About this table

Support for operations

Columns

About this table

Support for operations

Columns

About this table

Support for operations

Columns

About this table

Support for operations

Columns

Basic information

Notification triggers

System impact

Status control

ON

OFF

Objects

Recommended action

Basic information

Notification triggers

System impact

Status control

ON

OFF

Objects

Recommended action

Basic information

Notification triggers

System impact

Status control

ON

OFF

Objects

Recommended action

Intelligent Terminal Products

Product Support Services

Technical Service Solutions

Resource Center

Policy

Online Help

Become a Partner

Partner Policy & Program

Global Learning

Partner Sales Resources

Service Business

News & Events

Contact Us