PureStorage.CBS.AVS

1.1.496

PureStorage.CBS.AVS.Configuration.ps1

                                function Set-VmHostiSCSI {

    <#

    .SYNOPSIS

      Configure FlashArray iSCSI target information on ESXi host

    .DESCRIPTION

      Takes in an ESXi host and configures FlashArray iSCSI target info

    #>

    Param(

        [Parameter(Mandatory = $true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster,

        [Parameter(Mandatory = $true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.VMHost]$Esxi,

        [Parameter(Mandatory = $true, ValueFromPipeline = $True)]

        $Flasharray,

        [Parameter(Mandatory = $false)]

        [String]$AVSCloudName,

        [Parameter(Mandatory = $false)]

        [String]$AVSResourceGroup,

        [Parameter(Mandatory = $false)]

        [int]$TimeoutInMinutes = 10,

        [Parameter(Mandatory = $true)]

        $Logger

    )

    if ($esxi.ExtensionData.Runtime.ConnectionState -ne "connected") {

        $Logger.LogWarning("Host $($esxi.NetworkInfo.HostName) is not in a connected state and cannot be configured.")

        return

    }

    $faiSCSItargets = Get-Pfa2NetworkInterface -Array $FlashArray | Where-Object { $_.services -eq "iscsi" } | Where-Object { $_.enabled -eq $true } | Where-Object { $null -ne $_.Eth.address }

    if ($null -eq $faiSCSItargets) {

        throw "The target Pure Cloud Block Store does not currently have any iSCSI targets configured."

    }

    foreach ($target in $faiSCSItargets) {

        $params = @{

            ClusterName   = $Cluster.Name

            ScsiIpAddress = $target.Eth.address

        }

        Invoke-RunScript -RunCommandName  "Set-VmfsIscsi" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params `

            -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger

    }

}

function New-PfaHostFromVmHost {

    <#

    .SYNOPSIS

      Create a FlashArray host from an ESXi vmhost object

    .DESCRIPTION

      Takes in a vCenter ESXi host and creates a FlashArray host

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster,

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.VMHost]$Esxi,

        [Parameter(Mandatory=$true,ValueFromPipeline=$True)]

        $Flasharray,

        [Parameter(Mandatory=$false)]

        [int] $TimeoutInMinutes = 10,

        [Parameter(Mandatory = $true)]

        $Logger

    )

    $ArrayName = Get-ArrayName -FlashArray $FlashArray

    $Logger.LogDebug("Creating Pure Cloud Block Store $ArrayName host for VMHost $($Esxi.Name)...")

    $newFaHost = $null

    try {

        $newFaHost = Get-PfaHostFromVmHost -flasharray $flasharray -esxi $esxi -ErrorAction Stop

    }

    catch {

        # "No matching host" is expected for a brand-new host - but log it so a real failure here is still visible.

        $Logger.LogDebug("Existing-host lookup for ESXi '$($esxi.Name)' returned: $($_.Exception.Message)")

    }

    if ($null -eq $newFaHost) {

        $Logger.LogDebug("Host $($Esxi.Name) not found on Purity array $ArrayName, configuring Purity host...")

        $iscsiadapter = Get-IScsiAdapter -Esxi $esxi

        $iqn = $iscsiadapter.ExtensionData.IScsiName

        $Logger.LogInfo("Creating FlashArray host '$($esxi.NetworkInfo.HostName)' on $ArrayName with IQN '$iqn'...")

        try {

            $newFaHost = New-Pfa2Host -Array $FlashArray -Name ($esxi.NetworkInfo.HostName) -Iqns $iqn -ErrorAction Stop

        }

        catch {

            if ($PSItem.ToString() -like "Host already exists.*") {

                $randName = $esxi.NetworkInfo.HostName + (Get-Random -Maximum 99999 -Minimum 10000).ToString()

                $newFaHost = New-Pfa2Host -Array $FlashArray -Name $($randName) -Iqns $iqn

                $Logger.LogInfo("Host name $($esxi.NetworkInfo.HostName) is in use. Host $($newFaHost.Name) is created for Esxi $($Esxi.Name)")

            } else {

                throw $PSItem.ToString()

            }

        }

        $arrayInfo = Get-Pfa2Array -Array $FlashArray

        $Logger.LogDebug("Array $ArrayName Purity version: $($arrayInfo.Version)")

        $majorVersion = [int](($arrayInfo.Version.Split('.'))[0])

        if ($majorVersion -ge 5) {

            Update-Pfa2Host -Array $FlashArray -Name $($newFaHost.name) -Personality "esxi" | Out-Null

        }

        $Logger.LogInfo("FlashArray host '$($newFaHost.Name)' created for ESXi '$($esxi.Name)'.")

    }

    return $newFaHost

}

function Remove-PfaUnusedHosts {

    Param (

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster,

        [Parameter(Mandatory=$True)]

        $Flasharray,

        [Parameter(Mandatory = $true)]

        $Logger

    )

    $hostGroups =  Get-PfaHostGroupfromVcCluster -flasharray $Flasharray -cluster $cluster -Logger $Logger

    $faHostList = @()

    foreach ($hostGroup in $hostGroups) {

        $faHosts = Get-Pfa2Host -Array $Flasharray | Where-Object{$_.HostGroup.Name -eq $hostGroup.Name} | Where-Object {$_.IsLocal -eq $True}

        $faHostList = $faHostList + $faHosts

    }

    if ($faHostList.Count -eq 0) {

        return

    }

    try {

        $vmHosts = $Cluster | Get-VMHost -ErrorAction Stop

    } catch {

        $clusterName = if ($null -ne $Cluster -and $Cluster.PSObject.Properties["Name"]) {

            $Cluster.Name

        } else {

            "<unknown>"

        }

        throw "Failed to get VMHosts from cluster '$clusterName'. Bailing out. Error: $_"

    }

    foreach ($vmHost in $vmHosts) {

        try {

            $faHost = Get-PfaHostFromVmHost -Flasharray $FlashArray -Esxi $vmHost -ErrorAction Stop

        } catch {

            throw "Failed to determine whether host '$($vmHost.Name)' is in use. Bailing out. Error: $_"

        }

        # Remove used hosts from the list

        $faHostList = $faHostList | Where-Object {$_.Name -ne $faHost.Name}

    }

    foreach ($faHost in $faHostList) {

        $Logger.LogInfo("Removing unused host '$($faHost.Name)' from host group '$($faHost.HostGroup.Name)'...")

        Update-Pfa2Host -Array $Flasharray -Name $faHost.Name -HostGroupName ''

        # Remove might fail if there is volume in the host.

        try {

            Remove-Pfa2Host -Array $Flasharray -Name $faHost.Name

        } catch {

            # Write a non-terminating error here if failed to remove the host

            $Logger.LogError("$_")

        }

    }

}

function New-PfaHostGroupfromVcCluster {

    <#

    .SYNOPSIS

      Create a host group from an ESXi cluster

    .DESCRIPTION

      Takes in a vCenter Cluster and creates hosts (if needed) and host group

    #>

    Param(

        [Parameter(Mandatory=$true)]

        [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster,

        [Parameter(Mandatory=$True)]

        $Flasharray,

        [Parameter(Mandatory=$false)]

        [String]$AVSCloudName,

        [Parameter(Mandatory=$false)]

        [String]$AVSResourceGroup,

        [Parameter(Mandatory=$false)]

        [int] $TimeoutInMinutes = 10,

        [Parameter(Mandatory = $true)]

        $Logger

    )

    $updated_hosts = @()

    # We have to use try catch here as adding -ErrorAction SilentlyContinue still throw terminating error

    try {

        $hostGroup = Get-PfaHostGroupfromVcCluster -flasharray $Flasharray -cluster $cluster -Logger $Logger

    }

    catch {}

    if ($hostGroup.count -gt 1)

    {

        throw "The cluster already is configured on the Pure Cloud Block Store and spans more than one host group. This cmdlet does not support a multi-hostgroup configuration."

    }

    $hostgroupName = $hostGroup.Name

    $esxiHosts = $cluster | Get-VMHost

    $HostMap = @{}

    foreach ($esxiHost in $esxiHosts) {

        # Enable the software iSCSI adapter and configure FlashArray targets on the ESXi host BEFORE

        # creating the Purity host. Creating the Purity host needs the host IQN, which only exists once

        # the software iSCSI adapter is enabled. Fresh Gen2/AV64 hosts have no MPIO/External Storage step

        # that pre-enables iSCSI, so doing this first is what lets them bootstrap.

        $iscsiTargetsUpdated = Set-HostHBAISCSITargets -Esxi $esxiHost -FlashArray $FlashArray -Cluster $Cluster `

            -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger

        # Validate the adapter is actually present after enablement before we rely on the IQN below.

        Test-IScsiAdapter -Esxi $esxiHost

        $faHost = $null

        try {

            $faHost = Get-PfaHostFromVmHost -flasharray $Flasharray -esxi $esxiHost -ErrorAction Ignore

        }

        catch {

            $Logger.LogInfo("$_")

        }

        if ($null -eq $faHost) {

            try {

                $faHost = New-PfaHostFromVmHost -Cluster $Cluster -flasharray $Flasharray -esxi $esxiHost `

                    -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger -ErrorAction Stop

                $HostMap[$faHost.Name] = $esxiHost

                $updated_hosts += $esxiHost.Name

            }

            catch {

                $Logger.LogError("Failed to create FlashArray host for ESXi '$($esxiHost.Name)': $($_.Exception.Message)")

                $Logger.LogDebug("Stack trace: $($_.ScriptStackTrace)")

                throw "Could not create host. Cannot create host group."

            }

        }

        if ($null -ne $faHost.HostGroup.Name -and $faHost.HostGroup.Name -eq $hostgroupName) {

            $Logger.LogWarning("The host $($faHost.name) is already in the host group $($faHost.hgroup).")

        }

        if ($iscsiTargetsUpdated -and $updated_hosts -notcontains $esxiHost.Name) {

            $updated_hosts += $esxiHost.Name

        }

        $HostMap[$faHost.name] = $esxiHost.Name

    }

    #FlashArray only supports Alphanumeric or the dash - character in host group names. Checking for VMware cluster name compliance and removing invalid characters.

    if ($null -eq $hostGroup)

    {

        if ($cluster.Name -match "^[a-zA-Z0-9\-]+$" -and $AVSCloudName -match "^[a-zA-Z0-9\-]+$")

        {

            $hostgroupName = "$($AVSCloudName)-$($cluster.Name)"

        }

        else

        {

            $hostgroupName = "$($AVSCloudName)-$($cluster.Name)"

            $hostgroupName = $hostgroupName -replace "[^\w\-]", ""

            $hostgroupName = $hostgroupName -replace "[_]", ""

            $hostgroupName = $hostgroupName -replace " ", ""

        }

        $hg = $null

        $hg =  Get-Pfa2HostGroup -Array $Flasharray -Name $hostgroupName -ErrorAction SilentlyContinue | Where-Object {$_.IsLocal -eq $True}

        if ($null -ne $hg)

        {

            if ($hg.hosts.count -ne 0)

            {

                #if host group name is already in use and has only unexpected hosts i will create a new one with a random number at the end

                $nameRandom = Get-random -Minimum 1000 -Maximum 9999

                $hostgroupName = "$($hostgroupName)-$($nameRandom)"

                $hostGroup = New-Pfa2HostGroup -Array $Flasharray -Name $hostgroupName  -ErrorAction stop

            }

            else {

                $hostGroup = $hg

            }

        }

        else {

                #if there is no host group, it will be created

                $hostGroup = New-Pfa2HostGroup -Array $Flasharray -Name $hostgroupName  -ErrorAction stop

        }

    }

    $faHostNames = @()

    foreach ($faHostName in $HostMap.Keys)

    {

        $faHost = Get-Pfa2Host -Array $Flasharray -Name $faHostName | Where-Object {$_.IsLocal -eq $True}

        if ($null -eq $faHost.HostGroup.Name)

        {

            $faHostNames += $faHostName

        }

    }

    #any hosts that are not already in the host group will be added

    if ($faHostNames.count -gt 0)

    {

        foreach ($faHostName in $faHostNames)

        {

            $Logger.LogInfo("Adding $faHostName to $hostgroupName...")

            Update-Pfa2Host -Array $Flasharray -Name $faHostName -HostGroupName $hostgroupName | Out-Null

            if (-not $updated_hosts -contains $HostMap[$faHostName]) {

                $updated_hosts += $HostMap[$faHostName]

            }

        }

    }

    return $updated_hosts

}

# SIG # Begin signature block

# MIIpRAYJKoZIhvcNAQcCoIIpNTCCKTECAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDytBztMT5Qxm4R

# IqiGR9KPX0L3bV05FypofSjhebTzjKCCDfIwggbmMIIEzqADAgECAhB3vQ4DobcI

# +FSrBnIQ2QRHMA0GCSqGSIb3DQEBCwUAMFMxCzAJBgNVBAYTAkJFMRkwFwYDVQQK

# ExBHbG9iYWxTaWduIG52LXNhMSkwJwYDVQQDEyBHbG9iYWxTaWduIENvZGUgU2ln

# bmluZyBSb290IFI0NTAeFw0yMDA3MjgwMDAwMDBaFw0zMDA3MjgwMDAwMDBaMFkx

# CzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMS8wLQYDVQQD

# EyZHbG9iYWxTaWduIEdDQyBSNDUgQ29kZVNpZ25pbmcgQ0EgMjAyMDCCAiIwDQYJ

# KoZIhvcNAQEBBQADggIPADCCAgoCggIBANZCTfnjT8Yj9GwdgaYw90g9z9DljeUg

# IpYHRDVdBs8PHXBg5iZU+lMjYAKoXwIC947Jbj2peAW9jvVPGSSZfM8RFpsfe2vS

# o3toZXer2LEsP9NyBjJcW6xQZywlTVYGNvzBYkx9fYYWlZpdVLpQ0LB/okQZ6dZu

# bD4Twp8R1F80W1FoMWMK+FvQ3rpZXzGviWg4QD4I6FNnTmO2IY7v3Y2FQVWeHLw3

# 3JWgxHGnHxulSW4KIFl+iaNYFZcAJWnf3sJqUGVOU/troZ8YHooOX1ReveBbz/IM

# BNLeCKEQJvey83ouwo6WwT/Opdr0WSiMN2WhMZYLjqR2dxVJhGaCJedDCndSsZlR

# Qv+hst2c0twY2cGGqUAdQZdihryo/6LHYxcG/WZ6NpQBIIl4H5D0e6lSTmpPVAYq

# gK+ex1BC+mUK4wH0sW6sDqjjgRmoOMieAyiGpHSnR5V+cloqexVqHMRp5rC+QBmZ

# y9J9VU4inBDgoVvDsy56i8Te8UsfjCh5MEV/bBO2PSz/LUqKKuwoDy3K1JyYikpt

# WjYsL9+6y+JBSgh3GIitNWGUEvOkcuvuNp6nUSeRPPeiGsz8h+WX4VGHaekizIPA

# tw9FbAfhQ0/UjErOz2OxtaQQevkNDCiwazT+IWgnb+z4+iaEW3VCzYkmeVmda6tj

# cWKQJQ0IIPH/AgMBAAGjggGuMIIBqjAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAww

# CgYIKwYBBQUHAwMwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQU2rONwCSQ

# o2t30wygWd0hZ2R2C3gwHwYDVR0jBBgwFoAUHwC/RoAK/Hg5t6W0Q9lWULvOljsw

# gZMGCCsGAQUFBwEBBIGGMIGDMDkGCCsGAQUFBzABhi1odHRwOi8vb2NzcC5nbG9i

# YWxzaWduLmNvbS9jb2Rlc2lnbmluZ3Jvb3RyNDUwRgYIKwYBBQUHMAKGOmh0dHA6

# Ly9zZWN1cmUuZ2xvYmFsc2lnbi5jb20vY2FjZXJ0L2NvZGVzaWduaW5ncm9vdHI0

# NS5jcnQwQQYDVR0fBDowODA2oDSgMoYwaHR0cDovL2NybC5nbG9iYWxzaWduLmNv

# bS9jb2Rlc2lnbmluZ3Jvb3RyNDUuY3JsMFYGA1UdIARPME0wQQYJKwYBBAGgMgEy

# MDQwMgYIKwYBBQUHAgEWJmh0dHBzOi8vd3d3Lmdsb2JhbHNpZ24uY29tL3JlcG9z

# aXRvcnkvMAgGBmeBDAEEATANBgkqhkiG9w0BAQsFAAOCAgEACIhyJsav+qxfBsCq

# jJDa0LLAopf/bhMyFlT9PvQwEZ+PmPmbUt3yohbu2XiVppp8YbgEtfjry/RhETP2

# ZSW3EUKL2Glux/+VtIFDqX6uv4LWTcwRo4NxahBeGQWn52x/VvSoXMNOCa1Za7j5

# fqUuuPzeDsKg+7AE1BMbxyepuaotMTvPRkyd60zsvC6c8YejfzhpX0FAZ/ZTfepB

# 7449+6nUEThG3zzr9s0ivRPN8OHm5TOgvjzkeNUbzCDyMHOwIhz2hNabXAAC4ShS

# S/8SS0Dq7rAaBgaehObn8NuERvtz2StCtslXNMcWwKbrIbmqDvf+28rrvBfLuGfr

# 4z5P26mUhmRVyQkKwNkEcUoRS1pkw7x4eK1MRyZlB5nVzTZgoTNTs/Z7KtWJQDxx

# pav4mVn945uSS90FvQsMeAYrz1PYvRKaWyeGhT+RvuB4gHNU36cdZytqtq5NiYAk

# CFJwUPMB/0SuL5rg4UkI4eFb1zjRngqKnZQnm8qjudviNmrjb7lYYuA2eDYB+sGn

# iXomU6Ncu9Ky64rLYwgv/h7zViniNZvY/+mlvW1LWSyJLC9Su7UpkNpDR7xy3bzZ

# v4DB3LCrtEsdWDY3ZOub4YUXmimi/eYI0pL/oPh84emn0TCOXyZQK8ei4pd3iu/Y

# TT4m65lAYPM8Zwy2CHIpNVOBNNwwggcEMIIE7KADAgECAgxcuW61kTkv+4t8zgQw

# DQYJKoZIhvcNAQELBQAwWTELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNp

# Z24gbnYtc2ExLzAtBgNVBAMTJkdsb2JhbFNpZ24gR0NDIFI0NSBDb2RlU2lnbmlu

# ZyBDQSAyMDIwMB4XDTI0MDMxMTE0MDQxMloXDTI3MDMxMjE0MDQxMlowcjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFDASBgNVBAcTC1NhbnRhIENs

# YXJhMRswGQYDVQQKExJQdXJlIFN0b3JhZ2UsIEluYy4xGzAZBgNVBAMTElB1cmUg

# U3RvcmFnZSwgSW5jLjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMCQ

# rioSn48IvHpTg5dofsUYj/pNTDidwjYUrcxVu78NoyhSweG8FhcxDi/SI40+8Fcc

# l3D5ZoqpjkFnGhzSwmpxU3J4AP7+fdTZht9eWD1I5qKY07esYwdPDV4yg+csPfdG

# PqI2XjRfT5UC3YkXQeUrX8KQZldD4KqvgxzpYcuBwsgHbTb/eArpi68YgFR2jgZG

# yZigfy8RuJMrL1thcBOe/VWjUyK21wVT8cuunBYFaStLHhsRBRMDcZBDuTSGC4ev

# E6oaCqlQbdMl9YFJ64mDQsKlCxrr7rmLVtcVzKGwmjp4b2xRwE+RmTh6JtrUL9Wx

# /3a3UzgAnDNimfwp85zoL48kyLtHqQ3FI8tVKGm+aBOgBZfmURoy7fbp4zKhGgqF

# bpOmILO16i4f999YsEEJQgIF3CtyH1R60/ZZWlDmoeeEgjAGrnd14muU5Hk3Cksr

# 43uPUAg+fV78Y0fDV85ibm42ZwwPuz6MI4HhYNUlGzRwIQ31vjaGuAMWHNqFKkcO

# 0JuIeHQ/gFKPnYIxnGC9H9R4Kw/uMezqtnYJwGU2epB/ABl/w7U4NgU2ZOxWB5BF

# y4frZ3f+hNgbjFUjMaXnVFotOJxXntzjdSl4znw8DaKiC5ooChteZMITG9p078p/

# TUsOJQbUtFADSY1hsfCfB7t+gJSNt5peS9GOZIMVAgMBAAGjggGxMIIBrTAOBgNV

# HQ8BAf8EBAMCB4AwgZsGCCsGAQUFBwEBBIGOMIGLMEoGCCsGAQUFBzAChj5odHRw

# Oi8vc2VjdXJlLmdsb2JhbHNpZ24uY29tL2NhY2VydC9nc2djY3I0NWNvZGVzaWdu

# Y2EyMDIwLmNydDA9BggrBgEFBQcwAYYxaHR0cDovL29jc3AuZ2xvYmFsc2lnbi5j

# b20vZ3NnY2NyNDVjb2Rlc2lnbmNhMjAyMDBWBgNVHSAETzBNMEEGCSsGAQQBoDIB

# MjA0MDIGCCsGAQUFBwIBFiZodHRwczovL3d3dy5nbG9iYWxzaWduLmNvbS9yZXBv

# c2l0b3J5LzAIBgZngQwBBAEwCQYDVR0TBAIwADBFBgNVHR8EPjA8MDqgOKA2hjRo

# dHRwOi8vY3JsLmdsb2JhbHNpZ24uY29tL2dzZ2NjcjQ1Y29kZXNpZ25jYTIwMjAu

# Y3JsMBMGA1UdJQQMMAoGCCsGAQUFBwMDMB8GA1UdIwQYMBaAFNqzjcAkkKNrd9MM

# oFndIWdkdgt4MB0GA1UdDgQWBBSzJ9KiDCa3UBiAajy+Iioj5kQjzDANBgkqhkiG

# 9w0BAQsFAAOCAgEAHsFQixeQEcoHurq9NWSUt4S39Q+UGP6crmVq3Wwy9g23YbdW

# g+SgMxoLUqdoDfA4k4B6Dyoo0jEQzn2kxnsnT9lNHKrcZHH88dv0hjfiH2qAiQWa

# zPjS3LhK2J6nhpyipJPpyRaSQG4x4aG0NB2D4WUfUz9CGAYsERJGww/wkTaaxMip

# ttKDTaI1C49u1igDfRzIO+Q8vuyyBFLiYTno/df97xtjNC+KxxFhDhl/4tawK6kw

# xaVzCMAfj48I67Wbo4DMH6pM1s19as7c3qp92i3MylGKsB6+u+o7UkbSdLNkS4AL

# I33CJOUc+GoK3Nt5IXXCFJTQFHBXkBdAur3gmlXEm8vlNG/1Sbxr0H7T1e7ABGH/

# 48o/+PeMLuCc72EeK5dJ4cX9NEQ3QnTsZHwGnYzjEOvOvP0s1c7yNsDbcUHoIqQv

# b5xS5aqMU5G+8sdPQ1nwpPf7gGaEEbAVW4w51Pam42qeN9HIPa+ZinXnsN02Kk1Q

# w0QwUqzaQy9W/gIquI0KOjw0LmoW9M/8S0lrjpEq2eEeUw9WQLhhUEIirFxGPtjq

# iCLiiS9CZ+kf2vWLJKUspkYv+OHT3q805Zg1dJsBFAzEYUFLb1mhmigDEO9bsMor

# jECIL2ijE5zHtbGkalrrsPWu8tiDT/B7P9GSYzKfOOy4PoOIfWSK0IxlS7Ixghqo

# MIIapAIBATBpMFkxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52

# LXNhMS8wLQYDVQQDEyZHbG9iYWxTaWduIEdDQyBSNDUgQ29kZVNpZ25pbmcgQ0Eg

# MjAyMAIMXLlutZE5L/uLfM4EMA0GCWCGSAFlAwQCAQUAoIGXMBkGCSqGSIb3DQEJ

# AzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMCsG

# CisGAQQBgjcCAQwxHTAboRmAF2h0dHBzOi8vcHVyZXN0b3JhZ2UuY29tMC8GCSqG

# SIb3DQEJBDEiBCCxS3FZFno9/lQWBy6dkHmpqBWqCK55L5m79TNZryWSOjANBgkq

# hkiG9w0BAQEFAASCAgA+SCHQL7n+ZIxGi51DuOHt6B/G7EOyUxcO9ef5h3LJZooJ

# pLf0p4MKN8Jwlp/WS8TmzJSpLUMG/grOAUqZY3ht2Gd5cfVXhF7NLN8t5RSiTjlO

# 6DswI/vBHs/ldmFMoQiG6tpiJU8/MiDeuU8MtVx3OdvBMArUokgzqkLgKtg+JZds

# T62Yoe5yEqGJIIOnHgPCYjOY1/KXrkBtCbcb1Y87nVMpDEZM1ddHFWa9mijqpomj

# yzjm6u24WyVkpGpnP7FvxpRodO6WsyJ0T5rzVvH8JywcxdIY2VU89391NlG2sWUa

# 2u6tdkceHLfWRk+IRaq+i0UjIQxFpRHRdimzVUREe/1H/FSy4ODzgaN+kqdBHbry

# U0OEJAXIvdqF22GkXIhCQbxCKwe4d19WPZLvcOTxpfxpGqF72bSLl8Gt2x6eDdtk

# G7prNW/oYiLXDVYCwh/S8NV82FuQF7qxs3iE9iowZi+2s8Zm4v4ThFw7YXFj3r3m

# 36urI4gSjfoWCANIhpVLHxtzK5q5I8y0gcZnDC8fDs32wGa9uKkoM6ABhgIEU8eR

# vvNA70+R/iGCSzV0397/RmzldVvezVy3fwQ2olQnKD7Yb0cYHQBDQ1I5Az9NjnRu

# lwWvxMddY67LvRcszRJRaSjt6XzqrB7mU3QwACetFL+fV+BIgXqGrTPrS6FHgqGC

# F3YwghdyBgorBgEEAYI3AwMBMYIXYjCCF14GCSqGSIb3DQEHAqCCF08wghdLAgED

# MQ8wDQYJYIZIAWUDBAIBBQAwdwYLKoZIhvcNAQkQAQSgaARmMGQCAQEGCWCGSAGG

# /WwHATAxMA0GCWCGSAFlAwQCAQUABCA3gZSETkyrPmA9xK07ADQUHdYmh1ZcIb1Y

# pv7DSOFn0gIQBVYGKSAQdwA+0ReSv1VLlhgPMjAyNjA2MTcxMTQxNTZaoIITOjCC

# Bu0wggTVoAMCAQICEAqA7xhLjfEFgtHEdqeVdGgwDQYJKoZIhvcNAQELBQAwaTEL

# MAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhE

# aWdpQ2VydCBUcnVzdGVkIEc0IFRpbWVTdGFtcGluZyBSU0E0MDk2IFNIQTI1NiAy

# MDI1IENBMTAeFw0yNTA2MDQwMDAwMDBaFw0zNjA5MDMyMzU5NTlaMGMxCzAJBgNV

# BAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjE7MDkGA1UEAxMyRGlnaUNl

# cnQgU0hBMjU2IFJTQTQwOTYgVGltZXN0YW1wIFJlc3BvbmRlciAyMDI1IDEwggIi

# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDQRqwtEsae0OquYFazK1e6b1H/

# hnAKAd/KN8wZQjBjMqiZ3xTWcfsLwOvRxUwXcGx8AUjni6bz52fGTfr6PHRNv6T7

# zsf1Y/E3IU8kgNkeECqVQ+3bzWYesFtkepErvUSbf+EIYLkrLKd6qJnuzK8Vcn0D

# vbDMemQFoxQ2Dsw4vEjoT1FpS54dNApZfKY61HAldytxNM89PZXUP/5wWWURK+If

# xiOg8W9lKMqzdIo7VA1R0V3Zp3DjjANwqAf4lEkTlCDQ0/fKJLKLkzGBTpx6EYev

# vOi7XOc4zyh1uSqgr6UnbksIcFJqLbkIXIPbcNmA98Oskkkrvt6lPAw/p4oDSRZr

# eiwB7x9ykrjS6GS3NR39iTTFS+ENTqW8m6THuOmHHjQNC3zbJ6nJ6SXiLSvw4Smz

# 8U07hqF+8CTXaETkVWz0dVVZw7knh1WZXOLHgDvundrAtuvz0D3T+dYaNcwafsVC

# GZKUhQPL1naFKBy1p6llN3QgshRta6Eq4B40h5avMcpi54wm0i2ePZD5pPIssosz

# QyF4//3DoK2O65Uck5Wggn8O2klETsJ7u8xEehGifgJYi+6I03UuT1j7FnrqVrOz

# aQoVJOeeStPeldYRNMmSF3voIgMFtNGh86w3ISHNm0IaadCKCkUe2LnwJKa8TIlw

# CUNVwppwn4D3/Pt5pwIDAQABo4IBlTCCAZEwDAYDVR0TAQH/BAIwADAdBgNVHQ4E

# FgQU5Dv88jHt/f3X85FxYxlQQ89hjOgwHwYDVR0jBBgwFoAU729TSunkBnx6yuKQ

# VvYv1Ensy04wDgYDVR0PAQH/BAQDAgeAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMI

# MIGVBggrBgEFBQcBAQSBiDCBhTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGln

# aWNlcnQuY29tMF0GCCsGAQUFBzAChlFodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5j

# b20vRGlnaUNlcnRUcnVzdGVkRzRUaW1lU3RhbXBpbmdSU0E0MDk2U0hBMjU2MjAy

# NUNBMS5jcnQwXwYDVR0fBFgwVjBUoFKgUIZOaHR0cDovL2NybDMuZGlnaWNlcnQu

# Y29tL0RpZ2lDZXJ0VHJ1c3RlZEc0VGltZVN0YW1waW5nUlNBNDA5NlNIQTI1NjIw

# MjVDQTEuY3JsMCAGA1UdIAQZMBcwCAYGZ4EMAQQCMAsGCWCGSAGG/WwHATANBgkq

# hkiG9w0BAQsFAAOCAgEAZSqt8RwnBLmuYEHs0QhEnmNAciH45PYiT9s1i6UKtW+F

# ERp8FgXRGQ/YAavXzWjZhY+hIfP2JkQ38U+wtJPBVBajYfrbIYG+Dui4I4PCvHpQ

# uPqFgqp1PzC/ZRX4pvP/ciZmUnthfAEP1HShTrY+2DE5qjzvZs7JIIgt0GCFD9kt

# x0LxxtRQ7vllKluHWiKk6FxRPyUPxAAYH2Vy1lNM4kzekd8oEARzFAWgeW3az2xe

# jEWLNN4eKGxDJ8WDl/FQUSntbjZ80FU3i54tpx5F/0Kr15zW/mJAxZMVBrTE2oi0

# fcI8VMbtoRAmaaslNXdCG1+lqvP4FbrQ6IwSBXkZagHLhFU9HCrG/syTRLLhAezu

# /3Lr00GrJzPQFnCEH1Y58678IgmfORBPC1JKkYaEt2OdDh4GmO0/5cHelAK2/gTl

# QJINqDr6JfwyYHXSd+V08X1JUPvB4ILfJdmL+66Gp3CSBXG6IwXMZUXBhtCyIaeh

# r0XkBoDIGMUG1dUtwq1qmcwbdUfcSYCn+OwncVUXf53VJUNOaMWMts0VlRYxe5nK

# +At+DI96HAlXHAL5SlfYxJ7La54i71McVWRP66bW+yERNpbJCjyCYG2j+bdpxo/1

# Cy4uPcU3AWVPGrbn5PhDBf3Froguzzhk++ami+r3Qrx5bIbY3TVzgiFI7Gq3zWcw

# gga0MIIEnKADAgECAhANx6xXBf8hmS5AQyIMOkmGMA0GCSqGSIb3DQEBCwUAMGIx

# CzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3

# dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRydXN0ZWQgUm9vdCBH

# NDAeFw0yNTA1MDcwMDAwMDBaFw0zODAxMTQyMzU5NTlaMGkxCzAJBgNVBAYTAlVT

# MRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4RGlnaUNlcnQgVHJ1

# c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYgMjAyNSBDQTEwggIi

# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC0eDHTCphBcr48RsAcrHXbo0Zo

# dLRRF51NrY0NlLWZloMsVO1DahGPNRcybEKq+RuwOnPhof6pvF4uGjwjqNjfEvUi

# 6wuim5bap+0lgloM2zX4kftn5B1IpYzTqpyFQ/4Bt0mAxAHeHYNnQxqXmRinvuNg

# xVBdJkf77S2uPoCj7GH8BLuxBG5AvftBdsOECS1UkxBvMgEdgkFiDNYiOTx4OtiF

# cMSkqTtF2hfQz3zQSku2Ws3IfDReb6e3mmdglTcaarps0wjUjsZvkgFkriK9tUKJ

# m/s80FiocSk1VYLZlDwFt+cVFBURJg6zMUjZa/zbCclF83bRVFLeGkuAhHiGPMvS

# GmhgaTzVyhYn4p0+8y9oHRaQT/aofEnS5xLrfxnGpTXiUOeSLsJygoLPp66bkDX1

# ZlAeSpQl92QOMeRxykvq6gbylsXQskBBBnGy3tW/AMOMCZIVNSaz7BX8VtYGqLt9

# MmeOreGPRdtBx3yGOP+rx3rKWDEJlIqLXvJWnY0v5ydPpOjL6s36czwzsucuoKs7

# Yk/ehb//Wx+5kMqIMRvUBDx6z1ev+7psNOdgJMoiwOrUG2ZdSoQbU2rMkpLiQ6bG

# RinZbI4OLu9BMIFm1UUl9VnePs6BaaeEWvjJSjNm2qA+sdFUeEY0qVjPKOWug/G6

# X5uAiynM7Bu2ayBjUwIDAQABo4IBXTCCAVkwEgYDVR0TAQH/BAgwBgEB/wIBADAd

# BgNVHQ4EFgQU729TSunkBnx6yuKQVvYv1Ensy04wHwYDVR0jBBgwFoAU7NfjgtJx

# XWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1UdJQQMMAoGCCsGAQUF

# BwMIMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGln

# aWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5j

# b20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8EPDA6MDigNqA0hjJo

# dHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNy

# bDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEwDQYJKoZIhvcNAQEL

# BQADggIBABfO+xaAHP4HPRF2cTC9vgvItTSmf83Qh8WIGjB/T8ObXAZz8OjuhUxj

# aaFdleMM0lBryPTQM2qEJPe36zwbSI/mS83afsl3YTj+IQhQE7jU/kXjjytJgnn0

# hvrV6hqWGd3rLAUt6vJy9lMDPjTLxLgXf9r5nWMQwr8Myb9rEVKChHyfpzee5kH0

# F8HABBgr0UdqirZ7bowe9Vj2AIMD8liyrukZ2iA/wdG2th9y1IsA0QF8dTXqvcnT

# mpfeQh35k5zOCPmSNq1UH410ANVko43+Cdmu4y81hjajV/gxdEkMx1NKU4uHQcKf

# ZxAvBAKqMVuqte69M9J6A47OvgRaPs+2ykgcGV00TYr2Lr3ty9qIijanrUR3anzE

# wlvzZiiyfTPjLbnFRsjsYg39OlV8cipDoq7+qNNjqFzeGxcytL5TTLL4ZaoBdqbh

# OhZ3ZRDUphPvSRmMThi0vw9vODRzW6AxnJll38F0cuJG7uEBYTptMSbhdhGQDpOX

# gpIUsWTjd6xpR6oaQf/DJbg3s6KCLPAlZ66RzIg9sC+NJpud/v4+7RWsWCiKi9EO

# LLHfMR2ZyJ/+xhCx9yHbxtl5TPau1j/1MIDpMPx0LckTetiSuEtQvLsNz3Qbp7wG

# WqbIiOWCnb5WqxL3/BAPvIXKUjPSxyZsq8WhbaM2tszWkPZPubdcMIIFjTCCBHWg

# AwIBAgIQDpsYjvnQLefv21DiCEAYWjANBgkqhkiG9w0BAQwFADBlMQswCQYDVQQG

# EwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNl

# cnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBBc3N1cmVkIElEIFJvb3QgQ0EwHhcN

# MjIwODAxMDAwMDAwWhcNMzExMTA5MjM1OTU5WjBiMQswCQYDVQQGEwJVUzEVMBMG

# A1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSEw

# HwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQC/5pBzaN675F1KPDAiMGkz7MKnJS7JIT3yithZwuEp

# pz1Yq3aaza57G4QNxDAf8xukOBbrVsaXbR2rsnnyyhHS5F/WBTxSD1Ifxp4VpX6+

# n6lXFllVcq9ok3DCsrp1mWpzMpTREEQQLt+C8weE5nQ7bXHiLQwb7iDVySAdYykt

# zuxeTsiT+CFhmzTrBcZe7FsavOvJz82sNEBfsXpm7nfISKhmV1efVFiODCu3T6cw

# 2Vbuyntd463JT17lNecxy9qTXtyOj4DatpGYQJB5w3jHtrHEtWoYOAMQjdjUN6Qu

# BX2I9YI+EJFwq1WCQTLX2wRzKm6RAXwhTNS8rhsDdV14Ztk6MUSaM0C/CNdaSaTC

# 5qmgZ92kJ7yhTzm1EVgX9yRcRo9k98FpiHaYdj1ZXUJ2h4mXaXpI8OCiEhtmmnTK

# 3kse5w5jrubU75KSOp493ADkRSWJtppEGSt+wJS00mFt6zPZxd9LBADMfRyVw4/3

# IbKyEbe7f/LVjHAsQWCqsWMYRJUadmJ+9oCw++hkpjPRiQfhvbfmQ6QYuKZ3AeEP

# lAwhHbJUKSWJbOUOUlFHdL4mrLZBdd56rF+NP8m800ERElvlEFDrMcXKchYiCd98

# THU/Y+whX8QgUWtvsauGi0/C1kVfnSD8oR7FwI+isX4KJpn15GkvmB0t9dmpsh3l

# GwIDAQABo4IBOjCCATYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU7NfjgtJx

# XWRM3y5nP+e6mK4cD08wHwYDVR0jBBgwFoAUReuir/SSy4IxLVGLp6chnfNtyA8w

# DgYDVR0PAQH/BAQDAgGGMHkGCCsGAQUFBwEBBG0wazAkBggrBgEFBQcwAYYYaHR0

# cDovL29jc3AuZGlnaWNlcnQuY29tMEMGCCsGAQUFBzAChjdodHRwOi8vY2FjZXJ0

# cy5kaWdpY2VydC5jb20vRGlnaUNlcnRBc3N1cmVkSURSb290Q0EuY3J0MEUGA1Ud

# HwQ+MDwwOqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFz

# c3VyZWRJRFJvb3RDQS5jcmwwEQYDVR0gBAowCDAGBgRVHSAAMA0GCSqGSIb3DQEB

# DAUAA4IBAQBwoL9DXFXnOF+go3QbPbYW1/e/Vwe9mqyhhyzshV6pGrsi+IcaaVQi

# 7aSId229GhT0E0p6Ly23OO/0/4C5+KH38nLeJLxSA8hO0Cre+i1Wz/n096wwepqL

# sl7Uz9FDRJtDIeuWcqFItJnLnU+nBgMTdydE1Od/6Fmo8L8vC6bp8jQ87PcDx4eo

# 0kxAGTVGamlUsLihVo7spNU96LHc/RzY9HdaXFSMb++hUD38dglohJ9vytsgjTVg

# HAIDyyCwrFigDkBjxZgiwbJZ9VVrzyerbHbObyMt9H5xaiNrIv8SuFQtJ37YOtnw

# toeW/VvRXKwYw02fc7cBqZ9Xql4o4rmUMYIDfDCCA3gCAQEwfTBpMQswCQYDVQQG

# EwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0

# IFRydXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUgQ0Ex

# AhAKgO8YS43xBYLRxHanlXRoMA0GCWCGSAFlAwQCAQUAoIHRMBoGCSqGSIb3DQEJ

# AzENBgsqhkiG9w0BCRABBDAcBgkqhkiG9w0BCQUxDxcNMjYwNjE3MTE0MTU2WjAr

# BgsqhkiG9w0BCRACDDEcMBowGDAWBBTdYjCshgotMGvaOLFoeVIwB/tBfjAvBgkq

# hkiG9w0BCQQxIgQg+Gf8YHGszx8PXc3IyFsde+6tZWwQhTzRMss90c10FlYwNwYL

# KoZIhvcNAQkQAi8xKDAmMCQwIgQgSqA/oizXXITFXJOPgo5na5yuyrM/420mmqM0

# 8UYRCjMwDQYJKoZIhvcNAQEBBQAEggIAdg/WLn/hHZF/JDw5FqDmtk6wU4RtmZ2H

# XlpbOEow2UbUtaqQgg06smrbWhxY7XIRNpfxr7+PCpQsnp/1JyayVI4fc+LCPtzI

# jb3TkObYMM+Y/tt7mTMoGXK+knG4I2MB7G3leb++vj22EzKnrUF9U1Wf+JQQmaNd

# amh+40zY3jPh9wsnKOZE9juyxFKGVKXAHot/ybe8b+mhnlqnZVu5F6JQ8zeyVi/A

# VLV57FfeZWswW85tivsX7OxRMxe8L/eTZUB6T/YLJowKB7owgxhhhbx1XMBRl7Xg

# XHCWq1VCa3NEVjvk0WDNZJoqFMANQqH+9HXl3w0y+I03nOn6xulrNhI1idLbrt2i

# rk+B57A+gySfJnJ/saPbTacD2BUsriSKwRRDCUfmNWhCSn7UpBsq3oC35uFed0Yb

# g40a1rx4nJUnID5+rtRnWWZgNqi4QRGJT+zVOfG/g0DQrVw0hwrNdRBVID4INjVt

# VbHwMgjLunTYBeqUGwc091SUFEQ/hC5LIbOVuHHdif1tq3ZFmkDfGP49HIPEfmcq

# ekfLgQQ7Psor5c0o84bowFeAqwNwjP8S5NTRUJsfE3CXYaBptc7ijIA463yC00RW

# Ghx/xL/FcplEPEH+elEcXZNMFyOATJRvXquEAunb0rDvJDxVLuIiSYUVN+2xNDXW

# +4VEg4Xolqo=

# SIG # End signature block