Home » Dell Manuals » Storage Devices » Dell Unity 600F » Manual Viewer

Dell Unity 600F EMC Unity Family SMI-S Provider Programmer s Guide - Page 70

Client considerations, Model specification

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

Page 70 highlights

Return code Type Description • If TheElement is not type of SnapVolume. (for Copy Service) The ECOM will throw exceptions when any of the below cases are met: • Any of the required parameters is NULL. NA CIM_Error • The Element is not type of CIM_LogicalElement. • Any of the Instance References - TheElement cannot be found in the system. Client considerations Model specification • StoragePool Manipulation StoragePool creation, deletion and modification are not supported. • LogicalDevice Manipulation LogicalDisk is Read-Only. StorageVolume is only supported to be created from StoragePool. • StorageSetting (to StorageCapabilities) All CIM_StorageSetting (associated to CIM_StorageCapabilities) are predefined, which means property ChangeableType is set to '0: Fixed, Not changeable'. User generated storage settings are not supported. Different storage pool can be linked to the same CIM_StorageSetting instance because only predefined storage settings are supported. • StorageVolume (LUN) Creation When SMI-S API creates a StorageVolume, it will create a standalone virtual disk. The StorageVolume will get the default FAST VP tiering policy of "Start high then auto-tier". • StorageVolume (LUN) Enumeration All Virtual Disks, no matter they are Standalone or in an Application (modeled as CIM_ReplicationGroup), and also no matter they are in Generic SCSI Storage Application or other type of Applications. In SMI-S view, there will be one CIM_StorageVolume instance per virtual disk to CIM client. • StorageVolume (LIN) Deletion A StorageVolume can be deleted successfully through SMI-S API under following conditions: 1) There is no host access; 2) There is no snapshot on the StorageVolume; 3) The StorageVolume is not involved by any Replication Group. Since Application is modeled as SMI-S Replication Group while Virtual Disks in Applications other than Generic SCSI Storage cannot be removed from its owner Application. As a result, SMI-S clients are only able to delete Standalone Virtual Disk or Virtual Disks within Generic SCSI Storage Application. It also avoids the deletion of Virtual Disks for other purposes. • Additional properties on StoragePool 70

