PureStorage.CBS.AVS

1.1.497

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 (-not (Test-VmHostConnected -Esxi $esxi -Logger $Logger)) {

        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

        $faHostName = Get-VmHostName -Esxi $esxi

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

        try {

            $newFaHost = New-Pfa2Host -Array $FlashArray -Name $faHostName -Iqns $iqn -ErrorAction Stop

        }

        catch {

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

                $randName = $faHostName + (Get-Random -Maximum 99999 -Minimum 10000).ToString()

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

                $Logger.LogInfo("Host name $faHostName 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

# MIIpRQYJKoZIhvcNAQcCoIIpNjCCKTICAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCD8YcxGjn3/JBrY

# +rkungRzDw7QwFInhb5070uOxBX/2qCCDfIwggbmMIIEzqADAgECAhB3vQ4DobcI

# +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/B7P9GSYzKfOOy4PoOIfWSK0IxlS7Ixghqp

# MIIapQIBATBpMFkxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52

# LXNhMS8wLQYDVQQDEyZHbG9iYWxTaWduIEdDQyBSNDUgQ29kZVNpZ25pbmcgQ0Eg

# MjAyMAIMXLlutZE5L/uLfM4EMA0GCWCGSAFlAwQCAQUAoIGXMBkGCSqGSIb3DQEJ

# AzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMCsG

# CisGAQQBgjcCAQwxHTAboRmAF2h0dHBzOi8vcHVyZXN0b3JhZ2UuY29tMC8GCSqG

# SIb3DQEJBDEiBCC+K4rheThV5PV6BbG6kWzVrBsxdXRWFcir4eb3EFnjOTANBgkq

# hkiG9w0BAQEFAASCAgAcpTnUg3XcEMCdWFJ2PX8jai0T6Jod76EfxvHdbislew4o

# 8xGSBYZFn3KOO0iXk11le7WBcKHr8UuAnY3DGORTOkTSrbWtLUmk4Mr0UhORbh4z

# EH11InPZdV6hbTiaNDeIwrMyYLrnHSxmSzICpMFY2PIZBpjZIgLpajq6A/eLBPbc

# XgqsiOAPzEobKFKxwTYVIbsT1guSB1OEUqBUaL3c99CtjgpMlLL+Af9//njjWEt8

# n5bg21P3UVslAZOq6TgJ5kt9ECKCk19gmNExxXSSHJRmf/KuP4E4HSK9LRVSZo7+

# pm4qYDDNZf5aqSs21YkY6oAS6FDEYDQfdUZOMRWxCdAsO4Rsksi1BkPN0JibRA18

# N3Xn9ZRlDRe+YSgFUBUWzYITyhFRVqgMpL7OikcUEo+EdMir1UiVVDQNjVWlh6r0

# ttQYLKEDddNyZ5hLGYggVJT1CPGIr3rIWJhlFcJEMgefrHgv1YhBTH7Ff67MXzOM

# 9H2tNU8w9+cUezQzrbDIjxZB8RhzQq6qPnETpogWD5GjO5APiUZJRob93/dkLCD9

# QnPgk83Os8HIMUAPpD3KzL6LFwqpu0m5cZghMTvUSlXEVURIjtBEkZ/Lv9pmbnAj

# HDwcZsmTGwoAP04Vl2f2EWN22euviSjkkfUVFuZzPusDFDqKoRRLQg+x2mUOo6GC

# F3cwghdzBgorBgEEAYI3AwMBMYIXYzCCF18GCSqGSIb3DQEHAqCCF1AwghdMAgED

# MQ8wDQYJYIZIAWUDBAIBBQAweAYLKoZIhvcNAQkQAQSgaQRnMGUCAQEGCWCGSAGG

# /WwHATAxMA0GCWCGSAFlAwQCAQUABCBEWZNAoxNHXc/EzgW/tN/SdWdZvPFYR0Ox

# QdX+GbkQQwIRAKLaCM02fjy7XlPUal/tmJEYDzIwMjYwNjMwMTYyNzEyWqCCEzow

# ggbtMIIE1aADAgECAhAKgO8YS43xBYLRxHanlXRoMA0GCSqGSIb3DQEBCwUAMGkx

# CzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4

# RGlnaUNlcnQgVHJ1c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYg

# MjAyNSBDQTEwHhcNMjUwNjA0MDAwMDAwWhcNMzYwOTAzMjM1OTU5WjBjMQswCQYD

# VQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lD

# ZXJ0IFNIQTI1NiBSU0E0MDk2IFRpbWVzdGFtcCBSZXNwb25kZXIgMjAyNSAxMIIC

# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA0EasLRLGntDqrmBWsytXum9R

# /4ZwCgHfyjfMGUIwYzKomd8U1nH7C8Dr0cVMF3BsfAFI54um8+dnxk36+jx0Tb+k

# +87H9WPxNyFPJIDZHhAqlUPt281mHrBbZHqRK71Em3/hCGC5KyyneqiZ7syvFXJ9

# A72wzHpkBaMUNg7MOLxI6E9RaUueHTQKWXymOtRwJXcrcTTPPT2V1D/+cFllESvi

# H8YjoPFvZSjKs3SKO1QNUdFd2adw44wDcKgH+JRJE5Qg0NP3yiSyi5MxgU6cehGH

# r7zou1znOM8odbkqoK+lJ25LCHBSai25CFyD23DZgPfDrJJJK77epTwMP6eKA0kW

# a3osAe8fcpK40uhktzUd/Yk0xUvhDU6lvJukx7jphx40DQt82yepyekl4i0r8OEp

# s/FNO4ahfvAk12hE5FVs9HVVWcO5J4dVmVzix4A77p3awLbr89A90/nWGjXMGn7F

# QhmSlIUDy9Z2hSgctaepZTd0ILIUbWuhKuAeNIeWrzHKYueMJtItnj2Q+aTyLLKL

# M0MheP/9w6CtjuuVHJOVoIJ/DtpJRE7Ce7vMRHoRon4CWIvuiNN1Lk9Y+xZ66laz

# s2kKFSTnnkrT3pXWETTJkhd76CIDBbTRofOsNyEhzZtCGmnQigpFHti58CSmvEyJ

# cAlDVcKacJ+A9/z7eacCAwEAAaOCAZUwggGRMAwGA1UdEwEB/wQCMAAwHQYDVR0O

# BBYEFOQ7/PIx7f391/ORcWMZUEPPYYzoMB8GA1UdIwQYMBaAFO9vU0rp5AZ8esri

# kFb2L9RJ7MtOMA4GA1UdDwEB/wQEAwIHgDAWBgNVHSUBAf8EDDAKBggrBgEFBQcD

# CDCBlQYIKwYBBQUHAQEEgYgwgYUwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRp

# Z2ljZXJ0LmNvbTBdBggrBgEFBQcwAoZRaHR0cDovL2NhY2VydHMuZGlnaWNlcnQu

# Y29tL0RpZ2lDZXJ0VHJ1c3RlZEc0VGltZVN0YW1waW5nUlNBNDA5NlNIQTI1NjIw

# MjVDQTEuY3J0MF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly9jcmwzLmRpZ2ljZXJ0

# LmNvbS9EaWdpQ2VydFRydXN0ZWRHNFRpbWVTdGFtcGluZ1JTQTQwOTZTSEEyNTYy

# MDI1Q0ExLmNybDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEwDQYJ

# KoZIhvcNAQELBQADggIBAGUqrfEcJwS5rmBB7NEIRJ5jQHIh+OT2Ik/bNYulCrVv

# hREafBYF0RkP2AGr181o2YWPoSHz9iZEN/FPsLSTwVQWo2H62yGBvg7ouCODwrx6

# ULj6hYKqdT8wv2UV+Kbz/3ImZlJ7YXwBD9R0oU62PtgxOao872bOySCILdBghQ/Z

# LcdC8cbUUO75ZSpbh1oipOhcUT8lD8QAGB9lctZTTOJM3pHfKBAEcxQFoHlt2s9s

# XoxFizTeHihsQyfFg5fxUFEp7W42fNBVN4ueLaceRf9Cq9ec1v5iQMWTFQa0xNqI

# tH3CPFTG7aEQJmmrJTV3Qhtfparz+BW60OiMEgV5GWoBy4RVPRwqxv7Mk0Sy4QHs

# 7v9y69NBqycz0BZwhB9WOfOu/CIJnzkQTwtSSpGGhLdjnQ4eBpjtP+XB3pQCtv4E

# 5UCSDag6+iX8MmB10nfldPF9SVD7weCC3yXZi/uuhqdwkgVxuiMFzGVFwYbQsiGn

# oa9F5AaAyBjFBtXVLcKtapnMG3VH3EmAp/jsJ3FVF3+d1SVDTmjFjLbNFZUWMXuZ

# yvgLfgyPehwJVxwC+UpX2MSey2ueIu9THFVkT+um1vshETaWyQo8gmBto/m3acaP

# 9QsuLj3FNwFlTxq25+T4QwX9xa6ILs84ZPvmpovq90K8eWyG2N01c4IhSOxqt81n

# MIIGtDCCBJygAwIBAgIQDcesVwX/IZkuQEMiDDpJhjANBgkqhkiG9w0BAQsFADBi

# MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3

# d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3Qg

# RzQwHhcNMjUwNTA3MDAwMDAwWhcNMzgwMTE0MjM1OTU5WjBpMQswCQYDVQQGEwJV

# UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0IFRy

# dXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUgQ0ExMIIC

# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtHgx0wqYQXK+PEbAHKx126NG

# aHS0URedTa2NDZS1mZaDLFTtQ2oRjzUXMmxCqvkbsDpz4aH+qbxeLho8I6jY3xL1

# IusLopuW2qftJYJaDNs1+JH7Z+QdSKWM06qchUP+AbdJgMQB3h2DZ0Mal5kYp77j

# YMVQXSZH++0trj6Ao+xh/AS7sQRuQL37QXbDhAktVJMQbzIBHYJBYgzWIjk8eDrY

# hXDEpKk7RdoX0M980EpLtlrNyHw0Xm+nt5pnYJU3Gmq6bNMI1I7Gb5IBZK4ivbVC

# iZv7PNBYqHEpNVWC2ZQ8BbfnFRQVESYOszFI2Wv82wnJRfN20VRS3hpLgIR4hjzL

# 0hpoYGk81coWJ+KdPvMvaB0WkE/2qHxJ0ucS638ZxqU14lDnki7CcoKCz6eum5A1

# 9WZQHkqUJfdkDjHkccpL6uoG8pbF0LJAQQZxst7VvwDDjAmSFTUms+wV/FbWBqi7

# fTJnjq3hj0XbQcd8hjj/q8d6ylgxCZSKi17yVp2NL+cnT6Toy+rN+nM8M7LnLqCr

# O2JP3oW//1sfuZDKiDEb1AQ8es9Xr/u6bDTnYCTKIsDq1BtmXUqEG1NqzJKS4kOm

# xkYp2WyODi7vQTCBZtVFJfVZ3j7OgWmnhFr4yUozZtqgPrHRVHhGNKlYzyjlroPx

# ul+bgIspzOwbtmsgY1MCAwEAAaOCAV0wggFZMBIGA1UdEwEB/wQIMAYBAf8CAQAw

# HQYDVR0OBBYEFO9vU0rp5AZ8esrikFb2L9RJ7MtOMB8GA1UdIwQYMBaAFOzX44LS

# cV1kTN8uZz/nupiuHA9PMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEF

# BQcDCDB3BggrBgEFBQcBAQRrMGkwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRp

# Z2ljZXJ0LmNvbTBBBggrBgEFBQcwAoY1aHR0cDovL2NhY2VydHMuZGlnaWNlcnQu

# Y29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcnQwQwYDVR0fBDwwOjA4oDagNIYy

# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5j

# cmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEB

# CwUAA4ICAQAXzvsWgBz+Bz0RdnEwvb4LyLU0pn/N0IfFiBowf0/Dm1wGc/Do7oVM

# Y2mhXZXjDNJQa8j00DNqhCT3t+s8G0iP5kvN2n7Jd2E4/iEIUBO41P5F448rSYJ5

# 9Ib61eoalhnd6ywFLerycvZTAz40y8S4F3/a+Z1jEMK/DMm/axFSgoR8n6c3nuZB

# 9BfBwAQYK9FHaoq2e26MHvVY9gCDA/JYsq7pGdogP8HRtrYfctSLANEBfHU16r3J

# 05qX3kId+ZOczgj5kjatVB+NdADVZKON/gnZruMvNYY2o1f4MXRJDMdTSlOLh0HC

# n2cQLwQCqjFbqrXuvTPSegOOzr4EWj7PtspIHBldNE2K9i697cvaiIo2p61Ed2p8

# xMJb82Yosn0z4y25xUbI7GIN/TpVfHIqQ6Ku/qjTY6hc3hsXMrS+U0yy+GWqAXam

# 4ToWd2UQ1KYT70kZjE4YtL8Pbzg0c1ugMZyZZd/BdHLiRu7hAWE6bTEm4XYRkA6T

# l4KSFLFk43esaUeqGkH/wyW4N7OigizwJWeukcyIPbAvjSabnf7+Pu0VrFgoiovR

# Diyx3zEdmcif/sYQsfch28bZeUz2rtY/9TCA6TD8dC3JE3rYkrhLULy7Dc90G6e8

# BlqmyIjlgp2+VqsS9/wQD7yFylIz0scmbKvFoW2jNrbM1pD2T7m3XDCCBY0wggR1

# oAMCAQICEA6bGI750C3n79tQ4ghAGFowDQYJKoZIhvcNAQEMBQAwZTELMAkGA1UE

# BhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2lj

# ZXJ0LmNvbTEkMCIGA1UEAxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4X

# DTIyMDgwMTAwMDAwMFoXDTMxMTEwOTIzNTk1OVowYjELMAkGA1UEBhMCVVMxFTAT

# BgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEh

# MB8GA1UEAxMYRGlnaUNlcnQgVHJ1c3RlZCBSb290IEc0MIICIjANBgkqhkiG9w0B

# AQEFAAOCAg8AMIICCgKCAgEAv+aQc2jeu+RdSjwwIjBpM+zCpyUuySE98orYWcLh

# Kac9WKt2ms2uexuEDcQwH/MbpDgW61bGl20dq7J58soR0uRf1gU8Ug9SH8aeFaV+

# vp+pVxZZVXKvaJNwwrK6dZlqczKU0RBEEC7fgvMHhOZ0O21x4i0MG+4g1ckgHWMp

# Lc7sXk7Ik/ghYZs06wXGXuxbGrzryc/NrDRAX7F6Zu53yEioZldXn1RYjgwrt0+n

# MNlW7sp7XeOtyU9e5TXnMcvak17cjo+A2raRmECQecN4x7axxLVqGDgDEI3Y1Dek

# LgV9iPWCPhCRcKtVgkEy19sEcypukQF8IUzUvK4bA3VdeGbZOjFEmjNAvwjXWkmk

# wuapoGfdpCe8oU85tRFYF/ckXEaPZPfBaYh2mHY9WV1CdoeJl2l6SPDgohIbZpp0

# yt5LHucOY67m1O+SkjqePdwA5EUlibaaRBkrfsCUtNJhbesz2cXfSwQAzH0clcOP

# 9yGyshG3u3/y1YxwLEFgqrFjGESVGnZifvaAsPvoZKYz0YkH4b235kOkGLimdwHh

# D5QMIR2yVCkliWzlDlJRR3S+Jqy2QXXeeqxfjT/JvNNBERJb5RBQ6zHFynIWIgnf

# fEx1P2PsIV/EIFFrb7GrhotPwtZFX50g/KEexcCPorF+CiaZ9eRpL5gdLfXZqbId

# 5RsCAwEAAaOCATowggE2MA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFOzX44LS

# cV1kTN8uZz/nupiuHA9PMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3zbcgP

# MA4GA1UdDwEB/wQEAwIBhjB5BggrBgEFBQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0

# dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBDBggrBgEFBQcwAoY3aHR0cDovL2NhY2Vy

# dHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNydDBFBgNV

# HR8EPjA8MDqgOKA2hjRodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRB

# c3N1cmVkSURSb290Q0EuY3JsMBEGA1UdIAQKMAgwBgYEVR0gADANBgkqhkiG9w0B

# AQwFAAOCAQEAcKC/Q1xV5zhfoKN0Gz22Ftf3v1cHvZqsoYcs7IVeqRq7IviHGmlU

# Iu2kiHdtvRoU9BNKei8ttzjv9P+Aufih9/Jy3iS8UgPITtAq3votVs/59PesMHqa

# i7Je1M/RQ0SbQyHrlnKhSLSZy51PpwYDE3cnRNTnf+hZqPC/Lwum6fI0POz3A8eH

# qNJMQBk1RmppVLC4oVaO7KTVPeix3P0c2PR3WlxUjG/voVA9/HYJaISfb8rbII01

# YBwCA8sgsKxYoA5AY8WYIsGyWfVVa88nq2x2zm8jLfR+cWojayL/ErhULSd+2DrZ

# 8LaHlv1b0VysGMNNn3O3AamfV6peKOK5lDGCA3wwggN4AgEBMH0waTELMAkGA1UE

# BhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2Vy

# dCBUcnVzdGVkIEc0IFRpbWVTdGFtcGluZyBSU0E0MDk2IFNIQTI1NiAyMDI1IENB

# MQIQCoDvGEuN8QWC0cR2p5V0aDANBglghkgBZQMEAgEFAKCB0TAaBgkqhkiG9w0B

# CQMxDQYLKoZIhvcNAQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MDYzMDE2MjcxMlow

# KwYLKoZIhvcNAQkQAgwxHDAaMBgwFgQU3WIwrIYKLTBr2jixaHlSMAf7QX4wLwYJ

# KoZIhvcNAQkEMSIEIDMjMU7JE+0ZJsdcQem67BDhAt3HQfGPKhj9tzO9mpojMDcG

# CyqGSIb3DQEJEAIvMSgwJjAkMCIEIEqgP6Is11yExVyTj4KOZ2ucrsqzP+NtJpqj

# NPFGEQozMA0GCSqGSIb3DQEBAQUABIICAMoebRK9u/JinaPpiKkd4/MteYMtFEPC

# aCyz15wDL9tzqcdEgGN8WnRlbn7a8dZQrx8lDiLzN9ftcwRO4ZCLia9cStyL4aL2

# ltijav0FjSv1m7fDaft6hF0mMYGtyxhFmcets42brXIZIlHNhxtNnoXvJhA8qoF8

# qY1qqivJU+Qzi4SIG+Hx4f+JymMUQkSmTu/XDwp2ApInXwHOlaFhG5YsX03ketTN

# aDNCPf0OOcBGoqozfQMHf+9vXauvP4zKYBj5IgW7ZhOOVIDgWebEeTrL6sFuB7KM

# G1TbAn+nNM9w1c52pWJ8pav65PzNo2xBVFjcG/N55Ylm2nv6UKTgOfq13dIJb2Ex

# 02+vTDhPmzrkIjTCpyqqj8loH+aC1w0wcH4U4gj4s1OCw7oHtSq/oA68cwWzmILZ

# nDXCpZraBNdNFp98i58yqnK8TiTE7dd7ybaPl1RzZjlw1id+tAq9E4LSY/pgYABc

# JkrzeMajS6er2D1svZ4ZjMaaCRqwssAGN6WI4DR/TNPIU06mK2UPu5EwIjTPW1Dd

# rv2ONK2rST61RcDg1SxBxLqCC2oTa/5JeQSt8dHq1nTS0CXkwRjsdntZAmqcxDkH

# 4h3g6vFW2H02+IW2v4KuNVG6hxgPs9BmnrYBANQ9hmP+3M2r2/oceJ7So0Sb4rNq

# FEisC2KVUPov

# SIG # End signature block