HP 8/20q HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer
HP 8/20q Manual
View all HP 8/20q manuals
Add to My Manuals
Save this manual to your list of manuals |
HP 8/20q manual content summary:
- HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 1
HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide This guide describes how the Common Interface Model (CIM) Agent functions as an implementation of the Storage Management Initiative (SMI) Specification 1.1. The guide describes the supported classes and associations, - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 2
products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein. QuickTools™ is a trademark of QLogic Corporation. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 3
Classes 47 CIM_ListenerDestinationCIMXML 47 CIM_IndicationSubscription 48 CIM_IndicationFilter 49 Pre-defined filters 50 7 Support and Other Resources 53 Document conventions and symbols 53 Contacting HP 54 HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 3 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 4
Documents 54 Other HP websites 55 Customer self repair 55 A Appendix 57 SLP support 57 Advertised profiles 57 Limitations 57 State changes 57 CIM operations over HTTP 57 Index 59 Tables 1 Document conventions 53 2 Connecting to the switch 57 3 IP support 58 4 HTTP support 58 5 CIM/XML - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 5
profiles and sub-profiles: • Switch profile • Switch configuration data • Access points • Location • Physical package • Software Package • Fabric profile • Zone control • Enhanced zoning • Server profile • Indications HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 5 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 6
6 Introduction - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 7
to the switch, host the CIM Agent, and are described in the SMI Specification 1.1 switch profile. Classes that are common to both the switch and the Property contains the number of FC frames received by the port. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 7 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 8
: [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 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 9
: CIM_PhysicalPackage The embedded CIM Agent reports a single physical chassis instance representing the framework on which the hosting switch components are mounted. Supported properties and methods CreationClassName HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 9 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 10
Property contains the string HP. Version Property contains the value 0. ElementName Property contains the commonly known name of the product. For rebranded switches, this is the vendor-assigned product name. This property matches the SNMP System Description. Supported WBEM operations • getClass - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 11
-1-to-1 relationship to QLGC_FCSwitch • QLGC_ProfileElementSoftwareIdentity : CIM_ElementSoftwareIdentity-1-to-Many relationship to all instances of QLGC_RegisteredProfile • QLGC_SubProfileElementSoftwareIdentity : HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 11 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 12
switch. The embedded CIM Agent reports a single Location instance locating the switch hosting the agent. Supported properties and methods Name • Property contains the label FC Mgmt MIB for every port on the switch hosting the CIM Agent. This class determines the configuration options for an FCPort. - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 13
is TRUE if the FCPortConfig.AutoSenseSpeed property may be configured, or FALSE if the property is read-only. Supported WBEM operations • getClass • getInstance • enumerateInstances • enumerateInstanceNames Associations HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 14
set to the new configured value. Supported properties and methods InstanceID Opaque Identifier ElementName Property contains the string FC Port Settings. RequestedSpeed Property contains the configured port speed. This value is ignored if the AutoSenseSpeed property is TRUE. The active port speed is - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 15
. MaxElementNameLen Property contains the maximum string length of the FCSwitch.ElementName property. RequestedStatesSupported Property contains an array of acceptable values for the FCPort.RequestStateChange method. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 15 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 16
the configuration of the switch hosting the CIM Agent. Supported properties and methods InstanceID Opaque Identifier ElementName Property contains the string FC Switch Settings. PreferredDomainID Property contains the configured domainID. The configured domainID matches the Active domainID - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 17
principal priority configuration for the switch. Valid values User Interface • Embedded GUI IPV6 Web User Interface • Ethernet Ethernet Port IP Address • Ethernet IPV6 Ethernet Port IP Address SystemCreationClassName HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 18
IPv4 and IPv6 address for each service is returned for each service type. IPv4 addresses use dot IPv6 Address Supported WBEM switch configuration image. The configuration image includes the local zoning database and all switch configuration settings. A configuration is uploaded to the switch - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 19
• getClass • getInstance • enumerateInstances • enumerateInstanceNames • createInstance • invokeMethod Associations • QLGC_FCSwitchConfigurationData : CIM_ElementSettingData-1-to-1 relationship to QLGC_FCSwitch HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 19 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 20
20 Switch Management Classes - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 21
the remote switches, a truncated fabric is reported. QLGC_SAN : CIM_AdminDomain The SAN object aggregates multiple fabrics. This distribution supports a single fabric per switch, so to-Many relationship to QLGC_FCPort HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 21 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 22
Active=TRUE) • QLGC_FabricZone : CIM_HostedCollection-1-to-Many relationship to QLGC_Zone (Active contains the string WWN. Supported WBEM operations • getClass • ports that are exposed by the Fabric Configuration Service on the remote switch. Switch ports are associated to an aggregating FCSwitch - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 23
to another switch • 15-F: (Local/Remote) Fabric port is linked to an N port • 16-FL: (Local/Remote) Fabric port is linked to one or more NL ports via FC-AL • 16000-Donor: (Local) Port is in Donor Mode and is unusable HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 23 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 24
supported classes of service for a port on an attached device (NS port). It is NULL for switch ports. SupportedFC4Types Property contains an array of 0..N supported matches the configured switch enabled state (EnabledDefault) unless the switch state has been temporarily changed. Supported values • - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 25
reports the diagnostic status of the port as a result of the switch POST. Supported values are: • 0-Unknown Port is not installed • 5-OK No errors • 25-Critical Failure Port failed POST IOStreamGuardState (Local Only) HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 25 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 26
-1-to-1 relationship to QLGC_FCPortSettings 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 contains the string - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 27
-NA Switch may not be enabled/disabled (remote switch). EnabledDefault Property contains the configured switch state. Possible values are: • 2-Enabled: Switch ports are online. • 3-Disabled: Switch ports are offline. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 27 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 28
Use: Switch is being configured by another user. • Supported. 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 FCSwitch instance was not found. Supported - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 29
together by an instance of ActiveConnection. Only FCPorts that are online are associated with a protocol endpoint. Supported properties and methods CreationClassName Property contains the string QLGC_ProtocolEndpoint. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 29 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 30
the WWN of the principal switch in the fabric. NameFormat Property contains the string WWN. ProtocolType Property contains the enumerated value 18=Fibre Channel. Property is deprecated. ProtocolIFType Property contains the enumerated value 56=Fibre Channel. Supported WBEM operations • getClass - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 31
the maximum number of zone aliases in the zoning database. MaxNumZoneMembers Property contains the maximum number of zone members allowed in the inactive zoning database. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 31 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 32
to the switch (CIM_ComputerSystem) that hosts the CIM Agent. The Zoning service is used for operations that create either a zone, zoneset, zone alias, zone member, or the association objects that link them together. These objects may be deleted using intrinsic methods. Supported properties and - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 33
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 reference to the newly created zoneset object. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 33 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 34
default type. • Zone: [out] Reference to the newly constructed Zone object. Returns: • 0-Success • 4-Failed • 5-Invalid Parameter: Invalid zone name, or invalid zone type. • 6-Access Denied: Switch is being configured by another user Parameter: May not configure active zone. 34 Fabric Zoning Classes - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 35
: • 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. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 35 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 36
ConnectivityMemberType or ConnectivityMemberID format. • 6-Access Denied: Switch is being configured by another user. • 7-Not Found: Referenced zone or alias or default zoning state, which indicates whether fabric members (devices) that are not in any active zone can access each other. Supported - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 37
zones differ from soft zones in that hard zones affect the flow of FC frames whereas soft zones only affect a device's ability to see other devices in the fabric. • 01-Other: Zone is an Access Control List hard zone. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 37 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 38
is activated, any zone aliases are expanded into their component zone members. Supported properties and methods InstanceID Opaque CollectionAlias Property contains a user-assigned represents either a device in the fabric, or a port on a switch. In the latter case, all devices connected to the port on - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 39
Associations • QLGC_ZoneElementSettingData : CIM_ElementSettingData-Many-to-Many relationship to QLGC_Zone • QLGC_ZoneAliasElementSettingData : CIM_ElementSettingData-Many-to-Many relationship to QLGC_ZoneAlias HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 39 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 40
40 Fabric Zoning Classes - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 41
There is one instance of ObjectManager representing the CIM Agent. Supported properties and methods CreationClassName Property contains the string QLGC_ObjectManager. Name Property contains the switch WWN. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 41 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 42
Property contains the switch WWN. Description Property contains the string Embedded CIM Agent. ElementName Property contains the string HP CIM Agent. describing the capabilities of the interface implementation. Supported properties and methods CreationClassName Property contains the string - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 43
Property contains the following array of enumerated values: [3=SLP]. AdvertiseTypeDescriptions Property contains the following array of description strings: [SLP]. Supported WBEM operations • getClass • getInstance HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 43 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 44
value 11=SNIA. RegisteredName Property contains one of the following supported sub-profile names: • Zone Control • Enhanced Zoning and Enhanced Zoning Control Software • Switch Configuration Data • Access Points • Location • Physical Package • Indications RegisteredVersion Property contains - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 45
-Many-to-1 relationship to QLGC_FCSwitch • QLGC_SubProfileElementSoftwareIdentity : CIM_ElementSoftwareIdentity-Many-to-1 relationship to the QLGC_SoftwareIdentity representing the active firmware HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 45 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 46
46 Server Support Classes - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 47
describes the Indication support classes. CIM Agent supports all indications required by the SMI Specification for the switch and fabric profiles -1-to-1 relationship to CIM_CIMIndicationFilter HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 47 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 48
dependent subscription objects are also deleted. An indication subscription is active only if the SubscriptionState is 2 (enabled) and it the CIM Agent is unable to transmit it to the listener. SubscriptionState Supported Values are: • 2-Enabled • 4-Disabled IndicationSubscriptions may not be - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 49
the string WQL or CQL. Associations • CIM_IndicationSubscription-1-to-1 relationship to CIM_CIMListenerDestinationCIMXML Supported WBEM operations • getClass • getInstance • enumerateInstances • enumerateInstanceNames HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 49 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 50
Fabric Segmentation results in the creation of a new Fabric for the isolated switches. The Delete:FCPort indication implies a device removal from the original fabric, not from the from the SAN as a whole, as the device remains in the new fabric. Modify:FCPort WQL: SELECT * FROM CIM_InstModification - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 51
thrown whenever the inactive zoning database changes. As the CIM Agent doesn't support zoning sessions, this means that a multi-step zoning change via CIM ='33' An indication is thrown whenever a zoneset is activated. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 51 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 52
52 Indication Support Classes - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 53
follow directions could result in damage to equipment or data. IMPORTANT: Provides clarifying information or specific instructions. NOTE: Provides additional information. TIP: Provides helpful hints and shortcuts. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 53 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 54
: • HP StorageWorks 8Gb Simple SAN Connection Kit Quick Start Instructions • HP StorageWorks Simple SAN Connection Manager User Guide • HP StorageWorks 8/20q and SN6000 Fibre Channel Switch Rack Mount Kit Quick Start Installation Instructions • HP StorageWorks 8/20q and SN6000 Fibre Channel Switch - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 55
courier/carrier to be used. For more information about the HP Customer Self Repair program, contact your local service provider. For the North American program, visit the HP website (http://www.hp.com/go/selfrepair). HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 55 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 56
56 Support and Other Resources - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 57
over HTTP. Table 2 Connecting to the switch Parameter Description Namespace User root/switch User Password Port 5988 (SSL Disabled), or 5989 (SSL Enabled) HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 57 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 58
on the switch, the CIM Agent does not accept connections to port 5988. User accounts may be added using Telnet or QuickTools. Table 3 IP support Parameter Supported on Supported Versions IPv4, IPv6 IPsec Both IPv4 and IPv6 stacks Table 4 HTTP support Parameter Supported Versions Supported - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 59
classes 7 symbols in text 53 T technical support, HP 54 text symbols 53 W websites HP documentation 54 HP storage 55 HP Subscriber's choice 54 Z Zoning database 31 discovery 31 management 31 name conventions 31 HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 59 - HP 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refer - Page 60
60
HP StorageWorks 8/20q and SN6000
Fibre Channel Switch
CIM Agent Reference Guide
This guide describes how the Common Interface Model (CIM) Agent functions as an implementation of the Storage
Management Initiative (SMI) Specification 1.1. The guide describes the supported classes and associations, including
custom and overridden properties and methods. It also lists the capabilities and limitations of the CIM Agent at the HTTP,
XML, and CIM protocol levels. This document is for software developers who are building a management client for the HP
StorageWorks SN6000 or 8/20q Fibre Channel Switch.
Part Number: 5697-0407
Published June 2010
Edition: 2