Request for Comments: 4369 McDATA Corporation
Category: Standards Track C. Monia
Consultant
J. Tseng
Riverbed Technology
F. Travostino
Nortel
January 2006
Definitions of Managed Objects for
Internet Fibre Channel Protocol (iFCP)
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 Internet Society (2006).
Abstract
The iFCP protocol (RFC 4172) provides Fibre Channel fabric
functionality on an IP network in which TCP/IP switching and routing
elements replace Fibre Channel components. The iFCP protocol is used
between iFCP Gateways. This document provides a mechanism to monitor
and control iFCP Gateway instances, and their associated sessions,
using SNMP.
Table of Contents
1. The Internet-Standard Management Framework ......................2
2. Introduction ....................................................2
3. Technical Description ...........................................3
4. MIB Definition ..................................................4
5. IANA Considerations ............................................25
6. Security Considerations ........................................25
7. Normative References ...........................................26
8. Informative References .........................................27
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. Introduction
The iFCP protocol can be used by FC-to-IP-based storage gateways for
Fibre Channel Protocol (FCP) storage interconnects. Figure 1
provides an example of an interconnect between iFCP gateways.
Gateway Region Gateway Region
+--------+ +--------+ +--------+ +--------+
| FC | | FC | | FC | | FC |
| Device | | Device | | Device | | Device | Fibre
|........| |........| FC |........| |........| Channel
| N_PORT | | N_PORT |<.........>| N_PORT | | N_PORT | Device
+---+----+ +---+----+ Traffic +----+---+ +----+---+ Domain
| | | | ^
+---+----+ +---+----+ +----+---+ +----+---+ |
| F_PORT | | F_PORT | | F_PORT | | F_PORT | |
=+========+==+========+===========+========+==+========+==========
| iFCP Layer |<--------->| iFCP Layer | |
|....................| ^ |....................| |
| iFCP Portal | | | iFCP Portal | v
+--------+-----------+ | +----------+---------+ IP
iFCP|Gateway Control iFCP|Gateway Network
| Data |
| |
| |
|<------Encapsulated Frames------->|
| +------------------+ |
| | | |
+------+ IP Network +--------+
| |
+------------------+
Figure 1: Interconnect between iFCP Gateways
The iFCP MIB Module is designed to allow SNMP to be used to monitor
and manage local iFCP gateway instances, including the configuration
of iFCP sessions between gateways.
3. Technical Description
The iFCP MIB Module is divided into sections for iFCP local gateway
instance management, iFCP session management, and iFCP session
statistics.
The section for iFCP gateway management provides default settings and
information about each local instance. A single management entity
can monitor multiple local gateway instances. Each local gateway is
conceptually an independent gateway that has both Fibre Channel and
IP interfaces. The default IP Time Out Value (IP_TOV) is
configurable for each gateway. Other standard MIBs, such as the
Fibre Management MIB [RFC4044] or Interfaces Group MIB [RFC2863], can
be used to manage non-iFCP-specific gateway parameters. The local
gateway instance section provides iFCP-specific information as well
as optional links to other standard management MIBs.
The iFCP session management section provides information on iFCP
sessions that use one of the local iFCP gateway instances. This
section allows the management of specific iFCP parameters, including
changing the IP_TOV from the default setting of the gateway.
The iFCP session statistics section provides statistical information
on the iFCP sessions that use one of the local iFCP gateways. These
tables augment the session management table. Additional statistical
information for an iFCP gateway or session, that is not
iFCP-specific, can be obtained using other standard MIBs. The iFCP
statistics are provided in both standard and low-capacity (counter32)
methods.
The following MIB module imports from RMON2-MIB [RFC2021], SNMPv2-SMI
[RFC2578], SNMPv2-TC [RFC2579], SNMPv2-CONF [RFC2580], HCNUM-TC
[RFC2856], IF-MIB [RFC2863], SNMP-FRAMEWORK-MIB [RFC3411], INET-
ADDRESS-MIB [RFC4001], FC-MGMT-MIB [RFC4044], and ENTITY-MIB (v3)
[RFC4133].
4. MIB Definition
IFCP-MGMT-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
Gauge32,
Integer32,
Unsigned32,
transmission
FROM SNMPv2-SMI
OBJECT-GROUP,
MODULE-COMPLIANCE
FROM SNMPv2-CONF
TEXTUAL-CONVENTION,
TimeStamp,
TruthValue,
StorageType
FROM SNMPv2-TC
-- From RFC 2021
ZeroBasedCounter32
FROM RMON2-MIB
-- From RFC 2856
ZeroBasedCounter64
FROM HCNUM-TC
-- From RFC 2863
InterfaceIndexOrZero
FROM IF-MIB
-- From RFC 3411
SnmpAdminString
FROM SNMP-FRAMEWORK-MIB
-- From RFC 4001
InetAddressType,
InetAddress,
InetPortNumber
FROM INET-ADDRESS-MIB
-- From RFC 4044
FcNameIdOrZero,
FcAddressIdOrZero
FROM FC-MGMT-MIB
-- From RFC 4133
PhysicalIndexOrZero
FROM ENTITY-MIB
;
ifcpMgmtMIB MODULE-IDENTITY
LAST-UPDATED "200601170000Z"
ORGANIZATION "IETF IPS Working Group"
CONTACT-INFO "
Attn: Kevin Gibbons
McDATA Corporation
4555 Great America Pkwy
Santa Clara, CA 95054-1208 USA
Phone: (408) 567-5765
EMail: kevin.gibbons@mcdata.com
Charles Monia
Consultant
7553 Morevern Circle
San Jose, CA 95135 USA
EMail: charles_monia@yahoo.com
Josh Tseng
Riverbed Technology
501 2nd Street, Suite 410
San Francisco, CA 94107 USA
Phone: (650) 274-2109
EMail: joshtseng@yahoo.com
Franco Travostino
Nortel
600 Technology Park Drive
Billerica, MA 01821 USA
Phone: (978) 288-7708
EMail: travos@nortel.com"
DESCRIPTION
"This module defines management information specific
to internet Fibre Channel Protocol (iFCP) gateway
management.
Copyright (C) The Internet Society 2006. This
version of this MIB module is part of RFC 4369; see
the RFC itself for full legal notices."
REVISION "200601170000Z"
DESCRIPTION
"Initial version of iFCP Management Module.
This MIB published as RFC 4369."
::= { transmission 230 }
--
-- Textual Conventions
--
IfcpIpTOVorZero ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d"
STATUS current
DESCRIPTION "The maximum propagation delay, in seconds,
for an encapsulated FC frame to traverse the
IP network. A value of 0 implies fibre
channel frame lifetime limits will not be
enforced."
REFERENCE "RFC 4172, iFCP Protocol Specification"
SYNTAX Unsigned32 (0..3600)
IfcpLTIorZero ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d"
STATUS current
DESCRIPTION "The value for the Liveness Test Interval
(LTI) being used in an iFCP connection, in
seconds. A value of 0 implies no Liveness
Test Interval will be used."
REFERENCE "RFC 4172, iFCP Protocol Specification"
SYNTAX Unsigned32 (0..65535)
IfcpSessionStates ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION "The value for an iFCP session state."
SYNTAX INTEGER {down(1), openPending(2), open(3)}
IfcpAddressMode ::= TEXTUAL-CONVENTION
STATUS current
DESCRIPTION "The values for iFCP Address Translation
Mode."
REFERENCE "RFC 4172, iFCP Protocol Specification"
SYNTAX INTEGER {addressTransparent(1),
addressTranslation(2)}
--
-- Internet Fibre Channel Protocol (iFCP)
--
ifcpGatewayObjects OBJECT IDENTIFIER ::= {ifcpMgmtMIB 1}
ifcpGatewayConformance OBJECT IDENTIFIER ::= {ifcpMgmtMIB 2}
--
-- Local iFCP Gateway Instance Information ==================
--
ifcpLclGatewayInfo OBJECT IDENTIFIER ::= {ifcpGatewayObjects 1}
ifcpLclGtwyInstTable OBJECT-TYPE
SYNTAX SEQUENCE OF IfcpLclGtwyInstEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Information about all local iFCP Gateway instances that can
be monitored and controlled. This table contains an entry
for each local iFCP Gateway instance that is being managed."
::= {ifcpLclGatewayInfo 1}
ifcpLclGtwyInstEntry OBJECT-TYPE
SYNTAX IfcpLclGtwyInstEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry in the local iFCP Gateway Instance table.
Parameters and settings for the gateway are found here."
INDEX { ifcpLclGtwyInstIndex }
::= {ifcpLclGtwyInstTable 1}
IfcpLclGtwyInstEntry ::= SEQUENCE {
ifcpLclGtwyInstIndex Unsigned32,
ifcpLclGtwyInstPhyIndex PhysicalIndexOrZero,
ifcpLclGtwyInstVersionMin Unsigned32,
ifcpLclGtwyInstVersionMax Unsigned32,
ifcpLclGtwyInstAddrTransMode IfcpAddressMode,
ifcpLclGtwyInstFcBrdcstSupport TruthValue,
ifcpLclGtwyInstDefaultIpTOV IfcpIpTOVorZero,
ifcpLclGtwyInstDefaultLTInterval IfcpLTIorZero,
ifcpLclGtwyInstDescr SnmpAdminString,
ifcpLclGtwyInstNumActiveSessions Gauge32,
ifcpLclGtwyInstStorageType StorageType
}
ifcpLclGtwyInstIndex OBJECT-TYPE
SYNTAX Unsigned32 (1..2147483647)
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An arbitrary integer value to uniquely identify this iFCP
Gateway from other local Gateway instances."
::= {ifcpLclGtwyInstEntry 1}
ifcpLclGtwyInstPhyIndex OBJECT-TYPE
SYNTAX PhysicalIndexOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"An index indicating the location of this local gateway within
a larger entity, if one exists. If supported, this is the
entPhysicalIndex from the Entity MIB (Version 3), for this
iFCP Gateway. If not supported, or if not related to a
physical entity, then the value of this object is 0."
REFERENCE "Entity MIB (Version 3)"
::= {ifcpLclGtwyInstEntry 2}
ifcpLclGtwyInstVersionMin OBJECT-TYPE
SYNTAX Unsigned32 (0..255)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The minimum iFCP protocol version supported by the local iFCP
gateway instance."
REFERENCE "RFC 4172, iFCP Protocol Specification"
::= {ifcpLclGtwyInstEntry 3}
ifcpLclGtwyInstVersionMax OBJECT-TYPE
SYNTAX Unsigned32 (0..255)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The maximum iFCP protocol version supported by the local iFCP
gateway instance."
REFERENCE "RFC 4172, iFCP Protocol Specification"
::= {ifcpLclGtwyInstEntry 4}
ifcpLclGtwyInstAddrTransMode OBJECT-TYPE
SYNTAX IfcpAddressMode
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The local iFCP gateway operating mode. Changing this value
may cause existing sessions to be disrupted."
REFERENCE "RFC 4172, iFCP Protocol Specification"
DEFVAL { addressTranslation }
::= {ifcpLclGtwyInstEntry 5}
ifcpLclGtwyInstFcBrdcstSupport OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"Whether the local iFCP gateway supports FC Broadcast.
Changing this value may cause existing sessions to be
disrupted."
REFERENCE "RFC 4172, iFCP Protocol Specification"
DEFVAL { false }
::= {ifcpLclGtwyInstEntry 6}
ifcpLclGtwyInstDefaultIpTOV OBJECT-TYPE
SYNTAX IfcpIpTOVorZero
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The default IP_TOV used for iFCP sessions at this gateway.
This is the default maximum propagation delay that will be
used for an iFCP session. The value can be changed on a
per-session basis. The valid range is 0 - 3600 seconds.
A value of 0 implies that fibre channel frame lifetime limits
will not be enforced."
REFERENCE "RFC 4172, iFCP Protocol Specification"
DEFVAL { 6 }
::= {ifcpLclGtwyInstEntry 7}
ifcpLclGtwyInstDefaultLTInterval OBJECT-TYPE
SYNTAX IfcpLTIorZero
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"The default Liveness Test Interval (LTI), in seconds, used
for iFCP sessions at this gateway. This is the default
value for an iFCP session and can be changed on a
per-session basis. The valid range is 0 - 65535 seconds.
A value of 0 implies no Liveness Test Interval will be
performed on a session."
REFERENCE "RFC 4172, iFCP Protocol Specification"
DEFVAL { 10 }
::= {ifcpLclGtwyInstEntry 8}
ifcpLclGtwyInstDescr OBJECT-TYPE
SYNTAX SnmpAdminString (SIZE (0..64))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A user-entered description for this iFCP Gateway."
DEFVAL { "" }
::= {ifcpLclGtwyInstEntry 9}
ifcpLclGtwyInstNumActiveSessions OBJECT-TYPE
SYNTAX Gauge32 (0..4294967295)
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The current total number of iFCP sessions in the open or
open-pending state."
::= {ifcpLclGtwyInstEntry 10}
ifcpLclGtwyInstStorageType OBJECT-TYPE
SYNTAX StorageType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The storage type for this row. Parameter values defined
for a gateway are usually non-volatile, but may be volatile
or permanent in some configurations. If permanent, then
the following parameters must have read-write access:
ifcpLclGtwyInstAddrTransMode, ifcpLclGtwyInstDefaultIpTOV,
and ifcpLclGtwyInstDefaultLTInterval."
DEFVAL { nonVolatile }
::= {ifcpLclGtwyInstEntry 11}
--
-- iFCP N Port Session Information ============================
--
ifcpNportSessionInfo
OBJECT IDENTIFIER ::= {ifcpGatewayObjects 2}
ifcpSessionAttributesTable OBJECT-TYPE
SYNTAX SEQUENCE OF
IfcpSessionAttributesEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An iFCP session consists of the pair of N_PORTs comprising
the session endpoints joined by a single TCP/IP connection.
This table provides information on each iFCP session
currently using a local iFCP Gateway instance. iFCP sessions
are created and removed by the iFCP Gateway instances, which
are reflected in this table."
::= {ifcpNportSessionInfo 1}
ifcpSessionAttributesEntry OBJECT-TYPE
SYNTAX IfcpSessionAttributesEntry
MAX-ACCESS not-accessible
STATUS current