Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch QLogic Intelligent Pass-thru Module for IBM BladeCenter QLogic 20-Port SAN Switch Module for IBM BladeCenter QLogic Virtual Fabric Extension Module for IBM BladeCenter Firmware Version 7.x, 8.x, 9.
Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice.
Table of Contents Preface Client Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Supported Profiles and SubProfiles . . . . . . . . . . . . . . . . .
Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch QLGC_LogicalNetwork : CIM_ConnectivityCollection . . . . . . . . . . . . . . . . . QLGC_ProtocolEndpoint : CIM_ProtocolEndpoint . . . . . . . . . . . . . . . . . . . . 3 Fabric Zoning Classes Zoning Discovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Zoning Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Zoning Name Limits . . . . . . .
Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch QLGC_PassThroughMapEntry : CIM_Dependency. . . . . . . . . . . . . . . . . . . QLGC_RegisteredProfile : CIM_RegisteredProfile . . . . . . . . . . . . . . . . . . . QLGC_RegisteredSubProfile : CIM_RegisteredSubProfile . . . . . . . . . . . . .
Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch vi 59223-03 E
Preface This guide describes how the Common Interface Model (CIM) Agent functions as an implementation of the Storage Management Initiative (SMI)-Specification 1.1. This manual provides the supported classes and associations, including custom and overridden properties and methods. It also lists the capabilities and limitations of the CIMAgent at the HTTP, XML, and CIM protocol levels.
Preface Intended Audience The CIMAgent is the primary focus of this manual which is organized as follows: This preface describes the intended audience for this manual, related materials, and technical support. Section 1 describes how to use Switch Management and its classes. Section 2 describes how to use Fabric Discovery. Section 3 describes how to use Fabric Zoning. Section 4 describes how to use Server Support. Section 5 describes how to use Indication Support.
Preface Documentation Conventions Documentation Conventions This guide uses the following documentation conventions: NOTE: provides additional information. CAUTION! indicates the presence of a hazard that has the potential of causing damage to data or equipment. WARNING!! indicates the presence of a hazard that has the potential of causing personal injury.
Preface Supported Profiles and SubProfiles Text in italics indicates terms, emphasis, variables, or document titles. For example: For a complete listing of license agreements, refer to the QLogic Software End User License Agreement. What are shortcut keys? To enter the date type mm/dd/yyyy (where mm is the month, dd is the day, and yyyy is the year).
Preface Technical Support Technical Support Customers should contact their authorized maintenance provider for technical support of their QLogic products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates.
Preface Technical Support Knowledge Base The QLogic knowledge base is an extensive collection of QLogic product information that you can search for specific solutions. We are constantly adding to the collection of information in our knowledge base to provide answers to your most urgent questions. Access the knowledge base from the QLogic Support Center: http://support.qlogic.com.
1 Switch Management Classes The following classes are exclusive to the switch that is hosting the CIMAgent, and are described in the SMI-Specification 1.1 Switch profile. Classes that are common to both the Switch and the Fabric profiles are described in the Fabric Discovery section of this document. QLGC_FCPortStatistics: CIM_FCPortStatistics There will be an instance of FCPortStatistics for every port on the switch.
1–Switch Management Classes QLGC_FCPortStatistics: CIM_FCPortStatistics RXClass3Frames Property will contain the number of class3 FC frames received by the port. TXClass3Frames Property will contain the number of class 3 frames transmitted by the port. RXClass2Frames Property will contain the number of class2 frames received by the port. TXClass2Frames Property will contain the number of class2 frames transmitted by the port.
1–Switch Management Classes QLGC_FCPortStatistics: CIM_FCPortStatistics ResetSelectedStats() Reset ALL the counters for the port to zero. Parameters: SelectedStatistics: [required] Must be [“ALL”] or [“All”] Returns: 0 - Success 1 - Not Supported 5 - Invalid Parameter: Invalid SelectedStatistics parameter, not in [“ALL”|”All”]. 6 - Access Denied: Switch is being configured by another user. Request Status Codes: CIM_ERR_INVALID_PARAMETER: One or more required parameters are missing.
1–Switch Management Classes QLGC_FCPortRateStatistics : CIM_FCPortRateStatistics QLGC_FCPortRateStatistics : CIM_FCPortRateStatistics There will be an instance of FCPortRateStatistics for every port on the switch. All rate values will be NULL until the first full sample interval after a counter reset has completed. Rates are calculated by sampling counters at regular intervals. Polling for RateStatistics more than once per interval will result in duplicate rate values.
1–Switch Management Classes QLGC_StatisticsCollection : CIM_StatisticsCollection QLGC_StatisticsCollection : CIM_StatisticsCollection The model will contain a single StatisticsCollection which may be used to retrieve all port statistics for the switch hosting the CIMAgent in a single Associators() call.
1–Switch Management Classes QLGC_PhysicalIOBlade : CIM_PhysicalPackage Manufacturer If the switch is re-branded, this property will contain the name of the branding vendor, otherwise it will default to “QLogic Corporation”. Model Property will contain the FRU Type mnemonic identifying the IO blade. PartNumber Property will contain a string that matches the planar part number printed on blade. PackageType Property will contain the enumerated value 16=Blade.
1–Switch Management Classes QLGC_PhysicalChassis : CIM_PhysicalPackage QLGC_PhysicalChassis : CIM_PhysicalPackage The embedded CIMAgent will report a single physical chassis instance representing the framework on which the hosting switch components are mounted.
1–Switch Management Classes QLGC_Product : CIM_Product QLGC_Product : CIM_Product Product models the combination of hardware and software that make up the Switch. The embedded CIMAgent will report a single product instance representing the switch hosting the agent. Supported Properties and Methods IdentifyingNumber Property will contain the switch serial number as printed on the chassis. Name Property will contain the commonly known name of the product.
1–Switch Management Classes QLGC_SoftwareIdentity : CIM_SoftwareIdentity QLGC_SoftwareIdentity : CIM_SoftwareIdentity Software Identity is used here to identify the firmware revision on the switch. The CIMAgent only reports firmware information for its hosting switch. Only the active firmware version is reported.
1–Switch Management Classes QLGC_Location : CIM_Location Supported WBEM Operations getClass getInstance enumerateInstances enumerateInstanceNames Associations QLGC_FCSwitchSoftware : CIM_InstalledSoftwareIdentity — 1to1 relationship to QLGC_FCSwitch QLGC_ProfileElementSoftwareIdentity : CIM_ElementSoftwareIdentity — 1toMany relationship to all instances of QLGC_RegisteredProfile QLGC_SubProfileElementSoftwareIdentity : CIM_ElementSoftwareIdentity — 1toMany relationship to all ins
1–Switch Management Classes QLGC_FCPortCapabilities : CIM_FCPortCapabilities QLGC_FCPortCapabilities : CIM_FCPortCapabilities There will be an instance of FCPortCapabilities for every port on the switch hosting the CIMAgent. This class is used to determine the configuration options for an FCPort. Port capabilities will vary by port, and may change for a given port as a result of hardware or license changes.
1–Switch Management Classes QLGC_FCPortCapabilities : CIM_FCPortCapabilities AutoSenseSpeedConfigurable Property will contain a boolean value that will be TRUE if the FCPortConfig.AutoSenseSpeed property may be configured, or FALSE if the property is read-only. RequestedTypesSupported Property will contain an array of one or more acceptable values for the FCPortConfig.RequestedType property. Possible values are: 2-G: Port may act as an E or F port. 3-GL: Port may act as an E, F, or FL port.
1–Switch Management Classes QLGC_FCPortSettings : CIM_FCPortSettings DeviceScanConfigurable Property will contain a boolean value that will be TRUE when the FCPortSettings.DeviceScan property may be edited, or FALSE if the property is read-only.
1–Switch Management Classes QLGC_FCPortSettings : CIM_FCPortSettings If AutoSenseSpeed is set to TRUE, then changes to this property will be ignored. As a result, the AutoSenseSpeed property should be disabled BEFORE the RequestedSpeed property is changed, or they should both be changed at the same time. AutoSenseSpeed Property will contain a boolean value indicating if the port is configured to AutoSense the speed. This property overrides the RequestedSpeed property.
1–Switch Management Classes QLGC_FCPortSettings : CIM_FCPortSettings RequestedPerformanceTuningMode Property will contain the configured Performance Tuning mode. The operational Performance Tuning mode is reported by FCPort.PerformanceTuning property. Valid values for this property are reported by the SupportedPerformanceTuningModes property of the corresponding FCPortCapabilities instance. Supported values are: 1 – AutoSense 2 – None 3 – MFS: Multi-frame sequence interleaving is suppressed.
1–Switch Management Classes QLGC_FCSwitchCapabilities : CIM_EnabledLogicalElementCapabilities QLGC_FCSwitchCapabilities : CIM_EnabledLogicalElementCapabilities There will be one instance of FCSwitchCapapilities representing the configuration capabilities of the switch hosting the CIMAgent. Switch capabilities may change over time as a result of hardware or license, or operating mode changes.
1–Switch Management Classes QLGC_FCSwitchCapabilities : CIM_EnabledLogicalElementCapabilities DomainIDLockedSupported Property will contain a boolean value that will be TRUE then the CIM_FCSwitchSettings.DomainIDLocked property may be edited, or FALSE if the property is read-only. PrincipalPrioritiesSupported Property will contain an array of one or more acceptable values for the CIM_FCSwitchSettings.PrincipalPriority property.
1–Switch Management Classes QLGC_FCSwitchSettings : CIM_FCSwitchSettings QLGC_FCSwitchSettings : CIM_FCSwitchSettings There will be one instance of FCSwitchCapabilities representing the configuration of the switch hosting the CIMAgent. Supported Properties and Methods InstanceID Opaque Identifier ElementName Property will contain the string “FC Switch Settings” PreferredDomainID Property will contain the configured domainID.
1–Switch Management Classes QLGC_LogicalIOBlade : CIM_LogicalIOBlade Supported WBEM Operations getClass getInstance enumerateInstances enumerateInstanceNames modifyInstance setProperty Associations QLGC_FCSwitchElementSettingData : CIM_ElementSettingData — 1to1 relationship to QLGC_FCSwitch QLGC_LogicalIOBlade : CIM_LogicalIOBlade QLGC_LogicalIOBlade is a logical representation of an IO blade on the switch. Blade information is only available for the switch hosting the CIMAgent.
1–Switch Management Classes QLGC_LogicalIOBlade : CIM_LogicalIOBlade And optionally, one of the following enumerated state values. 08-Starting: Blade has been inserted, or enabled. 09-Stopping: Blade has been turned off, and is shutting down. 10-Stopped: Blade has been turned off (presumably for removal). 15-Dormant: Blade has been disabled. 11-InService: The Blade is in diagnostic mode A healthy blade working normally will report the array [02] for this property.
1–Switch Management Classes QLGC_LogicalIOBlade : CIM_LogicalIOBlade Parameters: RequestedState [required] Parameter must be one of the following enumerated values. 2-Enabled: Blade is online. 3-Disabled: Blade is offline 7-Test: Blade is in diagnostics mode. 11-Reset: Blade will be reset. 32768-PoweredOff: Blade will be powered off, and the CIMAgent will no longer report the blade object until is it powered on again (or re-inserted). Job Ignored, command is synchronous.
1–Switch Management Classes QLGC_RemoteServiceAccessPoint : CIM_RemoteServiceAccessPoint Associations QLGC_LogicalIOBladeFCPort : CIM_ModulePort — 1toMany relationship to QLGC_FCPort QLGC_RealizesLogicalIOBlade : CIM_Realizes — 1to1 relationship to QLGC_PhysicalIOBlade QLGC_FCSwitchLogicalIOBlade : CIM_SystemDevice — 1to1 relationship to the local QLGC_FCSwitch instance.
1–Switch Management Classes QLGC_RemoteServiceAccessPoint : CIM_RemoteServiceAccessPoint AccessInfo Property will contain the a string value using standard URI syntax, except for the ethernet interface which is simply the ipaddr.
1–Switch Management Classes CIM_ConfigurationData : CIM_SettingData Associations QLGC_FCSwitchAccessPoint : CIM_HostedAccessPoint — Manyto1 relationship to QLGC_FCSwitch QLGC_SAPAvailableForFCSwitch : CIM_SAPAvailableForElement — Manyto1 relationship to QLGC_FCSwitch CIM_ConfigurationData : CIM_SettingData This class is used to retrieve and restore the current switch configuration image. The configuration image includes the local zoning database and all switch configuration settings.
1–Switch Management Classes CIM_ConfigurationData : CIM_SettingData Returns: 0: Success 5: Invalid Parameter. One or more parameters do not conform to the parameter limitations above. 16000: Validate Only Request Not Supported; ValidateOnly must be FALSE 16001: ConfigurationData is invalid; Validation failure during while applying configuration.
1–Switch Management Classes CIM_ConfigurationData : CIM_SettingData 1-26 59223-03 E
2 Fabric Discovery Classes The CIMAgent is able to provide information about all the switches and ports in the fabric by querying the management server and name server on other switches in the fabric. If the management server is disabled or incompletely implemented on the remote switches, a truncated fabric will be reported. The following classes are described in the SMI-Specification 1.1.0 Fabric profile. QLGC_SAN : CIM_AdminDomain The SAN object aggregates multiple fabrics.
2–Fabric Discovery Classes QLGC_Fabric : CIM_AdminDomain QLGC_Fabric : CIM_AdminDomain This distribution supports a single fabric per switch, so there will be a one to one relationship between the sole SAN and Fabric objects. Supported Properties and Methods CreationClassName Property will contain the string “QLGC_Fabric” Name Property will contain the WWN of the principal switch in the fabric.
2–Fabric Discovery Classes QLGC_FCNode : CIM_LogicalPortGroup QLGC_FCNode : CIM_LogicalPortGroup A host or storage device model will have an FCNode (possibly an HBA) that aggregates one or more FCPorts. A device may contain multiple FCNodes. All FCNodes are hosted by the Fabric object as the switch is usually unable to determine valid information about the actual ComputerSystem hosting the nodes.
2–Fabric Discovery Classes QLGC_FCPort : CIM_FCPort QLGC_FCPort : CIM_FCPort There are three distinct groups of FCPort objects: Local Switch Ports These are the ports that are attached to the switch that hosts the CIMAgent. Ports that are not licensed or not installed or, in the case of a blade about to be removed, powered off are not instantiated. Remote Switch Ports These are ports on other switches in the fabric.
2–Fabric Discovery Classes QLGC_FCPort : CIM_FCPort NetworkAddresses (Local/Remote)Property will be NULL (NS)Property will contain the FibreChannel address identifier (FCID) formatted as 6 uppercase hex digits. OperationalStatus Operational Status is an array containing a single value as follows. It represents the operational status of the port, not the configured port settings. Supported values are: (Local/Remote) 00-Unknown: Remote port state is unknown, and/or port is not installed.
2–Fabric Discovery Classes QLGC_FCPort : CIM_FCPort PortNumber (Local): Property will contain a value that matches the label on the switch. Port number is zero based. (Remote): Property will contain the “Physical Port Number” reported by the fabric configuration server on the remote switch.
2–Fabric Discovery Classes QLGC_FCPort : CIM_FCPort (Remote) 0 Unknown (NS) NULL SupportedCOS Property will contain an array of 0..N supported classes of service for a port on an attached device (NS port). It will be NULL for switch ports. SupportedFC4Types Property will contain an array of 0..N supported FC4 Types for a port on an attached device (NS port). It will be NULL for switch ports. EnabledState (Local) Property will contain the current port enabled state.
2–Fabric Discovery Classes QLGC_FCPort : CIM_FCPort Parameters: RequestedState: [required] A port specific array of valid values may be found in the FCPortCapabilities.RequestedStatesSupported property. Parameter must be one of the following enumerated values. 2-Enabled: Port is online. 3-Disabled: Port is offline 7-Test: Port is in diagnostics mode. 11-Reset: Port will be reset. Job: Ignored, command is synchronous.
2–Fabric Discovery Classes QLGC_FCPort : CIM_FCPort IOStreamGuardState (Local Only) Property will contain an enumerated value representing the operational state of the port IOStreamGuard feature. The property is used to detect what state the port is using when the FCPortSettings.IOStreamGuard property has been set to 1-AutoDetect. Supported values are: 2 - Enable: Suppresses the reception of RSCN messages from other ports for which I/O Stream Guard is enabled.
2–Fabric Discovery Classes QLGC_FCPort : CIM_FCPort Supported WBEM Operations getClass getInstance enumerateInstances enumerateInstanceNames Associations 2-10 QLGC_FCPortStatisticalData : CIM_ElementStatisticalData — 1to1 relationship to QLGC_FCPortStatistics (Local only) QLGC_FCPortRateStatisticalData : CIM_ElementStatisticalData — 1to1 relationship to QLGC_FCPortRateStatistics (Local only) QLGC_DeviceSAPImplementation : CIM_DeviceSAPImplementation — 1to1 relationship to QLGC_
2–Fabric Discovery Classes QLGC_FCSwitch : CIM_ComputerSystem QLGC_FCSwitch : CIM_ComputerSystem The switch “System” is represented by an instance of FCSwitch. This class is required in both the fabric profile and the switch profile. Supported Properties and Methods CreationClassName Property will contain the string “QLGC_FCSwitch” Name Property will contain the switch WWN. ElementName Property will contain the Switch Symbolic Name. The property may be edited if FCSwitchCapabilities.
2–Fabric Discovery Classes QLGC_FCSwitch : CIM_ComputerSystem IdentifyingDescriptions Property will contain an array with a single string value of “DomainID”. This corresponds with the OtherIdentifyingInfo property that contains the domainID of the switch. Dedicated Property will contain the enumerated value 5=Switch; identifying this instance of CIM_ComputerSystem as a Switch. EnabledState Property will contain the current port enabled state.
2–Fabric Discovery Classes QLGC_FCSwitch : CIM_ComputerSystem 11-Reset: Switch will perform a hard reset. Job: Ignored, command is synchronous. TimeoutPeriod, must be zero second interval, or NULL, command is synchronous. Returns: 0 - Success 6 - In Use: Switch is being configured by another user. 4097 - Invalid State Transition: RequestedState parameter value is out of range.
2–Fabric Discovery Classes QLGC_FCSwitch : CIM_ComputerSystem QLGC_FCSwitchSoftware : CIM_InstalledSoftwareIdentity — 1to1 relationship to QLGC_SoftwareIdentity QLGC_FCSwitchPackage : CIM_ComputerSystemPackage — 1to1 relationship to QLGC_PhysicalChassis QLGC_FabricFCSwitch : CIM_Component — ManyTo1 relationship to QLGC_Fabric QLGC_FCSwitchFCPort : CIM_SystemDevice — 1toMany relationship to QLGC_FCPort QLGC_FCSwitchAccessPoint : CIM_HostedAccessPoint — 1toMany relationship to QLGC_RemoteS
2–Fabric Discovery Classes QLGC_LogicalNetwork : CIM_ConnectivityCollection QLGC_LogicalNetwork : CIM_ConnectivityCollection This class is useful as a means to quickly access all the Fibre Channel specific instances of ProtocolEndpoint in the fabric. Supported Properties and Methods InstanceID Opaque identifier ElementName Property will contain the WWN of the principal switch in the fabric.
2–Fabric Discovery Classes QLGC_ProtocolEndpoint : CIM_ProtocolEndpoint QLGC_ProtocolEndpoint : CIM_ProtocolEndpoint The two ends of a Fibre Channel link are represented by protocol endpoints associated together by an instance of ActiveConnection. Only FCPorts that are ONLINE will be associated with a protocol endpoint.
2–Fabric Discovery Classes QLGC_ProtocolEndpoint : CIM_ProtocolEndpoint Associations 59223-03 E QLGC_ActiveConnection : CIM_ActiveConnection — 1to1 relationship to QLGC_ProtocolEndpoint QLGC_DeviceSAPImplementation : CIM_DeviceSAPImplementation — 1to1 relationship to QLGC_FCPort (online ports only) QLGC_FabricProtocolEndPoint : CIM_HostedAccessPoint — ManyTo1 relationship to QLGC_Fabric (NS ports) QLGC_FCSwitchProtocolEndPoint : CIM_HostedAccessPoint — ManyTo1 relationship to QLGC_FCSwitch
2–Fabric Discovery Classes QLGC_ProtocolEndpoint : CIM_ProtocolEndpoint 2-18 59223-03 E
3 Fabric Zoning Classes The following classes are described in the SMI-Specification 1.1.0 Fabric profile. Zoning Discovery The CIMAgent supports discovery of the Active Zoneset and the local Zoning Database. The active zoneset shows the zoning configuration that is currently being enforced by all switches in the fabric. The zoning database contains saved zonesets that may be edited and or activated.
3–Fabric Zoning Classes Zoning Name Limits 1. Locate the “Fabric” profile (CIM_RegisteredProfile). 2. Follow the CIM_ElementConformsToProfile association to the fabric CIM_AdminDomain object that will be associated with the active zoneset and zone objects. Zoning Name Limits The CIMAgent supports names for zones, zone aliases, and zoneset with the following character set: alphanumeric characters, “^”, “$”, “-”, and “_”. The maximum name length is 64 characters.
3–Fabric Zoning Classes QLGC_ZoningService : CIM_ZoneService MaxNumZonesPerZoneset Property will contain the maximum number of zones that a zoneset may contain. ZoneNameMaxLen Property will contain the numeric value 64. This property is the maximum number of characters allowed in an alias, zoneset, or zone names. ZoneNameFormat Property will contain the enumerated value 3-AlphaNumeric. This property applies to the alias, zoneset, and zone names.
3–Fabric Zoning Classes QLGC_ZoningService : CIM_ZoneService SystemName Property will contain the switch WWN. Name Property will contain the switch WWN RequestedSessionState Property will contain the enumerated value 5=NotApplicable. Sessions are not supported. OperationalStatus Property will contain the enumerated value 2=OK SessionState Property will contain the enumerated value 5=No Change. Applicable. Sessions are not supported.
3–Fabric Zoning Classes QLGC_ZoningService : CIM_ZoneService Returns: 0 - Success 4 - Failed: Illegal zoneset, other fabric error. 5 - Invalid Parameter: Cannot activate the active zoneset object. 6 - Access Denied: Switch is being configured by another user. 7 – Not Found: Referenced zoneset was not found. Request Status Codes: CIM_ERR_ACCESS_DENIED: User does not have authorization for this command. CIM_ERR_INVALID_PARAMETER: One or more required parameters are missing.
3–Fabric Zoning Classes QLGC_ZoningService : CIM_ZoneService Request Status Codes: CIM_ERR_ACCESS_DENIED: User does not have authorization for this command. CIM_ERR_INVALID_PARAMETER: One or more required parameters are missing. CIM_ERR_NOT_FOUND: The ZoningService instance was not found. CreateZoneSet Method will create a zoneset in the zoning database. The output parameter “ZoneSet” will contain a reference to the newly created zoneset object.
3–Fabric Zoning Classes QLGC_ZoningService : CIM_ZoneService CreateZone Method will create a zone in the zoning database. The output parameter “Zone” will contain a reference to the newly created zone object. Parameters: ZoneName: [required] Name of zone to be created. Must be unique within the zoning database. ZoneType: [required] Must contain the value 2=Default. (A soft zone is created) ZoneSubType: [optional] Ignored, subtype does not apply to default type.
3–Fabric Zoning Classes QLGC_ZoningService : CIM_ZoneService Returns: 0 - Success 4 - Failed 5 – Invalid Parameter: May not configure Active zone. 6 - Access Denied: Switch is being configured by another user. 7 - Not Found: Referenced zone or zone alias was not found. 8 - Already ExistsZone already contains referenced Alias. Request Status Codes: CIM_ERR_ACCESS_DENIED: User does not have authorization for this command. CIM_ERR_INVALID_PARAMETER: One or more required parameters are missing.
3–Fabric Zoning Classes QLGC_ZoningService : CIM_ZoneService AddZoneMembershipSettingData Method will add a zone member to an alias or zone in the zoning database by creating an instance of association class CIM_ElementSettingData linking the zone member to the alias or zone. The zone member must already exist before this method is called. Parameters: SystemSpecificCollection: [required] Reference to the zone or zone alias the zone member will be added to.
3–Fabric Zoning Classes QLGC_ZoningService : CIM_ZoneService Parameters: ConnectivityMemberType[required] Enumerated type of zone member being created. 2=Permanent Address (Device Port WWN) 3=Network Address (Device Port FCID) 4=SwitchPort ID (Switch Domain/Port) ConnectivityMemberID: [required] String identifying the zone member. The format is dependent on the ConnectivityMemberType.
3–Fabric Zoning Classes QLGC_ZoningService : CIM_ZoneService Request Status Codes: CIM_ERR_ACCESS_DENIED: User does not have authorization for this command. CIM_ERR_INVALID_PARAMETER: One or more required parameters are missing. CIM_ERR_NOT_FOUND: The ZoningService instance was not found. CIM_ERR_FAILED: If the response is an error message containing an instance of CIM_Error and CIM_Error.MessageID=FC5 – ZoningObject already exists The zone member already exists.
3–Fabric Zoning Classes QLGC_ZoneSet : CIM_ZoneSet QLGC_ZoneSet : CIM_ZoneSet A zoneset aggregates zones into a single logical unit. There may be one instance of zoneset marked as Active to represent the active zoneset associated with the fabric. All other instances of zoneset are stored in the zoning database on the switch.
3–Fabric Zoning Classes QLGC_Zone : CIM_Zone QLGC_Zone : CIM_Zone A zone is a named group of ports or devices that can communicate with each other. Active zones will be associated with the fabric object, whereas inactive zones will be associated with the switch object. Supported Properties and Methods InstanceID Opaque Active Property will contain a boolean value that will be TRUE if the zone object participates in the active zoneset, or false if the zone object is from the zoning database.
3–Fabric Zoning Classes QLGC_ZoneAlias : CIM_NamedAddressCollection QLGC_MemberOfZone : CIM_MemberOfCollection — 1ToMany relationship to QLGC_ZoneAlias QLGC_ZoneElementSettingData : CIM_ElementSettingData — ManyToMany relationship to QLGC_ZoneMembership QLGC_ZoneAlias : CIM_NamedAddressCollection A zone alias is a collection of 1 or more related zone members which may be added to a zone in the zoning database. The active zoneset and zones won't contain any zone aliases.
3–Fabric Zoning Classes QLGC_ZoneMembership : CIM_ZoneMembershipSettingData QLGC_ZoneMembership : CIM_ZoneMembershipSettingData A zone member represents either a device in the fabric, or a port on a switch. In the latter case, all devices connected to the port on the switch will participate in the zone. Multiple zones (or zone aliases) may contain identical zone members, effectively identifying the same zoning element (port, device, etc.).
3–Fabric Zoning Classes QLGC_ZoneMembership : CIM_ZoneMembershipSettingData Associations 3-16 QLGC_ZoneElementSettingData : CIM_ElementSettingData — ManyToMany relationship to QLGC_Zone QLGC_ZoneAliasElementSettingData : CIM_ElementSettingData — ManyToMany relationship to QLGC_ZoneAlias 59223-03 E
4 Server Support Classes The following classes are described in the SMI-Specification 1.1 server profile. These classes may be used to discover the capabilities of the CIMAgent. All profiles including the Server profile are implemented in the namespace: “root/switch” (firmware versions 7.x and 8.x) and “root/interop” (firmware version 9.x). QLGC_Namespace : CIM_Namespace There will be one instance of QLGC_Namespace representing the sole namespace supported by the CIMAgent.
4–Server Support Classes QLGC_ObjectManager : CIM_ObjectManager Supported WBEM Operations getClass getInstance enumerateInstances enumerateInstanceNames Associations QLGC_NamespaceInManager : CIM_NamespaceInManager — 1To1 relationship to QLGC_ObjectManager QLGC_ObjectManager : CIM_ObjectManager There will be one instance of ObjectManager representing the CIMAgent.
4–Server Support Classes QLGC_CIMXMLCommunicationMechanism : Supported WBEM Operations getClass getInstance enumerateInstances enumerateInstanceNames Associations QLGC_FCSwitchObjectManager : CIM_HostedService — 1To1 relationship to QLGC_FCSwitch QLGC_NamespaceInManager : CIM_NamespaceInManager — 1To1 relationship to QLGC_Namespace QLGC_CIMXMLCommMechanismForManager : CIM_CommMechanismForManager — 1To1 relationship to QLGC_CIMXMLCommunicationMechanism QLGC_ManagerConformsToPr
4–Server Support Classes QLGC_CIMXMLCommunicationMechanism : MultipleOperationsSupported Property will contain the value FALSE. The CIMAgent doesn't support multiple operation requests. AuthenticationMechanismsSupported Property will contain the following array of enumerated values: [3=basic]. Enable SSL to encrypt login information. Version Property will contain the version string “1.1” representing the version of the CIM over XML specification implemented by the CIMAgent.
4–Server Support Classes QLGC_RegisteredProfile : CIM_RegisteredProfile QLGC_RegisteredProfile : CIM_RegisteredProfile There will be one instance of RegisteredProfile for each of the CIM profiles supported by the CIMAgent. Supported Properties and Methods InstanceID Opaque RegisteredOrganization Property will contain enumerated value 11=SNIA RegisteredName Property will contain one of the following supported profile names “Fabric”, “Server”, and “Switch”.
4–Server Support Classes QLGC_RegisteredSubProfile : CIM_RegisteredSubProfile QLGC_RegisteredSubProfile : CIM_RegisteredSubProfile There will be one instance of RegisteredSubProfile for each of the CIM sub-profiles supported by the CIMAgent. Supported Properties and Methods InstanceID Opaque RegisteredOrganization Property will contain enumerated value 11=SNIA.
5 Indication Support Classes The CIMAgent only supports all indications required by the SMI-Specification for the Switch and Fabric profiles. Indication Registration limitations are: 32 cimlisteners may be created 16 subscriptions per Listener HealthState Indications are not supported at this time, as the value reported is the result of the switch POST, and will not change during operation.
5–Indication Support Classes CIM_IndicationSubscription Destination Property must contain a valid URI indicating the TCP address and port number of the listener. Host name lookup is not supported. The scheme must be either “http” or “https”. Format: _://:[/] Examples: _http://10.0.0.1:12000 _ _https://10.0.0.
5–Indication Support Classes CIM_IndicationSubscription OnFatalErrorPolicay This property is ignored on creation. Its value will always be 2 (Ignore). An indication will be dropped if the CIMAgent is unable to transmit it to the listener. SubscriptionState Supported Values are: 2 - Enabled 4 - Disabled IndicationSubscriptions may not be "modified" via the CIM interface, so there is little point in creating a "Disabled" IndicationSubscription, as it may not be enabled.
5–Indication Support Classes CIM_IndicationFilter CIM_IndicationFilter Indication filters are statically defined and may not be modified. There will be one each instance of CIM_IndicationFilter for the WQL and the CQL version of the supported requests. Supported Properties and Methods SystemCreationClassName Property will contain "QLGC_FCSwitch" SystemName Property will contain the WWN of the switch hosting the CIMAgent.
5–Indication Support Classes Predefined Filters Predefined Filters The CIMAgent supports the following pre-defined filters. Create:ComputerSystem WQL: SELECT * FROM CIM_InstCreation WHERE SourceInstance ISA CIM_ComputerSystem CQL: SELECT * FROM CIM_InstCreation WHERE SourceInstance ISA CIM_ComputerSystem An indication will be thrown whenever a switch is added to the fabric as seen by the switch hosting the CIMAgent.
5–Indication Support Classes Predefined Filters Delete:FCPort WQL: SELECT * FROM CIM_InstDeletion WHERE SourceInstance ISA CIM_FCPort CQL: SELECT * FROM CIM_InstDeletion WHERE SourceInstance ISA CIM_FCPort An indication will be thrown whenever a device is removed from the nameserver. Removing a switch from the fabric will not cause a Delete:FCPort indication for each of the new switch ports, however it will cause Delete:FCPort indications for all the devices attached to the removed switch.
5–Indication Support Classes Predefined Filters Alert:All CQL:SELECT * FROM CIM_AlertIndication An indication will be thrown whenever any Alert occurs. This is not in itself an alert but rather a method for specifying a wildcard. Alert:SNIA:Core1 CQL:SELECT * FROM CIM_AlertIndication WHERE OwningEntity=SNIA and MessageID='Core1' An indication will be thrown whenever a redundancy-related condition has occurred.
5–Indication Support Classes Predefined Filters Alert:Core12 CQL:SELECT * FROM CIM_AlertIndication WHERE OwningEntity=SNIA and MessageID='Core12' An indication will be thrown whenever a port has changed status. The following port status changes are reported: unknown, other, Ok, Degraded, Stressed, Predictive, Failure, Error, Non-Recoverable Error, Starting.
A Appendix This Appendix describes the following SLP support, advertised profiles, state changes, limitations, HTTP operations, and Fibre Channel Transparent Mode (FC-T mode). SLP Support SLP (SA) support is integrated into the CIMAgent. As long as the switch is turned on and the CIM service is enabled, the CIMAgent will advertise its' presence and respond to requests for service. Ipv6 support was added as defined in RFC 3111.
A–Appendix CIM Operations over HTTP The default registration timeout is 130 seconds. The DA may require a larger timeout which would then be used for that DA. CIM Operations over HTTP The following tables describe the CIM operation over HTTP. Table A-1. Connecting to the Switch Parameter Namespace Description root/switch (firmware version 7.x, 8.x) root/interop (firmware version 9.
A–Appendix Fibre Channel Transparent Mode Table A-3. HTTP Support Parameter Description Supported Versions HTTP 1.0 and HTTP 1.1 Supported Character Sets utf-8 Supported Languages en-us Authentication Basic (Digest authentication is NOT supported) Chunking Supported Pipelining Supported Max Client Connections 8 All requests are handled serially in order of receipt. Parallel processing of requests is not supported. Table A-4. CIM/XML Support Parameter Description Supported Versions 1.
A–Appendix Fibre Channel Transparent Mode Class Changes New Classes QLGC_PassThroughMapEntry Modified Classes QLGC_FCPortCapabilities QLGC_FCPortSettingData QLGC_FCPort QLGC_FCSwitch QLGC_RegisteredProfile QLGC_RegisteredSubProfile Removed Classes A-4 QLGC_SAN QLGC_ContainedDomain QLGC_Fabric QLGC_FCNode QLGC_ProtocolEndPoint QLGC_ZoningCapabilities QLGC_ZoningService QLGC_Zoneset QLGC_Zone QLGC_ZoneAlias QLGC_ZoneMembership 59223-03 E
A–Appendix QLGC_FCSwitch : CIM_ComputerSystem QLGC_FCSwitch : CIM_ComputerSystem FC-Switch specific properties have been removed in FC-T mode. Redefined Properties and Methods Dedicated Property will contain an array with the single enumerated value 2-Other. OtherDedicatedDescriptions Property will contain an array with the single string value "FC-T Switch" IdentifyingDescriptions Property will be NULL. Description Property will contain the string "FC-T Switch" OtherIdentifyingInfo Property will be NULL.
A–Appendix QLGC_FCPortCapabilities : CIM_FCPortCapabilities QLGC_FCPortCapabilities : CIM_FCPortCapabilities Only translated port types (TH and TF) are supported in FC-T mode. Redefined Properties and Methods RequestedTypesSupported Property will contain an array of one or more acceptable values for the FCPortConfig.RequestedType property. The possible values are: 16001-TH: Port may act as a translated host port. 16002-TF: Port may act as a translated fabric port.
A–Appendix QLGC_RegisteredProfile : CIM_RegisteredProfile QLGC_RegisteredProfile : CIM_RegisteredProfile Fabric profile is removed in FC-T mode. Redefined Properties and Methods RegisteredName Property will contain one of the following supported profile names: “Server”, and “Switch”. QLGC_RegisteredSubProfile : CIM_RegisteredSubProfile Fabric SubProfiles have been removed in FC-T mode.
A–Appendix QLGC_RegisteredSubProfile : CIM_RegisteredSubProfile A-8 59223-03 E
Index A Active Zoneset 3-1 C CIM_AdminDomain 2-1, 2-2 CIM_CIMXMLCommunicationMechanism 4-3 CIM_ComputerSystem 2-11 CIM_ConfigurationData 1-24 CIM_ConnectivityCollection 2-15 CIM_EnabledLogicalElementCapabilities 1-16 CIM_FCPort 2-4 CIM_FCPortCapabilities 1-11 CIM_FCPortSettings 1-13 CIM_FCSwitchSettings 1-18 CIM_IndicationFilter 5-4 CIM_IndicationSubscription 5-2 CIM_ListenerDestinationCIMXML 5-1 CIM_Location 1-10 CIM_LogicalIOBlade 1-19 CIM_LogicalPortGroup 2-3 CIM_NamedAddressCollection 3-14 CIM_Namespac
Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch Q QLGC_CIMXMLCommunicationMechanism 4-3 QLGC_Fabric 2-2 QLGC_FCNode 2-3 QLGC_FCPort 2-4 QLGC_FCPortCapabilities 1-11 QLGC_FCPortSettings 1-13 QLGC_FCSwitch 2-11 QLGC_FCSwitchCapabilities 1-16 QLGC_FCSwitchSettings 1-18 QLGC_Location 1-10 QLGC_LogicalIOBlade 1-19 QLGC_LogicalNetwork 2-15 QLGC_Namespace 4-1 QLGC_ObjectManager 4-2 QLGC_PhysicalChassis 1-7 QLGC_PhysicalIOBlade 1-5 QLGC_Product 1-8 QLGC_ProtocolEndpoint 2-16 QLGC_Regist
Corporate Headquarters QLogic Corporation 26650 Aliso Viejo Parkway Aliso Viejo, CA 92656 949.389.6000 www.qlogic.com International Offices UK | Ireland | Germany | France | India | Japan | China | Hong Kong | Singapore | Taiwan © 2000-2011 QLogic Corporation. Specifications are subject to change without notice. All rights reserved worldwide. QLogic, the QLogic logo, QuickTools, and Enterprise Fabric Suite are trademarks or registered trademarks of QLogic Corporation.
