PureStorage.CBS.AVS.VMFS.ps1
|
function Get-PfaVolumeFromVMFSDataStore { Param( [Parameter(mandatory=$true)] $FlashArray, [Parameter(mandatory=$true)] $DataStore ) $Lun = $Datastore.ExtensionData.Info.Vmfs.Extent.DiskName |select-object -unique if ($Lun -like 'naa.624a9370*') { $VolSerial = ($lun.ToUpper()).substring(12) $PureVol = Get-Pfa2Volume -Array $FlashArray -Filter "Serial='$VolSerial'" } else { throw "This VMFS is not hosted on Pure Cloud Block Store." } return $PureVol } function Remove-PfaVmfsDatastore { [CmdletBinding()] Param( [Parameter(Mandatory=$true)] $Cluster, [Parameter(Mandatory=$true)] $Datastore, [Parameter(ValueFromPipeline=$True)] $FlashArray, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) $PureVol = Get-PfaVolumeFromVMFSDataStore -FlashArray $FlashArray -Datastore $Datastore Write-Progress -Activity "Dismounting datastore" -Status "25% Complete:" -PercentComplete 25 $params = @{ ClusterName = $Cluster.Name; DatastoreName = $Datastore.Name } # Question: We just do unmount/detach at VMWare side. Do we need to run Remove-Datastore to clean the datastore? Invoke-RunScript -RunCommandName "Dismount-VmfsDatastore" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes Write-Progress -Activity "Removing volume" -Status "50% Complete:" -PercentComplete 50 # Remove volume from array hostgroup if available $FaHg = Get-PfaHostGroupfromVcCluster -Flasharray $Flasharray -Cluster $Cluster $HgConnection = Get-Pfa2Connection -Array $FlashArray -VolumeNames $PureVol.Name -HostGroupNames $FaHg.Name -ErrorAction SilentlyContinue if ($HgConnection) { Write-Host "Removing volume $($PureVol.Name) from host group $($FaHg.Name)..." Remove-Pfa2Connection -Array $FlashArray -VolumeNames $PureVol.Name -HostGroupNames $FaHg.Name } # Destroy volume if there is no host/hg connections for the volume $Connections = Get-Pfa2Connection -Array $FlashArray -VolumeNames $PureVol.Name if (-not $Connections) { Write-Host "Destroying volume $($PureVol.Name)..." Remove-Pfa2Volume -Array $FlashArray -Name $PureVol.Name -Confirm:$false } Write-Progress -Activity "Rescanning storage" -Status "75% Complete:" -PercentComplete 75 $params = @{ ClusterName = $Cluster.Name; } Invoke-RunScript -RunCommandName "Sync-ClusterVMHostStorage" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } function New-VolumeFromSnaspshot { [CmdletBinding()] Param( [Parameter(ValueFromPipeline=$True)] $FlashArray, [Parameter(Mandatory=$true)] [String]$SnapshotName ) $VolumeSnapshot = Get-Pfa2VolumeSnapshot -Array $FlashArray -Name $SnapshotName -ErrorAction Ignore if (-not $VolumeSnapshot) { throw "Could not find snapshot '$SnapshotName'." } if ($VolumeSnapshot.Source.Name) { # If the original volume still exist $VolumeName = $volumeSnapshot.Source.Name + "-"+ (Get-Random -Minimum 10000000 -Maximum 99999999) } else { # If the original volume is missing, get volume name from snapshot name # Get Alphanumeric string from snapshot $FilteredSnapshotName = $SnapshotName -replace "[^a-zA-Z0-9]" $VolumeName = $FilteredSnapshotName + "-volcopy-"+ (Get-Random -Minimum 10000000 -Maximum 99999999) } $newVol = New-PfaVolumeByPrefix -FlashArray $FlashArray -Name $VolumeName -SourceName $SnapshotName return $newVol } function Restore-PfaVmfsFromProtectionGroupSnapshot { <# .SYNOPSIS Mounts a copy of a VMFS datastore to a VMware cluster from a Pure Storage Block Store protection groupsnapshot. .DESCRIPTION Takes in a snapshot name, the corresponding Pure Storage Block Store, and a cluster. The VMFS copy will be resignatured and mounted. .INPUTS Pure Cloud Block Store connection, a VolumeSnapshot, and a cluster. .OUTPUTS Returns the new datastore. #> [CmdletBinding()] Param( [Parameter(Mandatory=$true,ValueFromPipeline=$True)] $Cluster, [Parameter(ValueFromPipeline=$True)] $FlashArray, [Parameter(Mandatory=$true)] [String]$ProtectionGroupSnapshotName, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup ) $NewDatastore = @() # Verify snapshot exist $ProtectionGroupSnapshot = Get-Pfa2ProtectionGroupSnapshot -Array $FlashArray -Name $ProtectionGroupSnapshotName -ErrorAction Ignore if (-not $ProtectionGroupSnapshot) { throw "Protection group snapshot $ProtectionGroupSnapshotName does not exist." } $VolumeSnapshots = Get-Pfa2VolumeSnapshot -Array $FlashArray -Filter "Name='$($ProtectionGroupSnapshotName).*'" foreach ($VolumeSnapshot in $VolumeSnapshots) { try { $NewDatastore += Restore-PfaVmfsFromVolumeSnapshot -FlashArray $FlashArray -Cluster $Cluster -VolumeSnapshotName $VolumeSnapshot.Name ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup } catch { Write-Error "Failed to restore datastore from protection group $ProtectionGroupSnapshotName using volume snapshot $($VolumeSnapshot.Name)" Write-Error $_.Exception.Message } } if (-not $NewDatastore) { throw "No datastore was restored from protection group snapshot $ProtectionGroupSnapshotName." } return $NewDatastore } function Restore-PfaVmfsFromPod { <# .SYNOPSIS Mounts a copy of a VMFS datastore to a VMware cluster from a Pure Storage Block Store protection groupsnapshot. .DESCRIPTION Takes in a snapshot name, the corresponding Pure Storage Block Store, and a cluster. The VMFS copy will be resignatured and mounted. .INPUTS Pure Cloud Block Store connection, a VolumeSnapshot, and a cluster. .OUTPUTS Returns the new datastore. #> [CmdletBinding()] Param( [Parameter(Mandatory=$true,ValueFromPipeline=$True)] $Cluster, [Parameter(ValueFromPipeline=$True)] $FlashArray, [Parameter(Mandatory=$true)] [String]$PodName, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup ) $NewDatastore = @() # Verify the pod exists $Pod = Get-Pfa2Pod -Array $FlashArray -Name $PodName -ErrorAction Ignore if (-not $Pod) { throw "Pod $PodName does not exist." } $Volumes = Get-Pfa2Volume -Array $FlashArray -Filter "Name='$($PodName)::*'" foreach ($Volume in $Volumes) { try { $NewDatastore += Restore-PfaVmfsFromVolume -FlashArray $FlashArray -Cluster $Cluster -VolumeName $Volume.Name ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup } catch { Write-Error "Failed to restore datastore from pod $PodName using volume $($Volume.Name)" Write-Error $_.Exception.Message } } if (-not $NewDatastore) { throw "No datastore was restored from pod $PodName." } return $NewDatastore } function Restore-PfaVmfsFromVolumeSnapshot { <# .SYNOPSIS Mounts a copy of a VMFS datastore to a VMware cluster from a Pure Storage Block Store snapshot. .DESCRIPTION Takes in a snapshot name, the corresponding Pure Storage Block Store, and a cluster. The VMFS copy will be resignatured and mounted. .INPUTS Pure Cloud Block Store connection, a VolumeSnapshot, and a cluster. .OUTPUTS Returns the new datastore. #> [CmdletBinding()] Param( [Parameter(Mandatory=$true,ValueFromPipeline=$True)] $Cluster, [Parameter(ValueFromPipeline=$True)] $FlashArray, [Parameter(Mandatory=$true)] [String]$VolumeSnapshotName, [Parameter(Mandatory=$false)] [String]$DatastoreName, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup ) $hostGroup = Get-PfaHostGroupfromVcCluster -cluster $cluster -FlashArray $FlashArray # Create volume from the volume snapshot $VolumesForRestore = New-VolumeFromSnaspshot -FlashArray $FlashArray -SnapshotName $VolumeSnapshotName try { $NewDatastore = Restore-PfaVmfsFromVolume -FlashArray $FlashArray -Cluster $Cluster -VolumeName $VolumesForRestore.Name ` -DatastoreName $DatastoreName ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup } catch { # Clean up created volume if restore failed Write-Host "Failed to restore datastore from the volume snapshot $($VolumeSnapshotName)..." Write-Host "Cleaning up the volume $($VolumesForRestore.name) created from $($VolumeSnapshotName)..." Remove-Pfa2Connection -Array $FlashArray -HostgroupNames $hostGroup.name -VolumeNames $VolumesForRestore.name -ErrorAction SilentlyContinue Remove-Pfa2Volume -Array $FlashArray -Name $VolumesForRestore.name -Confirm:$false -ErrorAction SilentlyContinue Remove-Pfa2Volume -Array $FlashArray -Name $VolumesForRestore.name -Eradicate -Confirm:$false -ErrorAction SilentlyContinue throw } return $NewDatastore } function Restore-PfaVmfsFromVolume { <# .SYNOPSIS Mounts a copy of a VMFS datastore to a VMware cluster from a Pure Storage Block Store volume. .DESCRIPTION Takes in a snapshot name, the corresponding Pure Storage Block Store, and a cluster. The VMFS copy will be resignatured and mounted. .INPUTS Pure Cloud Block Store connection, a VolumeSnapshot, and a cluster. .OUTPUTS Returns the new datastore. #> [CmdletBinding()] Param( [Parameter(Mandatory=$true,ValueFromPipeline=$True)] $Cluster, [Parameter(ValueFromPipeline=$True)] $FlashArray, [Parameter(Mandatory=$true)] [String]$VolumeName, [Parameter(Mandatory=$false)] [String]$DatastoreName, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) $Volume = Get-Pfa2Volume -Array $FlashArray -Name $VolumeName -ErrorAction Ignore if (-not $Volume) { throw "Volume $VolumeName does not exist." } $newNAA = "naa.624a9370" + $Volume.serial.toLower() $Datastore = Get-Datastore -ErrorAction stop | Where-Object {$_.ExtensionData.Info.Vmfs.Extent.DiskName -eq $newNAA} if ($Datastore) { throw "Datastore $($Datastore.Name) is using the volume $VolumeName. Please use a different volume. You can manually create a new volume copy from volume $VolumeName and restore the datastore from the new volume." } $hostGroup = Get-PfaHostGroupfromVcCluster -cluster $cluster -FlashArray $FlashArray Write-Progress -Activity "Connecting volume" -Status "25% Complete:" -PercentComplete 25 Write-Host "Connecting volume $($Volume.Name) to host group $($hostGroup.Name)..." $Connection = Get-Pfa2Connection -Array $FlashArray -VolumeName $($Volume.Name) -HostGroupName $hostGroup.name -ErrorAction Ignore if ($Connection) { Write-Host "Volume $($Volume.Name) is already connected to host group $($hostGroup.Name). Using the existing connection..." } else { New-Pfa2Connection -Array $FlashArray -VolumeName $($Volume.Name) -HostGroupName $hostGroup.name | Out-Null } $esxi = $cluster | Get-VMHost| where-object {($_.ConnectionState -eq 'Connected')} | Select-Object -last 1 Write-Progress -Activity "Rescanning storage" -Status "50% Complete:" -PercentComplete 50 Write-Host "Rescanning HBA..." $params = @{ VMHostName = $esxi.Name; } Invoke-RunScript -RunCommandName "Sync-VMHostStorage" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes Write-Progress -Activity "Restoring volume" -Status "75% Complete:" -PercentComplete 75 $params = @{ ClusterName = $Cluster.Name; DeviceNaaId = $newNAA DatastoreName = $DatastoreName } Write-Host "Restoring VMFS Datastore $($DatastoreName) from volume $($Volume.Name)..." Invoke-RunScript -RunCommandName "Restore-VmfsVolume" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes $NewDatastore = Get-Datastore -ErrorAction stop | Where-Object {$_.ExtensionData.Info.Vmfs.Extent.DiskName -eq $newNAA} if (-not $NewDatastore) { throw "Failed to restore datastore from volume $($Volume.Name)." } return $NewDatastore } function New-PfaVolumeByPrefix { Param ( [Parameter(Mandatory=$true)] [string] $Name, [ValidateRange(1GB,64TB)] # 1 GB to 64 TB [Parameter(Mandatory=$false)] [UInt64] $Size, [Parameter(Mandatory=$True)] $Flasharray, [Parameter(Mandatory=$false)] [string] $SourceName, [Parameter(Mandatory=$false)] [string] $PodName, [Parameter(Mandatory=$false)] [switch] $NoDefaultProtection ) # Create a volume with the specified name. If the name already exists in the array, use it as a prefix $maxTries = 20 $count = 0 $existingVolume = $null # Get base volume name from source volume reflected in pure snapshot object # Source volume name possibility: # regular volume snapshot: testvol # pod volume snapshot: testpod::testacvol # array replicated volume snapshot: msconnect-ff-flasharray-1:testvol $BaseName = $Name.split(":")[-1] # Truncate the name if it is too large if ($BaseName.Length -gt 53) { $BaseName = $BaseName.Substring(0,53).TrimEnd("-") } # If a PodName is specified, verify the pod exists if ($PodName) { $pod = Get-Pfa2Pod -Array $FlashArray -Name $PodName -ErrorAction Ignore if (-not $pod) { throw "Pod '$PodName' does not exist." } $BaseName = "$PodName::$BaseName" } $volName = $BaseName $existingVolume = Get-Pfa2Volume -Array $Flasharray -Name $volName -ErrorAction SilentlyContinue while ($existingVolume -and $count -lt $maxTries) { $count = $count + 1 $volName = "$BaseName-$count" $existingVolume = Get-Pfa2Volume -Array $Flasharray -Name $volName -ErrorAction SilentlyContinue } if ($existingVolume) { # We exhausted the max number of tries throw "Could note create a volume based on the Name '$Name', please select a unique volume name" } Write-Host "Creating volume $volName..." $UseDefaultProtection = -not $NoDefaultProtection.IsPresent if ($SourceName) { # Create a volume from a snapshot $vol = New-Pfa2Volume -Array $FlashArray -Name $volName -SourceName $SourceName -WithDefaultProtection $UseDefaultProtection -ErrorAction Stop } else { # Create a fresh volume $vol = New-Pfa2Volume -Array $FlashArray -Name $volName -Provisioned $Size -WithDefaultProtection $UseDefaultProtection -ErrorAction Stop } return $vol } function New-PfaVmfs { <# .SYNOPSIS Create a new VMFS on a new Pure Cloud Block Store volume .DESCRIPTION Creates a new VMFS on Pure Cloud Block Store and presents it to a cluster. .INPUTS FlashArray connection, a vCenter cluster, a volume size, and name. .OUTPUTS Returns a VMFS object. #> [CmdletBinding()] Param( [Parameter(Mandatory=$true)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster, [Parameter(Mandatory=$True)] $Flasharray, [Parameter(Mandatory=$true)] [string]$Name, [Parameter(Mandatory=$true)] $vCenterServer, [ValidateRange(1GB,64TB)] # 1 GB to 64 TB [Parameter(Mandatory=$true)] [UInt64]$Size, [Parameter(Mandatory=$false)] [string] $PodName, [Parameter(Mandatory=$false)] [switch] $NoDefaultProtection, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) Write-Progress -Activity "Creating volume" -Status "25% Complete:" -PercentComplete 25 $datastore = Get-Datastore -Server $vCenterServer -Name $Name -ErrorAction Ignore if ($datastore) { throw "Cannot create the datastore. Datastore '$Name' already exists!" } $hostGroup = Get-PfaHostGroupfromVcCluster -cluster $cluster -FlashArray $FlashArray -ErrorAction Stop $newVol = New-PfaVolumeByPrefix -FlashArray $FlashArray -Name $Name -Size $Size -NoDefaultProtection:$NoDefaultProtection.IsPresent -PodName $PodName -ErrorAction Stop New-Pfa2Connection -Array $FlashArray -HostGroupNames $hostGroup.Name -VolumeNames $newVol.Name | Out-Null Write-Progress -Activity "Rescanning storage" -Status "50% Complete:" -PercentComplete 50 $newNAA = "naa.624a9370" + $newVol.serial.toLower() Write-Host "Rescanning storage..." $params = @{ ClusterName = $Cluster.Name; } Invoke-RunScript -RunCommandName "Sync-ClusterVMHostStorage" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes Write-Debug -Message "NAA for datastore $Name is $newNAA" Write-Progress -Activity "Creating datastore" -Status "75% Complete:" -PercentComplete 75 try { $params = @{ ClusterName = $Cluster.Name; DatastoreName = $Name; DeviceNaaId = $newNAA; Size = $Size } Invoke-RunScript -RunCommandName "New-VmfsDatastore" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } catch { # Cleanup Remove-Pfa2Connection -Array $Flasharray -HostGroupNames $hostGroup.Name -VolumeNames $newVol.Name Remove-Pfa2Volume -Array $Flasharray -Name $newVol.Name -Confirm:$false | Out-Null Remove-Pfa2Volume -Array $Flasharray -Name $newVol.Name -Eradicate -Confirm:$false| Out-Null throw } } function Set-PfaVmfsCapacity { [CmdletBinding()] Param( [Parameter(Mandatory=$true)] $Cluster, [Parameter(Position=0,ValueFromPipeline=$True)] $Flasharray, [Parameter(Position=1,mandatory=$true,ValueFromPipeline=$True)] $Datastore, [Parameter(mandatory=$false)] [UInt64]$SizeInByte, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) Write-Progress -Activity "Resizing volume" -Status "25% Complete:" -PercentComplete 25 $pureVol = Get-PfaVolumeFromVMFSDataStore -Flasharray $FlashArray -Datastore $Datastore $Size = Get-FriendlySize -SizeInByte $SizeInByte $CurrentSize = Get-FriendlySize -SizeInByte $pureVol.Provisioned if ($SizeInByte -lt $pureVol.Provisioned) { throw "The new specified size '$Size' is not larger than the current size '$CurrentSize'. ESXi does not permit VMFS volumes to be shrunk--please specify a size larger than the existing." } elseif ($SizeInByte -eq $pureVol.Provisioned) { # Resize operation might not have been completed in the past, try again # Check if the datastore was already resizes $CapacityDiff = ($SizeInByte - $Datastore.CapacityGB * 1GB) / 1GB if ($CapacityDiff -lt 0) { throw "Cannot resize datastore to lower capacity than $($Datastore.CapacityGB)GB" } if ($CapacityDiff -le 1) { # Difference is negligible. Might be due to VMWare reserved capacity Write-Warning "Datastore '$Datastore.Name' is already set to requested capacity." return } Write-Warning "Volume $($pureVol.Name) is already set at the requested capacity. Refreshing datastore object on AVS.." } else { Write-Host "Increasing the size of the volume $($pureVol.Name) to $Size on Pure Cloud Block Store..." # FlashArray only accept byte that is multiple of 512. If not, we round up by 512 $SizeInByte = [math]::ceiling($SizeInByte/512) * 512 Update-Pfa2Volume -Array $FlashArray -Name $pureVol.Name -Provisioned $SizeInByte | Out-Null } Write-Progress -Activity "Resizing datastore" -Status "50% Complete:" -PercentComplete 50 $params = @{ ClusterName = $Cluster.Name; DeviceNaaId = $Datastore.ExtensionData.Info.Vmfs.Extent.DiskName } Invoke-RunScript -RunCommandName "Resize-VmfsVolume" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } function Get-FriendlySize { [CmdletBinding()] Param( [Parameter(mandatory=$false)] [UInt64]$SizeInByte ) $SizeInGB = $SizeInByte / 1024 / 1024 / 1024 if ($SizeInGB -ge 1024) { $SizeInTB = $SizeInGB/1024 return "$([math]::Round($SizeInTB, 2)) TB" } else { return "$([math]::Round($SizeInGB, 2)) GB" } } # SIG # Begin signature block # MIIXRQYJKoZIhvcNAQcCoIIXNjCCFzICAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCOaUCrvPrPiC4f # gnWB/vWO6N5EJjmj4hR+9Jb30iYoH6CCE2gwggVyMIIDWqADAgECAhB2U/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 # AgEVMC8GCSqGSIb3DQEJBDEiBCB0IGpZlTYFj5Neg9yXxl8xbioP4eWdwklbZDDU # b1RTLjAwBgorBgEEAYI3AgEMMSIwIKACgAChGoAYaHR0cHM6Ly9wdXJlc3RvcmFn # ZS5jb20gMA0GCSqGSIb3DQEBAQUABIICACq/+07zRi4IwWWUKkF+lz7B4/WpAmlM # z/YOhG4Af46CBIjUgxJB97LSweHgAzcMdXzTysp5hHo8Yf1udj3hOjHwxKeRdkqD # INJEzZo0OIpiC8y1f2Nft0rCYnBUyKmFbFkixcNwoZdLejIX3OCiSp9d+YwUoIvc # 65ejDkn6ZGlPcI3biC5U7HJJTS/STWVRRb7QMKzaMdaHr2axkjBv7pZfUl4clLr3 # lI7pqtK7V9xwwbJL5YM19TenKKjByRWpvS4DY6zFrBZp416k7olz12fLMxCOjm/4 # 7G9xzf+es3HhVy+oOvdFRG+7h6+cMDo3BOrfxClawSyEjpHs4YB3zAgiCj0dAwkj # 3BZyQ+JNGLmGZEDS1YXz2PyXrnnhfemCv8jeVsMeTEN130pulRli1ze8t+2ybyfM # MPez24iMYzq2wKGGD2FIhsV4JMIQP34YLt9RhdjNjlZ11j9eLIqsomZC4reWBHA7 # iR+I614D0fJP9bOljiBNOLbafGoEzSeZJhiUU+DJ3LULWie6zypYqOy3xmtjLHZw # gokoWc8mY9OCYptLpzhGZEcFBdufAPAlx3UQE7bSulEz1hYHYlvwdOoLBVozGemE # aHpTsG5pHvA/p9RzP0/lTZwA5EmXjlXoe/WspbB+p9oe9iSu6ypZGWvi14oe6aua # 2BgFtdCyCzsj # SIG # End signature block |