HP SN6000 HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe
HP SN6000 Manual
View all HP SN6000 manuals
Add to My Manuals
Save this manual to your list of manuals |
HP SN6000 manual content summary:
- HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 2
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 Reference - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 3
15 QLGC_FCSwitchSettings : CIM_FCSwitchSettings 16 QLGC_RemoteServiceAccessPoint : CIM_RemoteServiceAccessPoint 17 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 - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 5
change even though the object represents the same port on an HBA. For this reason, a client should use durable identifiers to manage physical devices in the fabric. The HP StorageWorks SN6000 Fibre Channel Switch and 8/20q Fibre Channel Switch supports Secure Socket Layer (SSL), which may be enabled - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 6
6 Introduction - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 7
the total number of bytes received by the port. BytesTransmitted Property contains the total number of bytes transmitted from the port. PacketsReceived 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 8
() 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]. • 6-Access Denied: Switch is being configured by another user - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 12
of FCPortCapabilities for every port on the switch hosting the CIM Agent. This class determines the configuration options for an FCPort. Port capabilities vary by port, and may change for a given port as a result of hardware or license changes. Supported properties and methods InstanceID Opaque - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 13
Gb/s port may be configured to 8 Gb/s even if a 4 Gb/s optical transceiver is installed. Supported WBEM operations • getClass • getInstance • enumerateInstances • enumerateInstanceNames Associations HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 14
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 reported - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 15
the reception of RSCN messages from other ports for which IOStreamGuard is enabled. • . Supported properties and methods InstanceID Opaque Identifier ElementName Property contains the string FC Switch Capabilities HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 15 - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 if the - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 17
ssh SSH Interface • ssh IPV6 SSH Interface • Embedded GUI Web 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 17 - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 18
the preferred IPv4 and IPv6 address for each service is returned for each service type. IPv4 addresses use dot-decimal notation. Address or 4-IPv6 Address Supported WBEM operations • getClass CIM_ConfigurationData class that represents the current switch configuration. If a client has uploaded - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 19
. • 16002: Element Does Not Support Initial/Default Configs; TypeOfConfiguration must be 2. • 16003: Element Does Not Support Possible Configs/Config; TypeOfConfiguration must be -1-to-1 relationship to QLGC_FCSwitch HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 19 - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 20
20 Switch Management Classes - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 22
not licensed or not installed, are not instantiated. Remote switch ports The ports on other switches in the fabric. The CIM Agent is only able to report information about ports that are exposed by the Fabric Configuration Service on the remote switch. Switch ports are associated to an aggregating - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 24
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). It is NULL for switch ports. EnabledState (Local) Property - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 26
number of (buffer-to-buffer) credits dedicated to the port. Supported WBEM operations • getClass • getInstance • enumerateInstances • enumerateInstanceNames switch system is represented by an instance of FCSwitch. This class is required in both the fabric profile and the switch profile. Supported - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 28
values. • 2-Enabled: Switch ports are online. • 3-Disabled: Switch ports are offline. • 7-Test: Switch ports are in diagnostics mode. • 11-Reset: Switch will perform a hard reset CIM_ERR_NOT_FOUND: The FCSwitch instance was not found. Supported WBEM operations • getClass • getInstance • - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 30
with a switch port: Property contains the switch WWN. • 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 - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 31
prevent the creation of a zoneset that overwhelms an attached switch when activated. Supported properties and methods InstanceID Opaque MaxNumZone Property contains the maximum allowed in the inactive zoning database. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 31 - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 32
. • 2-Permanent Address • 3-Network Address • 4-Switch Port ID Supported WBEM operations • getClass • getInstance • enumerateInstances • is one instance of zoning service associated to the switch (CIM_ComputerSystem) that hosts the CIM Agent. The Zoning service is used for operations - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 33
not supported. ActivateZoneSet Method attempts to activate the referenced zoneset, or to deactivate the active zoneset. The following effects of activating a contains a reference to the newly created zoneset object. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 33 - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 34
a reference 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 Reference to the zone to be added to the zonealias. • ZoneAlias: [required] Reference - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 35
Reference to the zone member to be added to the zone or zone alias. Returns: • 0-Success • 4-Failed • 5-Invalid Parameter: May not configure Active zone. • 6-Access Denied: Switch ZoningService instance was not found. HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 35 - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 36
Format/Example: PermanentAddress: 16 uppercase hex digits / 2100002037730526 Network Address: 6 uppercase hex digits / 0B04E4 SwitchPortID: D:P where D is the switch domain and P is the switch port (area). Both values are base10./3:122. • SystemSpecificCollection: [required] Reference to the zone or - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 38
aliases. When a zoneset is activated, any zone aliases are expanded into their component zone members. Supported properties and methods InstanceID Opaque CollectionAlias the fabric, or a port on a switch. In the latter case, all devices connected to the port on the switch participate in the zone. - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 40
40 Fabric Zoning Classes - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 44
active software QLGC_RegisteredSubProfile : CIM_RegisteredSubProfile There is one instance of RegisteredSubProfile for each of the CIM sub-profiles supported by the CIM Agent. Supported supported sub-profile names: • Zone Control • Enhanced Zoning and Enhanced Zoning Control Software • Switch - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 46
46 Server Support Classes - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 47
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 CIM_IndicationSubscription-1-to-1 relationship to CIM_CIMIndicationFilter HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Reference Guide 47 - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 48
subscription is active only if the SubscriptionState is 2 (enabled) and it has not expired as a result of the SubscriptionDuration property. An inactive subscription does not pass filtered indications to the listeners. Supported properties and methods Filter Property must contain a reference to an - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 50
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 whenever the operational status of a port on the switch hosting the CIM Agent changes. 50 Indication Support Classes - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 52
52 Indication Support Classes - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 54
Suite User Guide • HP StorageWorks 8/20q and SN6000 Fibre Channel Switch Event Message Reference Guide • HP StorageWorks 8/20q and SN6000 Fibre Channel Switch Simple Network Management Protocol Reference Guide For the latest product information, including firmware, documentation, and supported SAN - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - Page 56
56 Support and Other Resources - HP SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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 SN6000 | HP StorageWorks 8/20q and SN6000 Fibre Channel Switch CIM Agent Refe - 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