Home » HP Manuals » Storage Devices » HP 3PAR StoreServ 7200 2-node » Manual Viewer

HP 3PAR StoreServ 7200 2-node HP 3PAR CIM API Programming Reference (OS 3.1.2 - Page 84

ExposeDefaultLUs, HideDefaultLUs

View all HP 3PAR StoreServ 7200 2-node manuals

Add to My Manuals
Save this manual to your list of manuals

Page 84 highlights

ExposeDefaultLUs Use of ExposeDefaultLUs has been deprecated. Please use ExposePaths instead to create a port-present SPC. HideDefaultLUs Use of HideDefaultLUs has been deprecated. Please use HidePaths instead. ExposeLUsToStorageHardwareIDCollection (Creating Host-Sees VLUNs) (3PAR proprietary method) ControllerConfigurationService.ExposeLUsToStorageHardwareIDCollection() is similar to ExposePaths, except ExposeLUsToStorageHardwareIDCollection exposes volumes to all the initiator ports (StorageHardwareID) on the specified hosts (StorageHardwareIDCollection) regardless of which target ports they are connected to. The parameter, TargetPortLIPDs, which if specified, also allows for creation of matched-set VLUNs; this allows for more flexibility in creating template VLUNs to target ports that might not exist yet. The method signature is described below: uint32 ExposedLUsToStorageHardwareIDCollection ( [Out] CIM_ConcreteJob ref Job, [In] String LUNames[], [In] String HostNames[], [In] string TargetPortLPIDs[], [In] String DeviceNumbers[], [In] uint16 DeviceAccesses[], [In/Out] CIM_SCSIProtocolController ref ProtocolController[], [In] boolean Override, [In] boolean NoVCN, [Out] String ResultDescriptions[]); • Job: This is ignored since the storage system does not support job control. • LUNames[]: An array of IDs of logical unit instances. The LU instances must already exist. The members of this array must match the Name property of StorageVolume instances. • HostNames[]: An array of names for the hosts (StorageHardwareIDCollection). Instances MUST already exist. The members of this array MUST match the ElementName property of TPD_StorageHardwareIDCollection. • TargetPortLPIDs[]: An array of target port LPIDs, in '::' format. If this is empty, then host-sees vlun is created; otherwise matched set vlun(s) is created. • DeviceNumbers[]: A list of logical unit numbers to assign to the corresponding logical unit in the LUNames parameter. (within the context of the elements specified in the other parameters). If the LUNames parameter is null, then this parameter must be null. If this parameter is NULL, the logical unit number will be assigned by the system. • DeviceAccesses[]: A list of permissions to assign to the corresponding logical unit in the LUNames parameter. This specifies the permission to assign within the context of the elements specified in the other parameters. This is mandatory only to be consistent with other methods. For the storage system, access permissions cannot be specified when creating a VLUN. Rather, each volume has its own access permission. The ControllerConfigurationService provider checks the passed in DeviceAccesses value against the permission of the specified LU (volume), and the operation fails if the two values do not match. • ProtocolControllers[]: An array of references to SCSIProtocolControllers (SPCs). On input, this can be null, or contain exactly one SPC; there may be multiple references on output. If null on input, the instrumentation creates one or more new SPC instances. If SPC is included 84 CIM API SMI-S Support

Section	Page
HP 3PAR CIM API Programming Reference	1
Contents	3
1 Concepts	10
About SMI-S	10
About the WBEM Initiative	10
2 Security	11
TCP Ports	11
Authentication	11
Authorization	11
3 Configuring and Using the CIM Server	12
CLI Command Overview	12
Enabling and Disabling the CIM Server	12
Enabling the CIM Server	12
Disabling the CIM Server	12
Displaying the CIM Server Status	12
Displaying the CIM Server Version	13
Communicating with the CIM Server	13
Client Software	13
Sending Client Requests	13
CIM Namespaces	14
4 CIM API SMI-S Support	15
Standard Compliance	15
SMI-S Functionality	15
Supported Discovery Service	15
Supported Profiles	15
Supported Array Packages	15
Supported Array Subprofiles	16
Supported Server Subprofile	16
Supported SMI-S Levels by Release	17
Discovery Service	17
Server Profile	18
Server Profile CIM Classes	18
Supported Methods	18
UML Diagram	18
Profile Registration Profile	18
CIM Classes	18
UML Diagram	19
Registered Version	19
SMI-S Profile	19
Array Profile	20
Array Profile CIM Classes	20
Supported Methods	20
Block Services Package	20
Block Services Package CIM Classes	20
Supported Methods	21
StorageCapabilities	21
StorageSetting	22
Creating a DynamicStoragePool (CPG) via SMI-S	26
Relevant Properties of DynamicStoragePool	28
Modifiable StorageSetting Properties for DSP	29
StorageCapabilities of DynamicStoragePool	30
StoragePoolConfigurationCapabilities of DynamicStoragePool	30
Creating a Volume Through SMI-S	31
Supported Method For Creating a Storage Volume	32
Method Signature	32
Creating Data and Snapshot Space from Two Storage Pools	33
Method Signature for CreateOrModifyElementFromStoragePools	33
CreateSetting	35
Creating a Volume with a Default Setting	35
Creating a Volume with a Non-Default Setting	36
Creating a Volume with Disk Pattern Filtering	37
Summary of Different Types of Volumes That Can Be Created	38
Modifiable StorageSetting Properties for StorageVolume	39
Calculating Capacity for StoragePool and StorageVolume	40
Primordial Storage Pool	40
Concrete Storage Pool	40
Dynamic Storage Pool (CPG)	41
Legacy Storage Volume	41
Initial State Example	42
Before Volume Creation	42
After Volume Creation	42
Fully Provisioned Storage Volume	43
Thinly Provisioned Storage Volume	44
Indications	46
Thin Provisioning Indications	46
Lifecycle Indications	48
Copy Services Subprofile	48
CIM Classes	48
TPD_AffectedJobElement	50
TPD_AllocatedFromStoragePool	50
TPD_AssociatedJobMethodResult	50
TPD_CapabilitiesOfStorageConfigurationService	50
TPD_CapabilitiesOfStoragePool	50
TPD_ConcreteJob	50
TPD_ConcreteJobInstModification	50
TPD_DeltaReplicaStoragePool	51
TPD_ElementSettingData	51
TPD_HostedStoragePool	51
TPD_MethodResult	51
TPD_OwningJobElement	51
TPD_ReplicaPoolForStorage	51
TPD_StorageCapabilities	51
TPD_StorageConfigurationCapabilities	51
TPD_StorageConfigurationService	52
TPD_StorageReplicationCapabilities	52
TPD_StorageSetting	55
TPD_StorageSynchronized	56
TPD_SystemVolume	57
TPD_DynamicStoragePool	57
SA/SD Space as StoragePool	57
Goal StorageSetting	57
CreateOrModifyStoragePool	58
Associations	58
TPD_ReplicaPoolForStorage	58
TPD_AllocatedFromStoragePool	58
Capacity Calculations	59
Non-CPVV	59
CPVV	59
UpdateDeltaSnapshotSpace() Method	60
Indications	61
Physical Copy	61
StorageSynchronized	61
StorageReplicationCapabilities	62
Job Control Subprofile Indications	67
Virtual Copy	67
StorageSynchronized	67
StorageReplicationCapabilities	68
Job Control Indications	70
Job Control	70
Overview	70
TPD_ConcreteJob	71
RequestStateChange() Method	71
GetError() Method	71
Mapping Error Code to CIM_Error	72
TPD_OwningJobElement	73
TPD_AffectedJobElement	73
TPD_AssociatedJobMethodResult	73
Indications	73
Location Subprofile	73
Location Subprofile CIM Classes	74
Supported Methods	74
Multiple Computer System Subprofile	74
Multiple Computer System Subprofile CIM Classes	74
Supported Methods	74
Software Subprofile	74
Software Subprofile CIM Classes	75
Supported Methods	75
Masking and Mapping Subprofile	75
Masking and Mapping Subprofile CIM Classes	75
Supported Methods	76
SMI-S View and Paths	76
ProtocolControllerMaskingCapabilities	79
ControllerConfigurationService	80
ExposePaths (Creating VLUNs)	81
HidePaths (Removing VLUNs)	82
ExposeDefaultLUs	84
HideDefaultLUs	84
ExposeLUsToStorageHardwareIDCollection (Creating Host-Sees VLUNs) (3PAR proprietary method)	84
HideLUsFromStorageHardwareIDCollection(Removing Host-Sees VLUNs)	85
StorageHardwareIDManagementService	86
CreateStorageHardwareID (Creating Host and Path)	87
DeleteStorageHardwareID (Removing a Path from a Host)	87
CreateStorageHardwareIDCollection (Creating a Host)	88
AddStorageHardwareIDsToCollection (Adding a Path to a Host)	88
SetISCSICHAP	89
RemoveISCSICHAP	89
StorageHardwareIDCollection.ModifyInstance	89
StorageHardwareIDCollection.DeleteInstance (Deleting a Host)	89
ConcreteDependency	90
SAPAvailableForElement	90
iSCSISAPAvailableForElement	90
SCSIPrococolController	90
iSCSIPrococolController	90
SCSIPrococolEndpoint	90
iSCSIPrococolEndpoint	91
ControllerForUnit	91
iSCSIControllerForUnit	92
StorageClientSettingData	92
StorageHardwareID	92
TPD_StorageHardwareIDCollection	92
Supporting classes	92
AuthorizedPrivilege	92
PrivilegeForStorageHardwareID	93
PrivilegeForStorageHardwareIDCollection	93
AuthorizedSubject	93
AuthorizedTarget	93
ConcreteDependency	93
SystemEndpoint (HostedAccessPoint)	93
ElementCapabilities	93
ElementSettingData	93
MemberOfCollection	93
ProtocolControllerMaskingCapabilities	93
FC Target Ports Subprofile	93
FC Target Ports Subprofile CIM Classes	94
Supported Methods	94
FCoE Target Port	94
Distinctions between FC and FCoE Port	94
FC Initiator Ports Subprofile	94
FC Initiator Ports Subprofile CIM Classes	95
Supported Methods	95
iSCSI Target Ports Subprofile	95
iSCSI Target Ports Subprofile CIM Classes	95
Supported Methods	96
Distinction between iSCSI and iSCSI over CNA Port	96
Disk Drive Lite Subprofile	96
Disk Drive Lite Subprofile CIM Classes	96
Supported Methods	97
Block Server Performance Subprofile	97
Block Server Performance Subprofile CIM Classes	97
TPD_ArrayStatisticalData	97
TPD_NodeStatisticalData	98
TPD_VolumeStatisticalData	100
TPD_PortStatisticalData	100
TPD_DiskStatisticalData	101
TPD_LUNStatisticalData	102
Supported Methods	102
Replication Services Profile	102
CIM Classes	103
TPD_ReplicationGroup	103
TPD_RemoteReplicationGroup	104
TPD_ReplicationService	105
TPD_ReplicationServiceCapabilities	117
TPD_RemoteStorageSynchronized	128
TPD_ReplicationEntity	132
TPD_RemoteReplicationGroup	133
TPD_RemoteGroupSynchronized	133
TPD_OrderedMemberOfRemoteReplicationGroup	135
TPD_ReplicationServiceAffectsRemoteReplicationGroup	135
TPD_HostedRemoteReplicationGroup	135
TPD_SAPAvailableForRemoteReplicaVolume	136
TPD_SAPAvailableForRemoteReplicationGroup	136
Thin Provisioning Profile	136
SAS Initiator Ports Profile	136
Supported Methods	137
5 CIM Indications	138
Lifecycle Indications	138
Storage Volume	138
TPD_StorageVolumeInstCreation	138
TPD_StorageVolumeInstDeletion	138
TPD_StorageVolumeInstModification	138
DynamicStoragePool	138
TPD_DynamicStoragePoolInstCreation	138
TPD_DynamicStoragePoolInstDeletion	139
TPD_DynamicStoragePoolInstModification	139
Fibre Channel Ports	139
Job Control for Copy Services	139
AlertIndication	139
Thin Provisioning	139
Generic AlertIndications	140
State Change Alerts	142
6 CIM-API Extensions	144
Health Management	144
Controller Node Subsystem	144
Controller Node Subsystem CIM Classes	144
Properties for TPD_StorageSystem	144
Properties for TPD_NodeSystem	145
Properties for TPD_PCICard	145
Properties for TPD_NodeCPU	145
Properties for TPD_PhysicalMemory	145
Properties for TPD_IDEDrive	145
Supported Methods	146
UML Diagram	146
Disk Enclosure Subsystem	146
Disk Enclosure Subsystem CIM Classes	146
Properties for TPD_StorageSystem	147
Properties for TPD_DriveCage	147
Properties for TPD_CageInterfaceCard	147
Properties for TPD_Magazine	147
Properties for TPD_DiskDrive	147
Supported Methods	148
UML Diagram	148
Power and Cooling	148
Power and Cooling CIM Classes	148
Properties for TPD_StorageSystem	149
Properties for TPD_NodeSystem	149
Properties for TPD_DriveCage	149
Properties for TPD_PowerSupply	150
Properties for TPD_Battery	150
Properties for TPD_Fan	150
Supported Methods	150
UML Diagram	151
Inventory Management	151
Controller Node Subsystem	151
Controller Node Subsystem CIM Classes	151
Properties for TPD_StorageSystem	152
Properties for TPD_SystemPackage	152
Properties for TPD_NodeSystem	152
Properties for TPD_NodePackage	152
Properties for TPD_PCICard	152
Properties for TPD_NodeCPU	153
Properties for TPD_PhysicalMemory	153
Properties for TPD_IDEDrive	153
Supported Methods	153
UML Diagram	154
Disk Enclosure Subsystem	154
Disk Enclosure Subsystem CIM Classes	154
Properties for TPD_StorageSystem	154
Properties for TPD_DriveCage	155
Properties for TPD_CageInterfaceCard	155
Properties for TPD_Magazine	155
Properties for TPD_DiskDrive	155
Properties for TPD_DiskDrivePackage	156
Properties for TPD_DiskSoftwareIdentity	156
Supported Methods	156
UML Diagram	156
Power and Cooling	156
Power and Cooling CIM Classes	157
Properties for TPD_StorageSystem	157
Properties for TPD_NodeSystem	157
Properties for TPD_DriveCage	157
Properties for TPD_PowerSupply	158
Properties for TPD_Battery	158
Properties for TPD_Fan	158
Supported Methods	158
UML Diagram	159
Domain, User and Licenses	159
Description	159
CIM Classes	159
Properties for TPD_StorageSystem	160
Properties for TPD_StorageDomainGroup	160
Supported Methods	160
Methods for TPD_StorageHardwareIDCollection	160
Thin Provisioning and TPVV Manipulations	160
7 Support and Other Resources	161
Contacting HP	161
HP 3PAR documentation	161
Typographic conventions	164
HP 3PAR branding information	164
8 Documentation feedback	165
A Managed Object Format Files	166
3PAR_InterOp.mof	166
3PAR_TPD.mof	170
3PAR_TPDCage.mof	236
3PAR_TPDCopySvcs.mof	247
3PAR_TPDDisk.mof	248
3PAR_TPDNode.mof	255
3PAR_TPDEnv.mof	263
3PAR_TPDIndication.mof	268
3PAR_TPDLocation.mof	272
3PAR_TPDEthPort.mof	273
3PAR_TPDiSCSI.mof	275
3PAR_TPDJob.mof	283
3PAR_TPDReplicationSvcs.mof	286
3PAR_TPDStats.mof	296

Match case Limit results 1 per page

ExposeDefaultLUs

Use of

ExposeDefaultLUs

has been deprecated. Please use ExposePaths instead to create a

port-present SPC.

HideDefaultLUs

Use of HideDefaultLUs has been deprecated. Please use HidePaths instead.

ExposeLUsToStorageHardwareIDCollection (Creating Host-Sees VLUNs) (3PAR proprietary method)

ControllerConfigurationService.ExposeLUsToStorageHardwareIDCollection()

is similar to

ExposePaths

, except

ExposeLUsToStorageHardwareIDCollection

exposes

volumes to all the initiator ports (

StorageHardwareID

) on the specified hosts

(

StorageHardwareIDCollection

) regardless of which target ports they are connected to.

The parameter,

TargetPortLIPDs

, which if specified, also allows for creation of matched-set

VLUNs; this allows for more flexibility in creating template VLUNs to target ports that might not

exist yet.

The method signature is described below:

uint32 ExposedLUsToStorageHardwareIDCollection (

[Out] CIM_ConcreteJob ref Job,

[In] String LUNames[],

[In] String HostNames[],

[In] string TargetPortLPIDs[],

[In] String DeviceNumbers[],

[In] uint16 DeviceAccesses[],

[In/Out] CIM_SCSIProtocolController ref ProtocolController[],

[In] boolean Override,

[In] boolean NoVCN,

[Out] String ResultDescriptions[]);

•

Job

: This is ignored since the storage system does not support job control.

•

LUNames[]

: An array of IDs of logical unit instances. The LU instances must already exist. The

members of this array must match the Name property of

StorageVolume

instances.

•

HostNames[]

: An array of names for the hosts (

StorageHardwareIDCollection

). Instances

MUST already exist. The members of this array MUST match the

ElementName

property of

TPD_StorageHardwareIDCollection

•

TargetPortLPIDs[]

: An array of target port LPIDs, in '

' format. If this

is empty, then host-sees vlun is created; otherwise matched set vlun(s) is created.

•

DeviceNumbers[]

: A list of logical unit numbers to assign to the corresponding logical unit in

the

LUNames

parameter. (within the context of the elements specified in the other parameters).

If the

LUNames

parameter is null, then this parameter must be null. If this parameter is NULL,

the logical unit number will be assigned by the system.

•

DeviceAccesses[]

: A list of permissions to assign to the corresponding logical unit in the

LUNames

parameter. This specifies the permission to assign within the context of the elements

specified in the other parameters. This is mandatory only to be consistent with other methods.

For the storage system, access permissions cannot be specified when creating a VLUN. Rather,

each volume has its own access permission. The

ControllerConfigurationService

provider checks the passed in

DeviceAccesses

value against the permission of the specified

LU (volume), and the operation fails if the two values do not match.

•

ProtocolControllers[]

: An array of references to

SCSIProtocolControllers

(SPCs). On

input, this can be null, or contain exactly one SPC; there may be multiple references on output.

If null on input, the instrumentation creates one or more new SPC instances. If SPC is included

CIM API SMI-S Support