Section	Page
Table of Figures	12
Table of Tables	13
Additional resources	18
As part of an improvement effort, revisions of the software and hardware are periodically released. Therefore, some functions described in this document might not be supported by all versions of the software or hardware currently in use. The product r...	18
Where to get help	18
Product information	18
For product and feature documentation or release notes, go to Unity Technical Documentation at: dell.com/unitydocs.	18
Troubleshooting	18
For information about products, software updates, licensing, and service, go to Support (registration required) at: dell.com/support. After logging in, locate the appropriate product page.	18
Introduction	18
Audience	18
Basic requirements	18
Format of Profile Chapter	18
Definitions and conventions	18
Recommendations	20
Server Profile	21
Overview	21
Method of the Profile	21
Client considerations	21
Model specifications	21
Use case: View Server Profile implementation for EMC CIM server	22
Profile Registration Profile	23
Overview	23
Method of the Profile	23
Client consideration	23
Model specification	23
Use case: Find all Profiles on a CIM Server	23
Use case: Identify the ManagedElement defined by a Profile	24
Use case: Enumerate autonomous profiles supported by a given CIM server	25
Use case: Determine the SNIA Version of a SMI-S Profile	26
Multiple Computer System Subprofile	27
Overview	27
Methods of the Profile	27
Client considerations	27
Model Specification	27
Use case: Find top-level ComputerSystem	28
Use case: Check system redundancy	29
Use case: Find top-level ComputerSystem for any LogicalDevice	29
Software Subprofile	30
Overview	30
Method of the Profile	30
Client considerations	30
Physical Package Package	31
Overview	31
Methods of the Profile	31
Client considerations	31
Model Specification	31
Use case: Get product information for a ComputerSystem	32
Use case: Find asset information for subcomponents	32
Access Points Subprofile	33
Overview	33
Method of the Profile	33
Client considerations	33
FC Target Ports Subprofile	34
Overview	34
Methods of the Profile	34
Client considerations	34
iSCSI Target Ports Subprofile	35
Overview	35
Methods of the Profile	35
Client considerations	35
Model Specification	35
1.	35
2.	35
3.	35
4.	35
Use case: Discover the iSCSI target port capabilities	35
Use case: Identify the iSCSI nodes in a target system (NetworkEntity).	35
Use case: Identify the iSCSI ports on a given iSCSI node.	35
Fan Profile	36
Overview	36
Method of the Profile	36
Client considerations	36
Model Specification	36
Use case: Discover fan devices	36
Power Supply Profile	37
Overview	37
Method of the Profile	37
Client considerations	37
Model Specification	37
Use case: Discover power supplies	37
Health Package	38
Overview	38
Method of the Profile	38
Client considerations	38
Indication Subprofile	39
Overview	39
Method of the Profile	39
Client considerations	39
Model specification	39
Use case: CQL for profiles	52
Use case: Create IndicationFilter and ListenerDestination instances	52
Use case: Create IndicationSubscription instances	52
Use case: Subscribe to Indications using pre-defined filters	52
Job Control Subprofile	54
Overview	54
Method of the Profile	54
Client considerations	54
Model specification	54
Use case: Obtain job-affected element	54
Array Profile	55
Overview	55
Method of the Profile	55
Client considerations	55
Use case: Discover Block Server (Array ComputerSystem)	55
Use case: Discover the capacity optimization support in an array	56
Disk Drive Lite Subprofile	57
Overview	57
Method of the Profile	57
Client considerations	57
Model Specification	57
Extent Composition Subprofile	58
Overview	58
Method of the Profile	58
Client considerations	58
Use case: Traverse the virtualization hierarchy of a StorageVolume or LogicalDisk	58
Use case: Find the Primordial Extents used by a StorageVolume or LogicalDisk	58
Block Services Package	60
Overview	60
Methods of the Profile	60
Extrinsic methods on StorageCapabilities	60
Method: GetSupportedStripeLengths of Concrete Pool Capabilities	60
Method: GetSupportedParityLayouts of Concrete Pool Capabilities	61
Method: CreateSetting of Concrete Pool Capabilities	61
Method: GetSupportedStripeLengths of Primordial Pool Capabilities	62
Method: GetSupportedParityLayouts of Primordial Pool Capabilities	62
Method:GetSupportedStripeLengths of System Capabilities	63
Method:GetSupportedParityLayouts of System Capabilities	63
Extrinsic methods on StoragePool	64
Method: GetAvailableExtents of Concrete Pool	64
Method:GetSupportedSizeRange of Concrete Pool	65
Method: GetAvailableExtents of Primordial Pool	65
Extrinsic methods on StorageConfiguration	66
Method: CreateOrModifyElementFromStoragePool of Storage Configuration	67
Method: ReturnToStoragePool of Storage Configuration	69
Client considerations	70
Model specification	70
Use case: Discover system’s Storage Configuration Capabilities	71
Use case: Discover pool’s Storage Configuration Capabilities	71
Use case: create StorageVolume (LUN) from StoragePool	71
Use case: Expand a StorageVolume (LUN)	72
Use case: Rename a StorageVolume (LUN)	73
Use case: Delete StorageVolume (LUN)	74
Thin Provisioning Profile	75
Overview	75
Method of the Profile	75
Client considerations	75
Model specification	75
Use case: Creating a Thinly provisioned StorageVolume	75
Automated Storage Tiering Profile	76
Overview	76
Method of the Profile	76
Client considerations	76
Model Specification	76
Use case: Discover Automated Storage Tiering Capabilities	76
Use case: Create StorageVolume with Storage Tiering	77
Use case: Modify Tiering Policy of StorageVolume	77
Copy Service Subprofile	79
Overview	79
Method of the Profile	79
Intrinsic methods on StorageConfigurationService	79
Method: StorageConfigurationService.CreateReplica	79
Method: StorageConfigurationService.ModifySynchronization	81
Extrinsic methods on ReplicationService	82
Method: ReplicationService.CreateElementReplica	82
Method: ReplicationService.ModifyReplicaSynchronization	82
Client considerations	82
Model Specification	82
Use case: Discover Copy support and capabilities	82
Use case: Create Standalone-LUN Snapshot	83
Use case: Delete Standalone-LUN Snapshot	83
Replication Services Profile	85
Overview	85
Method of the Profile	85
Extrinsic Methods on Group Management	85
Method: ReplicationService.CreateGroup	85
Method: ReplicationService.DeleteGroup	86
Method: ReplicationService.AddMembers	87
Method: ReplicationService.RemoveMembers	88
Extrinsic Methods on Replication Management	90
Method: ReplicationService.GetPeerSystems	90
Method: ReplicationService.GetServiceAccessPoints	90
Method: ReplicationService.GetReplicationRelationshipInstances	91
Method: ReplicationService.GetReplicationRelationships	92
Method: ReplicationService.GetAvailableTargetElements	93
Method: ReplicationService.CreateElementReplica	94
Method: ReplicationService.CreateGroupReplica	97
Method: ReplicationService.ModifyReplicaSynchronization	100
Method: ReplicationService.CreateSynchronizationAspect	101
Method: ReplicationService.ModifySettingsDefineState	103
Extrinsic Methods on ReplicationServiceCapabilities	105
Method: ReplicationServiceCapabilities.ConvertReplicationTypeToSyncType	105
Method: ReplicationServiceCapabilities.ConvertSyncTypeToReplicationType	105
Method: ReplicationServiceCapabilities.GetDefaultConsistency	106
Method: ReplicationServiceCapabilities.GetDefaultGroupPersistency	107
Method: ReplicationServiceCapabilities.GetSupportedConsistency	107
Method: ReplicationServiceCapabilities.GetSupportedCopyStates	107
Method: ReplicationServiceCapabilities.GetSupportedFeatures	108
Method: ReplicationServiceCapabilities.GetSupportedGroupCopyStates	109
Method: ReplicationServiceCapabilities.GetSupportedGroupFeatures	109
Method: ReplicationServiceCapabilities.GetSupportedOperations	110
Client considerations	110
Model Specification	110
Use case: Disvocer Replication Services Capabilities	110
Use case: Create Promoted Snapshot of Standalone-LUN	111
Use case: Delete Promoted Snapshot of Standalone-LUN	111
Use case: Demote Promoted Snapshot of Standalone-LUN	111
Use case: Create SynchronizationAspect of Storage Element	112
Use case: Delete SynchronizationAspect of Storage Element	112
Use case: Restore Storage Element from SynchronizationAspect	112
Use case: Promote Non-Promoted Snapshot of Storage Element	113
Use case: Create Replication Group	113
Use case: Delete Replication Group	113
Use case: Add LUN to a Replication Group	113
Use case: Remove LUN from Replication Group	114
Use case: Create Promoted Snapshot of Replication Group	114
Use case: Delete Promoted Snapshot of Replication Group	114
Use case: Demote Promoted Snapshot of Replication Group	115
Use case: Create SynchronizationAspect of Storage Group	115
Use case: Delete SynchronizationAspect of Storage Group	115
Use case: Restore Storage Group from SynchronizationAspect	116
Use case: Promote Non-Promoted Snapshot of Storage Group	116
Use case: Setup Standalone-LUN Mirror	116
Use case: Detach Standalone-LUN Mirror	116
Use case: Split Standalone-LUN Mirror	117
Use case: Resync Standalone-LUN Mirror after Split	117
Use case: Failover Standalone-LUN Mirror	117
Use case: Failback Standalone-LUN Mirror after Failover	118
Use case: Reverse Roles of Standalone-LUN Mirror	118
Use case: Setup Replication Group Mirror	118
Use case: Detach Replication Group Mirror	118
Use case: Split Replication Group Mirror	119
Use case: Resync Replication Group Mirror after Split	119
Use case: Failover Replication Group Mirror	119
Use case: Failback Replication Group Mirror after Failover	120
Use case: Reverse Roles of Replication Group Mirror	120
Masking and Mapping Subprofile	121
Overview	121
Method of the Profile	121
Extrinsic Methods on ControllerConfigurationService	121
Method: ControllerConfigurationService.ExposePaths	121
Method: ControllerConfigurationService.HidePaths	124
Method: ControllerConfigurationService.DeleteProtocolController	125
Extrinsic Methods on StorageHardwareIDManagementService	126
Extrinsic Methods on PrivilegeManagementService	126
Client considerations	126
Model Specification	126
Use case: Create a New Host	127
Use case: Register Initiators to a Host	127
Use case: Expose LUs to a Host	127
Use case: Unregister InitiatorPortIDs from a Host	127
Use case: Detach LUs from a Host	128
Use case: Delete a Host	129
Use case: Rename a Host	130
Block Server Performance Subprofile	131
Overview	131
Method of the Profile	131
Extrinsic Methods on Manifest Management	131
Method: CreateManifestCollection	131
Method: AddOrModifyManifest	132
Method: RemoveManifest	133
Extrinsic Methods on Statistics Query	133
Method: GetStatisticsCollection	133
Mehod: GetRateStatisticsCollection	135
Client Considerations	137
Model Specification	137
Use case: Check Block Server Performance Supported Capabilities	138
Use case: Create Client-Defined Manifest Collection	139
Use case: Remove client-defined Manifest Collection	139
Use case: Add Client-Defined Manifest	139
Use case: Remove Client-Defined Manifest	139
Use case: Retrieve Statistics for a Specified Element	139
Use case: Get Statistics Collection	140
Use case: Get Rate Statistics Collection	140
NAS Head Profile	141
Overview	141
Method of the Profile	141
Client considerations	141
Use case: Discover NAS Head	141
NAS Network Port Profile	143
Overview	143
Methods of the Profile	143
Client considerations	143
File Server Manipulation Subprofile	144
Overview	144
Methods of the Profile	144
Extrinsic Methods on Capabilities	144
Method: FileServerCapabilities.CreateGoalSettings	144
Extrinsic Methods on FileServerConfigurationService	147
Method: FileServerConfigurationService.CreateFileServer	147
Method: FileServerConfigurationService.ModifyFileServer	149
Method: FileServerConfigurationService.DeleteFileServer	151
Method: FileServerConfigurationService.AddIPInterface	152
Method: FileServerConfigurationService.ModifyIPInterface	154
Method: FileServerConfigurationService.DeleteIPInterface	155
Client considerations	156
Model Specification	156
1.	157
Use case: Create Supported Settings for File Server	157
Use case: Create a File Server	157
Use case: Modify a File Server	158
Use case: Delete a File Server	159
1.	159
2.	159
3.	159
4.	159
4.1.	159
4.2.	159
4.3.	159
4.4.	159
Use case: Add a New IP Interface to an Existing CIFS File Server	159
Use case: Modify an Existing IP Interface of a File Server	160
Use case: Delete an Existing IP Interface from a CIFS File Server	160
File Storage Profile	162
Overview	162
Methods of the Profile	162
Client considerations	162
File System Profile	163
Overview	163
Methods of the Profile	163
Client considerations	163
Model Specification	163
1.	163
2.	163
3.	163
4.	163
Use case: Discover all File Systems Hosted by the Referencing Profile	163
Use case: Discover all Exportable File Systems	163
Use case: Get the Settings of a File System	164
Use case: Get the ComputerSystem that Hosts a File System	164
Use case: Get all File Servers that Have Local Access to a File System and their Access Paths	164
Use case: Get the Access Path to a File System on the Specified File Server	164
Use case: Get the Local Access Settings for a File System on the Specified File Server	164
Use case: Get the File Shares of a given File System exported from the specified File Server	165
File System Manipulation Subprofile	166
Overview	166
Methods of the Profile	166
1.	166
2.	166
3.	166
Extrinsic Methods on Capabilities	166
Method: FileSystemCapabilities.CreateGoalSettings	166
Method: LocallyAccessibleFileSystemCapabilities.CreateGoalSettings	167
Extrinsic Methods on FileSystemConfigurationService	168
Method: FileSystemConfigurationService.SNIA_CreateFileSystem	168
Method: FileSystemConfigurationService.SNIA_ModifyFileSystem	170
Method: FileSystemConfigurationService.DeleteFileSystem	172
Client considerations	173
4.	173
Model Specification	173
Use case: Create Locally Accessible Setting for Filesystem	173
Use case: Create a Locally Accessible Filesystem on a StoragePool	174
Use case: Modify the Name of a Filesystem	174
Use case: Increase the size of a File System	175
Use case: Delete a File System and return underlying StorageExtent	176
File Export Profile	177
Overview	177
Methods of the Profile	177
Client considerations	177
Use case: Discover all File Shares Hosted on a File Server	177
Use case: Discover all File Shares of a File System	177
Use case: Get the Settings of a File Share	177
File Export Manipulation Subprofile	178
Overview	178
Methods of the Profile	178
Extrinsic Methods on Capabilities	178
Method: NFSShareCapabilities.CreateGoalSettings	178
Method: CIFSShareCapabilities.CreateGoalSettings	179
Extrinsic Methods on FileExportService	180
Method: FileExportService.SNIA_CreateExportedShare	180
Method: FileExportService.SNIA_ModifyExportedShare	182
Method: FileExportService.ReleaseExportedShare	183
Method: FileExportService.AssignPrivilegeToExportedShare	184
Client considerations	184
1.	184
2.	184
3.	184
4.	184
Use case: Check the Supported Capabilities Pattern of a FileExportService	184
Use case: Create Settings for File Share	185
Use case: Create a File Share	185
Use case: Modify the Settings of a CIFS File Share	186
Use case: Release an Exported File Share	188
Simple Identity Management Profile	189
Overview	189
Method of the Profile	189
Intrinsic/Extrinsic Methods on UserContact Manipulation	189
Method: List all UserContacts	189
Method: Create UserContact	189
Method: Retrieve UserContact	190
Method: Remove UserContact	191
Intrinsic/Extrinsic Methods on Privilege Manipulation	191
Method: List all AssociatedPrivileges	191
NOTE: EMC recommends that users do not directly invoke the intrinsic method EnumerateInstances of CIM_AssociatedPrivilegeAssoc to list all existing ACEs.	191
Method: List all AssociatedPrivileges on a CIFS Share	191
Method: Assign Privilege	192
Method: Delete Privilege	193
Method: Modify Privilege	193
Client consideration	193
Model Specification	193
Use case: Create UserContact and Identities for a domain user	195
Use case: Get the UserContact for a specified domain user whose UserContact has been created	195
Use case: Removal of an existing UserContact	196
Use case: Get the Privilege and UserContact by an Exported File Share	196
Use case: Assign a privilege to a pair of UserContact and Exported FileShare	197
Use case: Modify privilege to a pair of UserContact and Exported FileShare	198
Use case: Removal of the existing privilege	198
Filesystem Performance Subprofile	199
Overview	199
Method of the Profile	199
Extrinsic Methods on Manifest Management	199
Method: CreateManifestCollection	199
Method: AddOrModifyManifest	200
Method: RemoveManifest	201
Extrinsic Methods on Statistics Query	201
Method: GetStatisticsCollection	201
Client Considerations	203
Model Specification	203
Use case: Check Filesystem Performance Supported Capabilities	203
Use case: Create Client-Defined Manifest Collection	204
Use case: Remove Client-Defined Manifest Collection	204
Use case: Add Client-Defined Manifest	204
Use case: Remove Client-Defined Manifest	204
Use case: Retrieve Statistics for a Specified Element	205
Use case: Get Statistics Collection	205
Appendix A: Known Issues in Third Party Integration	206
Microsoft System Center 2012 Virtual Machine Manager (SCVMM)	206
Display Name of Pool Selection	206

