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-7516 Second edition: July 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 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 - 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
the active firmware version is reported. Supported properties and methods InstanceID Opaque Identifier Manufacturer 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 ten instances of RemoteServiceAccessPoint, depending on which services are enabled on the switch. Supported properties and methods CreationClassName Property contains the string QLGC_RemoteServiceAccessPoint. Name World Wide Name (WWN). 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
Where: • ipaddr = Only the preferred IPv4 and IPv6 address for each service is returned for each service type. IPv4 addresses will be in dot-decimal notation. IPv6 addresses are URL • Ethernet: 3-IPv4 Address or 4-IPv6 Address Supported WBEM operations • getClass • getInstance • enumerateInstances • - 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 • 10 and is unusable 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 . Method Returns: • 0-Success • 1-Not Supported: (NS/Remote Ports) Method applies to local Timeout Parameter Not Supported. Request Status result of the switch POST. Supported values are: • 0-Unknown Supported values are: 8/20q Fibre Channel Switch CIM Agent - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 30
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 QLGC_FCSwitch. Name Property contains the switch WWN. ElementName 30 Fabric discovery classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 31
not be enabled/disabled (remote switch). RequestStateChange Method will change the configured switch state to the RequestedState value. 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
Parameters: RequestedState: [required] A switch-specific array of valid values may be found in the FCSwitchCapabilities. parameter value is out of range. • 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 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 • 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
describes the Indication support classes. CIM Agent supports all indications required by the SMI Specification for the switch from 1-64 characters. PersistenceType Supported values are: • 2-Permanent: The listener object will remain until manually deleted. • 3-Transient: CIM Agent reference guide 51 - 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
Supported WBEM operations • getClass • getInstance • enumerateInstances • WQL and the CQL version of the supported requests. Supported properties and methods SystemCreationClassName Property contains QLGC_FCSwitch. relationship to CIM_CIMListenerDestinationCIMXML Supported WBEM operations • getClass - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 54
Pre-defined filters The CIM Agent supports the following pre-defined filters: Create:ComputerSystem WQL: SELECT * FROM CIM_InstCreation WHERE SourceInstance ISA CIM_ComputerSystem CQL: whenever the operational status of a port on the switch hosting the CIM Agent changes. 54 Indication support classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 55
' 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 is thrown whenever a zoneset is activated. 8/20q Fibre Channel Switch CIM Agent reference guide 55 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 56
56 Indication support classes - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 57
As long as the switch is turned on and the CIM service is enabled, the CIM Agent will advertise its presence and respond to requests for service. IPv6 support was added as defined in RFC 3111. The SA will (SSL Disabled), or 5989 (SSL Enabled) 8/20q Fibre Channel Switch CIM Agent reference guide 57 - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 58
be added via 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 Character Sets Supported Languages Authentication Chunking Pipelining Max Client Connections - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 59
help, obtaining 7, 8 HP storage web site 8 Subscriber's choice web site 7 technical support 7 L Location 16 9 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 Subscriber's - HP StorageWorks 8/20q | HP StorageWorks 8/20q Fibre Channel Switch CIM Agent ref - Page 60
Z Zoning database 35 discovery 35 management 35 name conventions 35 60
HP StorageWorks 8/20q Fibre Channel Switch
CIM Agent reference guide
Part number: 5697-7516
Second edition: July 2008