Professional Documents
Culture Documents
07 January 2016
Document History
DCFM SMI Agent Developers Guide 53-1001361-01 New document March 2010
Brocade Network Advisor SMI Agent 53-1002169-01 Updated to support DCX and DCX-4S May 2011
Developers Guide switches. Updated profiles and
subprofiles to conform to SMI-S 1.5.
Brocade Network Advisor SMI Agent 53-1002534-01 Updated to support Brocade 6505 March 2012
Developers Guide switch, FC8-32E port blade, and FC8-
48E port blade. Updated AG class
diagram and Physical Package, Access
Points, Software, Blades, and Location
subprofiles data model.
Brocade Network Advisor SMI Agent 53-1001701-01 Updated to support Brocade 5430, December 2012
Developers Guide and Brocade 6520. Updated the Fabric
profile. Included enhancements for
SAN_Element.Name and AG class
diagram, included AG Physical
package support, and VF support for
Brocade 7800.
Title Publication number Summary of changes Date
Brocade Network Advisor SMI Agent 53-1002996-01 Updated to support Release 12.1.0. July 2013
Developers Guide
Brocade Network Advisor SMI Agent 53-1003061-01 Updated to support Release 12.2.0. February 2014
Developers Guide
Brocade Network Advisor SMI Agent 53-1003159-01 Updated to support Release 12.3.0 July 2014
Developers Guide
Brocade Network Advisor SMI Agent 53-1003750-01 Updated to support Release 12.4.0 April 2015
Developers Guide
Brocade Network Advisor SMI Agent 53-1003750-02 Updated to support Release 12.4.2 August 2015
Developers Guide
Brocade Network Advisor SMI Agent 53-1003750-03 Updated to support Release 12.4.3 December 2015
Developers Guide
Brocade Network Advisor SMI Agent 53-1004153-01 Updated to support Release 14.0.0 January 2016
Developers Guide
Contents
Chapter 4 Indications
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
Alert indications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
Life-cycle indications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150
In this chapter
How this document is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Supported hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
Whats new in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi
Document conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii
Notice to the reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Additional information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii
Getting technical help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiv
Brocade Network Advisor SMI Agent support . . . . . . . . . . . . . . . . . . . . . . . . xiv
Document feedback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv
The procedures or parts of procedures documented here apply to some switches but not to others;
this guide identifies exactly which switches are supported and which are not.
Although many different software and hardware configurations are tested and supported by
Brocade Communications Systems, Inc. for Brocade Network Advisor SMI Agent 14.0.0,
documenting all possible configurations and scenarios is beyond the scope of this document.
Document conventions
This section describes text formatting conventions and important notice formats used in this
document.
Text formatting
The narrative-text formatting conventions that are used in this document are as follows:
bold text Identifies command names
Identifies the names of user-manipulated GUI elements
Identifies keyword
Identifies text to enter at the GUI or CLI
italic text Provides emphasis
Identifies variables
Identifies paths and Internet addresses
Identifies document titles
code text Identifies CLI output
Identifies command syntax examples
For readability, command names in the narrative portions of this guide are presented in mixed
lettercase: for example, switchShow. In actual examples, command lettercase is all lowercase.
NOTE
A note provides a tip, guidance, or advice, emphasizes important information, or provides a
reference to related information.
ATTENTION
An Attention statement indicates potential damage to hardware or data.
Additional information
This section lists additional Brocade and industry-specific documentation that you might find
helpful.
Brocade resources
To get up-to-the-minute information, go to http://my.brocade.com to register at no cost for a user ID
and password.
White papers, online demonstrations, and data sheets are available through the Brocade website
at:
http://www.brocade.com/products-solutions/products/index.page
For additional Brocade documentation, visit the Brocade website:
http://www.brocade.com
Release notes are available on the MyBrocade website.
' "!&'
FT00X0054E9
Document feedback
Quality is our first concern at Brocade and we have made every effort to ensure the accuracy and
completeness of this document. However, if you find an error or an omission, or you think that a
topic needs further development, we want to hear from you. Forward your feedback to:
documentation@brocade.com
Provide the title and version number of the document and as much detail as possible about your
comment, including the topic heading and page number and your suggestions for improvement.
In this chapter
Role-Based Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Admin Domains and Brocade Network Advisor SMI Agent. . . . . . . . . . . . . . . 2
Connecting to the Brocade Network Advisor SMI Agent . . . . . . . . . . . . . . . . . 2
Discovering a fabric and a host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
NOTE
The existing mutual authentication certificate is retained while migrating to Network Advisor 12.4.2
from any previous versions. The user has to manually generate and import the mutual
authentication certificate using SMIA configuration tool, in case the default certificate is used.
Features supported
The following features are supported by the CIMOM fabric discovery:
Option to discover all types of Storage Area Network (SAN) fabrics supported by the Brocade
Network Advisor.
Option to edit the switch credentials and the SNMP configurations used to discover the fabric
after the fabric is discovered.
Option to delete a fabric based on the fabric CIM Object Path (COP).
If the discovery of one of the Virtual Fabric (VF) fails, the return parameter is set to
PARTIALLY_DISCOVERED and the out parameter contains the Fabric Identifier (FID) and the
error code of the fabric that failed to get discovered.
Limitations
The following are the limitations of the CIMOM fabric discovery:
All the contexts are discovered by default in the VF. The user cannot select the contexts to be
discovered, but can delete the unwanted contexts through the DeleteFabric extrinsic method.
No support for Monitor and un-monitor operations.
No provision to change the Seed switch.
No support to discover M model switches.
Data model
The Brocade_Fabric has two new additional properties, SeedSwitchWWN and SeedSwitchIP.
The connection setting of each switch is associated to the discovery service.
Every switch in the discovered fabric is represented with an instance of
Brocade_SwitchConnectionSettings. This instance gives the data to be provided in the discover
Fabric dialog box of the Brocade Network Advisor client, such as switch status, user ID, and so
on.
The discovery service is hosted on the management server.
Figure 1 shows the data model of the fabric discovery through the SMIA extrinsic method.
Features supported
The following features are supported by the CIMOM host discovery process:
Option to discover all types of hosts supported by Brocade Network Advisor.
Option to delete a host based on the HostDiscovered COP provided.
Option to receive the status of the host discovery information maintained in the
Brocade_HostDiscovered class.
Option to receive the status of discovery or deletion requests on execution of the DiscoverHost
and DeleteHost methods.
Limitations
The following are the limitations of the CIMOM host discovery process:
Supports only direct discovering of the host either through its IP address or its name, but does
not support for discovery from fabric or Virtual Machine (VM) Manager.
Editing the host discovery information through the CIMOM is not supported.
The history of the deleted host is not maintained in the CIMOM.
Data model
The Brocade_HostDiscovered class gives the discovery information of each host associated to
the Discovery service.
The discovery service is hosted on the management server.
Figure 2 shows the data model of the host discovery through the SMIA extrinsic method.
Figure 4 shows the host discovery through the SMIA Configuration Tool.
For more information related to fabric and host discovery, refer to the Brocade Network Advisor
User Manual.
In this chapter
Brocade Managed Object Format files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Additional MOF description specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . 10
NOTE
The Brocade subclasses do not automatically override all of the properties in the superclass. The
properties that are not overridden have a null value unless the superclass has a default value that
is defined in the MOF.
When the property in the MOF is defined to be of type sint16, then the equivalent Java type is
java.lang.Short.
If instances of a class can only be created, the following line is included in the Description qualifier:
Instances of this class can be created by a client
If instances of a class can only be deleted, the following line is included in the Description qualifier:
Instances of this class can be deleted by a client
For example:
[Provider("java:com.brocade.api.cim.provider.zoning.Brocade_ZoneSetProvider"),
Description (
"Brocade_ZoneSet is a container of zones.\n\n"
"Instances of this class can be deleted by a client.")]
class Brocade_ZoneSet: CIM_ZoneSet {
Deprecation qualifier
Instance classes, association classes, properties, or extrinsic methods that have the Common
Information Model (CIM) qualifier deprecated in the MOF definition will continue to be implemented
in the Brocade Network Advisor SMI Agent. If a new implementation is documented, you should use
the new implementation as soon as possible to minimize backward-compatibility issues.
In this chapter
UML diagram conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
SMI profiles and subprofiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Server profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Fabric profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Switch profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
CP blades (Brocade extension). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
FC HBA profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Launch In Context profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
CEE switch support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Fabric switch partitioning subprofile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
FC routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Brocade Access Gateway and NPIV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
FRU profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Server profile
The Server profile is supported by the Web-Based Enterprise Management (WBEM) Solutions J
WBEM Server CIMOM. The Brocade Network Advisor SMI Agent is a combination of two products,
the CIMOM and the provider product. Each product supports its software as shown in Figure 6.
NOTE
The Brocade Network Advisor SMI Agent's J WBEM Server has been upgraded from version 3.4.3 to
version 3.9.0. The 64 bit Network Advisor will contain a 64 bit JServer with it and the 32 bit Network
Advisor will contain a 32 bit JServer.
Indications subprofile
The Indications subprofile is supported by the WBEM Solutions J WBEM Server CIMOM as shown in
Figure 7.
Fabric profile
The Brocade Network Advisor SMI Agent supports the Storage Networking Industry Association
(SNIA) Fabric profile, which defines the model and functions of a storage network for topology and
zoning control.
A Brocade_SAN (CIM_AdminDomain) instance represents a SAN containing one or more
Brocade_Fabric (CIM_AdminDomain) instances that are physically interconnected. A SAN and
a fabric are considered to be a group of components that operate together as a single system
and should be managed as such. The containment of Brocade_Fabric instances to
Brocade_SAN instances is through the associated Brocade_FabricInSAN
(CIM_ContainedDomain).
A Brocade_SAN instance in CIM is keyed by the property name with an associated optional
property, NameFormat. Name is opaque and NameFormat identifies how the property name is
generated. In the case of Brocade_SAN, the property NameFormat is set to WWN. Simple
fabric - Brocade_SAN.Name is the principal WWN of the fabric.
A fabric or SAN instance both inheriting CIM_AdminDomain are differentiated using the
OtherIdentifyingInfo property.
For Brocade_SAN, OtherIdentifyingInfo = SAN
For Brocade_Fabric, OtherIdentifyingInfo = FABRIC
For both Brocade_SAN and Brocade_Fabric, IdentifyingDescriptions = SNIA:DetailedType
From a SMI perspective, all fabrics which are physically connected are considered to be contained
in the same SAN.
In virtual fabrics with dedicated ISL between the base switches where some of virtual fabrics
have been discovered but there is no base fabric.
- If the base fabric is discovered, Brocade_SAN.Name is the principal WWN of the base
fabric.
- If the base fabric is not discovered, the virtual fabrics will be disjointed and in each fabric
one SAN instance will be generated.
In Virtual fabrics with no dedicated ISL between the base switches but with a dedicated ISL
between one of the discovered virtual fabrics.
- In the absence of a dedicated ISL between the base switches, no actual logical fabrics
exist except for those which have a dedicated ISL. The virtual fabrics will be disjointed and
in each fabric one SAN instance will be generated.
A FCR setup where the backbone fabric and edge fabrics have been discovered,
Brocade_SAN.Name is the principal WWN of the backbone fabric.
A FCR setup where only one or more edge fabrics have been discovered.
- In the absence of the backbone, each edge fabric is associated to its own SAN instance
and the Brocade_SAN.Name is the principal WWN of that edge fabric.
When a single edge fabric is connected to more than one separate backbone fabric, all the
fabrics will be discovered as a single SAN. The Brocade_SAN.Name is the principal WWN of
one of the backbone fabric.
A fabric containing a CEE switch, Brocade_SAN.Name is the principal WWN of the Fibre
Channel fabric with the switch.
In a simple Fibre Channel fabric, Brocade_SAN.Name is the principal WWN of the fabric.
Registration
Figure 8 shows the SNIA profile registration profile model to advertise the Fabric profile and its
subprofiles.
Data model
Figure 9 shows the Fabric profile data model with the classes and properties that are supported to
conform to the Fabric profile. Only those properties that are mandatory are considered.
NOTE
The following properties are mapped with the value specified to differentiate between
Brocade_Fabric and Brocade_SAN instances.
Brocade_Fabric instance:
OtherIdentifyingInfo[] = {"Fabric"}
IdentifyingDescriptions[] = {"SNIA:DetailedType"}
Brocade_SAN instance:
OtherIdentifyingInfo[] = {"SAN"}
IdentifyingDescriptions[] = {"SNIA:DetailedType"}
NOTE
The SwitchId property will be populated only for switches running FOS 7.1.0 onwards.
Brocade_SAN.ElementName properties
The following are the properties of Brocade_SAN.ElementName:
Brocade_SAN.ElementName is a descriptive name to identify the SAN.
The default value for ElementName is the Brocade_SAN.Name property value.
Supports the set operation that is used to set the user-friendly name to SAN. The name can be
up to 15 characters.
The Brocade_SAN.ElementName will not get reset unless all the fabrics in the SAN have been
deleted from Brocade Network Advisor.
If the principal switch of the fabric changes then the associated SAN name for the SAN will be
retained.
For SAN consisting of multiple fabrics SAN name would be retained until all the fabrics in the
SAN get deleted.
For multiple fabrics managed by BNA merge, the name of the SAN whose SAN key is retained
becomes the new SAN ElementName.
For SAN that splits into multiple fabrics, the SAN which has the same name as the original SAN
would retain its name.
NOTE
The default value for Brocade_SAN.ElementName is the Brocade_SAN.Name property value.
For more information about Brocade_SAN.ElementName default values, refer to Rules governing
Brocade_SAN.Name on page 17.
Limitations
The following are the limitations of the Brocade_SAN.ElementName:
The ElementName is changed whenever the SAN WWN is changed.
The SAN user-friendly name is deleted when the fabric is deleted. For example, assume a
fabric with switch1 as principal switch and you configure a SAN Element Name.
- If the firmware is upgraded in the switch1 and it goes down momentarily, then switch2
becomes the principal switch in that fabric and the Element Name is changed to default.
- When the switch1 comes active and becomes the principal switch, then the configured
SAN ElementName is reset to the configured name.
The SAN element name is reset to the default value when the principal switch WWN is changed
during fabric merge or segmentation.
- For example, assume there are two switch fabrics where switch1 is the seed switch and
switch2 is the principal switch, and SAN Element name is configured. If a switch3 joins the
fabric as a principal switch, then the element name changes to switch3 WWN and the
configured name is lost.
Registration
Refer to Registration on page 18.
Data model
Figure 10 shows the data model with the classes and properties that are supported to conform to
these subprofiles. Only those properties that are mandatory are considered.
FIGURE 10 Zone control and enhanced zone control subprofiles data model
Table 3 outlines the required CIM elements for the zone control subprofile.
Extrinsic methods
The Brocade_ZoneService class contains the following extrinsic methods of the zone control
subprofiles:
CreateZoneSet
CreateZone
CreateZoneAlias
CreateZoneMembershipSettingData
AddZone
AddZoneAlias
AddZoneMembershipSettingData
ActivateZoneSet
SessionControl
ActivateZoneSetWithJob
SessionControlWithJob
The following method is Brocade extension:
ClearZoneDB
If a Brocade Network Advisor client first starts zoning on a fabric (opens a zoning dialog box for
that fabric) and then an SMI client starts a transaction on the same fabric, a notification is sent
to the Brocade Network Advisor client that another user is starting zoning operations. This is a
broadcast notification to all the Brocade Network Advisor clients that currently have the zoning
dialog box open to do zoning configuration on the same fabric. This behavior is the same as
between two Brocade Network Advisor clients.
If an SMI client starts a transaction on a fabric and a Brocade Network Advisor client opens a
zoning dialog box, a notification is issued, which need not be considered. The SMI client could
be in the middle of the session changes.
If the SMI client commits first, the Brocade Network Advisor client is notified that the zone
database has been changed. The Brocade Network Advisor client has the option of ignoring or
refreshing the zone database copy. This is a warning message and there is nothing preventing
the Brocade Network Advisor client from ignoring the warning. This behavior is the same as
between two Brocade Network Advisor clients.
If a Brocade Network Advisor client commits the changes first, the SMI client's zone
transaction is aborted and an indication is sent.
If the time for which an open transaction is idle or greater than Brocade_ZoneService.Timeout
(value in seconds), the SMI client's zone transaction is aborted and an indication is sent.
Error code 32770 is mapped to Transaction_Not_Started, which is different from the host
agent where it is No_Transaction.
Error code 32772 is mapped to Transaction_Already_Started, which is different from the host
agent where it is Transaction_Already_On.
Error code 32781 is a new error code mapping to Transaction_Not_Available. This will be
returned to a CIMClient on SessionControl in the event that the zoning transaction on that
fabric is already opened by some other CIMClient.
Error code 32775 mapped to Too Many Members no longer exists.
Indication is not delivered when the client intentionally aborts a transaction.
The fabric assist zoning feature is not supported and therefore the H{<WWN>} notation for a
fabric member is not supported in the SMI Agent.
Data model
Figure 11 shows the classes and properties of the Job control subprofile.
A second job for the same operation and same target cannot be started if a job is already in
progress and in the running state.
A failed job shows an OperationalStatus of {"6", "17"}, while a successful job shows {"2", "17"}.
Although the GetError() method is mandatory, this operation is not supported.
Upon Brocade Network Advisor server restart, all existing Brocade_ConcreteJob instances are
deleted because they are not persisted in the Brocade Network Advisor database.
Supported indications
Table 4 shows all the supported mandatory indications.
SAN zoning
Storage Area Network (SAN) zoning is a method of arranging Fibre Channel devices into logical
groups over the physical configuration of the fabric. Brocade Network Advisor SMI Agent provides
SAN zoning configuration support such as CreateSANZone, AddSANZoneMemembers,
RemoveSANZoneMembers, and DeleteSANZone through extrinsic methods.
A Logical Storage Area Network (LSAN) consist of zones in two or more edge fabrics or backbone
fabrics that contain the same devices.The LSANs provide selective device connectivity between
fabrics without forcing you to merge those fabrics.
Peer zoning
Beginning with Fabric OS 7.4.0 or later, Peer zone Read-Only support is provided on the Brocade
Network Advisor SMI Agent for SAN zoning and LSAN zoning, with user restrictions. The following
are the Peer zone user restrictions:
Creating a Peer zone.
Adding a new member to the existing Peer zone.
Deleting a Peer zone.
Removing a member from an existing Peer zone.
Deleting a member that is part of the Peer zone.
Adding a zone alias to the Peer zone.
Removing a zone alias from the Peer zone.
Differentiating Peer User and Peer Target zones from normal zones.
Registration
There is no profile registration for this model.
Data model
Figure 12 shows the data model of SAN zoning.
NOTE
The name of SAN zone must start with LSAN_. Otherwise, the extrinsic call returns an error code:
5 (CIM_ERR_INVALID_PARAMETER). Invalid SANZone name: <SAN Zone name>.
Use cases
Figure 13 explains a sample SAN configuration.
Host
E E
E E E E E
EX EX EX
EX EX EX
EX
Backbone fabric
Create a LSAN_Zone1, add WWN of Host, Target3 and activate the same zone. As the
LSAN_Zone1 has end devices from fabric1 and fabric3, it is activated to both the fabrics. The
following extrinsic calls are used for this operation:
- Activate the SAN zoning session with SANSessionControl (RequestedSessionState=2).
- Create an LSAN zone with CreateSANZone (SANZoneName=LSAN_Zone1,
SANZoneType=LSAN, ZoneMembers={Host WWN, Target 3 WWN}).
- Commit the SAN zoning session with SANSessionControl (RequestedSessionState=3).
Create a LSAN_Zone2, add WWN of Host, Target1, Target3, and activate the same zone. As the
LSAN_Zone2 has devices from fabric1, fabric2, and fabric3, the LSAN_Zone2 is activated to all
the three fabrics.
Create LSAN_Zone3 with offline zone members. As the LSAN_Zone3 has only offline members,
the operation is failed with error code 4 (FAILED).
Create LSAN_Zone4, add host, and offline members and activate the same zone. It is activated
in fabric1 as the host belongs to fabric1.
Adding a zone member:
- Add member operation is invoked with the input: WWN Target1 on LSAN_Zone1.
- The member is added to the zone in the fabric1 and fabric3. A copy of the zone is added to
the active zoneset of the fabric2.
- The following are the extrinsic calls used for this operation:
Activate the SAN zoning session with SANSessionControl (RequestedSessionState=2).
Add zone members with AddSANZoneMembers (SANZoneName=LSAN_Zone1,
ZoneMembers={Target 1 WWN}).
Commit the SAN zoning session with SANSessionControl (RequestedSessionState=3).
Removing a zone member:
- Remove member operation is invoked with the input: WWN Target1.
- The member is removed from the zone in fabric1 and fabric3 and the copy of zone is
removed from the fabric2.
- The following extrinsic calls are used for this operation:
Activate the SAN zoning session with SANSessionControl (RequestedSessionState=2).
Remove zone members with RemoveSANZoneMembers
(SANZoneName=LSAN_Zone1, ZoneMembers={Target 1 WWN}).
Commit the SAN zoning session with SANSessionControl (RequestedSessionState=3).
Delete a zone with input of zone name (LSAN_Zone1). It will be removed from all the edge
fabrics and backbone fabric.
- The following extrinsic calls are used for this operation:
Activate the SAN zoning session with SANSessionControl (RequestedSessionState=2).
Delete a zone with DeleteSANZone (SANZoneName=LSAN_Zone1).
Commit the SAN zoning session with SANSessionControl (RequestedSessionState=3).
Delete a zone with input of zone name (LSAN_Zone7), which is not present in any of the
fabrics. The following error code is returned
- 4 (Failed).<LSAN_Zone7>: SAN Zone name is not found in zone DB.
Subscribe BRCD102 indications and create SAN zone with online members. An indication with
message ID BRCD102 is delivered for activation failures.
Create SAN zone with the prefix XSAN_, add some zones member WWNs, and activate the
zone. As there are invalid zone names, the failure error code 5
(CIM_ERR_INVALID_PARAMETER) is returned.
Add some Domain:PortIndex zone members in the SAN zone. Due to invalid zone members,
the error code 5 (CIM_ERR_INVALID_PARAMETER) is returned.
Registration
Each virtual fabric represented by an instance of Brocade_Fabric, is associated to an instance of
Brocade_RegisteredProfile(Fabric). By SMI definition, all virtual fabrics that are physically
interconnected belong to the same SAN. The Brocade_SAN instance containing the virtual fabrics
associates itself to an instance of Brocade_RegisteredSubprofile (FabricVirtualFabrics) only if the
base switch is discovered. Refer to Registration on page 18.
Data model
Figure 14 models the required classes. The classes relevant in the Fabric profile are also included:
Each physical switch is represented by an instance of Brocade_PhysicalComputerSystem.
Each physical port is represented by an instance of Brocade_PCSNetworkPort.
Each virtual fabric is represented by an instance of Brocade_Fabric.
Each virtual switch is represented by an instance of Brocade_Switch.
Each port within a virtual switch is represented by an instance of Brocade_SwitchFCPort.
All virtual fabrics associate to a single Brocade_SAN instance.
All virtual switches carved out from a single switch associate to a single
Brocade_PhysicalComputerSystem instance.
All Brocade_PhysicalComputerSystem instances associate to a single Brocade_SAN instance.
FIGURE 15 Sample Virtual Fabrics configuration, connecting the SMI Agent to a single chassis
For this example, assume that the SMI Agent is connected to the Chassis 2 IP address. The SMI
Agent can discover the following:
1 SAN
3 fabrics (Fabric ID 1, Fabric ID 2, and Fabric ID 3)
4 physical chassis
- Chassis 1
- Chassis 2
- Chassis 3
- The chassis for Switch B
9 switches
- 2 logical switches in Chassis 1
- 3 logical switches in Chassis 2
- 3 logical switches in Chassis 3
- Switch B
Logical switch 18 in Chassis 3 and Switch A, which is connected to this logical switch, are not
discovered.
The physical and logical ports corresponding to the discovered switches
Topology view
The Topology View class was introduced in SMI-S 1.3 to increase the performance and reduce the
number of traversals required to discover topology.
The Network Advisor SMI Agent cannot provide a complete topology and its related information
including instances of classes like Brocade_TopologyView, Brocade_SanActiveConnection if one of
the switches involved goes unreachable or unmanageable.
Objectives
The objective is to deliver a class that can be enumerated, gives better performance than
enumerating Brocade_SANActiveConnection(CIM_ActiveConnection), and traverse to each
endpoint to gather data about the link between switch ports or between N_Ports and switchports.
Performance considerations
Performance should be significantly better than the combined performance of enumeration of
Brocade_SANActiveConnection (CIM_ActiveConnection) and traversals to endpoint instances
through CIMClient.associators call.
Registration
Figure 17 shows the registration model of Topology view.
Data model
Figure 18 shows the data model of Topology view.
NOTE
Beginning with Network Advisor 12.4.2, Brocade_TopologyView class is changed from association to
provider, in order to support the property name change of AntecedentFCPort, AntecedentSystem,
DependentFCPort, and DependentSystem from REF to String.
FDMI subprofile
The Fabric-Device Management Interface (FDMI) enables the management of devices such as Host
Bus Adapters (HBAs) through the fabric. This subprofile models the discovery of HBA type devices
without having the SMI Agent reside on the host containing the HBA. It shows how an HBA is hosted
on the system (host) along with the nodes contained in it and ports controlled by it. It allows HBAs
to expose product information such as firmware version, vendor, serial number, and so on. This
model supports all HBA configurations such as single-node single-port HBA, single-node dual-port
HBA, and dual-node dual-port HBA.
Prerequisites
Only the HBAs that register a FDMI host name in the Name Server (NS) on the switch or fabric
support the Brocade_Platform model. Currently, the EOS switches do not support FDMI. Therefore,
HBAs connected to EOS switches do not support the Brocade_Platform model, including the
instance classes and association classes.
NOTE
The switch connected to an FDMI-enabled HBA runs on Fabric OS v7.0.0 or later. Also, the seed
switch runs on Fabric OS v7.0.0 or later to support this profile.
Registration
Refer to Registration on page 18.
Data model
Figure 19 shows the class diagram of the classes and properties supported in the FDMI subprofile.
The instances for the CIM classes Brocade_SoftwareIdentity, Brocade_HBAProduct,
Brocade_PhysicalHBA, and Brocade_PortController are available as part of the FDMI subprofile
provided the switches are running Fabric OS v7.0.0 or later.
For a single-node single-port HBA, there is a single Brocade_Node instance hosted on a
Brocade_Platform and a single Brocade_PortController representing the logical aspects of the
Brocade_PhysicalHBA controlling a single Brocade_NodeFCPort.
For a single-node dual-port HBA, there is a single Brocade_Node hosted on a Brocade_Platform
and a single Brocade_PortController representing the logical aspects of the Brocade_PhysicalHBA
controlling both Brocade_NodeFCPort instances.
For a dual-node dual-port HBA, there are two Brocade_Node instances hosted on the same
Brocade_Platform and a single Brocade_PortController representing the logical aspects of the
Brocade_PhysicalHBA controlling both Brocade_NodeFCPort instances.
Trunking
This section defines the model for the trunking feature in Brocade Network Advisor SMI Agent. The
trunking model is supported only for FOS switches.
NOTE
The m-EOS switches open trunking feature is not supported in Brocade Network Advisor SMI Agent
and there will not be any modeling m-EOS open trunking.
Both ISL trunking and F_Port trunking are supported for FOS switches.
Data model
Figure 20 shows the trunking class diagram.
InstanceID [Key] string InstanceID opaquely and uniquely identifies an instance of this
class.
The format of this key is as follows.
SOURCESWITCHWWN=<value>;
SOURCESWITCHTYPE=<value>:
DESTINATIONWWN=<value>;
SOURCESWITCHPORTWWN=<value>;
DESTPORTWWN=<value>;
CLASSNAME=Brocade_Trunk;
DESTINATIONTYPE=<value>;
SOURCE_WWN is the master switch WWN of one end.
SOURCE_PORT_WWN is the master port WWN of the trunk
members in a trunk group.
DEST_WWN is the WWN of the other end, which is a switch in case
of an ISL trunk and AG in case of an trunk.
DEST_PORT_WWN is the port WWN of the other end.
SOURCE_TYPE is the type of the source (Switch=0, Device=1)
DEST_TYPE is the type of the other end (Switch=0, Device=1)
TypeOfSet[] uint16 TypeOfSet provides information on the type of redundancy.
ElementName string A user-friendly name for the object.
RedundancyStatus uint16 RedundancyStatus provides information on the state of the
RedundancySet.
LoadBalanceAlgorithm uint16 The current load balance algorithm.
OtherTypeOfSet[] string When the corresponding array entry in TypeOfSet[] is Other, this
entry provides a string describing the type of set.
OtherLoadBalanceAlgorithm String When LoadBalanceAlgorithm is Other, this property describes
the algorithm.
Switch profile
The Storage Networking Industry Association (SNIA) switch profile defines the model and functions
of a fibre channel switch including state, status, and control of the device and its connections.
Registration
The SNIA Profile Registration Profile model is followed to advertise Switch profile and its
subprofiles.
Figure 21 shows the instance diagram with the objects and properties for Switch profile
registration. Only for blades, the actual blade instances that conform to the Blades subprofile will
be associated. For the other subprofiles, such as Software, Access Points, and so on, the
association to the actual instances are not supported.
Data model
Figure 22 shows the Switch profile data model.
NOTE
The value of the Dedicated property of Brocade_Switch is Switch (5) and FC Switch (37).
The set operation for the Brocade_SwitchFCPortSettings.RequestedType is supported from Fabric
OS v6.3 and later.
NOTE
Switch un-monitoring is not supported from SMI perspective and if the switch is un monitored, then
the SMI Agent would return stale information.
Registration
Refer to Registration on page 43.
Data model
Figure 23 shows the data model with the classes and properties that are supported to conform to
the switch subprofiles.
FIGURE 23 Physical Package, Access Points, Software, Blades, and Location subprofiles data model
NOTE
he Brocade_Chassis.ElementName property is set correctly in the corresponding instance only if the
seed switch is running on a Fabric OS v6.3.x or higher and if the chassisName in the switches of the
fabric are set after the seed switch firmware has been upgraded.
Data model
Figure 24 shows the instance diagram of the CP blades.
FC HBA profile
The Fibre Channel Host Bus Adapter (FC HBA) profile is similar to the FDMI subprofile. As with
FDMI, this model also supports all HBA configurations such as single node-single port HBA,
single-node dual-port HBA, and dual-node dual-port HBA.
Prerequisites
Only the HBAs discovered in Brocade Network Advisor are exposed through the FC HBA profile.
Data model
Figure 25 shows the data model of the FC HBA profile.
NOTE
The HBA is represented by the PortController class and the serial number is the key.
LIC names
Table 11 shows the list of LIC names and their descriptions.
TABLE 11 Description of LIC names
LIC name Description
For example,
http:// <IP Address: port number>/webstart/<JNLP file name>?module=<module name>&<SSO
parameters if any>&${<parameter name like WWN>}
The corresponding entries in Brocade_LICServiceAccessPoint.ParameterName is of the following
format.
{<OrgName>:<SpecName>:<SpecVersion>:WWN}.
You have to replace the ${WWN} part of URL. Here, orgName is Brocade; specName and
specVersion are empty. Therefore, the ParameterName is Brocade:::<WWN>
NOTE
Extrinsic methods of launch service are not supported.
Registration
Refer to Registration on page 43. The Brocade_Switch instance representing the CEE switch is
associated to the Brocade_RegisteredProfile instance for switch. There is no profile conformance
for the Ethernet portion of the model due to evolving standards.
Data model
Figure 27 shows the FC and Ethernet topologies along with their connections to the physical
elements. This is a general model that covers device and switch connections to the CEE switch:
Two CIM_ComputerSystem instances (Brocade_Switch and Brocade_EthernetSwitch) is shown
to represent the FC and Ethernet sides of the switch. These instances are associated to the
physical counterpart, which is the Brocade_PhysicalComputerSystem.
Brocade_EthernetSwitch is a component of Brocade_EthernetAdminDomain on the Ethernet
topology side. Similarly, the Brocade_Switch is a component of Brocade_Fabric on the FC
topology side.
The value of the dedicated property of Brocade_EthernetSwitch is Ethernet switch (38).
The Ethernet ports is shown as Brocade_EthernetPort instances associated to the physical
counterpart, which is the Brocade_PCSNetworkPort.
The virtual FCoE port is represented as the Brocade_SwitchFCPort instance with the PortType
as G, or F, or E and is not be associated to a Brocade_PCSNetworkPort. It is an internal port
and there is no physical representation for that port. Even though the virtual FCoE ports are
internal to the switch, they will be modeled as visible switch ports in order to show the devices
physically (directly or indirectly) connected to one of the Ethernet interfaces. However, these
internal ports exist in the ASIC and the Brocade_SwitchFCPort.PortDescriminator property has
the value "8" representing that this is an internal port.
The presence of an active FCoE session is registered as a name server node and port entry.
This is depicted in the host topology as the node and node ports.
The Brocade_EthernetPort of the host is associated to the Brocade_NodeFCPort(s)
(HostedDependency). The Brocade_EthernetPort on the host will not have all properties
populated. All key properties are populated. Among the non-key properties, the
OperationalStatus is 2 (OK) and EnabledState is 2 (Enabled).
All LANEndPoints are part of the EthernetLogicalNetwork in the
Brocade_EthernetAdminDomain.
Configuration of the virtual FCoE port is supported. It is a normal switch port instance. Each
Brocade_SwitchFCPort instance representing a virtual FCoE port is associated to
Brocade_SwitchFCPortSettings and Brocade_SwitchFCPortCapabilities instances (not shown
in Figure 27 to avoid clutter; refer to Figure 22 on page 44).
Brocade_SwitchFCPortStats and Brocade_SwitchFCPortRateStats is not shown for virtual FCoE
ports. There is no statistics for the Ethernet interfaces due to the lack of an SMI model.
Topology supported
The Brocade Network Advisor SMI Agent supports the following use cases.
Device
A device connected to one of the eight FC ports - The Switch profile is used to model the
Brocade CEE switch and its eight FC ports. For the devices connected to these eight FC ports,
refer to Data model on page 19 and Data model on page 46. The FC topology portion in
Figure 27 shows the classes and their associations for this use case.
A device directly connected to one of the Ethernet ports on the CEE switch (one or multiple
FCoE login sessions open) with the device port and device node WWN for each session
registered in the NS database. Figure 27 shows elements in both the FC and Ethernet side. If
the host is registered with a FDMI host name, then the node and node port is hosted on the
platform.
A device indirectly connected to the CEE switch (one or multiple FCoE login sessions open) with
the device port and device node WWN for each session registered in the NS database.
Figure 27 shows elements in both the FC and Ethernet side. The elements in orange cannot be
discovered. This means there is no representation of the Ethernet cloud.
Switch
Two CEE switches connected by their FC ports.
Two CEE switches connected by their Ethernet ports in pure Layer 2 - Both the switches must
be individually managed. The Ethernet portion in Figure 28 depicts the elements and their
connections. There will be one Brocade_EthernetAdminDomain and one
Brocade_EthernetLogicalNetwork per subnet.
Zoning support
Zoning is supported only on the front-end FC ports. The Brocade Network Advisor SMI Agent has
the same limitations as Brocade Network Advisor.
Configuration
The Brocade Network Advisor SMI Agent relies on Brocade Network Advisor support to provide CEE
configuration functionality.
All CEE configuration features are supported on Fabric OS v6.3.0 and later.
Requirements
Enable or disable CEE port
Set interface mode of CEE port to Layer 2 or none
Set Layer 2 mode of CEE port to access, trunk, or converged
Discovery of LAGs
- Create LAG
- Delete LAG
- Add members to LAG
- Remove members from LAG
Discovery of VLANs
- Create VLAN
- Delete VLAN
- Add members to VLAN
- Remove members from VLAN
Discovery of CEE ACL policies
- Create ACL policy
- Delete ACL policy
- Modify ACL policy
- Assign ACLs
Discover CEE maps
- Create CEE map
- Delete CEE map
- Modify CEE map
- Assign CEE Map
Enable global LLDP
Disable global LLDP
Indications
Saving the running configuration to the startup configuration on the CEE switch
This feature allows you to save all the CEE configuration changes made after startup so that they
are persisted across reboots. The class Brocade_EthernetSwitch in BrocadeEthernet.mof is
updated with a new extrinsic method ConfigSaveRunningToStartup. This method saves the CEE
changes to startup configuration on the switch. The changes are visible even after a reboot.
Limitations
The value of LLDP-DCBX for port and switch is not persisted in Brocade Network Advisor. In order to
retrieve the value of this property, a call needs to be executed. As a result, populating this property
for port and switch during an enumerateInstances operation is costly and will lead to a degradation
in discovery timings. The Brocade Network Advisor SMI Agent will populate this property as
Unknown in both Brocade_EthernetSwitch and Brocade_EthernetPort, if the instance is retrieved
through enumerateInstances. Users can get the correct value of this property on demand through
the getInstance() intrinsic operation only.
The value of Brocade_VLANEndPoint is not persisted in Brocade Network Advisor. Brocade Network
Advisor SMI Agent will populate this property as Unknown.
LAGs
Link aggregation allows you to bundle multiple physical Ethernet links to form a single logical trunk
providing enhanced performance and redundancy. The aggregated trunk is referred to as a Link
Aggregation Group (LAG). The LAG is viewed as a single link by connected devices, the Spanning
Tree Protocol (STP), Virtual Local Area Network (VLANs), and so on. When one physical link in the
LAG fails, the other links stay up and there is no disruption to traffic.
Brocade Network Advisor SMI Agent supports discovery of these LAGs. In addition, support will be
provided to create, delete, and modify existing LAGs.
NOTE
To configure links to form a LAG, the physical links must be in the same speed and all links must go
to the same neighboring device.
Data model
There is no SNIA model for LAGs. Some aspects of the Distributed Management Task Force (DMTF)
model are considered while others are completely proprietary. The following detailed notes
describe the class diagram as shown in Figure 29.
The LAG is a protocol endpoint defined at the scope of the switch and is represented by an
instance of Brocade_LAG associated to the scoping system, which is the
Brocade_EthernetSwitch through Brocade_LAGInEthernetSwitch.
The property Brocade_LAG.InterfaceMode indicates whether or not the LAG is in Layer 2 mode
and is writable.
The property Brocade_LAG.OperationalEndPointMode indicates whether the LAG is in access,
trunk mode and is writable.
Each LAG can contain zero or more members. Each LAG member is represented by an instance
of Brocade_LAGPort. The composition is through Brocade_LAGPortInLAG.
The member is also defined at the scope of the switch associated to the scoping system, which
is the Brocade_EthernetSwitch through Brocade_EthernetSwitchHostedLAGPort.
Each Brocade_LAGPort instance represents a concrete Brocade_LANEndPoint of a
Brocade_EthernetPort that has been added to the BrocadeLAG. This relationship between the
Brocade_LAGPort and the Brocade_LANEndPoint is represented as
Brocade_LAGPortOfLANEndPoint.
There is one Brocade_LAGService instance per Brocade_EthernetSwitch. This hosting is
represented by Brocade_LAGServiceInEthernetSwitch.
Registration
There is no conformance to any profile, and thus no registration.
VLANs
Virtual Local Area Network (VLANs) provide the capability to overlay the physical network with
multiple virtual networks. VLANs allow you to isolate the network traffic between virtual networks
and reduce the size of administrative and broadcast domains. A VLAN contains end stations that
have a common set of requirements that are independent of physical location. You can group end
stations in a VLAN even if they are not physically located in the same LAN segment. VLANs are
typically associated with IP subnetworks and all the end stations in a particular IP subnet belong to
the same VLAN. VLAN membership is configurable on a per-interface basis.
Data model
There is no SNIA model for VLANs. Some aspects of the Distributed Management Task
Force (DMTF) model have been considered while others are completely proprietary. The following
detailed notes describe the class diagram as shown in Figure 30.
The VLAN is a collection of protocol endpoints defined at the scope of the switch and is
represented by an instance of Brocade_VLAN associated to the scoping system, which is the
Brocade_EthernetSwitch through Brocade_VLANInEthernetSwitch.
The property Brocade_VLAN.ElementName gives the VLAN's user-friendly name.
Each VLAN may contain zero or more members. Each VLAN member is represented by an
instance of Brocade_VLANEndPoint. The composition is through
Brocade_VLANEndPointInVLAN.
The member is also defined at the scope of the switch associated to the scoping system, which
is the Brocade_EthernetSwitch through Brocade_EthernetSwitchHostedVLANEndPoint.
Each Brocade_VLANEndPoint instance represents a concrete Brocade_LAG or
Brocade_LANEndPoint of a Brocade_EthernetPort that has been added to the Brocade_VLAN.
This relationship between the Brocade_VLANEndPoint and the Brocade_LANEndPoint is
represented as Brocade_VLANEndPointOfLANEndPoint. And the relationship between the
Brocade_VLANEndPoint and the Brocade_LAG is represented as
Brocade_VLANEndPointOfLAG.
There is one Brocade_VLANService instance per Brocade_EthernetSwitch. This hosting is
represented by Brocade_VLANServiceInEthernetSwitch.
The capabilities of the service are represented by an instance of
Brocade_VLANServiceCapabilities associated to the service through
Brocade_VLANServiceElementCapabilities. The maximum number of VLANs that can be
created on the switch and the methods supported by the service are reported in this
capabilities instance.
Brocade_VLANService provides extrinsic methods to create and delete VLANs, and add and
remove members from an existing VLAN.
Brocade_VLAN can be created using the Brocade_VLANService.CreateVLAN() extrinsic method.
Refer to mof content for details on the parameters.
The path of the newly created Brocade_VLAN instance is returned in the output parameter
VLAN. The Brocade_VLAN will be associated to the appropriate Brocade_EthernetSwitch
instance on which it is defined.
Members may be added to an existing Brocade_VLAN instance using the
Brocade_VLANService.AddMembers() extrinsic method. Refer to BrocadeLAG.mof for details
on the parameters.
Registration
There is no conformance to any profile, and thus no registration.
Limitations
The following are the limitations of VLAN profile:
The properties are provided through the capabilities on the endpoint.
There is no support for Generic VLAN Registration Protocol (GVRP) and so the
Brocade_VLANEndPointCapabilities.Dot1QTagging is false. Therefore,
Brocade_VLANEndPoint.GVRPStatus is not applicable.
Brocade_VLANEndPointCapabilities.Dot1QAcceptableVLANFramesTypes is same as
Brocade_VLANEndPoint.FrameType.
Valid values for Brocade_VLANEndPointCapabilities.Dot1QAcceptableVLANFramesTypes is
populated on Enumerate Instance Names and Enumerate Instances only. The value is
Unknown on GetInstance due to performance issue.
Ingress and egress filtering is always enabled.
CEE ACLs
Access Control List (ACL) is used to filter Ethernet traffic of the Ethernet switch. It permits or denies
incoming packets from passing through interfaces that has the ACL policies applied to them. The
primary function is to control the movement of packets through or to the system and also to track
the packet movement.
ACLs are not effective until they are applied to an interface. One can apply ACLs on VLANs and on
the Ethernet switch 10-Gigabit Ethernet Layer 2 interfaces (Physical interfaces, Logical interfaces,
and LAGs). Each ACL is a unique collection of permit and deny statements (rules) that apply to the
packets. When a packet is received on an interface, the switch compares the fields in the packet
against any ACLs applied to the interface to verify that the packet has the required permissions to
be forwarded. The switch compares the packet sequentially against each rule in the ACL and either
forwards the packet or drops the packet.
The Brocade Network Advisor SMI Agent supports the discovery of these ACLs, both standard and
extended. In addition, support is provided to create, delete, and modify existing ACLs.
Resequencing of an ACL is not supported. Displaying and clearing of the ACL statistics counter is
not supported. However, users can enable or disable the tracking of traffic by specifying the count
parameter within the rule of an ACL policy.
There are two types of Layer 2 Media Access Control (MAC) address ACLs, standard and extended.
Layer 2 standard ACLs-permit and deny traffic according to the source MAC address in the
incoming frame. Use standard MAC ACLs if you only need to filter traffic based on source MAC
addresses.
Layer 2 extended ACLs-permit and deny traffic according to the source and destination MAC
addresses in the incoming frame, as well as other information in the MAC header, such as
EtherType.
The ACL name must be unique across both the standard and extended types.
The ACL name can be a maximum of 64 characters.
Special characters can be used in an ACL name.
Even though ACLs can be Layer 2-specific (MAC) or Layer 3-specific (IP), they can only be
applied on the same type of interface. Because an interface can only be set to Layer 2 mode,
Layer 2 ACLs and only ACLs with MAC source and destination addresses are supported.
Data model
There is no SNIA model for CEE ACLs. The DMTF DSP1039 version 1.0.0 for the Role-Based
Authorization Profile to model these ACLs will be followed. All mandatory classes and properties as
stated in this profile will be supported. The following detailed notes describe the class diagram as
shown in Figure 31.
The CEE ACL policy is defined at the scope of the switch. This policy represented by an instance
of Brocade_CEEACLPolicy is associated to the scoping system, which is the
Brocade_EthernetSwitch through Brocade_CEEACLPolicyInEthernetSwitch.
Each CEE ACL policy may contain zero or more rules. All the rules within a policy are
represented by a single instance of Brocade_CEEACLRules. The composition is through
Brocade_CEEACLRulesInPolicy. There is one instance of Brocade_CEEACLRules for every
Brocade_CEEACLPolicy on the Brocade_EthernetSwitch.
The Brocade_CEEACLRules.ActivityQualifiers array contains an array of strings, each string
represents one rule within the policy. Each string contains the details of the sequence number,
source, destination, count, Ether Type and privilege of the rule in a specific format.
The Brocade_CEEACLRules.QualifierFormats array contains an array of strings, each string
represents the format for the rule in the Brocade_CEEACLRules.ActivityQualifiers array at the
same index.
All the possible values for the Brocade_CEEACLRules.QualifierFormats array are published in
the Brocade_CEEACLServiceCapabilities.QualifierFormatsSupported as an array of strings. The
value in the Brocade_CEEACLRules.QualifierFormats property is a subset of these formats.
A policy may be empty. In such a case, the Brocade_CEEACLPolicy is associated to a
Brocade_CEEACLRules instance in which the Brocade_CEEACLRules.ActivityQualifiers and
Brocade_CEEACLRules.QualifierFormats properties are empty.
If a CEE ACL policy has been applied to a port, LAG or VLAN, this information can be discovered
by traversing the Brocade_CEEACLPolicyOnEthernetPort, Brocade_CEEACLPolicyOnLAG, or
Brocade_CEEACLPolicyOnVLAN respectively to the appropriate ManagedElement.
For every Brocade_EthernetSwitch instance, there is an instance of Brocade_CEEACLService.
This service provides the ability to create, delete, modify, and assign CEE ACL policies.
The capabilities of the service are published by a single instance of
Brocade_CEEACLServiceCapabilities associated to the service through
Brocade_CEEACLServiceElementCapabilities.
Brocade_CEEACLPolicy can be created using the Brocade_CEEACLService.CreateRole()
extrinsic method. Only the input parameters RoleTemplate and Privileges are supported. The
successful execution of this method results in the creation of an instance of
Brocade_CEEACLPolicy being associated to an instance of Brocade_CEEACLRules. The path of
the newly created Brocade_CEEACLPolicy instance is returned in the output parameter Role.
The Brocade_CEEACLPolicy is associated to the appropriate Brocade_EthernetSwitch instance
on which it is defined. The Brocade_CEEACLPolicy instance is not associated to a port, LAG or
VLAN. This is done as a separate operation.
Registration
Because the DMTF DSP 1039 version 1.0.0 for Role-Based Authorization Profile to model these
ACLs is being followed, conformance will be advertised to that profile. Figure 32 shows the profile
registration diagram.
CEE maps
Data model
There is no SNIA model for CEE maps. The following notes present details on the class diagram in
Figure 33.
The CEE map is defined at the scope of the switch. This map is represented by an instance of
Brocade_CEEMap associated to the scoping system, which is the Brocade_EthernetSwitch
through Brocade_CEEMapInEthernetSwitch.
Each CEE map can contain zero or more priority groups. All the priority groups within a map are
represented by a single instance of Brocade_PriorityGroups. The composition is through
Brocade_ PriorityGroupsInCEEMap. There will be one instance of Brocade_PriorityGroups for
every Brocade_CEEmap on the Brocade_EthernetSwitch.
The Brocade_PriorityGroups.ActivityQualifiers array will contain an array of strings, each string
representing one priority group within the map with the exception of the last entry. The last
entry will contain the priorities for the mapping of the priority groups to the incoming
Converged OS (COS). Each string representing a priority group will contain the details of the
bandwidth and Priority Flow Control (PFC) in a specific format. The last string representing the
priority table will contain the priority group ID for incoming CoS in a specific format.
The Brocade_PriorityGroups.QualifierFormats array will contain an array of strings, each string
representing the format for the priority group or the priority table in the
Brocade_PriorityGroups.ActivityQualifiers array at the same index.
All the possible values for the Brocade_PriorityGroups.QualifierFormats array are published in
the Brocade_CEEMapServiceCapabilities.QualifierFormatsSupported as an array of strings.
The value in the Brocade_PriorityGroups.QualifierFormats property is a subset of these
formats.
A CEE map can be empty. In such a case, the Brocade_CEEMap will be associated to a
Brocade_PriorityGroups instance in which the Brocade_PriorityGroups.ActivityQualifiers and
the Brocade_PriorityGroups.QualifierFormats properties will be empty.
If a CEE map has been applied to a port, this information can be discovered by traversing the
Brocade_CEEMapOnEthernetPort to the Brocade_EthernetPort instance.
For every Brocade_EthernetSwitch instance, there will be an instance of
Brocade_CEEMapService. This service will provide the ability to create, delete, modify, and
assign CEE maps.
The capabilities of the service are published by a single instance of
Brocade_CEEMapServiceCapabilities associated to the service through
Brocade_CEEMapServiceElementCapabilities.
Brocade_CEEMap can be created using the Brocade_CEEMapService.CreateRole() extrinsic
method. Only the input parameters RoleTemplate and Privileges are supported. The successful
execution of this method results in the creation of an instance of Brocade_CEEMap being
associated to an instance of Brocade_PriorityGroups. The path of the newly created
Brocade_CEEMap instance is returned in the output parameter Role. The Brocade_CEEMap
will be owned by the Brocade_EthernetSwitch instance on which it is defined. The
Brocade_CEEMap instance will not be associated to any port. That assignment must be done
as a separate operation. Refer to BrocadeCEEMaps.mof description for more details.
An existing Brocade_CEEMap instance may be modified using the
Brocade_CEEMapService.ModifyRole() extrinsic method. The input parameters Role and
Privileges are required. The call will replace the existing Brocade_PriorityGroups instance for
the Brocade_CEEMap specified in the input parameter Role with the instance of
Brocade_PriorityGroups specified in the input parameter Privileges. Assigning to targets is not
supported during modification. This can be done separately through the AssignRoles
operation.
An existing Brocade_CEEMap instance can be deleted using the
Brocade_CEEMapService.DeleteRole() extrinsic method. This method deletes the instance and
its associated priority groups.
A Brocade_CEEMap may be applied to an Ethernet port using the
Brocade_CEEMapService.AssignRoles() extrinsic method. Only one map can be applied at a
time on the port.
Registration
There is no conformance to any profile, and thus no registration.
Brocade 8470 supports Layer 3 mode of operation. The external ports and LAGs can be in
None, Layer 2 and Layer 3 Interface mode. However, the internal ports can only be in the Layer
2 Interface mode.
SetInstance of the interface mode on external ports to None and Layer 2 is supported.
NOTE
Support for setting of Layer 3 mode is not needed because adding of an IP address to an
ethernet port automatically puts the port in Layer 3 mode.
Data model
The following data model is supported. Figure 34 shows the classes and associations for discovery
and configuration of IPv4 addresses on CEE ports and LAGs.
Data model
Figure 35 shows the fabric switch partitioning subprofile data model.
Registration
Only instances of Brocade_PhysicalComputerSystem that are Virtual Fabrics-enabled are
associated to the Brocade_RegisteredSubProfile instance for fabric switch partitioning. Figure 36
shows the registration for fabric switch partitioning subprofile.
FC routing
A Fibre Channel Router (FCR) is a specific case of switch partitioning. The FC-FC routing service
provides connectivity to devices in different fabrics without merging the fabrics. A switch running
the FC-FC routing service is called a Fibre Channel Router.
Data model
Figure 37 shows the FCR data model.
FCR devices of Brocade act as normal switches and routers. Therefore, the switch which is
router capable and functioning in multi-domain mode, has both physical and logical
representation in SMIS. The FCR is represented by two instances of CIM_ComputerSystem, a
Brocade_Switch and a Brocade_PhysicalComputerSystem associated by
CIM_HostedDependency(Brocade_SwitchInPCS).
The Brocade_PhysicalComputerSystem, in addition to being associated to the BackBone
Brocade_Switch instance, will also be associated to Brocade_Switch instances of front and
xlate phantoms.
Both the xlate phantom and front phantom switches are represented as Brocade_Switch
instances. The front phantom domain and xlate phantom domain switches are associated by
the Brocade_SANActiveConnection. These phantom switches can be differentiated by
Brocade_Switch.OtherIdentifyingInfo property value (which would have the values as Translate
Domain, Front Domain, and None for translate phantom domain, front phantom domain, and
ordinary switches respectively).
The InteropMode property of front phantom domain and xlate phantom domain switches are
not populated.
Registration
Brocade_RegisteredProfile is mapped to Brocade_Switch using
Brocade_ElementConformsToProfile association class if edge switch is discovered along with its
backbone.
Figure 38 shows the SNIA Profile Registration model to advertise Inter-Fabric Routing profile.
Brocade Network Advisor SMI Agent classes added for this profile
Table 12 explains the classes and MOF files.
TABLE 12 Classes and MOF file
Class MOF file
Brocade_PCSNetworkPortSettings BrocadePartitioning.mof
Brocade_PCSNetworkPortCapabilities BrocadePartitioning.mof
Brocade_PCSServiceCapabilities BrocadePartitioning.mof
Brocade_EthernetPort BrocadePartitioning.mof
Brocade_PortSettingsForPCSNetworkPort BrocadePartitioning.mof
Brocade_PortCapabilitiesForPCSNetworkPort BrocadePartitioning.mof
Brocade_EthernetPortOfPCSNetworkPort BrocadeEthernet.mof
Brocade_PCSCapabilities BrocadePartitioning.mof
Brocade_EthernetPortInExtender BrocadeExtender.mof
Brocade_SwitchFCPortOfEthernetPort BrocadePartitioning.mof
Limitations
Brocade Network Advisor SMI Agent does not support MEOS switches.
In order to achieve a full topology discovery of edge fabrics, the backbone fabric must be
managed through the Brocade Network Advisor Server. If the backbone fabric is not managed
through the Brocade Network Advisor server, discovery is limited to the topology shown in
Figure 42.
You can modify the PreferredDomainID value for phantom switches only when the associated
backbone fabric is managed through Brocade Network Advisor.
NOTE
The SMI Agent does not support the discovery of an Access Gateway-enabled switch as a seed
switch, using Extrinsic method, except for the Encryption Switch.
Node Port Initialized Virtualization (NPIV) allows a single Fibre Channel port to appear as multiple
distinct ports. It provides a separate port identification and security zoning within the fabric for
each operating system image. Each operating system image has its own unique physical port.
For additional information about Access Gateway, refer to the Access Gateway Administrators
Guide.
For additional information about NPIV, refer to the Fabric OS Administrators Guide.
Registration
Figure 43 shows the SNIA Profile Registration Profile model to advertise the NPIV profile.
When an Access Gateway switch exists with devices attached in the discovered fabric, the
Brocade_RegisteredProfile (N_Port Virtualizer) is mapped to Brocade_AccessGateWay using
Brocade_ElementConformsToProfile association class.
Data model
Figure 44 defines the data model and functions of the AG and NPIV.
NOTE
The port statistics and the port rate statistic information modeled for the AGFCPorts will be
supported from FOS 5.3 onwards.
Access Gateway
When a AG-capable switch is changed to AG, it will not act as a switch and it cannot be directly
discovered through Brocade Network Advisor. The port on the switch that is connected to AG is the
F_Port and the port on AG that has a connection from switch is the N_Port. AG is considered as a
node from the switchs perspective.
As shown in Figure 47, there are two connections from Switch1 to AG. There are two F_Ports on
switch F1 and F2 connected to ports N1 and N2 of AG. The AG is connected to three HBAs, so the
F_Ports F1, F2, and F3 on AG are connected to the ports n1, n2, and n3 of HBA1, HBA2, and HBA3
correspondingly. There is an internal mapping on AG as N1 is mapped with F1 and F2, and N2 is
mapped with F3.
HBA1
n1
AG Switch 1
F1 N1 F1
n2 F2
N2 F2
F3
HBA2
n3
HBA3
FIGURE 47 AG mapping
Switch 1
HBA1
n1
F1
AG
Fabric 1
F1 N1
n2 F2 N2
N3
F3
HBA2 N4
Switch 2
F2
n3
HBA3
Fabric 2
AG with NPIV
Figure 50 represents the AG with NPIV model where the switch is connected to AG and the AG is
connected to HBAs that has one NPIV-enabled device with two virtualized ports.
Figure 51 is the combination of AG and NPIV data models.
HBA1
n1
AG Switch 1
F1 N1 F1
n2 F2
N2 F2
F3
HBA2
n3
Virtualized Ports
HBA3
NPIV Device
Figure 52 shows a simplified instance diagram to illustrate the combination of the AG and NPIV,
and Topology View features
The following Brocade Network Advisor SMI Agent classes are defined in
Brocade_AccessGateway.mof:
Brocade_AccessGateway
Brocade_AGFCPort
Brocade_AGFCPortStats
Brocade_AGFCPortStatisticsCollection
Brocade_AGFCPortRateStats
Brocade_PortRateStatsForAGFCPort
Brocade_PortStatsForAGFCPort
Brocade_AGFCPortStatsInAGFCPortStatisticsCollection
Brocade_AGFCPortStatisticsCollectionForAG
Brocade_AGNode
Brocade_AGSANProtocolEndPoint
Brocade_AGMgmtAccessPoint
Brocade_AGSoftwareIdentity
Brocade_AGWebGUIRemoteAccessPoint
Brocade_AGInFabric
Brocade_AGNodeInAG
Brocade_AGFCPortInAGNode
Brocade_AGFCPortInTrunk
Brocade_PortInAG
Brocade_AGFCPortSANProtocolEndPoint
Brocade_AGHostedSANAccessPoint
Brocade_AGSANActiveConnection
Brocade_AGHostedRemoteAccessPoint
Brocade_AGHostedMgmtAccessPoint
Brocade_AGSANProtocolEndPointLogicalIdentity
Brocade_NodeFCPortDependency
Brocade_EthernetAccessGateway
Brocade_EthernetPortInEthernetAccessGateway
Brocade_EthernetAGInEthernetAdminDomain
Brocade_EthernetAccessGatewayHostedLANEndPoint
Limitations
The following are the limitations of Brocade Network Advisor SMI Agent:
AG on Ethernet switch
- No Brocade_AGFCPort instances are discovered for the Virtual FCoE ports on the Ethernet
AG.
- Brocade_AGSANActiveConnection, Brocade_TopologyView discovery (and related
associations), Brocade_AGSANProtocolEndPointLogicalIdentity,
Brocade_SANActiveConnection, and Brocade_NodeFCPortDependency will not be
complete for the devices attached to the Ethernet AG.
FRU profiles
The Fan, Power Supply, and Sensors (FRU) profiles model discovery of a switch's field-replaceable
units (FRUs).
Registration
Refer to Figure 53 for profile registration details.
Data model
Figure 53 shows the data model with the classes and properties that supports the FRU subprofiles.
Limitations
FRU support for EOS switch is limited. If the mandatory properties cannot be fully populated, those
instances will not be advertised as conforming to the respective profile.
NOTE
The Brocade_NumericSensor returns instances to represent the power usage value for Brocade
6505, 6510 switches, FC 16-32, FC 16-48, FC 8-32E, FC8-48E software Blades, CR16-4, and
CR16-8 core blades which are running on Fabric OS v7.0.1 or later.
Names
Various system objects such as a switch, switch port, device, device port, and so on are identified
by a WWN. For convenience, these system objects may also be assigned a user-friendly name. The
user-friendly name is generally the ElementName property in the instance. This feature provides
the ability to easily discover the user-friendly names for all the system objects.
The following are the functions:
Discovering the list of user-friendly names.
There will be no support for setting of Name for a system object.
Fabric names will not be reported by the Brocade SMI Agent. This is to avoid the conflict where
the fabric and seed or principal switch share the same WWN.
All the detached WWN names are supported by the Brocade SMI Agent.
Data model
A new extrinsic method is defined in the Brocade_Agent class.
Indications 4
In this chapter
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Alert indications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Life-cycle indications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Introduction
The Brocade Network Advisor SMI Agent delivers events in the form of two types of indications:
alert indications and life-cycle indications.
Alert indications are used to represent all fabric events. To receive the alert indications, the clients
must first register with SNMP traps.
Life-cycle indications are delivered by the classes in reaction to a change in the status of a
connection such as, when elements (for example, switch or node) leave or join the fabric.
The Configuration tool allows you to enable mutual authentication for indications. If this is enabled,
all the indications are received over the HTTPS port. By default, the HTTPS is enabled without
mutual authentication.
Alert indications
Table 14 explains the supported alert indications.
FC2 Configuration was enabled, and now this AlertingManagedElement COP of Brocade_Fabric
configuration is the active configuration.
AlertingElementFormat COP
Query: SELECT * FROM
CIM_AlertIndication WHERE AlertType Device Alert
OwningEntity=SNIA and MessageID=FC2
OtherAlertType N/A
How to trigger: Enable the zoning
configuration. You can also do this AlertSubType Config Enabled
through the CLIs zonadd, cfgsave, and
cfgenable. PerceivedSeverity 5 (Major)
ProbableCause 123
SystemCreationClassName Brocade_Fabric
SystemName Fabric WWN
ProviderName Brocade_AlertIndication
Provider
OwningEntity SNIA
Message ZoneSet <ZoneSet
Name> was activated for
fabric <WWN>
MessageArguments ZoneSet name Fabric
WWN
FC5 Change in operational status for switch. AlertingManagedElement COP of Brocade_Switch
Query: SELECT * FROM
AlertingElementFormat COP
CIM_AlertIndication WHERE
OwningEntity=SNIA and MessageID=FC5 AlertType Device Alert
OtherAlertType N/A
AlertSubType Switch modified
PerceivedSeverity 5 (Major)
ProbableCause 123
SystemCreationClassName Brocade_Switch
SystemName Switch WWN
ProviderName Brocade_AlertIndication
Provider
OwningEntity SNIA
Message Switch <Switch Unique
Identifier> in Fabric
<Fabric Name> status
changed to <Switch
OperationalStatus>
MessageArguments Switch WWN, fabric
WWN, switch operational
status
BRCD27 Account is locked out on the switch. This AlertingManagedElement COP of Brocade_Switch
event occurs whenever a switch account
AlertingElementFormat COP
gets locked out.
Query: SELECT * FROM AlertType Security
CIM_AlertIndication WHERE
OwningEntity=BROCADE and OtherAlertType N/A
MessageID=BRCD27 AlertSubType Account locked out
How to trigger: Set the lockout duration
as 1 using the CLI Pasargadae --set for a PerceivedSeverity 2 (Informational)
user account. Attempt to telnet to the ProbableCause 123
switch with a wrong password for that
user account. SystemCreationClassName Brocade_Switch
NOTE: BRCD27 indication is not SystemName Switch WWN
supported for EOS switches.
ProviderName Brocade_AlertIndication
Provider
OwningEntity BROCADE
Message Account for user
<username> was locked
out for Switch <WWN>
MessageArguments Account User Name,
Switch WWN
BRCD28 New user account is added to the switch. AlertingManagedElement COP of Brocade_Switch
Query: SELECT * FROM
AlertingElementFormat COP
CIM_AlertIndication WHERE
OwningEntity=BROCADE and AlertType Security
MessageID=BRCD28
OtherAlertType N/A
How to trigger: Add a new account using
the CLI userconfig. AlertSubType Account added
NOTE: BRCD28 indication is not PerceivedSeverity Informational
delivered for FOS switches, if
SNMP registration fails. ProbableCause 123
SystemCreationClassName Brocade_Switch
SystemName Switch WWN
ProviderName Brocade_AlertIndication
Provider
OwningEntity BROCADE
Message Account for user
<username> was added
for Switch <WWN>
MessageArguments username = string user
name
WWN = string Switch
WWN
BRCD48 A data value is greater than the high AlertingManagedElement COP of Brocade_Switch
threshold boundary.
AlertingElementFormat COP
Query: SELECT * FROM
CIM_AlertIndication WHERE AlertType Other Alert
OwningEntity=BROCADE and
MessageID=BRCD48 OtherAlertType Fabric Watch
SystemCreationClassName Brocade_Switch
SystemName Switch WWN
ProviderName Brocade_AlertIndication
Provider
OwningEntity Brocade
Message Condition= <Threshold
Condition> Value=
<Current value>
RuleName=
<RuleName> Category=
<Category>
MessageArguments <Threshold
Condition>,<Current
value>, <RuleName>,
SEC_VIOLATIONS
BRCD106 Flow vision violation. AlertingManagedElement COP of
Query: SELECT * FROM Brocade_SwitchFcport
CIM_AlertIndication WHERE
AlertingElementFormat COP
OwningEntity=" BROCADE " and
MessageID="BRCD106" AlertType Device
OtherAlertType N/A
AlertSubType MAPS violation
PerceivedSeverity 3 (WARN)
ProbableCause 123
SystemCreationClassName Brocade_SwitchFcport
SystemName Switch WWN
ProviderName Brocade_AlertIndication
Provider
OwningEntity Brocade
Message Condition= <Threshold
Condition> Value=
<Current value>
RuleName=
<RuleName> Category=
<Category>
MessageArguments <Threshold
Condition>,<Current
value>, <RuleName>,
TRAF_PERF
NOTE
For indications from BRCD61 to BRCD76:
All CEE alert indications and life-cycle indications are only applicable for FOS switches (Brocade
8000 switch and FCOE10-24 blade) with versions from v6.4.0. To get all CEE indications, make sure
that CEE indication is enabled in the switch.
NOTE
For indications from BRC103 to BRC109:
SNMP traps must be registered for the switches to receive the indication.
Life-cycle indications
Table 15 explains the supported life-cycle indications.
SELECT * FROM CIM_InstCreation WHERE SourceInstance ISA CIM_InstCreation When new fabric is discovered
Brocade_Fabric
SELECT * FROM CIM_InstDeletion WHERE SourceInstance ISA CIM_InstDeletion When the fabric is deleted
Brocade_Fabric
SELECT * FROM CIM_InstModification WHERE SourceInstance CIM_InstModification The operational status of a switch changes.
ISA Brocade_Switch AND SourceInstance.OperationalStatus
<>PreviousInstance. OperationalStatus
SELECT * FROM CIM_InstModification WHERE SourceInstance CIM_InstModification The operational status of a switch port
ISA CIM_FCPort AND SourceInstance.OperationalStatus changes.
<>PreviousInstance. OperationalStatus
SELECT * FROM CIM_InstModification WHERE SourceInstance CIM_InstModification The enabled state of a switch port changes,
ISA CIM_FCPort AND SourceInstance.EnabledState such as when ISL is unplugged and plugged.
<>PreviousInstance.EnabledState
SELECT * FROM CIM_InstCreation WHERE SourceInstance ISA CIM_InstCreation Applicable for logical switch also.
CIM_ComputerSystem
SELECT * FROM CIM_InstDeletion WHERE SourceInstance ISA CIM_InstDeletion Applicable for ComputerSystem also.
CIM_ComputerSystem
SELECT * FROM CIM_InstCreation WHERE SourceInstance ISA CIM_InstCreation Port is moved from one logical switch to
CIM_FCPort another logical switch.
SELECT * FROM CIM_InstDeletion WHERE SourceInstance ISA CIM_InstDeletion Port is moved from one logical switch to
CIM_FCPort another logical switch.
SELECT * FROM CIM_InstCreation WHERE SourceInstance ISA CIM_InstCreation A device is added to a fabric.
CIM_LogicalPortGroup
SELECT * FROM CIM_InstDeletion WHERE SourceInstance ISA CIM_InstDeletion A device is removed from a fabric.
CIM_LogicalPortGroup
SELECT * FROM CIM_InstCreation WHERE SourceInstance ISA CIM_InstCreation When a blade is inserted or powered on in
CIM_LogicalModule the switch
SELECT * FROM CIM_InstDeletion WHERE SourceInstance ISA CIM_InstDeletion When a blade is removed or powered off
CIM_LogicalModule from the switch
SELECT * FROM CIM_InstModification WHERE SourceInstance Complete Applicable to zoning in
ISA CIM_ConcreteJob AND SourceInstance. CIM_InstModification SessionControlWithJob and
CIM_ConcreteJob::PercentComplete <> ActivateZoneSetWithJob
PreviousInstance.CIM_ConcreteJob::Percent
SELECT * FROM CIM_InstModification WHERE SourceInstance CIM_InstModification Applicable to zoning in
ISA CIM_ConcreteJob AND ANY SessionControlWithJob and
SourceInstance.CIM_ConcreteJob::Operation alStatus[*] = 17 ActivateZoneSetWithJob
AND ANY SourceInstance.CIM_ConcreteJob::Operation
alStatus[*] = 2
SELECT * FROM CIM_InstModification WHERE SourceInstance CIM_InstModification Applicable to zoning in
ISA CIM_ConcreteJob AND ANY SessionControlWithJob and
SourceInstance.CIM_ConcreteJob::Operation alStatus[*] = 17 ActivateZoneSetWithJob
AND ANY SourceInstance.CIM_ConcreteJob::Operation
alStatus[*] = 6
NOTE
Sensors are built in with other FRU elements; and thus InstanceCreation, InstanceDeletion, and
InstanceModification indications are not supported.
When a rule is removed from the ACL policy, indication populates only the sequence number. When
PG ID is removed from CEE map, indication populates only the PG ID. In both the cases, the
indication populates default values for the other properties (priority flow control, bandwidth).
Table 16 lists the Brocade Network Advisor SMI Agent error codes.