IPS Working Group
INTERNET-DRAFT Ravi Natarajan
<draft-ietf-ips-fcip-mib-04.txt> Lightsand Communications
Expires October 2003
Anil Rijhsinghani
McDATA Corporation
April 2003
Definitions of Managed Objects for FCIP
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.
Copyright Notice
Copyright (C) The Internet Society (2003). All Rights Reserved.
Abstract
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in TCP/IP based internets.
In particular it defines objects for managing FCIP entities, as
defined in [FCIP] and used in FC fabrics as described in [FCBB2].
FCIP MIB Expires October 2003 [Page 1]
Internet Draft FCIP MIB April 2003
Table of Contents
Status of this Memo...............................................1
Copyright Notice..................................................1
Abstract..........................................................1
Table of Contents.................................................2
1. The Internet-Standard Management Framework....................3
2. Overview of FCIP management model.............................3
3. Relationship to other MIBs....................................4
4. Changes from draft-ietf-ips-fcip-mib-03.txt...................5
5. MIB Definitions...............................................6
6. Security Considerations......................................26
7. Intellectual Property........................................26
8. Acknowledgements.............................................27
9. Normative References.........................................27
10. Informative References.......................................28
11. Authors' Addresses...........................................28
12. Full Copyright Notice........................................28
FCIP MIB Expires October 2003 [Page 2]
Internet Draft FCIP MIB April 2003
1. 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].
2. Overview of FCIP management model
Note that the FCIP Entity is fully described in [FCIP] from a
functional point of view. A collection of multiple instances of
FCIP Entities and the corresponding FC Entities, described in [BB2],
within an SNMP Context is referred to as an FCIP device here.
This section describes FCIP from a management point of view.
The FCIP device provides IP-based interconnection model to interconnect
FC fabric elements. In this model, the FCIP devices along with
the IP network on which they are running provide a new FCIP transport
network.
This IP-based FCIP Interconnection Model supports the following
topology:
o The FCIP-based transport network is formed by interconnecting the
FCIP-devices.
o Each FCIP device has one or more FCIP Entities or Instances.
o Peer FCIP Entities are connected by FCIP Links, attached to
VE_ports/B_Access.
o Each FCIP Link Endpoint contains one or more Data Engines.
o The FCIP device can work as a standalone box or as part
of a FC fabric element.
Each FCIP Entity managed by this MIB is referred to as a FCIP Instance.
The MIB is broken up as follows:
2.1 FCIP Entity Instances Table
The FCIP Entity table contains information about this entity's existing
instances of FCIP entities.
2.2 FCIP Link Table
The FCIP link table contains information about this FCIP device's
FCIP MIB Expires October 2003 [Page 3]
Internet Draft FCIP MIB April 2003
existing FCIP links.
2.3 FCIP TCP Connection Table
The FCIP TCP Connection table contains information about existing TCP
connections. Each FCIP link within a FCIP entity contains one or more
TCP connections. The FCIP entity employs a Data Engine for each TCP
connection for handling FC frame encapsulation, de-encapsulation and
transmission of FCIP frames on the connection.
2.4 FCIP Dynamic Route Table
The FCIP dynamic route table contains routing information that is
dynamically discovered by this FCIP device. The FCIP device may use
the SLPv2 protocol in conjunction with other protocols, such as FSPF,
to dynamically discover other FCIP entities, and populate this table
to map destination domains to FCIP Links.
2.5 FCIP Static Route Table
The FCIP static route table contains routing information that is
statically configured into this FCIP device by Network Admin.
In the absence of dynamic discovery of remote FCIP entities, the
Network Manager will configure remote domains and FCIP Entities
that are reachable by this device into this table.
2.6 FCIP Discovery Domain Table
The FCIP Discovery Domain Table maps this device's FCIP Entities into
FCIP Discovery Domains.
2.7 FCIP Link Error Table
The FCIP Link Errors Table contains counters that indicate error
conditions on an FCIP Link.
3. Relationship to other MIBs
Objects accessible from other MIBs applicable to FCIP devices have not
been included in this MIB.
3.1 Relationship to the 'TCP' group of MIB-II
This group is mandatory for all systems which implement TCP. Objects
relevant to TCP must be obtained from this group.
3.2 Relationship to the 'interfaces' MIB
The 'interfaces' group is defined as being mandatory for
all systems and contains information on an entity's interfaces.
Each logical/virtual interface created as an FCIP Link should be
represented as a row in the ifTable with a unique ifIndex value and a
FCIP MIB Expires October 2003 [Page 4]
Internet Draft FCIP MIB April 2003
value of ifType 'fcipLink' for each such interface. These are the only
ifIndex values of relevance to an FCIP Entity because FCIP runs over
top of TCP/IP. When an FCIP entity has data to transmit to a peer FCIP
entity, it gives it to TCP, and TCP formats the data into segments and
gives them to IP; IP puts the data into datagrams which it sends on
whatever one or more physical interfaces IP has available. Therefore,
only IP, not an FCIP Entity, has knowledge of the ifIndex values for
physical interfaces.
3.3 Relationship to the Fibre Channel Management MIB
The Fibre Channel Management MIB [FCMGMT] is assumed for FC
functionality managed objects.
4. Changes from draft-ietf-ips-fcip-mib-03.txt
o The syntax for fcipEntityId has been changed from Unsigned64 to
OCTET STRING (Size 8).
o The syntax for fcipEntityTcpConnPort object has been changed from
INTEGER (0..65535) to Unsigned32 (0..65535).
o The syntax for fcipTcpConnLocalPort and fcipTcpConnRemPort objects
has been changed from INTEGER (0..65535) to Unsigned32 (1..65535).
o The description for fcipLinkFcipSfRespNotReceived object has been
corrected.
o Added Table of Contents.
o Removed obsolete references.
FCIP MIB Expires October 2003 [Page 5]
Internet Draft FCIP MIB April 2003
5. MIB Definitions
FCIP-MGMT-MIB DEFINITIONS ::= BEGIN
IMPORTS
OBJECT-TYPE,
MODULE-IDENTITY,
Unsigned32,
Counter32,
mib-2 FROM SNMPv2-SMI
TEXTUAL-CONVENTION,
TruthValue,
DisplayString, RowStatus FROM SNMPv2-TC
InetAddressType,
InetAddress FROM INET-ADDRESS-MIB
FcNameIdOrZero FROM FC-MGMT-MIB
InterfaceIndex FROM IF-MIB
MODULE-COMPLIANCE,
OBJECT-GROUP FROM SNMPv2-CONF;
fcipMIB MODULE-IDENTITY
LAST-UPDATED "200303020000Z"
ORGANIZATION "IETF IPFC Working Group"
CONTACT-INFO "Anil Rijhsinghani
McDATA Corporation
4 McDATA Parkway
Broomfield, CO 80021 USA.
Email: anil.rijhsinghani@mcdata.com
Ravi Natarajan
LightSand Communications Inc,
279 Sinclair Frontage Road
Milpitas, CA 95035 USA.
Email: ravin@lightsand.com"
DESCRIPTION "The module defines management information specific to FCIP devices."
REVISION "200303020000Z"
DESCRIPTION
"Initial version of the FCIP MIB module."
::= { mib-2 8889 } -- TO BE ASSIGNED by IANA
fcipObjects OBJECT IDENTIFIER ::= { fcipMIB 1 }
fcipConformance OBJECT IDENTIFIER ::= { fcipMIB 2 }
fcipConfig OBJECT IDENTIFIER ::= { fcipObjects 1 }
-- ******************************************************************
-- Textual conventions
--
FCIP MIB Expires October 2003 [Page 6]
Internet Draft FCIP MIB April 2003
FcDomainId ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION "The Domain ID of a FC entity."
SYNTAX OCTET STRING (SIZE(1))
FcEntityMode ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION "The type of port mode provided by an FCIP Entity
for a FCIP Link. An FCIP Entity can be an E-Port
mode for one of its FCIP Link Endpoints, an B-Port
mode for another of its FCIP Link Endpoints."
SYNTAX INTEGER {
ePortMode(1),
bPortMode(2),
other(3)
}
-- ******************************************************************
-- The FCIP group
--
-- This group defines the global scalar objects applicable to FCIP
-- devices only
--
fcipDynIpConfType OBJECT-TYPE
SYNTAX INTEGER {
slpv2(1),
none(2)
}
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The type of discovery protocol used to discover remote
FCIP entities."
::= { fcipConfig 1 }
fcipDeviceWWN OBJECT-TYPE
SYNTAX FcNameIdOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The World Wide Name of this FCIP device."
::= { fcipConfig 2 }
fcipEntitySACKOption OBJECT-TYPE
SYNTAX INTEGER {
enabled(1),
FCIP MIB Expires October 2003 [Page 7]
Internet Draft FCIP MIB April 2003
disabled(2)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An indication of whether the TCP Selective Acknowledgement Option
is enabled at this FCIP device to allow the receiver end to acknow-
ledge multiple lost packets in a single ACK, enabling faster recovery."
REFERENCE
"The Selective Ack option is defined in RFC 2883."
::= { fcipConfig 3 }
-- ******************************************************************
-- fcipEntityInstanceTable
--
-- The FCIP Entity table contains information about the local FCIP device's
-- one or more instances of an FCIP Entity.
fcipEntityInstanceTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcipEntityInstanceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing FCIP entity specific information."
REFERENCE
"IETF IPS Working Group - draft-ietf-ips-fcovertcpip-12.txt"
::= { fcipConfig 4 }
fcipEntityInstanceEntry OBJECT-TYPE
SYNTAX FcipEntityInstanceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row of the FCIP entity table containing information
about a particular FCIP entity."
INDEX { fcipEntityId }
::= { fcipEntityInstanceTable 1 }
FcipEntityInstanceEntry ::=
SEQUENCE {
fcipEntityId OCTET STRING,
fcipEntityName DisplayString,
fcipEntityAddressType InetAddressType,
fcipEntityAddress InetAddress,
fcipEntityTcpConnPort Unsigned32,
fcipEntitySeqNumWrap TruthValue,
FCIP MIB Expires October 2003 [Page 8]
Internet Draft FCIP MIB April 2003
fcipEntityPHBSupport TruthValue,
fcipEntityStatus RowStatus
}
fcipEntityId OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(8))
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The FCIP entity identifier."
REFERENCE
"IETF IPS Working Group - draft-ietf-ips-fcovertcpip-12.txt"
::= { fcipEntityInstanceEntry 1 }
fcipEntityName OBJECT-TYPE
SYNTAX DisplayString (SIZE (0..32))
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"An administratively-assigned name for this FCIP entity."
::= { fcipEntityInstanceEntry 2 }
fcipEntityAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The type of Internet address by which the entity is reachable."
::= { fcipEntityInstanceEntry 3 }
fcipEntityAddress OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The Internet address for the entity, if configured."
::= { fcipEntityInstanceEntry 4 }
fcipEntityTcpConnPort OBJECT-TYPE
SYNTAX Unsigned32 (0..65535)
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"A TCP port other than the FCIP Well-Known port on which the FCIP
entity entity listens for new TCP connection requests. It contains
the value zero(0) if the FCIP Entity only listens on the Well-Known
port."
::= { fcipEntityInstanceEntry 5 }
FCIP MIB Expires October 2003 [Page 9]
Internet Draft FCIP MIB April 2003
fcipEntitySeqNumWrap OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An indication of whether the FCIP Entity supports the protection
against sequence number wrap."
REFERENCE
"The PAWS option is defined in RFC 1323."
::= { fcipEntityInstanceEntry 6 }
fcipEntityPHBSupport OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An indication of whether the FCIP Entity supports PHB IP QoS."
REFERENCE
"Per hop behavior is defined in RFC 2474, definition of the
Differentiated Services Field."
::= { fcipEntityInstanceEntry 7 }
fcipEntityStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This variable displays the status of the entry."
::= { fcipEntityInstanceEntry 8 }
-- ******************************************************************
-- fcipLinkTable
--
-- The FCIP link table contains information about this FCIP device's
-- existing FCIP links.
fcipLinkTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcipLinkEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing FCIP link specific information."
::= { fcipConfig 5 }
fcipLinkEntry OBJECT-TYPE
SYNTAX FcipLinkEntry
FCIP MIB Expires October 2003 [Page 10]
Internet Draft FCIP MIB April 2003
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row of the FCIP link table containing information
about a particular FCIP link."
INDEX { fcipEntityId, fcipLinkIndex }
::= { fcipLinkTable 1 }
FcipLinkEntry ::=
SEQUENCE {
fcipLinkIndex Unsigned32,
fcipLinkIfIndex InterfaceIndex,
fcipLinkCost Unsigned32,
fcipLinkLocalFcipEntityMode FcEntityMode,
fcipLinkLocalFcipEntityAddressType InetAddressType,
fcipLinkLocalFcipEntityAddress InetAddress,
fcipLinkRemFcipEntityWWN FcNameIdOrZero,
fcipLinkRemFcipEntityId Unsigned32,
fcipLinkRemFcipEntityAddressType InetAddressType,
fcipLinkRemFcipEntityAddress InetAddress,
fcipLinkStatus RowStatus
}
fcipLinkIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An arbitrary integer which uniquely identifies one FCIP link within
a FCIP entity."
::= { fcipLinkEntry 1 }
fcipLinkIfIndex OBJECT-TYPE
SYNTAX InterfaceIndex
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The ifIndex value of the virtual interface corresponding to the
FCIP Link running over TCP/IP."
::= { fcipLinkEntry 2 }
fcipLinkCost OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The FSPF cost associated with this FCIP Link."
::= { fcipLinkEntry 3 }
FCIP MIB Expires October 2003 [Page 11]
Internet Draft FCIP MIB April 2003
fcipLinkLocalFcipEntityMode OBJECT-TYPE
SYNTAX FcEntityMode
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The mode of the local end of the FCIP link."
::= { fcipLinkEntry 4 }
fcipLinkLocalFcipEntityAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The type of Internet address contained in the corresponding
instance of fcipLinkLocalFcipEntityAddress."
::= { fcipLinkEntry 5 }
fcipLinkLocalFcipEntityAddress OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The Internet address for the local end of this FCIP Link."
::= { fcipLinkEntry 6 }
fcipLinkRemFcipEntityWWN OBJECT-TYPE
SYNTAX FcNameIdOrZero
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The World Wide Name of the remote FC Fabric Entity."
REFERENCE
"IETF IPS Working Group - draft-ietf-ips-fcovertcpip-12.txt"
::= { fcipLinkEntry 7 }
fcipLinkRemFcipEntityId OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The remote FCIP entity's identifier."
REFERENCE
"IETF IPS Working Group - draft-ietf-ips-fcovertcpip-12.txt"
::= { fcipLinkEntry 8 }
fcipLinkRemFcipEntityAddressType OBJECT-TYPE
SYNTAX InetAddressType
FCIP MIB Expires October 2003 [Page 12]
Internet Draft FCIP MIB April 2003
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The type of Internet address contained in the corresponding
instance of fcipLinkRemFcipEntityAddress."
::= { fcipLinkEntry 9 }
fcipLinkRemFcipEntityAddress OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The Internet address for the remote end of this FCIP Link."
::= { fcipLinkEntry 10 }
fcipLinkStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this FCIP link."
::= { fcipLinkEntry 11 }
-- ******************************************************************
-- fcipTcpConnTable
--
-- The FCIP TCP Connection table contains information about existing TCP
-- connections. Each FCIP link within a FCIP entity manages one or more
-- TCP connections. The FCIP entity employs a Data Engine for each TCP
-- connection for handling FC frame encapsulation, de-encapsulation and
-- transmission of FCIP frames on the connection.
fcipTcpConnTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcipTcpConnEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing FCIP specific information about this FCIP
device's existing TCP connections."
::= { fcipConfig 6 }
fcipTcpConnEntry OBJECT-TYPE
SYNTAX FcipTcpConnEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
FCIP MIB Expires October 2003 [Page 13]
Internet Draft FCIP MIB April 2003
"A conceptual row of the FCIP TCP Connection table containing
information about a particular TCP connection."
INDEX { fcipEntityId,
fcipLinkIndex,
fcipTcpConnLocalPort,
fcipTcpConnRemPort }
::= { fcipTcpConnTable 1 }
FcipTcpConnEntry ::=
SEQUENCE {
fcipTcpConnLocalPort Unsigned32,
fcipTcpConnRemPort Unsigned32,
fcipTcpConnRWSize Unsigned32,
fcipTcpConnMSS Unsigned32
}
fcipTcpConnLocalPort OBJECT-TYPE
SYNTAX Unsigned32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The local port number for this TCP connection."
::= { fcipTcpConnEntry 1 }
fcipTcpConnRemPort OBJECT-TYPE
SYNTAX Unsigned32 (1..65535)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The remote port number for this TCP connection."
::= { fcipTcpConnEntry 2 }
fcipTcpConnRWSize OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The default maximum TCP Receiver Window size for this TCP
connection."
::= { fcipTcpConnEntry 3 }
fcipTcpConnMSS OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The TCP Maximum Segment Size(MSS) for this TCP connection."
::= { fcipTcpConnEntry 4 }
FCIP MIB Expires October 2003 [Page 14]
Internet Draft FCIP MIB April 2003
-- ******************************************************************
-- fcipDynamicRouteTable
--
-- The FCIP dynamic route table contains information about this FCIP
-- device's routing information that is dynamically discovered.
-- The FCIP device may use SLPv2 protocol in conjunction with oher
-- protocols, say FSPF, for dynamically discovering other FCIP entities,
-- and populate this table for Destination Address Identifier to
-- connecting FCIP link information.
fcipDynamicRouteTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcipDynamicRouteEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing FCIP Route specific information."
::= { fcipConfig 7 }
fcipDynamicRouteEntry OBJECT-TYPE
SYNTAX FcipDynamicRouteEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row of the FCIP Dynamic Route Table containing
information about a particular FCIP route."
INDEX { fcipEntityId, fcipDynamicRouteDID }
::= { fcipDynamicRouteTable 1 }
FcipDynamicRouteEntry ::=
SEQUENCE {
fcipDynamicRouteDID FcDomainId,
fcipDynamicRouteLinkIndex Unsigned32
}
fcipDynamicRouteDID OBJECT-TYPE
SYNTAX FcDomainId
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"8 bit ID of a Fibre Channel Domain that is reachable from
this FCIP device."
::= { fcipDynamicRouteEntry 1 }
fcipDynamicRouteLinkIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
FCIP MIB Expires October 2003 [Page 15]
Internet Draft FCIP MIB April 2003
STATUS current
DESCRIPTION
"The FCIP Link used to reach the domain specified by the
corresponding instance of fcipDynamicRouteDID. The link
identified by a value of this object is the same FCIP link
as identified by the same value of fcipLinkIndex for the
same FCIP entity."
::= { fcipDynamicRouteEntry 2 }
-- ******************************************************************
-- fcipStaticRouteTable
--
-- The FCIP static route table contains information about this FCIP
-- device's routing information that is created by the Network Admin.
-- In the absence of dynamic discovery of remote FCIP entities, the
-- Network Manager will figure out all the remote FCIP devices that
-- are reachable from this device, and populate this table with FCIP
-- link information for each Domain Id.
fcipStaticRouteTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcipStaticRouteEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing administratively configured FCIP entities
Route specific information."
::= { fcipConfig 8 }
fcipStaticRouteEntry OBJECT-TYPE
SYNTAX FcipStaticRouteEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row of the FCIP Static Route Table containing
information about a particular FCIP route."
INDEX { fcipEntityId, fcipStaticRouteDID }
::= { fcipStaticRouteTable 1 }
FcipStaticRouteEntry ::=
SEQUENCE {
fcipStaticRouteDID FcDomainId,
fcipStaticRouteLinkIndex Unsigned32,
fcipStaticRouteStatus RowStatus
}
fcipStaticRouteDID OBJECT-TYPE
SYNTAX FcDomainId
FCIP MIB Expires October 2003 [Page 16]
Internet Draft FCIP MIB April 2003
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"8 bit ID of a Fibre Channel Domain that is reachable from
this FCIP device."
::= { fcipStaticRouteEntry 1 }
fcipStaticRouteLinkIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The FCIP Link used to reach the domain specified by the
corresponding instance of fcipStaticRouteDID. The link
identified by a value of this object is the same FCIP link
as identified by the same value of fcipLinkIndex for the
same FCIP entity."
::= { fcipStaticRouteEntry 2 }
fcipStaticRouteStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The status of this row."
::= { fcipStaticRouteEntry 3 }
-- ******************************************************************
-- fcipDiscoveryDomainTable
--
-- The FCIP Discovery Domain Table maps this device's FCIP Entities into
-- FCIP Discovery Domains.
fcipDiscoveryDomainTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcipDiscoveryDomainEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table of information about FCIP Discovery Domains. Each FCIP
Discovery Domain can contain one or more FCIP entities."
::= { fcipConfig 9 }
fcipDiscoveryDomainEntry OBJECT-TYPE
SYNTAX FcipDiscoveryDomainEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
FCIP MIB Expires October 2003 [Page 17]
Internet Draft FCIP MIB April 2003
"A conceptual row of the FCIP Discovery Domain Table containing
information about a particular FCIP Discovery Domain which contains
one or more FCIP entities."
INDEX { fcipEntityId, fcipDiscoveryDomainIndex }
::= { fcipDiscoveryDomainTable 1 }
FcipDiscoveryDomainEntry ::=
SEQUENCE {
fcipDiscoveryDomainIndex Unsigned32,
fcipDiscoveryDomainName DisplayString
}
fcipDiscoveryDomainIndex OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An integer which uniquely identifies a FCIP Discovery Domain amongst
those associated with the FCIP entity to which this entity corresponds."
::= { fcipDiscoveryDomainEntry 1 }
fcipDiscoveryDomainName OBJECT-TYPE
SYNTAX DisplayString (SIZE (0..128))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The name of this FCIP Discovery Domain."
REFERENCE
"IETF IPS Working Group - draft-ietf-ips-fcip-slp-06.txt"
::= { fcipDiscoveryDomainEntry 2 }
-- ******************************************************************
-- fcipLinkErrorsTable
--
-- The FCIP Link Errors Table contains counters that record the
-- number of times each error case happened that caused closing
-- down a TCP connection.
fcipLinkErrorsTable OBJECT-TYPE
SYNTAX SEQUENCE OF FcipLinkErrorsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A table containing error counters for FCIP Links."
REFERENCE
"IETF IPS Working Group - draft-ietf-ips-fcovertcpip-12.txt"
FCIP MIB Expires October 2003 [Page 18]
Internet Draft FCIP MIB April 2003
::= { fcipConfig 10 }
fcipLinkErrorsEntry OBJECT-TYPE
SYNTAX FcipLinkErrorsEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A conceptual row of the FCIP Link Errors Table containing
error counters for a FCIP Link."
INDEX { fcipEntityId, fcipLinkIndex }
::= { fcipLinkErrorsTable 1 }
FcipLinkErrorsEntry ::=
SEQUENCE {
fcipLinkFcipLossofFcSynchs Counter32,
fcipLinkFcipEncapErrors Counter32,
fcipLinkFcipSfRespNotReceived Counter32,
fcipLinkFcipSfRespMismatches Counter32,
fcipLinkFcipSfInvalidNonces Counter32,
fcipLinkFcipDuplicateSfReceived Counter32,
fcipLinkFcipSfInvalidWWNs Counter32,
fcipLinkFcipBB2LkaTimeOuts Counter32,
fcipLinkFcipSntpTimeStampsExpired Counter32,
fcipLinkTcpTooManyErrors Counter32,
fcipLinkTcpExcessiveDatagramsDropped Counter32,
fcipLinkTcpSaParamMismatches Counter32
}
fcipLinkFcipLossofFcSynchs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times FC synchronization lost on this FCIP
Link."
::= { fcipLinkErrorsEntry 1 }
fcipLinkFcipEncapErrors OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of FCIP frames received with encapsulation errors
such as improper header, format, or length."
::= { fcipLinkErrorsEntry 2 }
fcipLinkFcipSfRespNotReceived OBJECT-TYPE
SYNTAX Counter32
FCIP MIB Expires October 2003 [Page 19]
Internet Draft FCIP MIB April 2003
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times an FCIP Special Frame Response was expected
but not received on this FCIP Link."
::= { fcipLinkErrorsEntry 3 }
fcipLinkFcipSfRespMismatches OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times FCIP Special Frame Bytes mismatch
happened on this FCIP Link."
::= { fcipLinkErrorsEntry 4 }
fcipLinkFcipSfInvalidNonces OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times FCIP Special Frame Invalid Connection
Nonce happened on this FCIP Link."
::= { fcipLinkErrorsEntry 5 }
fcipLinkFcipDuplicateSfReceived OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times duplicate FCIP Special Frames were received
on this FCIP Link."
::= { fcipLinkErrorsEntry 6 }
fcipLinkFcipSfInvalidWWNs OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times FCIP Special Frames with invalid
destination FC Fabric Entity WWN received on this FCIP Link."
::= { fcipLinkErrorsEntry 7 }
fcipLinkFcipBB2LkaTimeOuts OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
FCIP MIB Expires October 2003 [Page 20]
Internet Draft FCIP MIB April 2003
"The number of FC Keep Alive Time outs that occured on
this FCIP Link."
::= { fcipLinkErrorsEntry 8 }
fcipLinkFcipSntpTimeStampsExpired OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of frames discarded due to an expired SNTP Time Stamp
on this FCIP Link."
::= { fcipLinkErrorsEntry 9 }
fcipLinkTcpTooManyErrors OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of TCP connections that closed down on this
FCIP Link due to too many errors on the connection."
::= { fcipLinkErrorsEntry 10 }
fcipLinkTcpExcessiveDatagramsDropped OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of TCP connections that closed down on this
FCIP Link due to an excessive number of dropped FCIP packets."
::= { fcipLinkErrorsEntry 11 }
fcipLinkTcpSaParamMismatches OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of times TCP connections with Security Association(SA)
parameter mismatches closed down on this FCIP Link."
REFERENCE
"IETF IPS Working Group - draft-ietf-ips-fcovertcpip-12.txt"
::= { fcipLinkErrorsEntry 12 }
FCIP MIB Expires October 2003 [Page 21]
Internet Draft FCIP MIB April 2003
-- ******************************************************************
-- Conformance Statements
--
fcipCompliances OBJECT IDENTIFIER ::= { fcipConformance 1 }
fcipGroups OBJECT IDENTIFIER ::= { fcipConformance 2 }
fcipCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"Compliance statement for FCIP MIB."
MODULE -- this module
MANDATORY-GROUPS {
fcipEntityScalarGroup,
fcipEntityInstanceGroup,
fcipLinkGroup,
fcipTcpConnGroup,
fcipDiscoveryDomainGroup,
fcipLinkErrorsGroup
}
GROUP fcipDynamicRouteGroup
DESCRIPTION
"This group is mandatory only for systems which do not
have these objects in any other FC MIB. It may be implemented
even in that case for convenience."
GROUP fcipStaticRouteGroup
DESCRIPTION
"This group is mandatory only for systems which do not
have these objects in any other FC MIB. It may be implemented
even in that case for convenience."
::= { fcipCompliances 1 }
fcipEntityScalarGroup OBJECT-GROUP
OBJECTS {
fcipDynIpConfType,
fcipDeviceWWN,
fcipEntitySACKOption
}
STATUS current
DESCRIPTION
"A collection of scalar objects applicable to all FCIP instances."
::= { fcipGroups 1 }
fcipEntityInstanceGroup OBJECT-GROUP
FCIP MIB Expires October 2003 [Page 22]
Internet Draft FCIP MIB April 2003
OBJECTS {
fcipEntityName,
fcipEntityAddressType,
fcipEntityAddress,
fcipEntityTcpConnPort,
fcipEntitySeqNumWrap,
fcipEntityPHBSupport,
fcipEntityStatus
}
STATUS current
DESCRIPTION
"A collection of objects providing information about FCIP
instances."
::= { fcipGroups 2 }
fcipLinkGroup OBJECT-GROUP
OBJECTS {
fcipLinkIfIndex,
fcipLinkCost,
fcipLinkLocalFcipEntityMode,
fcipLinkLocalFcipEntityAddressType,
fcipLinkLocalFcipEntityAddress,
fcipLinkRemFcipEntityWWN,
fcipLinkRemFcipEntityId,
fcipLinkRemFcipEntityAddressType,
fcipLinkRemFcipEntityAddress,
fcipLinkStatus
}
STATUS current
DESCRIPTION
"A collection of objects providing information about FCIP
Links."
::= { fcipGroups 3 }
fcipTcpConnGroup OBJECT-GROUP
OBJECTS {
fcipTcpConnRWSize,
fcipTcpConnMSS
}
STATUS current
DESCRIPTION
"A collection of objects providing information about FCIP
TCP conections."
::= { fcipGroups 4 }
fcipDiscoveryDomainGroup OBJECT-GROUP
OBJECTS {
fcipDiscoveryDomainName
FCIP MIB Expires October 2003 [Page 23]
Internet Draft FCIP MIB April 2003
}
STATUS current
DESCRIPTION
"A collection of objects providing information about FCIP
Discovery Domains."
::= { fcipGroups 5 }
fcipLinkErrorsGroup OBJECT-GROUP
OBJECTS {
fcipLinkFcipLossofFcSynchs,
fcipLinkFcipEncapErrors,
fcipLinkFcipSfRespNotReceived,
fcipLinkFcipSfRespMismatches,
fcipLinkFcipSfInvalidNonces,
fcipLinkFcipDuplicateSfReceived,
fcipLinkFcipSfInvalidWWNs,
fcipLinkFcipBB2LkaTimeOuts,
fcipLinkFcipSntpTimeStampsExpired,
fcipLinkTcpTooManyErrors,
fcipLinkTcpExcessiveDatagramsDropped,
fcipLinkTcpSaParamMismatches
}
STATUS current
DESCRIPTION
"A collection of objects providing information about FCIP
link errors."
::= { fcipGroups 6 }
fcipDynamicRouteGroup OBJECT-GROUP
OBJECTS {
fcipDynamicRouteLinkIndex
}
STATUS current
DESCRIPTION
"A collection of objects providing information about FCIP
dynamic routes."
::= { fcipGroups 7 }
fcipStaticRouteGroup OBJECT-GROUP
OBJECTS {
fcipStaticRouteLinkIndex,
fcipStaticRouteStatus
}
STATUS current
DESCRIPTION
"A collection of objects providing information about FCIP
static routes."
FCIP MIB Expires October 2003 [Page 24]
Internet Draft FCIP MIB April 2003
::= { fcipGroups 8 }
END
FCIP MIB Expires October 2003 [Page 25]
Internet Draft FCIP MIB April 2003
6. Security considerations
There are a number of management objects defined in this MIB that
have 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.
There are a number of managed objects in this MIB that contain what
could be considered as sensitive information. In particular, the
objects which provide information on identification and network
topology:
fcipDeviceWWN
fcipEntityName
fcipEntityAddress
fcipLinkLocalFcipEntityAddress
fcipLinkRemFcipEntityWWN
fcipLinkRemFcipEntityAddress
fcipDynamicRouteTable
fcipStaticRouteTable
fcipDiscoveryDomainTable
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 implementers 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.
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
FCIP MIB Expires October 2003 [Page 26]
Internet Draft FCIP MIB April 2003
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
The authors acknowledge significant feedback and guidance from NM Area
advisor Keith McCloghrie, Cisco. In addition, comments and feedback from
members of the FCIP Working Group have been incorporated.
9. Normative References:
[FCIP] Rajagopal, M., et al "Fibre Channel Over TCP/IP (FCIP)",
<draft-ietf-ips-fcovertcpip-12.txt>, August 2002.
[FCBB2] Fibre Channel Backbone -2 v6 (FC-BB-2), T11/03-078v0,
February 2003.
[FCMGMT] McCloghrie, K., "Fibre Channel Management MIB",
<draft-ietf-ips-fcmgmt-mib-04.txt>, February 2003.
[RFC2571] Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture
for Describing SNMP Management Frameworks", RFC 2571, April
1999.
[RFC1212] Rose, M., and K. McCloghrie, "Concise MIB Definitions", STD
16, RFC 1212, March 1991.
[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
FCIP MIB Expires October 2003 [Page 27]
Internet Draft FCIP MIB April 2003
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.
10. Informative References
[RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.
11. Authors' Addresses
Anil Rijhsinghani
McDATA Corporation
4 McDATA Parkway
Broomfield, CO 80021
USA
E-mail: anil.rijhsinghani@mcdata.com
Ravi Natarajan
LightSand Communications, Inc.
279 Sinclair Frontage Road
Milpitas, CA 95035
USA
E-mail: ravin@lightsand.com
12. Full Copyright Notice
Copyright (C) The Internet Society (2003). All Rights Reserved.
This document and translations of it may be copied and furnished to
FCIP MIB Expires October 2003 [Page 28]
Internet Draft FCIP MIB April 2003
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.
FCIP MIB Expires October 2003 [Page 29]