HP StorageWorks 8/20q HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref
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 Fibre Channel Switch CIM Agent ref - Page 1
HP StorageWorks 8/20q Fibre Channel Switch CIM Agent reference guide Part number: 5697-7202 First edition: February 2008 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 2
such 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. 8/20q Fibre Channel Switch CIM Agent reference guide - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 3
Contents About this guide 5 Intended audience 5 Related documentation 5 Document conventions and symbols 6 Rack stability 7 HP technical support 7 Customer self repair 7 Product warranties 7 Subscription service 7 HP web sites 8 Documentation feedback 8 1 Introduction 9 Client - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 4
classes 51 CIM_ListenerDestinationCIMXML 51 CIM_IndicationSubscription 52 CIM_IndicationFilter 52 Pre-defined filters 53 A Appendix 55 SLP support 55 Advertised profiles 55 Limitations 55 State changes 55 CIM operations over HTTP 55 Fibre Channel Transparent mode 56 Profile changes - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 5
CIM Schema 2.10 • Network Working Group, Service Location Protocol, version 2, RFC 2608 • HP StorageWorks 8/20q Fibre Channel Switch quick start installation instructions • HP StorageWorks 8Gb Simple SAN Connection Kit quick start instructions • HP StorageWorks 8/20q Fibre Channel Switch Rack Mount - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 6
Convention Medium blue text: Figure 1 Medium blue, underlined text (http://www.hp.com) Bold font Element Cross-reference links and e-mail addresses Web site data. IMPORTANT: Provides clarifying information or specific instructions. NOTE: Provides additional information. TIP: Provides helpful - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 7
This product has no customer replaceable components. Product warranties For information about HP StorageWorks product warranties, see the HP StorageWorks warranty information website: http://www.hp.com/go/storagewarranty Subscription service HP strongly recommends that customers sign up online using - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 8
sites For other product information, see the following HP web sites: • 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, please send - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 9
the Storage Management Initiative (SMI) Specification 1.1. The manual describes the supported classes and associations, including custom devices in the fabric. The Secure Socket Layer (SSL) capability is supported on the HP StorageWorks 8/20q Fibre Channel Switch. SSL is an option that may be - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 10
10 Introduction - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 11
switch, are hosting the CIM Agent, and are described in the SMI Specification 1.1 switch profile. Classes that are common to both the switch and (of any type) or the last port counter reset. Supported properties and methods InstanceID Opaque ElementName Property contains the string reference guide 11 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 12
by sampling counters at regular intervals. NOTE: Polling for RateStatistics more than once per interval will result in duplicate rate values. Supported properties and methods InstanceID Opaque StatisticTime Property contains the time that the most recent sample measurement was taken. Contains the - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 13
sample interval. Supported WBEM operations Agent in a single Associators() call. Supported properties and methods InstanceID Opaque ElementName Property nearest second. Supported WBEM operations hosting switch components are mounted. Supported properties and methods CreationClassName Property - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 14
product instance representing the switch hosting the agent. Supported properties and methods IdentifyingNumber Property contains the switch serial the vendor-assigned product name. Vendor Property contains the string HP. Version Property contains the value 0. ElementName Property contains the - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 15
active firmware version is reported. Supported properties and methods InstanceID Opaque Identifier Manufacturer This property contains the name HP. VersionString Property contains the version number to all instances of QLGC_RegisteredSubProfile 8/20q Fibre Channel Switch CIM Agent reference guide 15 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 16
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 string describing - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 17
entries, the mode is not configurable. Supported values are: • 1-AutoSense • 2-None • 3-MFS: Multi-frame sequence interleaving is suppressed. • 4-VI: Enable support for VI frames. • 5-LCF: or FALSE if the property is read-only. Supported WBEM operations • getClass • getInstance • enumerateInstances - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 18
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 Identifier ElementName Property contains the string FC Port Settings. RequestedSpeed Property contains the configured port - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 19
time as a result of hardware or license, or operating mode changes. Supported properties and methods InstanceID Opaque Identifier ElementName Property contains the string FC Switch are offline • 7-Test: All ports are in diagnostics mode. 8/20q Fibre Channel Switch CIM Agent reference guide 19 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 20
.PreferredDomainID property may be edited, or FALSE if the property is read-only. MinDomainID Property contains the minimum DomainID value supported by the switch. The CIM_FCSwitchSettings.PreferredDomainID may not be less than this value. MaxDomainID Property contains the maximum DomainID value - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 21
many as five instances of RemoteServiceAccessPoint depending on which services are enabled on the switch. Supported properties and methods CreationClassName Property contains the string ipaddr> for SNMPv3 • telnet: telnet:// 8/20q Fibre Channel Switch CIM Agent reference guide 21 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 22
• snmp: 200-URL • telnet: 200-URL • ssh: 200-URL • EmbeddedGUI: 200-URL • ethernet: 3-IPv4 Address Supported WBEM operations • getClass • getInstance • enumerateInstances • enumerateInstanceNames • invokeMethod Associations • QLGC_FCSwitchAccessPoint : CIM_HostedAccessPoint-Many-to-1 relationship to - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 23
parameter limitations above. • 16000: Validate Only Request Not Supported; ValidateOnly must be FALSE • 16001: ConfigurationData is invalid Does Not Support Initial/Default Configs; TypeOfConfiguration must be 2. • 16003: Element Does Not Support Possible Opaque Identifier Supported WBEM operations - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 24
24 Switch management classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 25
This chapter describes the classes in the SMI Specification 1.1.0 Fabric profile. The CIM Agent is QLGC_SAN : CIM_AdminDomain The SAN object aggregates multiple fabrics. This distribution supports a single fabric per switch, so there is a one-to- 20q Fibre Channel Switch CIM Agent reference guide 25 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 26
to definitively identify every port attached to an FCNode. Supported properties and methods InstanceID Opaque identifier ElementName Property contains information about these ports that is exposed by the Fabric Configuration Service on the remote switch. Switch ports are associated to an aggregating - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 27
Port Type represents the value negotiated during the port login procedure. It does not represent the configured port type. Supported values are: • 00-Unknown: (Local/Remote) G/GL port is not linked, or data is unknown. • NL ports via FC-AL. 8/20q Fibre Channel Switch CIM Agent reference guide 27 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 28
This value will match the label on the switch, however the contents of Physical Port Number are officially undefined, and experience has shown that 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 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 29
: [required] A port specific array of valid values may is synchronous. Method Returns: • 0-Success • 1-Not Supported: (NS/Remote Ports) Method applies to local ports of Timeout Parameter Not Supported. Request Status Codes: as a result of the switch POST. Supported values are: • 0-Unknown Port is not - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 30
. 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. • 3-Disable: Allows free - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 31
contains the configured switch state. Possible values are: • 2-Enabled: Switch ports are online. • 3-Disabled: Switch ports are offline. 8/20q Fibre Channel Switch CIM Agent reference guide 31 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 32
the RequestedState value. Parameters: RequestedState: [required] A switch-specific array of valid values may be found in the FCSwitchCapabilities. is out of range. • 4098-Use of Timeout Parameter Not Supported. Request Status Codes: • CIM_ERR_ACCESS_DENIED: User does not have authorization for - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 33
all the Fibre Channel specific instances of ProtocolEndpoint in the fabric. Supported properties and methods InstanceID switch in the fabric. Supported WBEM operations • getClass online are associated with a protocol endpoint. Supported properties and methods CreationClassName Property contains the - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 34
value 18=Fibre Channel. Property is deprecated. ProtocolIFType Property contains the enumerated value 56=Fibre Channel. Supported WBEM operations • getClass • getInstance • enumerateInstances • enumerateInstanceNames Associations • QLGC_ActiveConnection : CIM_ActiveConnection-1-to-1 relationship to - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 35
and/or activated. Zoning management The CIM Agent supports modification to the inactive zoning database, and zoneset activation. The SMI Specification 1.1.0 contains approved recipes for common zoning actions. The the inactive zoning database. 8/20q Fibre Channel Switch CIM Agent reference guide 35 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 36
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 methods SystemCreationClassName Property contains - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 37
. SessionState Property contains the enumerated value 5=No Change.Applicable. Sessions are not supported. ActivateZoneSet Method will attempt to activate the referenced zoneset, or to deactivate the reference to the newly created zoneset object. 8/20q Fibre Channel Switch CIM Agent reference guide 37 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 38
Parameters: • ZoneSetName: [required] String naming the zoneset to be created. Must be unique within the zoning database. • ZoneSet: [out] reference to the newly constructed ZoneSet object. Returns: • 0-Success • 4-Failed • 5-Invalid Parameter: Invalid zoneset name. • 6-Access Denied: Switch is - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 39
for this command. • CIM_ERR_INVALID_PARAMETER: One or more required parameters are missing. • CIM_ERR_NOT_FOUND: The ZoningService instance was not found. 8/20q Fibre Channel Switch CIM Agent reference guide 39 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 40
an enumerated value representing the default zoning state, which indicates whether fabric members (devices) that are not in any active zone can access each other. Supported values are: • 2-Allow: Unzoned devices can access each other. • 3-Deny: Unzoned devices are isolated - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 41
the fabric. All other instances of zoneset are stored in the zoning database on the switch. Supported properties and methods InstanceID Opaque Active Property contains a Boolean value that is TRUE if the is an Access Control List hard zone. 8/20q Fibre Channel Switch CIM Agent reference guide 41 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 42
zoneset and zones will not contain any zone aliases. When a zoneset is activated, any zone aliases are expanded into their component zone members. Supported properties and methods InstanceID Opaque CollectionAlias Property contains a user-assigned string identifying the collection of zone members - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 43
active zones will never be associated to inactive zone members, and vice versa. Supported properties and methods InstanceID Opaque ConnectivityMemberType Property contains the enumerated type of the zone -to-Many relationship to QLGC_ZoneAlias 8/20q Fibre Channel Switch CIM Agent reference guide 43 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 44
44 Fabric zoning classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 45
Server support classes This chapter describes the classes in the SMI Specification 1.1 the sole namespace supported by the CIM Agent. Supported properties and methods string 2.13.0. Supported WBEM operations • representing the CIM Agent. Supported properties and methods CreationClassName Property - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 46
contains the string Embedded CIM Agent. ElementName Property contains the string HP CIM Agent. OperationalStatus Property contains the enumerated value 2=OK. describing the capabilities of the interface implementation. Supported properties and methods CreationClassName Property contains the string - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 47
specification implemented by the CIM Agent. CIMValidated Property contains the value FALSE. XML parser does not validate against the DTD. ElementName Property contains the string CIMXML Communications Mechanism. OperationalStatus Property contains the enumerated value 2=OK. Supported supported - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 48
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 Configuration Data • Access Points - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 49
: CIM_ElementConformsToProfile-Many-to-1 relationship to QLGC_FCSwitch • QLGC_SubProfileElementSoftwareIdentity : CIM_ElementSoftwareIdentity-Many-to-1 relationship to the QLGC_SoftwareIdentity representing the active firmware 8/20q Fibre Channel Switch CIM Agent reference guide 49 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 50
50 Server support classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 51
support classes. CIM Agent supports all indications required by the SMI Specification CIM_ListenerDestinationCIMXML Supported properties Supported values are: • 2-Permanent: The listener object will remain until manually notation. Host name lookup is not supported by the switch. The scheme Supported - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - 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 Fibre Channel Switch CIM Agent ref - Page 53
WQL or CQL. Associations • CIM_IndicationSubscription-1-to-1 relationship to CIM_CIMListenerDestinationCIMXML Supported WBEM operations • getClass • getInstance • enumerateInstances • enumerateInstanceNames Pre- hosting the CIM Agent changes. 8/20q Fibre Channel Switch CIM Agent reference guide 53 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 54
WHERE OwnerEntity=SNIA and MessageID='32' An indication is 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 will result in multiple indications. Alert:ActivateZoneSet WQL: SELECT * FROM - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 55
SLP support SLP Service Agent (SA) support is integrated into the CIM Agent. As long as the switch is turned on and the CIM service is enabled the SANSurfer Manager. Table 3 HTTP support Parameter Description Supported Versions HTTP 1.0 and HTTP 1.1 Supported Character utf-8 Sets 8/20q Fibre - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 56
are handled serially in order of receipt. Parallel processing of requests is not supported. Table 4 CIM/XML support Parameter Description Supported Versions 1.0 Multiple Operations Not Supported CIM/Validation Loose CIMSupportedQueryLan None guages Fibre Channel Transparent mode A switch in - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 57
FC-Switch specific properties and TF) are supported in FC-T mode. TH and TF) are supported in FC-T mode. Redefined translated port types (TH and TF) are supported in FC-T mode. Redefined properties and methods does not represent the configured port type. The supported values are: • 00-Unknown: Port is - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 58
Fabric profile is removed in FC-T mode. Redefined properties and methods RegisteredName Property contains one of the following supported profile names: Server or Switch. QLGC_RegisteredSubProfile : CIM_RegisteredSubProfile Fabric SubProfiles have been removed in FC-T mode. Redefined properties and - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 59
15 H help, obtaining 7, 8 HP storage web site 8 Subscriber's choice web site 7 technical support 7 L Location 16 O ObjectManager Subscriber's choice, HP 7 subscriptions 51 supported profiles and sub-profiles technical support, HP 7 text symbols 6 W warning rack stability 7 web sites HP storage 8 HP - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 60
Z zoning database 35 Zoning discovery 35 Zoning management 35 Zoning name conventions 35 60
HP StorageWorks 8/20q Fibre Channel Switch
CIM Agent reference guide
Part number: 5697-7202
First edition: February 2008