Skip to main content
SnapCenter 4.7 cmdlets

Invoke-SmResourceSplit

Contributors

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