CISCO-FCTRACEROUTE-MIB
AI MIB Summary
The CISCO-FCTRACEROUTE-MIB enables monitoring and management of Fibre Channel trace route operations on Cisco SAN switches, specifically tracking hop-by-hop path discovery, node identifiers, and link status within the fabric topology.
The MIB module for the management of the Fibre Channel Trace Route functionality.
33
Objects
Active
Status
7
Dependencies
Imported Objects
Objects
33 total| Object Name |
|---|
ciscoFcTraceRouteMIB OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296 |
RFC1155-SMI Unknown .1.3.6.1.4.1.9.9.296 |
ciscoFcTraceRouteMIBObjects OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.1 |
fcTraceRouteConfiguration OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.1.1 |
fcTraceRouteTableA table of trace route request entries.
The fcTraceRouteTable will contain a set of
trace route requests that need to be executed
at the agent. SEQUENCE OF FcTraceRouteEntry .1.3.6.1.4.1.9.9.296.1.1.1 |
fcTraceRouteEntryA trace route request entry.
A management station wishing to create an entry
should generate a pseudo-random number to be
used as an index into this table and create an
instance of the fcTraceRouteRowStatus object.
After that, the management station should set
the corresponding instance of fcTraceRouteTargetAddr
object with the address of the destination for which
the route needs to be determined and
fcTraceRouteVsanIndex with the desired VSAN number.
Once the appropriate instance of all the
configuration objects have been created, either by
an explicit SNMP set request or by default, the row
status should be set to active and the corresponding
instance of fcTraceRouteAdminStatus should be set to
'enable' to initiate the trace route sequence. Note
that this entire procedure may be initiated via a
single set request which specifies a row status of
createAndGo as well as specifies valid values for
the non-defaulted configuration objects.
The results of the trace route operation are made
available in the fcTraceRouteHopsTable. For an entry
uniquely identified by fcTraceRouteIndex, the value
of the corresponding instance of
fcTraceRouteOperStatus object will specify whether
test was a success or a failure.
The fcTraceRouteHopsTable will contain the actual
hops that were determined by the test.
For an entry uniquely identified by
fcTraceRouteIndex, entries will be created
automatically in the fcTraceRouteHopsTable which
contain the different hops of the trace route path.
Once the trace route test is complete, the management
station should retrieve the information from the
fcTraceRouteHopsTable and delete the entry from this
table. When an entry is deleted from this table,
related entries in the fcTraceRouteHopsTable will be
automatically deleted by the agent.
In order to prevent old entries from clogging the
table, entries will be aged out. But an entry will
never be deleted within fcTraceRouteAgeInterval
milliseconds of completing.
If the management station wishes to repeat the trace
route test for a particular destination, then it will
need to set the corresponding instance of
fcTraceRouteAdminStatus to 'enable' again. FcTraceRouteEntry .1.3.6.1.4.1.9.9.296.1.1.1.1 |
fcTraceRouteIndexThe index of a trace route entry. This object
uniquely identifies a trace route request entry
on a particular VSAN. Gauge .1.3.6.1.4.1.9.9.296.1.1.1.1.1 |
fcTraceRouteVsanIndexThis object identifies the VSAN on which this
trace route request is to be performed. This
object cannot be modified if the corresponding
instance of fcTraceRouteOperStatus object has a
value of 'inProgress'.rw VsanIndex -- Rsyntax INTEGER .1.3.6.1.4.1.9.9.296.1.1.1.1.2 |
fcTraceRouteTargetAddrTypeThe format of the corresponding instance of
fcTraceRouteTargetAddr object.rw FcAddressType -- Rsyntax INTEGER { -- wwn(1), -- fcid(2) -- } .1.3.6.1.4.1.9.9.296.1.1.1.1.3 |
fcTraceRouteTargetAddrThe address of the device to which the route is to be
traced.
If the value of the corresponding instance of
fcTraceRouteTargetAddrType object is 'wwn', then this
object will contain an 8 octet long WWN.
If the value of the corresponding instance of
fcTraceRouteTargetAddrType object is 'fcid', then this
object will contain a 3 octet long FCID.
This object MUST be set to a valid value before
or concurrently with setting the corresponding
instance of fcTraceRouteRowStatus to 'active'.rw FcAddress -- Rsyntax OCTET STRING .1.3.6.1.4.1.9.9.296.1.1.1.1.4 |
fcTraceRouteTimeoutThe timeout value for this trace route request.
This object cannot be modified if the
corresponding instance of fcTraceRouteOperStatus
object has a value of 'inProgress'.rw Gauge .1.3.6.1.4.1.9.9.296.1.1.1.1.5 |
fcTraceRouteAdminStatusThis object specifies the desired state that a
fcTraceRouteEntry should be in:
enable(1) - Attempt to activate the test as
defined by this entry.
disable(2) - Deactivate the test as defined by
this entry.
The actual operational state of this test is
indicated by the corresponding instance of
fcTraceRouteOperStatus.
When the trace route test corresponding to this entry
is executing, this object cannot be modified. If this
object is read at such a time, a value of 'enable'
will be returned. When the test completes, the value
of this object will be made 'disable' automatically
by the agent.rw FcStartOper -- Rsyntax INTEGER { -- enable(1), -- disable(2) -- } .1.3.6.1.4.1.9.9.296.1.1.1.1.6 |
fcTraceRouteOperStatusThis object indicates the operational status
of this fcTraceRouteEntry.
inProgress(1) - Indicates that the trace route
test as defined by this instance
of fcTraceRouteEntry is currently
running.
success(2) - Indicates that the trace route
test as defined by this instance
of fcTraceRouteEntry is currently
complete and the whole path to the
destination has been traced.
partialSuccess(3) - Indicates that the trace route
test as defined by this instance
of fcTraceRouteEntry is currently
partially successful.
failure(4) - Indicates that the trace route
test as defined by this instance
of fcTraceRouteEntry has currently
failed due to resource
limitations.
disabled(5) - Indicates that the trace route
test as defined by this instance
of fcTraceRouteEntry is
currently disabled.
Initially the value of this object will be
'inProgress' when the test is being executed. Once
the test completes, the value of this object will
be 'success' or 'partialSuccess' depending on the
outcome of the test.
If the value of this object is 'success', then the
route to the target as determined by this test will
be available in the fcTraceRouteHopsTable.
If the value of this object is 'partialSuccess', then
the fcTraceRouteHopsTable will contain that portion
of the route that was traced by the test.
If the value of this object is 'failure', then the
test was not carried out and the
fcTraceRouteHopsTable will not have any entries
corresponding to this test.
If the value of the corresponding instance of
fcTraceRouteAdminStatus is 'disable', then this
object will have a value of 'disabled'.ro Enumeration .1.3.6.1.4.1.9.9.296.1.1.1.1.7 |
fcTraceRouteAgeIntervalThe amount of time to wait after a trace route
test completes before the entry is aged out.
This object cannot be modified if the
corresponding instance of fcTraceRouteOperStatus
object has a value of 'inProgress'.rw Gauge .1.3.6.1.4.1.9.9.296.1.1.1.1.8 |
fcTraceRouteTrapOnCompletionThis object specifies if fcTraceRouteCompletionNotify
notification should be generated or not when this
trace route test completes.
If this object is set to 'true', then the notification
is generated.
If this object is set to 'false', then the
notification is not generated.
This object cannot be modified if the corresponding
instance of fcTraceRouteOperStatus object is
having a value of 'inProgress'.rw TruthValue -- Rsyntax INTEGER { -- true(1), -- false(2) -- } .1.3.6.1.4.1.9.9.296.1.1.1.1.9 |
fcTraceRouteRowStatusThe status of this conceptual row.
If a trace route test is being executed and
if the corresponding instance of this
object is set to 'destroy', then the trace
route test will be stopped.rw RowStatus -- Rsyntax INTEGER { -- active(1), -- notInService(2), -- notReady(3), -- createAndGo(4), -- createAndWait(5), -- destroy(6) -- } .1.3.6.1.4.1.9.9.296.1.1.1.1.10 |
fcTraceRouteResults OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.1.2 |
fcTraceRouteHopsTableA table of trace route hop results.
This table contains the hop-by-hop result
of a trace route test performed for an
entry in the fcTraceRouteTable. SEQUENCE OF FcTraceRouteHopsEntry .1.3.6.1.4.1.9.9.296.1.2.1 |
fcTraceRouteHopsEntryA trace route hop entry.
The first index identifies the fcTraceRouteEntry
that a fcTraceRouteHopsEntry belongs to. The second
index element selects a hop in a trace route path.
Entries are created automatically in this table
corresponding to a fcTraceRouteEntry when the
trace route test completes.
In the case of a complete path being traced, the
source and destination points along with the
intermediate hops will be listed in this table.
The entries in this table corresponding to a
fcTraceRouteEntry are automatically deleted when
the fcTraceRouteEntry is deleted or aged out. FcTraceRouteHopsEntry .1.3.6.1.4.1.9.9.296.1.2.1.1 |
fcTraceRouteHopsHopIndexThis object specifies the hop index for a
traceroute hop. Values for this object with
respect to the same fcTraceRouteIndex MUST start
at 1 and increase monotonically.
All hops (traceRouteHopsTable entries) in a
trace route path MUST be updated at the same time
when a trace route test completes. Gauge .1.3.6.1.4.1.9.9.296.1.2.1.1.1 |
fcTraceRouteHopsHopAddrThis object reports the WWN of the device
associated with this hop.ro FcNameId -- Rsyntax OCTET STRING .1.3.6.1.4.1.9.9.296.1.2.1.1.2 |
fcTraceRouteHopsHopLatencyValidThis object indicates whether the
corresponding instance of
fcTraceRouteHopsHopLatency object contains
a valid value.
If the value of this object is 'true', then
the corresponding instance of
fcTraceRouteHopsHopLatency contains a valid
value.
If the value of this object is 'false', then
the corresponding instance of
fcTraceRouteHopsHopLatency does not contain a
valid value and should be ignored.ro TruthValue -- Rsyntax INTEGER { -- true(1), -- false(2) -- } .1.3.6.1.4.1.9.9.296.1.2.1.1.3 |
fcTraceRouteHopsHopLatencyThis object reports the round trip time associated
with this hop.ro Gauge .1.3.6.1.4.1.9.9.296.1.2.1.1.4 |
fcTraceRouteNotification OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.1.3 |
fcTraceRouteNotifications OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.1.3.0 |
fcTraceRouteCompletionNotifyThis notification is generated whenever a
trace route test is completed and the
corresponding instance of
fcTraceRouteTrapOnCompletion is set to 'true'.
The agent is encouraged to append, at the end
of this notification's varbindlist, one varbind
for each hop of the traced route. Each such
appended varbind would contain an instance of
fcTraceRouteHopsHopAddr object. If the number of
varbinds required would cause the notification
to approach it's maximum size, the number of
instances of fcTraceRouteHopsHopAddr will be
truncated suitably. TRAP-TYPE .1.3.6.1.4.1.9.9.296.1.3.0.1 |
fcTraceRouteMIBConformance OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.2 |
fcTraceRouteMIBCompliances OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.2.1 |
fcTraceRouteMIBCompliance OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.2.1.1 |
fcTraceRouteMIBGroups OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.2.2 |
fcTraceRouteConfigGroup OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.2.2.1 |
fcTraceRouteResultsGroup OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.2.2.2 |
fcTraceRouteNotifyGroup OBJECT IDENTIFIER .1.3.6.1.4.1.9.9.296.2.2.3 |