This blog post explains how to configure Array Based Replication (ABR) with the PowerCLI VMware.Sdk.Srm module. Before diving in, consider reading the blog post, explaining the basic concepts of the VMware.Sdk.Srm module: “Managing SRM and VR with PowerCLI 13.1“. There you can find out more about the module’s connection management, which will not be covered in details here.
Connect Site Recovery Manager with Connect-SrmSdkServer
To connect Site Recover Manager server use the Connect-SrmSdkServer cmdlet:
|
1 2 3 4 5 |
$srmConnection = Connect-SrmSdkServer -Server "MySrmAddress.com" ` -Password "MyLocalVcPassword" ` -RemotePassword "MyRemoteVcPassword" |
Create Array Managers for the Array Pair
Before creating the array pair you must create array managers for the local and the remote sites.
Retrieve Storage Replication Adapter for the local Array Manager
For this example we will use NetApp Storage Replication Adapter for ONTAP:
|
1 2 3 4 |
$localAdapter = (Invoke-SrmGetStorageAdapters -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.LocalSrmServer.Id ` -FilterProperty 'Name' ` -Filter 'NetApp').List[0] |
Invoke-SrmGetStorageAdapters returns a list of adapters, matching the specified filters. In our case we filter the available storage adapters by their Name property and expect only one adapter with name matching ‘NetApp’ to be found. Accordingly we will use the first element of the List property of the StorageAdapterDetailsDrResponseList object, returned from Invoke-SrmGetStorageAdapters.
Prepare Connection Parameters for the Storage Replication Adapter
To allow the array manager to communicate with the storage adapter we must prepare connection parameters, which will be used for the connection. Retrieve ConnectionParamGroup object for the local storage adapter:
|
1 2 3 4 |
$localConnectionParamGroup = (Invoke-SrmGetStorageAdapterConnectionParams ` -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.LocalSrmServer.Id ` -StorageAdapterId $localAdapter.Id).List[0] |
The output of Invoke-SrmGetStorageAdapterConnectionParams is a ConnectionParamGroupDrResponseList object, which in our case contains a list of one ConnectionParamGroup element. You have to provide values to the connection parameter, available in the $localConnectionParamGroup.ConnectionParams list. The set of parameters, available in the ConnectionParams list is specific for the used storage replication adapter. Here we will provide values for connection parameters, specific for the NetApp storage replication adapter:
|
1 2 3 4 5 |
($localConnectionParamGroup.ConnectionParams | where {$_.key -eq "username"}).Value = "myUser" ($localConnectionParamGroup.ConnectionParams | where {$_.key -eq "password"}).Value = "myPass" ($localConnectionParamGroup.ConnectionParams | where {$_.key -eq "VolumeInclusion"}).Value = "myVolume" ($localConnectionParamGroup.ConnectionParams | where {$_.key -eq "SVM Name"}).Value = "myLocalSvmName" ($localConnectionParamGroup.ConnectionParams | where {$_.key -eq "mgmtIP"}).Value = "192.168.10.10" |
Create the local Array Manager
Now when we have all the prerequisites for the array manager, use the ConnectionParamGroup and the storage adapter Id to initialize ArrayManagerSpec object:
|
1 2 3 |
$localArrayManagerSpec = Initialize-SrmArrayManagerSpec -Name "primary-array-manager" ` -StorageAdapter $localAdapters.Id ` -ConnectionParams $localConnectionParamGroup |
Then create the array manger, using the Invoke-SrmCreateArrayManage cmdlet:
|
1 2 3 |
$task = Invoke-SrmCreateArrayManager -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.LocalSrmServer.Id ` -ArrayManagerSpec $localArrayManagerSpec |
Wait for the task to complete and retrieve the array manager. The Result property of the task will contain the Id of the array manager, once the task completes:
|
1 2 3 4 5 |
$localManagerTask = Invoke-SrmGetTaskInfo -TaskId $task.Id $localArrayManager = Invoke-SrmGetArrayManager -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.LocalSrmServer.Id ` -ArrayManagerId $localManagerTask.Result |
Create the remote array manager, using the same approach:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 |
$remoteAdapter = (Invoke-SrmGetStorageAdapters -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.RemoteSrmServer.Id ` -FilterProperty 'Name' ` -Filter 'NetApp').List[0] $remoteConnectionParamGroup = (Invoke-SrmGetStorageAdapterConnectionParams ` -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.RemoteSrmServer.Id ` -StorageAdapterId $remoteAdapters.List[0].Id).List[0] ($remoteConnectionParamGroup.ConnectionParams | Where-Object {$_.key -eq "username"}).Value = "myUser" ($remoteConnectionParamGroup.ConnectionParams | Where-Object {$_.key -eq "password"}).Value = "myPass" ($remoteConnectionParamGroup.ConnectionParams | Where-Object {$_.key -eq "VolumeInclusion"}).Value = "myVolume" ($remoteConnectionParamGroup.ConnectionParams | Where-Object {$_.key -eq "SVM Name"}).Value = "myRemoteSvmName" ($remoteConnectionParamGroup.ConnectionParams | Where-Object {$_.key -eq "mgmtIP"}).Value = "192.168.10.11" $remoteArrayManagerSpec = Initialize-SrmArrayManagerSpec -Name "secondary-array-manager" ` -StorageAdapter $remoteAdapter.Id ` -ConnectionParams $remoteConnectionParamGroup $task = Invoke-SrmCreateArrayManager -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.RemoteSrmServer.Id ` -ArrayManagerSpec $remoteArrayManagerSpec #Wait for the create array manager task to complete $remoteManagerTask = Invoke-SrmGetTaskInfo -TaskId $task.Id $remoteArrayManager = Invoke-SrmGetArrayManager -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.RemoteSrmServer.Id ` -ArrayManagerId $remoteManagerTask.Result |
Create Replicated Array Pair
To create the replicated array pair, you have to initialize a ReplicatedArrayPairSpec object:
|
1 2 3 |
$replicatedArrayPairSpec = Initialize-SrmReplicatedArrayPairSpec -ArrayManagerId $localArrayManager.Id ` -StorageArrayKey $localArrayManager.StorageArrays[0].StorageArrayKey ` -PeerStorageArrayKey $remoteArrayManager.StorageArrays[0].StorageArrayKey |
Besides the ArrayManagerId you have to specify the StorageArrayKey and the PeerStorageArrayKey parameter. The available storage array keys can be found in the StorageArrays property of the local and the remote array managers.
Use the Invoke-SrmCreateReplicatedArrayPair cmdlet to create the replicated array pair:
|
1 2 3 |
$task = Invoke-SrmCreateReplicatedArrayPair -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.LocalSrmServer.Id ` -ReplicatedArrayPairSpec $replicatedArrayPairSpec |
Wait for the task to complete and retrieve the replicated array pair. The Result property of the task will contain the Id of the replicated array pair, once the task completes:
|
1 2 3 4 5 |
$replicatedArrayPairTask = Invoke-SrmGetTaskInfo -TaskId $task.Id $replicatedArrayPair = Invoke-SrmGetReplicatedArrayPair -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.LocalSrmServer.Id ` -ArrayPairId $replicatedArrayPairTask.Result |
Create Protected Group and Recovery Plan for the Replicated Array Pair
Use the Invoke-SrmDiscoverStorageDevices cmdlet to discover the storage devices of the replicated array pair. Wait for the task to complete before proceeding to the next step:
|
1 2 3 4 5 |
$task = Invoke-SrmDiscoverStorageDevices -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.LocalSrmServer.Id ` -ArrayPairId $replicatedArrayPair.Id Invoke-SrmGetTaskInfo -TaskId $task.Id |
Retrieve the storage devices from the replicated array pair:
|
1 2 3 |
$storageDevices = Invoke-SrmGetStorageDevices -PairingId $srmConnection.ConnectedPairing.PairingId ` -SrmId $srmConnection.ConnectedPairing.LocalSrmServer.Id ` -ArrayPairId $replicatedArrayPair.Id |
Initialize an AbrProtectionGroupSpec object. In our setup we created replicated array pair with single storage device, containing one datastore. We will create protection group for this datastore:
|
1 2 3 |
$abrProtectionGroupSpec = Initialize-SrmAbrProtectionGroupSpec ` -ReplicatedArrayPair $replicatedArrayPair.Id ` -Datastores $storageDevices.StorageDevicesData[0].Datastores[0].Id |
Then initialize ProtectionGroupCreateSpec object. For the ReplicationType parameter specify ABR:
|
1 2 3 4 |
$protectionGroupSpec = Initialize-SrmProtectionGroupCreateSpec -Name "MyAbrProtectionGroup" ` -ReplicationType ABR ` -ProtectedVcGuid $srmConnection.ConnectedPairing.LocalVcServer.Id ` -AbrSpec $abrProtectionGroupSpec |
Use Invoke-SrmCreateGroup to create the ABR protection group. Wait for the task to complete and retrieve the protection group:
|
1 2 3 4 5 6 7 |
$task = Invoke-SrmCreateGroup -PairingId $srmConnection.ConnectedPairing.PairingId ` -ProtectionGroupCreateSpec $protectionGroupSpec $task = Invoke-SrmGetTaskInfo -TaskId $task.Id $protectionGroup = Invoke-SrmGetGroup -PairingId $srmConnection.ConnectedPairing.PairingId ` -GroupId $task.Result |
Finally, you can create recovery plan for the protection group, we have just crated. To do this, Initialize RecoveryPlanCreateSpec object:
|
1 2 3 4 |
$recPlanSpec = Initialize-SrmRecoveryPlanCreateSpec ` -Name "AbrRecoveryPlan" ` -ProtectedVcGuid $srmConnection.ConnectedPairing.LocalVcServer.Id ` -ProtectionGroups @($protectionGroup.Id) |
Create recovery plan with the Invoke-SrmCreatePlan cmdlet and wait for the task to complete:
|
1 2 3 4 |
$task = Invoke-SrmCreatePlan -PairingId $srmConnection.ConnectedPairing.PairingId ` -RecoveryPlanCreateSpec $recPlanSpec Invoke-SrmGetTaskInfo -TaskId $task.Id |
Disconnect the SRM server connection
After you have finished interacting with the SRM server, close the connection, using the Disconnect-SrmSdkServer cmdlet.
|
1 |
Disconnect-SrmSdkServer "MySrmAddress.com" |
Conclusion
VMware.Sdk.Srm PowerCLI module enables the access to the Site Recovery Manager Rest API through PowerShell cmdlets. In this article we covered the end to end scenario of configuring array based replication and creation of protection group and recovery plan, based on this replication flavor. If you’re interested in using host based replication, refer to the “Managing SRM and VR with PowerCLI 13.1” blog post.