Match case Limit results 1 per page

Return code

Type

Description

•

If TheElement is not type of SnapVolume. (for Copy Service)

CIM_Error

The ECOM will throw exceptions when any of the below cases are met:

•

Any of the required parameters is NULL.

•

The Element is not type of CIM_LogicalElement.

•

Any of the Instance References – TheElement cannot be found in the system.

Client considerations

Model specification

•

StoragePool Manipulation

StoragePool

creation, deletion and modification are not supported.

•

LogicalDevice Manipulation

LogicalDisk

Read-Only

StorageVolume

is only supported to be created from

StoragePool

•

StorageSetting (to StorageCapabilities)

All

CIM_StorageSetting

(associated to

CIM_StorageCapabilities

) are predefined, which means

property

ChangeableType

is set to ‘

0: Fixed, Not changeable

’. User generated storage settings

are not supported.

Different storage pool can be linked to the same

CIM_StorageSetting

instance because only

predefined storage settings are supported.

•

StorageVolume (LUN) Creation

When SMI-S API creates a StorageVolume, it will create a standalone virtual disk. The

StorageVolume will get the default FAST VP tiering policy of “Start high then auto-tier”.

•

StorageVolume (LUN) Enumeration

All Virtual Disks, no matter they are Standalone or in an Application (modeled as

CIM_ReplicationGroup

), and also no matter they are in Generic SCSI Storage Application or

other type of Applications. In SMI-S view, there will be one

CIM_StorageVolume

instance per

virtual disk to CIM client.

•

StorageVolume (LIN) Deletion

A StorageVolume can be deleted successfully through SMI-S API under following conditions:

1) There is no host access;

2) There is no snapshot on the StorageVolume;

3) The StorageVolume is not involved by any Replication Group.

Since Application is modeled as SMI-S Replication Group while Virtual Disks in Applications other

than Generic SCSI Storage cannot be removed from its owner Application. As a result, SMI-S

clients are only able to delete Standalone Virtual Disk or Virtual Disks within Generic SCSI

Storage Application. It also avoids the deletion of Virtual Disks for other purposes.

•

Additional properties on StoragePool