PureStorage.CBS.AVS.VVOLS.Replication.ps1
|
function Sync-VvolReplicationGroup { [CmdletBinding()] Param( [Parameter(mandatory = $true)] [String]$ReplicationGroupID, [Parameter(mandatory = $true)] [String]$PointInTimeReplicaName, [Parameter(Mandatory = $True)] $vCenterServer, [Parameter(Mandatory = $true)] [String]$AVSCloudName, [Parameter(Mandatory = $true)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) $PointInTimeReplica = Get-SpbmPointInTimeReplica -Server $vCenterServer -Name $PointInTimeReplicaName -ErrorAction Ignore if ($PointInTimeReplica) { throw "Point-in-time replica '$PointInTimeReplicaName' already exists." } $repGroup = Get-SpbmReplicationGroup -Server $vCenterServer -ID $ReplicationGroupID if (-not $repGroup) { throw "Could not find replication group '$ReplicationGroupID'..." } elseif ($repGroup.State -ne "Target") { throw "Replication group '$ReplicationGroupID' need to be the Target replication group." } # wait for rep groups to sync $retryCount = 10 $TimeoutInSecs = 10 do { Write-Progress -Activity "Start sync replication group" -Status "50% Complete:" -PercentComplete 50 $params = @{ ReplicationGroupId = $ReplicationGroupID PointInTimeReplicaName = $PointInTimeReplicaName } Invoke-RunScript -RunCommandName "Sync-ReplicationGroup" -RunCommandModule "Microsoft.AVS.VVOLS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -ErrorAction Ignore Start-Sleep -Seconds $TimeoutInSecs Get-SpbmPointInTimeReplica -name $PointInTimeReplicaName -ErrorAction SilentlyContinue -ErrorVariable stopError $retryCount-- } while ($stopError -and $retryCount -gt 0) if ($stopError) { throw 'Took too long to sync. Giving up.' } } function Start-VvolReplicationGroupFailover { [CmdletBinding()] Param( [Parameter(mandatory = $true)] [String]$ClusterName, [Parameter(mandatory = $true)] [String]$ReplicationGroupID, [Parameter(mandatory = $false)] [String]$PointInTimeReplicaName, [Parameter(mandatory = $false)] [bool]$PowerOn, [Parameter(mandatory = $false)] [bool]$TestFailover, [Parameter(Mandatory = $True)] $vCenterServer, [Parameter(Mandatory = $true)] [String]$AVSCloudName, [Parameter(Mandatory = $true)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) ## check that the cluster exists ## $Cluster = Get-Cluster -Server $vCenterServer -Name $ClusterName -ErrorAction Stop if (-not $Cluster) { throw "Could not find cluster '$ClusterName'..." } $repGroup = Get-SpbmReplicationGroup -ID $ReplicationGroupID if (-not $repGroup) { throw "Could not find replication group '$ReplicationGroupID'." } elseif ($repGroup.State -ne "Target") { throw "Replication group '$ReplicationGroupID' need to be a replication group in 'Target' state." } if ($PointInTimeReplicaName) { $PointInTimeReplica = Get-SpbmPointInTimeReplica -Server $vCenterServer -Name $PointInTimeReplicaName -ErrorAction Ignore if (-not $PointInTimeReplica) { throw "Could not find point-in-time replica '$PointInTimeReplicaName'." } } #creates groupid tag to tag new VMs $cat = Get-TagCategory -Name "PCBS-Rep-Group-ID" -ErrorAction SilentlyContinue if (-not $cat) { $cat = New-TagCategory -Name "PCBS-Rep-Group-ID" -EntityType "VirtualMachine" } $tag = Get-Tag -Name $ReplicationGroupID -Category $cat -ErrorAction SilentlyContinue if (-not $tag) { $tag = New-Tag -Name $ReplicationGroupID -Category $cat } $params = @{ ReplicationGroupId = $ReplicationGroupID TestFailover = $TestFailover PointInTimeReplicaName = $PointInTimeReplicaName } Write-Progress -Activity "Start failover" -Status "50% Complete:" -PercentComplete 50 Invoke-RunScript -RunCommandName "Start-ReplicationFailover" -RunCommandModule "Microsoft.AVS.VVOLS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -GetNamedOutputs -TimeoutInMinutes $TimeoutInMinutes $ReplicatedVMFiles = (Get-Variable -Name NamedOutputs).Value # Might need change after MSFT published the new package $ReplicatedVMFiles.psobject.Properties | ForEach-Object { # create VMs on the failover vcenter Write-Host "Creating vm from vm file $($_.value)..." $newvm = New-VM -VMFilePath $_.value -ResourcePool $ClusterName # assign rep group tag to new vm New-TagAssignment -Tag $tag -Entity $newvm | Out-Null ## Starting the VM if PowerOn param is true ## if ($PowerOn) { $newvm | Start-VM -ErrorAction SilentlyContinue -ErrorVariable hasQuestion | out-null if ($hasQuestion) { ## there is a question that is asked if the VM is copied or moved. This question must be answered ## $newvm | Get-VMQuestion | Set-VMQuestion -Option '*copied*' -Confirm:$false } } } } function Start-VvolCleanupSourceReplicationGroupForFailover { [CmdletBinding()] Param( [Parameter(Mandatory = $true)] [String]$ReplicationGroupID, [Parameter(Mandatory = $false)] [bool]$RemoveFromDisk, [Parameter(Mandatory = $True)] $vCenterServer, [Parameter(Mandatory = $true)] [String]$AVSCloudName, [Parameter(Mandatory = $true)] [String]$AVSResourceGroup ) ## Setting the Replication Group Variable ## $repGroup = Get-SpbmReplicationGroup -Server $vCenterServer -ID $ReplicationGroupID if (-not $repGroup) { throw "Could not find replication group '$ReplicationGroupID'." } elseif ($repGroup.State -ne "Source") { throw "Replication group '$ReplicationGroupID' need to be the Source replication group." } ## Get VMs related to replication Group ## $relatedVMs = Get-VM -RelatedObject $repGroup foreach ($vm in $relatedVMs) { # stop VMs # if we fail to stop it's probably powered off already so we can ignore, if it's not it will fail on the next step $vm | Stop-VM -Confirm:$false -ErrorAction SilentlyContinue # unregister VMs # if VM exists but we cannot remove it, we should not continue if ($RemoveFromDisk) { Write-Verbose "Removing VM files from disk for VM $($vm.Name)" $vm | Remove-VM -Confirm:$false -DeletePermanently -ErrorAction Stop } else { Write-Verbose "Unregister VM $($vm.Name) from inventory" $vm | Remove-VM -Confirm:$false -ErrorAction Stop } } # remove tag category created on previous failovers $cat = Get-TagCategory -Server $vCenterServer -Name "PCBS-Rep-Group-ID" -ErrorAction SilentlyContinue if ($cat) { $tag = Get-Tag -Server $vCenterServer -Category $cat -ErrorAction SilentlyContinue if (-not $tag) { Remove-TagCategory -Server $vCenterServer -Category $cat -Confirm:$false } } } function Remove-ReplicationTags { [CmdletBinding()] Param( [Parameter(mandatory = $true)] [String]$ReplicationGroupID, [Parameter(Mandatory = $True)] $vCenterServer ) $cat = Get-TagCategory -Server $vCenterServer -Name "PCBS-Rep-Group-ID" -ErrorAction SilentlyContinue if ($cat) { $tag = Get-Tag -Server $vCenterServer -Name $ReplicationGroupID -Category $cat -ErrorAction SilentlyContinue if ($tag) { # cleanup tags created by previous failovers Remove-Tag -Server $vCenterServer -Tag $tag -Confirm:$false } } } function Get-VMsByReplicationTags { [CmdletBinding()] Param( [Parameter(Mandatory = $true)] [String]$ReplicationGroupID, [Parameter(Mandatory = $True)] $vCenterServer ) $cat = Get-TagCategory -Server $vCenterServer -Name "PCBS-Rep-Group-ID" -ErrorAction SilentlyContinue $tag = Get-Tag -Server $vCenterServer -Name $ReplicationGroupID -Category $cat -ErrorAction SilentlyContinue if (-not $tag) { return $null } # get vms list $vms = Get-VM -Server $vCenterServer -Tag $tag return $vms } function Stop-VvolReplicationGroupFailoverTest { <# .SYNOPSIS Stops test failover operation against group .DESCRIPTION Issue test failover operation against group .INPUTS replication group ID, .OUTPUTS N.A. .NOTES Version: 1.0 .EXAMPLE Stop-VvolReplicationGroupFailoverTest -RepGroupID myGroupId #> [CmdletBinding()] Param( [Parameter(mandatory = $true)] [String]$ReplicationGroupID, [Parameter(Mandatory = $True)] $vCenterServer, [Parameter(Mandatory = $true)] [String]$AVSCloudName, [Parameter(Mandatory = $true)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) ## Setting the Replication Group Variable ## $repGroup = Get-SpbmReplicationGroup -Server $vCenterServer -ID $ReplicationGroupID if (-not $repGroup) { throw "Could not find replication group '$ReplicationGroupID'." } elseif ($repGroup.State -ne "InTest") { throw "Replication group '$ReplicationGroupID' need to be the InTest replication group." } # get vms list $vms = Get-VMsByReplicationTags -vCenterServer $vCenterServer -ReplicationGroupID $ReplicationGroupID foreach ($vm in $vms) { # stop VMs # if we fail to stop it's probably powered off already so we can ignore, if it's not it will fail on the next step $vm | Stop-VM -Confirm:$false -ErrorAction SilentlyContinue # unregister VMs # if VM exists but we cannot remove it, we should not continue $vm | Remove-VM -DeletePermanently:$true -Confirm:$false -ErrorAction Stop } Remove-ReplicationTags -vCenterServer $vCenterServer -ReplicationGroupID $ReplicationGroupID $retryCount = 5 $TimeoutInSecs = 20 do { # Issue test failover stop # can fail saying that resource is still in use, but works if we retry $params = @{ ReplicationGroupId = $ReplicationGroupID } Write-Progress -Activity "Stop failover" -Status "50% Complete:" -PercentComplete 50 Invoke-RunScript -RunCommandName "Stop-ReplicationTestFailover" -RunCommandModule "Microsoft.AVS.VVOLS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -ErrorAction SilentlyContinue $SPBMGroup = Get-SpbmReplicationGroup -ID $ReplicationGroupID # wait sometimes for vms to cleanup Start-Sleep -Seconds $TimeoutInSecs } while ($SPBMGroup.state -eq "InTest" -and $retryCount -gt 0) } function Start-VvolReprotectReplicationGroup { [CmdletBinding()] Param( [Parameter(Mandatory = $true)] [String]$ReplicationGroupID, [Parameter(Mandatory = $false)] [String]$PolicyName, [Parameter(Mandatory = $True)] $vCenterServer, [Parameter(Mandatory = $true)] [String]$AVSCloudName, [Parameter(Mandatory = $true)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) ## Setting the Replication Group Variable ## $failoverGroup = Get-SpbmReplicationGroup -Server $vCenterServer -ID $ReplicationGroupID if (-not $failoverGroup) { throw "Could not find replication group '$ReplicationGroupID'." } elseif ($failoverGroup.State -ne "FailedOver") { throw "Replication group '$ReplicationGroupID' need to be the FailedOver replication group." } ## Running the reverse replication group operation to reverse the source and target status for the Replication Group ## Write-Progress -Activity "Start failover reverse" -Status "50% Complete:" -PercentComplete 50 $params = @{ ReplicationGroupId = $ReplicationGroupID } Invoke-RunScript -RunCommandName "Start-ReplicationReverse" -RunCommandModule "Microsoft.AVS.VVOLS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -GetNamedOutputs -TimeoutInMinutes $TimeoutInMinutes # Might need change after MSFT published the new package $new_source_group = (Get-Variable -Name NamedOutputs).Value.new_source_group # get vms list $cat = Get-TagCategory -Server $vCenterServer -Name "PCBS-Rep-Group-ID" -ErrorAction SilentlyContinue $tag = Get-Tag -Server $vCenterServer -Name $ReplicationGroupID -Category $cat -ErrorAction SilentlyContinue if (-not $tag) { throw "VM tag '$ReplicationGroupID' is missing. Failed to find VMs to reprotect." } # get vms list $vms = Get-VM -Tag $tag ## Setting the New VM to a variable on the recovery vCenter Server $relevantObjs = @() foreach ($newvm in $vms) { $relevantObjs += $newvm $HD1 = $newvm | Get-HardDisk $relevantObjs += $HD1 } ## get relevant SPBM-related configuration data of Virtual Machine, Hard Disk, and Datastore objects $spbmConfig = $relevantObjs | Get-SpbmEntityConfiguration ## Resetting the storage policy for the VM and each virtual disk to the "VVol No Requirements Policy" ## Write-Host "Resetting the storage policy for the VM and each virtual disk to the 'VVol No Requirements Policy'..." $noReqPolicy = Get-SpbmStoragePolicy -name 'VVol No Requirements Policy' $spbmConfig | Set-SpbmEntityConfiguration -StoragePolicy $noReqPolicy if ($PolicyName) { Write-Host "Re-protecting VMs with policy $PolicyName..." ## Setting the Variables for the replication group and storage policy that we want to use to re-protect the VM to the previous source/protected site ## $new_policy = Get-SpbmStoragePolicy -name $PolicyName -ErrorAction Ignore if (-not $new_policy) { throw "Could not find storage policy '$PolicyName'..." } $new_rg = $new_policy | Get-SpbmReplicationGroup -Name $new_source_group ## Applying the Storage Policy and Replication group to the VMs to complete the Re-protect process ## $spbmConfig | Set-SpbmEntityConfiguration -StoragePolicy $new_policy -ReplicationGroup $new_rg } Remove-ReplicationTags -ReplicationGroupID $ReplicationGroupID -vCenterServer $vCenterServer } |