Download
Share
Print this page
Qlogic 3000 Series Reference Manual
  1. Manuals
  2. Brands
  3. Qlogic Manuals
  4. Switch
  5. 3000 Series
  6. Reference manual

Qlogic 3000 Series Reference Manual

Fibre channel switch
Hide thumbs Also See for 3000 Series:

Advertisement

Quick Links

Download this manual See also: User Manual
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.x
59223-03 E

Advertisement

loading
Need help?

Need help?

Do you have a question about the 3000 Series and is the answer not in the manual?

Questions and answers

Related Manuals for Qlogic 3000 Series

Summary of Contents for Qlogic 3000 Series

  • Page 1 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.x 59223-03 E...

  • Page 2: Revision History

    QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification.

  • Page 3: Table Of Contents

    Table of Contents Preface Client Considerations ......... . Intended Audience .
  • Page 4 Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch QLGC_LogicalNetwork : CIM_ConnectivityCollection ....2-15 QLGC_ProtocolEndpoint : CIM_ProtocolEndpoint ....
  • Page 5 Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch QLGC_PassThroughMapEntry : CIM_Dependency....QLGC_RegisteredProfile : CIM_RegisteredProfile ....
  • Page 6 Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch 59223-03 E...

  • Page 7: Preface

    HBA. A client should use durable identifiers to manage physical devices in the fabric. The Secure Socket Layer (SSL) capability is not supported on all QLogic switch models. Where it is supported, SSL is an option that may be enabled or disabled.

  • Page 8: Intended Audience

    Intended Audience The primary audience for this document is software developers building a management client for QLogic switches. The reader is expected to be familiar with the SMI-Specification (rev 1.1) and have access to the referenced DMTF MOF files. A secondary audience may use this document as a reference to the CIMAgent capabilities.

  • Page 9: Documentation Conventions

     “Installation Checklist” on page 3-6.  For more information, visit www.qlogic.com.  Text in bold font indicates user interface elements such as a menu items, buttons, check boxes, or column headings. For example: ...

  • Page 10: Supported Profiles And Subprofiles

    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? ...

  • Page 11: Technical Support

    Technical Certification courses include installation, maintenance and troubleshooting QLogic products. Upon demonstrating knowledge using live equipment, QLogic awards a certificate identifying the student as a certified professional. You can reach the training professionals at QLogic by e-mail at training@qlogic.com. Contact Information QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays.

  • Page 12: Knowledge Base

    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.

  • Page 13: Switch Management Classes

    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.
  • Page 14 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.
  • Page 15 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”].

  • Page 16: Qlgc_Fcportratestatistics : Cim_Fcportratestatistics

    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.

  • Page 17: Qlgc_Statisticscollection : Cim_Statisticscollection

    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. Supported Properties and Methods InstanceID Opaque ElementName...
  • Page 18 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.

  • Page 19: Qlgc_Physicalchassis : Cim_Physicalpackage

    Property will contain the string “QLGC_PhysicalChassis” Opaque identifier 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 model number printed on the switch chassis. PartNumber Property will contain a string that matches the part number printed on the switch chassis.

  • Page 20: Qlgc_Product : Cim_Product

    Property will contain the commonly known name of the product. For re-branded switches, this will be the vendor assigned product name. Vendor Property will contain the string “QLogic Corporation” unless the switch has been re branded, in which case it will contain the name of the branding vendor.

  • Page 21: Qlgc_Softwareidentity : Cim_Softwareidentity

    Opaque Identifier Manufacturer If the switch is re-branded, this property will contain the name of the branding vendor, otherwise it will default to QLogic Corporation. VersionString Property will contain the version number of the active firmware. Note: the active firmware may differ from the installed firmware if a new image is uploaded but the switch has not been reset.

  • Page 22: Qlgc_Location : Cim_Location

    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 —...

  • Page 23: Qlgc_Fcportcapabilities : Cim_Fcportcapabilities

    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.
  • Page 24 6-FX: Port may act as an F or FL port.  16000-Donor: Port may not connect, it donates its credits for use by another port. QLogic Extended Properties and Methods SupportedIOStreamGuardStates Property will contain an array of acceptable values for the FCPortSettings.IOStreamGuard property.

  • Page 25: Qlgc_Fcportsettings : Cim_Fcportsettings

    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. Supported WBEM Operations  getClass  getInstance  enumerateInstances ...
  • Page 26 6-FX: Port may act as an F or FL port.  16000-Donor: Port may not connect, it donates its credits for use by another port. QLogic Extended Properties and Methods RequestedIOStreamGuardState Property will contain the configured IOStreamGuard state. The operational IOStreamGuard state is reported by the FCPort.IOStreamGuard property.
  • Page 27 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: ...

  • Page 28: Qlgc_Fcswitchcapabilities : Cim_Enabledlogicalelementcapabilities

    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. Supported Properties and Methods InstanceID Opaque Identifier...
  • Page 29 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.

  • Page 30: Qlgc_Fcswitchsettings : Cim_Fcswitchsettings

    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.

  • Page 31: Qlgc_Logicalioblade : Cim_Logicalioblade

    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.
  • Page 32 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).
  • Page 33 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. ...

  • Page 34: Qlgc_Remoteserviceaccesspoint : Cim_Remoteserviceaccesspoint

    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. QLGC_RemoteServiceAccessPoint : CIM_RemoteServiceAccessPoint RemoteServiceAccessPoint is used by the access points sub-profile to expose connectivity information for services and interfaces on the switch.
  • Page 35 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. ServiceType and Value  snmp: snmp://<communityname@<ipaddr> for SNMPv1 & SNMPv2  snmp://<ipaddr> for SNMPv3 ...

  • Page 36: Cim_Configurationdata : Cim_Settingdata

    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.
  • Page 37 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.
  • Page 38 1–Switch Management Classes CIM_ConfigurationData : CIM_SettingData 1-26 59223-03 E...

  • Page 39: Fabric Discovery Classes

    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.

  • Page 40: Qlgc_Fabric : Cim_Admindomain

    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.

  • Page 41: Qlgc_Fcnode : Cim_Logicalportgroup

    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.

  • Page 42: Qlgc_Fcport : Cim_Fcport

    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.
  • Page 43 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.
  • Page 44 (Remote): Property will contain the “Physical Port Number” reported by the fabric configuration server on the remote switch. For all QLogic switches, this value will match the label on the switch, however the contents of “Physical Port Number” are officially undefined, and experience has shown that not all vendors use the same scheme for that field.
  • Page 45 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).
  • Page 46 CIM_ERR_INVALID_PARAMETER: One or more required parameters are missing.  CIM_ERR_NOT_FOUND: The FCPort instance was not found. QLogic Extended Properties and Methods HealthState (Local Only) This property will report the diagnostic status of the port as a result of the Switch POST. Supported values are: 0 –...
  • Page 47 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: ...
  • Page 48 2–Fabric Discovery Classes QLGC_FCPort : CIM_FCPort Supported WBEM Operations  getClass  getInstance  enumerateInstances  enumerateInstanceNames Associations  QLGC_FCPortStatisticalData : CIM_ElementStatisticalData — 1to1 relationship to QLGC_FCPortStatistics (Local only)  QLGC_FCPortRateStatisticalData : CIM_ElementStatisticalData — 1to1 relationship to QLGC_FCPortRateStatistics (Local only) ...

  • Page 49: Qlgc_Fcswitch : Cim_Computersystem

    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.
  • Page 50 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.
  • Page 51 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. ...
  • Page 52 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 ...

  • Page 53: Qlgc_Logicalnetwork : Cim_Connectivitycollection

    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. Supported WBEM Operations ...

  • Page 54: Qlgc_Protocolendpoint : Cim_Protocolendpoint

    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. Supported Properties and Methods CreationClassName Property will contain the string “QLGC_ProtocolEndpoint”...
  • Page 55 2–Fabric Discovery Classes QLGC_ProtocolEndpoint : CIM_ProtocolEndpoint Associations  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 —...
  • Page 56 2–Fabric Discovery Classes QLGC_ProtocolEndpoint : CIM_ProtocolEndpoint 2-18 59223-03 E...

  • Page 57: Fabric Zoning Classes

    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.

  • Page 58: Zoning Name Limits

    3–Fabric Zoning Classes Zoning Name Limits Locate the “Fabric” profile (CIM_RegisteredProfile). 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 “_”.

  • Page 59: Qlgc_Zoningservice : Cim_Zoneservice

    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.
  • Page 60 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.
  • Page 61 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.
  • Page 62 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”...
  • Page 63 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.
  • Page 64 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.
  • Page 65 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.
  • Page 66 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.
  • Page 67 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 –...

  • Page 68: Qlgc_Zoneset : Cim_Zoneset

    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.

  • Page 69: Qlgc_Zone : Cim_Zone

    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...

  • Page 70: Qlgc_Zonealias : Cim_Namedaddresscollection

    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.

  • Page 71: Qlgc_Zonemembership : Cim_Zonemembershipsettingdata

    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.
  • Page 72 3–Fabric Zoning Classes QLGC_ZoneMembership : CIM_ZoneMembershipSettingData Associations  QLGC_ZoneElementSettingData : CIM_ElementSettingData — ManyToMany relationship to QLGC_Zone  QLGC_ZoneAliasElementSettingData : CIM_ElementSettingData — ManyToMany relationship to QLGC_ZoneAlias 3-16 59223-03 E...

  • Page 73: Server Support Classes

    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).

  • Page 74: Qlgc_Objectmanager : Cim_Objectmanager

    Property will contain the switch WWN. Description Property will contain the string “Embedded CIMAgent” ElementName Property will contain the string “QLogic CIMAgent”, if the switch has been rebranded, then the property will contain a string with the format: “<brandname> CIMAgent”. OperationalStatus Property will contain the enumerated value 2=OK.

  • Page 75: Qlgc_Cimxmlcommunicationmechanism : Cim_Cimxmlcommunicationmechanism

    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 ...
  • Page 76 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.

  • Page 77: Qlgc_Registeredprofile : Cim_Registeredprofile

    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”.

  • Page 78: Qlgc_Registeredsubprofile : Cim_Registeredsubprofile

    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. RegisteredName Property will contain one of the following supported sub-profile names “Zone Control”, “Enhanced Zoning and Enhanced Zoning Control”, “Software”, and “Switch Configuration Data”, “Access Points”,...

  • Page 79: Indication Support Classes

    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.

  • Page 80: Cim_Indicationsubscription

    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: <scheme>_://<ipaddr or hostname_>:<portno>[/<extension>] Examples: ...
  • Page 81 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 ...

  • Page 82: Cim_Indicationfilter

    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.

  • Page 83: Predefined Filters

    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.
  • Page 84 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.
  • Page 85 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.
  • Page 86 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.

  • Page 87: Appendix

    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.

  • Page 88: Cim Operations Over Http

    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.

  • Page 89: Fibre Channel Transparent Mode

    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 sup- ported) Chunking Supported Pipelining Supported Max Client Connections All requests are handled serially in order of receipt.

  • Page 90: Class Changes

    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  QLGC_SAN  QLGC_ContainedDomain  QLGC_Fabric  QLGC_FCNode  QLGC_ProtocolEndPoint  QLGC_ZoningCapabilities  QLGC_ZoningService ...

  • Page 91: Qlgc_Fcswitch : Cim_Computersystem

    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.

  • Page 92: Qlgc_Fcportcapabilities : Cim_Fcportcapabilities

    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: ...
  • Page 93 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. Redefined Properties and Methods RegisteredName Property will contain one of the following supported sub-profile names:...
  • Page 94 A–Appendix QLGC_RegisteredSubProfile : CIM_RegisteredSubProfile 59223-03 E...
  • Page 95 Index CIM_ZoneMembershipSettingData 3-15 CIM_ZoneService Active Zoneset CIM_ZoneSet 3-12 CIM_AdminDomain 2-1, Dormant 1-20 CIM_CIMXMLCommunicationMechanism CIM_ComputerSystem 2-11 CIM_ConfigurationData 1-24 CIM_ConnectivityCollection 2-15 Fabric Discovery Classes CIM_EnabledLogicalElementCapabilities 1-16 Fabric objects CIM_FCPort FCNodes CIM_FCPortCapabilities 1-11 FCPortCapabilities 1-11 CIM_FCPortSettings 1-13 FCPortRateStatistics CIM_FCSwitchSettings 1-18 FCPortSettings 1-13 CIM_IndicationFilter FCPortStatistics CIM_IndicationSubscription FCSwitchCapabilities 1-16,...
  • Page 96 Reference Guide CIM Agent QLogic 3000/5000/9000 Series Fibre Channel Switch Switch Management Classes QLGC_CIMXMLCommunicationMechanism QLGC_Fabric Zoning Database QLGC_FCNode QLGC_FCPort 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 QLGC_ObjectManager QLGC_PhysicalChassis QLGC_PhysicalIOBlade QLGC_Product...
  • Page 98 Business Machines Corporation. All other brand and product names are trademarks or registered trademarks of their respective owners. Information supplied by QLogic Corporation is believed to be accurate and reliable. QLogic Corporation assumes no responsibility for any errors in this publication.

This manual is also suitable for:

5000 series9000 series