BAS-TRACERT-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, IpAddress, Integer32 FROM SNMPv2-SMI DisplayString, RowStatus, TruthValue FROM SNMPv2-TC BasChassisId, BasSlotId, BasInterfaceId, BasLogicalPortId, basTracert FROM BAS-MIB TEXTUAL-CONVENTION FROM SNMPv2-TC; basTracertMib MODULE-IDENTITY LAST-UPDATED "2009211415Z" ORGANIZATION "Broadband Access Systems" CONTACT-INFO " Tech Support Broadband Access Systems 8 Technology Drive Westborough, MA 01581 U.S.A. 508-366-8833 support@basystems.com" DESCRIPTION "This module defines a way Traceroute is used in the BAS system." ::= { basTracert 1 } -- Textual Conventions -- The following textual convention is from the -- Interfaces MIB draft. It should go away once this -- draft has been published as RFC. InterfaceIndexOrZero ::= TEXTUAL-CONVENTION DISPLAY-HINT "d" STATUS current DESCRIPTION "This textual convention is an extension of the InterfaceIndex convention. The latter defines a greater than zero value used to identify an interface or interface sub-layer in the managed system. This extension permits the additional value of zero. the value zero is object-specific and must therefore be defined as part of the description of any object which uses this syntax. Examples of the usage of zero might include situations where interface was unknown, or when none or all interfaces need to be referenced." SYNTAX Integer32 (0..2147483647) basTracertConfig OBJECT IDENTIFIER ::= { basTracertMib 1 } -- the IP address table basTracertAddrTable OBJECT-TYPE SYNTAX SEQUENCE OF BasTracertAddrEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The table for Tracerouting out of the BAS chassis." ::= { basTracertConfig 1 } basTracertAddrEntry OBJECT-TYPE SYNTAX BasTracertAddrEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A single Traceroute." INDEX { basTracertChassis, basTracertSlot, basTracertIf, basTracertLPort, basTracertAddr } ::= { basTracertAddrTable 1 } BasTracertAddrEntry ::= SEQUENCE { basTracertChassis BasChassisId, basTracertSlot BasSlotId, basTracertIf BasInterfaceId, basTracertLPort BasLogicalPortId, basTracertAddr IpAddress, basTracertInstance INTEGER, basTracertSize INTEGER, basTracertTimeout INTEGER, basTracertProbesPerHop Integer32, basTracertPort Integer32, basTracertMaxTtl Integer32, basTracertDSField Integer32, basTracertSourceAddress IpAddress, basTracertIfIndex InterfaceIndexOrZero, basTracertMaxFailures Integer32, basTracertDontFragment TruthValue, basTracertInitialTtl Integer32, basTracertAdminStatus INTEGER, basTracertSendStatus INTEGER, basTracertStatus RowStatus, basTracertHostname DisplayString } basTracertChassis OBJECT-TYPE SYNTAX BasChassisId MAX-ACCESS not-accessible STATUS current DESCRIPTION "The BAS Chassis ID of the Card." ::= { basTracertAddrEntry 1 } basTracertSlot OBJECT-TYPE SYNTAX BasSlotId MAX-ACCESS not-accessible STATUS current DESCRIPTION "The BAS Slot ID of the Card." ::= { basTracertAddrEntry 2 } basTracertIf OBJECT-TYPE SYNTAX BasInterfaceId MAX-ACCESS not-accessible STATUS current DESCRIPTION "The BAS interface ID of the Card." ::= { basTracertAddrEntry 3 } basTracertLPort OBJECT-TYPE SYNTAX BasLogicalPortId MAX-ACCESS not-accessible STATUS current DESCRIPTION "The BAS logical port ID of the Card." ::= { basTracertAddrEntry 4 } basTracertAddr OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current DESCRIPTION "The IP address which we are tracerouting." ::= { basTracertAddrEntry 5 } basTracertInstance OBJECT-TYPE SYNTAX INTEGER MAX-ACCESS read-only STATUS current DESCRIPTION "If we are tracerouting the same destination this is the instance number." ::= { basTracertAddrEntry 6 } basTracertSize OBJECT-TYPE SYNTAX INTEGER (64..64000) MAX-ACCESS read-write STATUS current DESCRIPTION "Size of the traceroute to send." DEFVAL { 64 } ::= { basTracertAddrEntry 7 } basTracertTimeout OBJECT-TYPE SYNTAX INTEGER (1..30) MAX-ACCESS read-write STATUS current DESCRIPTION "Number of seconds to wait for a traceroute request." DEFVAL { 1 } ::= { basTracertAddrEntry 8 } basTracertProbesPerHop OBJECT-TYPE SYNTAX Integer32 (1..10) UNITS "probes" MAX-ACCESS read-create STATUS current DESCRIPTION "Number of times to reissue a traceroute request with the same TTL value." DEFVAL { 3 } ::= { basTracertAddrEntry 9 } basTracertPort OBJECT-TYPE SYNTAX Integer32 (1..65535) UNITS "UDP Port" MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the UDP port to send the traceroute request to." DEFVAL { 33434 } ::= { basTracertAddrEntry 10 } basTracertMaxTtl OBJECT-TYPE SYNTAX Integer32 (1..255) UNITS "time-to-live value" MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the maximum time-to-live value." DEFVAL { 30 } ::= { basTracertAddrEntry 11 } basTracertDSField OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-create STATUS current DESCRIPTION "The DS Field is defined as the Type of Service (TOS) octet in a IPv4 header or as the Traffic Class octet in a IPv6 header. This determines what effect an explicit DS Field setting has on a traceroute response. A value of 0 means that the function represented by this option is not supported. Useful TOS octet values are probably '16' (low delay) and '8' ( high throughput)." DEFVAL { 0 } ::= { basTracertAddrEntry 12 } basTracertSourceAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-create STATUS current DESCRIPTION "Use this IP address as the source address in outgoing probe packets." DEFVAL { ''H } ::= { basTracertAddrEntry 13 } basTracertIfIndex OBJECT-TYPE SYNTAX InterfaceIndexOrZero MAX-ACCESS read-create STATUS current DESCRIPTION "Setting this object to an interface's ifIndex prior to starting a remote traceroute operation directs the traceroute probes to be transmitted over the specified interface." DEFVAL { 0 } ::= { basTracertAddrEntry 14 } basTracertMaxFailures OBJECT-TYPE SYNTAX Integer32 (0..255) UNITS "timeouts" MAX-ACCESS read-create STATUS current DESCRIPTION "The value of this object indicates the maximum number of consecutive timeouts allowed before terminating a remote traceroute request." DEFVAL { 5 } ::= { basTracertAddrEntry 15 } basTracertDontFragment OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "This object enables setting of the don't fragment flag (DF) in the IP header for a probe. Use of this object enables performing a manual PATH MTU test." DEFVAL { false } ::= { basTracertAddrEntry 16 } basTracertInitialTtl OBJECT-TYPE SYNTAX Integer32 (0..255) MAX-ACCESS read-create STATUS current DESCRIPTION "The value of this object specifies the initial TTL value to use. This enables bypassing the initial (often well known) portion of a path." DEFVAL { 1 } ::= { basTracertAddrEntry 17 } basTracertAdminStatus OBJECT-TYPE SYNTAX INTEGER { enabled(1), -- operation should be started disabled(2) -- operation should be stopped } MAX-ACCESS read-create STATUS current DESCRIPTION "Reflects the desired state that an basTracertEntry should be in." DEFVAL { enabled } ::= { basTracertAddrEntry 18 } basTracertSendStatus OBJECT-TYPE SYNTAX INTEGER { ipSendOK(1), ipSendFragFail(2), ipSendNoRoute(3), ipSendNoSrc(4), ipSendNoDst(5), ipSendPktOverflow(6), ipSendBadVersion(7), ipSendNdError(8), ipSendIpsecDenied(9), sendInvalid(10), rcvIcmpError(11), tracerouteTimeout(12), tracerouteComplete(13), maxTTLReached(14) } MAX-ACCESS read-only STATUS current DESCRIPTION "Min time for the response." ::= { basTracertAddrEntry 19 } basTracertStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The row status object used to create and delete a conceptual row according to RowStatus conventions." ::= { basTracertAddrEntry 20 } basTracertHostname OBJECT-TYPE SYNTAX DisplayString (SIZE(0..40)) MAX-ACCESS read-only STATUS current DESCRIPTION "The name of the host in case we want to resolve addresses to host names ." ::= { basTracertAddrEntry 21 } -- Traceroute Hop Results Table basTracertResultHopsTable OBJECT-TYPE SYNTAX SEQUENCE OF BasTracertHopsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines the Remote Operations Traceroute Hop Table for keeping track of the results of traceroute tests on a per hop basis." ::= { basTracertConfig 2 } basTracertHopsEntry OBJECT-TYPE SYNTAX BasTracertHopsEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Defines an entry in the basTracertResultHopsTable. The first five index elements identify the basTracertResultCtlEntry that a basTracertResultHopsEntry belongs to. The third index element, basTracertResultHopsHopIndex, selects a hop in a traceroute path." INDEX { basTracertResultChassis, basTracertResultSlot, basTracertResultIf, basTracertResultLPort, basTracertResultHopsHopIndex, basTracertResultHopsTgtAddress } ::= { basTracertResultHopsTable 1 } BasTracertHopsEntry ::= SEQUENCE { basTracertResultChassis BasChassisId, basTracertResultSlot BasSlotId, basTracertResultIf BasInterfaceId, basTracertResultLPort BasLogicalPortId, basTracertResultHopsHopIndex Integer32, basTracertResultHopsTgtAddress IpAddress, basTracertResultHopsAddress IpAddress, basTracertResultHopsMin Integer32, basTracertResultHopsMax Integer32, basTracertResultHopsRTT Integer32, basTracertResultHopsSentProbes Integer32, basTracertResultHopsProbeResponses Integer32 } basTracertResultChassis OBJECT-TYPE SYNTAX BasChassisId MAX-ACCESS not-accessible STATUS current DESCRIPTION "The BAS Chassis ID of the Card." ::= { basTracertHopsEntry 1 } basTracertResultSlot OBJECT-TYPE SYNTAX BasSlotId MAX-ACCESS not-accessible STATUS current DESCRIPTION "The BAS Slot ID of the Card." ::= { basTracertHopsEntry 2 } basTracertResultIf OBJECT-TYPE SYNTAX BasInterfaceId MAX-ACCESS not-accessible STATUS current DESCRIPTION "The BAS interface ID of the Card." ::= { basTracertHopsEntry 3 } basTracertResultLPort OBJECT-TYPE SYNTAX BasLogicalPortId MAX-ACCESS not-accessible STATUS current DESCRIPTION "The BAS logical port ID of the Card." ::= { basTracertHopsEntry 4 } basTracertResultHopsHopIndex OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the hop index for a traceroute hop. Values for this object with respect to the same basTracertResultChassis, basTracertResultSlot, basTracertResultIf, basTracertResultLPort and basTracertResultAddr, MUST start at 1 and increase monotonically. The basTracertResultHopsTable keeps the current traceroute path per basTracertResultCtlEntry if enabled by setting the corresponding basTracertResultCtlCreateHopsEntries to true(1). All hops (basTracertResultHopsTable entries) in a traceroute path MUST be updated at the same time when a traceroute operation completes. Care needs to be applied when either a path changes or can't be determined. The initial portion of the path, up to the first hop change, MUST retain the same basTracertResultHopsHopIndex values. The remaining portion of the path SHOULD be assigned new basTracertResultHopsHopIndex values." ::= { basTracertHopsEntry 5 } basTracertResultHopsTgtAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current DESCRIPTION "This object reports the IP address associated with the final destination. A value for this object should be reported as a numeric IP address and not as a DNS name." ::= { basTracertHopsEntry 6 } basTracertResultHopsAddress OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-only STATUS current DESCRIPTION "This object reports the IP address associated with the hop. A value for this object should be reported as a numeric IP address and not as a DNS name." ::= { basTracertHopsEntry 7 } basTracertResultHopsSentProbes OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of traceroute probes sent for this hop during this traceroute test." ::= { basTracertHopsEntry 8 } basTracertResultHopsProbeResponses OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "Number of traceroute responses received." ::= { basTracertHopsEntry 9 } basTracertResultHopsRTT OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "Average RTT time for the traceroutes for this hop." ::= { basTracertHopsEntry 10 } basTracertResultHopsMax OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "Max time for the response for this hop." ::= { basTracertHopsEntry 11 } basTracertResultHopsMin OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "Min time for the response for this hop." ::= { basTracertHopsEntry 12 } END