296 lines
11 KiB
Plaintext
296 lines
11 KiB
Plaintext
-- =====================================================================
|
|
-- Copyright (c) 2010-2013 Hewlett-Packard Development Company, L.P.
|
|
--
|
|
-- Description:
|
|
-- This MIB module is for the management of the Fibre Channel
|
|
-- Trace Route functionality.
|
|
-- Reference:
|
|
-- Version: V1.0
|
|
-- History:
|
|
-- V1.0 Initial version created by liuyanchao 2013-02-27
|
|
-- =====================================================================
|
|
HPN-ICF-FC-TRACE-ROUTE-MIB DEFINITIONS ::= BEGIN
|
|
|
|
IMPORTS
|
|
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Unsigned32
|
|
FROM SNMPv2-SMI
|
|
RowStatus, TruthValue
|
|
FROM SNMPv2-TC
|
|
HpnicfFcVsanIndex, HpnicfFcAddressType, HpnicfFcAddress, HpnicfFcNameId,
|
|
HpnicfFcStartOper
|
|
FROM HPN-ICF-FC-TC-MIB
|
|
hpnicfSan
|
|
FROM HPN-ICF-VSAN-MIB;
|
|
|
|
|
|
hpnicfFcTraceRoute MODULE-IDENTITY
|
|
LAST-UPDATED "201302270000Z"
|
|
ORGANIZATION
|
|
""
|
|
CONTACT-INFO
|
|
""
|
|
DESCRIPTION
|
|
"This MIB module is for the management of the Fibre Channel
|
|
Trace Route functionality."
|
|
REVISION "201302270000Z"
|
|
DESCRIPTION
|
|
"Initial version of this MIB module."
|
|
::= { hpnicfSan 4 }
|
|
|
|
hpnicfFcTraceRouteObjects OBJECT IDENTIFIER
|
|
::= { hpnicfFcTraceRoute 1 }
|
|
hpnicfFcTraceRouteConfigurations OBJECT IDENTIFIER
|
|
::= { hpnicfFcTraceRouteObjects 1 }
|
|
hpnicfFcTraceRouteResults OBJECT IDENTIFIER
|
|
::= { hpnicfFcTraceRouteObjects 2 }
|
|
hpnicfFcTraceRouteNotifications OBJECT IDENTIFIER
|
|
::= { hpnicfFcTraceRouteObjects 3 }
|
|
hpnicfFcTraceRouteNotifyPrefix OBJECT IDENTIFIER
|
|
::= { hpnicfFcTraceRouteNotifications 0 }
|
|
|
|
-- Trace Route table.
|
|
|
|
hpnicfFcTraceRouteTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF HpnicfFcTraceRouteEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A table of trace route entries containing a group
|
|
of trace route requests that need to be executed
|
|
at the agent."
|
|
::= { hpnicfFcTraceRouteConfigurations 1 }
|
|
|
|
hpnicfFcTraceRouteEntry OBJECT-TYPE
|
|
SYNTAX HpnicfFcTraceRouteEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A trace route request entry that needs to be executed
|
|
at the agent."
|
|
INDEX { hpnicfFcTraceRouteIndex }
|
|
::= { hpnicfFcTraceRouteTable 1 }
|
|
|
|
|
|
HpnicfFcTraceRouteEntry ::= SEQUENCE {
|
|
hpnicfFcTraceRouteIndex Unsigned32,
|
|
hpnicfFcTraceRouteVsan HpnicfFcVsanIndex,
|
|
hpnicfFcTraceRouteAddressType HpnicfFcAddressType,
|
|
hpnicfFcTraceRouteAddress HpnicfFcAddress,
|
|
hpnicfFcTraceRouteTimeout Unsigned32,
|
|
hpnicfFcTraceRouteAdminStatus HpnicfFcStartOper,
|
|
hpnicfFcTraceRouteOperStatus INTEGER,
|
|
hpnicfFcTraceRouteAgeInterval Unsigned32,
|
|
hpnicfFcTraceRouteTrapOnCompletion TruthValue,
|
|
hpnicfFcTraceRouteRowStatus RowStatus
|
|
}
|
|
|
|
hpnicfFcTraceRouteIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..65535)
|
|
MAX-ACCESS accessible-for-notify
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The index of the current trace route entry. This object
|
|
uniquely identifies a trace route request entry in a
|
|
specified VSAN (Virtual Storage Area Network)."
|
|
::= { hpnicfFcTraceRouteEntry 1 }
|
|
|
|
hpnicfFcTraceRouteVsan OBJECT-TYPE
|
|
SYNTAX HpnicfFcVsanIndex
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The VSAN on which the trace route request will be
|
|
executed. If the corresponding instance value of
|
|
hpnicfFcTraceRouteOperStatus is 'inProgress', the
|
|
object cannot be modified."
|
|
::= { hpnicfFcTraceRouteEntry 2 }
|
|
|
|
hpnicfFcTraceRouteAddressType OBJECT-TYPE
|
|
SYNTAX HpnicfFcAddressType
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The type of the corresponding instance of
|
|
hpnicfFcTraceRouteAddress object."
|
|
DEFVAL { fcid }
|
|
::= { hpnicfFcTraceRouteEntry 3 }
|
|
|
|
hpnicfFcTraceRouteAddress OBJECT-TYPE
|
|
SYNTAX HpnicfFcAddress
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The address to which the route will be traced.
|
|
This object will contain an 8-octet WWN (World Wide Name),
|
|
if the value of the associated instance of
|
|
hpnicfFcTraceRouteAddressType object is 'wwn'.
|
|
This object will contain a 3-octet Fibre Channel ID,
|
|
if the value of the associated instance of
|
|
hpnicfFcTraceRouteAddressType object is 'fcid'."
|
|
::= { hpnicfFcTraceRouteEntry 4 }
|
|
|
|
hpnicfFcTraceRouteTimeout OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..10)
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The value of timeout for this trace route request.
|
|
If the corresponding instance value of
|
|
hpnicfFcTraceRouteOperStatus object is 'inProgress',
|
|
this object cannot be modified."
|
|
DEFVAL { 5 }
|
|
::= { hpnicfFcTraceRouteEntry 5 }
|
|
|
|
hpnicfFcTraceRouteAdminStatus OBJECT-TYPE
|
|
SYNTAX HpnicfFcStartOper
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The administrative status of each hpnicfFcTraceRouteEntry.
|
|
|
|
The object has two values:
|
|
enable - Activate the entry.
|
|
disable - Deactivate the entry.
|
|
|
|
When the trace route entry is being executed, this object
|
|
cannot be modified. If this object is being read, a value
|
|
of 'enable' will be returned. When the execution finishes,
|
|
the value of this object will be set to 'disable'."
|
|
DEFVAL { disable }
|
|
::= { hpnicfFcTraceRouteEntry 6 }
|
|
|
|
hpnicfFcTraceRouteOperStatus OBJECT-TYPE
|
|
SYNTAX INTEGER {
|
|
inProgress(1), -- trace route in progress
|
|
success(2), -- trace route success
|
|
partialSuccess(3), -- trace route partial success
|
|
failure(4), -- trace route failure
|
|
disabled(5) -- trace route is disabled
|
|
}
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the operational status
|
|
of this hpnicfFcTraceRouteEntry.
|
|
|
|
The value specifications are listed as follows:
|
|
inProgress - Trace route is in progress.
|
|
success - Trace route has succeeded.
|
|
partialSuccess - Trace route has partially succeeded.
|
|
failure - Trace route has failed due to resource limitations.
|
|
disabled - Trace route is disabled."
|
|
::= { hpnicfFcTraceRouteEntry 7 }
|
|
|
|
hpnicfFcTraceRouteAgeInterval OBJECT-TYPE
|
|
SYNTAX Unsigned32 (500..900)
|
|
UNITS "seconds"
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The interval time for an entry to age out
|
|
after a trace route test is completed."
|
|
DEFVAL { 500 }
|
|
::= { hpnicfFcTraceRouteEntry 8 }
|
|
|
|
hpnicfFcTraceRouteTrapOnCompletion OBJECT-TYPE
|
|
SYNTAX TruthValue
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates whether a hpnicfFcTraceRouteCompletionNotify
|
|
notification should be generated when this trace route test
|
|
completes."
|
|
DEFVAL { false }
|
|
::= { hpnicfFcTraceRouteEntry 9 }
|
|
|
|
hpnicfFcTraceRouteRowStatus OBJECT-TYPE
|
|
SYNTAX RowStatus
|
|
MAX-ACCESS read-create
|
|
STATUS current
|
|
DESCRIPTION
|
|
"The status of this conceptual row."
|
|
::= { hpnicfFcTraceRouteEntry 10 }
|
|
|
|
|
|
-- Trace Route Hops Table
|
|
-- The hpnicfFcTraceRouteHopsTable contains the hop-by-hop result
|
|
-- of a trace route test performed for an entry in the
|
|
-- hpnicfFcTraceRouteTable.
|
|
|
|
hpnicfFcTraceRouteHopsTable OBJECT-TYPE
|
|
SYNTAX SEQUENCE OF HpnicfFcTraceRouteHopsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A table of trace route hop results.
|
|
This table indicates the hop-by-hop result of a trace route test
|
|
associated with an entry in the hpnicfFcTraceRouteTable."
|
|
::= { hpnicfFcTraceRouteResults 1 }
|
|
|
|
hpnicfFcTraceRouteHopsEntry OBJECT-TYPE
|
|
SYNTAX HpnicfFcTraceRouteHopsEntry
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"A trace route hop entry.
|
|
|
|
The first index member specifies the hpnicfFcTraceRouteEntry
|
|
that an hpnicfFcTraceRouteHopsEntry is associated with. The
|
|
second index element identifies a hop in a trace route path.
|
|
|
|
In the case of a complete path being traced, entries
|
|
corresponding to an hpnicfFcTraceRouteEntry are created
|
|
automatically in this table.
|
|
|
|
Each hop in the complete path will be listed in this table.
|
|
|
|
When an hpnicfFcTraceRouteEntry is deleted or aged out, the
|
|
entries corresponding to the hpnicfFcTraceRouteEntry in this
|
|
table are also deleted."
|
|
INDEX { hpnicfFcTraceRouteIndex, hpnicfFcTraceRouteHopsIndex }
|
|
::= { hpnicfFcTraceRouteHopsTable 1 }
|
|
|
|
HpnicfFcTraceRouteHopsEntry ::= SEQUENCE {
|
|
hpnicfFcTraceRouteHopsIndex Unsigned32,
|
|
hpnicfFcTraceRouteHopsAddr HpnicfFcNameId
|
|
}
|
|
|
|
hpnicfFcTraceRouteHopsIndex OBJECT-TYPE
|
|
SYNTAX Unsigned32 (1..65535)
|
|
MAX-ACCESS not-accessible
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object indicates the hop index for a trace route hop.
|
|
|
|
Values for this object associated with the same
|
|
hpnicfFcTraceRouteIndex MUST begin with 1 and
|
|
automatically increase by 1."
|
|
::= { hpnicfFcTraceRouteHopsEntry 1 }
|
|
|
|
hpnicfFcTraceRouteHopsAddr OBJECT-TYPE
|
|
SYNTAX HpnicfFcNameId
|
|
MAX-ACCESS read-only
|
|
STATUS current
|
|
DESCRIPTION
|
|
"This object specifies the WWN of the device associated
|
|
with this hop."
|
|
::= { hpnicfFcTraceRouteHopsEntry 2 }
|
|
|
|
-- Notifications
|
|
|
|
hpnicfFcTraceRouteCompletionNotify NOTIFICATION-TYPE
|
|
OBJECTS { hpnicfFcTraceRouteIndex,
|
|
hpnicfFcTraceRouteVsan,
|
|
hpnicfFcTraceRouteAddressType,
|
|
hpnicfFcTraceRouteAddress,
|
|
hpnicfFcTraceRouteOperStatus }
|
|
STATUS current
|
|
DESCRIPTION
|
|
"When a trace route test is finished and the instance of
|
|
hpnicfFcTraceRouteTrapOnCompletion associated with the test
|
|
is set to 'true', this notification occurred."
|
|
::= { hpnicfFcTraceRouteNotifyPrefix 1 }
|
|
|
|
END
|