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
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].
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].
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.
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].
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
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).
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.
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
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.
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.
This group contains notification control and notification information objects for monitoring Fabric Configuration Server request rejection and discovery of topology information.
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
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 }
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)
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
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 }
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 }
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 }
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
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
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 }
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
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
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
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 }
t11FcsAttachPortNameListIndex OBJECT-TYPE SYNTAX T11FcListIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "The index value of the attach port name list." ::= { t11FcsAttachPortNameListEntry 1 }
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 }
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
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 }
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
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 }
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 }
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 }
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
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:
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.
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
[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.
[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.