HP StorageWorks 8/20q HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent
HP StorageWorks 8/20q - Fibre Channel Switch Manual
View all HP StorageWorks 8/20q manuals
Add to My Manuals
Save this manual to your list of manuals |
HP StorageWorks 8/20q manual content summary:
- HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 1
HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide Part Number: 5697-0266 Published February 2010 Edition: 1 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - 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 StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 3
: CIM_NamedAddressCollection 42 5 Server support classes 45 QLGC_Namespace : CIM_Namespace 45 QLGC_ObjectManager : CIM_ObjectManager 45 QLGC_CIMXMLCommunicationMechanism : CIM_CIMXMLCommunicationMechanism 46 HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 3 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 4
CIM_IndicationFilter 53 Pre-defined filters 54 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 6 2 Connecting to the switch 57 3 IP Support 58 4 HTTP support 58 5 CIM/XML support 58 4 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 5
CIM in XML, v2.2, DSP0201 • DMTF, CIM Schema 2.10 • Network Working Group, Service Location Protocol, version 2, RFC 2608 In addition to this guide, see the following documents for this product: • HP StorageWorks SN6000 Fibre Channel Switch Quick Start Installation Instructions • HP StorageWorks 8Gb - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 6
blue text: Figure 1 Medium blue, underlined text (http://www.hp.com) Bold font Italics font Monospace font Monospace, italic font Monospace or data. IMPORTANT: Provides clarifying information or specific instructions. NOTE: Provides additional information. TIP: Provides helpful hints and shortcuts - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 7
and firmware documentation updates as well as instant access to numerous other product resources. • After signing up, you can quickly locate your products by selecting Business support and then Storage under Product Category. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 8
For other product information, see the following HP websites: • http://www.hp.com • http://www.hp.com/go/storage • http://www.hp.com/support/ • http://www.docs.hp.com Documentation feedback HP welcomes your feedback. To make comments and suggestions about product documentation, send a message - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 9
supports the following 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 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 10
10 Introduction - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 11
CIM Agent, there is an instance of FCPortStatistics for every port on the switch. All counter values are relative to the last switch reset (of any type) or the last port counter reset. Supported received by the port. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 11 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 12
: [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 StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 13
a single physical chassis instance representing the framework on which the hosting switch components are mounted. Supported properties and methods CreationClassName Property contains the string QLGC_PhysicalChassis. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 13 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 14
combination of hardware and software that make up the switch. The embedded CIM Agent will report a single product instance representing the switch hosting the agent. Supported properties and methods IdentifyingNumber Property contains the switch serial number as printed on the chassis. Name Property - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 15
the firmware revision on the switch. The CIM Agent only reports firmware information for its hosting switch. Only the active firmware version is reported. Supported to all instances of QLGC_RegisteredSubProfile HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 15 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 16
used to note the physical location of the switch. The embedded CIM Agent will report a single Location instance locating the switch hosting the agent. Supported properties and methods Name • Property contains the label FC Mgmt MIB - connUnitLocation. Physical Position Property contains a free-form - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 17
is read-only. Supported WBEM operations • getClass • getInstance • enumerateInstances • enumerateInstanceNames Associations • QLGC_FCPortElementCapabilities : CIM_ElementCapabilities-1-to-1 relationship to QLGC_FCPort HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 17 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 18
FCPortSettings for every port on the switch hosting the CIM Agent. This class is used to change the port configuration used on reset and startup. Changing the configuration also causes the current port settings to be set to the new configured value. Supported properties and methods InstanceID Opaque - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 19
reported by the SupportedPerformanceTuningModes property of the corresponding FCPortCapabilities instance. Supported values are: • 1-AutoSense • 2-None • 3-MFS: FCPort.RequestStateChange method. Possible values are: HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 19 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 20
to-1 relationship to QLGC_FCSwitch QLGC_FCSwitchSettings : CIM_FCSwitchSettings There is one instance of FCSwitchCapabilities representing the configuration of the switch hosting the CIM Agent. Supported properties and methods InstanceID Opaque Identifier ElementName Property contains the string FC - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 21
GUI Web User Interface • Embedded GUI IPV6 Web User Interface • Ethernet Ethernet Port IP Address • Ethernet IPV6 Ethernet Port IP Address SystemCreationClassName Property contains the string QLGC_FCSwitch. SystemName HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 21 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 22
Only the preferred IPv4 and IPv6 address for each service is returned for each service type. IPv4 addresses will be in dot-decimal Address or 4-IPv6 Address Supported WBEM operations • getClass the CIM_ConfigurationData class that represents the current switch configuration. If a client has uploaded - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 23
Supported WBEM operations • 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 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 24
24 Switch management classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 25
-1 relationship to QLGC_Fabric QLGC_Fabric : CIM_AdminDomain This distribution supports a single fabric per switch, so there is a one to one relationship : CIM_SystemDevice-1-to-Many relationship to QLGC_FCPort HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 25 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 26
NameFormat Property contains the string WWN. Supported WBEM operations • getClass • getInstance switch ports The ports on other switches in the fabric. The CIM Agent is only able to report information about these ports that is exposed by the Fabric Configuration Service on the remote switch. Switch - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 27
Supported 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 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 28
/s (Remote) • 0 Unknown • (NS) NULL SupportedCOS Property contains an array of 0..N 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 FC4 Types for a port on an attached device (NS port - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 29
report 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 29 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 30
-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 StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 31
-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 31 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 32
is synchronous. Returns: • 0-Success • 6-In Use: Switch is being configured by another user. • 4097-Invalid State Transition: RequestedState parameter value is out 4098-Use of Timeout Parameter Not Supported. Request Status Codes: • CIM_ERR_ACCESS_DENIED: User does not have authorization for this - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 33
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 33 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 34
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 StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 35
associated with the active zoneset and zone objects. Zoning name conventions The CIM Agent supports names for zones, zone aliases, and zoneset with the following character set allowed in the inactive zoning database. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 35 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 36
to the switch (CIM_ComputerSystem) that is hosting 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 StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 37
.Applicable. Sessions are not supported. ActivateZoneSet Method will attempt an active zone or zoneset. • 6-Access Denied: Switch is being configured by another user. • 7-Not Found: Referenced zone or zoneset was HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 37 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 38
does not apply to 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. Request Status Codes: • CIM_ERR_ACCESS_DENIED - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 39
: • 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 39 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 40
. • 6-Access Denied: Switch is being configured by another user. • 7-Not Found: contains an enumerated value representing the default zoning state, which indicates whether fabric Supported values are: • 2-Allow: Unzoned devices can access each other. • 3-Deny: Unzoned devices are isolated. Supported - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 41
local zoning database. ElementName Property contains a user-assigned string identifying the zoneset. Supported WBEM operations • getClass • getInstance • fabric. • 01-Other: Zone is an Access Control List hard zone. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 41 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 42
Supported properties and methods InstanceID Opaque CollectionAlias Property contains a user-assigned string identifying the collection of zone members. Supported WBEM 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 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 43
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 43 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 44
44 Fabric zoning classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 45
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 45 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 46
Property contains the switch WWN. Description Property contains the string Embedded CIM Agent. ElementName Property contains the string HP CIM Agent. OperationalStatus QLGC_CIMXMLCommunicationMechanism : CIM_CIMXMLCommunicationMechanism The CIM Agent only supports the CIM over XML communications - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 47
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 47 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 48
the CIM Agent. Supported properties and methods InstanceID Opaque RegisteredOrganization Property contains the enumerated value 11=SNIA. RegisteredName Property contains one of the following supported sub-profile names: • Zone Control • Enhanced Zoning and Enhanced Zoning Control Software • Switch - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 49
-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 49 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 50
50 Server support classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 51
* _http://mylistener:12000 _ * _http://[FEDC:BA98:7654:3210:FEDC:BA98:7654:3210]:12000_ Associations • CIM_IndicationSubscription-1-to-1 relationship to CIM_CIMIndicationFilter HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 51 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 52
Its value will always be 2 [Ignore]. An indication is dropped if the CIM Agent 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 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 53
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 53 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 54
filters The CIM Agent 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 is thrown whenever a switch is added - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 55
database changes. As the CIM Agent doesn't support zoning sessions, this means that a multi-step zoning change via CIM will result in multiple indications ' An indication is thrown whenever a zoneset is activated. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 55 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 56
56 Indication support classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 57
CIM operation over HTTP. Table 2 Connecting to the switch Parameter Namespace User Password Port Description root/switch User 5988 (SSL Disabled), or 5989 (SSL Enabled) HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 58
on the switch, the CIM Agent will 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 StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 59
17 SupportedPerformanceTuningModes 17 Switch management classes 11 symbols in text 6 T technical support, HP 7 text symbols 6 W warning rack stability 7 websites HP storage 8 HP Subscriber's choice 7 HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 59 - HP StorageWorks 8/20q | HP StorageWorks 8/20q and SN6000 Fibre Channel CIM Agent - Page 60
Z Zoning database 35 discovery 35 management 35 name conventions 35 60
HP StorageWorks 8/20q and SN6000 Fibre
Channel Switch CIM Agent Reference Guide
Part Number: 5697-0266
Published February 2010
Edition: 1