💾 Archived View for gemini.bortzmeyer.org › rfc-mirror › rfc4935.txt captured on 2023-12-28 at 17:44:20.
⬅️ Previous capture (2021-11-30)
-=-=-=-=-=-=-
Network Working Group C. DeSanti
Request for Comments: 4935 H.K. Vivek
Category: Standards Track K. McCloghrie
Cisco Systems
S. Gai
Nuova Systems
August 2007
Fibre Channel Fabric Configuration Server MIB
Status of This Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (C) The IETF Trust (2007).
Abstract
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
In particular, it describes managed objects for information related
to the Fabric Configuration Server function of a Fibre Channel
network.
DeSanti, et al. Standards Track [Page 1]
RFC 4935 Fabric Configuration Server MIB August 2007
Table of Contents
1. Introduction ....................................................3
2. The Internet-Standard Management Framework ......................3
3. Short Overview of Fibre Channel .................................3
4. Relationship to Other MIBs ......................................5
5. MIB Overview ....................................................5
5.1. Fibre Channel Management Instance ..........................6
5.2. Switch Index ...............................................6
5.3. Fabric Index ...............................................6
5.4. The MIB Groups .............................................7
5.5. OS Logical Unit Number (LUN) Map Entries ...................8
6. The T11-FC-FABRIC-CONFIG-SERVER-MIB Module ......................9
7. IANA Considerations ............................................45
8. Security Considerations ........................................45
9. Acknowledgements ...............................................46
10. Normative References ..........................................47
11. Informative References ........................................48
DeSanti, et al. Standards Track [Page 2]
RFC 4935 Fabric Configuration Server MIB August 2007
1. Introduction
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
In particular, it describes managed objects for information related
to a Fibre Channel network's Fabric Configuration Server function,
which provides a means by which a management application can discover
Fibre Channel fabric topology and attributes. Discovered topology
includes Interconnect Elements (i.e., switches, hubs, bridges, etc.)
and their ports, as well as "platforms" that consist of one or more
Fibre Channel nodes.
This memo was previously approved by INternational Committee for
Information Technology Standards (INCITS) Task Group T11.5
(http://www.t11.org); this document is a product of the IETF's IMSS
working group.
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in BCP 14, RFC 2119
[RFC2119].
2. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of
RFC 3410 [RFC3410].
Managed objects are accessed via a virtual information store, termed
the Management Information Base or MIB. MIB objects are generally
accessed through the Simple Network Management Protocol (SNMP).
Objects in the MIB are defined using the mechanisms defined in the
Structure of Management Information (SMI). This memo specifies a MIB
module that is compliant to the SMIv2, which is described in STD 58,
RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580
[RFC2580].
3. Short Overview of Fibre Channel
The Fibre Channel (FC) is logically a bidirectional point-to-point
serial data channel, structured for high performance. Fibre Channel
provides a general transport vehicle for higher-level protocols such
as Small Computer System Interface (SCSI) command sets, the High-
Performance Parallel Interface (HIPPI) data framing, IP (Internet
Protocol), IEEE 802.2, and others.
Physically, Fibre Channel is an interconnection of multiple
communication points, called N_Ports, interconnected either by a
DeSanti, et al. Standards Track [Page 3]
RFC 4935 Fabric Configuration Server MIB August 2007
switching network, called a Fabric, or by a point-to-point link. A
Fibre Channel "node" consists of one or more N_Ports. A Fabric may
consist of multiple Interconnect Elements, some of which are
switches. An N_Port connects to the Fabric via a port on a switch
called an F_Port. When multiple FC nodes are connected to a single
port on a switch via an "Arbitrated Loop" topology, the switch port
is called an FL_Port, and the nodes' ports are called NL_Ports. The
term Nx_Port is used to refer to either an N_Port or an NL_Port. The
term Fx_Port is used to refer to either an F_Port or an FL_Port. A
switch port, which is interconnected to another switch port via an
Inter-Switch Link (ISL), is called an E_Port. A B_Port connects a
bridge device with an E_Port on a switch; a B_Port provides a subset
of E_Port functionality.
Many Fibre Channel components, including the Fabric, each node, and
most ports, have globally unique names. These globally unique names
are typically formatted as World Wide Names (WWNs). More information
on WWNs can be found in [FC-FS]. WWNs are expected to be persistent
across agent and unit resets.
Fibre Channel frames contain 24-bit address identifiers that identify
the frame's source and destination ports. Each FC port has both an
address identifier and a WWN. When a Fabric is in use, the FC
address identifiers are dynamic and are assigned by a switch. Each
octet of a 24-bit address represents a level in an address hierarchy,
with a Domain_ID being the highest level of the hierarchy.
The Fibre Channel Fabric Configuration Server provides a way for a
management application to discover Fibre Channel fabric topology and
attributes. The Fabric Configuration Server is designed so that it
can be distributed among switches and accessed from any Nx_Port.
However, the Fabric Configuration Server is not restricted or
required to be part of/within a Fabric.
The information registered with and available from each Fabric
Configuration Server is modeled as a Fabric consisting of one or more
Interconnect Elements that each have some number of physical Ports,
and one or more Fibre Channel nodes grouped together into Platforms
to facilitate discovery and management. The Ports are connected
either to other Ports on other Interconnect Elements, or to Nx_Ports.
Each Interconnect Element may have attributes including its name,
type, Domain Identifier, Management Identifier, Logical Name,
Management Address(es), Information List, Zoning Enforcement Status,
etc. Each Port may have attributes including its name, type, TX
type, Module type, physical port number, attached port name(s), port
state, speed, etc. Each platform may have attributes including its
name, type, description, label, location, management address, etc.
DeSanti, et al. Standards Track [Page 4]
RFC 4935 Fabric Configuration Server MIB August 2007
The Fibre Channel Fabric Configuration Server is defined in the FC-GS
specification. The Fabric Configuration Server is one of a set of
functions that are collectively known as the Management Service. The
latest version of the specification is [FC-GS-5].
The latest standard for an interconnecting Fabric containing multiple
Fabric Switch elements is [FC-SW-4]. [FC-SW-4] carries forward the
earlier specification for the operation of a single Fabric in a
physical infrastructure, and augments it with the definition of
Virtual Fabrics and with the specification of how multiple Virtual
Fabrics can operate within one (or more) physical infrastructures.
The use of Virtual Fabrics provides for each frame to be tagged in
its header to indicate which one of several Virtual Fabrics that
frame is being transmitted on. All frames entering a particular
"Core Switch" [FC-SW-4] (i.e., a physical switch) on the same Virtual
Fabric are processed by the same "Virtual Switch" within that Core
Switch.
4. Relationship to Other MIBs
The first standardized MIB for Fibre Channel [RFC2837] was focused on
Fibre Channel switches. It has been replaced by the more generic
Fibre Channel Management MIB [RFC4044], which defines basic
information for Fibre Channel hosts and switches, including
extensions to the standard IF-MIB for Fibre Channel interfaces.
This MIB extends beyond [RFC4044] to cover the functionality, in
Fibre Channel switches, of providing Fibre Channel's Fabric
Configuration Server function.
This MIB imports some common Textual Conventions from T11-TC-MIB
[RFC4439] and from T11-FC-NAME-SERVER-MIB [RFC4438]. It also imports
URLString from NETWORK-SERVICES-MIB [RFC2788].
5. MIB Overview
This MIB module provides the means for monitoring the operation of,
and configuring some parameters of, one or more Fabric Configuration
Servers (FCS) in a Fibre Channel (FC) network. The capabilities
provided include triggering a discovery of the configuration of one
or more Fabrics, retrieving the results of such a discovery, as well
as controlling and monitoring the operation of an FCS. The
discovered configuration contains information about:
- Interconnect Elements (IEs), i.e., switches, hubs, bridges, etc.,
- Ports on IEs, and
- Platforms that consist of one or more FC nodes.
DeSanti, et al. Standards Track [Page 5]
RFC 4935 Fabric Configuration Server MIB August 2007
5.1. Fibre Channel Management Instance
A Fibre Channel management instance is defined in [RFC4044] as a
separable managed instance of Fibre Channel functionality. Fibre
Channel functionality may be grouped into Fibre Channel management
instances in whatever way is most convenient for the
implementation(s). For example, one such grouping accommodates a
single SNMP agent having multiple AgentX [RFC2741] sub-agents, with
each sub-agent implementing a different Fibre Channel management
instance.
The object, fcmInstanceIndex, is IMPORTed from the FC-MGMT-MIB
[RFC4044] as the index value to uniquely identify each Fibre Channel
management instance, for example, within the same SNMP context
([RFC3411], section 3.3.1).
5.2. Switch Index
The FC-MGMT-MIB [RFC4044] defines the fcmSwitchTable as a table of
information about Fibre Channel switches that are managed by Fibre
Channel management instances. Each Fibre Channel management instance
can manage one or more Fibre Channel switches. The Switch Index,
fcmSwitchIndex, is IMPORTed from the FC-MGMT-MIB as the index value
to uniquely identify a Fibre Channel switch amongst those (one or
more) managed by the same Fibre Channel management instance.
5.3. Fabric Index
With multiple Fabrics, each Fabric has its own instances of the
Fabric-related management instrumentation. Thus, this MIB defines
all Fabric-related information in tables that are INDEXed by an
arbitrary integer, named a "Fabric Index". The syntax of a Fabric
Index is T11FabricIndex, imported from T11-TC-MIB [RFC4439]. When a
device is connected to a single physical Fabric, without use of any
virtual Fabrics, the value of this Fabric Index will always be 1. In
an environment of multiple virtual and/or physical Fabrics, this
index provides a means to distinguish one Fabric from another.
It is quite possible, and may even be likely, that a Fibre Channel
switch will have ports connected to multiple virtual and/or physical
Fabrics. Thus, in order to simplify a management protocol query
concerning all the Fabrics to which a single switch is connected,
fcmSwitchIndex will be listed before t11FcsFabricIndex when they both
appear in the same INDEX clause.
DeSanti, et al. Standards Track [Page 6]
RFC 4935 Fabric Configuration Server MIB August 2007
5.4. The MIB Groups
This section describes the six MIB groups contained in the MIB
module.
5.4.1. The t11FcsDiscoveredConfigGroup Group
This group contains the Fabric configuration information discovered
by Fabric Configuration Servers.
5.4.2. The t11FcsDiscoveryStatusGroup Group
This group contains objects by which to monitor the status of
discovery of Fabric configurations by Fabric Configuration Servers.
5.4.3. The t11FcsDiscoveryControlGroup Group
This group contains objects for requesting a Fabric Configuration
Server to discover the configuration of one or more Fabrics.
5.4.4. The t11FcsStatisticsGroup Group
This group contains objects for Fabric Configuration Server
statistics information.
5.4.5. The t11FcsNotificationGroup Group
This group contains three notifications, generated when an FCS:
- rejects a registration, deregistration, or query request;
- completes discovery on a range of Fabrics;
- learns that a management address of an Interconnect Element has
changed.
5.4.5.1. Flow Control for Notifications
When defining SNMP notifications for events that occur in the data-
plane, the maximum frequency of their generation needs to be
considered. Unless there is some limiting factor, such notifications
need to be flow-controlled in some way, e.g., defined such that after
some maximum number within a specified time interval have occurred,
further notifications are suppressed for some subsequent time
interval. However, as and when such a suppression occurs, the
Network Management System (NMS) that didn't receive the notifications
(because they were suppressed) needs to be able to obtain an
indication of how many were suppressed. Therefore, an additional
Counter32 object needs to be defined, and/or a new type of
notification needs to be defined for use at the end of the interval.
DeSanti, et al. Standards Track [Page 7]
RFC 4935 Fabric Configuration Server MIB August 2007
While this is extra complexity, it is necessary for notifications
that need to be flow-controlled.
In contrast, for notifications such as all the ones defined in this
MIB module, which are generated due to control-plane events (and are
not able to start a chain reaction):
- estimating the maximum number that could possibly be generated per
unit time for each type of notification is too simplistic. For
example, it's unreasonable to ask how many of the
t11FcsDiscoveryCompleteNotify notifications can be generated in a
time interval, because it depends on several factors: how big is
the network? how many Virtual Fabrics need to be discovered? how
quickly can the operator ask for another discovery after the last
one completes?
- the extra complexity of flow-controlling these types of
notifications is not warranted.
5.4.6. The t11FcsNotificationInfoGroup Group
This group contains notification control and notification information
objects for monitoring Fabric Configuration Server request rejection
and discovery of topology information.
5.5. OS Logical Unit Number (LUN) Map Entries
A "Platform" is defined in FC-GS-5 to be not only a set of zero or
more FC nodes, but also a set of zero or more "OS LUN Map Entries"
(see Figure 8 in [FC-GS-5]). Information on "OS LUN Map Entries" is
not included in this T11-FC-FABRIC-CONFIG-SERVER-MIB. Instead,
information on LUN Maps can be obtained via the scsiLunMapGroup
object group defined in the SCSI-MIB [RFC4455].
DeSanti, et al. Standards Track [Page 8]
RFC 4935 Fabric Configuration Server MIB August 2007
6. The T11-FC-FABRIC-CONFIG-SERVER-MIB Module
T11-FC-FABRIC-CONFIG-SERVER-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE,
NOTIFICATION-TYPE, mib-2, Counter32, Unsigned32
FROM SNMPv2-SMI -- [RFC2578]
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
FROM SNMPv2-CONF -- [RFC2580]
TEXTUAL-CONVENTION, TruthValue, TimeStamp
FROM SNMPv2-TC -- [RFC2579]
SnmpAdminString
FROM SNMP-FRAMEWORK-MIB -- [RFC3411]
URLString
FROM NETWORK-SERVICES-MIB -- [RFC2788]
FcPortType, FcNameIdOrZero, FcDomainIdOrZero,
fcmInstanceIndex, fcmSwitchIndex, FcAddressIdOrZero
FROM FC-MGMT-MIB -- [RFC4044]
T11NsGs4RejectReasonCode
FROM T11-FC-NAME-SERVER-MIB -- [RFC4438]
T11FabricIndex
FROM T11-TC-MIB -- [RFC4439]
t11FamLocalSwitchWwn
FROM T11-FC-FABRIC-ADDR-MGR-MIB; -- [RFC4439]
t11FcFabricConfigServerMIB MODULE-IDENTITY
LAST-UPDATED "200706270000Z"
ORGANIZATION "For the initial versions, T11.
For later versions, the IETF's IMSS Working Group."
CONTACT-INFO
" Claudio DeSanti
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134 USA
EMail: cds@cisco.com
Keith McCloghrie
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134 USA
EMail: kzm@cisco.com"
DESCRIPTION
"The MIB module for the management of a Fabric
Configuration Server (FCS) in a Fibre Channel (FC)
network. An FCS is defined by the FC-GS-5 standard. This
DeSanti, et al. Standards Track [Page 9]
RFC 4935 Fabric Configuration Server MIB August 2007
MIB provides the capabilities to trigger a discovery of
the configuration of one or more Fabrics, to retrieve the
results of such a discovery, as well as to control and
monitor the operation of an FCS. The discovered
configuration contains information about:
- Interconnect Elements (IEs), i.e., switches, hubs,
bridges, etc.,
- Ports on IEs, and
- Platforms that consist of one or more FC nodes.
Copyright (C) The IETF Trust (2007). This version of
this MIB module is part of RFC 4935; see the RFC itself for
full legal notices."
REVISION "200706270000Z"
DESCRIPTION
"Initial version of this MIB module, published as RFC 4935."
::= { mib-2 162 }
t11FcsMIBObjects OBJECT IDENTIFIER
::= { t11FcFabricConfigServerMIB 1 }
t11FcsMIBConformance OBJECT IDENTIFIER
::= { t11FcFabricConfigServerMIB 2 }
t11FcsNotifications OBJECT IDENTIFIER
::= { t11FcFabricConfigServerMIB 0 }
t11FcsDiscovery OBJECT IDENTIFIER ::= { t11FcsMIBObjects 1 }
t11FcsDiscoveredConfig OBJECT IDENTIFIER ::= { t11FcsMIBObjects 2 }
t11FcsStats OBJECT IDENTIFIER ::= { t11FcsMIBObjects 3 }
t11FcsNotificationInfo OBJECT IDENTIFIER ::= { t11FcsMIBObjects 4 }
--
-- Textual Conventions
--
T11FcListIndex ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d"
STATUS current
DESCRIPTION
"An index that identifies a list of elements.
All elements that belong to the same list have the
same index value. This syntax is used for objects
which identify a list in the INDEX clause of a table
of elements of that type of list."
SYNTAX Unsigned32 (1..4294967295)
T11FcListIndexPointerOrZero ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d"
DeSanti, et al. Standards Track [Page 10]
RFC 4935 Fabric Configuration Server MIB August 2007
STATUS current
DESCRIPTION
"Objects with this syntax point to a list of elements
contained in a table, by holding the same value as the
object with syntax T11FcListIndex defined in the table's
INDEX clause, or, zero to indicate an empty list.
Note that such a table could have one row per list, or
it could have one row per element of a list.
The definition of an object with this syntax must
identify the table(s) into which it points."
SYNTAX Unsigned32 -- the default range of (0..4294967295)
T11FcIeType ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The type of Interconnect Element (IE):
unknown(1) - an unknown IE.
other(2) - some other type of IE.
switch(3) - the IE is a switch.
hub(4) - the IE is a hub.
bridge(5) - the IE is a bridge."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, Table 96."
SYNTAX INTEGER {
unknown(1),
other(2),
switch(3),
hub(4),
bridge(5)
}
T11FcPortState ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The state of a port:
unknown(1) - unknown state.
other(2) - some other state.
online(3) - port is in online state.
offline(4) - port is in offline state.
testing(5) - port is in testing state.
fault(6) - port is faulty."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, Table 106."
DeSanti, et al. Standards Track [Page 11]
RFC 4935 Fabric Configuration Server MIB August 2007
SYNTAX INTEGER {
unknown(1),
other(2),
online(3),
offline(4),
testing(5),
fault(6)
}
T11FcPortTxType ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The technology of the port transceiver:
unknown(1) - unknown (includes the 'null' type)
other(2) - some other technology
shortwave850nm(3) - Short wave laser - SN (850 nm)
longwave1550nm(4) - Long wave laser - LL (1550 nm)
longwave1310nm(5) - Long wave laser cost
reduced - LC (1310 nm)
electrical(6) - Electrical - EL.
tenGbaseSr850(7) - 10GBASE-SR 850nm laser
tenGbaseLr1310(8) - 10GBASE-LR 1310nm laser
tenGbaseEr1550(9) - 10GBASE-ER 1550nm laser
tenGbaseLx1300(10) - 10GBASE-LX4 WWDM 1300nm laser
tenGbaseSw850(11) - 10GBASE-SW 850nm laser
tenGbaseLw1310(12) - 10GBASE-LW 1310nm laser
tenGbaseEw1550(13) - 10GBASE-EW 1550nm laser
"
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, Table 101."
SYNTAX INTEGER {
unknown(1),
other(2),
shortwave850nm(3),
longwave1550nm(4),
longwave1310nm(5),
electrical(6),
tenGbaseSr850(7),
tenGbaseLr1310(8),
tenGbaseEr1550(9),
tenGbaseLx1300(10),
tenGbaseSw850(11),
tenGbaseLw1310(12),
tenGbaseEw1550(13)
}
DeSanti, et al. Standards Track [Page 12]
RFC 4935 Fabric Configuration Server MIB August 2007
T11FcsRejectReasonExplanation ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION
"The reject reason code explanation:
noAdditionalExplanation(1)
- no additional explanation.
invNameIdForIEOrPort(2)
- the format of IE or port name is invalid.
ieListNotAvailable(3)
- IE list is not available.
ieTypeNotAvailable(4)
- IE type is not available.
domainIdNotAvailable(5)
- Domain ID is not available.
mgmtIdNotAvailable(6)
- mgmt ID is not available.
fabNameNotAvailable(7)
- Fabric_Name is not available.
ielogNameNotAvailable(8)
- IE logical name is not available.
mgmtAddrListNotAvailable(9)
- mgmt address list is not available.
ieInfoListNotAvailable(10)
- IE info list is not available.
portListNotAvailable(11)
- port list is not available.
portTypeNotAvailable(12)
- port type is not available.
phyPortNumNotAvailable(13)
- physical port number is not available.
attPortNameListNotAvailable(14)
- attached port name list is not available.
portStateNotAvailable(15)
- port state is not available.
unableToRegIELogName(16)
- not able to register IE logical name.
platformNameNoExist(17)
- platform name does not exist.
platformNameAlreadyExists(18)
- platform name already exists.
platformNodeNameNoExists(19)
- platform node name does not exist.
platformNodeNameAlreadyExists(20)
- platform node name already exists.
resourceUnavailable(21)
- resource unavailable.
noEntriesInLunMap(22)
DeSanti, et al. Standards Track [Page 13]
RFC 4935 Fabric Configuration Server MIB August 2007
- zero entries in OS LUN Map.
invalidDeviceNameLength(23)
- invalid OS device name length.
multipleAttributes(24)
- multiple attributes of same type in
platform attribute block.
invalidAttribBlockLength(25)
- invalid platform attribute block length.
attributesMissing(26)
- required platform attributes not present."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, Table 124."
SYNTAX INTEGER {
noAdditionalExplanation(1),
invNameIdForIEOrPort(2),
ieListNotAvailable(3),
ieTypeNotAvailable(4),
domainIdNotAvailable(5),
mgmtIdNotAvailable(6),
fabNameNotAvailable(7),
ielogNameNotAvailable(8),
mgmtAddrListNotAvailable(9),
ieInfoListNotAvailable(10),
portListNotAvailable(11),
portTypeNotAvailable(12),
phyPortNumNotAvailable(13),
attPortNameListNotAvailable(14),
portStateNotAvailable(15),
unableToRegIELogName(16),
platformNameNoExist(17),
platformNameAlreadyExists(18),
platformNodeNameNoExists(19),
platformNodeNameAlreadyExists(20),
resourceUnavailable(21),
noEntriesInLunMap(22),
invalidDeviceNameLength(23),
multipleAttributes(24),
invalidAttribBlockLength(25),
attributesMissing(26)
}
--
-- Objects for Fabric Discovery
--
t11FcsFabricDiscoveryTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsFabricDiscoveryEntry
DeSanti, et al. Standards Track [Page 14]
RFC 4935 Fabric Configuration Server MIB August 2007
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains control information for discovery
of Fabric configuration by switches.
Values written to objects in this table are not
retained over agent reboots."
::= { t11FcsDiscovery 1 }
t11FcsFabricDiscoveryEntry OBJECT-TYPE
SYNTAX T11FcsFabricDiscoveryEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Control information for discovery by the switch
identified by fcmInstanceIndex and fcmSwitchIndex."
INDEX { fcmInstanceIndex, fcmSwitchIndex }
::= { t11FcsFabricDiscoveryTable 1 }
T11FcsFabricDiscoveryEntry ::= SEQUENCE {
t11FcsFabricDiscoveryRangeLow T11FabricIndex,
t11FcsFabricDiscoveryRangeHigh T11FabricIndex,
t11FcsFabricDiscoveryStart INTEGER,
t11FcsFabricDiscoveryTimeOut Unsigned32
}
t11FcsFabricDiscoveryRangeLow OBJECT-TYPE
SYNTAX T11FabricIndex
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The discovery by a particular switch operates
within all existing Fabrics that have a Fabric
Index within a specific inclusive range. This
object specifies the minimum Fabric Index value
within that range. This value just represents
the lower end of the range and does not necessarily
represent any existing Fabric."
::= { t11FcsFabricDiscoveryEntry 1 }
t11FcsFabricDiscoveryRangeHigh OBJECT-TYPE
SYNTAX T11FabricIndex
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The discovery by a particular switch operates
within all existing Fabrics that have a Fabric
DeSanti, et al. Standards Track [Page 15]
RFC 4935 Fabric Configuration Server MIB August 2007
Index within a specific inclusive range. This
object specifies the maximum Fabric Index value
within that range. This value just represents the
higher end of the range and does not necessarily
represent any existing Fabric."
::= { t11FcsFabricDiscoveryEntry 2 }
t11FcsFabricDiscoveryStart OBJECT-TYPE
SYNTAX INTEGER {
start(1),
noOp(2)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object provides the capability to trigger the start
of a discovery by a Fabric Configuration Server. If this
object is set to 'start', then the discovery is started on
those Fabrics that have their Fabric Index value in the
range specified by t11FcsFabricDiscoveryRangeLow and
t11FcsFabricDiscoveryRangeHigh. It is recommended that
whenever an instance of this object is set to 'start',
that the desired range be specified at the same time by
setting the corresponding instances of
t11FcsFabricDiscoveryRangeLow and
t11FcsFabricDiscoveryRangeHigh.
Setting this object to 'start' will be rejected if a
discovery is already/still in progress on any Fabrics in
the specified range.
No action is taken if this object is set to 'noOp'.
The value of this object when read is always 'noOp'."
::= { t11FcsFabricDiscoveryEntry 3 }
t11FcsFabricDiscoveryTimeOut OBJECT-TYPE
SYNTAX Unsigned32 (300..86400)
UNITS "Seconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The minimum interval of time for which the discovered
Fabric information is cached by a Fabric Configuration
Server."
DEFVAL { 900 }
::= { t11FcsFabricDiscoveryEntry 4 }
--
DeSanti, et al. Standards Track [Page 16]
RFC 4935 Fabric Configuration Server MIB August 2007
-- Discovery State table
--
t11FcsDiscoveryStateTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsDiscoveryStateEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains the status of discovery of
locally known Fabrics."
::= { t11FcsDiscovery 2 }
t11FcsDiscoveryStateEntry OBJECT-TYPE
SYNTAX T11FcsDiscoveryStateEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The discovery status for a particular Fabric on the
switch identified by fcmInstanceIndex and fcmSwitchIndex."
INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FcsFabricIndex }
::= { t11FcsDiscoveryStateTable 1 }
T11FcsDiscoveryStateEntry ::= SEQUENCE {
t11FcsFabricIndex T11FabricIndex,
t11FcsDiscoveryStatus INTEGER,
t11FcsDiscoveryCompleteTime TimeStamp
}
t11FcsFabricIndex OBJECT-TYPE
SYNTAX T11FabricIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A unique index value that uniquely identifies a
particular Fabric.
In a Fabric conformant to FC-SW-4, multiple Virtual Fabrics
can operate within one (or more) physical infrastructures,
and this index value is used to uniquely identify a
particular (physical or virtual) Fabric within a physical
infrastructure.
In a Fabric conformant to versions earlier than FC-SW-4,
only a single Fabric could operate within a physical
infrastructure, and thus, the value of this Fabric Index
was defined to always be 1."
::= { t11FcsDiscoveryStateEntry 1 }
DeSanti, et al. Standards Track [Page 17]
RFC 4935 Fabric Configuration Server MIB August 2007
t11FcsDiscoveryStatus OBJECT-TYPE
SYNTAX INTEGER {
inProgress(1),
completed(2),
localOnly(3)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The status of the discovery for the particular Fabric.
Initially when the switch comes up, all instances of this
object have the value: 'localOnly', and the database
contains only local information, i.e., no information
discovered via the Fabric Configuration Server protocol
specified in FC-GS-5.
If t11FcsFabricDiscoveryStart is set to 'start' for a
range of Fabrics that includes this Fabric, then the
value of this object transitions to 'inProgress'. When
the discovery completes, this object transitions to
'completed', and the data is cached for the minimum
interval of time specified by
t11FcsFabricDiscoveryTimeOut. After this interval has
been exceeded, the data may be lost, in which case, the
value of this object changes to 'localOnly'.
This object cannot be set via SNMP to any value other
than 'localOnly'. If this object is set (via SNMP) to
'localOnly', the cached data for the Fabric is discarded
immediately, and if a discovery initiated from this
switch was in progress for this Fabric, then that
discovery is aborted."
::= { t11FcsDiscoveryStateEntry 2 }
t11FcsDiscoveryCompleteTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object contains the value of sysUpTime at which
discovery was most recently completed or aborted on this
Fabric. This object contains the value of zero before
the first discovery on this Fabric."
::= { t11FcsDiscoveryStateEntry 3 }
DeSanti, et al. Standards Track [Page 18]
RFC 4935 Fabric Configuration Server MIB August 2007
--
-- The Database of Fabric Configuration Information
--
-- Interconnect Element table
--
t11FcsIeTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsIeEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of Interconnect Elements. Interconnect
Elements (IEs) are switches, hubs, bridges etc.
By default, the Fabric Configuration Server will
maintain detailed information pertaining only to
local resources. As far as discovered topology is
concerned, only the IE name, type, and Domain ID
information will be maintained. If a discovery
cycle is triggered on a set of Fabrics, this table
along with the Port and Platform tables will be
populated with the discovered information. The
discovered data will be retained in this table for
at least t11FcsFabricDiscoveryTimeOut seconds after
the completion of its discovery or until the
discovered data is invalidated."
::= { t11FcsDiscoveredConfig 1 }
t11FcsIeEntry OBJECT-TYPE
SYNTAX T11FcsIeEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about an Interconnect Element that was
discovered on a Fabric (identified by t11FcsFabricIndex),
by a switch (identified by fcmInstanceIndex and
fcmSwitchIndex)."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2."
INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FcsFabricIndex,
t11FcsIeName }
::= { t11FcsIeTable 1 }
T11FcsIeEntry ::= SEQUENCE {
t11FcsIeName FcNameIdOrZero,
t11FcsIeType T11FcIeType,
DeSanti, et al. Standards Track [Page 19]
RFC 4935 Fabric Configuration Server MIB August 2007
t11FcsIeDomainId FcDomainIdOrZero,
t11FcsIeMgmtId FcAddressIdOrZero,
t11FcsIeFabricName FcNameIdOrZero,
t11FcsIeLogicalName OCTET STRING,
t11FcsIeMgmtAddrListIndex T11FcListIndexPointerOrZero,
t11FcsIeInfoList OCTET STRING
}
t11FcsIeName OBJECT-TYPE
SYNTAX FcNameIdOrZero (SIZE(8 | 16))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The WWN of an Interconnect Element. This object
uniquely identifies an Interconnect Element on a
Fabric. If the IE is a switch, then this object
is the Switch_Name (WWN) of the switch."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2.1."
::= { t11FcsIeEntry 1 }
t11FcsIeType OBJECT-TYPE
SYNTAX T11FcIeType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of this Interconnect Element."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2.2"
::= { t11FcsIeEntry 2 }
t11FcsIeDomainId OBJECT-TYPE
SYNTAX FcDomainIdOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Domain ID of this Interconnect Element."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2.3."
::= { t11FcsIeEntry 3 }
t11FcsIeMgmtId OBJECT-TYPE
SYNTAX FcAddressIdOrZero
MAX-ACCESS read-only
STATUS current
DeSanti, et al. Standards Track [Page 20]
RFC 4935 Fabric Configuration Server MIB August 2007
DESCRIPTION
"The management identifier of this Interconnect Element.
If the Interconnect Element is a switch, this object will
be the Domain Controller identifier of the switch. When
the value of the identifier is unknown, this object
contains the all-zeros value: x'00 00 00'."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2.4."
DEFVAL { '000000'h }
::= { t11FcsIeEntry 4 }
t11FcsIeFabricName OBJECT-TYPE
SYNTAX FcNameIdOrZero (SIZE(8 | 16))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Fabric_Name (WWN) of this Interconnect Element.
When the Fabric_Name is unknown, this object contains
the all-zeros value: x'00 00 00 00 00 00 00 00'."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2.5."
DEFVAL { '0000000000000000'h }
::= { t11FcsIeEntry 5 }
t11FcsIeLogicalName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..255))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The logical name of this Interconnect Element.
When the logical name is unknown, this object contains
the zero-length string."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2.6."
::= { t11FcsIeEntry 6 }
t11FcsIeMgmtAddrListIndex OBJECT-TYPE
SYNTAX T11FcListIndexPointerOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The management address list for this Interconnect Element.
This object points to an entry in the
t11FcsMgmtAddrListTable."
REFERENCE
DeSanti, et al. Standards Track [Page 21]
RFC 4935 Fabric Configuration Server MIB August 2007
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2.7."
::= { t11FcsIeEntry 7 }
t11FcsIeInfoList OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..252))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The information list for this Interconnect Element.
The value of this object is formatted as specified in
FC-GS-5, i.e., it has the following substrings in order:
vendor name, model name/number, and release code/level,
followed by zero or more substrings of vendor-specific
information. Each substring is terminated with a byte
containing a null value (x'00')."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2.8"
::= { t11FcsIeEntry 8 }
--
-- Management Address List table
--
t11FcsMgmtAddrListTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsMgmtAddrListEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains the set of management address lists
that are currently referenced by any instance of the
t11FcsIeMgmtAddrListIndex or
t11FcsPlatformMgmtAddrListIndex objects."
::= { t11FcsDiscoveredConfig 2 }
t11FcsMgmtAddrListEntry OBJECT-TYPE
SYNTAX T11FcsMgmtAddrListEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about one management address in a
management address list, which is known to a
switch (identified by fcmInstanceIndex and
fcmSwitchIndex)."
INDEX { fcmInstanceIndex, fcmSwitchIndex,
t11FcsMgmtAddrListIndex, t11FcsMgmtAddrIndex }
DeSanti, et al. Standards Track [Page 22]
RFC 4935 Fabric Configuration Server MIB August 2007
::= { t11FcsMgmtAddrListTable 1 }
T11FcsMgmtAddrListEntry ::= SEQUENCE {
t11FcsMgmtAddrListIndex T11FcListIndex,
t11FcsMgmtAddrIndex Unsigned32,
t11FcsMgmtAddr URLString
}
t11FcsMgmtAddrListIndex OBJECT-TYPE
SYNTAX T11FcListIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The index value of the management address list."
::= { t11FcsMgmtAddrListEntry 1 }
t11FcsMgmtAddrIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An integer value to distinguish different
management addresses in the same list."
::= { t11FcsMgmtAddrListEntry 2 }
t11FcsMgmtAddr OBJECT-TYPE
SYNTAX URLString
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The management address of this entry.
The format of this object is a Uniform Resource
Locator (URL), e.g., for SNMP, see RFC 4088."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.2.7"
::= { t11FcsMgmtAddrListEntry 3 }
--
-- Ports
--
t11FcsPortTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsPortEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
DeSanti, et al. Standards Track [Page 23]
RFC 4935 Fabric Configuration Server MIB August 2007
"This table contains information about the ports of IEs."
::= { t11FcsDiscoveredConfig 4 }
t11FcsPortEntry OBJECT-TYPE
SYNTAX T11FcsPortEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a particular port of an Interconnect
Element (identified by t11FcsIeName). The port is
connected to a Fabric (identified by t11FcsFabricIndex)
and known to a switch (identified by fcmInstanceIndex
and fcmSwitchIndex)."
INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FcsFabricIndex,
t11FcsIeName, t11FcsPortName }
::= { t11FcsPortTable 1 }
T11FcsPortEntry ::= SEQUENCE {
t11FcsPortName FcNameIdOrZero,
t11FcsPortType FcPortType,
t11FcsPortTxType T11FcPortTxType,
t11FcsPortModuleType Unsigned32,
t11FcsPortPhyPortNum Unsigned32,
t11FcsPortAttachPortNameIndex T11FcListIndexPointerOrZero,
t11FcsPortState T11FcPortState,
t11FcsPortSpeedCapab OCTET STRING,
t11FcsPortOperSpeed OCTET STRING,
t11FcsPortZoningEnfStatus OCTET STRING
}
t11FcsPortName OBJECT-TYPE
SYNTAX FcNameIdOrZero (SIZE(8 | 16))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The Port_Name (WWN) of the port for which this row
contains information."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.1."
::= { t11FcsPortEntry 1 }
t11FcsPortType OBJECT-TYPE
SYNTAX FcPortType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Port Type of this port."
DeSanti, et al. Standards Track [Page 24]
RFC 4935 Fabric Configuration Server MIB August 2007
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.2."
::= { t11FcsPortEntry 2 }
t11FcsPortTxType OBJECT-TYPE
SYNTAX T11FcPortTxType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The Port TX Type of this port."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.3."
::= { t11FcsPortEntry 3 }
t11FcsPortModuleType OBJECT-TYPE
SYNTAX Unsigned32 (0..255)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The port module type of this port."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.4."
::= { t11FcsPortEntry 4 }
t11FcsPortPhyPortNum OBJECT-TYPE
SYNTAX Unsigned32 -- the default range of (0..4294967295)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The physical number for this port. FC-GS-5 says that
the contents of this field, which are carried in a field
with a size of 4 bytes, are not to be restricted due to
vendor-specific methods for numbering physical ports."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.5."
::= { t11FcsPortEntry 5 }
t11FcsPortAttachPortNameIndex OBJECT-TYPE
SYNTAX T11FcListIndexPointerOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The attached port name list for this port. This object
points to an entry in the t11FcsAttachPortNameListTable."
DeSanti, et al. Standards Track [Page 25]
RFC 4935 Fabric Configuration Server MIB August 2007
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.6."
::= { t11FcsPortEntry 6 }
t11FcsPortState OBJECT-TYPE
SYNTAX T11FcPortState
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The state of this port."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.7."
::= { t11FcsPortEntry 7 }
t11FcsPortSpeedCapab OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (2))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The port speed capabilities of this port. The two octets
of the value are formatted as described in FC-GS-5."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.8."
::= { t11FcsPortEntry 8 }
t11FcsPortOperSpeed OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (2))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The operating speed of this port. The two octets
of the value are formatted as described in FC-GS-5."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.9."
::= { t11FcsPortEntry 9 }
t11FcsPortZoningEnfStatus OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (12))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The zoning enforcement status of this port. The 12
octets of the value are formatted as described in FC-GS-5."
REFERENCE
DeSanti, et al. Standards Track [Page 26]
RFC 4935 Fabric Configuration Server MIB August 2007
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.10."
::= { t11FcsPortEntry 10 }
--
-- Attached Port List table
--
t11FcsAttachPortNameListTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsAttachPortNameListEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains all the lists of attach port
names."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.6"
::= { t11FcsDiscoveredConfig 5 }
t11FcsAttachPortNameListEntry OBJECT-TYPE
SYNTAX T11FcsAttachPortNameListEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about the name of a particular attached port,
which is known to a switch (identified by fcmInstanceIndex
and fcmSwitchIndex)."
INDEX { fcmInstanceIndex, fcmSwitchIndex,
t11FcsAttachPortNameListIndex, t11FcsAttachPortName }
::= { t11FcsAttachPortNameListTable 1 }
T11FcsAttachPortNameListEntry ::= SEQUENCE {
t11FcsAttachPortNameListIndex T11FcListIndex,
t11FcsAttachPortName OCTET STRING
}
t11FcsAttachPortNameListIndex OBJECT-TYPE
SYNTAX T11FcListIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The index value of the attach port name list."
::= { t11FcsAttachPortNameListEntry 1 }
t11FcsAttachPortName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (12))
MAX-ACCESS read-only
DeSanti, et al. Standards Track [Page 27]
RFC 4935 Fabric Configuration Server MIB August 2007
STATUS current
DESCRIPTION
"The attached port name. Zero or more of these names
may be associated with a port object.
The first 8 bytes of this object contain the WWN of
the port followed by 2 reserved bytes. Following
this is one byte of Port flags and one byte of
Port type, as described in FC-GS-5."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.3.6"
::= { t11FcsAttachPortNameListEntry 2 }
--
-- Platforms
--
t11FcsPlatformTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsPlatformEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains information on platforms.
By default, this table only contains local (e.g., for a
local switch) information. If a discovery is triggered,
this table will also contain information gathered by the
discovery process. The discovered information is retained
in this table for at least t11FcsFabricDiscoveryTimeOut
seconds after the completion of its discovery or until
the discovered cache is invalidated."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4"
::= { t11FcsDiscoveredConfig 6 }
t11FcsPlatformEntry OBJECT-TYPE
SYNTAX T11FcsPlatformEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a particular platform, which is
known to a switch (identified by fcmInstanceIndex and
fcmSwitchIndex).
A platform can contain multiple nodes. Information on
nodes is contained in the t11FcsNodeNameListTable. The
t11FcsPlatformNodeNameListIndex object in this table
DeSanti, et al. Standards Track [Page 28]
RFC 4935 Fabric Configuration Server MIB August 2007
points to the list of nodes contained in this platform.
Similarly, the t11FcsPlatformMgmtAddrListIndex object in
this table points to the list of management addresses
associated with this platform."
INDEX { fcmInstanceIndex, fcmSwitchIndex,
t11FcsFabricIndex, t11FcsPlatformIndex }
::= { t11FcsPlatformTable 1 }
T11FcsPlatformEntry ::= SEQUENCE {
t11FcsPlatformIndex Unsigned32,
t11FcsPlatformName OCTET STRING,
t11FcsPlatformType OCTET STRING,
t11FcsPlatformNodeNameListIndex T11FcListIndexPointerOrZero,
t11FcsPlatformMgmtAddrListIndex T11FcListIndexPointerOrZero,
t11FcsPlatformVendorId SnmpAdminString,
t11FcsPlatformProductId SnmpAdminString,
t11FcsPlatformProductRevLevel SnmpAdminString,
t11FcsPlatformDescription SnmpAdminString,
t11FcsPlatformLabel SnmpAdminString,
t11FcsPlatformLocation SnmpAdminString,
t11FcsPlatformSystemID SnmpAdminString,
t11FcsPlatformSysMgmtAddr T11FcListIndexPointerOrZero,
t11FcsPlatformClusterId SnmpAdminString,
t11FcsPlatformClusterMgmtAddr T11FcListIndexPointerOrZero,
t11FcsPlatformFC4Types OCTET STRING
}
t11FcsPlatformIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..4294967295)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An integer value to distinguish one platform from
other platforms in the same Fabric."
::= { t11FcsPlatformEntry 1 }
t11FcsPlatformName OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (1..255))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The name of this platform. The last byte of the value
indicates the format of the name (even if the name itself
is the zero-length string) as specified in FC-GS-5."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.2"
::= { t11FcsPlatformEntry 2 }
DeSanti, et al. Standards Track [Page 29]
RFC 4935 Fabric Configuration Server MIB August 2007
t11FcsPlatformType OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (4))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type(s) of this platform, encoded in 4 bytes as
specified in FC-GS-5."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.3"
::= { t11FcsPlatformEntry 3 }
t11FcsPlatformNodeNameListIndex OBJECT-TYPE
SYNTAX T11FcListIndexPointerOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The list of nodes for this platform. This object points
to an entry in the t11FcsNodeNameListTable."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.6"
::= { t11FcsPlatformEntry 4 }
t11FcsPlatformMgmtAddrListIndex OBJECT-TYPE
SYNTAX T11FcListIndexPointerOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The list of management addresses for this platform. This
object points to an entry in the t11FcsMgmtAddrListTable."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.7"
::= { t11FcsPlatformEntry 5 }
t11FcsPlatformVendorId OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0 | 12))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The identifier of the vendor of this platform, in the
format specified in FC-GS-5."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.5"
::= { t11FcsPlatformEntry 6 }
DeSanti, et al. Standards Track [Page 30]
RFC 4935 Fabric Configuration Server MIB August 2007
t11FcsPlatformProductId OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0 | 20))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The vendor's product and/or model identifier for this
platform, in the format specified in FC-GS-5."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.5"
::= { t11FcsPlatformEntry 7 }
t11FcsPlatformProductRevLevel OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0 | 4..32))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The product revision level for this platform, in the
format specified in FC-GS-5."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.5"
::= { t11FcsPlatformEntry 8 }
t11FcsPlatformDescription OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0 | 4..128))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The description of this platform, in the
format specified in FC-GS-5. This value should
include the full name and version identification of the
platform's hardware type and software operating system."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.10"
::= { t11FcsPlatformEntry 9 }
t11FcsPlatformLabel OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0 | 4..64))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An administratively assigned symbolic name for the
platform, in the format specified in FC-GS-5."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.11"
DeSanti, et al. Standards Track [Page 31]
RFC 4935 Fabric Configuration Server MIB August 2007
::= { t11FcsPlatformEntry 10 }
t11FcsPlatformLocation OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0 | 4..128))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The physical location of the platform, in the format
specified in FC-GS-5 (e.g., 'telephone closet, 3rd floor')."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.12"
::= { t11FcsPlatformEntry 11 }
t11FcsPlatformSystemID OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0 | 4..64))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An identifier for a hosting system that this platform is
associated with. This identifier is used to associate
platforms of logical types (e.g., logical partitions) with
a physical system."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.5"
::= { t11FcsPlatformEntry 12 }
t11FcsPlatformSysMgmtAddr OBJECT-TYPE
SYNTAX T11FcListIndexPointerOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A list of management addresses for the platform."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, sections 6.2.3.4.5 and 6.2.3.2.7."
::= { t11FcsPlatformEntry 13 }
t11FcsPlatformClusterId OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0 | 4..64))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An identifier for a cluster that this platform is
associated with, where a cluster is a set of independent
platforms that are managed together to provide increased
performance capabilities, failover, etc."
DeSanti, et al. Standards Track [Page 32]
RFC 4935 Fabric Configuration Server MIB August 2007
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.5"
::= { t11FcsPlatformEntry 14 }
t11FcsPlatformClusterMgmtAddr OBJECT-TYPE
SYNTAX T11FcListIndexPointerOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A list of management addresses for the cluster identified
in the corresponding instance of t11FcsPlatformClusterId."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, sections 6.2.3.4.5 and 6.2.3.2.7."
::= { t11FcsPlatformEntry 15 }
t11FcsPlatformFC4Types OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0 | 32))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The FC-4 types supported by this platform, formatted as
a bit mask as specified in FC-GS-5. If this object
contains the zero-length string, the types are unknown."
REFERENCE
"ANSI INCITS 427-2007, Fibre Channel - Generic Services 5,
FC-GS-5, section 6.2.3.4.5"
::= { t11FcsPlatformEntry 16 }
--
-- Node Name List table
--
t11FcsNodeNameListTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsNodeNameListEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains all the lists of nodes."
::= { t11FcsDiscoveredConfig 7 }
t11FcsNodeNameListEntry OBJECT-TYPE
SYNTAX T11FcsNodeNameListEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about a node, which is known to a
DeSanti, et al. Standards Track [Page 33]
RFC 4935 Fabric Configuration Server MIB August 2007
switch (identified by fcmInstanceIndex and
fcmSwitchIndex)."
INDEX { fcmInstanceIndex, fcmSwitchIndex,
t11FcsNodeNameListIndex, t11FcsNodeName }
::= { t11FcsNodeNameListTable 1 }
T11FcsNodeNameListEntry ::= SEQUENCE {
t11FcsNodeNameListIndex T11FcListIndex,
t11FcsNodeName FcNameIdOrZero
}
t11FcsNodeNameListIndex OBJECT-TYPE
SYNTAX T11FcListIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The index value of the node name list."
::= { t11FcsNodeNameListEntry 1 }
t11FcsNodeName OBJECT-TYPE
SYNTAX FcNameIdOrZero (SIZE(8 | 16))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The name of this node."
::= { t11FcsNodeNameListEntry 2 }
--
-- Statistics
--
t11FcsStatsTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains all the statistics related
to the Fabric Configuration Server."
::= { t11FcsStats 1 }
t11FcsStatsEntry OBJECT-TYPE
SYNTAX T11FcsStatsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A set of statistics for a particular Fabric (identified
by t11FcsFabricIndex) on a switch (identified by
fcmInstanceIndex and fcmSwitchIndex)."
DeSanti, et al. Standards Track [Page 34]
RFC 4935 Fabric Configuration Server MIB August 2007
INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FcsFabricIndex }
::= { t11FcsStatsTable 1 }
T11FcsStatsEntry ::= SEQUENCE {
t11FcsInGetReqs Counter32,
t11FcsOutGetReqs Counter32,
t11FcsInRegReqs Counter32,
t11FcsOutRegReqs Counter32,
t11FcsInDeregReqs Counter32,
t11FcsOutDeregReqs Counter32,
t11FcsRejects Counter32
}
t11FcsInGetReqs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Get Requests received by the Fabric
Configuration Server on this Fabric.
This counter has no discontinuities other than
those that all Counter32s have when sysUpTime=0."
::= { t11FcsStatsEntry 1 }
t11FcsOutGetReqs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Get Requests sent by the Fabric
Configuration Server on this Fabric to other
servers in the Fabric.
This counter has no discontinuities other than
those that all Counter32s have when sysUpTime=0."
::= { t11FcsStatsEntry 2 }
t11FcsInRegReqs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Registration Requests received by the
Fabric Configuration Server on this Fabric.
DeSanti, et al. Standards Track [Page 35]
RFC 4935 Fabric Configuration Server MIB August 2007
This counter has no discontinuities other than
those that all Counter32s have when sysUpTime=0."
::= { t11FcsStatsEntry 3 }
t11FcsOutRegReqs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Registration Requests sent by the
Fabric Configuration Server on this Fabric.
This counter has no discontinuities other than
those that all Counter32s have when sysUpTime=0."
::= { t11FcsStatsEntry 4 }
t11FcsInDeregReqs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Deregistration Requests received by
the Fabric Configuration Server on this Fabric.
This counter has no discontinuities other than
those that all Counter32s have when sysUpTime=0."
::= { t11FcsStatsEntry 5 }
t11FcsOutDeregReqs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of Deregistration Requests sent by
the Fabric Configuration Server on this Fabric.
This counter has no discontinuities other than
those that all Counter32s have when sysUpTime=0."
::= { t11FcsStatsEntry 6 }
t11FcsRejects OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The total number of requests rejected by the Fabric
Configuration Server on this Fabric.
DeSanti, et al. Standards Track [Page 36]
RFC 4935 Fabric Configuration Server MIB August 2007
This counter has no discontinuities other than
those that all Counter32s have when sysUpTime=0."
::= { t11FcsStatsEntry 7 }
--
-- Notification Control Table
--
t11FcsNotifyControlTable OBJECT-TYPE
SYNTAX SEQUENCE OF T11FcsNotifyControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of control information for notifications
generated due to Fabric Configuration Server events.
Values written to objects in this table should be
persistent/retained over agent reboots."
::= { t11FcsNotificationInfo 1 }
t11FcsNotifyControlEntry OBJECT-TYPE
SYNTAX T11FcsNotifyControlEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Each entry contains notification control information
for a Fabric Configuration Server on a particular Fabric
(identified by t11FcsFabricIndex) on a particular
switch (identified by fcmInstanceIndex and
fcmSwitchIndex)."
INDEX { fcmInstanceIndex, fcmSwitchIndex,
t11FcsFabricIndex }
::= { t11FcsNotifyControlTable 1 }
T11FcsNotifyControlEntry ::= SEQUENCE {
t11FcsReqRejectNotifyEnable TruthValue,
t11FcsDiscoveryCompNotifyEnable TruthValue,
t11FcsMgmtAddrChangeNotifyEnable TruthValue,
t11FcsRejectCtCommandString OCTET STRING,
t11FcsRejectRequestSource FcNameIdOrZero,
t11FcsRejectReasonCode T11NsGs4RejectReasonCode,
t11FcsRejectReasonCodeExp T11FcsRejectReasonExplanation,
t11FcsRejectReasonVendorCode OCTET STRING
}
t11FcsReqRejectNotifyEnable OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
DeSanti, et al. Standards Track [Page 37]
RFC 4935 Fabric Configuration Server MIB August 2007
STATUS current
DESCRIPTION
"This object specifies if the Fabric Configuration
Server should generate 't11FcsRqRejectNotification'
notifications.
If the value of this object is 'true', then the
notification is issued. If the value of this object
is 'false', then the notification is not issued."
DEFVAL { false }
::= { t11FcsNotifyControlEntry 1 }
t11FcsDiscoveryCompNotifyEnable OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies if the Fabric Configuration
Server should generate 't11FcsDiscoveryCompleteNotify'
notifications.
If the value of this object is 'true', then the
notification is issued. If the value of this object
is 'false', then the notification is not issued."
DEFVAL { false }
::= { t11FcsNotifyControlEntry 2 }
t11FcsMgmtAddrChangeNotifyEnable OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"This object specifies if the Fabric Configuration
Server should generate 't11FcsMgmtAddrChangeNotify'
notifications.
If the value of this object is 'true', then the
notification is issued. If the value of this object
is 'false', then the notification is not issued."
DEFVAL { false }
::= { t11FcsNotifyControlEntry 3 }
t11FcsRejectCtCommandString OBJECT-TYPE
SYNTAX OCTET STRING (SIZE (0..255))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The binary content of the Fabric Configuration Server
DeSanti, et al. Standards Track [Page 38]
RFC 4935 Fabric Configuration Server MIB August 2007
request, formatted as an octet string (in network byte
order) containing the Common Transport Information Unit
(CT_IU), as described in Table 2 of FC-GS-5 (including
the preamble), which was most recently rejected by the
Fabric Configuration Server for this Fabric.
This object contains the zero-length string if and when the
CT-IU's content is unavailable.
When the length of this object is 255 octets, it contains
the first 255 octets of the CT-IU (in network byte order)."
::= { t11FcsNotifyControlEntry 4 }
t11FcsRejectRequestSource OBJECT-TYPE
SYNTAX FcNameIdOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The WWN that was the source of the CT_IU contained in
the corresponding instance of t11FcsRejectCtCommandString."
::= { t11FcsNotifyControlEntry 5 }
t11FcsRejectReasonCode OBJECT-TYPE
SYNTAX T11NsGs4RejectReasonCode
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object contains the reason code corresponding
to the latest Fabric Configuration Server request
rejected by the local system."
::= { t11FcsNotifyControlEntry 6 }
t11FcsRejectReasonCodeExp OBJECT-TYPE
SYNTAX T11FcsRejectReasonExplanation
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"When the corresponding instance of
t11FcsRejectReasonCode has the value: 'unable to
perform command request', this object contains the
corresponding reason code explanation."
::= { t11FcsNotifyControlEntry 7 }
t11FcsRejectReasonVendorCode OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(1))
MAX-ACCESS read-only
STATUS current
DESCRIPTION
DeSanti, et al. Standards Track [Page 39]
RFC 4935 Fabric Configuration Server MIB August 2007
"A registration reject vendor-specific code. This
object contains the vendor-specific code of the most
recently rejected Fabric Configuration Server
Registration request for the particular port on
the particular Fabric."
::= { t11FcsNotifyControlEntry 8 }
--
-- Notifications
--
t11FcsRqRejectNotification NOTIFICATION-TYPE
OBJECTS { t11FamLocalSwitchWwn,
t11FcsRejectReasonCode,
t11FcsRejectReasonCodeExp,
t11FcsRejectReasonVendorCode }
STATUS current
DESCRIPTION
"This notification is generated whenever the Fabric
Configuration Server on a switch (indicated by the
value of t11FamLocalSwitchWwn) rejects a Fabric
Configuration Server request.
The Fabric Configuration Server should update the
t11FcsRejectReasonCode, t11FcsRejectReasonCodeExp
and t11FcsRejectReasonVendorCode objects with the
corresponding reason code, explanation and vendor
specific code before sending the notification."
::= { t11FcsNotifications 1 }
t11FcsDiscoveryCompleteNotify NOTIFICATION-TYPE
OBJECTS {t11FcsFabricDiscoveryRangeLow}
STATUS current
DESCRIPTION
"This notification is generated by the Fabric
Configuration Server on the completion of the
discovery of Fabrics in the range that has
t11FcsFabricDiscoveryRangeLow at its low end."
::= { t11FcsNotifications 2 }
t11FcsMgmtAddrChangeNotify NOTIFICATION-TYPE
OBJECTS { t11FcsMgmtAddrChangeFabricIndex,
t11FcsMgmtAddrChangeIeName }
STATUS current
DESCRIPTION
"This notification is generated by the Fabric
Configuration Server whenever the management
address of an IE changes, i.e., whenever an
entry in the t11FcsMgmtAddrListTable changes."
DeSanti, et al. Standards Track [Page 40]
RFC 4935 Fabric Configuration Server MIB August 2007
::= { t11FcsNotifications 3 }
t11FcsMgmtAddrChangeFabricIndex OBJECT-TYPE
SYNTAX T11FabricIndex
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"The index value that identifies the Fabric on which
a management address change has been detected."
::= { t11FcsNotificationInfo 2 }
t11FcsMgmtAddrChangeIeName OBJECT-TYPE
SYNTAX FcNameIdOrZero
MAX-ACCESS accessible-for-notify
STATUS current
DESCRIPTION
"The IE for which a management address change has been
detected."
::= { t11FcsNotificationInfo 3 }
-- Conformance
t11FcsMIBCompliances OBJECT IDENTIFIER ::= { t11FcsMIBConformance 1 }
t11FcsMIBGroups OBJECT IDENTIFIER ::= { t11FcsMIBConformance 2 }
t11FcsMIBCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The compliance statement for entities that
implement the Fabric Configuration Server."
MODULE MANDATORY-GROUPS { t11FcsDiscoveredConfigGroup,
t11FcsDiscoveryStatusGroup,
t11FcsNotificationInfoGroup,
t11FcsNotificationGroup }
GROUP t11FcsDiscoveryControlGroup
DESCRIPTION
"This group is mandatory only for those systems that
allow discovery of configuration by Fabric Configuration
Servers to be controlled via a MIB."
GROUP t11FcsStatisticsGroup
DESCRIPTION
"These counters, containing Fabric Configuration
Server statistics, are mandatory only for those systems
that count such events."
DeSanti, et al. Standards Track [Page 41]
RFC 4935 Fabric Configuration Server MIB August 2007
OBJECT t11FcsDiscoveryStatus
WRITE-SYNTAX INTEGER { localOnly(3) }
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required.
However, if write access is supported, then the only
writable value is 'localOnly'."
OBJECT t11FcsReqRejectNotifyEnable
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT t11FcsDiscoveryCompNotifyEnable
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
OBJECT t11FcsMgmtAddrChangeNotifyEnable
MIN-ACCESS read-only
DESCRIPTION
"Write access is not required."
::= { t11FcsMIBCompliances 1 }
-- Units of Conformance
t11FcsDiscoveryControlGroup OBJECT-GROUP
OBJECTS { t11FcsFabricDiscoveryRangeLow,
t11FcsFabricDiscoveryRangeHigh,
t11FcsFabricDiscoveryStart,
t11FcsFabricDiscoveryTimeOut }
STATUS current
DESCRIPTION
"A collection of objects for requesting a Fabric
Configuration Server to discover the configuration
of one or more Fabrics."
::= { t11FcsMIBGroups 1 }
t11FcsDiscoveryStatusGroup OBJECT-GROUP
OBJECTS { t11FcsDiscoveryStatus,
t11FcsDiscoveryCompleteTime }
STATUS current
DESCRIPTION
"A collection of objects with which to monitor the
status of discovery (of Fabric configurations) by
Fabric Configuration Servers."
DeSanti, et al. Standards Track [Page 42]
RFC 4935 Fabric Configuration Server MIB August 2007
::= { t11FcsMIBGroups 2 }
t11FcsDiscoveredConfigGroup OBJECT-GROUP
OBJECTS {
t11FcsIeType,
t11FcsIeDomainId,
t11FcsIeMgmtId,
t11FcsIeFabricName,
t11FcsIeLogicalName,
t11FcsIeMgmtAddrListIndex,
t11FcsIeInfoList,
t11FcsMgmtAddr,
t11FcsPortType,
t11FcsPortTxType,
t11FcsPortModuleType,
t11FcsPortPhyPortNum,
t11FcsPortAttachPortNameIndex,
t11FcsPortState,
t11FcsPortSpeedCapab,
t11FcsPortOperSpeed,
t11FcsPortZoningEnfStatus,
t11FcsAttachPortName,
t11FcsPlatformName,
t11FcsPlatformType,
t11FcsPlatformNodeNameListIndex,
t11FcsPlatformMgmtAddrListIndex,
t11FcsPlatformVendorId,
t11FcsPlatformProductId,
t11FcsPlatformProductRevLevel,
t11FcsPlatformDescription,
t11FcsPlatformLabel,
t11FcsPlatformLocation,
t11FcsPlatformSystemID,
t11FcsPlatformSysMgmtAddr,
t11FcsPlatformClusterId,
t11FcsPlatformClusterMgmtAddr,
t11FcsPlatformFC4Types,
t11FcsNodeName }
STATUS current
DESCRIPTION
"A collection of objects to contain the Fabric configuration
information discovered by Fabric Configuration Servers."
::= { t11FcsMIBGroups 3 }
t11FcsStatisticsGroup OBJECT-GROUP
OBJECTS { t11FcsInGetReqs,
t11FcsOutGetReqs,
t11FcsInRegReqs,
DeSanti, et al. Standards Track [Page 43]
RFC 4935 Fabric Configuration Server MIB August 2007
t11FcsOutRegReqs,
t11FcsInDeregReqs,
t11FcsOutDeregReqs,
t11FcsRejects }
STATUS current
DESCRIPTION
"A collection of objects for Fabric Configuration Server
statistics information."
::= { t11FcsMIBGroups 4 }
t11FcsNotificationInfoGroup OBJECT-GROUP
OBJECTS { t11FcsReqRejectNotifyEnable,
t11FcsDiscoveryCompNotifyEnable,
t11FcsMgmtAddrChangeNotifyEnable,
t11FcsRejectCtCommandString,
t11FcsRejectRequestSource,
t11FcsRejectReasonCode,
t11FcsRejectReasonCodeExp,
t11FcsRejectReasonVendorCode,
t11FcsMgmtAddrChangeFabricIndex,
t11FcsMgmtAddrChangeIeName }
STATUS current
DESCRIPTION
"A collection of notification control and notification
information objects for monitoring Fabric
Configuration Servers."
::= { t11FcsMIBGroups 5 }
t11FcsNotificationGroup NOTIFICATION-GROUP
NOTIFICATIONS { t11FcsRqRejectNotification,
t11FcsDiscoveryCompleteNotify,
t11FcsMgmtAddrChangeNotify }
STATUS current
DESCRIPTION
"A collection of notifications for monitoring Fabric
Configuration Servers."
::= { t11FcsMIBGroups 6 }
END
DeSanti, et al. Standards Track [Page 44]
RFC 4935 Fabric Configuration Server MIB August 2007
7. IANA Considerations
IANA has assigned a MIB OID (162) under the mib-2 subtree.
8. Security Considerations
There are several management objects defined in this MIB module with
a MAX-ACCESS clause of read-write and/or read-create. Such objects
may be considered sensitive or vulnerable in some network
environments. The support for SET operations in a non-secure
environment without proper protection can have a negative effect on
network operations. These objects and their
sensitivity/vulnerability is:
t11FcsFabricDiscoveryRangeLow
t11FcsFabricDiscoveryRangeHigh
t11FcsFabricDiscoveryTimeOut
t11FcsFabricDiscoveryStart -- the ability to specify parameters
for, and trigger the start of,
a topology discovery.
t11FcsDiscoveryStatus -- the ability to abort a discovery, or
invalidate discovered information.
t11FcsReqRejectNotifyEnable
t11FcsDiscoveryCompNotifyEnable
t11FcsMgmtAddrChangeNotifyEnable -- the ability to enable/disable
notifications.
Such objects may be considered sensitive or vulnerable in some
network environments. For example, the ability to invalidate
discovered topology may afford an attacker the ability to hide the
presence of unauthorized equipment on the network. The support for
SET operations in a non-secure environment without proper protection
can have a negative effect on network operations.
Some of the readable objects in this MIB module (i.e., objects with a
MAX-ACCESS other than not-accessible) may be considered sensitive or
vulnerable in some network environments. It is thus important to
control even GET and/or NOTIFY access to these objects and possibly
to even encrypt the values of these objects when sending them over
the network via SNMP. These are the tables and objects and their
sensitivity/vulnerability:
t11FcsIeTable
t11FcsMgmtAddrListTable
t11FcsPortTable
t11FcsAttachPortNameListTable
t11FcsPlatformTable
DeSanti, et al. Standards Track [Page 45]
RFC 4935 Fabric Configuration Server MIB August 2007
t11FcsNodeNameListTable -- contains information about the topology
of the Fibre Channel network.
t11FcsStatsTable -- contains statistics information about the
operation of the Fabric Configuration Server.
SNMP versions prior to SNMPv3 did not include adequate security.
Even if the network itself is secure (for example by using IPsec),
even then, there is no control as to who on the secure network is
allowed to access and GET/SET (read/change/create/delete) the objects
in this MIB module.
It is RECOMMENDED that implementors consider the security features as
provided by the SNMPv3 framework (see [RFC3410], section 8),
including full support for the SNMPv3 cryptographic mechanisms (for
authentication and privacy).
Further, deployment of SNMP versions prior to SNMPv3 is NOT
RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to
enable cryptographic security. It is then a customer/operator
responsibility to ensure that the SNMP entity giving access to an
instance of this MIB module is properly configured to give access to
the objects only to those principals (users) that have legitimate
rights to indeed GET or SET (change/create/delete) them.
9. Acknowledgements
This document was originally developed and approved by the INCITS
Task Group T11.5 (http://www.t11.org) as the SM-FCFGM project. We
wish to acknowledge the many contributions and comments from the
INCITS Technical Committee T11, especially from the following:
T11 Chair: Robert Snively, Brocade
T11 Vice Chair: Claudio DeSanti, Cisco Systems
T11.5 Chair: Roger Cummings, Symantec
T11.5 Vice Chair: Scott Kipp, McData
and T11.5 members.
The document was subsequently a work item of the IETF's IMSS Working
Group, chaired by David Black (EMC Corporation). We thank Bert
Wijnen (Lucent Technologies) for his thorough review of the document.
We also wish to acknowledge Dan Romascanu (Avaya), the IETF Area
Director, for his comments and assistance.
DeSanti, et al. Standards Track [Page 46]
RFC 4935 Fabric Configuration Server MIB August 2007
10. Normative References
[RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
Rose, M. and S. Waldbusser, "Structure of Management
Information Version 2 (SMIv2)", STD 58, RFC 2578, April
1999.
[RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
Rose, M. and S. Waldbusser, "Textual Conventions for
SMIv2", STD 58, RFC 2579, April 1999.
[RFC2580] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J.,
Rose, M. and S. Waldbusser, "Conformance Statements for
SMIv2", STD 58, RFC 2580, April 1999.
[RFC2788] Freed, N. and S. Kille, "Network Services Monitoring MIB",
RFC 2788, March 2000.
[RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An
Architecture for Describing Simple Network Management
Protocol (SNMP) Management Frameworks", STD 58, RFC 3411,
December 2002.
[FC-FS] "Fibre Channel - Framing and Signaling (FC-FS)" ANSI
INCITS 373-2003,
http://www.t11.org/t11/stat.nsf/upnum/1331-d, April 2003.
[FC-GS-5] "Fibre Channel - Generic Services - 5 (FC-GS-5)", ANSI
INCITS 427-2007,
http://www.t11.org/t11/stat.nsf/upnum/1677-d, 2007.
[FC-SW-4] "Fibre Channel - Switch Fabric - 4 (FC-SW-4)", ANSI INCITS
418-2006, http://www.t11.org/t11/stat.nsf/upnum/1674-d,
December 2006.
[RFC4044] McCloghrie, K., "Fibre Channel Management MIB", RFC 4044,
May 2005.
[RFC4438] DeSanti, C., Gaonkar, V., Vivek, H.K., McCloghrie, K., and
S. Gai, "Fibre Channel Name Server MIB", RFC 4438, March
2006.
[RFC4439] DeSanti, C., Gaonkar, V., McCloghrie, K., and S. Gai,
"Fibre Channel Fabric Address Manager MIB", RFC 4439,
March 2006.
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
DeSanti, et al. Standards Track [Page 47]
RFC 4935 Fabric Configuration Server MIB August 2007
11. Informative References
[RFC2741] Daniele, M., Wijnen, B., Ellison, M., and D. Francisco,
"Agent Extensibility (AgentX) Protocol Version 1", RFC
2741, January 2000.
[RFC2837] Teow, K., "Definitions of Managed Objects for the Fabric
Element in Fibre Channel Standard", RFC 2837, May 2000.
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.
[RFC4455] Hallak-Stamler, M., Bakke, M., Lederman, Y., Krueger, M.,
and K. McCloghrie, "Definition of Managed Objects for
Small Computer System Interface (SCSI) Entities", RFC
4455, April 2006.
DeSanti, et al. Standards Track [Page 48]
RFC 4935 Fabric Configuration Server MIB August 2007
Authors' Addresses
Claudio DeSanti
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134 USA
Phone: +1 408 853-9172
EMail: cds@cisco.com
H.K. Vivek
Cisco Systems, Inc.
71 Millers Rd
Bangalore, India
Phone: +91 80 2289933x5117
EMail: hvivek@cisco.com
Keith McCloghrie
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134 USA
Phone: +1 408 526-5260
EMail: kzm@cisco.com
Silvano Gai
Nuova Systems
3 West Plumeria Drive
San Jose, CA 95134
Phone: +1 408 387-6123
EMail: sgai@nuovasystems.com
DeSanti, et al. Standards Track [Page 49]
RFC 4935 Fabric Configuration Server MIB August 2007
Full Copyright Statement
Copyright (C) The IETF Trust (2007).
This document is subject to the rights, licenses and restrictions
contained in BCP 78, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY, THE IETF TRUST AND
THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF
THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in BCP 78 and BCP 79.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
http://www.ietf.org/ipr.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Acknowledgement
Funding for the RFC Editor function is currently provided by the
Internet Society.
DeSanti, et al. Standards Track [Page 50]