Debian Codegraph @

rfc4439.html

raw
1 <pre>Network Working Group C. DeSanti
2 Request for Comments: 4439 V. Gaonkar
3 Category: Standards Track K. McCloghrie
4 Cisco Systems
5 S. Gai
6 Retired
7 March 2006
8
9
10 <span class="h1">Fibre Channel Fabric Address Manager MIB</span>
11
12 Status of This Memo
13
14 This document specifies an Internet standards track protocol for the
15 Internet community, and requests discussion and suggestions for
16 improvements. Please refer to the current edition of the "Internet
17 Official Protocol Standards" (STD 1) for the standardization state
18 and status of this protocol. Distribution of this memo is unlimited.
19
20 Copyright Notice
21
22 Copyright (C) The Internet Society (2006).
23
24 Abstract
25
26 This memo defines a portion of the Management Information Base (MIB)
27 for use with network management protocols in the Internet community.
28 In particular, it describes managed objects for information related
29 to a Fibre Channel network's Fabric Address Manager.
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52 <span class="grey">DeSanti, et al. Standards Track [Page 1]</span></pre>
53 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-2" ></span>
54 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
55
56
57 Table of Contents
58
59 <a href="#section-1">1</a>. Introduction ....................................................<a href="#page-3">3</a>
60 <a href="#section-2">2</a>. The Internet-Standard Management Framework ......................<a href="#page-3">3</a>
61 <a href="#section-3">3</a>. Short Overview of Fibre Channel .................................<a href="#page-3">3</a>
62 <a href="#section-4">4</a>. Relationship to Other MIBs ......................................<a href="#page-4">4</a>
63 <a href="#section-5">5</a>. MIB Overview ....................................................<a href="#page-5">5</a>
64 <a href="#section-5.1">5.1</a>. Fibre Channel Management Instance ..........................<a href="#page-5">5</a>
65 <a href="#section-5.2">5.2</a>. Switch Index ...............................................<a href="#page-5">5</a>
66 <a href="#section-5.3">5.3</a>. Fabric Index ...............................................<a href="#page-5">5</a>
67 <a href="#section-5.4">5.4</a>. The t11FamGroup Group ......................................<a href="#page-6">6</a>
68 <a href="#section-5.5">5.5</a>. The t11FamDatabaseGroup Group ..............................<a href="#page-6">6</a>
69 <a href="#section-5.6">5.6</a>. The t11FamAreaGroup Group ..................................<a href="#page-6">6</a>
70 <a href="#section-5.7">5.7</a>. The t11FamCacheGroup Group .................................<a href="#page-6">6</a>
71 <a href="#section-5.8">5.8</a>. The t11FamCommandGroup Group ...............................<a href="#page-6">6</a>
72 <a href="#section-5.9">5.9</a>. The t11FamNotificationGroup Group ..........................<a href="#page-6">6</a>
73 <a href="#section-5.10">5.10</a>. Use of RCF and BF .........................................<a href="#page-6">6</a>
74 <a href="#section-6">6</a>. Definitions .....................................................<a href="#page-8">8</a>
75 <a href="#section-6.1">6.1</a>. The T11-TC-MIB Module ......................................<a href="#page-8">8</a>
76 <a href="#section-6.2">6.2</a>. The T11-FC-FABRIC-ADDR-MGR-MIB Module ......................<a href="#page-9">9</a>
77 <a href="#section-7">7</a>. Acknowledgements ...............................................<a href="#page-35">35</a>
78 <a href="#section-8">8</a>. Normative References ...........................................<a href="#page-36">36</a>
79 <a href="#section-9">9</a>. Informative References .........................................<a href="#page-36">36</a>
80 <a href="#section-10">10</a>. IANA Considerations ...........................................<a href="#page-37">37</a>
81 <a href="#section-11">11</a>. Security Considerations .......................................<a href="#page-37">37</a>
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108 <span class="grey">DeSanti, et al. Standards Track [Page 2]</span></pre>
109 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-3" ></span>
110 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
111
112
113 <span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>. Introduction</span>
114
115 This memo defines a portion of the Management Information Base (MIB)
116 for use with network management protocols in the Internet community.
117 In particular, it describes managed objects for information related
118 to a Fibre Channel network's Fabric Address Manager. Fabric Address
119 Manager refers to the functionality of acquiring DomainID(s) as
120 specified in [<a href="#ref-FC-SW-3" title="&quot;Fibre Channel - Switch Fabric - 3 (FC-SW-3)&quot;">FC-SW-3</a>], and managing Fibre Channel Identifiers as
121 specified in [<a href="#ref-FC-FS" title="&quot;Fibre Channel - Framing and Signaling (FC-FS)&quot;">FC-FS</a>].
122
123 <span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>. The Internet-Standard Management Framework</span>
124
125 For a detailed overview of the documents that describe the current
126 Internet-Standard Management Framework, please refer to <a href="./rfc3410#section-7">section&nbsp;7 of
127 RFC 3410</a> [<a href="./rfc3410" title="&quot;Introduction and Applicability Statements for Internet- Standard Management Framework&quot;">RFC3410</a>].
128
129 Managed objects are accessed via a virtual information store, termed
130 the Management Information Base or MIB. MIB objects are generally
131 accessed through the Simple Network Management Protocol (SNMP).
132 Objects in the MIB are defined using the mechanisms defined in the
133 Structure of Management Information (SMI). This memo specifies a MIB
134 module that is compliant to the SMIv2, which is described in STD 58,
135 <a href="./rfc2578">RFC 2578</a> [<a href="./rfc2578" title="&quot;Structure of Management Information Version 2 (SMIv2)&quot;">RFC2578</a>], STD 58, <a href="./rfc2579">RFC 2579</a> [<a href="./rfc2579" title="&quot;Textual Conventions for SMIv2&quot;">RFC2579</a>] and STD 58, <a href="./rfc2580">RFC 2580</a>
136 [<a href="./rfc2580" title="&quot;Conformance Statements for SMIv2&quot;">RFC2580</a>].
137
138 <span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>. Short Overview of Fibre Channel</span>
139
140 The Fibre Channel (FC) is logically a bidirectional point-to-point
141 serial data channel, structured for high performance. Fibre Channel
142 provides a general transport vehicle for higher-level protocols such
143 as Small Computer System Interface (SCSI) command sets, the High-
144 Performance Parallel Interface (HIPPI) data framing, IP (Internet
145 Protocol), IEEE 802.2, and others.
146
147 Physically, Fibre Channel is an interconnection of multiple
148 communication points, called N_Ports, interconnected either by a
149 switching network, called a Fabric, or by a point-to-point link. A
150 Fibre Channel "node" consists of one or more N_Ports. A Fabric may
151 consist of multiple Interconnect Elements, some of which are
152 switches. An N_Port connects to the Fabric via a port on a switch
153 called an F_Port. When multiple FC nodes are connected to a single
154 port on a switch via an "Arbitrated Loop" topology, the switch port
155 is called an FL_Port, and the nodes' ports are called NL_Ports. The
156 term Nx_Port is used to refer to either an N_Port or an NL_Port. The
157 term Fx_Port is used to refer to either an F_Port or an FL_Port. A
158 switch port, which is interconnected to another switch port via an
159
160
161
162
163
164 <span class="grey">DeSanti, et al. Standards Track [Page 3]</span></pre>
165 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-4" ></span>
166 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
167
168
169 Inter-Switch Link (ISL), is called an E_Port. A B_Port connects a
170 bridge device with an E_Port on a switch; a B_Port provides a subset
171 of E_Port functionality.
172
173 Many Fibre Channel components, including the Fabric, each node, and
174 most ports, have globally-unique names. These globally-unique names
175 are typically formatted as World Wide Names (WWNs). More information
176 on WWNs can be found in [<a href="#ref-FC-FS" title="&quot;Fibre Channel - Framing and Signaling (FC-FS)&quot;">FC-FS</a>]. WWNs are expected to be persistent
177 across agent and unit resets.
178
179 Fibre Channel frames contain 24-bit address identifiers, which
180 identify the frame's source and destination ports. Each FC port has
181 both an address identifier and a WWN. When a Fabric is in use, the
182 FC address identifiers are dynamically assigned by a switch. Each
183 octet of a 24-bit address represents a level in an address hierarchy,
184 with a Domain_ID being the highest level of the hierarchy.
185
186 Each switch in a Fabric is assigned one (or more) unique Domain_IDs
187 using a two-step process. First, one switch, called Principal
188 Switch, is selected from the switches of a Fabric. Then, the
189 Principal Switch assigns Domain_IDs to the other switches of the
190 Fabric. Address assignment within a domain is performed by the
191 switch to which that Domain_ID is granted.
192
193 <span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>. Relationship to Other MIBs</span>
194
195 The first standardized MIB for Fibre Channel [<a href="./rfc2837" title="&quot;Definitions of Managed Objects for the Fabric Element in Fibre Channel Standard&quot;">RFC2837</a>] was focused on
196 Fibre Channel switches. It is being replaced by the more generic
197 Fibre Channel Management MIB [<a href="#ref-FC-MGMT" title="&quot;Fibre Channel Management MIB&quot;">FC-MGMT</a>], which defines basic
198 information for Fibre Channel hosts and switches, including
199 extensions to the standard IF-MIB [<a href="#ref-IF-MIB" title="&quot;The Interfaces Group MIB&quot;">IF-MIB</a>] for Fibre Channel
200 interfaces. [<a href="#ref-FC-MGMT" title="&quot;Fibre Channel Management MIB&quot;">FC-MGMT</a>] includes the specification of how the generic
201 objects defined in [<a href="#ref-IF-MIB" title="&quot;The Interfaces Group MIB&quot;">IF-MIB</a>] apply to Fibre Channel interfaces.
202
203 Note that an interface's ifIndex value must be unique within an SNMP
204 context, irrespective of how many Fibre Channel management instances
205 (see below) and how many Fibre Channel switches are instrumented
206 within that SNMP context.
207
208 This document defines the T11-FC-FABRIC-ADDR-MGR-MIB module, which
209 extends beyond [<a href="#ref-FC-MGMT" title="&quot;Fibre Channel Management MIB&quot;">FC-MGMT</a>] to cover the functionality, in Fibre Channel
210 switches, which is used to manage Fabric configuration, domains, and
211 addresses within a domain.
212
213 This document also contains a MIB module, T11-TC-MIB, to define
214 textual conventions that might also be useful in other MIBs defined
215 by T11.
216
217
218
219
220 <span class="grey">DeSanti, et al. Standards Track [Page 4]</span></pre>
221 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-5" ></span>
222 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
223
224
225 <span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>. MIB Overview</span>
226
227 This section explains the use of a Fibre Channel management instance,
228 a Switch Index, and a Fabric Index. It also describes the six MIB
229 groups contained in the MIB.
230
231 <span class="h3"><a class="selflink" id="section-5.1" href="#section-5.1">5.1</a>. Fibre Channel Management Instance</span>
232
233 A Fibre Channel management instance is defined in [<a href="#ref-FC-MGMT" title="&quot;Fibre Channel Management MIB&quot;">FC-MGMT</a>] as a
234 separable managed instance of Fibre Channel functionality. Fibre
235 Channel functionality may be grouped into Fibre Channel management
236 instances in whatever way is most convenient for the
237 implementation(s). For example, one such grouping accommodates a
238 single SNMP agent having multiple AgentX sub-agents, with each sub-
239 agent implementing a different Fibre Channel management instance.
240
241 The object, fcmInstanceIndex, is IMPORTed from the FC-MGMT-MIB
242 [<a href="#ref-FC-MGMT" title="&quot;Fibre Channel Management MIB&quot;">FC-MGMT</a>] as the index value to uniquely identify a Fibre Channel
243 management instance.
244
245 <span class="h3"><a class="selflink" id="section-5.2" href="#section-5.2">5.2</a>. Switch Index</span>
246
247 The FC-MGMT-MIB [<a href="#ref-FC-MGMT" title="&quot;Fibre Channel Management MIB&quot;">FC-MGMT</a>] defines the fcmSwitchTable as a table of
248 information about Fibre Channel switches that are managed by Fibre
249 Channel management instances. Each Fibre Channel management instance
250 can manage one or more Fibre Channel switches. The Switch Index,
251 fcmSwitchIndex, is IMPORTed from the FC-MGMT-MIB as the index value
252 to uniquely identify a Fibre Channel switch amongst those (one or
253 more) managed by the same Fibre Channel management instance.
254
255 <span class="h3"><a class="selflink" id="section-5.3" href="#section-5.3">5.3</a>. Fabric Index</span>
256
257 The [<a href="#ref-FC-SW-3" title="&quot;Fibre Channel - Switch Fabric - 3 (FC-SW-3)&quot;">FC-SW-3</a>] standard for an interconnecting Fabric consisting of
258 multiple Fabric Switch elements describes the operation of a single
259 Fabric in a physical infrastructure. The current [<a href="#ref-FC-SW-4" title="&quot;Fibre Channel - Switch Fabric - 4 (FC-SW-4)&quot;">FC-SW-4</a>] standard
260 also supports the operation of multiple Virtual Fabrics operating
261 within one (or more) physical infrastructures. In such a scenario,
262 each Fabric has, of course, its own management instrumentation. In
263 order to accommodate this scenario, this MIB module defines all
264 Fabric-related information in tables that are INDEXed by an arbitrary
265 integer, named a "Fabric Index". In a Fabric that is conformant to
266 [<a href="#ref-FC-SW-3" title="&quot;Fibre Channel - Switch Fabric - 3 (FC-SW-3)&quot;">FC-SW-3</a>], the value of this Fabric Index will always be 1.
267
268
269
270
271
272
273
274
275
276 <span class="grey">DeSanti, et al. Standards Track [Page 5]</span></pre>
277 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-6" ></span>
278 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
279
280
281 It is quite possible, and may even become likely, that (a port of) a
282 Fibre Channel switch will be connected to multiple such Fabrics.
283 Thus, in order to simplify a query concerning all the Fabrics to
284 which a single switch is connected, fcmSwitchIndex will be listed
285 before t11FamFabricIndex when they both appear in the same INDEX
286 clause.
287
288 <span class="h3"><a class="selflink" id="section-5.4" href="#section-5.4">5.4</a>. The t11FamGroup Group</span>
289
290 This group contains basic information about the Fabric Address
291 Manager functionality within a switch, including its configuration
292 parameters that are per-interface (i.e., specified for a particular
293 Fibre Channel interface identified by an ifIndex value).
294
295 <span class="h3"><a class="selflink" id="section-5.5" href="#section-5.5">5.5</a>. The t11FamDatabaseGroup Group</span>
296
297 This group contains information about which switches are assigned to
298 which domains.
299
300 <span class="h3"><a class="selflink" id="section-5.6" href="#section-5.6">5.6</a>. The t11FamAreaGroup Group</span>
301
302 This group contains information about which Port-IDs have been
303 assigned within the areas of the local domain.
304
305 <span class="h3"><a class="selflink" id="section-5.7" href="#section-5.7">5.7</a>. The t11FamCacheGroup Group</span>
306
307 This conditional mandatory group contains information about all the
308 FC address identifier assignments that have been recently released.
309 This cache is kept to support the concept of Preferred Domain_ID via
310 a best-effort attempt for (short-term) re-assignment of the same FC
311 address identifiers.
312
313 <span class="h3"><a class="selflink" id="section-5.8" href="#section-5.8">5.8</a>. The t11FamCommandGroup Group</span>
314
315 This optional group contains objects used for initiating an operation
316 on a Fabric.
317
318 <span class="h3"><a class="selflink" id="section-5.9" href="#section-5.9">5.9</a>. The t11FamNotificationGroup Group</span>
319
320 This group contains notifications of significant events concerning
321 the Fabric Address management functionality within a switch.
322
323 <span class="h3"><a class="selflink" id="section-5.10" href="#section-5.10">5.10</a>. Use of RCF and BF</span>
324
325 Included in [<a href="#ref-FC-SW-3" title="&quot;Fibre Channel - Switch Fabric - 3 (FC-SW-3)&quot;">FC-SW-3</a>] is the specification of Reconfigure Fabric
326 (RCF) and Build Fabric (BF), both of which are command codes of the
327 Switch Fabric Internal Link Service (SW_ILS). [<a href="#ref-FC-SW-3" title="&quot;Fibre Channel - Switch Fabric - 3 (FC-SW-3)&quot;">FC-SW-3</a>] includes the
328 warning:
329
330
331
332 <span class="grey">DeSanti, et al. Standards Track [Page 6]</span></pre>
333 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-7" ></span>
334 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
335
336
337 NOTE 13 - Since the RCF causes a complete reconfiguration of the
338 Fabric, and may cause addresses allocated to a Switch to change,
339 this SW_ILS should be used with caution. The BF SW_ILS allows the
340 Fabric to attempt reconfiguration without loss of or change of
341 address and therefore should be attempted before an RCF. Examples
342 of situations in which RCF may be appropriate include resolution
343 of overlapped Domains, or the failure of a Fabric Reconfiguration
344 initiated by a BF.
345
346 Further, [<a href="#ref-FC-MI" title="&quot;Fibre Channel - Methodologies for Interconnects (FC-MI)&quot;">FC-MI</a>] specifies:
347
348 A Fabric is prohibited from autonomously generating an RCF, but an
349 outside administrative function may request a switch to generate
350 an RCF. Such an administrative function is outside the scope of
351 this technical report.
352
353 The T11-FC-FABRIC-ADDR-MGR-MIB defined in this document is consistent
354 with both of the above quotes since it defines two objects,
355 t11FamAutoReconfigure and t11FamRestart, which are defined with a
356 MAX-ACCESS of read-write, and setting them to the appropriate value
357 is a means by which "an outside administrative function may request a
358 switch to generate an RCF" [<a href="#ref-FC-MI" title="&quot;Fibre Channel - Methodologies for Interconnects (FC-MI)&quot;">FC-MI</a>].
359
360 Note, however, the MIB specifies in its compliance section that the
361 minimum required level of support for these two objects is read-only.
362
363 Further, for both t11FamAutoReconfigure and t11FamRestart, the MIB
364 serves only as a request to generate; it does not represent the
365 action of the RCF or BF. That is, a successful SNMP SetRequest on
366 these objects will cause an RCF (or BF) to be sent, but SNMP does
367 not/cannot ensure the successful operation of the SW_ILS operation.
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388 <span class="grey">DeSanti, et al. Standards Track [Page 7]</span></pre>
389 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-8" ></span>
390 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
391
392
393 <span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>. Definitions</span>
394
395 <span class="h3"><a class="selflink" id="section-6.1" href="#section-6.1">6.1</a>. The T11-TC-MIB Module</span>
396
397 T11-TC-MIB DEFINITIONS ::= BEGIN
398
399 IMPORTS
400 MODULE-IDENTITY, Unsigned32, mib-2
401 FROM SNMPv2-SMI -- [<a href="./rfc2578" title="&quot;Structure of Management Information Version 2 (SMIv2)&quot;">RFC2578</a>]
402 TEXTUAL-CONVENTION FROM SNMPv2-TC; -- [<a href="./rfc2579" title="&quot;Textual Conventions for SMIv2&quot;">RFC2579</a>]
403
404 t11TcMIB MODULE-IDENTITY
405 LAST-UPDATED "200603020000Z"
406 ORGANIZATION "T11"
407 CONTACT-INFO
408 " Claudio DeSanti
409 Cisco Systems, Inc.
410 170 West Tasman Drive
411 San Jose, CA 95134 USA
412 Phone: +1 408 853-9172
413 EMail: [email protected]
414
415 Keith McCloghrie
416 Cisco Systems, Inc.
417 170 West Tasman Drive
418 San Jose, CA USA 95134
419 Phone: +1 408-526-5260
420 EMail: [email protected]"
421 DESCRIPTION
422 "This module defines textual conventions used in T11 MIBs.
423
424 Copyright (C) The Internet Society (2006). This version
425 of this MIB module is part of <a href="./rfc4439">RFC 4439</a>; see the RFC
426 itself for full legal notices."
427 REVISION "200603020000Z"
428 DESCRIPTION
429 "Initial version of this MIB module, published as <a href="./rfc4439">RFC 4439</a>."
430 ::= { mib-2 136 }
431
432 T11FabricIndex ::= TEXTUAL-CONVENTION
433 DISPLAY-HINT "d"
434 STATUS current
435 DESCRIPTION
436 "A Fabric Index that is used as a unique
437 index value to identify a particular Fabric within
438 one (or more) physical infrastructures.
439
440 In an environment that is conformant to FC-SW-3, where
441
442
443
444 <span class="grey">DeSanti, et al. Standards Track [Page 8]</span></pre>
445 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-9" ></span>
446 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
447
448
449 there is always exactly one Fabric in a single physical
450 infrastructure, the value of this Fabric Index will
451 always be 1.
452
453 However, the current standard, FC-SW-4, defines
454 how multiple Fabrics, each with its own management
455 instrumentation, could operate within one (or more)
456 physical infrastructures. When such multiple Fabrics
457 are in use, this index value is used to uniquely
458 identify a particular Fabric within a physical
459 infrastructure.
460
461 Note that the value of this textual convention has a
462 range of (0..4095) so as to be consistent with FC-SW-4,
463 which says that a 'VF_ID Bitmap' is 512 bytes long, with
464 the high-order bit representing VF_ID zero, and the
465 low-order bit representing 4095."
466 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4),
467 ANSI INCITS 418-2006, <a href="#section-6.1.27.2.4">section 6.1.27.2.4</a>."
468 SYNTAX Unsigned32 (0..4095)
469
470 END
471
472 <span class="h3"><a class="selflink" id="section-6.2" href="#section-6.2">6.2</a>. The T11-FC-FABRIC-ADDR-MGR-MIB Module</span>
473
474 T11-FC-FABRIC-ADDR-MGR-MIB DEFINITIONS ::= BEGIN
475
476 -- the Fibre Channel Fabric Address Manager MIB
477 --
478 -- for management of the functionality, in Fibre Channel switches,
479 -- which is used to manage fabric configuration, domains, and
480 -- addresses within a domain.
481 --
482
483 IMPORTS
484 MODULE-IDENTITY, OBJECT-TYPE,
485 NOTIFICATION-TYPE, Unsigned32,
486 Counter32, Gauge32, mib-2 FROM SNMPv2-SMI -- [<a href="./rfc2578" title="&quot;Structure of Management Information Version 2 (SMIv2)&quot;">RFC2578</a>]
487 MODULE-COMPLIANCE, OBJECT-GROUP,
488 NOTIFICATION-GROUP FROM SNMPv2-CONF -- [<a href="./rfc2580" title="&quot;Conformance Statements for SMIv2&quot;">RFC2580</a>]
489 TEXTUAL-CONVENTION, TruthValue,
490 RowStatus FROM SNMPv2-TC -- [<a href="./rfc2579" title="&quot;Textual Conventions for SMIv2&quot;">RFC2579</a>]
491 ifIndex FROM IF-MIB -- [<a href="#ref-IF-MIB" title="&quot;The Interfaces Group MIB&quot;">IF-MIB</a>]
492 fcmInstanceIndex, fcmSwitchIndex,
493 FcDomainIdOrZero, FcNameIdOrZero FROM FC-MGMT-MIB -- [<a href="#ref-FC-MGMT" title="&quot;Fibre Channel Management MIB&quot;">FC-MGMT</a>]
494 T11FabricIndex FROM T11-TC-MIB;
495
496 t11FcFabricAddrMgrMIB MODULE-IDENTITY
497
498
499
500 <span class="grey">DeSanti, et al. Standards Track [Page 9]</span></pre>
501 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-10" ></span>
502 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
503
504
505 LAST-UPDATED "200603020000Z"
506 ORGANIZATION "T11"
507 CONTACT-INFO
508 " Claudio DeSanti
509 Cisco Systems, Inc.
510 170 West Tasman Drive
511 San Jose, CA 95134 USA
512 Phone: +1 408 853-9172
513 EMail: [email protected]
514
515 Keith McCloghrie
516 Cisco Systems, Inc.
517 170 West Tasman Drive
518 San Jose, CA USA 95134
519 Phone: +1 408-526-5260
520 EMail: [email protected]"
521 DESCRIPTION
522 "The MIB module for the Fabric Address management
523 functionality defined by the Fibre Channel standards. For
524 the purposes of this MIB, Fabric Address Manager refers to
525 the functionality of acquiring DomainID(s) as specified in
526 FC-SW-3, and managing Fibre Channel Identifiers as specified
527 in FC-FS. An instance of 'Fabric Address Manager' software
528 functionality executes in the Principal Switch, and in each
529 other switch.
530
531 After an agent reboot, the values of read-write objects
532 defined in this MIB module are implementation-dependent.
533
534 Copyright (C) The Internet Society (2006). This version of
535 this MIB module is part of <a href="./rfc4439">RFC 4439</a>; see the RFC itself for
536 full legal notices."
537 REVISION "200603020000Z"
538 DESCRIPTION
539 "Initial version of this MIB module, published as <a href="./rfc4439">RFC 4439</a>."
540 ::= { mib-2 137 }
541
542 t11FamNotifications OBJECT IDENTIFIER ::= { t11FcFabricAddrMgrMIB 0 }
543 t11FamMIBObjects OBJECT IDENTIFIER ::= { t11FcFabricAddrMgrMIB 1 }
544 t11FamMIBConformance OBJECT IDENTIFIER ::= { t11FcFabricAddrMgrMIB 2 }
545 t11FamConfiguration OBJECT IDENTIFIER ::= { t11FamMIBObjects 1 }
546 t11FamInfo OBJECT IDENTIFIER ::= { t11FamMIBObjects 2 }
547 t11FamNotifyControl OBJECT IDENTIFIER ::= { t11FamMIBObjects 3 }
548
549
550 -- Textual Conventions
551
552 T11FamDomainPriority ::= TEXTUAL-CONVENTION
553
554
555
556 <span class="grey">DeSanti, et al. Standards Track [Page 10]</span></pre>
557 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-11" ></span>
558 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
559
560
561 DISPLAY-HINT "d"
562 STATUS current
563 DESCRIPTION
564 "Priority of a switch.
565
566 The Principal Switch selection is influenced by the
567 priority of the switches.
568
569 Some values of importance are:
570
571 1 : The highest priority in Principal Switch
572 selection, which is used by the administrator
573 to establish which switch becomes the Principal
574 Switch.
575 255 : Indicates that the switch is not capable of
576 acting as a Principal Switch."
577 REFERENCE "Fibre Channel - Switch Fabric - 3 (FC-SW-3),
578 ANSI INCITS 384-2004, <a href="#section-6.1.5">section 6.1.5</a>."
579 SYNTAX Unsigned32 (1..255)
580
581 T11FamDomainInterfaceRole ::= TEXTUAL-CONVENTION
582 STATUS current
583 DESCRIPTION
584 "The 'designated' state/role of the Inter-Switch Link (ISL)
585 to which an interface connects, or (if not connected)
586 the state of the interface:
587
588 nonPrincipal (1) - non-Principal ISL
589 principalUpstream (2) - Upstream Principal ISL
590 principalDownsteam (3) - Downstream Principal ISL
591 isolated (4) - interface is isolated
592 down (5) - interface is down
593 unknown (6) - state/role is unknown
594 "
595 REFERENCE "Fibre Channel - Switch Fabric - 3 (FC-SW-3),
596 ANSI INCITS 384-2004, Sections <a href="#section-3.1">3.1</a>, <a href="#section-5.7">5.7</a>,
597 and Figure 9."
598 SYNTAX INTEGER {
599 nonPrincipal (1),
600 principalUpstream (2),
601 principalDownsteam (3),
602 isolated (4),
603 down (5),
604 unknown (6)
605 }
606
607 T11FamState ::= TEXTUAL-CONVENTION
608 STATUS current
609
610
611
612 <span class="grey">DeSanti, et al. Standards Track [Page 11]</span></pre>
613 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-12" ></span>
614 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
615
616
617 DESCRIPTION
618 "The state of the Fabric Address Manager, as described in
619 Table 86 and Figure 15 of FC-SW-3.
620
621 - 'other' represents a switch that is in a state not
622 represented by any of the below enumerations.
623
624 - 'starting' represents a switch engaged in the process
625 represented by the first row in Table 86.
626
627 - 'unconfigured' represents a switch that requires
628 operator input before it can begin the process
629 represented by the first row in Table 86.
630
631 - 'principalSwitchSelection' represents a switch engaged
632 in the process represented by the second row in
633 Table 86, but not in states F0 or F1 of Figure 15.
634
635 - 'domainIdDistribution' represents a switch engaged in
636 the process represented by the third row in Table 86.
637
638 - 'buildFabricPhase' represents a switch that is in
639 state F0 of Figure 15.
640
641 - 'reconfigureFabricPhase' represents a switch that is
642 in state F1 of Figure 15.
643
644 - 'stable' represents a switch that has successfully
645 completed the process represented by the third row in
646 Table 86 and has at least one E_Port.
647
648 - 'stableWithNoEports' represents a switch that has
649 successfully completed the process represented by the
650 third row in Table 86 but has no E_Ports.
651
652 - 'noDomains' represents a switch that has completed
653 the process represented by the third row in Table 86
654 but failed to obtain a Domain_ID.
655
656 - 'disabled' represents any situation in which the
657 corresponding instance of t11FamEnable has the value
658 'false'.
659
660 - 'unknown' represents a switch that is confused about
661 what state it is in."
662 REFERENCE "Fibre Channel - Switch Fabric - 3 (FC-SW-3),
663 ANSI INCITS 384-2004, Table 86 and Figure 15."
664 SYNTAX INTEGER {
665
666
667
668 <span class="grey">DeSanti, et al. Standards Track [Page 12]</span></pre>
669 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-13" ></span>
670 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
671
672
673 other(1),
674 starting(2),
675 unconfigured(3),
676 principalSwitchSelection(4),
677 domainIdDistribution(5),
678 buildFabricPhase(6),
679 reconfigureFabricPhase(7),
680 stable(8),
681 stableWithNoEports(9),
682 noDomains(10),
683 disabled(11),
684 unknown(12)
685 }
686
687
688 --
689 -- t11FamTable
690 --
691
692 t11FamTable OBJECT-TYPE
693 SYNTAX SEQUENCE OF T11FamEntry
694 MAX-ACCESS not-accessible
695 STATUS current
696 DESCRIPTION
697 "This table contains Fabric Address Manager related
698 parameters that are able to be configured and monitored
699 in a Fibre Channel switch. For each of the switches
700 (identified by fcmSwitchIndex) managed by a Fibre Channel
701 management instance (identified by fcmInstanceIndex),
702 there is any entry for each Fabric known to that switch.
703 Entries are implicitly created/removed if and when
704 additional Fabrics are created/deleted."
705 ::= { t11FamConfiguration 1 }
706
707 t11FamEntry OBJECT-TYPE
708 SYNTAX T11FamEntry
709 MAX-ACCESS not-accessible
710 STATUS current
711 DESCRIPTION
712 "An entry provides information on the local Fabric Address
713 Manager functionality for a Fabric known to a
714 particular switch."
715 INDEX { fcmInstanceIndex, fcmSwitchIndex, t11FamFabricIndex }
716 ::= { t11FamTable 1 }
717
718 T11FamEntry ::= SEQUENCE {
719 t11FamFabricIndex T11FabricIndex,
720 t11FamConfigDomainId FcDomainIdOrZero,
721
722
723
724 <span class="grey">DeSanti, et al. Standards Track [Page 13]</span></pre>
725 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-14" ></span>
726 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
727
728
729 t11FamConfigDomainIdType INTEGER,
730 t11FamAutoReconfigure TruthValue,
731 t11FamContiguousAllocation TruthValue,
732 t11FamPriority T11FamDomainPriority,
733 t11FamPrincipalSwitchWwn FcNameIdOrZero,
734 t11FamLocalSwitchWwn FcNameIdOrZero,
735 t11FamAssignedAreaIdList OCTET STRING,
736 t11FamGrantedFcIds Counter32,
737 t11FamRecoveredFcIds Counter32,
738 t11FamFreeFcIds Gauge32,
739 t11FamAssignedFcIds Gauge32,
740 t11FamAvailableFcIds Gauge32,
741 t11FamRunningPriority T11FamDomainPriority,
742 t11FamPrincSwRunningPriority T11FamDomainPriority,
743 t11FamState T11FamState,
744 t11FamLocalPrincipalSwitchSlctns Counter32,
745 t11FamPrincipalSwitchSelections Counter32,
746 t11FamBuildFabrics Counter32,
747 t11FamFabricReconfigures Counter32,
748 t11FamDomainId FcDomainIdOrZero,
749 t11FamSticky TruthValue,
750 t11FamRestart INTEGER,
751 t11FamRcFabricNotifyEnable TruthValue,
752 t11FamEnable TruthValue,
753 t11FamFabricName FcNameIdOrZero
754 }
755
756 t11FamFabricIndex OBJECT-TYPE
757 SYNTAX T11FabricIndex
758 MAX-ACCESS not-accessible
759 STATUS current
760 DESCRIPTION
761 "A unique index value that uniquely identifies a
762 particular Fabric known to a particular switch.
763
764 In a Fabric conformant to FC-SW-3, only a single Fabric
765 can operate within a physical infrastructure, and thus,
766 the value of this Fabric Index will always be 1.
767
768 However, the current standard, FC-SW-4, defines
769 how multiple Fabrics, each with its own management
770 instrumentation, could operate within one (or more)
771 physical infrastructures. When such multiple Fabrics
772 are in use, this index value is used to uniquely
773 identify a particular Fabric within a physical
774 infrastructure."
775 ::= { t11FamEntry 1 }
776
777
778
779
780 <span class="grey">DeSanti, et al. Standards Track [Page 14]</span></pre>
781 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-15" ></span>
782 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
783
784
785 t11FamConfigDomainId OBJECT-TYPE
786 SYNTAX FcDomainIdOrZero
787 MAX-ACCESS read-write
788 STATUS current
789 DESCRIPTION
790 "The configured Domain_ID of the particular switch on this
791 Fabric, or zero if no Domain_ID has been configured.
792 The meaning of this object depends on
793 t11FamConfigDomainIdType object.
794
795 If t11FamConfigDomainIdType is 'preferred', then the
796 configured Domain_ID is called the 'preferred Domain_ID'.
797 Valid values are between 0 and 239. In a situation where
798 this Domain_ID cannot be assigned, any other Domain_ID
799 will be acceptable. A value of zero means any Domain_ID.
800
801 If t11FamConfigDomainIdType is 'insistent', then the
802 configured Domain_ID is called the 'insistent Domain_ID' and
803 valid values are between 1 and 239. In a situation where
804 this Domain_ID cannot be assigned, no other Domain_ID is
805 acceptable.
806
807 In both of the above cases, the switch sends an RDI (Request
808 Domain_ID) to request this Domain_ID to the Principal
809 Switch. If no Domain_ID is able to be granted in the case
810 of 'preferred', or if an 'insistent' Domain_ID is configured
811 but not able to be granted, then it is an error condition.
812 When this error occurs, the switch will continue as if it
813 receives a SW_RJT with a reason/explanation of 'Unable to
814 perform command request'/'Domain_ID not available'. That
815 is, its E_Ports on that Fabric will be isolated and the
816 administrator informed via a 't11FamDomainIdNotAssigned'
817 notification.
818
819 If t11FamConfigDomainIdType is 'static', then the configured
820 Domain_ID is called the 'static Domain_ID' and valid values
821 are between 1 and 239. In this situation, there is no
822 Principal Switch in the Fabric and the Domain_ID is simply
823 assigned by configuration, together with the Fabric_Name.
824 A switch configured with a static Domain_ID, on receiving
825 an EFP, BF, RCF, DIA, or RDI SW_ILS, shall reply with an
826 SW_RJT having Reason Code Explanation 'E_Port is Isolated'
827 and shall isolate the receiving E_Port.
828
829 For the persistence of values across reboots, see the
830 MODULE-IDENTITY's DESCRIPTION clause."
831 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4),
832 ANSI INCITS 418-2006, <a href="#section-7">section 7</a>."
833
834
835
836 <span class="grey">DeSanti, et al. Standards Track [Page 15]</span></pre>
837 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-16" ></span>
838 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
839
840
841 DEFVAL { 0 }
842 ::= { t11FamEntry 2 }
843
844 t11FamConfigDomainIdType OBJECT-TYPE
845 SYNTAX INTEGER {
846 preferred(1),
847 insistent(2),
848 static(3)
849 }
850 MAX-ACCESS read-write
851 STATUS current
852 DESCRIPTION
853 "Type of configured Domain_ID contained in
854 t11FamConfigDomainId.
855
856 For the persistence of values across reboots, see the
857 MODULE-IDENTITY's DESCRIPTION clause."
858 DEFVAL { preferred }
859 ::= { t11FamEntry 3 }
860
861 t11FamAutoReconfigure OBJECT-TYPE
862 SYNTAX TruthValue
863 MAX-ACCESS read-write
864 STATUS current
865 DESCRIPTION
866 "This object determines how a particular switch
867 responds to certain error conditions.
868
869 The condition that might cause these errors is
870 the merging of two disjoint Fabrics that have
871 overlapping Domain_ID lists.
872
873 If value of this object is 'true', the switch will
874 send an RCF (ReConfigureFabric) to rebuild the
875 Fabric.
876
877 If 'false', the switch will isolate the E_Ports on
878 which the errors happened.
879
880 For the persistence of values across reboots, see the
881 MODULE-IDENTITY's DESCRIPTION clause."
882 REFERENCE "Fibre Channel - Switch Fabric - 3 (FC-SW-3),
883 December 2003, sections <a href="#section-6.1.12">6.1.12</a> &amp; 7.3.
884 Fibre Channel - Methodologies for Interconnects
885 (FC-MI), INCITS TR-30-2002, table 14, note g."
886 DEFVAL { false }
887 ::= { t11FamEntry 4 }
888
889
890
891
892 <span class="grey">DeSanti, et al. Standards Track [Page 16]</span></pre>
893 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-17" ></span>
894 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
895
896
897 t11FamContiguousAllocation OBJECT-TYPE
898 SYNTAX TruthValue
899 MAX-ACCESS read-write
900 STATUS current
901 DESCRIPTION
902 "Determines how a particular switch behaves when elected as
903 the Principal Switch.
904
905 If true, the switch will only accept RDIs with a contiguous
906 allocation; specifically, it will reject RDIs with
907 non-contiguous Domain_IDs, and if an RDI for a contiguous
908 Domain_ID is not able to be fulfilled, it will try to
909 replace all the Domain_IDs in the list with contiguous
910 Domain_IDs, and if that fails, the RDI will be rejected.
911
912 If false, then the switch acts normally in granting
913 the Domain_IDs even if they are not contiguous.
914
915 For the persistence of values across reboots, see the
916 MODULE-IDENTITY's DESCRIPTION clause."
917 ::= { t11FamEntry 5 }
918
919 t11FamPriority OBJECT-TYPE
920 SYNTAX T11FamDomainPriority
921 MAX-ACCESS read-write
922 STATUS current
923 DESCRIPTION
924 "The initial or configured priority of a particular switch
925 to be used in Principal Switch selection process.
926
927 For the persistence of values across reboots, see the
928 MODULE-IDENTITY's DESCRIPTION clause."
929 ::= { t11FamEntry 6 }
930
931 t11FamPrincipalSwitchWwn OBJECT-TYPE
932 SYNTAX FcNameIdOrZero
933 MAX-ACCESS read-only
934 STATUS current
935 DESCRIPTION
936 "The WWN of the Principal Switch on this Fabric,
937 or zero-length string if the identity of the principal
938 switch is unknown."
939 DEFVAL { ''H }
940 ::= { t11FamEntry 7 }
941
942 t11FamLocalSwitchWwn OBJECT-TYPE
943 SYNTAX FcNameIdOrZero
944 MAX-ACCESS read-only
945
946
947
948 <span class="grey">DeSanti, et al. Standards Track [Page 17]</span></pre>
949 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-18" ></span>
950 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
951
952
953 STATUS current
954 DESCRIPTION
955 "The WWN of the particular switch on this Fabric."
956 ::= { t11FamEntry 8 }
957
958 t11FamAssignedAreaIdList OBJECT-TYPE
959 SYNTAX OCTET STRING (SIZE(0..256))
960 MAX-ACCESS read-only
961 STATUS current
962 DESCRIPTION
963 "The list of (zero or more) Area_IDs that have been
964 assigned by a particular switch in this Fabric, formatted
965 as an array of octets in ascending order.
966
967 Each octet represents one Area_ID. So, the list containing
968 Area_IDs 23, 45, 235, and 56 would be formatted as the
969 4-octet string x'172d38eb'.
970
971 A particular area's Area_ID is used as the index into the
972 t11FamAreaTable to get the statistics on that area."
973 ::= { t11FamEntry 9 }
974
975 t11FamGrantedFcIds OBJECT-TYPE
976 SYNTAX Counter32
977 MAX-ACCESS read-only
978 STATUS current
979 DESCRIPTION
980 "The total number of Fibre Channel Address Identifiers
981 granted (for local use, i.e., with a particular switch's
982 Domain_ID) by the Fabric Address Manager on that switch.
983
984 This counter has no discontinuities other than those
985 that all Counter32s have when sysUpTime=0."
986 ::= { t11FamEntry 10 }
987
988 t11FamRecoveredFcIds OBJECT-TYPE
989 SYNTAX Counter32
990 MAX-ACCESS read-only
991 STATUS current
992 DESCRIPTION
993 "The total number of Fibre Channel Address Identifiers that
994 have been recovered by the Fabric Address Manager on a
995 particular switch since the switch has been initialized.
996 A recovered Fibre Channel Address Identifier is one that is
997 explicitly returned after previously being used.
998
999 This counter has no discontinuities other than those
1000 that all Counter32s have when sysUpTime=0."
1001
1002
1003
1004 <span class="grey">DeSanti, et al. Standards Track [Page 18]</span></pre>
1005 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-19" ></span>
1006 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1007
1008
1009 ::= { t11FamEntry 11 }
1010
1011 t11FamFreeFcIds OBJECT-TYPE
1012 SYNTAX Gauge32
1013 MAX-ACCESS read-only
1014 STATUS current
1015 DESCRIPTION
1016 "The number of Fibre Channel Address Identifiers that are
1017 currently unassigned on this Fabric and could be available
1018 for assignment either immediately or at some later time.
1019
1020 The sum of the instances of FreeFcIds and AssignedFcIds
1021 corresponding to a particular Fabric is the total number of
1022 Fibre Channel Address Identifiers that the local Fabric
1023 Address Management is capable of assigning on that Fabric."
1024 ::= { t11FamEntry 12 }
1025
1026 t11FamAssignedFcIds OBJECT-TYPE
1027 SYNTAX Gauge32
1028 MAX-ACCESS read-only
1029 STATUS current
1030 DESCRIPTION
1031 "The number of Fibre Channel Address Identifiers that are
1032 currently assigned on this Fabric.
1033
1034 The sum of the instances of FreeFcIds and AssignedFcIds
1035 corresponding to a particular Fabric is the total number of
1036 Fibre Channel Address Identifiers that the local Fabric
1037 Address Management is capable of assigning on that Fabric."
1038 ::= { t11FamEntry 13 }
1039
1040 t11FamAvailableFcIds OBJECT-TYPE
1041 SYNTAX Gauge32
1042 MAX-ACCESS read-only
1043 STATUS current
1044 DESCRIPTION
1045 "The number of Fibre Channel Address Identifiers that are
1046 unassigned and currently available for immediate assignment
1047 on the Fabric, e.g., with the 'Clean Address' bit set to 1."
1048 REFERENCE
1049 "Fibre Channel - Framing and Signaling (FC-FS),
1050 ANSI INCITS 373-2003, <a href="#section-15.6.2.4.2">section 15.6.2.4.2</a>."
1051 ::= { t11FamEntry 14 }
1052
1053 t11FamRunningPriority OBJECT-TYPE
1054 SYNTAX T11FamDomainPriority
1055 MAX-ACCESS read-only
1056 STATUS current
1057
1058
1059
1060 <span class="grey">DeSanti, et al. Standards Track [Page 19]</span></pre>
1061 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-20" ></span>
1062 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1063
1064
1065 DESCRIPTION
1066 "The running priority of a particular switch on this Fabric.
1067 This value is initialized to the value of t11FamPriority,
1068 and subsequently altered as specified by the procedures
1069 defined in FC-SW-3."
1070 ::= { t11FamEntry 15 }
1071
1072 t11FamPrincSwRunningPriority OBJECT-TYPE
1073 SYNTAX T11FamDomainPriority
1074 MAX-ACCESS read-only
1075 STATUS current
1076 DESCRIPTION
1077 "The running priority of the Principal Switch on this
1078 Fabric."
1079 ::= { t11FamEntry 16 }
1080
1081 t11FamState OBJECT-TYPE
1082 SYNTAX T11FamState
1083 MAX-ACCESS read-only
1084 STATUS current
1085 DESCRIPTION
1086 "The state of the Fabric Address Manager on a particular
1087 switch on this Fabric."
1088 ::= { t11FamEntry 17 }
1089
1090 t11FamLocalPrincipalSwitchSlctns OBJECT-TYPE
1091 SYNTAX Counter32
1092 MAX-ACCESS read-only
1093 STATUS current
1094 DESCRIPTION
1095 "The number of times a particular switch became the
1096 Principal Switch on this Fabric.
1097
1098 This counter has no discontinuities other than those
1099 that all Counter32s have when sysUpTime=0."
1100 ::= { t11FamEntry 18 }
1101
1102 t11FamPrincipalSwitchSelections OBJECT-TYPE
1103 SYNTAX Counter32
1104 MAX-ACCESS read-only
1105 STATUS current
1106 DESCRIPTION
1107 "The number of Principal Switch selections on this Fabric.
1108
1109 This counter has no discontinuities other than those
1110 that all Counter32s have when sysUpTime=0."
1111 ::= { t11FamEntry 19 }
1112
1113
1114
1115
1116 <span class="grey">DeSanti, et al. Standards Track [Page 20]</span></pre>
1117 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-21" ></span>
1118 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1119
1120
1121 t11FamBuildFabrics OBJECT-TYPE
1122 SYNTAX Counter32
1123 MAX-ACCESS read-only
1124 STATUS current
1125 DESCRIPTION
1126 "The number of non-disruptive fabric reconfigurations (BFs)
1127 that have occurred on this Fabric.
1128
1129 This counter has no discontinuities other than those
1130 that all Counter32s have when sysUpTime=0."
1131 ::= { t11FamEntry 20 }
1132
1133 t11FamFabricReconfigures OBJECT-TYPE
1134 SYNTAX Counter32
1135 MAX-ACCESS read-only
1136 STATUS current
1137 DESCRIPTION
1138 "The number of disruptive fabric reconfigurations (RCFs)
1139 that have occurred on this Fabric.
1140
1141 This counter has no discontinuities other than those
1142 that all Counter32s have when sysUpTime=0."
1143 ::= { t11FamEntry 21 }
1144
1145 t11FamDomainId OBJECT-TYPE
1146 SYNTAX FcDomainIdOrZero
1147 MAX-ACCESS read-only
1148 STATUS current
1149 DESCRIPTION
1150 "The Domain_ID of a particular switch on this Fabric or
1151 zero if no Domain_ID has been assigned."
1152 ::= { t11FamEntry 22 }
1153
1154 t11FamSticky OBJECT-TYPE
1155 SYNTAX TruthValue
1156 MAX-ACCESS read-only
1157 STATUS current
1158 DESCRIPTION
1159 "An indication of whether a particular switch is supporting
1160 the concept of Preferred Domain_IDs via a best-effort
1161 attempt to re-assign the same Fibre Channel Address
1162 Identifier value to a port on the next occasion when a port
1163 requests an assignment on this Fabric.
1164
1165 If the value of this object is 'true', then the switch is
1166 maintaining rows in the t11FamFcIdCacheTable for this
1167 Fabric."
1168 ::= { t11FamEntry 23 }
1169
1170
1171
1172 <span class="grey">DeSanti, et al. Standards Track [Page 21]</span></pre>
1173 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-22" ></span>
1174 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1175
1176
1177 t11FamRestart OBJECT-TYPE
1178 SYNTAX INTEGER {
1179 nonDisruptive(1),
1180 disruptive(2),
1181 noOp(3)
1182 }
1183 MAX-ACCESS read-write
1184 STATUS current
1185 DESCRIPTION
1186 "This object tells the Fabric Address Manager to
1187 request a Fabric reconfiguration.
1188
1189 If this object is set to 'disruptive', then an RCF
1190 (ReConfigure Fabric) is generated in the Fabric
1191 in order for the Fabric to recover from the errors.
1192
1193 If this object is set to 'nonDisruptive', then a
1194 BF (Build Fabric) is generated in the Fabric.
1195
1196 No action is taken if this object is set to 'noOp'.
1197 The value of the object when read is always 'noOp'.
1198
1199 For the persistence of values across reboots, see the
1200 MODULE-IDENTITY's DESCRIPTION clause."
1201 REFERENCE "Fibre Channel - Switch Fabric - 3 (FC-SW-3),
1202 ANSI INCITS 384-2004, <a href="#section-7.3">section 7.3</a>."
1203 ::= { t11FamEntry 24 }
1204
1205 t11FamRcFabricNotifyEnable OBJECT-TYPE
1206 SYNTAX TruthValue
1207 MAX-ACCESS read-write
1208 STATUS current
1209 DESCRIPTION
1210 "An indication of whether or not a particular switch
1211 should issue a t11FamFabricChangeNotify notification on
1212 sending or receiving ReConfigureFabric (RCF) on a Fabric.
1213
1214 If the value of the object is 'true', then the
1215 notification is generated. If the value is 'false',
1216 notification is not generated.
1217
1218 If an implementation requires all Fabrics to have the
1219 same value, then setting one instance of this object
1220 to a new object will result in all corresponding
1221 instances being set to that same new value.
1222
1223 For the persistence of values across reboots, see the
1224 MODULE-IDENTITY's DESCRIPTION clause."
1225
1226
1227
1228 <span class="grey">DeSanti, et al. Standards Track [Page 22]</span></pre>
1229 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-23" ></span>
1230 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1231
1232
1233 DEFVAL { false }
1234 ::= { t11FamEntry 25 }
1235
1236 t11FamEnable OBJECT-TYPE
1237 SYNTAX TruthValue
1238 MAX-ACCESS read-write
1239 STATUS current
1240 DESCRIPTION
1241 "Enables the Fabric Address Manager on this switch
1242 on this Fabric.
1243
1244 If enabled on a Fabric, the switch will participate in
1245 Principal Switch selection, and Domain_IDs are assigned
1246 dynamically. If disabled, the switch will not participate
1247 in Principal Switch selection, and Domain_IDs are
1248 assigned statically. Thus, the corresponding value of
1249 t11FamConfigDomainIdType needs to be 'static'.
1250
1251 For the persistence of values across reboots, see the
1252 MODULE-IDENTITY's DESCRIPTION clause."
1253 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4),
1254 ANSI INCITS 418-2006, sections <a href="#section-7.1">7.1</a> and <a href="#section-7.3">7.3</a>."
1255 DEFVAL { true }
1256 ::= { t11FamEntry 26 }
1257
1258 t11FamFabricName OBJECT-TYPE
1259 SYNTAX FcNameIdOrZero
1260 MAX-ACCESS read-write
1261 STATUS current
1262 DESCRIPTION
1263 "The WWN that is configured on this switch to be used as
1264 the name of this Fabric when the value of t11FamEnable is
1265 'false'.
1266
1267 If the value of t11FamEnable is 'true', this value is not
1268 used.
1269
1270 Fibre Channel requires that:
1271 a) all switches in an operational Fabric be
1272 configured with the same Fabric name; and
1273 b) each Fabric have a unique Fabric name.
1274 If either of these is violated, either by switches within a
1275 single Fabric being configured with different Fabric names,
1276 or by multiple Fabrics that share management applications
1277 or interact in other ways having the same Fabric name,
1278 then the behavior of the switches and associated management
1279 functions is not specified by Fibre Channel or Internet
1280 standards.
1281
1282
1283
1284 <span class="grey">DeSanti, et al. Standards Track [Page 23]</span></pre>
1285 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-24" ></span>
1286 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1287
1288
1289 For the persistence of values across reboots, see the
1290 MODULE-IDENTITY's DESCRIPTION clause."
1291 REFERENCE "Fibre Channel - Switch Fabric - 4 (FC-SW-4),
1292 ANSI INCITS 418-2006, <a href="#section-7.1">section 7.1</a>."
1293 ::= { t11FamEntry 27 }
1294
1295
1296 --
1297 -- t11FamIfTable - Interface configuration
1298 --
1299
1300 t11FamIfTable OBJECT-TYPE
1301 SYNTAX SEQUENCE OF T11FamIfEntry
1302 MAX-ACCESS not-accessible
1303 STATUS current
1304 DESCRIPTION
1305 "This table contains those Fabric Address Manager parameters
1306 and status values that are per-interface (identified
1307 by an ifIndex value), per-Fabric (identified by a
1308 t11FamFabricIndex value), and per-switch (identified by
1309 values of fcmInstanceIndex and fcmSwitchIndex).
1310
1311 An entry in this table is automatically created when
1312 an E_Port becomes non-isolated on a particular Fabric.
1313
1314 An entry is deleted automatically from this table if:
1315 a) the corresponding interface is no longer an E_Port (e.g.,
1316 a G_Port that is dynamically determined to be an F_Port),
1317 and all configuration parameter(s) have default values; or
1318 b) the interface identified by ifIndex no longer exists
1319 (e.g., because a line-card is physically removed); or
1320 c) the row in the t11FamTable corresponding the fabric
1321 identified by t11FamFabricID no longer exists.
1322
1323 Creating an entry in this table via t11FamIfRowStatus
1324 provides the means to specify non-default parameter value(s)
1325 for an interface at a time when the relevant row in this
1326 table does not exist, i.e., because the interface is either
1327 down or it is not an E_Port."
1328 ::= { t11FamConfiguration 2 }
1329
1330 t11FamIfEntry OBJECT-TYPE
1331 SYNTAX T11FamIfEntry
1332 MAX-ACCESS not-accessible
1333 STATUS current
1334 DESCRIPTION
1335 "An entry containing information on the interface
1336 configuration on the Fabric identified by
1337
1338
1339
1340 <span class="grey">DeSanti, et al. Standards Track [Page 24]</span></pre>
1341 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-25" ></span>
1342 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1343
1344
1345 t11FamFabricIndex."
1346 INDEX { fcmInstanceIndex, fcmSwitchIndex,
1347 t11FamFabricIndex, ifIndex}
1348 ::= { t11FamIfTable 1 }
1349
1350 T11FamIfEntry ::= SEQUENCE {
1351 t11FamIfRcfReject TruthValue,
1352 t11FamIfRole T11FamDomainInterfaceRole,
1353 t11FamIfRowStatus RowStatus
1354 }
1355
1356 t11FamIfRcfReject OBJECT-TYPE
1357 SYNTAX TruthValue
1358 MAX-ACCESS read-create
1359 STATUS current
1360 DESCRIPTION
1361 "This object determines if the incoming ReConfigure
1362 Fabric (RCF) messages on this interface on this
1363 Fabric is accepted or not. If this object is 'true', then
1364 the incoming RCF is rejected. If 'false', incoming RCF is
1365 accepted.
1366
1367 Note that this object does not apply to the outgoing
1368 RCFs generated by this interface.
1369
1370 Implementations that support write-access to this object
1371 can do so under whatever conditions they choose."
1372 DEFVAL {false}
1373 ::= { t11FamIfEntry 1 }
1374
1375 t11FamIfRole OBJECT-TYPE
1376 SYNTAX T11FamDomainInterfaceRole
1377 MAX-ACCESS read-only
1378 STATUS current
1379 DESCRIPTION
1380 "The role of this interface."
1381 ::= { t11FamIfEntry 2 }
1382
1383 t11FamIfRowStatus OBJECT-TYPE
1384 SYNTAX RowStatus
1385 MAX-ACCESS read-create
1386 STATUS current
1387 DESCRIPTION
1388 "The status of this row."
1389 ::= { t11FamIfEntry 3 }
1390
1391
1392 --
1393
1394
1395
1396 <span class="grey">DeSanti, et al. Standards Track [Page 25]</span></pre>
1397 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-26" ></span>
1398 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1399
1400
1401 -- t11FamAreaTable
1402 --
1403
1404 t11FamAreaTable OBJECT-TYPE
1405 SYNTAX SEQUENCE OF T11FamAreaEntry
1406 MAX-ACCESS not-accessible
1407 STATUS current
1408 DESCRIPTION
1409 "This table contains area assignments per-Fabric by a
1410 switch's Fabric Address Manager. Each octet in
1411 t11FamAssignedAreaList is able to be used to index into
1412 this table to find information on each area."
1413 REFERENCE "Fibre Channel - Switch Fabric - 3 (FC-SW-3),
1414 ANSI INCITS 384-2004, <a href="#section-4.8">section 4.8</a>."
1415 ::= { t11FamInfo 1 }
1416
1417 t11FamAreaEntry OBJECT-TYPE
1418 SYNTAX T11FamAreaEntry
1419 MAX-ACCESS not-accessible
1420 STATUS current
1421 DESCRIPTION
1422 "An entry gives information on the Area_ID and all
1423 Port_IDs that have been assigned within an area for
1424 the Fabric identified by t11FamFabricIndex, by the
1425 Fabric Address Manager in the switch identified by
1426 fcmInstanceIndex and fcmSwitchIndex."
1427 INDEX { fcmInstanceIndex, fcmSwitchIndex,
1428 t11FamFabricIndex, t11FamAreaAreaId}
1429 ::= { t11FamAreaTable 1 }
1430
1431 T11FamAreaEntry ::= SEQUENCE {
1432 t11FamAreaAreaId Unsigned32,
1433 t11FamAreaAssignedPortIdList OCTET STRING
1434 }
1435
1436 t11FamAreaAreaId OBJECT-TYPE
1437 SYNTAX Unsigned32 (0..255)
1438 MAX-ACCESS not-accessible
1439 STATUS current
1440 DESCRIPTION
1441 "The Area_ID of this area."
1442 ::= { t11FamAreaEntry 1 }
1443
1444 t11FamAreaAssignedPortIdList OBJECT-TYPE
1445 SYNTAX OCTET STRING (SIZE(0..256))
1446 MAX-ACCESS read-only
1447 STATUS current
1448 DESCRIPTION
1449
1450
1451
1452 <span class="grey">DeSanti, et al. Standards Track [Page 26]</span></pre>
1453 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-27" ></span>
1454 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1455
1456
1457 "The list of Port_IDs which have been assigned in
1458 this area and Fabric, formatted as an array of
1459 octets in ascending order. There could be zero or more
1460 Port_IDs assigned on this area and Fabric.
1461
1462 Each octet represents one Port_ID. So, the list containing
1463 the Port_IDs 23, 45, 235, and 56 would be formatted as the
1464 4-octet string x'172d38eb'."
1465 ::= { t11FamAreaEntry 2 }
1466
1467
1468 --
1469 -- t11FamDatabaseTable
1470 --
1471
1472 t11FamDatabaseTable OBJECT-TYPE
1473 SYNTAX SEQUENCE OF T11FamDatabaseEntry
1474 MAX-ACCESS not-accessible
1475 STATUS current
1476 DESCRIPTION
1477 "This table contains all information known by
1478 a switch about all the domains that have been
1479 assigned in each Fabric."
1480 REFERENCE "Fibre Channel - Switch Fabric - 3 (FC-SW-3),
1481 ANSI INCITS 384-2004, <a href="#section-4.8">section 4.8</a>."
1482 ::= { t11FamInfo 2 }
1483
1484 t11FamDatabaseEntry OBJECT-TYPE
1485 SYNTAX T11FamDatabaseEntry
1486 MAX-ACCESS not-accessible
1487 STATUS current
1488 DESCRIPTION
1489 "An entry (conceptual row) in the t11FamDatabaseTable
1490 containing information about one Domain_ID in the
1491 Fabric identified by t11FamFabricIndex, and known by
1492 the switch identified by t11FamFabricIndex and
1493 t11FamDatabaseDomainId."
1494 INDEX { fcmInstanceIndex, fcmSwitchIndex,
1495 t11FamFabricIndex , t11FamDatabaseDomainId}
1496 ::= { t11FamDatabaseTable 1 }
1497
1498 T11FamDatabaseEntry ::= SEQUENCE {
1499 t11FamDatabaseDomainId FcDomainIdOrZero,
1500 t11FamDatabaseSwitchWwn FcNameIdOrZero
1501 }
1502
1503 t11FamDatabaseDomainId OBJECT-TYPE
1504 SYNTAX FcDomainIdOrZero (1..239)
1505
1506
1507
1508 <span class="grey">DeSanti, et al. Standards Track [Page 27]</span></pre>
1509 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-28" ></span>
1510 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1511
1512
1513 MAX-ACCESS not-accessible
1514 STATUS current
1515 DESCRIPTION
1516 "The Domain_ID for which this row contains information.
1517 The value must be non-zero."
1518 ::= { t11FamDatabaseEntry 1 }
1519
1520 t11FamDatabaseSwitchWwn OBJECT-TYPE
1521 SYNTAX FcNameIdOrZero
1522 MAX-ACCESS read-only
1523 STATUS current
1524 DESCRIPTION
1525 "The node name (WWN) of the switch to which the
1526 corresponding value of t11FamDatabaseDomainId is currently
1527 assigned for the particular Fabric."
1528 ::= { t11FamDatabaseEntry 2 }
1529
1530
1531 --
1532 -- Fibre Channel Address Identifier cache information
1533 --
1534 -- The cached information allows the Fabric Address Manager to
1535 -- implement the concept of a Preferred Domain_ID, whereby after a port
1536 -- releases a Fibre Channel Address Identifier value, a switch makes an
1537 -- attempt to re-assign the same Fibre Channel Address Identifier value
1538 -- on the next occasion when that port requests an assignment.
1539 --
1540
1541 t11FamMaxFcIdCacheSize OBJECT-TYPE
1542 SYNTAX Unsigned32 (0..4294967295)
1543 MAX-ACCESS read-only
1544 STATUS current
1545 DESCRIPTION
1546 "The maximum number of Fibre Channel Address Identifiers
1547 that are able to be cached in the t11FamFcIdCacheTable.
1548 If the number is unknown, the value of this object is
1549 zero."
1550 ::= { t11FamInfo 3 }
1551
1552
1553 --
1554 -- t11FamFcIdCacheTable
1555 --
1556
1557 t11FamFcIdCacheTable OBJECT-TYPE
1558 SYNTAX SEQUENCE OF T11FamFcIdCacheEntry
1559 MAX-ACCESS not-accessible
1560 STATUS current
1561
1562
1563
1564 <span class="grey">DeSanti, et al. Standards Track [Page 28]</span></pre>
1565 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-29" ></span>
1566 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1567
1568
1569 DESCRIPTION
1570 "This table contains all the Fibre Channel Address
1571 Identifiers that have recently been released by the
1572 Fabric Address Manager in a switch. So, it lists
1573 all the Fibre Channel Address Identifiers that have valid
1574 WWN-to-Fibre Channel Address Identifier mappings and are
1575 currently not assigned to any ports. These Fibre Channel
1576 Address Identifiers were assigned to ports but have since
1577 been released. These cached Fibre Channel Address
1578 Identifiers contain only Area_ID and Port_ID information.
1579 This cache is kept to provide best-effort re-assignment of
1580 same Fibre Channel Address Identifiers; i.e., when an
1581 Nx_Port asks for a Fibre Channel Address Identifier, soon
1582 after releasing one, the same value is re-assigned, if
1583 possible."
1584 ::= { t11FamInfo 4 }
1585
1586 t11FamFcIdCacheEntry OBJECT-TYPE
1587 SYNTAX T11FamFcIdCacheEntry
1588 MAX-ACCESS not-accessible
1589 STATUS current
1590 DESCRIPTION
1591 "An entry (conceptual row) in the t11FamFcIdCacheTable
1592 containing information about one Fibre Channel Address
1593 Identifier that was released from a WWN, corresponding to a
1594 range of one or more ports connected to the switch
1595 (identified by t11FamFabricIndex and t11FamFcIdCacheWwn) in
1596 the Fabric (identified by t11FamFabricIndex). An entry is
1597 created when a Fibre Channel Address Identifier is released
1598 by the last port in the range. The oldest entry is deleted
1599 if the number of rows in this table reaches
1600 t11FamMaxFcIdCacheSize, and its space is required for a new
1601 entry. An entry is also deleted when its Fibre Channel
1602 Address Identifier is assigned to a port."
1603 INDEX { fcmInstanceIndex, fcmSwitchIndex,
1604 t11FamFabricIndex, t11FamFcIdCacheWwn}
1605 ::= { t11FamFcIdCacheTable 1 }
1606
1607 T11FamFcIdCacheEntry ::= SEQUENCE {
1608 t11FamFcIdCacheWwn FcNameIdOrZero,
1609 t11FamFcIdCacheAreaIdPortId OCTET STRING,
1610 t11FamFcIdCachePortIds Unsigned32
1611 }
1612
1613 t11FamFcIdCacheWwn OBJECT-TYPE
1614 SYNTAX FcNameIdOrZero
1615 MAX-ACCESS not-accessible
1616 STATUS current
1617
1618
1619
1620 <span class="grey">DeSanti, et al. Standards Track [Page 29]</span></pre>
1621 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-30" ></span>
1622 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1623
1624
1625 DESCRIPTION
1626 "The N_Port_Name (WWN) of the port associated with this
1627 entry."
1628 ::= { t11FamFcIdCacheEntry 1 }
1629
1630 t11FamFcIdCacheAreaIdPortId OBJECT-TYPE
1631 SYNTAX OCTET STRING (SIZE (2))
1632 MAX-ACCESS read-only
1633 STATUS current
1634 DESCRIPTION
1635 "The combination of this object and t11FamFcIdCachePortIds
1636 represent one range of Fibre Channel Address Identifiers,
1637 which were assigned and later released. This object
1638 contains the Area_ID and Port_ID of the first Fibre
1639 Channel Address Identifier in the range.
1640
1641 Note that this object is only 2 bytes."
1642 ::= { t11FamFcIdCacheEntry 2 }
1643
1644 t11FamFcIdCachePortIds OBJECT-TYPE
1645 SYNTAX Unsigned32 (0..65535)
1646 MAX-ACCESS read-only
1647 STATUS current
1648 DESCRIPTION
1649 "The combination of t11FamFcIdCacheAreaIdPortId and this
1650 object represent one range of Fibre Channel Address
1651 Identifiers, which were assigned and later released. This
1652 object contains the number of (consecutive) Fibre Channel
1653 Address Identifiers in the range."
1654 ::= { t11FamFcIdCacheEntry 3 }
1655
1656
1657 -- Objects for use in notifications
1658
1659 t11FamNotifyFabricIndex OBJECT-TYPE
1660 SYNTAX T11FabricIndex
1661 MAX-ACCESS accessible-for-notify
1662 STATUS current
1663 DESCRIPTION
1664 "A unique index value that identifies a particular
1665 Fabric for which a particular notification is generated.
1666
1667 In a Fabric conformant to SW-3, only a single Fabric
1668 can operate within a physical infrastructure, and thus,
1669 the value of this Fabric Index will always be 1.
1670
1671 However, the current standard, FC-SW-4, defines
1672 how multiple Fabrics, each with its own management
1673
1674
1675
1676 <span class="grey">DeSanti, et al. Standards Track [Page 30]</span></pre>
1677 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-31" ></span>
1678 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1679
1680
1681 instrumentation, could operate within one (or more)
1682 physical infrastructures. In order to accommodate this
1683 scenario, this index value is used to uniquely identify a
1684 particular Fabric within a physical infrastructure."
1685 ::= { t11FamNotifyControl 1 }
1686
1687
1688 -- Notifications
1689
1690 t11FamDomainIdNotAssignedNotify NOTIFICATION-TYPE
1691 OBJECTS { t11FamLocalSwitchWwn, t11FamNotifyFabricIndex }
1692 STATUS current
1693 DESCRIPTION
1694 "This notification indicates that a Domain_ID has not
1695 been configured or assigned for a particular Fabric,
1696 identified by t11FamNotifyFabricIndex, on a particular
1697 switch identified by t11FamLocalSwitchWwn. This could
1698 happen under the following conditions, and results in the
1699 switch isolating E_Ports on the Fabric:
1700
1701 - if the switch's request for a configured static
1702 Domain_ID is rejected or no other Domain_ID is
1703 assigned, then the E_Ports are isolated."
1704 ::= { t11FamNotifications 1 }
1705
1706 t11FamNewPrincipalSwitchNotify NOTIFICATION-TYPE
1707 OBJECTS { t11FamLocalSwitchWwn, t11FamNotifyFabricIndex }
1708 STATUS current
1709 DESCRIPTION
1710 "This notification indicates that a particular switch,
1711 identified by t11FamLocalSwitchWwn, has become the new
1712 Principal Switch on the Fabric identified by
1713 t11FamNotifyFabricIndex.
1714
1715 This notification is sent soon after its election as
1716 the new Principal Switch, i.e., upon expiration of a
1717 Principal Switch selection timer that is equal to
1718 twice the Fabric Stability Timeout value (F_S_TOV)."
1719 ::= { t11FamNotifications 2 }
1720
1721 t11FamFabricChangeNotify NOTIFICATION-TYPE
1722 OBJECTS { t11FamLocalSwitchWwn, t11FamNotifyFabricIndex }
1723 STATUS current
1724 DESCRIPTION
1725 "This notification is sent whenever a particular switch,
1726 identified by t11FamLocalSwitchWwn, sends or
1727 receives a Build Fabric (BF) or a ReConfigure Fabric
1728 (RCF) message on the Fabric identified by
1729
1730
1731
1732 <span class="grey">DeSanti, et al. Standards Track [Page 31]</span></pre>
1733 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-32" ></span>
1734 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1735
1736
1737 t11FamNotifyFabricIndex.
1738
1739 This notification is not sent if a
1740 't11FamNewPrincipalSwitchNotify' notification is sent
1741 for the same event."
1742 ::= { t11FamNotifications 3 }
1743
1744
1745 --
1746 -- Conformance
1747 --
1748
1749 t11FamMIBCompliances OBJECT IDENTIFIER ::= { t11FamMIBConformance 1 }
1750 t11FamMIBGroups OBJECT IDENTIFIER ::= { t11FamMIBConformance 2 }
1751
1752 t11FamMIBCompliance MODULE-COMPLIANCE
1753 STATUS current
1754 DESCRIPTION
1755 "The compliance statement for Fibre Channel switches
1756 that implement Fabric Address Manager functionality."
1757 MODULE
1758 MANDATORY-GROUPS { t11FamGroup,
1759 t11FamDatabaseGroup,
1760 t11FamAreaGroup,
1761 t11FamNotificationGroup
1762 }
1763
1764 OBJECT t11FamConfigDomainId
1765 MIN-ACCESS read-only
1766 DESCRIPTION
1767 "Write access is not required."
1768
1769 OBJECT t11FamConfigDomainIdType
1770 MIN-ACCESS read-only
1771 DESCRIPTION
1772 "Write access is not required."
1773
1774 OBJECT t11FamAutoReconfigure
1775 MIN-ACCESS read-only
1776 DESCRIPTION
1777 "Write access is not required."
1778
1779 OBJECT t11FamContiguousAllocation
1780 MIN-ACCESS read-only
1781 DESCRIPTION
1782 "Write access is not required."
1783
1784 OBJECT t11FamPriority
1785
1786
1787
1788 <span class="grey">DeSanti, et al. Standards Track [Page 32]</span></pre>
1789 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-33" ></span>
1790 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1791
1792
1793 MIN-ACCESS read-only
1794 DESCRIPTION
1795 "Write access is not required."
1796
1797 OBJECT t11FamIfRcfReject
1798 MIN-ACCESS read-only
1799 DESCRIPTION
1800 "Write access is not required."
1801
1802 OBJECT t11FamIfRowStatus
1803 MIN-ACCESS read-only
1804 DESCRIPTION
1805 "Write access is not required."
1806
1807 OBJECT t11FamRcFabricNotifyEnable
1808 MIN-ACCESS read-only
1809 DESCRIPTION
1810 "Write access is not required."
1811
1812 GROUP t11FamCacheGroup
1813 DESCRIPTION
1814 "This group is mandatory only for switches that
1815 support the concept of Preferred Domain_ID via a best-
1816 effort attempt for (short-term) re-assignment of the
1817 same FC address identifiers."
1818
1819 GROUP t11FamCommandGroup
1820 DESCRIPTION
1821 "This group is optional."
1822
1823 ::= { t11FamMIBCompliances 1 }
1824
1825
1826 -- Units of Conformance
1827
1828 t11FamGroup OBJECT-GROUP
1829 OBJECTS { t11FamConfigDomainId,
1830 t11FamConfigDomainIdType,
1831 t11FamAutoReconfigure,
1832 t11FamContiguousAllocation,
1833 t11FamPriority,
1834 t11FamPrincipalSwitchWwn,
1835 t11FamLocalSwitchWwn,
1836 t11FamAssignedAreaIdList,
1837 t11FamGrantedFcIds,
1838 t11FamRecoveredFcIds,
1839 t11FamFreeFcIds,
1840 t11FamAssignedFcIds,
1841
1842
1843
1844 <span class="grey">DeSanti, et al. Standards Track [Page 33]</span></pre>
1845 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-34" ></span>
1846 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1847
1848
1849 t11FamAvailableFcIds,
1850 t11FamRunningPriority,
1851 t11FamPrincSwRunningPriority,
1852 t11FamState,
1853 t11FamLocalPrincipalSwitchSlctns,
1854 t11FamPrincipalSwitchSelections,
1855 t11FamBuildFabrics,
1856 t11FamFabricReconfigures,
1857 t11FamDomainId,
1858 t11FamSticky,
1859 t11FamRestart,
1860 t11FamRcFabricNotifyEnable,
1861 t11FamEnable,
1862 t11FamFabricName,
1863 t11FamIfRcfReject,
1864 t11FamIfRole,
1865 t11FamIfRowStatus,
1866 t11FamNotifyFabricIndex
1867 }
1868 STATUS current
1869 DESCRIPTION
1870 "A collection of general objects for displaying and
1871 configuring Fabric Address management."
1872 ::= { t11FamMIBGroups 1 }
1873
1874 t11FamCommandGroup OBJECT-GROUP
1875 OBJECTS { t11FamRestart }
1876 STATUS current
1877 DESCRIPTION
1878 "A collection of objects used for initiating an
1879 operation on the Fabric."
1880 ::= { t11FamMIBGroups 2 }
1881
1882 t11FamDatabaseGroup OBJECT-GROUP
1883 OBJECTS { t11FamDatabaseSwitchWwn }
1884 STATUS current
1885 DESCRIPTION
1886 "A collection of objects containing information about
1887 Domain-IDs assignments."
1888 ::= { t11FamMIBGroups 3 }
1889
1890 t11FamAreaGroup OBJECT-GROUP
1891 OBJECTS { t11FamAreaAssignedPortIdList }
1892 STATUS current
1893 DESCRIPTION
1894 "A collection of objects containing information about
1895 currently assigned addresses within a domain."
1896 ::= { t11FamMIBGroups 4 }
1897
1898
1899
1900 <span class="grey">DeSanti, et al. Standards Track [Page 34]</span></pre>
1901 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-35" ></span>
1902 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1903
1904
1905 t11FamCacheGroup OBJECT-GROUP
1906 OBJECTS { t11FamMaxFcIdCacheSize,
1907 t11FamFcIdCacheAreaIdPortId,
1908 t11FamFcIdCachePortIds
1909 }
1910 STATUS current
1911 DESCRIPTION
1912 "A collection of objects containing information about
1913 recently-released Fibre Channel Address Identifiers."
1914 ::= { t11FamMIBGroups 5 }
1915
1916 t11FamNotificationGroup NOTIFICATION-GROUP
1917 NOTIFICATIONS { t11FamDomainIdNotAssignedNotify,
1918 t11FamNewPrincipalSwitchNotify,
1919 t11FamFabricChangeNotify }
1920 STATUS current
1921 DESCRIPTION
1922 "A collection of notifications for status monitoring
1923 and notification."
1924 ::= { t11FamMIBGroups 6 }
1925 END
1926
1927 <span class="h2"><a class="selflink" id="section-7" href="#section-7">7</a>. Acknowledgements</span>
1928
1929 This document began life as a work item of the INCITS Task Group
1930 T11.5. We wish to acknowledge the many contributions and comments
1931 from the INCITS Technical Committee T11, including the following:
1932
1933 T11 Chair: Robert Snively, Brocade
1934 T11 Vice Chair: Claudio DeSanti, Cisco Systems
1935 T11.5 Chair: Roger Cummings, Symantec
1936 T11.5 members, especially:
1937 Ken Hirata, Emulex
1938 Scott Kipp, McData
1939 Michael O'Donnell, McData
1940 Elizabeth G. Rodriguez, Dot Hill
1941 Steven L. Wilson, Brocade
1942
1943 Thanks also to Orly Nicklass of RAD Data Communications, Bert Wijnen
1944 of Lucent, and those members of the IMSS WG who provided review
1945 comments.
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956 <span class="grey">DeSanti, et al. Standards Track [Page 35]</span></pre>
1957 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-36" ></span>
1958 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
1959
1960
1961 <span class="h2"><a class="selflink" id="section-8" href="#section-8">8</a>. Normative References</span>
1962
1963 [<a id="ref-RFC2578">RFC2578</a>] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
1964 "Structure of Management Information Version 2 (SMIv2)",
1965 STD 58, <a href="./rfc2578">RFC 2578</a>, April 1999.
1966
1967 [<a id="ref-RFC2579">RFC2579</a>] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
1968 "Textual Conventions for SMIv2", STD 58, <a href="./rfc2579">RFC 2579</a>, April
1969 1999.
1970
1971 [<a id="ref-RFC2580">RFC2580</a>] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
1972 "Conformance Statements for SMIv2", STD 58, <a href="./rfc2580">RFC 2580</a>,
1973 April 1999.
1974
1975 [<a id="ref-IF-MIB">IF-MIB</a>] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
1976 MIB", <a href="./rfc2863">RFC 2863</a>, June 2000.
1977
1978 [<a id="ref-FC-MGMT">FC-MGMT</a>] McCloghrie, K., "Fibre Channel Management MIB", <a href="./rfc4044">RFC 4044</a>,
1979 May 2005.
1980
1981 [<a id="ref-FC-SW-3">FC-SW-3</a>] "Fibre Channel - Switch Fabric - 3 (FC-SW-3)", ANSI INCITS
1982 384-2004, June 2004.
1983
1984 [<a id="ref-FC-SW-4">FC-SW-4</a>] "Fibre Channel - Switch Fabric - 4 (FC-SW-4)", ANSI INCITS
1985 418-2006, 2006.
1986
1987 [<a id="ref-FC-FS">FC-FS</a>] "Fibre Channel - Framing and Signaling (FC-FS)" ANSI
1988 INCITS 373-2003, April 2003.
1989
1990 <span class="h2"><a class="selflink" id="section-9" href="#section-9">9</a>. Informative References</span>
1991
1992 [<a id="ref-RFC2837">RFC2837</a>] Teow, K., "Definitions of Managed Objects for the Fabric
1993 Element in Fibre Channel Standard", <a href="./rfc2837">RFC 2837</a>, May 2000.
1994
1995 [<a id="ref-RFC3410">RFC3410</a>] Case, J., Mundy, R., Partain, D., and B. Stewart,
1996 "Introduction and Applicability Statements for Internet-
1997 Standard Management Framework", <a href="./rfc3410">RFC 3410</a>, December 2002.
1998
1999 [<a id="ref-FC-MI">FC-MI</a>] "Fibre Channel - Methodologies for Interconnects (FC-MI)",
2000 INCITS TR-30-2002, November 2002.
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012 <span class="grey">DeSanti, et al. Standards Track [Page 36]</span></pre>
2013 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-37" ></span>
2014 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
2015
2016
2017 <span class="h2"><a class="selflink" id="section-10" href="#section-10">10</a>. IANA Considerations</span>
2018
2019 IANA has made two MIB OID assignments, one for the T11-TC-MIB module
2020 and one for the T11-FC-FABRIC-ADDR-MGR-MIB module, under the
2021 appropriate subtree(s).
2022
2023 <span class="h2"><a class="selflink" id="section-11" href="#section-11">11</a>. Security Considerations</span>
2024
2025 There are a number of management objects defined in this MIB module
2026 with a MAX-ACCESS clause of read-write and/or read-create. Such
2027 objects may be considered sensitive or vulnerable in some network
2028 environments. The support for SET operations in a non-secure
2029 environment without proper protection can have a negative effect on
2030 network operations. These are the tables and objects and their
2031 sensitivity/vulnerability:
2032
2033 t11FamConfigDomainId, t11FamConfigDomainIdType and
2034 t11FamContiguousAllocation -- ability to change the address
2035 allocation policy.
2036
2037 t11FamRestart and t11FamAutoReconfigure -- ability to cause a
2038 fabric reconfiguration, e.g., on certain error conditions.
2039
2040 t11FamPriority -- ability to affect which switch becomes the
2041 Principal Switch.
2042
2043 t11FamRcFabricNotifyEnable -- ability to enable/disable a
2044 notification.
2045
2046 t11FamIfRcfReject -- ability to change the switch's behavior on
2047 receipt of an RCF.
2048
2049 t11FamIfRowStatus -- ability to change an interface
2050 configuration parameter.
2051
2052 Some of the readable objects in this MIB module (i.e., objects with a
2053 MAX-ACCESS other than not-accessible) may also be considered
2054 sensitive or vulnerable in some network environments. It is thus
2055 important to control even GET and/or NOTIFY access to these objects
2056 and possibly to even encrypt the values of these objects when sending
2057 them over the network via SNMP. These are the tables and objects and
2058 their sensitivity/vulnerability:
2059
2060 t11FamTable and t11FamIfTable -- contain the configuration,
2061 status, and statistics of the Fabric Address Manager.
2062
2063
2064
2065
2066
2067
2068 <span class="grey">DeSanti, et al. Standards Track [Page 37]</span></pre>
2069 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-38" ></span>
2070 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
2071
2072
2073 t11FamAreaTable, t11FamDatabaseTable and t11FamFcIdCacheTable
2074 -- contain information on currently assigned or recently-
2075 released addresses.
2076
2077 SNMP versions prior to SNMPv3 did not include adequate security.
2078 Even if the network itself is secure (for example by using IPsec),
2079 even then, there is no control as to who on the secure network is
2080 allowed to access and GET/SET (read/change/create/delete) the objects
2081 in this MIB module.
2082
2083 It is RECOMMENDED that implementors consider the security features as
2084 provided by the SNMPv3 framework (see <a href="./rfc3410#section-8">[RFC3410], section&nbsp;8</a>),
2085 including full support for the SNMPv3 cryptographic mechanisms (for
2086 authentication and privacy).
2087
2088 Further, deployment of SNMP versions prior to SNMPv3 is NOT
2089 RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to
2090 enable cryptographic security. It is then a customer/operator
2091 responsibility to ensure that the SNMP entity giving access to an
2092 instance of this MIB module is properly configured to give access to
2093 the objects only to those principals (users) that have legitimate
2094 rights to indeed GET or SET (change/create/delete) them.
2095
2096
2097
2098
2099
2100
2101
2102
2103
2104
2105
2106
2107
2108
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124 <span class="grey">DeSanti, et al. Standards Track [Page 38]</span></pre>
2125 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-39" ></span>
2126 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
2127
2128
2129 Authors' Addresses
2130
2131 Claudio DeSanti
2132 Cisco Systems, Inc.
2133 170 West Tasman Drive
2134 San Jose, CA 95134 USA
2135
2136 Phone: +1 408 853-9172
2137 EMail: [email protected]
2138
2139
2140 Vinay Gaonkar
2141 Cisco Systems, Inc.
2142 170 West Tasman Drive
2143 San Jose, CA 95134 USA
2144
2145 Phone: +1 408 527-8576
2146 EMail: [email protected]
2147
2148
2149 Keith McCloghrie
2150 Cisco Systems, Inc.
2151 170 West Tasman Drive
2152 San Jose, CA USA 95134
2153
2154 Phone: +1 408-526-5260
2155 EMail: [email protected]
2156
2157
2158 Silvano Gai
2159 Retired
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180 <span class="grey">DeSanti, et al. Standards Track [Page 39]</span></pre>
2181 <hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-40" ></span>
2182 <span class="grey"><a href="./rfc4439">RFC 4439</a> Fibre Channel Fabric Address Manager MIB March 2006</span>
2183
2184
2185 Full Copyright Statement
2186
2187 Copyright (C) The Internet Society (2006).
2188
2189 This document is subject to the rights, licenses and restrictions
2190 contained in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a>, and except as set forth therein, the authors
2191 retain all their rights.
2192
2193 This document and the information contained herein are provided on an
2194 "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
2195 OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
2196 ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
2197 INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
2198 INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
2199 WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
2200
2201 Intellectual Property
2202
2203 The IETF takes no position regarding the validity or scope of any
2204 Intellectual Property Rights or other rights that might be claimed to
2205 pertain to the implementation or use of the technology described in
2206 this document or the extent to which any license under such rights
2207 might or might not be available; nor does it represent that it has
2208 made any independent effort to identify any such rights. Information
2209 on the procedures with respect to rights in RFC documents can be
2210 found in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a> and <a href="https://www.rfc-editor.org/bcp/bcp79">BCP 79</a>.
2211
2212 Copies of IPR disclosures made to the IETF Secretariat and any
2213 assurances of licenses to be made available, or the result of an
2214 attempt made to obtain a general license or permission for the use of
2215 such proprietary rights by implementers or users of this
2216 specification can be obtained from the IETF on-line IPR repository at
2217 <a href="http://www.ietf.org/ipr">http://www.ietf.org/ipr</a>.
2218
2219 The IETF invites any interested party to bring to its attention any
2220 copyrights, patents or patent applications, or other proprietary
2221 rights that may cover technology that may be required to implement
2222 this standard. Please address the information to the IETF at
2223 [email protected].
2224
2225 Acknowledgement
2226
2227 Funding for the RFC Editor function is provided by the IETF
2228 Administrative Support Activity (IASA).
2229
2230
2231
2232
2233
2234
2235
2236 DeSanti, et al. Standards Track [Page 40]
2237 </pre>