Internet Draft C. DeSanti V. Gaonkar Andiamo Systems K. McCloghrie S. Gai Cisco Systems 23 January 2004 Fibre-Channel Domain Management MIB draft-desanti-fc-domain-manager-00.txt Status of this Memo This document is an Internet-Draft and is subject to all provisions of Section 10 of RFC2026. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet- Drafts as reference material or to cite them other than as "work in progress". The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Distribution of this document is unlimited. Copyright Notice Copyright (C) The Internet Society (2004). All Rights Reserved. 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 a Fibre Channel network's Domain Management. Expires June 2004 [Page 1] Internet Draft Fibre-Channel Domain Management MIB January 2004 Table of Contents 1 Introduction ................................................. 3 1.1 Change Log ................................................. 3 1.1.1 First version ............................................ 3 2 The Internet-Standard Management Framework ................... 3 3 Short Overview of Fibre Channel .............................. 3 4 Relationship to Other MIBs ................................... 4 5 MIB Overview ................................................. 5 5.1 The t11DmGroup group ....................................... 5 5.2 The t11DmDatabaseGroup group ............................... 5 5.3 The t11DmAreaGroup group ................................... 5 5.4 The t11DmCacheGroup group .................................. 5 5.5 The t11DmNotificationGroup group ........................... 5 6 Definitions .................................................. 6 6.1 T11-TC-MIB ................................................. 6 6.2 T11-FC-DOMAIN-MGR-MIB ...................................... 7 7 Intellectual Property ........................................ 31 8 Acknowledgements ............................................. 31 9 Normative References ......................................... 31 10 Informative References ...................................... 32 11 Security Considerations ..................................... 32 12 Authors' Addresses .......................................... 33 13 Full Copyright Statement .................................... 34 Expires June 2004 [Page 2] Internet Draft Fibre-Channel Domain Management MIB January 2004 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 Domain Management. 1.1. Change Log (This section to be deleted before final publication.) This section to be maintained as a record of changes between interim versions. 1.1.1. First version Published in January 2004 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 capability. The Fibre Channel provides a general transport vehicle for higher level protocols such as Intelligent Peripheral Interface (IPI) and Small Computer System Interface (SCSI) command sets, the High-Performance Parallel Interface (HIPPI) data framing, IP (Internet Protocol), IEEE 802.2, and others. Expires June 2004 [Page 3] Internet Draft Fibre-Channel Domain Management MIB January 2004 Physically, Fibre Channel is an interconnection of multiple communication points, called N_Ports, interconnected either by a 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 Element Link (IEL), 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 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. Each Switch in a Fabric is assigned one (or more) unique Domain_IDs using a two-step process. First, one switch, called Principal Switch, is selected from the switches of a Fabric. Then, the Principal Switch assigns Domain_IDs to the other switches of the Fabric. Address assignment within a Domain is performed by the switch to which that Domain_ID is granted. 4. Relationship to Other MIBs The first standardized MIB for Fibre Channel [RFC2837] was focussed on Fibre Channel switches. It is being replaced by the more generic Fibre Channel Management MIB [FC-MGMT] 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 [FC-MGMT] to cover the functionality, in Expires June 2004 [Page 4] Internet Draft Fibre-Channel Domain Management MIB January 2004 Fibre Channel switches, which is used to manage fabric configuration, domains, and addresses within a domain. This document also contains a MIB module, T11-TC-MIB, to define Textual Conventions useful for multiple MIBs defined by T11, which could be moved to its own document if appropriate. 5. MIB Overview This MIB contains five MIB groups, as follows. 5.1. The t11DmGroup group This group contains basic information about the Domain management functionality within a switch. 5.2. The t11DmDatabaseGroup group This group contains information about which switches are assigned to which domains. 5.3. The t11DmAreaGroup group This group contains information about which port-ids have been assigned within the areas of the local domain. 5.4. The t11DmCacheGroup group This group contains information about all the FC address identifier assignments which have been recently released. This cache is kept to provide best effort (short-term) re-assignment of the same FC address identifiers. 5.5. The t11DmNotificationGroup group This group contains notifications of significant events concerning the domain management functionality within a switch. Expires June 2004 [Page 5] Internet Draft Fibre-Channel Domain Management MIB January 2004 6. Definitions 6.1. T11-TC-MIB T11-TC-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, Integer32 FROM SNMPv2-SMI TEXTUAL-CONVENTION FROM SNMPv2-TC; t11TextualConventions MODULE-IDENTITY LAST-UPDATED "200401040000Z" ORGANIZATION "T11" CONTACT-INFO " Editor: Phone: E-mail: xxx@yyy.com" DESCRIPTION "This module defines textual conventions used in T11 MIBs." REVISION "200401040000Z" DESCRIPTION "Initial version of this MIB module." ::= { tbd 998 } VfId ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The Fabric Identifier (F_ID) which is sometimes used as a unique index value to identify a particular Virtual Fabric (within one physical fabric). Index values: 0, 4094 and 4095 are reserved." SYNTAX Integer32 (1..4093) END Expires June 2004 [Page 6] Internet Draft Fibre-Channel Domain Management MIB January 2004 6.2. T11-FC-DOMAIN-MGR-MIB T11-FC-DOMAIN-MGR-MIB DEFINITIONS ::= BEGIN -- the Fibre-Channel Domain Manager MIB -- -- for management of the functionality, in Fibre Channel switches, -- which is used to manage fabric configuration, domains, and addresses -- within a domain. -- IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Unsigned32, Counter32, Gauge32 FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF TEXTUAL-CONVENTION, TruthValue, RowStatus FROM SNMPv2-TC ifIndex FROM IF-MIB DomainIdOrZero, FcNameIdOrZero FROM FC-MGMT-MIB VfId FROM T11-TC-MIB; t11DomainMgrMIB MODULE-IDENTITY LAST-UPDATED "200401040000Z" ORGANIZATION "T11" CONTACT-INFO " Editor: Phone: E-mail: xxx@yyy.com" DESCRIPTION "The MIB module for the domain management functionality defined by the Fibre Channel standards (FC-SW-2). For the purposes of this MIB, 'Domain Manager' is the software functionality which executes in both the principal switch and other switches." REVISION "200401040000Z" DESCRIPTION "Initial version of this MIB module." ::= { tbd 999 } t11DmMIBObjects OBJECT IDENTIFIER ::= { t11DomainMgrMIB 1 } t11DmMIBConformance OBJECT IDENTIFIER ::= { t11DomainMgrMIB 2 } t11DmConfiguration OBJECT IDENTIFIER ::= { t11DmMIBObjects 1 } Expires June 2004 [Page 7] Internet Draft Fibre-Channel Domain Management MIB January 2004 t11DmInfo OBJECT IDENTIFIER ::= { t11DmMIBObjects 2 } t11DmNotifyControl OBJECT IDENTIFIER ::= { t11DmMIBObjects 3 } t11DmNotifications OBJECT IDENTIFIER ::= { t11DmMIBObjects 0 } -- Textual Conventions T11DmDomainPriority ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Priority of the switch. The principal switch selection is influenced by the priority of the switch. Some values are of importance are: 1 : The highest priority in principal switch selection, which is used by the administrator to establish which switch becomes the principal switch. 255 : Indicates that the switch is not capable of acting as a principal switch." SYNTAX Unsigned32 (1..255) T11DmDomainInterfaceRole ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Role of the Domain Manager interface. nonPrincipal (1) - non-principal interface principalUpstream (2) - upstream principal interface principalDownsteam (3) - downstream principal interface isolated (4) - isolated interface down (5) - down interface unknown (6) - unknown interface " SYNTAX INTEGER { nonPrincipal (1), principalUpstream (2), principalDownsteam (3), isolated (4), down (5), unknown (6) } T11DmState ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "State of the Domain Manager. Expires June 2004 [Page 8] Internet Draft Fibre-Channel Domain Management MIB January 2004 starting(1) unconfigured(2) principalSwitchSelection(3) - principal switch selection in progress. domainIdDistribution(4) - domain ID distribution in progress. buildFabricPhase(5) - BuildFabric in progress. reconfigureFabricPhase(6) - ReconfigureFabric in progress. stable(7) - stable. stableWithNoEports(8) - stable with no E-Ports present. stableWithDomainConfigured(9) - stable with domain configured. noDomains(10) - no domain configured/assigned. disabled(11) - domain manager disabled. unknown(12) - unknown. " SYNTAX INTEGER { starting(1), unconfigured(2), principalSwitchSelection(3), domainIdDistribution(4), buildFabricPhase(5), reconfigureFabricPhase(6), stable(7), stableWithNoEports(8), stableWithDomainConfigured(9), noDomains(10), disabled(11), unknown(12) } -- -- t11DmTable -- t11DmTable OBJECT-TYPE SYNTAX SEQUENCE OF T11DmEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains Domain Manager related parameters which are able to be configured and monitored in a Fibre Expires June 2004 [Page 9] Internet Draft Fibre-Channel Domain Management MIB January 2004 Channel switch. There is one entry for each of the Virtual Fabrics configured on the switch. Entries are implicitly created/removed as and when Virtual Fabrics are created/deleted." ::= { t11DmConfiguration 1 } t11DmEntry OBJECT-TYPE SYNTAX T11DmEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry provides information on the local domain manager functionality for a Virtual Fabric." INDEX { t11DmVfId } ::= { t11DmTable 1 } T11DmEntry ::= SEQUENCE { t11DmVfId VfId, t11DmConfigDomainId DomainIdOrZero, t11DmConfigDomainIdType INTEGER, t11DmEnable TruthValue, t11DmAutoReconfigure TruthValue, t11DmContiguousAllocation TruthValue, t11DmPriority T11DmDomainPriority, t11DmRestart INTEGER, t11DmFabricName FcNameIdOrZero, t11DmPrincipalSwitchWwn FcNameIdOrZero, t11DmLocalSwitchWwn FcNameIdOrZero, t11DmAssignedAreaIdList OCTET STRING, t11DmFcIdsGranted Counter32, t11DmFcIdsRecovered Counter32, t11DmFreeFcIds Gauge32, t11DmAssignedFcIds Gauge32, t11DmReservedFcIds Gauge32, t11DmRunningPriority T11DmDomainPriority, t11DmPrincSwRunningPriority T11DmDomainPriority, t11DmState T11DmState, t11DmPrincipalSwitchSelections Counter32, t11DmBuildFabrics Counter32, t11DmFabricReconfigures Counter32, t11DmDomainId DomainIdOrZero, t11DmLocalPrincipalSwitchSelctns Counter32 } t11DmVfId OBJECT-TYPE Expires June 2004 [Page 10] Internet Draft Fibre-Channel Domain Management MIB January 2004 SYNTAX VfId MAX-ACCESS not-accessible STATUS current DESCRIPTION "A unique index value which identifies a particular Virtual Fabric." ::= { t11DmEntry 1 } t11DmConfigDomainId OBJECT-TYPE SYNTAX DomainIdOrZero MAX-ACCESS read-write STATUS current DESCRIPTION "The configured Domain_ID of the local switch on this Virtual Fabric, or zero if no Domain_ID has been configured. The meaning of this object depends on t11DmConfigDomainIdType object. If t11DmConfigDomainIdType is 'preferred', then domain ID configured is called 'preferred Domain_ID'. The valid values are between 0 and 239. In a situation where this domain could not be assigned, any other domain ID would be acceptable. The value '0' means any domain ID. If t11DmConfigDomainIdType is 'static', then domain ID is called 'static Domain_ID' and valid values are between 1 and 239. In a situation where this domain was non-zero but could not be assigned, no other domain ID would be acceptable. If the Domain Manager is enabled on the Virtual Fabric, then an RDI (Request Domain_ID) will be sent requesting this Domain_ID. If a Domain_ID is not able to be granted in the case of 'preferred', or if a 'static' Domain_ID is configured but not able to be granted, then it is an error condition. When this error occurs, the E_Ports on that Virtual Fabric will be isolated and administrator will be informed via a 't11DmDomainIdNotAssigned' notification. If the domain manager is not enabled, then the static Domain_ID is assumed to be granted, if it has been configured (to a valid number). If either of the domain IDs are not configured with a non-zero value on this Virtual Fabric and if the domain Expires June 2004 [Page 11] Internet Draft Fibre-Channel Domain Management MIB January 2004 manager is not enabled, then - switch will isolate all its E_Ports on the Virtual Fabric. - The user will be informed via a notification 't11DmDomainIdNotAssigned'." DEFVAL { 0 } ::= { t11DmEntry 2 } t11DmConfigDomainIdType OBJECT-TYPE SYNTAX INTEGER { static (1), preferred(2) } MAX-ACCESS read-write STATUS current DESCRIPTION "Type of configured Domain_ID." DEFVAL { preferred } ::= { t11DmEntry 3 } t11DmEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Enables the Domain Manager on this Virtual Fabric. If enabled on an active Virtual Fabric, the switch will participate in principal switch selection. If disabled, the switch will participate in neither the principal switch selection nor domain allocation. Thus, Domain_ID needs to be configured statically." DEFVAL { true } ::= { t11DmEntry 4 } t11DmAutoReconfigure OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "This object determines how the switch responds to certain error conditions. The condition that might cause these errors is Expires June 2004 [Page 12] Internet Draft Fibre-Channel Domain Management MIB January 2004 merging of two disjoint fabrics that have overlapping Domain_ID list. If value of this object is 'true', the switch will send a RCF (ReConfigureFabric) to rebuild the Fabric. If 'false' the switch will isolate the E_Ports on which the errors happened." DEFVAL { false } ::= { t11DmEntry 5 } t11DmContiguousAllocation OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Determines how the switch behaves when elected as the principal switch. If true, switch won't accept non-contiguous domain IDs in RDIs and will try to replace all the Domain_IDs in the list with contiguous Domain_IDs if a RDI for a contiguous Domain_ID is not able to be fulfilled. If false, then the switch acts normally in granting the Domain_IDs even if they are not contiguous." ::= { t11DmEntry 6 } t11DmPriority OBJECT-TYPE SYNTAX T11DmDomainPriority MAX-ACCESS read-write STATUS current DESCRIPTION "Priority of the switch to be used in principal switch selection process." ::= { t11DmEntry 7 } t11DmRestart OBJECT-TYPE SYNTAX INTEGER { nonDisruptive(1), disruptive(2), noOp(3) } MAX-ACCESS read-write STATUS current DESCRIPTION Expires June 2004 [Page 13] Internet Draft Fibre-Channel Domain Management MIB January 2004 "This object tells the Domain Manager to rebuild the Domain_ID tree all over again. If this object is set to 'disruptive', then a RCF (ReConfigure Fabric) is generated in the Virtual Fabric in order for the fabric to recover from the errors. If this object is set to 'nonDisruptive', then a BF (Build Fabric) is generated in the Virtual Fabric. No action is taken if this object is set to 'noOp'. The value of the object when read is always 'noOp'." ::= { t11DmEntry 8 } t11DmFabricName OBJECT-TYPE SYNTAX FcNameIdOrZero MAX-ACCESS read-write STATUS current DESCRIPTION "The WWN that is used for fabric logins on this Virtual Fabric. This object is used only if the value of t11DmEnable is false. If the value of t11DmEnable is true, then principal switch WWN is used. It is automatically set to the default value when set to zero-length value." DEFVAL {'20010005300028df'H} ::= { t11DmEntry 9 } t11DmPrincipalSwitchWwn OBJECT-TYPE SYNTAX FcNameIdOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "The WWN of the Principal Switch on this Virtual Fabric, or zero-length string if the identity of the principal switch is unknown." DEFVAL { ''H } ::= { t11DmEntry 10 } t11DmLocalSwitchWwn OBJECT-TYPE SYNTAX FcNameIdOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "The WWN of the local Switch on this Virtual Fabric." Expires June 2004 [Page 14] Internet Draft Fibre-Channel Domain Management MIB January 2004 ::= { t11DmEntry 11 } t11DmAssignedAreaIdList OBJECT-TYPE SYNTAX OCTET STRING (SIZE(0..256)) MAX-ACCESS read-only STATUS current DESCRIPTION "The list of Area_IDs which have been assigned in this Virtual Fabric, formatted as an array of octets in ascending order. There could zero or more Area_IDs assigned on this Virtual Fabric. Each octet represents one Area_ID. So, the list containing area_IDs: 23, 45, 235 and 56 would be formatted as the 4-octet string x'172d38eb'. A particular area's Area_ID is used as the index into the t11DmAreaTable to get the statistics on that area." ::= { t11DmEntry 12 } t11DmFcIdsGranted OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of FC_IDs that are granted (for local use) by the Domain Manager on the local switch since the switch has been initialized. Note that all such FC_IDs have the local switch's Domain_ID." ::= { t11DmEntry 13 } t11DmFcIdsRecovered OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The total number of FC_IDs that are recovered by the Domain Manager on the local switch since the switch has been initialized. A recovered FC_ID is one that is explicitly returned after previously being granted for local use." ::= { t11DmEntry 14 } t11DmFreeFcIds OBJECT-TYPE SYNTAX Gauge32 Expires June 2004 [Page 15] Internet Draft Fibre-Channel Domain Management MIB January 2004 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of FC_IDs that are unassigned on this Virtual Fabric." ::= { t11DmEntry 15 } t11DmAssignedFcIds OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of FC_IDs that are assigned on this Virtual Fabric." ::= { t11DmEntry 16 } t11DmReservedFcIds OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of FC_IDs that are reserved on the Virtual Fabric." ::= { t11DmEntry 17 } t11DmRunningPriority OBJECT-TYPE SYNTAX T11DmDomainPriority MAX-ACCESS read-only STATUS current DESCRIPTION "The running priority of the local switch on this Virtual Fabric." ::= { t11DmEntry 18 } t11DmPrincSwRunningPriority OBJECT-TYPE SYNTAX T11DmDomainPriority MAX-ACCESS read-only STATUS current DESCRIPTION "The running priority of the principal switch on this Virtual Fabric." ::= { t11DmEntry 19 } t11DmState OBJECT-TYPE SYNTAX T11DmState Expires June 2004 [Page 16] Internet Draft Fibre-Channel Domain Management MIB January 2004 MAX-ACCESS read-only STATUS current DESCRIPTION "The state of the Domain Manager on the local switch on this Virtual Fabric." ::= { t11DmEntry 20 } t11DmPrincipalSwitchSelections OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of principal switch selections on this Virtual Fabric." ::= { t11DmEntry 21 } t11DmBuildFabrics OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'BuildFabrics' (BFs) that have occurred on this Virtual Fabric." ::= { t11DmEntry 22 } t11DmFabricReconfigures OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of 'ReconfigureFabrics' (RCFs) that have occurred on this Virtual Fabric." ::= { t11DmEntry 23 } t11DmDomainId OBJECT-TYPE SYNTAX DomainIdOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "The Domain_ID of the local switch on this Virtual Fabric or zero if no Domain_ID has been assigned." ::= { t11DmEntry 24 } t11DmLocalPrincipalSwitchSelctns OBJECT-TYPE SYNTAX Counter32 Expires June 2004 [Page 17] Internet Draft Fibre-Channel Domain Management MIB January 2004 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of times the local switch became the principal switch on this Virtual Fabric." ::= { t11DmEntry 25 } -- -- t11DmIfTable - Interface configuration -- t11DmIfTable OBJECT-TYPE SYNTAX SEQUENCE OF T11DmIfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains interface configuration of the domain manager per Virtual Fabric. An entry in this table is automatically created when an E_Port becomes non-isolated and there is a entry in t11DmTable for that Virtual Fabric. An entry is deleted automatically from this table if : a) the correponding interface becomes non-existent, or b) the correponding interface becomes a non-E_Port and all the writable objects has default values. or c) the t11DmTable entry for the corresponding Virtual Fabric is deleted. Creating entries in this table via t11DmIfRowStatus provides the means to specify non-default parameter values for an interface at a time when that interface is either down or is a non-E_Port. So an entry in this table exists when one or both of these conditions holds: - one or more configuration parameters have non-default values for an interface which is either down or a non-E_Port and corresponding Virtual Fabric has an entry in the t11DmTable, and/or - the interface is an E_Port and it is up. This has a number of consequences: Expires June 2004 [Page 18] Internet Draft Fibre-Channel Domain Management MIB January 2004 - an entry exists for a non-E_Port or an E_Port which is down whenever that interface has non-default parameters and the corresponding Virtual Fabric has an entry in the t11DmTable; - an entry is not able to be created (via t11DmIfRowStatus) for an interface with default parameters; instead, the agent creates/deletes an entry for an interface with default parameters according to whether the E_Port is up or down. - an entry is not able to be created via t11DmIfRowStatus unless non-default parameter values are (simultaneously) configured for an interface which is a non-E_Port or a down interface, and the correspoding Virtual Fabric has an entry in the t11DmTable. - deleting an entry via RowStatus when either the interface is down and configured with non-default values or the interface is up, is equivalent to resetting its parameters to their default values. If the interface is down and was configured with default values, then the entry would be deleted." ::= { t11DmConfiguration 2 } t11DmIfEntry OBJECT-TYPE SYNTAX T11DmIfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry gives information on interface configuration on a particular Virtual Fabric." INDEX { t11DmVfId, ifIndex} ::= { t11DmIfTable 1 } T11DmIfEntry ::= SEQUENCE { t11DmIfRcfReject TruthValue, t11DmIfRole T11DmDomainInterfaceRole, t11DmIfRowStatus RowStatus } t11DmIfRcfReject OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-create STATUS current DESCRIPTION "This object determines if the incoming ReConfigure Fabric (RCF) messages on this interface on this Virtual Expires June 2004 [Page 19] Internet Draft Fibre-Channel Domain Management MIB January 2004 Fabric is accepted or not. If this object is 'true', then the incoming RCF is rejected. If 'false', incoming RCF is accepted. Note that this object does not apply to the outgoing RCFs generated by this interface." DEFVAL {false} ::= { t11DmIfEntry 1 } t11DmIfRole OBJECT-TYPE SYNTAX T11DmDomainInterfaceRole MAX-ACCESS read-only STATUS current DESCRIPTION "The role of this interface." ::= { t11DmIfEntry 2 } t11DmIfRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this row. This object is not able to be used to create an entry unless the corresponding interface exists. If the interface does not exists, a create will fail." ::= { t11DmIfEntry 3 } -- -- t11DmAreaTable -- t11DmAreaTable OBJECT-TYPE SYNTAX SEQUENCE OF T11DmAreaEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains area statistics on the local domain manager per Virtual Fabric. Each octet in the t11DmAssignedAreaList is able to be used to index into this table to find information on each area." ::= { t11DmInfo 1 } Expires June 2004 [Page 20] Internet Draft Fibre-Channel Domain Management MIB January 2004 t11DmAreaEntry OBJECT-TYPE SYNTAX T11DmAreaEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry gives information on the Area_ID and all Port_IDs that were assigned for within an area for a particular Virtual Fabric." INDEX { t11DmVfId, t11DmAreaAreaId} ::= { t11DmAreaTable 1 } T11DmAreaEntry ::= SEQUENCE { t11DmAreaAreaId Unsigned32, t11DmAreaAssignedPortIdList OCTET STRING } t11DmAreaAreaId OBJECT-TYPE SYNTAX Unsigned32 (0..255) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Area_ID of this area." ::= { t11DmAreaEntry 1 } t11DmAreaAssignedPortIdList OBJECT-TYPE SYNTAX OCTET STRING (SIZE(0..256)) MAX-ACCESS read-only STATUS current DESCRIPTION "The list of Port_IDs which have been assigned in this Area and Virtual Fabric, formatted as an array of octets in ascending order. There could be zero or more Port_IDs assigned on this Area and Virtual Fabric. Each octet represents one Port_ID. So, the list containing the Port_IDs 23, 45, 235 and 56 would be formatted as the 4-octet string x'172d38eb'." ::= { t11DmAreaEntry 2 } -- -- t11DmDatabaseTable -- . t11DmDatabaseTable OBJECT-TYPE Expires June 2004 [Page 21] Internet Draft Fibre-Channel Domain Management MIB January 2004 SYNTAX SEQUENCE OF T11DmDatabaseEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains all information known by the local switch about all the domains which have been assigned in each of the Virtual Fabrics." ::= { t11DmInfo 2 } t11DmDatabaseEntry OBJECT-TYPE SYNTAX T11DmDatabaseEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the t11DmDatabaseTable containing information about one Domain_ID in one Virtual Fabric." INDEX { t11DmVfId , t11DmDatabaseDomainId} ::= { t11DmDatabaseTable 1 } T11DmDatabaseEntry ::= SEQUENCE { t11DmDatabaseDomainId DomainIdOrZero, t11DmDatabaseSwitchWwn FcNameIdOrZero } t11DmDatabaseDomainId OBJECT-TYPE SYNTAX DomainIdOrZero (1..239) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The Domain_ID for which this row contains information. The value must be non-zero." ::= { t11DmDatabaseEntry 1 } t11DmDatabaseSwitchWwn OBJECT-TYPE SYNTAX FcNameIdOrZero MAX-ACCESS read-only STATUS current DESCRIPTION "The WWN of the switch to which the corresponding value of t11DmDatabaseDomainId is currently assigned for the particular Virtual Fabric." ::= { t11DmDatabaseEntry 2 } -- Expires June 2004 [Page 22] Internet Draft Fibre-Channel Domain Management MIB January 2004 -- Domain Manager FC_ID cache information -- t11DmMaxFcIdCacheSize OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS read-only STATUS current DESCRIPTION "The maximum number of FC_IDs that are able to be cached in the t11DmFcIdCacheTable." ::= { t11DmInfo 3 } -- -- t11DmFcIdCacheTable -- t11DmFcIdCacheTable OBJECT-TYPE SYNTAX SEQUENCE OF T11DmFcIdCacheEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table contains all the FC_IDs that have recently been released. So it lists all the FC_IDs that have valid WWN to FC_ID mappings and currently not assigned to any ports. These FC_ID were assigned to ports and now, have been released. This cached FC_ID contains only Area_ID and Port_ID information. The FC_ID cache is kept to provide best effort re-assignment of same FC_IDs. i.e, an Nx_Port would get the same FC_ID when it asks for a FC_ID ID again, after releasing it." ::= { t11DmInfo 4 } t11DmFcIdCacheEntry OBJECT-TYPE SYNTAX T11DmFcIdCacheEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry (conceptual row) in the t11DmFcIdCacheTable containing information about one FC_ID that was released from a WWN, corresponding to a range of one or more ports. An entry is created when a FC_ID is released by the last port in the range. An entry is deleted either when the number of rows in this table reaches 't11DmMaxFcIdCacheSize' if it is the oldest entry (depending on the value of the object Expires June 2004 [Page 23] Internet Draft Fibre-Channel Domain Management MIB January 2004 't11DmFcIdCacheReleasedTime') to make room for the a new entry or when the this FC_ID is assinged to a port." INDEX { t11DmVfId, t11DmFcIdCacheWwn} ::= { t11DmFcIdCacheTable 1 } T11DmFcIdCacheEntry ::= SEQUENCE { t11DmFcIdCacheWwn FcNameIdOrZero, t11DmFcIdCacheAreaIdPortId OCTET STRING, t11DmFcIdCachePortIds Unsigned32 } t11DmFcIdCacheWwn OBJECT-TYPE SYNTAX FcNameIdOrZero MAX-ACCESS not-accessible STATUS current DESCRIPTION "The WWN of the port associated this entry." ::= { t11DmFcIdCacheEntry 1 } t11DmFcIdCacheAreaIdPortId OBJECT-TYPE SYNTAX OCTET STRING (SIZE (2)) MAX-ACCESS read-only STATUS current DESCRIPTION "The Area_ID and Port_ID of FC_ID that was assigned and has since been released by this port on this Virtual Fabric. Note that this object is only 2 bytes and only contains the Area_ID and Port_ID." ::= { t11DmFcIdCacheEntry 2 } t11DmFcIdCachePortIds OBJECT-TYPE SYNTAX Unsigned32 (0..65535) MAX-ACCESS read-only STATUS current DESCRIPTION "Number of port IDs assigned and/or released starting from Port_ID contained in the second byte of t11DmFcIdCacheAreaIdPortId for the Area_ID contained in the first byte of object t11DmFcIdCacheAreaIdPortId." ::= { t11DmFcIdCacheEntry 3 } -- Notification control objects Expires June 2004 [Page 24] Internet Draft Fibre-Channel Domain Management MIB January 2004 t11DmReConfFabricChangeNotifyEnable OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION "Specifies whether or not the local switch should issue a t11DmFabricChangeNotify notification on sending or receiving ReConfigureFabric (RCF) on a Virtual Fabric. If the value of the object is 'true, then the notification is generated. If the value is 'false', notification is not generated." DEFVAL { false } ::= { t11DmNotifyControl 1 } t11DmNotifyVfId OBJECT-TYPE SYNTAX VfId MAX-ACCESS accessible-for-notify STATUS current DESCRIPTION "A unique index value which identifies a particular Virtual Fabric for which a particular notification is generated." ::= { t11DmNotifyControl 2 } -- Notifications t11DmDomainIdNotAssignedNotify NOTIFICATION-TYPE OBJECTS { t11DmNotifyVfId } STATUS current DESCRIPTION "This notifications indicates that a Domain_ID has not been not configured nor assigned for a particular Virtual Fabric. This might happen under the following conditions, and results in the switch isolating E_Ports on the Virtual Fabric: - if the Domain Manager is enabled on the local switch and its request for a configured static Domain_ID is rejected or no other Domain_ID is assigned, then the E_Ports are isolated. - if the domain manager is not enabled and if a static Domain_ID is not configured on the Virtual Fabric, then the switch will isolate all of its Expires June 2004 [Page 25] Internet Draft Fibre-Channel Domain Management MIB January 2004 E_Ports on the Virtual Fabric." ::= { t11DmNotifications 1 } t11DmNewPrincipalSwitchNotify NOTIFICATION-TYPE OBJECTS { t11DmNotifyVfId } STATUS current DESCRIPTION "This notification indicates that the sending switch has become the new Principal Switch on a Virtual Fabric. This notification is sent soon after its election as the new Principal Switch, i.e., upon expiration of a Principal Switch selection timer which is equal to twice the Fabric Stability Timeout value (F_S_TOV)." ::= { t11DmNotifications 2 } t11DmFabricChangeNotify NOTIFICATION-TYPE OBJECTS { t11DmNotifyVfId } STATUS current DESCRIPTION "This notification is sent whenever a switch sends or receives a Build Fabric (BF) or a ReConfigure Fabric (RCF) message on a Virtual Fabric. A switch might receive or issue a BuildFabric (BF) message under the following conditions: - A new link causes two disjoint fabrics in a Virtual Fabric to merge into one fabric. The sent/received message is BF if the Domain_ID lists on the disjoint fabrics do not overlap. - An upstream principal ISL which connects to Principal switch and other switches in a Virtual Fabric fails. BF is issued to see if there is an alternative path to the Principal Switch, or to select a new Principal Switch. - A switch asks for a different set of Domain_IDs than the currently assigned list, then the Principal switch would issue a BF. A switch issues a ReConfigure Fabric (RCF) message under administrative control. The notification is not sent if a 't11DmNewPrincipalSwitchNotify' notification is sent for the same transition." Expires June 2004 [Page 26] Internet Draft Fibre-Channel Domain Management MIB January 2004 ::= { t11DmNotifications 3 } -- -- Conformance -- t11DmMIBCompliances OBJECT IDENTIFIER ::= { t11DmMIBConformance 1 } t11DmMIBGroups OBJECT IDENTIFIER ::= { t11DmMIBConformance 2 } t11DmMIBCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for Fibre Channel switches which implement Domain Manager functionality." MODULE MANDATORY-GROUPS { t11DmGroup, t11DmDatabaseGroup, t11DmAreaGroup, t11DmCacheGroup, t11DmNotificationGroup } OBJECT t11DmConfigDomainId MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11DmConfigDomainIdType MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11DmEnable MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11DmAutoReconfigure MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11DmContiguousAllocation MIN-ACCESS read-only DESCRIPTION Expires June 2004 [Page 27] Internet Draft Fibre-Channel Domain Management MIB January 2004 "Write access is not required." OBJECT t11DmPriority MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11DmRestart MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11DmFabricName MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11DmIfRcfReject MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11DmIfRowStatus MIN-ACCESS read-only DESCRIPTION "Write access is not required." OBJECT t11DmReConfFabricChangeNotifyEnable MIN-ACCESS read-only DESCRIPTION "Write access is not required." ::= { t11DmMIBCompliances 1 } -- Units of Conformance t11DmGroup OBJECT-GROUP OBJECTS { t11DmConfigDomainId, t11DmConfigDomainIdType, t11DmEnable, t11DmAutoReconfigure, t11DmContiguousAllocation, t11DmPriority, t11DmRestart, t11DmFabricName, Expires June 2004 [Page 28] Internet Draft Fibre-Channel Domain Management MIB January 2004 t11DmPrincipalSwitchWwn, t11DmLocalSwitchWwn, t11DmAssignedAreaIdList, t11DmFcIdsGranted, t11DmFcIdsRecovered, t11DmFreeFcIds, t11DmAssignedFcIds, t11DmReservedFcIds, t11DmRunningPriority, t11DmPrincSwRunningPriority, t11DmState, t11DmPrincipalSwitchSelections, t11DmBuildFabrics, t11DmFabricReconfigures, t11DmDomainId, t11DmLocalPrincipalSwitchSelctns, t11DmIfRcfReject, t11DmIfRole, t11DmIfRowStatus, t11DmReConfFabricChangeNotifyEnable, t11DmNotifyVfId } STATUS current DESCRIPTION "A collection of objects for displaying and configuring Domain Manager membership." ::= { t11DmMIBGroups 1 } t11DmDatabaseGroup OBJECT-GROUP OBJECTS { t11DmDatabaseSwitchWwn } STATUS current DESCRIPTION "A collection of objects for displaying the Domain database information." ::= { t11DmMIBGroups 2 } t11DmAreaGroup OBJECT-GROUP OBJECTS { t11DmAreaAssignedPortIdList } STATUS current DESCRIPTION "A collection of objects for displaying the Domain area information." ::= { t11DmMIBGroups 3 } t11DmCacheGroup OBJECT-GROUP Expires June 2004 [Page 29] Internet Draft Fibre-Channel Domain Management MIB January 2004 OBJECTS { t11DmMaxFcIdCacheSize, t11DmFcIdCacheAreaIdPortId, t11DmFcIdCachePortIds } STATUS current DESCRIPTION "A collection of objects for displaying the Domain area information." ::= { t11DmMIBGroups 4 } t11DmNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { t11DmDomainIdNotAssignedNotify, t11DmNewPrincipalSwitchNotify, t11DmFabricChangeNotify } STATUS current DESCRIPTION "A collection of notifications for status monitoring and notification." ::= { t11DmMIBGroups 5 } END Expires June 2004 [Page 30] Internet Draft Fibre-Channel Domain Management MIB January 2004 7. Intellectual Property The IETF takes no position regarding the validity or scope of any intellectual property 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; neither does it represent that it has made any effort to identify any such rights. Information on the IETF's procedures with respect to rights in standards-track and standards-related documentation can be found in BCP-11. Copies of claims of rights made available for publication 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 implementors or users of this specification can be obtained from the IETF Secretariat. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights which may cover technology that may be required to practice this standard. Please address the information to the IETF Executive Director. 8. Acknowledgements To be supplied. 9. 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. [FC-SW-2] "Fibre Channel - Switch Fabric - 2 (FC-SW-2)", ANSI NCITS 355-2001, Expires June 2004 [Page 31] Internet Draft Fibre-Channel Domain Management MIB January 2004 June 2001. [FC-MGMT] K. McCloghrie, "Fibre Channel Management MIB", Internet-Draft (draft-ietf-ips-fcmgmt-mib-nn.txt), work-in-progress. 10. Informative References [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. [FC-FS] "Fibre Channel - Framing and Signaling (FC-FS)" ANSI INCITS 373-2003, April 2003. 11. Security Considerations There are a number of management objects defined in this MIB that have a MAX-ACCESS clause of read-write: - to be supplied Such objects may be considered sensitive or vulnerable in some network environments. For example, the ability to change network topology or network speed may afford an attacker the ability to obtain better performance at the expense of other network users. 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. In particular, these objects provide information on ... Expires June 2004 [Page 32] Internet Draft Fibre-Channel Domain Management MIB January 2004 - to be supplied 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. 12. Authors' Addresses Claudio DeSanti Andiamo Systems, Inc. 375 E. Tasman Dr. San Jose, CA 95134 USA Phone: +1 408 853-9172 EMail: cds@andiamo.com Vinay Gaonkar Systems, Inc. 375 E. Tasman Dr. San Jose, CA 95134 USA Phone: +1 408 527-8576 EMail: vgaonkar@andiamo.com Keith McCloghrie Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA USA 95134 Phone: +1 408-526-5260 Email: kzm@cisco.com Expires June 2004 [Page 33] Internet Draft Fibre-Channel Domain Management MIB January 2004 Silvano Gai Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA USA 95134 Phone: +1 408-526-7269 Email: sgai@cisco.com 13. Full Copyright Statement Copyright (C) The Internet Society (2001). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS 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. Expires June 2004 [Page 34]