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
}
# SIG # Begin signature block
# MIIXRQYJKoZIhvcNAQcCoIIXNjCCFzICAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAKbo3KHWobFMz0
# WiRaHwCVTsyyjBfpWVkg/oNCfKOcIqCCE2gwggVyMIIDWqADAgECAhB2U/6sdUZI
# k/Xl10pIOk74MA0GCSqGSIb3DQEBDAUAMFMxCzAJBgNVBAYTAkJFMRkwFwYDVQQK
# ExBHbG9iYWxTaWduIG52LXNhMSkwJwYDVQQDEyBHbG9iYWxTaWduIENvZGUgU2ln
# bmluZyBSb290IFI0NTAeFw0yMDAzMTgwMDAwMDBaFw00NTAzMTgwMDAwMDBaMFMx
# CzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMSkwJwYDVQQD
# EyBHbG9iYWxTaWduIENvZGUgU2lnbmluZyBSb290IFI0NTCCAiIwDQYJKoZIhvcN
# AQEBBQADggIPADCCAgoCggIBALYtxTDdeuirkD0DcrA6S5kWYbLl/6VnHTcc5X7s
# k4OqhPWjQ5uYRYq4Y1ddmwCIBCXp+GiSS4LYS8lKA/Oof2qPimEnvaFE0P31PyLC
# o0+RjbMFsiiCkV37WYgFC5cGwpj4LKczJO5QOkHM8KCwex1N0qhYOJbp3/kbkbuL
# ECzSx0Mdogl0oYCve+YzCgxZa4689Ktal3t/rlX7hPCA/oRM1+K6vcR1oW+9YRB0
# RLKYB+J0q/9o3GwmPukf5eAEh60w0wyNA3xVuBZwXCR4ICXrZ2eIq7pONJhrcBHe
# OMrUvqHAnOHfHgIB2DvhZ0OEts/8dLcvhKO/ugk3PWdssUVcGWGrQYP1rB3rdw1G
# R3POv72Vle2dK4gQ/vpY6KdX4bPPqFrpByWbEsSegHI9k9yMlN87ROYmgPzSwwPw
# jAzSRdYu54+YnuYE7kJuZ35CFnFi5wT5YMZkobacgSFOK8ZtaJSGxpl0c2cxepHy
# 1Ix5bnymu35Gb03FhRIrz5oiRAiohTfOB2FXBhcSJMDEMXOhmDVXR34QOkXZLaRR
# kJipoAc3xGUaqhxrFnf3p5fsPxkwmW8x++pAsufSxPrJ0PBQdnRZ+o1tFzK++Ol+
# A/Tnh3Wa1EqRLIUDEwIrQoDyiWo2z8hMoM6e+MuNrRan097VmxinxpI68YJj8S4O
# JGTfAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0G
# A1UdDgQWBBQfAL9GgAr8eDm3pbRD2VZQu86WOzANBgkqhkiG9w0BAQwFAAOCAgEA
# Xiu6dJc0RF92SChAhJPuAW7pobPWgCXme+S8CZE9D/x2rdfUMCC7j2DQkdYc8pzv
# eBorlDICwSSWUlIC0PPR/PKbOW6Z4R+OQ0F9mh5byV2ahPwm5ofzdHImraQb2T07
# alKgPAkeLx57szO0Rcf3rLGvk2Ctdq64shV464Nq6//bRqsk5e4C+pAfWcAvXda3
# XaRcELdyU/hBTsz6eBolSsr+hWJDYcO0N6qB0vTWOg+9jVl+MEfeK2vnIVAzX9Rn
# m9S4Z588J5kD/4VDjnMSyiDN6GHVsWbcF9Y5bQ/bzyM3oYKJThxrP9agzaoHnT5C
# JqrXDO76R78aUn7RdYHTyYpiF21PiKAhoCY+r23ZYjAf6Zgorm6N1Y5McmaTgI0q
# 41XHYGeQQlZcIlEPs9xOOe5N3dkdeBBUO27Ql28DtR6yI3PGErKaZND8lYUkqP/f
# obDckUCu3wkzq7ndkrfxzJF0O2nrZ5cbkL/nx6BvcbtXv7ePWu16QGoWzYCELS/h
# AtQklEOzFfwMKxv9cW/8y7x1Fzpeg9LJsy8b1ZyNf1T+fn7kVqOHp53hWVKUQY9t
# W76GlZr/GnbdQNJRSnC0HzNjI3c/7CceWeQIh+00gkoPP/6gHcH1Z3NFhnj0qinp
# J4fGGdvGExTDOUmHTaCX4GUT9Z13Vunas1jHOvLAzYIwggbmMIIEzqADAgECAhB3
# vQ4DobcI+FSrBnIQ2QRHMA0GCSqGSIb3DQEBCwUAMFMxCzAJBgNVBAYTAkJFMRkw
# FwYDVQQKExBHbG9iYWxTaWduIG52LXNhMSkwJwYDVQQDEyBHbG9iYWxTaWduIENv
# ZGUgU2lnbmluZyBSb290IFI0NTAeFw0yMDA3MjgwMDAwMDBaFw0zMDA3MjgwMDAw
# MDBaMFkxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMS8w
# LQYDVQQDEyZHbG9iYWxTaWduIEdDQyBSNDUgQ29kZVNpZ25pbmcgQ0EgMjAyMDCC
# AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANZCTfnjT8Yj9GwdgaYw90g9
# z9DljeUgIpYHRDVdBs8PHXBg5iZU+lMjYAKoXwIC947Jbj2peAW9jvVPGSSZfM8R
# Fpsfe2vSo3toZXer2LEsP9NyBjJcW6xQZywlTVYGNvzBYkx9fYYWlZpdVLpQ0LB/
# okQZ6dZubD4Twp8R1F80W1FoMWMK+FvQ3rpZXzGviWg4QD4I6FNnTmO2IY7v3Y2F
# QVWeHLw33JWgxHGnHxulSW4KIFl+iaNYFZcAJWnf3sJqUGVOU/troZ8YHooOX1Re
# veBbz/IMBNLeCKEQJvey83ouwo6WwT/Opdr0WSiMN2WhMZYLjqR2dxVJhGaCJedD
# CndSsZlRQv+hst2c0twY2cGGqUAdQZdihryo/6LHYxcG/WZ6NpQBIIl4H5D0e6lS
# TmpPVAYqgK+ex1BC+mUK4wH0sW6sDqjjgRmoOMieAyiGpHSnR5V+cloqexVqHMRp
# 5rC+QBmZy9J9VU4inBDgoVvDsy56i8Te8UsfjCh5MEV/bBO2PSz/LUqKKuwoDy3K
# 1JyYikptWjYsL9+6y+JBSgh3GIitNWGUEvOkcuvuNp6nUSeRPPeiGsz8h+WX4VGH
# aekizIPAtw9FbAfhQ0/UjErOz2OxtaQQevkNDCiwazT+IWgnb+z4+iaEW3VCzYkm
# eVmda6tjcWKQJQ0IIPH/AgMBAAGjggGuMIIBqjAOBgNVHQ8BAf8EBAMCAYYwEwYD
# VR0lBAwwCgYIKwYBBQUHAwMwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQU
# 2rONwCSQo2t30wygWd0hZ2R2C3gwHwYDVR0jBBgwFoAUHwC/RoAK/Hg5t6W0Q9lW
# ULvOljswgZMGCCsGAQUFBwEBBIGGMIGDMDkGCCsGAQUFBzABhi1odHRwOi8vb2Nz
# cC5nbG9iYWxzaWduLmNvbS9jb2Rlc2lnbmluZ3Jvb3RyNDUwRgYIKwYBBQUHMAKG
# Omh0dHA6Ly9zZWN1cmUuZ2xvYmFsc2lnbi5jb20vY2FjZXJ0L2NvZGVzaWduaW5n
# cm9vdHI0NS5jcnQwQQYDVR0fBDowODA2oDSgMoYwaHR0cDovL2NybC5nbG9iYWxz
# aWduLmNvbS9jb2Rlc2lnbmluZ3Jvb3RyNDUuY3JsMFYGA1UdIARPME0wQQYJKwYB
# BAGgMgEyMDQwMgYIKwYBBQUHAgEWJmh0dHBzOi8vd3d3Lmdsb2JhbHNpZ24uY29t
# L3JlcG9zaXRvcnkvMAgGBmeBDAEEATANBgkqhkiG9w0BAQsFAAOCAgEACIhyJsav
# +qxfBsCqjJDa0LLAopf/bhMyFlT9PvQwEZ+PmPmbUt3yohbu2XiVppp8YbgEtfjr
# y/RhETP2ZSW3EUKL2Glux/+VtIFDqX6uv4LWTcwRo4NxahBeGQWn52x/VvSoXMNO
# Ca1Za7j5fqUuuPzeDsKg+7AE1BMbxyepuaotMTvPRkyd60zsvC6c8YejfzhpX0FA
# Z/ZTfepB7449+6nUEThG3zzr9s0ivRPN8OHm5TOgvjzkeNUbzCDyMHOwIhz2hNab
# XAAC4ShSS/8SS0Dq7rAaBgaehObn8NuERvtz2StCtslXNMcWwKbrIbmqDvf+28rr
# vBfLuGfr4z5P26mUhmRVyQkKwNkEcUoRS1pkw7x4eK1MRyZlB5nVzTZgoTNTs/Z7
# KtWJQDxxpav4mVn945uSS90FvQsMeAYrz1PYvRKaWyeGhT+RvuB4gHNU36cdZytq
# tq5NiYAkCFJwUPMB/0SuL5rg4UkI4eFb1zjRngqKnZQnm8qjudviNmrjb7lYYuA2
# eDYB+sGniXomU6Ncu9Ky64rLYwgv/h7zViniNZvY/+mlvW1LWSyJLC9Su7UpkNpD
# R7xy3bzZv4DB3LCrtEsdWDY3ZOub4YUXmimi/eYI0pL/oPh84emn0TCOXyZQK8ei
# 4pd3iu/YTT4m65lAYPM8Zwy2CHIpNVOBNNwwggcEMIIE7KADAgECAgxcuW61kTkv
# +4t8zgQwDQYJKoZIhvcNAQELBQAwWTELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEds
# b2JhbFNpZ24gbnYtc2ExLzAtBgNVBAMTJkdsb2JhbFNpZ24gR0NDIFI0NSBDb2Rl
# U2lnbmluZyBDQSAyMDIwMB4XDTI0MDMxMTE0MDQxMloXDTI3MDMxMjE0MDQxMlow
# cjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFDASBgNVBAcTC1Nh
# bnRhIENsYXJhMRswGQYDVQQKExJQdXJlIFN0b3JhZ2UsIEluYy4xGzAZBgNVBAMT
# ElB1cmUgU3RvcmFnZSwgSW5jLjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC
# ggIBAMCQrioSn48IvHpTg5dofsUYj/pNTDidwjYUrcxVu78NoyhSweG8FhcxDi/S
# I40+8Fccl3D5ZoqpjkFnGhzSwmpxU3J4AP7+fdTZht9eWD1I5qKY07esYwdPDV4y
# g+csPfdGPqI2XjRfT5UC3YkXQeUrX8KQZldD4KqvgxzpYcuBwsgHbTb/eArpi68Y
# gFR2jgZGyZigfy8RuJMrL1thcBOe/VWjUyK21wVT8cuunBYFaStLHhsRBRMDcZBD
# uTSGC4evE6oaCqlQbdMl9YFJ64mDQsKlCxrr7rmLVtcVzKGwmjp4b2xRwE+RmTh6
# JtrUL9Wx/3a3UzgAnDNimfwp85zoL48kyLtHqQ3FI8tVKGm+aBOgBZfmURoy7fbp
# 4zKhGgqFbpOmILO16i4f999YsEEJQgIF3CtyH1R60/ZZWlDmoeeEgjAGrnd14muU
# 5Hk3Cksr43uPUAg+fV78Y0fDV85ibm42ZwwPuz6MI4HhYNUlGzRwIQ31vjaGuAMW
# HNqFKkcO0JuIeHQ/gFKPnYIxnGC9H9R4Kw/uMezqtnYJwGU2epB/ABl/w7U4NgU2
# ZOxWB5BFy4frZ3f+hNgbjFUjMaXnVFotOJxXntzjdSl4znw8DaKiC5ooChteZMIT
# G9p078p/TUsOJQbUtFADSY1hsfCfB7t+gJSNt5peS9GOZIMVAgMBAAGjggGxMIIB
# rTAOBgNVHQ8BAf8EBAMCB4AwgZsGCCsGAQUFBwEBBIGOMIGLMEoGCCsGAQUFBzAC
# hj5odHRwOi8vc2VjdXJlLmdsb2JhbHNpZ24uY29tL2NhY2VydC9nc2djY3I0NWNv
# ZGVzaWduY2EyMDIwLmNydDA9BggrBgEFBQcwAYYxaHR0cDovL29jc3AuZ2xvYmFs
# c2lnbi5jb20vZ3NnY2NyNDVjb2Rlc2lnbmNhMjAyMDBWBgNVHSAETzBNMEEGCSsG
# AQQBoDIBMjA0MDIGCCsGAQUFBwIBFiZodHRwczovL3d3dy5nbG9iYWxzaWduLmNv
# bS9yZXBvc2l0b3J5LzAIBgZngQwBBAEwCQYDVR0TBAIwADBFBgNVHR8EPjA8MDqg
# OKA2hjRodHRwOi8vY3JsLmdsb2JhbHNpZ24uY29tL2dzZ2NjcjQ1Y29kZXNpZ25j
# YTIwMjAuY3JsMBMGA1UdJQQMMAoGCCsGAQUFBwMDMB8GA1UdIwQYMBaAFNqzjcAk
# kKNrd9MMoFndIWdkdgt4MB0GA1UdDgQWBBSzJ9KiDCa3UBiAajy+Iioj5kQjzDAN
# BgkqhkiG9w0BAQsFAAOCAgEAHsFQixeQEcoHurq9NWSUt4S39Q+UGP6crmVq3Wwy
# 9g23YbdWg+SgMxoLUqdoDfA4k4B6Dyoo0jEQzn2kxnsnT9lNHKrcZHH88dv0hjfi
# H2qAiQWazPjS3LhK2J6nhpyipJPpyRaSQG4x4aG0NB2D4WUfUz9CGAYsERJGww/w
# kTaaxMipttKDTaI1C49u1igDfRzIO+Q8vuyyBFLiYTno/df97xtjNC+KxxFhDhl/
# 4tawK6kwxaVzCMAfj48I67Wbo4DMH6pM1s19as7c3qp92i3MylGKsB6+u+o7UkbS
# dLNkS4ALI33CJOUc+GoK3Nt5IXXCFJTQFHBXkBdAur3gmlXEm8vlNG/1Sbxr0H7T
# 1e7ABGH/48o/+PeMLuCc72EeK5dJ4cX9NEQ3QnTsZHwGnYzjEOvOvP0s1c7yNsDb
# cUHoIqQvb5xS5aqMU5G+8sdPQ1nwpPf7gGaEEbAVW4w51Pam42qeN9HIPa+ZinXn
# sN02Kk1Qw0QwUqzaQy9W/gIquI0KOjw0LmoW9M/8S0lrjpEq2eEeUw9WQLhhUEIi
# rFxGPtjqiCLiiS9CZ+kf2vWLJKUspkYv+OHT3q805Zg1dJsBFAzEYUFLb1mhmigD
# EO9bsMorjECIL2ijE5zHtbGkalrrsPWu8tiDT/B7P9GSYzKfOOy4PoOIfWSK0Ixl
# S7IxggMzMIIDLwIBATBpMFkxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxT
# aWduIG52LXNhMS8wLQYDVQQDEyZHbG9iYWxTaWduIEdDQyBSNDUgQ29kZVNpZ25p
# bmcgQ0EgMjAyMAIMXLlutZE5L/uLfM4EMA0GCWCGSAFlAwQCAQUAoIGcMBkGCSqG
# SIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3
# AgEVMC8GCSqGSIb3DQEJBDEiBCDBQMep+2PVB+AzVLt+dSORRVHp3WJZC8kVO6NN
# jjTyvDAwBgorBgEEAYI3AgEMMSIwIKACgAChGoAYaHR0cHM6Ly9wdXJlc3RvcmFn
# ZS5jb20gMA0GCSqGSIb3DQEBAQUABIICABmiRs+/8/4z5UlqIz/nXssrpO2Trp3z
# iq9rwhHU/UekYLZx8wmSSYy7I95x4JRMHX0SjXYkNGZiC8HP+qOrLouDlv1WyVkx
# MeUUZnS2fJRJ9XokI3W4/DB80oFX4XSj+VTbuxa+cR368FQMPpu0zCquy0Pg/SPy
# 07MQPHp83IAvommXA5wqd9mx90sl3wcuhFmgUn6d8FhKc0FGAhgaHjsoqbTHfOg8
# jP62hJJsRAM63l4dcqn1yg0b/anvS07rSpxn+sOvKwBOh7MJ7lAIJJyB3hCiZWWu
# KlnrgHFMkOtqLbtcypPU90HsQ3tkTpluHV77aHaCbdctBuhBJJdSI/GHI3SL45fC
# XyRBQ7QiQMBTbaeNVC8Bhqzgb3psyMJ3XNxZJeng9BkI/+Mog/DvpRidJ0NxPttm
# Fv0SAAHaFY6qoHptJxAaa03CEMXuu5uwe9AtQ0AsnzSyVD59O2dJhYLNlPQXRg5k
# hVQDOzMju3Ij1Newcq9mOsO2KkNYiGCkcwvttKa41mEpHq1YFL6cHhAo5GMD7upc
# JgSHDqdXxrHqlNXo3euXmFLCzHkb01kQyvOYQ43Ick9tGG9/LTYTErq+QtZMtXoY
# u71wv71msOhT6yk9NZfQ+YgfYb4ywJax+Z8cN8IRMhAWHv7NNEUmUvrRv7wYX9+w
# sYHyeIZbR/E1
# SIG # End signature block