SnapCenter Powershell Commands
Invoke-SmResourceSplit
Suggest changes
PDFs
Initiates the split clone operation.
Syntax
Invoke-SmResourceSplit [-Estimate] <> [-AppObjectId] <String> [-CloneName] <String> [-Start] <> [-AppObjectId] <String> [-CloneName] <String> [-DoNotEstimate] <> [-EnableEmail] <> [-EmailPreference] <SmEmailNotificationPreference> [-Stop] <> [-AppObjectId] <String> [-CloneName] <String> [-Status] <> [-AppObjectId] <String> [-CloneName] <String>
Detailed Description
You can use SnapCenter to split the database clone from the parent database. The split clone database becomes independent of the original database.
Parameters
| Name | Description | Required? | Pipeline Input | Default Value |
|---|---|---|---|---|
Estimate |
Specifies that details be provided for volumes that are being split. |
false |
true (ByValue) |
|
AppObjectId |
Specifies the AppObjectId of the clone where the split will be performed. |
false |
true (ByValue) |
|
CloneName |
The name of the clone where the split will be performed. |
false |
true (ByValue) |
|
EmailBody |
false |
true (ByPropertyName) |
||
EmailFrom |
true |
true (ByPropertyName) |
||
EmailTo |
true |
true (ByPropertyName) |
||
EmailSubject |
true |
true (ByPropertyName) |
||
EnableEmailAttachment |
false |
true (ByPropertyName) |
||
Start |
Triggers the split clone operation. |
false |
true (ByValue) |
|
DoNotEstimate |
Specifies that details should not be provided for the volumes that are being split. |
false |
true (ByValue) |
|
EnableEmail |
Enables email notifications. |
false |
false |
|
EmailPreference |
Specifies when you will received email notifications. Possible values include Always, Never, OnError, OnErrorOrWarning. |
false |
false |
|
Stop |
Stops the split clone operation. |
false |
true (ByValue) |
|
Status |
Determines the status of the split clone operation. |
false |
true (ByValue) |
Examples
Example 1: Clone split estimate
Invoke-SmResourceSplit -AppObjectId 'SC14110001040-3\NAMEDINST1\SC14110001040_3_SDML_1_Clone_103255' -Estimate
This example syntax displays the estimate details for the volume that is going to be split.
Clone Split Estimate Job Summary:
=================================
JobId : 221
ListVolumeAggSpaceMapping : {SC14110001040_3_SDML_Data_Vol1115172233091381,
SC14110001040_3_SDML_Log_Vol1115172233079350}
CanSplit : True
AppObjectId : SC14110001040_3_SDML_1_Clone_103255
CloneName : ResourceGroup_SDML_45212443__clone__11-15-2017_22.33.25
Result: SMCoreContracts.SMResult
TotalCount: 0
DisplayCount : 0
Context :
Job : SMCoreContracts.SmJob
Estimation Details for the volumes involved in Clone Split:
===========================================================
VolumeName: SC14110001040_3_SDML_Data_Vol1115172233091381
RequiredSpace : 24 MB
AggregateName : aggr_anu
AvailableSpaceInAggregate : 3528 GB
StorageSystem : 10.225.85.51
IsVolumeAlreadySplit : False
VolumeName: SC14110001040_3_SDML_Log_Vol1115172233079350
RequiredSpace : 22 MB
AggregateName : aggr_anu
AvailableSpaceInAggregate : 3528 GB
StorageSystem : 10.225.85.51
IsVolumeAlreadySplit : False
Example 2: Clone split status
Invoke-SmResourceSplit -CloneName 'Resource_Group_Instance_45212443__clone__11-15-2017_22.44.24' -Status
This example syntax displays the status of a clone split operation.
Clone Split Status Job Summary: =============================== JobId: 237 AppObjectId : SC14110001040_3_MDSL_4_Clone_104322 CloneName: Resource_Group_Instance_45212443__clone__11-15-2017_22.44.24 Result : SMCoreContracts.SMResult TotalCount : 0 DisplayCount : 0
Example 3: Starting a clone split operation
Invoke-SmResourceSplit -CloneName 'Resource_Group_Instance_45212443__clone__11-15-2017_22.44.24' -confirm:$false -Start
This example syntax starts a clone split operation.
Clone Split Start Job Summary: ============================== JobId: 238 AppObjectId : SC14110001040_3_MDSL_4_Clone_104322 CloneName: Resource_Group_Instance_45212443__clone__11-15-2017_22.44.24 Result : SMCoreContracts.SMResult TotalCount : 0 DisplayCount : 0 Context : Job : SMCoreContracts.SmJob
Example 4: Stopping a clone split operation
Invoke-SmResourceSplit -AppObjectId 'SC14110001040-3\NAMEDINST1\SC14110001040_3_MDML_4_Clone_105129' -Stop
This example syntax stops a clone split operation.
Clone Split Stop Job Summary: ============================= JobId: 246 AppObjectId : SC14110001040_3_MDML_4_Clone_105129 CloneName: Resource_Group_Instance_45212443__clone__11-15-2017_22.52.47 Result : SMCoreContracts.SMResult TotalCount : 0 DisplayCount : 0 Context : Job : SMCoreContracts.SmJob
Example 5: Clone split estimate for a SAP HANA MultiTenant Database Container resource clone
Invoke-SmResourceSplit -Estimate -CloneName SNAPCENTER40.sccore.test.com\hana\H30\H30_cn
This example syntax displays the estimate details for the volume that is going to be split. CloneName may be obtained by running the Get-SmClone command.
Clone Split Stop Job Summary:
=============================
JobId : 773
ListVolumeAggSpaceMapping : {ng_pvol04021807440550}
CanSplit : True
AppObjectId : H30_cn
CloneName : SNAPCENTER40.sccore.test.com\hana\H30\H30_cn
Result: SMCoreContracts.SMResult
TotalCount: 0
DisplayCount : 0
Context :
Job : SMCoreContracts.SmJob
Estimation Details for the volumes involved in Clone Split:
===========================================================
VolumeName: ng_pvol04021807440550
RequiredSpace : 48 MB
AggregateName : aggr1_old
AvailableSpaceInAggregate : 4670 GB
StorageSystem : 10.200.200.100
IsVolumeAlreadySplit : False
Example 6: Starting a clone split operation for a SAP HANA MultiTenant Database Container resource clone
Invoke-SmResourceSplit -start -CloneName SNAPCENTER40.sccore.test.com\hana\H30\H30_cn
This example syntax starts a clone split operation. CloneName may be obtained by running the Get-SmClone command.
This may take several minutes to complete for large volumes. All backups taken on the clone will be deleted Do you still want to continue? [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): Clone Split Start Job Summary: ============================== JobId: 774 AppObjectId : H30_cn CloneName: SNAPCENTER40.sccore.test.com\hana\H30\H30_cn Result : SMCoreContracts.SMResult TotalCount : 0 DisplayCount : 0 Context : Job : SMCoreContracts.SmJob
Example 7: Stopping a clone split operation for a SAP HANA MultiTenant Database Container resource clone
Invoke-SmResourceSplit -stop -CloneName SNAPCENTER40.sccore.test.com\hana\H30\H30_cn
This example syntax stops a clone split operation. CloneName may be obtained by running the Get-SmClone command
Clone Split Stop Job Summary: ============================= JobId: 775 AppObjectId : H30_cn CloneName: SNAPCENTER40.sccore.test.com\hana\H30\H30_cn Result : SMCoreContracts.SMResult TotalCount : 0 DisplayCount : 0 Context : Job : SMCoreContracts.SmJob