Upload
duongtram
View
261
Download
10
Embed Size (px)
Citation preview
ETERNUS SMI-S User's Guide
P3AM-4602-06ENZ0
ETERNUS DX80 S2/DX90 S2, ETERNUS DX410 S2/DX440 S2, ETERNUS DX8100 S2/DX8700 S2
This page is intentionally left blank.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
3
Preface
This manual explains how to set and manage the ETERNUS DX80 S2/DX90 S2, ETERNUS DX410 S2/DX440 S2,or ETERNUS DX8100 S2/DX8700 S2 Disk storage system using SMI-S from software such as storagemanagement client software.This manual is designed for users with knowledge about the basic functions of the ETERNUS DX80 S2/DX90 S2,ETERNUS DX410 S2/DX440 S2, or ETERNUS DX8100 S2/DX8700 S2 Disk storage system, and SMI-S.In this manual, the ETERNUS DX80 S2/DX90 S2, ETERNUS DX410 S2/DX440 S2, and ETERNUS DX8100 S2/DX8700 S2 Disk storage systems are collectively referred to as "ETERNUS DX Disk storage system".
Sixth EditionJune 2013
The Structure and Contents of this Manual
This manual is composed of the following six chapters and appendices.
● Chapter 1 Overview
This chapter provides an overview of SMI-S.
● Chapter 2 SMI-S Settings
This chapter explains how to enable SMI-S.
● Chapter 3 Privileges
This chapter describes the privileges that are required for connecting to the ETERNUS DX Disk storagesystem from storage management client software.
● Chapter 4 Device Configuration Display
This chapter describes the classes that represent the device configuration and the associations for thedevice configuration.
● Chapter 5 Device Configuration Modifications
This chapter describes the interfaces that are used to change the device configuration and return values.
● Chapter 6 Notification of Device Configuration Modifications
This chapter describes notification of changes to the device configuration.
"The number of SMI-S that can be simultaneously connected" and "About Using of Open Sources" are providedas appendices.
The company names, product names and service names mentioned in this document are registeredtrademarks or trademarks of their respective companies.
Table of Contents
Chapter 1 Overview 6
1.1 Overview ............................................................................................................................. 6
1.2 Features .............................................................................................................................. 6
1.3 Accessing SMI-S .................................................................................................................. 6
1.4 Supported Version ............................................................................................................... 7
1.5 Supported Profiles and Subprofiles ..................................................................................... 71.5.1 Supported Profiles ........................................................................................................................................... 71.5.2 Supported Subprofiles ..................................................................................................................................... 7
1.6 Interop Namespace ............................................................................................................. 8
Chapter 2 SMI-S Settings 9
Chapter 3 Privileges 10
Chapter 4 Device Configuration Display 11
4.1 Device Configuration Display Class List ............................................................................. 11
Chapter 5 Device Configuration Modifications 27
5.1 List of Device Configuration Change Methods ................................................................... 27
5.2 Device Configuration Change Method Interfaces .............................................................. 295.2.1 FUJITSU_StorageConfigurationService::CreateOrModifyStoragePool ............................................................... 295.2.2 FUJITSU_StorageConfigurationService::DeleteStoragePool ............................................................................. 305.2.3 FUJITSU_StorageConfigurationService::CreateOrModifyElementFromStoragePool .......................................... 315.2.4 FUJITSU_StorageConfigurationService::ReturnToStoragePool ......................................................................... 335.2.5 FUJITSU_StorageConfigurationService::CreateOrModifyElementFromElements .............................................. 345.2.6 FUJITSU_StorageConfigurationService::CreateReplica ..................................................................................... 365.2.7 FUJITSU_StorageConfigurationService::ModifySynchronization ...................................................................... 375.2.8 FUJITSU_ControllerConfigurationService::ExposePaths ................................................................................... 385.2.9 FUJITSU_ControllerConfigurationService::HidePaths ....................................................................................... 405.2.10 FUJITSU_ControllerConfigurationService::ExposeDefaultLUs ........................................................................... 425.2.11 FUJITSU_ControllerConfigurationService::HideDefaultLUs .............................................................................. 435.2.12 FUJITSU_PrimordialStorageCapabilities::CreateSetting ................................................................................... 45
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
4
Table of Contents
5.2.13 FUJITSU_RAIDStorageCapabilities::CreateSetting ........................................................................................... 455.2.14 FUJITSU_PrimordialStoragePool::GetSupportedSizes ...................................................................................... 465.2.15 FUJITSU_PrimordialStoragePool::GetSupportedSizeRange .............................................................................. 475.2.16 FUJITSU_PrimordialStoragePool::GetAvailableExtents .................................................................................... 485.2.17 FUJITSU_RAIDStoragePool::GetSupportedSizes ............................................................................................... 485.2.18 FUJITSU_RAIDStoragePool::GetSupportedSizeRange ...................................................................................... 495.2.19 FUJITSU_RAIDStoragePool::GetAvailableExtents ............................................................................................ 505.2.20 FUJITSU_StorageHardwareIDManagementService::CreateStorageHardwareID ............................................... 515.2.21 FUJITSU_StorageHardwareIDManagementService::DeleteStorageHardwareID ............................................... 525.2.22 FUJITSU_ReplicationService::CreateElementReplica ....................................................................................... 535.2.23 FUJITSU_ReplicationService::ModifyReplicaSynchronization ........................................................................... 585.2.24 FUJITSU_ReplicationService::ModifyListSynchronization ................................................................................. 615.2.25 FUJITSU_ReplicationService::GetReplicationRelationships .............................................................................. 635.2.26 FUJITSU_ReplicationServiceCapabilities::ConvertSyncTypeToReplicationType ................................................. 645.2.27 FUJITSU_ReplicationServiceCapabilities::ConvertReplicationTypeToSyncType ................................................. 655.2.28 FUJITSU_ReplicationServiceCapabilities::GetSupportedFeatures ..................................................................... 675.2.29 FUJITSU_ReplicationServiceCapabilities::GetSupportedCopyStates ................................................................. 685.2.30 FUJITSU_ReplicationServiceCapabilities::GetSupportedWaitForCopyStates ..................................................... 695.2.31 FUJITSU_ReplicationServiceCapabilities::GetSupportedOperations ................................................................. 705.2.32 FUJITSU_ReplicationServiceCapabilities::GetSupportedListOperations ........................................................... 715.2.33 FUJITSU_ReplicationServiceCapabilities::GetSupportedMaximum .................................................................. 715.2.34 FUJITSU_ReplicationServiceCapabilities::GetDefaultReplicationSettingData .................................................. 725.2.35 FUJITSU_ThinProvisioningCapabilities::CreateSetting ..................................................................................... 735.2.36 FUJITSU_ThinProvisioningPool::GetSupportedSizes ........................................................................................ 735.2.37 FUJITSU_ThinProvisioningPool::GetSupportedSizeRange ................................................................................ 745.2.38 FUJITSU_ThinProvisioningPool::GetAvailableExtents ...................................................................................... 75
Chapter 6 Notification of Device Configuration Modifications 76
6.1 Notification of Device Configuration Change/Device Errors ............................................... 76
6.2 Notification Conditions ..................................................................................................... 76
6.3 Note .................................................................................................................................. 77
Appendix A The Number of SMI-S that can be Simultaneously Connected 78
Appendix B About Using of Open Sources 79
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
5
Chapter 1
Overview
This chapter provides an overview of the ETERNUS DX Disk storage system SMI-S.
1.1 Overview
Storage Management Initiative Specification (SMI-S) is an interface specification designed by the StorageNetworking Industry Association (SNIA) to standardize external interfaces that are related to storage systemmanagement.SMI-S is installed and configured in the controllers of the ETERNUS DX Disk storage system. SMI-S is accessedfrom storage management client software using HTTP.
1.2 Features
The main features of SMI-S are as follows:
● Device configuration display
SMI-S can be used to notify the device configuration, including disks and volumes.
● Device configuration change
SMI-S can be used to create or delete RAID groups and volumes. SMI-S can also be used to performAdvanced Copy.
● Notification of device configuration modifications
SMI-S can be used to notify when the device configuration is changed such as when a volume is created ordeleted.
1.3 Accessing SMI-S
SMI-S is accessed using HTTP (port 5988) or HTTPS (port 5989) from the SMI-S client (storage managementclient software). SMI-S receives requests from the MNT port on the master controller module.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
6
Chapter 1 Overview 1.4 Supported Version
1.4 Supported Version
The supported SMI-S version is "SMI-S 1.4".
1.5 Supported Profiles and Subprofiles
The following tables show the profiles and the subprofiles that are supported by SMI-S.
1.5.1 Supported Profiles
1.5.2 Supported Subprofiles
Profile name Overview
Server Profile SMI-S server information
Array Profile RAID device model
Profile Registration Profile Profile information
Replication Services Profile Copy service
Package/Subprofile name Overview
Access Points Subprofile Access point
Block Service Package Display and setting of RAID groups and LUNs
Copy Services Subprofile Copy service
Disk Drive Lite Subprofile Detailed information display of physical disks
Extent Composition Subprofile Volume creation
FC Target port Subprofile FC target port
Generic Target Ports Profile Device target port
Health Package Device error status display
iSCSI Target Ports Subprofile iSCSI target port
Masking and Mapping Subprofile LUN masking and mapping
Multiple Computer System Subprofile CM information
Physical Package Package Physical package
Serial Attached SCSI Target Ports Subprofile SAS target port
Software Subprofile Software version
Thin Provisioning Thin Provisioning
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
7
Chapter 1 Overview 1.6 Interop Namespace
1.6 Interop Namespace
Interop Namespace is "interop".
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
8
Chapter 2
SMI-S Settings
This chapter explains how to enable SMI-S.
It is necessary to enable the SMI-S setting to use SMI-S. To enable SMI-S, perform either of the followingactions:
ETERNUS Web GUI: Set the SMI-S setting to "Enable"ETERNUS CLI: Run "set smi-s -function enable"
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
9
Chapter 3
Privileges
This chapter describes the privileges that are required for connecting to the ETERNUS DX Disk storage systemfrom storage management client software.
For user accounts to connect to the ETERNUS DX Disk storage system from storage management clientsoftware, select one of the following role types:
• Default rolesPreset privileges are assigned to the default roles. Admin, Storage Admin, Maintainer, and Software areavailable as default roles.
• Custom rolesUser customized roles are created. All of the privileges that are listed in the following table must beassigned.
No. Privilege required
1 Status Display
2 RAID Group Management
3 Volume - Create / Modify
4 Volume - Delete / Format
5 Host Interface Management
6 Advanced Copy Management
7 Copy Session Management
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
10
Chapter 4
Device Configuration Display
This chapter describes the device configuration display.
4.1 Device Configuration Display Class List
■ Instance Providers
The following table shows the classes (Instance Providers) that represent the device configurationinformation:
No. Class name Description
Server Profile (SMI-S server information)
1 FUJITSU_System SMI-S server information
2 FUJITSU_ObjectManager CIM Object Manager (CIMOM) information
3 FUJITSU_Namespace SMI-S Namespace information
4 FUJITSU_CIMXMLCommunicationMechanism
Communication specification information of the SMI-S server
Profile Registration Profile (profile information)
5 FUJITSU_ProviderSoftwareIdentity SMI-S provider information
6 FUJITSU_RegisteredProfile Supported profile information
7 FUJITSU_RegisteredSubProfile Supported subprofile information
Array Profile (RAID device model)
8 FUJITSU_StorageComputerSystem Storage information
Access Points Subprofile (access point)
9 FUJITSU_RemoteServiceAccessPoint Storage connection destination information
Multiple Computer System Subprofile (CM information)
10 FUJITSU_RedundancySet CM redundancy information
11 FUJITSU_PhysicalMemory Information of memory installed on a CM
Software Subprofile (software version)
12 FUJITSU_ControllerModuleSoftwareIdentity
CM firmware information
13 FUJITSU_StorageComputerSystemSoftwareIdentity
CM firmware information
Disk Drive Lite Subprofile (detailed information display of physical disks)
14 FUJITSU_DiskDrive Disk drive information
15 FUJITSU_DiskExtent Disk drive specification information
16 FUJITSU_PhysicalMedia Hard disk information
17 FUJITSU_DiskSoftwareIdentity Disk firmware information
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
11
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
18 FUJITSU_StorageRedundancySet Hot spare disk information
Extent Composition Subprofile (volume creation)
19 FUJITSU_RAIDCompositeExtent RAID group information
20 FUJITSU_FreeExtent Free space information of a RAID group
21 FUJITSU_PartOfConcatenatedExtent LUN concatenation information
22 FUJITSU_MirroredExtent RAID group (for mirroring) information
23 FUJITSU_ConcatenatedExtent Concatenation volume information
24 FUJITSU_StripingCompositeExtent RLU (striping) information
25 FUJITSU_FlexibleTierExtent Flexible Tier Pool (FTRP) information
26 FUJITSU_FlexibleTierSubExtent Flexible Tier Sub Pool (FTSP) information
Masking and Mapping Subprofile (LUN masking and mapping)
27 FUJITSU_ProtocolControllerMaskingCapabilities
Details of the host affinity group function
28 FUJITSU_PrivilegeManagementService Host affinity group setting function
29 FUJITSU_StorageHardwareIDManagementService
Host information setting function
30 FUJITSU_ControllerConfigurationService Masking and Mapping function
31 FUJITSU_AuthorizedPrivilege Host affinity group information
32 FUJITSU_StorageHardwareID Host information
33 FUJITSU_DefaultAuthorizedPrivilege Default host affinity group information
34 FUJITSU_DefaultStorageHardwareID Default host information
35 FUJITSU_LUNMappingController LUN mapping information
36 FUJITSU_AffinityGroupController Affinity group information
FC Target Ports Subprofile (FC target port)
37 FUJITSU_FCPort FC port information
38 FUJITSU_SCSIProtocolEndPoint Port information
Block Services Package (display and setting of RAID groups and LUNs)
39 FUJITSU_StorageConfigurationService Function to operate a RAID group configuration
40 FUJITSU_StorageConfigurationCapabilities
Details of the function to operate a RAID group configuration
41 FUJITSU_StorageVolume Volume information
42 FUJITSU_PrimordialStoragePool Unused area information
43 FUJITSU_PrimordialStorageCapabilities Unused area setting information
44 FUJITSU_RAIDStorageCapabilities RAID group setting information (RAID level information)
45 FUJITSU_StorageSetting Volume setting information
46 FUJITSU_RAIDStoragePool RAID group area information
47 FUJITSU_FlexibleTierPool Flexible Tier Pool (FTRP) area information
48 FUJITSU_FlexibleTierSubPool Flexible Tier Sub Pool (FTSP) area information
49 FUJITSU_FlexibleTierCapabilities Flexible Tier Pool (FTRP) setting information
50 FUJITSU_FlexibleTierSubCapabilities Flexible Tier Sub Pool (FTSP) setting information
No. Class name Description
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
12
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
Physical Package Package (physical package)
51 FUJITSU_StorageProduct Storage product information
52 FUJITSU_ControllerEnclosure CE information
53 FUJITSU_ControllerSlot CM slot information
54 FUJITSU_ControllerCard CM card information
55 FUJITSU_ChannelAdapterSlot (*2) CA slot information
56 FUJITSU_ChannelAdapterCard (*2) CA card information
57 FUJITSU_DeviceEnclosure DE information
58 FUJITSU_DiskSlot Disk slot information
59 FUJITSU_PhysicalDisk Disk drive physical information
60 FUJITSU_DiskProduct Disk product information
61 FUJITSU_SCU (*1) SCU information
62 FUJITSU_Location Storage location information
63 FUJITSU_PSU PSU information
64 FUJITSU_FAN (*2) Fan information
65 FUJITSU_IOM IOM information
66 FUJITSU_BBU (*3) BBU information
67 FUJITSU_BCU (*2) BCU information
68 FUJITSU_BTU (*2) BTU information
69 FUJITSU_SFP SFP information
Health Package (device error status display)
70 FUJITSU_ControllerComputerSystem CM information
Serial Attached SCSI Target Ports Subprofile (SAS target port)
71 FUJITSU_SASPort (*1) SAS port information
72 FUJITSU_SASPHY(*1) SASPHY information
iSCSI Target Ports Subprofile (iSCSI target port)
73 FUJITSU_iSCSICapabilities iSCSI support information
74 FUJITSU_IPProtocolEndpoint IP protocol layer information
75 FUJITSU_TCPProtocolEndpoint TCP protocol layer information
76 FUJITSU_iSCSIProtocolEndpoint iSCSI protocol layer information
77 FUJITSU_iSCSISession iSCSI session information
78 FUJITSU_iSCSISessionSettings iSCSI session setting information
79 FUJITSU_EthernetPort iSCSI port information
80 FUJITSU_iSCSIConnection iSCSI connection information
81 FUJITSU_iSCSIConnectionSettings iSCSI connection setting information
82 FUJITSU_iSCSISessionStatistics iSCSI session statistics information
Replication Services Profile (copy service)
83 FUJITSU_ConnectivityCollection Device network summary information
84 FUJITSU_ReplicationService Copy operation function
85 FUJITSU_ReplicationServiceCapabilities Details of a copy operation function
86 FUJITSU_ReplicationSettingData Copy operation setting information
87 FUJITSU_RemoteStorageVolume Volume information of other device
No. Class name Description
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
13
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
*1: Only for the ETERNUS DX80 S2/DX90 S2*2: Only for the ETERNUS DX410 S2/DX440 S2*3: Only for the ETERNUS DX8100 S2/DX8700 S2
88 FUJITSU_RemoteSCSIProtocolEndpoint FC/iSCSI port information of the connection destination device
Copy Services Subprofile (copy service)
89 FUJITSU_StorageReplicationCapabilities Details of the "StorageConfigurationService" copy function
90 FUJITSU_SDPVExtent Snap Data Pool Volume (SDPV) information
91 FUJITSU_SDPVPool Snap Data Pool Volume (SDPV) area information
92 FUJITSU_SDPVCapabilities Snap Data Pool Volume (SDPV) setting information
93 FUJITSU_SnapDataCompositeExtent Snap Data Pool (SDP) information
94 FUJITSU_SnapDataPool Snap Data Pool (SDP) area information
95 FUJITSU_SnapDataCapabilities Snap Data Pool (SDP) setting information
Thin Provisioning Profile (Thin Provisioning function)
96 FUJITSU_ThinProvisioningCapabilities Thin Provisioning Pool (TPP) setting information
97 FUJITSU_ThinProvisioningExtent Thin Provisioning Pool (TPP) information
98 FUJITSU_ThinProvisioningPool Thin Provisioning Pool (TPP) area information
99 FUJITSU_ThinProvisioningFreeExtent Thin Provisioning Pool (TPP) free space information
No. Class name Description
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
14
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
■ Association Provider
The following table shows the classes (Association Providers) that are associated with the deviceconfiguration information:
No. Class name Association class
1 FUJITSU_AllocatedFromStoragePool FUJITSU_PrimordialStoragePool
FUJITSU_RAIDStoragePool
FUJITSU_RAIDStoragePool
FUJITSU_StorageVolume
FUJITSU_RAIDStoragePool
FUJITSU_SDPVPool
FUJITSU_SDPVPool
FUJITSU_SnapDataPool
FUJITSU_SnapDataPool
FUJITSU_StorageVolume
FUJITSU_RAIDStoragePool
FUJITSU_ThinProvisioningPool
FUJITSU_ThinProvisioningPool
FUJITSU_StorageVolume
FUJITSU_FlexibleTierPool
FUJITSU_StorageVolume
FUJITSU_FlexibleTierPool
FUJITSU_FlexibleTierSubPool
FUJITSU_RAIDStoragePool
FUJITSU_FlexibleTierSubPool
2 CIM_AssociatedComponentExtent FUJITSU_PrimordialStoragePool
FUJITSU_DiskExtent
FUJITSU_RAIDStoragePool
FUJITSU_RAIDCompositeExtent
FUJITSU_SDPVPool
FUJITSU_SDPVExtent
FUJITSU_SnapDataPool
FUJITSU_SnapDataCompositeExtent
FUJITSU_ThinProvisioningPool
FUJITSU_ThinProvisioningExtent
FUJITSU_FlexibleTierPool
FUJITSU_FlexibleTierExtent
FUJITSU_FlexibleTierSubPool
FUJITSU_FlexibleTierSubExtent
3 CIM_AssociatedRemainingExtent FUJITSU_RAIDStoragePool
FUJITSU_FreeExtent
FUJITSU_ThinProvisioningPool
FUJITSU_ThinProvisioningFreeExtent
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
15
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
4 CIM_AuthorizedSubject FUJITSU_AuthorizedPrivilege
FUJITSU_StorageHardwareID
FUJITSU_DefaultAuthorizedPrivilege
FUJITSU_DefaultStorageHardwareID
5 CIM_AuthorizedTarget FUJITSU_AuthorizedPrivilege
FUJITSU_AffinityGroupController
FUJITSU_DefaultAuthorizedPrivilege
FUJITSU_LUNMappingController
6 CIM_BasedOn FUJITSU_DiskExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_DiskExtent
FUJITSU_MirroredExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_FreeExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_StorageVolume
FUJITSU_ConcatenatedExtent
FUJITSU_StorageVolume
FUJITSU_PartOfConcatenatedExtent
FUJITSU_ConcatenatedExtent
FUJITSU_PartOfConcatenatedExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_SDPVExtent
FUJITSU_SDPVExtent
FUJITSU_SnapDataCompositeExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_ThinProvisioningExtent
FUJITSU_ThinProvisioningExtent
FUJITSU_StorageVolume
FUJITSU_ThinProvisioningExtent
FUJITSU_ThinProvisioningFreeExtent
FUJITSU_FlexibleTierExtent
FUJITSU_StorageVolume
FUJITSU_FlexibleTierExtent
FUJITSU_FlexibleTierSubExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_FlexibleTierSubExtent
7 CIM_BindsTo FUJITSU_IPProtocolEndpoint
FUJITSU_TCPProtocolEndpoint
FUJITSU_TCPProtocolEndpoint
FUJITSU_iSCSIProtocolEndpoint
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
16
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
8 CIM_CommMechanismForManager FUJITSU_ObjectManager
FUJITSU_CIMXMLCommunicationMechanism
9 CIM_ComponentCS FUJITSU_StorageComputerSystem
FUJITSU_ControllerComputerSystem
10 CIM_CompositeExtentBasedOn FUJITSU_DiskExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_MirroredExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_StripingCompositeExtent
FUJITSU_RAIDCompositeExtent
FUJITSU_DiskExtent
FUJITSU_StripingCompositeExtent
11 CIM_ComputerSystemPackage FUJITSU_ControllerEnclosure
FUJITSU_StorageComputerSystem
FUJITSU_DeviceEnclosure
FUJITSU_StorageComputerSystem
FUJITSU_ControllerCard
FUJITSU_ControllerComputerSystem
12 CIM_ConcreteComponent FUJITSU_PrimordialStoragePool
FUJITSU_DiskExtent
FUJITSU_RAIDStoragePool
FUJITSU_RAIDCompositeExtent
FUJITSU_RAIDStoragePool
FUJITSU_FreeExtent
FUJITSU_SASPort (*1)
FUJITSU_SASPHY (*1)
FUJITSU_ThinProvisioningPool
FUJITSU_ThinProvisioningExtent
FUJITSU_ThinProvisioningPool
FUJITSU_ThinProvisioningFreeExtent
FUJITSU_FlexibleTierPool
FUJITSU_FlexibleTierExtent
FUJITSU_FlexibleTierSubPool
FUJITSU_FlexibleTierSubExtent
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
17
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
13 CIM_ConcreteDependency FUJITSU_ControllerConfigurationService
FUJITSU_AffinityGroupController
FUJITSU_ControllerConfigurationService
FUJITSU_LUNMappingController
FUJITSU_StorageHardwareIDManagementService
FUJITSU_StorageHardwareID
FUJITSU_StorageHardwareIDManagementService
FUJITSU_DefaultStorageHardwareID
FUJITSU_PrivilegeManagementService
FUJITSU_AuthorizedPrivilege
FUJITSU_PrivilegeManagementService
FUJITSU_DefaultAuthorizedPrivilege
FUJITSU_SDPVPool
FUJITSU_SDPVExtent
FUJITSU_SnapDataPool
FUJITSU_SnapDataCompositeExtent
FUJITSU_DiskExtent
FUJITSU_StorageVolume
FUJITSU_ThinProvisioningPool
FUJITSU_StorageVolume
FUJITSU_FlexibleTierSubPool
FUJITSU_StorageVolume
14 CIM_ConcreteIdentity FUJITSU_StorageComputerSystem
FUJITSU_RedundancySet
15 CIM_ConnectorOnPackage FUJITSU_DeviceEnclosure
FUJITSU_DiskSlot
FUJITSU_ControllerEnclosure
FUJITSU_ControllerSlot
FUJITSU_ControllerEnclosure (*2)
FUJITSU_ChannelAdapterSlot (*2)
FUJITSU_ControllerEnclosure (*1)
FUJITSU_DiskSlot (*1)
16 CIM_Container FUJITSU_ControllerCard (*2)
FUJITSU_FAN (*2)
FUJITSU_BCU (*2)
FUJITSU_BTU (*2)
FUJITSU_ChannelAdapterCard (*2)
FUJITSU_SFP (*2)
FUJITSU_ControllerCard (*1)
FUJITSU_SCU (*1)
FUJITSU_ControllerCard (*1)
FUJITSU_SFP (*1)
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
18
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
17 CIM_DeviceSAPImplementation FUJITSU_FCPort
FUJITSU_SCSIProtocolEndpoint
FUJITSU_EthernetPort
FUJITSU_IPProtocolEndpoint
FUJITSU_EthernetPort
FUJITSU_iSCSIProtocolEndpoint
FUJITSU_SASPort (*1)
FUJITSU_SCSIProtocolEndpoint (*1)
18 CIM_ElementCapabilities FUJITSU_StorageComputerSystem
FUJITSU_ProtocolControllerMaskingCapabilities
FUJITSU_PrimordialStoragePool
FUJITSU_PrimordialStorageCapabilities
FUJITSU_StorageConfigurationService
FUJITSU_StorageConfigurationCapabilities
FUJITSU_RAIDStoragePool
FUJITSU_RAIDStorageCapabilities
FUJITSU_StorageComputerSystem
FUJITSU_iSCSICapabilities
FUJITSU_ReplicationService
FUJITSU_ReplicationServiceCapabilities
FUJITSU_StorageConfigurationService
FUJITSU_StorageReplicationCapabilities
FUJITSU_SnapDataPool
FUJITSU_SnapDataCapabilities
18 CIM_ElementCapabilities FUJITSU_SDPVPool
FUJITSU_SDPVCapabilities
FUJITSU_ThinProvisioningPool
FUJITSU_StorageConfigurationCapabilities
FUJITSU_ThinProvisioningPool
FUJITSU_ThinProvisioningCapabilities
FUJITSU_FlexibleTierPool
FUJITSU_FlexibleTierCapabilities
FUJITSU_FlexibleTierSubPool
FUJITSU_FlexibleTierSubCapabilities
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
19
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
19 CIM_ElementConformsToProfile FUJITSU_RegisteredProfile
FUJITSU_ObjectManager
FUJITSU_RegisteredProfile
FUJITSU_StorageComputerSystem
FUJITSU_RegisteredProfile (SMISProfile information)
FUJITSU_RegisteredProfile (ServerProfile information)
FUJITSU_RegisteredProfile (SMISProfile information)
FUJITSU_RegisteredProfile (ArrayProfile information)
FUJITSU_RegisteredProfile (SMISProfile information)
FUJITSU_RegisteredSubProfile
20 CIM_ElementLocation FUJITSU_StorageComputerSystem
FUJITSU_Location
21 CIM_ElementSettingData FUJITSU_StorageVolume
FUJITSU_StorageSetting
FUJITSU_TCPProtocolEndpoint
FUJITSU_iSCSIConnectionSettings
FUJITSU_iSCSIProtocolEndpoint
FUJITSU_iSCSIConnectionSettings
FUJITSU_iSCSIProtocolEndpoint
FUJITSU_iSCSISessionSettings
FUJITSU_AffinityGroupController
FUJITSU_iSCSISessionSettings
FUJITSU_LUNMappingController
FUJITSU_iSCSISessionSettings
FUJITSU_ControllerComputerSystem
FUJITSU_iSCSISessionSettings
22 CIM_ElementSoftwareIdentity FUJITSU_DiskSoftwareIdentity
FUJITSU_DiskDrive
FUJITSU_ProviderSoftwareIdentity
FUJITSU_RegisteredProfile
FUJITSU_ProviderSoftwareIdentity
FUJITSU_RegisteredSubProfile
23 CIM_ElementStatisticalData FUJITSU_iSCSISession
FUJITSU_iSCSISessionStatistics
24 CIM_EndpointOfNetworkPipe FUJITSU_TCPProtocolEndpoint
FUJITSU_iSCSIConnection
FUJITSU_iSCSIProtocolEndpoint
FUJITSU_iSCSISession
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
20
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
25 CIM_HostedAccessPoint FUJITSU_StorageComputerSystem
FUJITSU_RemoteServiceAccessPoint
FUJITSU_System
FUJITSU_CIMXMLCommunicationMechanism
FUJITSU_ControllerComputerSystem
FUJITSU_SCSIProtocolEndpoint
FUJITSU_ControllerComputerSystem
FUJITSU_IPProtocolEndpoint
FUJITSU_ControllerComputerSystem
FUJITSU_TCPProtocolEndpoint
FUJITSU_ControllerComputerSystem
FUJITSU_iSCSIProtocolEndpoint
26 CIM_HostedCollection FUJITSU_StorageComputerSystem
FUJITSU_ConnectivityCollection
27 CIM_HostedService FUJITSU_StorageComputerSystem
FUJITSU_PrivilegeManagementService
FUJITSU_StorageComputerSystem
FUJITSU_StorageHardwareIDManagementService
FUJITSU_StorageComputerSystem
FUJITSU_ControllerConfigurationService
FUJITSU_StorageComputerSystem
FUJITSU_StorageConfigurationService
FUJITSU_System
FUJITSU_ObjectManager
FUJITSU_StorageComputerSystem
FUJITSU_ReplicationService
28 CIM_HostedStoragePool FUJITSU_StorageComputerSystem
FUJITSU_PrimordialStoragePool
FUJITSU_StorageComputerSystem
FUJITSU_RAIDStoragePool
FUJITSU_StorageComputerSystem
FUJITSU_SnapDataPool
FUJITSU_StorageComputerSystem
FUJITSU_SDPVPool
FUJITSU_StorageComputerSystem
FUJITSU_ThinProvisioningPool
FUJITSU_StorageComputerSystem
FUJITSU_FlexibleTierPool
FUJITSU_StorageComputerSystem
FUJITSU_FlexibleTierSubPool
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
21
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
29 CIM_InstalledSoftwareIdentity FUJITSU_ControllerComputerSystem
FUJITSU_ControllerModuleSoftwareIdentity
FUJITSU_ControllerComputerSystem
FUJITSU_StorageComputerSystemSoftwareIdentity
30 CIM_IsSpare FUJITSU_DiskExtent
FUJITSU_StorageRedundancySet (Global Hot Spare)
FUJITSU_DiskExtent
FUJITSU_StorageRedundancySet (Dedicated Hot Spare)
31 CIM_MediaPresent FUJITSU_DiskDrive
FUJITSU_DiskExtent
32 CIM_MemberOfCollection FUJITSU_RedundancySet
FUJITSU_ControllerComputerSystem
FUJITSU_StorageRedundancySet (Global Hot Spare)
FUJITSU_DiskExtent
FUJITSU_StorageRedundancySet (Dedicated Hot Spare)
FUJITSU_DiskExtent
FUJITSU_ConnectivityCollection
FUJITSU_SCSIProtocolEndpoint
FUJITSU_ConnectivityCollection
FUJITSU_iSCSIProtocolEndpoint
FUJITSU_ConnectivityCollection
FUJITSU_RemoteSCSIProtocolEndpoint
33 CIM_MemoryOnCard FUJITSU_ControllerCard
FUJITSU_PhysicalMemory
34 CIM_NamespaceInManager FUJITSU_ObjectManager
FUJITSU_Namespace
35 CIM_NetworkPipeComposition FUJITSU_iSCSISession
FUJITSU_iSCSIConnection
36 CIM_PackagedComponent FUJITSU_PhysicalDisk
FUJITSU_PhysicalMedia
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
22
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
37 CIM_PackageInChassis FUJITSU_ControllerEnclosure
FUJITSU_ControllerCard
FUJITSU_ControllerEnclosure (*2)
FUJITSU_ChannelAdapterCard (*2)
FUJITSU_ControllerEnclosure
FUJITSU_PSU
FUJITSU_DeviceEnclosure
FUJITSU_PhysicalDisk
FUJITSU_DeviceEnclosure
FUJITSU_PSU
FUJITSU_DeviceEnclosure
FUJITSU_IOM
FUJITSU_ControllerEnclosure (*1)
FUJITSU_PhysicalDisk (*1)
FUJITSU_ControllerEnclosure (*2)
FUJITSU_BCU (*2)
FUJITSU_ControllerEnclosure (*3)
FUJITSU_FAN (*3)
FUJITSU_ControllerEnclosure (*3)
FUJITSU_BBU (*3)
38 CIM_PackageInSlot FUJITSU_DiskSlot
FUJITSU_PhysicalDisk
FUJITSU_ControllerSlot
FUJITSU_ControllerCard
FUJITSU_ChannelAdapterSlot (*2)
FUJITSU_ChannelAdapterCard (*2)
39 CIM_ProductParentChild FUJITSU_StorageProduct
FUJITSU_DiskProduct
40 CIM_ProductPhysicalComponent FUJITSU_StorageProduct
FUJITSU_ControllerEnclosure
FUJITSU_StorageProduct
FUJITSU_DeviceEnclosure
FUJITSU_DiskProduct
FUJITSU_PhysicalDisk
41 CIM_ProtocolControllerForPort FUJITSU_AffinityGroupController
FUJITSU_FCPort
FUJITSU_LUNMappingController
FUJITSU_FCPort
42 CIM_ProtocolControllerForUnit FUJITSU_AffinityGroupController
FUJITSU_StorageVolume
FUJITSU_LUNMappingController
FUJITSU_StorageVolume
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
23
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
43 CIM_Realizes FUJITSU_PhysicalDisk
FUJITSU_DiskDrive
FUJITSU_ChannelAdapterCard (*2)
FUJITSU_EthernetPort (*2)
FUJITSU_ControllerCard (*1)
FUJITSU_SASPort (*1)
FUJITSU_ControllerCard (*1)
FUJITSU_EthernetPort (*1)
FUJITSU_SFP
FUJITSU_FCPort
FUJITSU_SFP
FUJITSU_EthernetPort
44 CIM_RealizesExtent FUJITSU_PhysicalMedia
FUJITSU_DiskExtent
45 CIM_ReferencedProfile FUJITSU_RegisteredProfile
FUJITSU_RegisteredProfile
46 CIM_ReplicaPoolForStorage FUJITSU_StorageVolume
FUJITSU_SnapDataPool
47 CIM_SAPAvailableForElement FUJITSU_SCSIProtocolEndpoint
FUJITSU_AffinityGroupController
FUJITSU_SCSIProtocolEndpoint
FUJITSU_LUNMappingController
FUJITSU_RemoteServiceAccessPoint
FUJITSU_StorageComputerSystem
FUJITSU_iSCSIProtocolEndpoint
FUJITSU_AffinityGroupController
FUJITSU_iSCSIProtocolEndpoint
FUJITSU_LUNMappingController
FUJITSU_SCSIProtocolEndpoint
FUJITSU_StorageVolume
FUJITSU_iSCSIProtocolEndpoint
FUJITSU_StorageVolume
48 CIM_ServiceAffectsElement FUJITSU_ReplicationService
FUJITSU_ConnectivityCollection
49 CIM_StorageSettingsAssociatedToCapabilities
FUJITSU_RAIDStorageCapabilities
FUJITSU_StorageSetting
FUJITSU_PrimordialStorageCapabilities
FUJITSU_StorageSetting
FUJITSU_ThinProvisioningCapabilities
FUJITSU_StorageSetting
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
24
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
50 CIM_StorageSynchronized FUJITSU_StorageVolume (copy source volume information)
FUJITSU_StorageVolume(copy destination volume information)
FUJITSU_StorageVolume
FUJITSU_RemoteStorageVolume
FUJITSU_RemoteStorageVolume
FUJITSU_StorageVolume
51 FUJITSU_StorageSynchronized FUJITSU_StorageVolume (copy source volume information)
FUJITSU_StorageVolume(copy destination volume information)
FUJITSU_StorageVolume
FUJITSU_RemoteStorageVolume
FUJITSU_RemoteStorageVolume
FUJITSU_StorageVolume
52 CIM_SubProfileRequiresProfile FUJITSU_RegisteredProfile
FUJITSU_RegisteredSubProfile
FUJITSU_RegisteredProfile
FUJITSU_RegisteredSubProfile
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
25
Chapter 4 Device Configuration Display 4.1 Device Configuration Display Class List
*1: Only for the ETERNUS DX80 S2/DX90 S2*2: Only for the ETERNUS DX410 S2/DX440 S2*3: Only for the ETERNUS DX8100 S2/DX8700 S2
53 CIM_SystemDevice FUJITSU_StorageComputerSystem
FUJITSU_AffinityGroupController
FUJITSU_StorageComputerSystem
FUJITSU_LUNMappingController
FUJITSU_StorageComputerSystem
FUJITSU_DiskDrive
FUJITSU_StorageComputerSystem
FUJITSU_DiskExtent
FUJITSU_StorageComputerSystem
FUJITSU_RAIDCompositeExtent
FUJITSU_StorageComputerSystem
FUJITSU_ConcatinatedExtent
FUJITSU_StorageComputerSystem
FUJITSU_StorageVolume
FUJITSU_ControllerComputerSystem
FUJITSU_FCPort
FUJITSU_ControllerComputerSystem
FUJITSU_EthernetPort
FUJITSU_StorageComputerSystem
FUJITSU_MirroredExtent
FUJITSU_ControllerComputerSystem (*1)
FUJITSU_SASPHY (*1)
FUJITSU_StorageComputerSystem
FUJITSU_StripingCompositeExtent
FUJITSU_StorageComputerSystem
FUJITSU_FreeExtent
FUJITSU_StorageComputerSystem
FUJITSU_PartOfConcatenatedExtent
FUJITSU_ControllerComputerSystem (*1)
FUJITSU_SASPort (*1)
FUJITSU_StorageComputerSystem
FUJITSU_ThinProvisioningExtent
FUJITSU_StorageComputerSystem
FUJITSU_ThinProvisioningFreeExtent
FUJITSU_StorageComputerSystem
FUJITSU_FlexibleTierExtent
FUJITSU_StorageComputerSystem
FUJITSU_FlexibleTierSubExtent
No. Class name Association class
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
26
Chapter 5
Device Configuration Modifications
This chapter describes changing the device configuration.
5.1 List of Device Configuration Change Methods
The following table shows the methods that are used to change the device configuration:
Class name Method name Function overview
FUJITSU_StorageConfigurationService
CreateOrModifyStoragePool
RAID group creation/update
DeleteStoragePool RAID group deletion
CreateOrModifyElementFromStoragePool
Volume creation
ReturnToStoragePool Volume deletion
CreateOrModifyElementFromElements
RAID group creationVolume creation
CreateReplica Copy session creation
ModifySynchronization Copy session change
FUJITSU_ControllerConfigurationService
ExposePaths Affinity group creation
HidePaths Affinity group deletion
ExposeDefaultLUs Volume and host LUN mapping
HideDefaultLUs Volume and host LUN unmapping
FUJITSU_PrimordialStorageCapabilities
CreateSetting Creation of a template that is consistent with the RAID group setting information
FUJITSU_RAIDStorageCapabilities
CreateSetting Creation of a template that is consistent with the RAID group setting information
FUJITSU_PrimordialStoragePool
GetSupportedSizes Acquisition of the supported capacity of a RAID group (unused area)
GetSupportedSizeRange Acquisition of the supported capacity of a RAID group (unused area)
GetAvailableExtents Acquisition of a list of the available disks in a RAID group (unused area)
FUJITSU_RAIDStoragePool
GetSupportedSizes Acquisition of the supported capacity of a RAID group
GetSupportedSizeRange Acquisition of the supported capacity of a RAID group
GetAvailableExtents Acquisition of a list of the available disks in a RAID group
FUJITSU_StorageHardwareIDManagementService
CreateStorageHardwareID WWW addition
DeleteStorageHardwareID WWW deletion
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
27
Chapter 5 Device Configuration Modifications 5.1 List of Device Configuration Change Methods
FUJITSU_ReplicationService
CreateElementReplica Copy session creation
ModifyReplicaSynchronization
Copy session change
ModifyListSynchronization
Change of multiple copy sessions
GetReplicationRelationships
Search for the association information for a copy session volume
FUJITSU_ReplicationServiceCapabilities
ConvertSyncTypeToReplicationType
Conversion from SyncType, Mode, and Local/Remote to ReplicationType
ConvertReplicationTypeToSyncType
Conversion from ReplicationType to SyncType, Mode, and Local/Remote
GetSupportedFeatures Acquisition of the supported copy-related functions
GetSupportedCopyStates
Acquisition of the supported CopyStates
GetSupportedWaitForCopyStates
Acquisition of the value that is supported as the "WaitForCopyState" parameter of the "Create/Modify" method
GetSupportedOperations Acquisition of the value that is supported as the "Operation" parameter of the "ModifyReplicaSynchronization" method
GetSupportedListOperations
Acquisition of the value that is supported as the "Operation" parameter of the "ModifyListSynchronization" method
GetSupportedMaximum Acquisition of the supported maximum value of the specified element
GetDefaultReplicationSettingData
Acquisition of the default copy operation setting information
FUJITSU_ThinProvisioningCapabilities
CreateSetting Creation of a template that is consistent with the Thin Provisioning Pool (TPP) area setting information
FUJITSU_ThinProvisioningPool
GetSupportedSizes Acquisition of the supported capacity of a Thin Provisioning Pool (TPP) area information
GetSupportedSizeRange Acquisition of the supported capacity of a Thin Provisioning Pool (TPP) area information
GetAvailableExtents Acquisition of a list of available disks from the Thin Provisioning Pool (TPP) area information
Class name Method name Function overview
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
28
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2 Device Configuration Change Method Interfaces
This section describes interfaces for the methods to change the device configuration.
5.2.1 FUJITSU_StorageConfigurationService::CreateOrModifyStoragePool
This method is used to create a RAID group or Thin Provisioning Pool (TPP) using the specified RAID groupname, RAID level, and disks.When disks are omitted, available disks are automatically selected.
Interface
Parameters
uint32 CreateOrModifyStoragePool(
[In] string ElementName,
[Out, In] CIM_ConcreteJob REF Job,
[In] CIM_StorageSetting REF Goal,
[Out, In] uint64 Size,
[In] string InPools [ ],
[In] string InExtents [ ],
[Out, In] CIM_StoragePool REF Pool
)
ElementName Specifies the name for the RAID group or TPP that is to be created.
Job Not set
Goal Specifies the setting values (such as the RAID level) for the RAID group or TPPthat is to be created.When NULL is specified, RAID groups are created in the following order:
1: RAID1+02: RAID13: RAID54: RAID6
Size Specifies the RAID group or TPP capacity (byte) that is to be created.When NULL is specified, the capacity is calculated according to the "Goal"parameter value.When the free space in the RAID group or TPP is smaller than the specifiedcapacity, the "Size Not Supported" error is returned.
InPools Specifies the RAID group (unused area).
InExtents Specifies the disks that are used for the RAID group or TPP that is to be created.When NULL is specified, the available disks are selected according to the "Goal"parameter value.
Pool Instance of the created RAID group or TPP
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
29
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
5.2.2 FUJITSU_StorageConfigurationService::DeleteStoragePool
This method is used to delete a specified RAID group or Thin Provisioning Pool (TPP).
Interface
Parameters
Return values
Value Meaning Cause
0 Success Ends normally
1 Not Supported RAID group (unused area) was not specified.
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
4097 Size Not Supported Free space in the RAID group or TPP is smaller than the specified capacity.
Vendor specific error
32787 The device is in busy state The device is busy.
32788 Element Name is in use ElementName is already in use.
32808 No Thin Provisioning License No Thin Provisioning license
32816 Fatal error generic Fatal error (such as Exception)
uint32 DeleteStoragePool(
[Out, In] CIM_ConcreteJob REF Job,
[In] CIM_StoragePool REF Pool
)
Job Not set
Pool Specifies the RAID group or TPP that is to be deletedWhen NULL or RAID group (unused area) is specified, the "Invalid Parameter" error isreturned.
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
Vendor specific error
32785 The RAID group is in busy state The RAID group that is to be deleted is in use.
32787 The device is in busy state The device is busy.
32803 The RAID group is not operative Disk Buffer is set in the RAID group.
32804 The RAID group has Thin Provisioning volumes
The RAID group that is to be deleted includes Thin Provisioning Volumes.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
30
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.3 FUJITSU_StorageConfigurationService::CreateOrModifyElementFromStoragePool
This method is used to create a volume in a specified RAID group or Thin Provisioning Pool (TPP).
Interface
Parameters
32808 No Thin Provisioning License No Thin Provisioning license
32816 Fatal error generic Unexpected error
Value Meaning Cause
uint32 CreateOrModifyElementFromStoragePool(
[In] string ElementName,
[In] uint16 ElementType,
[Out, In] CIM_ConcreteJob REF Job,
[In] CIM_ManagedElement REF Goal,
[Out, In] uint64 Size,
[In] CIM_StoragePool REF InPool,
[Out, In] CIM_LogicalElement REF TheElement
)
ElementName Specifies the name of the volume that is to be created.
ElementType Specifies the element that is to be created.Only "2" (volume) or "5" (Thin Provisioning Volume (TPV)) can be specified.When NULL or values other than "2" (volume) or "5" (Thin Provisioning Volume(TPV)) are specified, the "Method Not Supported" error is returned.
Job Not set
Goal Not used
Size [In]Specifies the capacity of the volume that is to be created in bytes.When NULL is specified, the "Invalid Parameter" error is returned.When the free space in the volume is smaller than the specified capacity, the"Size Not Supported" error is returned.When a TPV is specified for the element, an error does not occur even if thespecified capacity is larger than the actual free space because the specifiedcapacity is set as the virtual size.
[Out]The capacity of a created volume is set in bytes.When the free space in the volume is smaller than the specified capacity, the"Size Not Supported" error is returned and the capacity of the current freespace is set.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
31
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
InPool Specifies the RAID group or TPP from which the volume is to be created.When NULL or RAID group (unused area) is specified, the "Invalid Parameter"error is returned.
TheElement [In]Creates a volume when NULL is specified.When a value other than NULL is specified and a volume is specified for "Ele-mentType", the "Not Supported" error is returned.When a value other than NULL is specified and a TPV is specified for "Ele-mentType", the specified TPV is expanded.
[Out]The created or expanded volume is set.
Value Meaning Cause
0 Success Ends normally
1 Method Not Supported Unsupported error
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
4097 Size Not Supported The free space in the RAID (group) is smaller than the specified capacity.
Vendor specific error
32769 Maximum number of Logical Volume in a RAID group has been reached
The maximum number of volumes has already been created in the specified RAID group.
32770 Maximum number of Logical Volume in the storage device has been reached
The maximum number of volumes has already been created in the device.
32785 The RAID group is in busy state The RAID group is busy.
32786 The Logical Volume is in busy state The volume is busy.
32787 The device is in busy state The device is busy.
32788 Element Name is in use Element Name is already in use.
32796 Quick Format Error Quick Format error occurred.
32803 The RAID group is not operative MLU, MVV, TPPV, TPPC, and RDBV already exist in the specified RAID group.
32808 No Thin Provisioning License No Thin Provisioning license
32816 Fatal error generic Fatal error (such as Exception)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
32
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.4 FUJITSU_StorageConfigurationService::ReturnToStoragePool
This method is used to delete a specified volume.
Interface
Parameters
Return values
uint32 ReturnToStoragePool(
[Out, In] CIM_ConcreteJob REF Job,
[In] CIM_LogicalElement REF TheElement
)
Job Not set
TheElement Specifies the volume that is to be deleted.When NULL is specified, the "Invalid Parameter" error is returned.
Value Meaning Cause
0 Success Ends normally
1 Method Not Supported Unsupported error
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
Vendor specific error
32785 The RAID group is in busy state The RAID group is in use.
32786 The Logical Volume is in busy state The volume is in use.
32787 The device is in busy state The device is busy.
32802 The Logical Volume is Mainframe volume
The volume is a MLU/MVV.
32804 The Logical Volume is not operative
The volume is a TPPV.
32809 The Logical Element is ODX volume
The volume that is specified for "SourceElement" or "TargetElement" is dedicated for Offloaded Data Transfer.
32816 Fatal error generic Fatal error (such as Exception)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
33
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.5 FUJITSU_StorageConfigurationService::CreateOrModifyElementFromElements
This method is used to create a RAID group, TPP, or volume.
Interface
Parameters
uint32 CreateOrModifyElementFromElements(
[In] string ElementName,
[In] uint16 ElementType,
[Out, In] CIM_ConcreteJob REF Job,
[In] CIM_ManagedElement REF Goal,
[Out, In] uint64 Size,
[In] CIM_StorageExtent REF InElements [ ],
[Out, In] CIM_LogicalElement REF TheElement
)
ElementName Specifies the name of the volume, the RAID group, or the TPP that is to becreated.
ElementType Specifies the element that is to be created.Only "2" (volume), "4" (RAID group), or "6" (Thin Provisioning Volume (TPV)) canbe specified.When NULL is specified, the "Invalid Parameter" error is returned.When a value other than "2" (volume), "4" (RAID group), or "6" (TPV) is specified,the "Not Supported" error is returned.
Job Not set
Goal Specifies the setting value of the volume, the RAID group, or the TPP that is to becreated.
Example: For RAID1+0"FUJITSU_StorageSetting.InstanceID=FUJITSU:SS_RAID1+0"
When "2" (volume) or "6" (TPV) is specified for "ElementType", this parameter isnot used since this parameter depends on the RAID group specification.In addition, when NULL is specified while "4" (RAID group) is specified for"ElementType", a RAID group is created according to the PriorityRAID level that isobtained from the model name.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
34
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
Size [In]Specifies the capacity of the volume, the RAID group, or the TPP that is to becreated in bytes.When NULL is specified, free space is calculated and the volume, the RAIDgroup, or the TPP is created using all the free space.When the free space in the RAID group, the TPP, or the disk is smaller thanthe specified capacity, the "Size Not Supported" error is returned.When a TPV is specified for the element, an error does not occur even if thespecified capacity is larger than the actual free space because the specifiedcapacity is set as the virtual size.
[Out]The capacity of a created volume, RAID group, or TPP is set in bytes.When NULL is specified while "2" (volume) or "6" (TPV) is specified for"ElementType", the "Fatal error -- generic" error is returned.In addition, when the free space in the volume is smaller than the specifiedcapacity, the "Size Not Supported" error is returned and the capacity of thecurrent free space is set.
InElements Specifies the source StorageExtent (free space or disk) from which a volume aRAID group, or a TPP is to be created.When NULL or blank data is specified, the "Invalid Parameter" error is returned.
TheElement [In]Creates a new volume a new RAID group, or a new TPP when NULL isspecified.When a value other than NULL is specified:When "6" (TPV) is specified for "ElementType", the TPV is expanded.When a TPP is specified, the specified TPP is expanded.When a volume or a RAID group is specified, the "Method Not Supported"error is returned.
[Out]The created volume, RAID group, or TPP is set.
Value Meaning Cause
0 Completed with No Error Ends normally
1 Method Not Supported Unsupported error
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
4097 Size Not Supported The free space in the volume, the RAID group, or the TPP is smaller than the specified capacity.
Vendor specific error
32769 Maximum number of Logical Volume in a RAID group has been reached
The maximum number of volumes has already been created in the specified RAID group.
32770 Maximum number of Logical Volume in the storage device has been reached
The maximum number of volumes has already been created in the device.
32787 The device is in busy state The device is busy.
32788 Element Name is in use Element Name is already in use.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
35
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.6 FUJITSU_StorageConfigurationService::CreateReplica
This method is used to start the SnapOPC+/EC/REC copy sessions.
Interface
Parameters
32796 Quick Format Error Quick Format occurred.
32803 The RAID group is not operative MLU, MVV, TPPV, TPPC, and RDBV already exist in the specified RAID group.
32808 No Thin Provisioning License No Thin Provisioning license
32816 Fatal error generic Fatal error (such as Exception)
Value Meaning Cause
uint32 CreateReplica(
[In] string ElementName,
[Out] CIM_ConcreteJob REF Job,
[In] CIM_LogicalElement REF SourceElement,
[Out] CIM_LogicalElement REF TargetElement,
[In] CIM_StorageSetting REF TargetSettingGoal,
[In] CIM_StoragePool REF TargetPool
[In] uint16 CopyType
)
ElementName Specifies "ElementName" to assign to the copy destination volume that isto be created.When this parameter is omitted, "ElementName" is automaticallyassigned.
Job Not set
SourceElement Specifies the copy source volume.
TargetElement Specifies the copy destination volume.
TargetSettingGoal Specifies "StorageSetting" to be associated with "TargetPool".Not used
TargetPool Specifies the RAID group that includes the copy source volume to becreated.When this parameter is omitted, RAID groups are selected in ascendingorder starting from the smallest "RaidNumber" in "RAIDStoragePool" inwhich the copy destination volume can be created.
CopyType Specifies the copy type that is to be created."3" (EC) or "4" (SnapOPC) can be specified.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
36
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Allowed parameter settings for each copy type
Return values
For return values that are not listed in the following table, refer to the values that are listed fromVe n d o r S p e c i f i c o nw a rd i n t h e Ret u r n Va l u e s t a b l e o f " 5 . 2 . 2 2FUJITSU_ReplicationService::CreateElementReplica" (page 53).
5.2.7 FUJITSU_StorageConfigurationService::ModifySynchronization
This method is used to change a copy session (suspend, resume, reverse, and end).
Interface
Parameters
Parameters EC SnapOPC
CopyType 3(Sync) 4(UnSyncAssoc)
ElementName Optional Optional
SourceElement Required Required
TargetElement Not required Not required
TargetPool Optional Optional
Value Meaning Cause
0 Completed with No Error Ends normally
1 Not Supported Not supported
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
uint32 ModifySynchronization(
[In] uint16 Operation,
[Out] CIM_ConcreteJob REF Job,
[In] CIM_StorageSynchronized REF Synchronization
)
Operation Specifies the copy operation."2" (Detach), "3" (Fracture), "4" (Resync), or "5" (Restore) can be specified.For details on the available Operation values for each copy type, refer to"Allowed parameter settings for each copy type" (page 38).
Job Not set
Synchronization Specifies the association information of a target copy volume.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
37
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Allowed parameter settings for each copy type
*1: Execution in Suspend status
Return values
Re f e r to t h e v a l u e s t h a t a re l i s te d i n t h e Ret u r n Va l u e s t a b l e o f " 5 . 2 . 2 3FUJITSU_ReplicationService::ModifyReplicaSynchronization" (page 58) because the return values arethe same as these values.
5.2.8 FUJITSU_ControllerConfigurationService::ExposePaths
This method is used to create an affinity group, to add a logical volume initiator to a specified affinity group,or to perform mapping between logical volumes and host LUNs. CA ports cannot be added to the specified affinity group since only "One Port per View" is supported as theview type.
Interface
Parameters
Copy type Action Operation
EC/REC Suspend 3(Fracture)
Resume (*1) 4(Resync)
Restore(reverse + resume) (*1)
5(Restore)
Stop 2(Detach)
SnapOPC/SnapOPC+ Restore 5(Restore)
Stop 2(Detach)
uint32 ExposePaths(
[Out, In] CIM_ConcreteJob REF Job,
[In] string LUNames [ ],
[In] string InitiatorPortIDs [ ],
[In] string TargetPortIDs [ ],
[In] string DeviceNumbers [ ],
[In] uint16 DeviceAccesses [ ],
[Out, In] CIM_SCSIProtocolController REF ProtocolControllers [ ]
)
Job Not set
LUNames A list of the volumes that are to be mappedSpecifies the "Name" property values of "FUJITSU_StorageVolume".The number of elements must be the same as "DeviceAccesses".
InitiatorPortIDs A list of the initiator (host) port IDs that are to be mappedSpecifies the "StorageID" property values of "FUJITSU_StorageHardwareID".If an initiator does not exist, an initiator is registered.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
38
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Allowed parameter settings
Return values
TargetPortIDs A list of the target port IDs that are to be mappedSpecifies the "Name" property values of "FUJITSU_SCSIProtocolEndpoint/FUJITSU_iSCSIProtocolEndpoint" when an affinity group is created.
DeviceNumbers A list of the logical unit numbers (LUNs) that correspond to "LUNames".The number specified here can be checked in the "DeviceNumber" propertiesof "FUJITSU_ProtocolControllerForUnit".If the number is less than "LUNames", LUNs are automatically assigned.
DeviceAccesses A list of the privileges that are to be assigned to the volumes that correspondto "LUNames".Specify "2" (Read Write).The sett ing can be checked in the "DeviceAccess" propert ies of"FUJITSU_ProtocolControllerForUnit".
ProtocolControllers [In]Create a new affinity group when NULL is specified.When a value other than NULL is specified, a logical volume initiator isadded to the affinity group.
[Out]The created or updated affinity group is set.
Operation LUNames InitiatorPortIDs
TargetPortIDs
DeviceNumbers
DeviceAccesses
ProtocolControllers
Affinity creation Mandatory Mandatory Mandatory Optional Mandatory NULL
LUN addition Mandatory NULL NULL Optional Mandatory single SPC
Host addition NULL Mandatory NULL NULL NULL single SPC
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
4097 Invalid logical unit ID An invalid volume was specified for the "LUNames" parameter.
4098 Invalid initiator port ID An invalid host was specified for the "InitiatorPortIDs" parameter.
4099 Invalid target port ID An invalid CA port was specified for the "TargetPortIDs" parameter.
4100 Invalid permission A value other than "2" (Read Write) was specified for the "DeviceAccesses" parameter.
4101 Target/initiator combination already exposed
The host and CA port combination already exists.
4102 Requested logical unit number in use
The LUN for the "DeviceNumbers" parameter is already in use.
4103 Maximum Map Count Exceeded The maximum number of LUNs that can be set is exceeded.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
39
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.9 FUJITSU_ControllerConfigurationService::HidePaths
This method is used to delete an affinity group, to remove a logical volume initiator from the specified affinitygroup, or to delete mapping between logical volumes and host LUNs. CA ports cannot be deleted from the specified affinity group since only "One Port per View" is supported as theview type.
Interface
Parameters
Vendor specific error
32771 Maximum number of registered Host WWN has been reached
The maximum number of hosts is exceeded.
32772 Maximum number of affinity group has been reached
The maximum number of affinity groups is exceeded.
32773 Maximum number of host affinity has been reached
The maximum number of host affinities that can be set for the port is exceeded.
32787 The device is in busy state The device is busy.
32801 The CA port is in invalid setting The CA port setting is incorrect.
32802 The Logical Volume is Mainframe volume
The volume is a MLU/MVV.
32804 The affinity group is not operative The affinity group (such as a concatenated affinity group) cannot be updated.
32806 The Logical Volume is pool for copy volume
The volume is a BLU.
32807 The Logical Volume is unknown volume
The volume is not supported.
32809 The Logical Element is ODX volume
The volume that is specified for "SourceElement" or "TargetElement" is dedicated for Offloaded Data Transfer.
32816 Fatal error generic Fatal error (such as Exception)
Value Meaning Cause
uint32 HidePaths(
[Out] CIM_ConcreteJob REF Job,
[In] string LUNames [ ],
[In] string InitiatorPortIDs [ ],
[In] string TargetPortIDs [ ],
[Out, In] CIM_SCSIProtocolController REF ProtocolControllers [ ]
)
Job Not set
LUNames A list of the volumes that are to be maskedSpecifies the "Name" property values of "FUJITSU_StorageVolume".When all the volumes that belong to an affinity group are specified, theAffinity group is also deleted.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
40
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Allowed parameter settings
Return values
InitiatorPortIDs A list of the initiator (host) port IDs that are to be maskedSpecifies the "StorageID" property values of "FUJITSU_StorageHardwareID".
TargetPortIDs A list of the target port IDs that are to be maskedNot used since only "OnePortPerView" is supported as the view type.
ProtocolControllers [In]Specifies the affinity group that is to be changed or deleted.A volume initiator or affinity group is deleted for the specified"ProtocolController".The number of elements is fixed at 1.
[Out]The updated affinity group is set.When the affinity group is deleted, NULL is set.
Operation LUNames InitiatorPortIDs TargetPortIDs ProtocolControllers
LUN deletion Mandatory NULL NULL single SPC
Host deletion NULL Mandatory NULL single SPC
View deletion Mandatory Mandatory NULL single SPC
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
4097 Invalid logical unit ID An invalid volume was specified for the "LUNames" parameter.
4098 Invalid initiator port ID An invalid host was specified for the "InitiatorPortIDs" parameter.
4099 Invalid target port ID An invalid CA port was specified for the "TargetPortIDs" parameter.
4100 host/initiator combination not exposed
The host WWPN and CA port combination does not exist.
Vendor specific error
32787 The device is in busy state The device is busy.
32801 The CA port is in invalid setting The CA port setting is incorrect.
32802 The Logical Volume is Mainframe volume
The volume is a MLU/MVV.
32804 The affinity group is not operative The affinity group (such as a concatenated affinity group) cannot be updated.
32806 The Logical Volume is pool for copy volume
The volume is a BLU.
32807 The Logical Volume is unknown volume
The volume is not supported.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
41
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.10 FUJITSU_ControllerConfigurationService::ExposeDefaultLUs
This method is used to perform mapping between logical volumes and host LUNs.
Interface
Parameters
32809 The Logical Element is ODX volume
The volume that is specified for "SourceElement" or "TargetElement" is dedicated for Offloaded Data Transfer.
32816 Fatal error generic Fatal error (such as Exception)
Value Meaning Cause
uint32 ExposeDefaultLUs(
[Out, In] CIM_ConcreteJob REF Job,
[In] string LUNames [ ],
[In] string TargetPortIDs [ ],
[In] string DeviceNumbers [ ],
[In] uint16 DeviceAccesses [ ],
[Out, In] CIM_SCSIProtocolController REF ProtocolControllers [ ]
)
Job Not set
LUNames A list of the existing volumes that are to be mappedSpecifies the "Name" property values of "FUJITSU_StorageVolume".The number of elements must be the same as "DeviceAccesses".Cannot be omitted.
TargetPortIDs Cannot be specified.
DeviceNumbers A list of the LUNs that correspond to "LUNames"The number specified here can be checked in the "DeviceNumber" propertiesof "FUJITSU_ProtocolControllerForUnit".If the number is less than "LUNames", LUNs are automatically assigned.
DeviceAccesses A list of that privileges that are to be assigned to the volumes thatcorrespond to "LUNames"Specify "2" (Read Write).The sett ing can be checked in the "DeviceAccess" propert ies of"FUJITSU_ProtocolControllerForUnit".
ProtocolControllers [In]Adds a logical volume to the specified default view.The number of elements is fixed at 1.
[Out]The updated default view is set.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
42
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Allowed parameter settings
* The view is automatically created when AffinityMode of the CA port is turned OFF.
Return values
5.2.11 FUJITSU_ControllerConfigurationService::HideDefaultLUs
This method is used to unmap logical volumes and their host LUNs.
Interface
Operation LUNames TargetPortIDs
DeviceNumbers
DeviceAccesses
ProtocolControllers
LUN addition Mandatory NULL Optional Mandatory single SPC
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
4097 Invalid logical unit ID An invalid logical volume was specified for the "LUNames" parameter.
4098 Invalid target port ID An invalid CA port was specified for the "TargetPortIDs" parameter.
4099 Invalid permission A value other than "2" (Read Write) was specified for the "DeviceAccesses" parameter.
4100 Requested logical unit number in use
A number that has already been used for the default view was specified for the "DeviceNumbers" parameter.
4101 Maximum Map Count Exceeded The maximum number of LUNs that can be set in the default view is exceeded.
Vendor specific error
32787 The device is in busy state The device is busy.
32801 The CA port is in invalid setting The CA port setting is incorrect.
32802 The Logical Volume is Mainframe volume
The volume is a MLU/MVV.
32806 The Logical Volume is pool for copy volume
The volume is a BLU.
32807 The Logical Volume is unknown volume
The volume is not supported.
32809 The Logical Element is ODX volume
The volume that is specified for "SourceElement" or "TargetElement" is dedicated for Offloaded Data Transfer.
32816 Fatal error generic Fatal error (such as Exception)
32817 SCSI Protocol Controller is already exist
The default view already exists.
uint32 HideDefaultLUs(
[Out, In] CIM_ConcreteJob REF Job,
[In] string LUNames [ ],
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
43
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Parameters
● Allowed parameter settings
* The view is automatically deleted when AffinityMode of the CA port is turned ON.
Return values
[In] string TargetPortIDs [ ],
[In] string DeviceNumbers [ ],
[In] uint16 DeviceAccesses [ ]
[Out, In] CIM_SCSIProtocolController REF ProtocolControllers [ ]
)
Job Not set
LUNames A list of the existing volumes that are to be maskedSpecifies the "Name" property values of "FUJITSU_StorageVolume".
TargetPortIDs Not used
ProtocolControllers [In]Deletes a volume from the specified default view.The number of elements is fixed at 1.
[Out]The updated default view is set.
Operation LUNames TargetPortIDs ProtocolControllers
LUN deletion Mandatory NULL single SPC
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
4097 Invalid logical unit ID An invalid logical volume was specified for the "LUNames" parameter.
4098 Invalid target port ID An invalid CA port was specified for the "TargetPortIDs" parameter.
Vendor specific error
32787 The device is in busy state The device is busy.
32801 The CA port is in invalid setting The CA port setting is incorrect.
32802 The Logical Volume is Mainframe volume
The volume is a MLU/MVV.
32806 The Logical Volume is pool for copy volume
The volume is a BLU.
32807 The Logical Volume is unknown volume
The volume is not supported.
32809 The Logical Element is ODX volume
The volume that is specified for "SourceElement" or "TargetElement" is dedicated for Offloaded Data Transfer.
32816 Fatal error generic Fatal error (such as Exception)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
44
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.12 FUJITSU_PrimordialStorageCapabilities::CreateSetting
This method is used to create a RAID group setting information template that is consistent with the RAIDgroup (unused area) setting information.
Interface
Parameters
Return values
5.2.13 FUJITSU_RAIDStorageCapabilities::CreateSetting
This method is used to create a RAID group setting information template that is the same as the RAID groupsetting information.
Interface
uint32 CreateSetting(
[In] uint16 SettingType,
[Out, In] CIM_StorageSetting REF NewSetting
)
SettingType Specifies how to allocate properties (Max, Min, and Goal for DataRedundancy, forPackageRedundancy, and for DeltaReservation) for the RAID group settinginformation that is to be created."2" (Default) and "3" (Goal) can be specified.When NULL is specified, the "Invalid Parameter" error is returned.
NewSetting Sets the created RAID group setting information.When NULL is specified, the "Failed" error is returned.
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter A value other than 2 and 3 was specified for the "SettingType" parameter.
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
uint32 CreateSetting(
[In] uint16 SettingType,
[Out, In] CIM_StorageSetting REF NewSetting
)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
45
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Parameters
Return values
5.2.14 FUJITSU_PrimordialStoragePool::GetSupportedSizes
This method is used to acquire the supported capacity of a RAID group (unused area).
Interface
Parameters
SettingType Specifies how to allocate properties (Max, Min, and Goal for DataRedundancy, forPackageRedundancy, and for DeltaReservation) for the RAID group settinginformation that is to be created."2" (Default) and "3" (Goal) can be specified.When NULL is specified, the "Invalid Parameter" error is returned.
NewSetting Specifies the created RAID group setting information.When NULL is specified, the "Failed" error is returned.
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter A value other than 2 and 3 was specified for the "SettingType" parameter.
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
uint32 GetSupportedSizes(
[In] uint16 ElementType,
[In] CIM_StorageSetting REF Goal,
[Out, In] uint64 Sizes [ ]
)
ElementType The type of supported capacity that is to be acquired"2" (RAID group) can be specified.When "3" (volume) or "4" (disk) is specified, the "Method Not Supported" error isreturned.
Goal Specifies the setting value of the supported capacity that is to be acquired.When NULL is specified, the supported capacity that can be created is acquiredaccording to the Priority RAID level obtained from the model name.
Sizes Sets a list of the supported capacities in bytes.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
46
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
5.2.15 FUJITSU_PrimordialStoragePool::GetSupportedSizeRange
This method is used to acquire the supported capacity of a RAID group (unused area).
Interface
Parameters
Return values
Value Meaning Cause
0 Method completed OK Ends normally
1 Method not supported A value other than "2" was specified for "ElementType" or RAID group was specified for "ElementType".An error occurred during size acquisition.
4 Failed Ends abnormally
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
uint32 GetSupportedSizeRange(
[In] uint16 ElementType,
[In] CIM_StorageSetting REF Goal,
[Out, In] uint64 MinimumVolumeSize,
[Out, In] uint64 MaximumVolumeSize,
[Out, In] uint64 VolumeSizeDivisor
)
ElementType Specifies the type of supported capacity that is to be acquired.When "2" (RAID group) is specified, the "Use GetSupportedSizes instead"error is returned.When a value other than "2" (RAID group) is specified, the "Method NotSupported" error is returned.
Goal Specifies the setting value of the supported capacity that is to be acquired.
MinimumVolumeSize Sets the minimum value of the supported capacity in bytes.
MaximumVolumeSize Sets the maximum value of the supported capacity in bytes.
VolumeSizeDivisor Sets the supported capacity of a single block in bytes.
Value Meaning Cause
0 Method completed OK Ends normally
1 Method not supported A value other than "2" was specified for "ElementType".
2 Use GetSupportedSizes instead "2" was specified for "ElementType".
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
47
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.16 FUJITSU_PrimordialStoragePool::GetAvailableExtents
This method is used to acquire a list of the available disks in a RAID group (unused area).
Interface
Parameters
Return values
5.2.17 FUJITSU_RAIDStoragePool::GetSupportedSizes
This method is used to acquire the supported capacity of a RAID group.
Interface
uint32 GetAvailableExtents(
[In] CIM_StorageSetting REF Goal,
[Out] CIM_StorageExtent REF AvailableExtents [ ]
)
Goal Specifies the setting value of the supported capacity that is to be acquired.When NULL is specified, all the available disks are acquired.
AvailableExtents[ ] A list of the available disks is set.
Value Meaning Cause
0 Completed with No Error Ends normally
1 Not Supported Not supported
2 Unknown Unknown
3 Timeout Timeout
4 Failed Ends abnormally
5 Invalid Parameter Invalid parameter
6 In Use In use
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
uint32 GetSupportedSizes(
[In] uint16 ElementType,
[In] CIM_StorageSetting REF Goal,
[Out, In] uint64 Sizes [ ]
)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
48
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Parameters
Return values
5.2.18 FUJITSU_RAIDStoragePool::GetSupportedSizeRange
This method is used to acquire the supported capacity of a RAID group.
Interface
Parameters
ElementType Specifies the type of supported capacity that is to be acquired.When "3" (volume) is specified, the "Use GetSupportedSizeRange instead" error isreturned.When a value other than "3" (volume) is specified, the "Method Not Supported"error is returned.
Goal Specifies the setting value of the supported capacity that is to be acquired.
Sizes Sets a list of the supported capacities in bytes.
Value Meaning Cause
0 Method completed OK Ends normally
1 Method not supported A value other than "3" was specified for "ElementType".
2 Use GetSupportedSizeRange instead
"3" was specified for "ElementType".
uint32 GetSupportedSizeRange(
[In] uint16 ElementType,
[In] CIM_StorageSetting REF Goal,
[Out, In] uint64 MinimumVolumeSize,
[Out, In] uint64 MaximumVolumeSize,
[Out, In] uint64 VolumeSizeDivisor
)
ElementType The type of supported capacity that is to be acquired"3" (volume) can be specified.When "2" (RAID group) or "4" (disk) is specified, the "Method NotSupported" error is returned.
Goal Specifies the setting value of the supported capacity that is to be acquired.Not used
MinimumVolumeSize Sets the minimum value of the supported capacity in bytes.
MaximumVolumeSize Sets the maximum value of the supported capacity in bytes.
VolumeSizeDivisor Sets the supported capacity of a single block in bytes.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
49
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
5.2.19 FUJITSU_RAIDStoragePool::GetAvailableExtents
This method is used to acquire a list of the available disks in a RAID group.
Interface
Parameters
Return values
Value Meaning Cause
0 Method completed OK Ends normally
1 Method not supported A value other than "3" was specified for "ElementType" or Primordial StoragePool was specified for "ElementType"An error occurred during size acquisition.
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
uint32 GetAvailableExtents(
[In] CIM_StorageSetting REF Goal,
[Out] CIM_StorageExtent REF AvailableExtents [ ]
)
Goal Specifies the setting value of the supported capacity that is to be acquired.Not used
AvailableExtents A list of the available disks is set.
Value Meaning Cause
0 Completed with No Error Ends normally
1 Not Supported Not supported
2 Unknown Unknown
3 Timeout Timeout
4 Failed Ends abnormally
5 Invalid Parameter Invalid parameter
6 In Use In use
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
50
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.20 FUJITSU_StorageHardwareIDManagementService::CreateStorageHardwareID
This method is used to register the nicknames that correspond to the names listed in the table below thatidentify the Host Bus Adapters (HBAs) of each port.
FC/FCoE port: WWNSAS port: SAS AddressiSCSI port: iSCSI name
Interface
Parameters
uint32 CreateStorageHardwareID(
[In] string ElementName,
[In] string StorageID,
[In] uint16 IDType,
[In] string OtherIDType,
[In] CIM_StorageClientSettingData REF Setting,
[Out] CIM_StorageHardwareID REF HardwareID
)
ElementName Specifies "ElementName" of "FUJITSU_StorageHardwareID" for an added WWN.
StorageID Specifies the "StorageID" (WWN, iSCSI Name, SAS Address) that is to be added.
IDType Specifies the "StorageID" property type.When a value other than "2" (PortWWN) , "5" (iSCSI Name), or "6" (SAS Address) isspecified, the "Hardware implementation does not support specified IDType"error is returned.
OtherIDType Specifies the "StorageID" property type to be specified when "1" (Other) isspecified for "IDType".Not used
Setting Specifies "OSType".Not used
HardwareID An object path for the created host information is set.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
51
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
5.2.21 FUJITSU_StorageHardwareIDManagementService::DeleteStorageHardwareID
This method is used to delete the registered host identifiers of FC, SAS, and ISCSI.
Interface
Parameters
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter • NULL was specified for "StorageID".
• "StorageID" is not in the WWN format, the iSCSI Name format, or the SAS Address format.
• When the iSCSI Name format is used, the following conditions are not satisfied:
- Alphanumeric characters- Symbols (only "-" (hyphen), "." (dot), and ":" (colon))- The name starts with "iqn." or "eui.".
• NULL was specified for "IDType".
4096 ID already created "StorageID" exists.
4097 Hardware implementation does not support specified IDType
A value other than "2" (PortWWN) , "5" (iSCSI Name), or "6" (SAS Address) was specified for "IDType".
Vendor specific error
32771 Maximum number of registered Host WWN has been reached
The maximum number of WWNs, iSCSI Names, or SAS Addresses that can be registered is exceeded.
32787 The device is in busy state The device is busy.
32788 Element Name is in use Element Name is already in use.
32816 Fatal error generic Fatal error (such as Exception)
uint32 DeleteStorageHardwareID(
[In] CIM_StorageHardwareID REF HardwareID
)
HardwareID Specifies the "HardwareID" (WWN, iSCSI Name, SAS Address) that is to bedeleted.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
52
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
5.2.22 FUJITSU_ReplicationService::CreateElementReplica
This method is used to start the SnapOPC+/EC/REC copy sessions.
Interface
Parameters
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter NULL was specified for "HardwareID"."HardwareID" is not the object path of "CIM_StorageHardwareID".
4096 Specified instance not found The HardwareID instance does not exist.
Vendor specific error
32787 The device is in busy state The device is busy.
32816 Fatal error generic Fatal error (such as Exception)
32817 HostWWN is still used WWNs, iSCSI Names, or SAS Addresses are in use.
uint32 CreateElementReplica(
[In] string ElementName,
[In] uint16 SyncType,
[In] uint16 Mode,
[In] CIM_LogicalElement REF SourceElement,
[In] CIM_ServiceAccessPoint REF SourceAccessPoint,
[Out, In] CIM_LogicalElement REF TargetElement,
[In] CIM_ServiceAccessPoint REF TargetAccessPoint,
[In] string ReplicationSettingData,
[Out] CIM_ConcreteJob REF Job,
[Out] SNIA_Synchronized REF Synchronization,
[In] CIM_SettingData REF TargetSettingGoal,
[In] CIM_ResourcePool REF TargetPool,
[In] uint16 WaitForCopyState
)
ElementName Specifies "ElementName" to assign to the copy destination volume that isto be created.Not used
SyncType Specifies the copy type that is to be created."6" (EC/REC), "7" (SnapOPC), or "32768" (SnapOPC+) can be specified.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
53
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Allowed parameter settings for each copy type
Mode Specifies the synchronous mode."2" (Synchronous) can be specified.
SourceElement Specifies the copy source volume.
SourceAccessPoint This parameter is used for REC.Specifies the device connection information for the copy source device.When this parameter is omitted, the copy source device operates as local.
TargetElement Specifies the copy destination volume.This parameter is not used for output.
TargetAccessPoint This parameter is used for REC.Specifies the device connection information for the copy destinationdevice.When this parameter is omitted, the copy destination device operates aslocal.
ReplicationSettingData Specifies the copy operation setting information.When this parameter is omitted, the device operates using the defaultsetting that depends on "SyncType".
Job Not set
Synchronization The information that associates the copy source volume withthe copy destination volume is set.
TargetSettingGoal Specifies StorageSetting to be associated with "TargetPool".Not used
TargetPool Specifies the RAID group that includes the copy source volume to becreated.Not used
WaitForCopyState Specifies the copy status that triggers a return."2" (Initialized) or "4" (Synchronized) can be specified.
Parameters EC REC SnapOPC SnapOPC+
SyncType 6(Mirror) 6(Mirror) 7(Snapshot) 32768(Expansion of Snapshot)
Mode 2(Synchronous) 2(Synchronous) 2(Synchronous) 2(Synchronous)
SourceElement Required Required Required Required
SourceAccessPoint Not required Optional Not required Not required
TargetElement Required Required Required Required
TargetAccessPoint Not required Optional Not required Not required
ReplicationSettingData
Optional Optional Optional Optional
WaitForCopyState 2(Initialized)/4(Synchronized)
2(Initialized)/4(Synchronized)
2(Initialized) 2(Initialized)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
54
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
Value Meaning Cause
0 Completed with No Error Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
Vendor specific error
32785 The RAID group is in busy state The RAID group is busy.
32786 The Logical Volume is in busy state The copy source or the copy destination volume is busy.
32787 The device is in busy state The device is busy.
32792 No Copy License No Advanced Copy license
32795 The session already exists The session already exists.
32802 The Logical Element is Mainframe Volume
The copy source or the copy destination volume is a MLU.
32805 The Logical Element is Thin provisioning Pool Volume
The copy source or copy destination volume is a TPPV.
32809 The Logical Element is ODX volume
The volume that is specified for "SourceElement" or "TargetElement" is dedicated for Offloaded Data Transfer.
32816 Fatal error generic Fatal error (such as Exception)
35300 Communication error A communication error occurred between the devices (Time-out or blocked).
35301 Unsupported command for remote ComputerSystem
A communication command that is not supported by the remote device is issued.
35302 Invalid LogicalElement The size of the copy source or the copy destination volume exceeds the maximum for the device.
35303 LogicalElement type error The LU type of the copy source or the copy destination volume is not OLU, SDV, or TPPC.
35304 LogicalElement state error The copy session cannot be set for the copy source or the copy destination volume.
35305 SourceElement has bad data The copy source volume contains bad data.
35306 Encryption state is inconsistency The encryption status of the copy source volume and the copy destination volume are not the same.
35307 Resource domain is not the same The resource domain numbers of the copy source volume and the copy destination volume are not the same.
35308 LogicalElement is abnormal The copy source or the copy destination volume is a dummy volume.A restore copy cannot be set because the target session is already set to be deleted.
35309 Disk failure in Fractured An error occurred for the session due to a failed disk that is in suspend status.
35310 Parameter error (Copy) The specified parameters are incorrect. (The setting is incor-rect)
35311 SourceElement is larger than TargetElement
A volume that is larger than the copy source volume is specified for the destination volume of a Totally copy.
35312 Error in reverse Failed to reverse (ChangeError) the session.
35313 LogicalElement is in migration A conflict occurred between the copy session and an existing RAID migration session.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
55
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
35314 SourceElement is TargetElement of other session
The range of the copy source volume is the same as the range of a copy destination volume for an existing session (excluding cascade or restore sessions).
35315 TargetElement is SourceElement of other session
The range of the copy destination volume is the same as the range of a copy source volume for an existing session (excluding cascade or restore sessions).
35316 Multi-hop error The range of the cascade copy exceeds the range that can be set.
35317 Already restored Cannot restore a restore copy session that has already been restored.
35318 Maximum number of multi-hop has been reached
The number of multi-stages for cascade copy exceeds the maximum (1).
35319 Status is Broken The session that is specified for the restoration copy is suspended by an error.
35320 Multi-copy in REC Consistency mode
Multiple copy sessions in REC Consistency mode are operated in a single device.
35323 This operation should be performed by Force
The session cannot be deleted or suspended unless the command is forcibly executed.The "STOP" command was issued without force settings for a session that is not the oldest SnapOPC+ generation.
35324 RAID is broken The RAID group that contains the copy source or the copy destination volume is blocked.
35325 TargetElement is inhibit The copy destination volume is protected.
35327 REC buffer status error REC Buffer recovery was initiated while the suspend command is still processing during transfer of the REC Buffer (suspend is not possible when the recovery of untransferred data is being performed).
35328 REC buffer is being watched The copy session cannot be reversed because the untransferred REC Buffer is being monitored.
35329 Multi-hop error (Reverse) The copy session cannot be reversed because the session will become the source of an EC/REC cascade copy that is not in suspend status.
35330 Already reversed The copy session cannot be reversed because it has been already reversed.
35331 Maximum number of session has been reached (per device)
The number of copy sessions exceeds the maximum for a single device.
35333 Maximum number of session has been reached (per SourceElement)
The number of copy sessions exceeds the maximum for a single copy source volume.
35334 Maximum number of session has been reached (per TargetElement)
The number of copy sessions exceeds the maximum for a single copy destination volume.
35335 Maximum number of Snapshot generation has been reached (per SourceElement)
The number of SnapOPC+ generations exceeds the maximum for a single copy source volume.
35336 Overlapped in SourceElement The areas of copy source volume for multiple monitor sessions are duplicated.
Value Meaning Cause
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
56
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
35337 Same copy range The copy range of the new session and an existing session are the same (excluding restarting when the status for OPC or QuickOPC is Copying).The copy range for the copy destination volume of the new session and the copy destination volume of an existing session are the same.
35338 TargetElement is TargetElement of other session (Multi-hop)
The copy destination volume of the relevant session and the cascade destination are the same.
35339 Reverse in multi-hop The copy destination volumes become the same when reverse is performed for an EC/REC that is performing a cascade copy.
35340 Snapshot TargetElement is being initialized
The SDV is currently being initialized.
35341 Snapshot TargetElement is already reserved
A session with an SDV as the copy destination volume already exists.
35346 Copy table size is not setup A copy table is not set.
35347 Copy table size is not enough The copy table size is insufficient.
35348 REC buffer is not in active The status of the REC Buffer is not Active.
35349 REC buffer parameter error The copy source volume, the destination volume, and the REC Buffer for sending and receiving do not correspond after the copy resumes.
35350 REC buffer is busy The REC Buffer settings are currently being changed.The related action for the REC Buffer is being performed by ETERNUS Web GUI/ETERNUS CLI.
35351 Error in Reverse (REC buffer) The copy source volume, the destination volume, and the REC Buffer for sending and receiving do not correspond after the direction of the copy is reversed.
35352 Disk is motor OFF The specified volume of the copy source or the copy destination cannot be copied because the motor of the disk is turned off (for OPC sessions).
35353 Invalid RemoteAccessPoint The specified BoxID information cannot be found in the configuration information.
35354 Detach is failed because of path error
The session can be deleted in the local device but cannot be deleted in the remote device because the status of a path is abnormal.
35355 Firmware is busy The commands cannot be used because a CFL is currently being performed.
35356 Copy resolution is not the same The device resolution for the copy source volume and the copy destination volume does not match.
35357 TargetElement is snapshot target element
An SDV is specified for the destination volume of a copy session that is not a SnapOPC.
35358 SourceElement is snapshot target element
An SDV is specified for the source volume of a copy session that is a SnapOPC.
35359 TargetElement is not snapshot target element
An OLU is specified for the copy destination of the SnapOPC.
35360 The device required the retry An event occurs that requires the process to be tried again.
Value Meaning Cause
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
57
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.23 FUJITSU_ReplicationService::ModifyReplicaSynchronization
This method is used to change a copy session (suspend, resume, reverse, and end).
Interface
Parameters
35361 The device is in NotReady state The device is in NotReady status or an abnormal event occurred in the firmware.
35362 LogicalElement is in "Bind In Cache"
RAID Migration cannot be performed for the specified copy source volume or the specified copy destination volume because Bind In Cache is currently being performed.
Value Meaning Cause
uint32 ModifyReplicaSynchronization(
[In] uint16 Operation,
[In] SNIA_Synchronized REF Synchronization,
[In] string ReplicationSettingData,
[In] SNIA_StorageSynchronized REF SyncPair[],
[Out] CIM_ConcreteJob REF Job,
[In] boolean Force,
[In] CIM_SettingsDefineState REF SettingsState,
[In] uint16 WaitForCopyState
)
Operation Specifies the copy operation."8" (Detach), "12" (Fracture), "14" (Resync Replica), "15" (Restore fromReplica), "19" (Return To ResourcePool), or "20" (Reverse Roles) can bespecified.For details on the available Operation values for each copy type, refer to"Allowed parameter settings for each copy type" (page 59).
Synchronization Specifies the association information of a target copy volume.
ReplicationSettingData Specifies the copy operation setting information.When this parameter is omitted, the device operates using the defaultsetting that depends on "SyncType".
SyncPair[] Specifies that "StorageSynchronized" is added to the group.Not used
Job Not set
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
58
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Allowed parameter settings for each copy type
*1: Only for REC*2: Execution in Suspend status
Force Specifies the forcible execution of an operation.This parameter is only available for EC/REC/SnapOPC+."false" or "true" can be specified.When this parameter is omitted, the device operates using "false".For differences between operations according to the specified values,refer to "Difference between operations according to the Forceparameters" (page 60).
SettingsState Speci f ies "Sett ingDefineState" that associates a volume with"SynchronizedAspect".Not used
WaitForCopyState Specifies the copy status that triggers a return."3" (Unsynchronized), "4" (Synchronized), "6" (Fractured), "8" (Inactive), or"15" (Not Applicable) can be specified.For details on the available WaitForCopyState values for each operation,refer to "Allowed parameter settings for each copy type" (page 59).
Copy type Action Operation Force WaitForCopyState
EC/REC Suspend 12(Fracture) false 6(Fractured)
Suspend(forcibly) (*1)
12(Fracture) true 6(Fractured)
Resume (*2) 14(Resync Replica) false 3(Unsynchronized)/4(Synchronized)
Restore (reverse + resume) (*2)
15(Restore From Replica)
false 3(Unsynchronized)/4(Synchronized)
Reverse (*2) 20(Reverse Roles) false 6(Fractured)
Stop 8(Detach) false 15(Not Applicable)
Stop (forcibly) 8(Detach) true 15(Not Applicable)
SnapOPC/SnapOPC+
Restore 15(Restore From Replica)
false 8(Inactive)
Stop 19(Return To ResourcePool)
false 15(Not Applicable)
Stop (forcibly) 19(Return To ResourcePool)
true 15(Not Applicable)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
59
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Difference between operations according to the Force parameters
Return values
For return values that are not listed in the following table, refer to the values that are listed from 35300onward in the Return Values table of "5.2.22 FUJITSU_ReplicationService::CreateElementReplica" (page53).
Copy type Operation Parameter difference affect on operation
EC Detach • When the value is "false":The target session is deleted only if the session is in an equivalent maintenance state (Phase is Equivalent). When the target session is still in a copying state (Phase is Copying), this command ends with an error.
• When the value is "true":Even if the target session is still in a copying state (Phase is Copying), the copy process is stopped and the session is forcibly deleted.
REC DetachFracture
• When the value is "false":The target session is deleted or suspended only if the session is in an equivalent maintenance state (Phase is Equivalent) and a blockage of all the REC paths does not occur. This command ends with an error in other cases. However, regardless of the session status and the REC path status, this command ends with an error when a REC Consistency session is the target session.
• When the value is "true":The target session is forcibly deleted or suspended even if the session is not in an equivalent maintenance state (Phase is Equivalent) and a blockage of all the REC paths occurs. Note that when a blockage of all the REC paths occurs, a session in the source device is deleted, but a session in the destination device remains or the session status is different between the source device and the destination device for suspension because the communication path is not available.
SnapOPC+ Detach • When the value is "false":The session is deleted only if the oldest SnapOPC+ session generation is specified amongst all of the generations. This command ends with an error if the target session is not the oldest generation (the session status does not modify this condition).
• When the value is "true":The target session is forcibly deleted even if it is not the oldest generation. In addition, generations older than the target session will also be deleted.
Value Meaning Cause
0 Completed with No Error Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
Vendor specific error
32785 The RAID group is in busy state The RAID group is busy.
32786 The Logical Volume is in busy state The copy source or copy destination volume is busy.
32787 The device is in busy state The device is busy.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
60
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.24 FUJITSU_ReplicationService::ModifyListSynchronization
This method is used to change multiple copy sessions (suspend, resume, reverse, and end).
Interface
Parameters
32791 Maximum number of copy session has been reached
The maximum number of copy sessions has been created for the device or for a volume.
32792 No Copy License No Advanced Copy license
32793 Session is not exist The copy session that corresponds to the specified copy volume association information does not exist.
32794 Phase is not correct The current copy phase is not correct.
32802 The Logical Element is Mainframe Volume
The copy source or the copy destination volume is a MLU.
32805 The Logical Element is Thin provisioning Pool Volume
The copy source or the copy destination volume is a TPPV.
32816 Fatal error generic Fatal error (such as Exception)
Value Meaning Cause
uint32 ModifyListSynchronization(
[In] uint16 Operation,
[In] SNIA_Synchronized REF Synchronization[],
[In] string ReplicationSettingData,
[Out] CIM_ConcreteJob REF Job,
[In] boolean Force,
[In] uint16 WaitForCopyState
)
Operation Specifies the operation that is to be executed for copy."8" (Detach), "12" (Fracture), "14" (Resync Replica), "15" (Restore fromReplica), "19" (Return To ResourcePool), or "20" (Reverse Roles) can bespecified.For details on the available Operation values for each copy type, refer to"Allowed parameter settings for each copy type" (page 59) in "5.2.23FUJITSU_ReplicationService::ModifyReplicaSynchronization".
Synchronization[] Specifies the association information of a target copy volume.
ReplicationSettingData
Specifies the copy operation setting information.When this parameter is omitted, the device operates using the defaultsetting that depends on "SyncType".
Job Not set
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
61
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
For return values that are not listed in the following table, refer to the values that are listed from 35300onward in the Return Values table of "5.2.22 FUJITSU_ReplicationService::CreateElementReplica" (page53).
Force Specifies the forcible execution of an operation.This parameter is only available for EC/REC/SnapOPC+."false" or "true" can be specified.When this parameter is omitted, the device operates using "false".For differences between operations according to the specified values, refer to"Difference between operations according to the Force parameters" (page60).
WaitForCopyState Specifies the copy status that triggers a return."3" (Unsynchronized), "4" (Synchronized), "6" (Fractured), "8" (Inactive), or"15" (Not Applicable) can be specified.For details on the available WaitForCopyState values for each operation, referto "Allowed parameter settings for each copy type" (page 59) in "5.2.23FUJITSU_ReplicationService::ModifyReplicaSynchronization".
Value Meaning Cause
0 Completed with No Error Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
Vendor specific error
32785 The RAID group is in busy state The RAID group is busy.
32786 The Logical Volume is in busy state The copy source volume or destination volume is busy.
32787 The device is in busy state The device is busy.
32791 Maximum number of copy session has been reached
The maximum number of copy sessions has been created for the device or for a volume.
32792 No Copy License No Advanced Copy license
32793 Session is not exist The copy session that corresponds to the specified Synchronization does not exist.
32794 Phase is not correct The current copy phase is not correct.
32801 Failed on the Partial Synchronization
A part of the copy session change failed.
32802 The Logical Element is Mainframe Volume
The target volume is a MLU.
32805 The Logical Element is Thin provisioning Pool Volume
The target volume is a TPPV.
32816 Fatal error generic Fatal error (such as Exception)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
62
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.25 FUJITSU_ReplicationService::GetReplicationRelationships
This method is used to acquire information that associates the copy source volume with the copy destinationvolume.
Interface
Parameters
uint32 GetReplicationRelationships(
[In] uint16 Type,
[In] uint16 SyncType,
[In] uint16 Mode,
[In] uint16 Locality,
[In] uint16 CopyState,
[Out] CIM_ConcreteJob REF Job,
[Out] SNIA_Synchronized REF Synchronizations[]
)
Type Specifies the type of association that is to be searched."2" (StorageSynchronized) or "3" (GroupSynchronized) can be specified.When "3" is speci f ied, the normal end return value is sent with"Synchronization" as "0".When this parameter is omitted, all the association types are searched.
SyncType Specifies the copy type that is to be searched."6" (Mirror), "7" (Snapshot), "8" (Clone), or "32768" (Expansion of Snapshot)can be specified.When "6" is specified, EC/REC copies are searched.When "7" is specified, SnapOPC copies are searched.When "8" is speci f ied, the normal end return value is sent with"Synchronization" as "0".When "32768" is specified, SnapOPC+ copies are searched.When this parameter is omitted, all the copy types are searched.
Mode Specifies the synchronous mode that is to be searched."2" (Synchronous) and "3" (Asynchronous) can be specified.When "2" is specified, EC, SnapOPC/SnapOPC+, and synchronous REC copiesare searched.When "3" is specified, asynchronous REC copies are searched.When this parameter is omitted, all the synchronous modes are searched.
Locality Specifies a locality that is to be searched. "2" (Local only) or "3" (Remote only) can be specified.When "2" is specified, EC and SnapOPC/SnapOPC+ copies are searched.When "3" is specified, REC copies are searched.When this parameter is omitted, all the localities are searched.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
63
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Allowed parameter settings for each copy type
Return values
5.2.26 FUJITSU_ReplicationServiceCapabilities::ConvertSyncTypeToReplicationType
This method is used to convert copy type, synchronous mode, and local/remote information to replicationtype.
Interface
CopyState Specifies the copy status that is to be searched. "2" (Initialized), "3" (Unsynchronized), "4" (Synchronized), "5" (Broken), "6"(Fractured), "7" (Split), "8" (Inactive), "9" (Suspended), "10" (Failover), "11"(Prepared), "12" (Aborted), "13" (Skewed), "14" (Mixed), or "15" (NotApplicable) can be specified.When this parameter is omitted, all the copy statuses are searched.
Job Not set
Synchronization[] The association information of a copy volume that is the search result is set.
Parameters EC REC SnapOPC SnapOPC+
Type 2(Storage Synchronized)
2(Storage Synchronized)
2(Storage Synchronized)
2(Storage Synchronized)
SyncType 6(Mirror) 6(Mirror) 7(Snapshot) 32768(Expansion of Snapshot)
Mode 2(Synchronous) 2(Synchronous)/3(Asynchronous)
2(Synchronous) 2(Synchronous)
Locality 2(Local only) 3(Remote only) 2(Local only) 2(Local only)
CopyState Optional Optional Optional Optional
Value Meaning Cause
0 Completed with No Error Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
uint32 ConvertSyncTypeToReplicationType(
[In] uint16 SyncType,
[In] uint16 Mode,
[In] uint16 LocalOrRemote,
[Out] uint16 SupportedReplicationTypes
)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
64
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Parameters
● Allowed parameter settings for each copy type
Return values
5.2.27 FUJITSU_ReplicationServiceCapabilities::ConvertReplicationTypeToSyncType
This method is used to convert replication type to copy type, synchronous mode, or local/remote information.
Interface
SyncType Specifies the copy type of the conversion source."6" (Mirror), "7" (Snapshot), "8" (Clone), or "32768" (Expansion ofSnapshot) can be specified.
Mode Specifies the synchronous mode of the conversion source."2" (Synchronized) and "3" (Unsynchronized) can be specified.
LocalOrRemote Specifies the local/remote information of the conversion source."2" (Local) or "3" (Remote) can be specified.
SupportedReplicationTypes The value that corresponds to the input "SyncType", "Mode", and"LocalOrRemote" is set.
Parameters EC REC SnapOPC SnapOPC+
SyncType 6(Mirror) 6(Mirror) 7(Snapshot) 32768(Expansion of Snapshot)
Mode 2(Synchronous) 2(Synchronous) 2(Synchronous) 2(Synchronous)
LocalOrRemote
2(Local) 3(Remote) 2(Local) 2(Local)
SupportedReplicationTypes
2(Synchronous Mirror Local)
4(Synchronous Mirror Remote)
6(Synchronous Snapshot Local)
6(Synchronous Snapshot Local)
Value Meaning Cause
0 Success Ends normally
5 Invalid Parameter Invalid Parameter
uint32 ConvertReplicationTypeToSyncType(
[In] uint16 ReplicationType,
[Out] uint16 SyncType,
[Out] uint16 Mode,
[Out] uint16 LocalOrRemote
)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
65
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Parameters
● Table of correspondence between replication types, copy types, synchronous modes, and local/remote information
ReplicationType Specifies the type that combines the copy type, asynchronous mode, and local/remote information of the conversion source."2" (Synchronous Mirror Local), "3" (Asynchronous Mirror Local), "4" (SynchronousMirror Remote), "5" (Asynchronous Mirror Remote), "6" (Synchronous SnapshotLocal), "7" (Asynchronous Snapshot Local), "8" (Synchronous Snapshot Remote),"9" (Asynchronous Snapshot Remote), "10" (Synchronous Clone Local), "11"(Asynchronous Clone Local), "12" (Synchronous Clone Remote), "13"(Asynchronous Clone Remote), "32768" (Synchronous Expansion of SnapshotLocal), "32769" (Asynchronous Expansion of Snapshot Local), "32770"(Synchronous Expansion of Snapshot Remote), or "32771"(AsynchronousExpansion of Snapshot Remote) can be specified.
SyncType The copy type that corresponds to the input "ReplicationType" is set.
Mode The synchronous mode that corresponds to the input"ReplicationType" is set.
LocalOrRemote The local/remote information that corresponds to the input"ReplicationType" is set.
SupportedReplicationTypes
SyncType Mode LocalOrRemote
2(Synchronous Mirror Local) 6(Mirror) 2(Synchronous) 2(Local)
3(Asynchronous Mirror Local) 6(Mirror) 3(Unsynchronized) 2(Local)
4(Synchronous Mirror Remote) 6(Mirror) 2(Synchronous) 3(Remote)
5(Asynchronous Mirror Remote)
6(Mirror) 3(Unsynchronized) 3(Remote)
6(Synchronous Snapshot Local)
7(Snapshot) 2(Synchronous) 2(Local)
7(Asynchronous Snapshot Local)
7(Snapshot) 3(Unsynchronized) 2(Local)
8(Synchronous Snapshot Remote)
7(Snapshot) 2(Synchronous) 3(Remote)
9(Asynchronous Snapshot Remote)
7(Snapshot) 3(Unsynchronized) 3(Remote)
10(Synchronous Clone Local)
8(Clone) 2(Synchronous) 2(Local)
11(Asynchronous Clone Local)
8(Clone) 3(Unsynchronized) 2(Local)
12(Synchronous Clone Remote)
8(Clone) 2(Synchronous) 3(Remote)
13(Asynchronous Clone Remote)
8(Clone) 3(Unsynchronized) 3(Remote)
32768(Synchronous Expan-sion of Snapshot Local)
32768(Expansion of Snapshot)
2(Synchronous) 2(Local)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
66
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
5.2.28 FUJITSU_ReplicationServiceCapabilities::GetSupportedFeatures
This method is used to return the supported functions.
Interface
Parameters
● Table of correspondence between "ReplicationType" and supported functions
32769(Asynchronous Expansion of Snapshot Local)
32768(Expansion of Snapshot)
3(Unsynchronized) 2(Local)
32770(Synchronous Expansion of Snapshot Remote)
32768(Expansion of Snapshot)
2(Synchronous) 3(Remote)
32771(Asynchronous Expansion of Snapshot Remote)
32768(Expansion of Snapshot)
3(Unsynchronized) 3(Remote)
Value Meaning Cause
0 Success Ends normally
5 Invalid Parameter Invalid Parameter
SupportedReplicationTypes
SyncType Mode LocalOrRemote
uint32 GetSupportedFeatures(
[In] uint16 ReplicationType,
[Out] uint16 Features[]
)
ReplicationType Specifies the type that combines the copy type, asynchronous mode, and local/remote information."2" (Synchronous Mirror Local), "4" (Synchronous Mirror Remote), "6"(Synchronous Snapshot Local), or "32768" (Synchronous Expansion of SnapshotLocal) can be specified.
Features[] The supported functions that correspond to the input"ReplicationType" are set.
ReplicationType Features
2(Synchronous Mirror Local) 7(Service suspends source I/O when necessary)
16(Target must remain associated to source)
20(Reverse Roles operation requires resync)
21(Restore operation requires fracture)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
67
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
5.2.29 FUJITSU_ReplicationServiceCapabilities::GetSupportedCopyStates
This method is used to return the supported copy status.
Interface
Parameters
4(Synchronous Mirror Remote) 3(Multi-hop element replication)
6(Requires full discovery of target ComputerSystem)
7(Service suspends source I/O when necessary)
16(Target must remain associated to source)
17(Remote resource requires remote CIMOM)
20(Reverse Roles operation requires resync)
21(Restore operation requires fracture)
6(Synchronous Snapshot Local)
8(Targets allocated from Any storage pool)
9(Targets allocated from Shared storage pool)
12(Target require reserved elements)
16(Target must remain associated to source)
"32768"(Synchronous Expansion of Snapshot Local)
8(Targets allocated from Any storage pool)
9(Targets allocated from Shared storage pool)
12(Target require reserved elements)
16(Target must remain associated to source)
Value Meaning Cause
0 Success Ends normally
5 Invalid Parameter Invalid Parameter
ReplicationType Features
uint32 GetSupportedCopyStates(
[In] uint16 ReplicationType,
[Out] uint16 SupportedCopyStates[],
[Out] boolean HostAccessible[]
)
ReplicationType Specifies the type that combines the copy type, asynchronous mode, andlocal/remote information."2" (Synchronous Mirror Local), "4" (Synchronous Mirror Remote), "6"(Synchronous Snapshot Local), or "32768" (Synchronous Expansion ofSnapshot Local) can be specified.
SupportedCopyStates[] T h e s u p p o r t e d c o p y s t a t u s t h a t c o r r e s p o n d s t o t h e i n p u t"ReplicationType" is set.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
68
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
● Table of correspondence between "ReplicationType", supported copy status, and "HostAccessible".
Return values
5.2.30 FUJITSU_ReplicationServiceCapabilities::GetSupportedWaitForCopyStates
This method is used to acquire a value that is supported as the "WaitForCopyState" parameter of the"CreateElementReplica/ModifyReplicaSynchronization" method (the copy status that triggers a return).
Interface
HostAccessible[] Whether the host can access the target volume while the volume is inthe copy status specified for "SupportedCopyStates" is set.
ReplicationType SupportedCopyState HostAccessible
2(Synchronous Mirror Local) 2(Initialized) false
3(Unsynchronized) false
4(Synchronized) false
5(Broken) false
6(Fractured) true
4(Synchronous Mirror Remote) 2(Initialized) false
3(Unsynchronized) false
4(Synchronized) false
5(Broken) false
6(Fractured) true
12(Aborted) false
6(Synchronous Snapshot Local) 2(Initialized) false
5(Broken) false
8(Inactive) true
32768(Synchronous Expansion of Snapshot Local)
2(Initialized) false
5(Broken) false
8(Inactive) true
Value Meaning Cause
0 Success Ends normally
5 Invalid Parameter Invalid Parameter
uint32 GetSupportedWaitForCopyStates(
[In] uint16 ReplicationType,
[In] uint16 MethodName,
[Out] uint16 SupportedCopyStates[]
)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
69
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Parameters
Return values
5.2.31 FUJITSU_ReplicationServiceCapabilities::GetSupportedOperations
This method is used to acquire a value that is supported as the "Operation" parameter of the"ModifyReplicaSynchronization" method.
Interface
Parameters
Return values
ReplicationType Specifies the type that combines the copy type, asynchronous mode, andlocal/remote information."2" (Synchronous Mirror Local), "4" (Synchronous Mirror Remote), "6"(Synchronous Snapshot Local), or "32768" (Synchronous Expansion ofSnapshot Local) can be specified.
MethodName Specifies the method."2" (CreateElementReplica), "4" (ModifySynchronization), or "5"(ModifyListSynchronization) can be specified.
SupportedCopyStates[] The copy status that can be specified for the "WaitForCopyState"parameter and that corresponds to the input "ReplicationType" and"MethodName" is set.
Value Meaning Cause
0 Success Ends normally
5 Invalid Parameter Invalid Parameter
uint32 GetSupportedOperations(
[In] uint16 ReplicationType,
[Out] uint16 SupportedOperations[]
)
ReplicationType Specifies the type that combines the copy type, asynchronous mode, andlocal/remote information."2" (Synchronous Mirror Local), "4" (Synchronous Mirror Remote), "6"(Synchronous Snapshot Local), or "32768" (Synchronous Expansion ofSnapshot Local) can be specified.
SupportedOperations[] The operation that is supported by the "ModifyReplicaSynchronization"method and that corresponds to the input "ReplicationType" is set.
Value Meaning Cause
0 Success Ends normally
5 Invalid Parameter Invalid Parameter
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
70
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.32 FUJITSU_ReplicationServiceCapabilities::GetSupportedListOperations
This method is used to acquire a value that is supported as the "Operation" parameter of the"ModifyListSynchronization" method.
Interface
Parameters
Return values
5.2.33 FUJITSU_ReplicationServiceCapabilities::GetSupportedMaximum
This method is used to acquire the maximum value that is supported for a specified element.
Interface
uint32 GetSupportedListOperations(
[In] uint16 ReplicationType,
[In] uint16 SynchronizationType,
[Out] uint16 SupportedOperations[]
)
ReplicationType Specifies the type that combines the copy type, asynchronous mode, andlocal/remote information."2" (Synchronous Mirror Local), "4" (Synchronous Mirror Remote), "6"(Synchronous Snapshot Local), or "32768" (Synchronous Expansion ofSnapshot Local) can be specified.
SynchronizationType Specifies the association type."2" (StorageSynchronized) can be specified.When a value other than "2" is specified, the "Invalid Parameter" error isreturned.When this parameter is omitted, the operation is the same as when "2" isspecified.
SupportedOperations[] The operation that is supported by the "ModifyListSynchronization"method and that corresponds to the input "ReplicationType" is set.
Value Meaning Cause
0 Success Ends normally
5 Invalid Parameter Invalid Parameter
uint32 GetSupportedMaximum(
[In] uint16 ReplicationType,
[In] uint16 Component,
[Out] uint64 MaxValue
)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
71
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Parameters
Return values
5.2.34 FUJITSU_ReplicationServiceCapabilities::GetDefaultReplicationSettingData
This method is used to acquire the default copy operation setting information.
Interface
Parameters
Return value
ReplicationType Specifies the type that combines the copy type, asynchronous mode, and local/remote information."2" (Synchronous Mirror Local), "4" (Synchronous Mirror Remote), "6"(Synchronous Snapshot Local), or "32768" (Synchronous Expansion of SnapshotLocal) can be specified.
Component Specifies the target for the maximum value."5" (Number of target elements per source element), "6" (Number of total sourceelements), "7" (Number of total target elements), "8" (Number of peer systems),or "9" (Number of hops in a multi-hop copy) can be specified.
MaxValue The maximum value that corresponds to the input "ReplicationType" and"Component" is set.
Value Meaning Cause
0 Success Ends normally
5 Invalid Parameter Invalid Parameter
uint32 GetDefaultReplicationSettingData(
[In] uint16 ReplicationType,
[Out] string DefaultInstance
)
ReplicationType Specifies the type that combines the copy type, asynchronous mode, and local/remote information."2" (Synchronous Mirror Local), "4" (Synchronous Mirror Remote), "6"(Synchronous Snapshot Local), or "32768" (Synchronous Expansion of SnapshotLocal) can be specified.
DefaultInstance The default copy operation setting information that corresponds to the input"ReplicationType" is set.
Value Meaning Cause
0 Success Ends normally
5 Invalid Parameter Invalid Parameter
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
72
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
5.2.35 FUJITSU_ThinProvisioningCapabilities::CreateSetting
This method is used to create a template of the TPP setting information that is consistent with the ThinProvisioning Pool (TPP) setting information.
Interface
Parameters
Return values
5.2.36 FUJITSU_ThinProvisioningPool::GetSupportedSizes
This method is used to acquire the supported capacity of a Thin Provisioning Pool (TPP).
Interface
uint32 CreateSetting(
[In] uint16 SettingType,
[Out, In] CIM_StorageSetting REF NewSetting
)
SettingType Specif ies how to assign the properties ("Max", "Min", and "Goal" for"DataRedundancy", "PackageRedundancy", and "DeltaReservation") of the TPPsetting information that is to be created.Only "2" (volume) or "3" (Goal) can be specified.When NULL is specified, the "Invalid Parameter" error is returned.
NewSetting Specifies the created TPP setting information.When NULL is specified, the "Failed" error is returned.
Value Meaning Cause
0 Success Ends normally
4 Failed Ends abnormally
5 Invalid Parameter Invalid Parameter
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
uint32 GetSupportedSizes(
[In] uint16 ElementType,
[In] CIM_StorageSetting REF Goal,
[Out, In] uint64 Sizes [ ]
)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
73
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Parameters
Return values
5.2.37 FUJITSU_ThinProvisioningPool::GetSupportedSizeRange
This method is used to acquire the supported capacity of a Thin Provisioning Pool (TPP).
Interface
Parameters
ElementType Specifies the type of supported capacity that is to be acquired.W h e n " 5 " ( T h i n P r o v i s i o n i n g P o o l ( T P V ) ) i s s p e c i f i e d , t h e " U s eGetSupportedSizeRange instead" error is returned.When a value other than "5" (TPV) is specified, the "Method Not Supported" erroris returned.
Goal Specifies the setting value of the supported capacity that is to be acquired.
Sizes Sets a list of the supported capacities in bytes.
Value Meaning Cause
0 Method completed OK Ends normally
2 Use GetSupportedSizeRange instead
"5" was specified for "ElementType"
3 Invalid Element Type A value other than "5" was specified for "ElementType"
uint32 GetSupportedSizeRange(
[In] uint16 ElementType,
[In] CIM_StorageSetting REF Goal,
[Out, In] uint64 MinimumVolumeSize,
[Out, In] uint64 MaximumVolumeSize,
[Out, In] uint64 VolumeSizeDivisor
)
ElementType Specifies the type of supported capacity that is to be acquired.
Goal Specifies the setting value of the supported capacity that is to beacquired.Not used
MinimumVolumeSize Sets the minimum value of the supported capacity in bytes.
MaximumVolumeSize Sets the maximum value of the supported capacity in bytes.
VolumeSizeDivisor Sets the supported capacity of a single block in bytes.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
74
Chapter 5 Device Configuration Modifications 5.2 Device Configuration Change Method Interfaces
Return values
5.2.38 FUJITSU_ThinProvisioningPool::GetAvailableExtents
This method is used to acquire a list of the available disks in a Thin Provisioning Pool (TPP).
Interface
Parameters
Return values
Value Meaning Cause
0 Method completed OK Ends normally
1 Method not supported "Primordial StoragePool" is specified or an error occurs during size acquisition
3 Invalid Element Type A value other than "5" was specified for "ElementType"
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
uint32 GetAvailableExtents(
[In] CIM_StorageSetting REF Goal,
[Out] CIM_StorageExtent REF AvailableExtents [ ]
)
Goal Specifies the setting value of the supported capacity that is to be acquired.Not used
AvailableExtents A list of the available disks is set.
Value Meaning Cause
0 Completed with No Error Ends normally
1 Not Supported Not supported
2 Unknown Unknown
3 Timeout Timeout
4 Failed Ends abnormally
5 Invalid Parameter Invalid parameter
6 In Use In use
Vendor specific error
32816 Fatal error generic Fatal error (such as Exception)
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
75
Chapter 6
Notification of Device Configuration Modifications
This chapter describes notification of changes to the device configuration.
6.1 Notification of Device Configuration Change/Device Errors
When the device configuration is changed (e.g. RAID group or volume addition/deletion) and when an erroroccurs in the device, the Indication Provider notifies the listener of the content of the change. The contents tobe notified and the address of the listener must be registered in the SMI-S server in advance.
Listener: The receiving end of the device configuration change that is notified asynchronously by the SMI-Sserver.
6.2 Notification Conditions
The following table shows the conditions for when the listener is notified of a device configuration change.
No. Device configuration change condition
1 When a RAID group is created
2 When a RAID group is deleted
3 When a volume is created
4 When a volume is deleted
5 When the volume status is changed
6 When a copy session is created
7 When a copy session is deleted
8 When the copy session status is changed
9 When an error occurs in the device
10 When an affinity group is created
11 When an affinity group is deleted
12 When LUN mapping is created
13 When LUN mapping is deleted
14 When a host affinity group is created
15 When a host affinity group is deleted
16 When the LUN mapping information is added while the host affinity mode is enabled
17 When the LUN mapping information is deleted while the host affinity mode is enabled
18 When the LUN mapping information is changed while the host affinity mode is enabled
19 When the LUN mapping information is added while the host affinity mode is disabled
20 When the LUN mapping information is deleted while the host affinity mode is disabled
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
76
Chapter 6 Notification of Device Configuration Modifications 6.3 Note
6.3 Note
When a large number of notifications for device configuration changes occurs, some of these notificationsmay be lost.
(Example)• When a large number of volumes (around 1000) are created or deleted at the same time, some of the
notifications for device configuration changes of "OperationalStatus modification for volumes" are lost.
21 When the LUN mapping information is changed while the host affinity mode is disabled
22 When the free capacity in a Thin Provisioning Pool or a Thin Provisioning Volume reaches the threshold
23 When there is a shortage of free capacity in a Thin Provisioning Pool or a Thin Provisioning Volume
No. Device configuration change condition
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
77
Appendix A
The Number of SMI-S that can be Simultaneously Connected
The number of SMI-S that can be simultaneously connected: 64
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
78
Appendix B
About Using of Open Sources
The SMI-S interface of the ETERNUS DX80 S2/DX90 S2, ETERNUS DX410 S2/DX440 S2, and ETERNUS DX8100 S2/DX8700 S2 uses the following open sources.
• OpenPegasus• OpenSSL
■ OpenPegasus
The OpenPegasus copyright and license information is as follows.This information can also be newed on http://www.openpegasus.org/
Copyright (c) 2000, 2001, 2002 BMC Software; Hewlett-Packard DevelopmentCompany, L.P.; IBM Corp.; The Open Group; Tivoli Systems.Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L.P.;IBM Corp.; EMC Corporation, The Open Group.Copyright (c) 2004 BMC Software; Hewlett-Packard Development Company, L.P.;IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.Copyright (c) 2005 Hewlett-Packard Development Company, L.P.; IBM Corp.;EMC Corporation; VERITAS Software Corporation; The Open Group.Copyright (c) 2006 Hewlett-Packard Development Company, L.P.; IBM Corp.; EMC Corporation; Symantec Corporation; The Open Group.
Permission is hereby granted, free of charge, to any person obtaining a copyof this software and associated documentation files (the "Software"), todeal in the Software without restriction, including without limitation therights to use, copy, modify, merge, publish, distribute, sublicense, and/orsell copies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:
THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED INALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED"AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIM-ITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHTHOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN ANACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTIONWITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
79
Appendix B About Using of Open Sources
■ OpenSSL
Both the following OpenSSL license and SSLeay license apply to the OpenSSL license. This information canalso be newed on http://openssl.org
OpenSSL License---------------
==================================================================== Copyright (c) 1998-2008 The OpenSSL Project. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software must display the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact [email protected].
5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their names without prior written permission of the OpenSSL Project.
6. Redistributions of any form whatsoever must retain the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)"
THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ====================================================================
This product includes cryptographic software written by Eric Young ([email protected]). This product includes software written by Tim Hudson ([email protected]).
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
80
Appendix B About Using of Open Sources
Original SSLeay License-----------------------
Copyright (C) 1995-1998 Eric Young ([email protected]) All rights reserved.
This package is an SSL implementation written by Eric Young ([email protected]). The implementation was written so as to conform with Netscapes SSL.
This library is free for commercial and non-commercial use as long as the following conditions are aheared to. The following conditions apply to all code found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not just the SSL code. The SSL documentation included with this distribution is covered by the same copyright terms except that the holder is Tim Hudson ([email protected]).
Copyright remains Eric Young's, and as such any Copyright notices in the code are not to be removed. If this package is used in a product, Eric Young should be given attribution as the author of the parts of the library used. This can be in the form of a textual message at program startup or in documentation (online or textual) provided with the package.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. All advertising materials mentioning features or use of this software must display the following acknowledgement: "This product includes cryptographic software written by Eric Young ([email protected])" The word 'cryptographic' can be left out if the rouines from the library being used are not cryptographic related :-). 4. If you include any Windows specific code (or a derivative thereof) from the apps directory (application code) you must include an acknowledgement: "This product includes software written by Tim Hudson ([email protected])"
THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
The license and distribution terms for any publically available version or derivative of this code cannot be changed. i.e. this code cannot simply be copied and put under another distribution license [including the GNU Public License.]
ETERNUS SMI-S User’s Guide
Copyright 2013 FUJITSU LIMITED P3AM-4602-06ENZ0
81
ETERNUS SMI-S User's GuideETERNUS DX80 S2/DX90 S2, ETERNUS DX410 S2/DX440 S2,
ETERNUS DX8100 S2/DX8700 S2
P3AM-4602-06ENZ0
Date of issuance: June 2013Issuance responsibility: FUJITSU LIMITED
• The content of this manual is subject to change without notice.
• This manual was prepared with the utmost attention to detail. However, Fujitsu shall assume no responsibility for any operational problems as the result of errors, omissions, or the use of information in this manual.
• Fujitsu assumes no liability for damages to third party copyrights or other rights arising from the use of any information in this manual.
• The content of this manual may not be reproduced or distributed in part or in its entirety without prior permission from Fujitsu.