AzStackHciNetwork/AzStackHci.Network.psm1

<#############################################################
 # #
 # Copyright (C) Microsoft Corporation. All rights reserved. #
 # #
 #############################################################>


Import-Module $PSScriptRoot\AzStackHci.Network.Helpers.psm1 -Force -DisableNameChecking -Global
Import-Module $PSScriptRoot\..\AzStackHci.EnvironmentChecker.Utilities.psm1 -Force -DisableNameChecking -Global
Import-Module $PSScriptRoot\..\AzStackHci.EnvironmentChecker.Reporting.psm1 -Force -DisableNameChecking -Global
Import-LocalizedData -BindingVariable lnTxt -FileName AzStackHci.Network.Strings.psd1
function Invoke-AzStackHciNetworkValidation
{
    <#
    .SYNOPSIS
        Perform AzStackHci Network Validation
    .DESCRIPTION
        Perform AzStackHci Network Validation by attempting below tests:
        - Validate management IP range (for deployment)
        - Validate host network configuration readiness
        - Validate adapter readiness
        - Validate DHCP status for host (for DHCP deployment)
        - Validate new node readiness and network intent status (during add server)
    .EXAMPLE
        # Using a deployment answer file to validate network configurations
 
        $allServers = @("Server 1 IP", "Server 2 IP") # you need to use IP for the connection
        $userName = "<LOCALADMIN>"
        $secPassWord = ConvertTo-SecureString "<LOCALADMINPASSWORD>" -AsPlainText -Force
        $hostCred = New-Object System.Management.Automation.PSCredential($username, $secPassWord)
        [System.Management.Automation.Runspaces.PSSession[]] $allServerSessions = @();
        foreach ($currentServer in $allServers) {
            $currentSession = Microsoft.PowerShell.Core\New-PSSession -ComputerName $currentServer -Credential $hostCred -ErrorAction Stop
            $allServerSessions += $currentSession
        }
        $answerFilePath = "<ANSWERFILELOCATION>" # Like C:\MASLogs\Unattended-2024-07-18-20-44-48.json
        Invoke-AzStackHciNetworkValidation -DeployAnswerFile $answerFilePath -PSSession $allServerSessions -ProxyEnabled $false
    .EXAMPLE
        # Using indivudual parameter to validate network configurations
 
        $answerFilePath = "<ANSWERFILELOCATION>"
        $managementSubnetCIDR = "<CIDR string for management subnet>"
        $logOutputPath = "<LOGFILELOCATION>"
        $userName = "<LOCALADMIN>"
        $secPassWord = ConvertTo-SecureString "<LOCALADMINPASSWORD>" -AsPlainText -Force
        $hostCred = New-Object System.Management.Automation.PSCredential($username, $secPassWord)
        $answerFileContent = Get-Content $answerFilePath -Raw | ConvertFrom-Json
        $ipPools = New-Object System.Collections.ArrayList
        [System.Management.Automation.Runspaces.PSSession[]] $allServerSessions = @();
        foreach ($ippool in $answerFileContent.scaleUnits[0].deploymentData.infrastructureNetwork[0].ipPools) {
            $currentPoolObject = [PSCustomObject] @{
                StartingAddress = $ipPool.StartingAddress
                EndingAddress= $ipPool.EndingAddress
            }
            $ipPools.Add($currentPoolObject)
        }
        [PSObject[]] $atcHostIntentsInfo = $answerFileContent.scaleUnits[0].deploymentData.hostNetwork.intents
        [System.Collections.Hashtable] $StorageAdapterVLANIDInfo = @{ "adapter1" = 711; "adapter2" = 712 }
        [System.String[]]$allServers = $answerFileContent.scaleUnits[0].deploymentData.physicalNodes.Name
        [System.Management.Automation.Runspaces.PSSession[]] $allServerSessions = @();
        foreach ($currentServer in $allServers) {
            $currentSession = Microsoft.PowerShell.Core\New-PSSession -ComputerName $currentServer -Credential $hostCred -ErrorAction Stop
            $allServerSessions += $currentSession
        }
        Invoke-AzStackHciNetworkValidation -IpPools $ipPools -ManagementSubnetValue $managementSubnetCIDR -PSSession $allServerSessions -OutputPath $logOutputPath -AtcHostIntents $atcHostIntentsInfo -StorageAdapterVLANIDInfo $StorageAdapterVLANIDInfo
 
    .INPUTS
        Inputs (if any)
    .OUTPUTS
        Output (if any)
    .LINK
        https://docs.microsoft.com/en-us/azure-stack/hci/manage/use-environment-checker?tabs=network
    #>

    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $true, ParameterSetName = 'AnswerFile', HelpMessage = "Specify the answer file used for deployment validation.")]
        [ValidateScript({ Test-Path -Path $_ -PathType Leaf })]
        [System.String]
        $DeployAnswerFile,

        [Parameter(Mandatory = $true, ParameterSetName = 'Deploy', HelpMessage = "Specify end infra IP Range pools")]
        [Parameter(Mandatory = $true, ParameterSetName = 'AddNode', HelpMessage = "Specify end infra IP Range pools")]
        [System.Collections.ArrayList]
        $IpPools,

        [Parameter(Mandatory = $true, ParameterSetName = 'Deploy', HelpMessage = "Specify PSObject array of ATC Host Intents.")]
        [Parameter(Mandatory = $true, ParameterSetName = 'AddNode', HelpMessage = "Specify PSObject array of ATC Host Intents.")]
        [string] $ManagementSubnetValue,

        [Parameter(Mandatory = $true, ParameterSetName = 'Deploy', HelpMessage = "Specify the PsSession(s) used to validation from.")]
        [Parameter(Mandatory = $true, ParameterSetName = 'AnswerFile', HelpMessage = "Specify the PsSession(s) used to validation from.")]
        [Parameter(Mandatory = $true, ParameterSetName = 'AddNode', HelpMessage = "Specify the PsSession(s) used to validation from.")]
        [System.Management.Automation.Runspaces.PSSession[]]
        $PSSession,

        [Parameter(Mandatory = $true, ParameterSetName = 'AddNode', HelpMessage = "Specify Host and Mgmt IP Mapping for Nodes")]
        [Hashtable]
        $NodeToManagementIPMap,

        [Parameter(Mandatory = $false, ParameterSetName = 'Deploy', HelpMessage = "Run tests specific to DHCP case")]
        [Parameter(Mandatory = $false, ParameterSetName = 'AddNode', HelpMessage = "Run tests specific to DHCP case")]
        [switch]
        $dhcpEnabled,

        [Parameter(Mandatory = $true, ParameterSetName = 'Deploy', HelpMessage = "Specify PSObject array of ATC Host Intents.")]
        [Parameter(Mandatory = $true, ParameterSetName = 'AddNode', HelpMessage = "Specify PSObject array of ATC Host Intents.")]
        [PSObject[]] $AtcHostIntents,

        [Parameter(Mandatory = $false, ParameterSetName = 'AddNode', HelpMessage = "Specify the installation method of the system")]
        [ValidateSet('Deployment','Upgrade')]
        [string] $InstallationMethod = "Deployment",

        [Parameter(Mandatory = $true, ParameterSetName = 'Deploy', HelpMessage = "Specify hashtable of storage adapter VLANID info.")]
        [System.Collections.Hashtable] $StorageAdapterVLANIDInfo,

        [Parameter(Mandatory = $false, ParameterSetName = 'Deploy', HelpMessage = "System proxy information")]
        [Parameter(Mandatory = $true, ParameterSetName = 'AnswerFile', HelpMessage = "System proxy information")]
        [System.Boolean] $ProxyEnabled = $false,

        [Parameter(Mandatory = $false, ParameterSetName = 'Deploy', HelpMessage = "If current HCI cluster is using switchless configuration for storage traffic")]
        [Parameter(Mandatory = $true, ParameterSetName = 'AnswerFile', HelpMessage = "If current HCI cluster is using switchless configuration for storage traffic")]
        [System.Boolean] $SwitchlessDeploy = $false,

        [Parameter(Mandatory = $false, HelpMessage = "Specify the region name to target for connectivity validation.")]
        [string]
        $RegionName,

        [Parameter(Mandatory = $false, HelpMessage = "Return PSObject result.")]
        [switch]
        $PassThru,

        [Parameter(Mandatory = $false, HelpMessage = "Tests to include.")]
        [ArgumentCompleter({ Get-TestListByFunction -ModuleName AzStackHci.Network.Helpers })]
        [ValidateScript({ $_ -in (Get-TestListByFunction -ModuleName AzStackHci.Network.Helpers) })]
        [string[]]
        $Include,

        [Parameter(Mandatory = $false, HelpMessage = "Tests to exclude.")]
        [ArgumentCompleter({ Get-TestListByFunction -ModuleName AzStackHci.Network.Helpers })]
        [ValidateScript({ $_ -in (Get-TestListByFunction -ModuleName AzStackHci.Network.Helpers) })]
        [string[]]
        $Exclude,

        [Parameter(Mandatory = $false, HelpMessage = "Hardware class: Small, Medium, or Large")]
        [ValidateSet('Small','Medium','Large')]
        [String] $HardwareClass = "Medium",

        [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")]
        [string]$OutputPath,

        [Parameter(Mandatory = $false, HelpMessage = "Remove all previous progress and create a clean report")]
        [switch]$CleanReport = $false,

        [Parameter(Mandatory = $false, HelpMessage = "Show only failed results on screen.")]
        [switch]$ShowFailedOnly,

        [Parameter(Mandatory = $false, HelpMessage = "Indicating Opeation Type")]
        [ValidateSet('AddNode','Deployment','Upgrade')]
        [String]$OperationType = "Deployment"
    )

    $callingTestParam = @{}

    switch ($PSCmdlet.ParameterSetName)
    {
        "AnswerFile"
        {
            # If the function is called with the AnswerFile parameter set, we need to set the other parameters
            Log-Info -Message "Performing Network Validation using AnswerFile"
            $deployAnswerFileContent = Get-Content $DeployAnswerFile -Raw | ConvertFrom-Json

            Log-Info -Message "Get IpPools info from answerfile `"infrastructureNetwork | ipPools`" section"
            $allIpPools = New-Object System.Collections.ArrayList
            foreach ($ippool in $deployAnswerFileContent.scaleUnits[0].deploymentData.infrastructureNetwork[0].ipPools)
            {
                $currentPoolObject = [PSCustomObject] @{
                    StartingAddress =  $ipPool.StartingAddress
                    EndingAddress= $ipPool.EndingAddress
                }

                $allIpPools.Add($currentPoolObject)
            }

            # calculate the infra network CIDR string
            Log-Info -Message "Calculate ManagementSubnetValue (infra network CIDR string) from answerfile `"infrastructureNetwork | subnetMask`" and StartingAddress of 1st element of `"infrastructureNetwork | ipPools`""
            $infraSubnetMask = $deployAnswerFileContent.scaleUnits[0].deploymentData.infrastructureNetwork[0].subnetMask
            $infraSubnetMaskBytes = $infraSubnetMask -split '\.' | ForEach-Object { [Convert]::ToString([int]$_, 2).PadLeft(8, '0') }
            $infraBinarySubnetMask = $infraSubnetMaskBytes -join ''
            $prefixLength = ($infraBinarySubnetMask -split '1').Count - 1
            $testIP = $deployAnswerFileContent.scaleUnits[0].deploymentData.infrastructureNetwork[0].ipPools[0].StartingAddress
            # Note that all IP pools must be in same subnet so we can use the first IP pool to calculate the subnet CIDR
            $managementSubnetCIDR = (NormalizeIPv4Subnet -cidrSubnet "$testIP/$prefixLength").ToString()
            Log-Info -Message "Got management subnet CIDR: $managementSubnetCIDR"

            [PSObject[]] $atcHostIntentsInfo = $deployAnswerFileContent.scaleUnits[0].deploymentData.hostNetwork.intents

            [System.Collections.Hashtable] $StorageAdapterVLANIDInfo = @{}
            [PSObject[]] $storageNetworkDefinition = $deployAnswerFileContent.scaleUnits[0].deploymentData.hostNetwork.storageNetworks
            foreach ($storageNetworkInfo in $storageNetworkDefinition)
            {
                $StorageAdapterVLANIDInfo.Add($storagenetworkInfo.networkAdapterName, $storageNetworkInfo.VlanId)
            }

            $callingTestParam = @{
                IpPools = $allIpPools
                ManagementSubnetValue = $managementSubnetCIDR
                PSSession = $PSSession
                dhcpEnabled = $deployAnswerFileContent.scaleUnits[0].deploymentData.infrastructureNetwork[0].useDhcp
                AtcHostIntents = $atcHostIntentsInfo
                StorageAdapterVLANIDInfo = $StorageAdapterVLANIDInfo
                ProxyEnabled = $ProxyEnabled
                HardwareClass = $HardwareClass
            }
        }
        "Deploy"
        {
            Log-Info -Message "Performing Network Validation using Deploy parameters"
            $callingTestParam = @{
                IpPools = $IpPools
                ManagementSubnetValue = $ManagementSubnetValue
                PSSession = $PSSession
                dhcpEnabled = $dhcpEnabled
                AtcHostIntents = $AtcHostIntents
                StorageAdapterVLANIDInfo = $StorageAdapterVLANIDInfo
                ProxyEnabled = $ProxyEnabled
                HardwareClass = $HardwareClass
            }
        }
        "AddNode"
        {
            Log-Info -Message "Performing Network Validation using AddNode parameters"
            $callingTestParam = @{
                IpPools = $IpPools
                ManagementSubnetValue = $ManagementSubnetValue
                PSSession = $PSSession
                NodeToManagementIPMap = $NodeToManagementIPMap
                dhcpEnabled = $dhcpEnabled
                AtcHostIntents = $AtcHostIntents
                HardwareClass = $HardwareClass
            }
        }
    }

    try
    {
        $script:ErrorActionPreference = 'Stop'
        Set-AzStackHciOutputPath -Path $OutputPath

        if ($RegionName -eq 'AzureLocal') {
            $params = @{
                RegionName = 'AzureLocal'
            }
            $callingTestParam += $params
        }

        Write-AzStackHciHeader -invocation $MyInvocation -params $PSBoundParameters -PassThru:$PassThru

        # Call/Initialise reporting
        $envcheckerReport = Get-AzStackHciEnvProgress -clean:$CleanReport
        $envcheckerReport = Add-AzStackHciEnvJob -report $envcheckerReport

        Import-Module $PSScriptRoot\AzStackHci.Network.Helpers.psm1 -Force -DisableNameChecking -Global

        #region Get test list
        Write-Progress -Id 1 -Activity "Checking AzStackHci Dependencies" -Status "Network Configuration" -PercentComplete 0 -ErrorAction SilentlyContinue

        # We could use function "Get-TestListByFunction" to get the list of tests to run.
        # However, that function will return all tests in the module that matching to a specific function name.
        # The inexplicit selection of the validator might make the maintenance of the validator list
        # harder: if a new validator is added, the function will automatically include it to be run for
        # a specific scenario. It will be easy to forget that implication. It might be easier to maintain
        # the list of tests to run in the script explicitly. With the explicit list, the user can clearly
        # see what tests are run for a specific scenario and can easily add or remove tests from the list.
        switch ($OperationType)
        {
            "Deployment"
            {
                Log-Info -Message "Deployment scenario, will check all network configuration"
                $script:envchktestList = @( "Test-NwkValidator_StorageAdapterReadiness",
                                            "Test-NwkValidator_StorageConnection",
                                            "Test-NwkValidator_InfraIpPoolReadiness",
                                            "Test-NwkValidator_HostNetworkConfigurationReadiness",
                                            "Test-NwkValidator_AdapterDriverMgmtAdapterReadiness",
                                            "Test-NwkValidator_MgmtIPIPPoolRequirement")

                if ($SwitchlessDeploy)
                {
                    # Test-NwkValidator_StorageConnection is not supported on switchless deploy for now
                    Log-Info -Message "Switchless deployment scenario, will skip Test-NwkValidator_StorageConnection"
                    $script:envchktestList = $script:envchktestList | Where-Object { $_ -ne "Test-NwkValidator_StorageConnection" }
                }
            }
            "AddNode"
            {
                Log-Info -Message "Add Node scenario, will check all network configuration"
                $script:envchktestList = @( "Test-NwkValidator_StorageAdapterReadiness",
                                            "Test-NwkValidator_HostNetworkConfigurationReadiness",
                                            "Test-NwkValidator_AdapterDriverMgmtAdapterReadiness",
                                            "Test-NwkValidator_MgmtIPIPPoolRequirement",
                                            "Test-NwkValidator_NetworkIntentStatus")

                # Check if DHCP enabled or Brownfield upgrade. envType will be "Upgrade" for brownfield, "Deployment" for greenfield
                $envType = $null

                if ($null -ne $InstallationMethod)
                {
                    $envType = $InstallationMethod
                }

                if ($dhcpEnabled -or ($envType -eq "Upgrade"))
                {
                    Log-Info -Message "No need to run TestMgmtIPForNewNode for Add Node scenario when DHCP enabled or Brownfield upgrade"
                }
                else
                {
                    Log-Info -Message "Need to run TestMgmtIPForNewNode for Add Node scenario if not DHCP enabled and not Brownfield upgrade"
                    $script:envchktestList += "Test-NwkValidator_MgmtIPForNewNode"
                }
            }
            "Upgrade"
            {
                Log-Info -Message "Only need to run Test-NwkValidator_InfraIpPoolReadiness for Upgrade scenario"
                $script:envchktestList = "Test-NwkValidator_InfraIpPoolReadiness"
            }
        }
        #endregion

        $TotalTestCount = ($script:envchktestList).Count

        # Run validation
        $i = 0
        $Result = @()
        $ProgressActivity = "Checking AzStackHci Network Compatibility"
        $i = 0
        $ProgressStatus = "Testing $ENV:ComputerName"
        $progressParams = @{
            Id          = 1
            Activity    = $ProgressActivity
            Status      = $ProgressStatus
            ErrorAction = 'SilentlyContinue'
        }
        Write-Progress @progressParams

        :noTestsBreak foreach ($test in $script:envchktestList)
        {
            $OpMsg = "Run network validator [{0}] on {1}" -f $test, $ENV:ComputerName
            Log-Info -Message $OpMsg
            Write-Progress @progressParams -CurrentOperation $OpMsg -PercentComplete (($i++ / $TotalTestCount) * 100)

            $invokeParameters = @{}
            Get-Command $test | Select-Object -ExpandProperty Parameters | Select-Object -ExpandProperty Keys | ForEach-Object {
                if ($callingTestParam[$PSITEM]) {
                    $invokeParameters += @{
                        $PSITEM = $callingTestParam[$PSITEM]
                    }
                }
            }

            Log-Info "Validator parameters:"
            Log-Info -Message ($invokeParameters | Out-String)
            $Result += Invoke-Expression "$test @invokeParameters"

            $OpMsg = "End of network validator [{0}] run on {1}`n" -f $test, $ENV:ComputerName
            Log-Info -Message $OpMsg
        }

        # Feedback results - user scenario
        Log-Info "Network validation finished!" -ConsoleOut:(-not $PassThru)
        if (-not $PassThru)
        {
            $progressParams = @{
                Id              = 3
                Activity        = "Formating Results"
                Status          = "Writing Results for $($ENV:ComputerName)"
                PercentComplete = 1
                ErrorAction     = 'SilentlyContinue'
            }
            Write-Progress @progressParams
            Write-AzStackHciResult -Title "$($ENV:COMPUTERNAME):" -Result $result -ShowFailedOnly:$ShowFailedOnly -Seperator ': '
            Write-Summary -Result $Result -Property1 Detail
        }
        else
        {
            return $result
        }
    }
    catch
    {
        Log-Info -Message "" -ConsoleOut
        Log-Info -Message "$($_.Exception.Message)" -ConsoleOut -Type Error
        Log-Info -Message "$($_.ScriptStackTrace)" -ConsoleOut -Type Error
        $cmdletException = $_
        throw $_
    }
    finally
    {
        $Script:ErrorActionPreference = 'SilentlyContinue'
        # Write result to telemetry channel
        foreach ($r in $result)
        {
            Write-ETWResult -Result $r
        }
        # Write validation result to report object and close out report
        $envcheckerReport | Add-Member -MemberType NoteProperty -Name 'Network' -Value $Result -Force
        $envcheckerReport = Close-AzStackHciEnvJob -report $envcheckerReport
        Write-AzStackHciEnvReport -report $envcheckerReport
        Write-AzStackHciFooter -invocation $MyInvocation -Exception $cmdletException -PassThru:$PassThru
    }
}
# SIG # Begin signature block
# MIIoRQYJKoZIhvcNAQcCoIIoNjCCKDICAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAOhnfvHiAhOj1Y
# C6OSPbzp6r9VtuBHUmthHzXqnBPN7aCCDXYwggX0MIID3KADAgECAhMzAAAEBGx0
# Bv9XKydyAAAAAAQEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p
# bmcgUENBIDIwMTEwHhcNMjQwOTEyMjAxMTE0WhcNMjUwOTExMjAxMTE0WjB0MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
# AQC0KDfaY50MDqsEGdlIzDHBd6CqIMRQWW9Af1LHDDTuFjfDsvna0nEuDSYJmNyz
# NB10jpbg0lhvkT1AzfX2TLITSXwS8D+mBzGCWMM/wTpciWBV/pbjSazbzoKvRrNo
# DV/u9omOM2Eawyo5JJJdNkM2d8qzkQ0bRuRd4HarmGunSouyb9NY7egWN5E5lUc3
# a2AROzAdHdYpObpCOdeAY2P5XqtJkk79aROpzw16wCjdSn8qMzCBzR7rvH2WVkvF
# HLIxZQET1yhPb6lRmpgBQNnzidHV2Ocxjc8wNiIDzgbDkmlx54QPfw7RwQi8p1fy
# 4byhBrTjv568x8NGv3gwb0RbAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE
# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU8huhNbETDU+ZWllL4DNMPCijEU4w
# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW
# MBQGA1UEBRMNMjMwMDEyKzUwMjkyMzAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci
# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG
# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu
# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0
# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAIjmD9IpQVvfB1QehvpC
# Ge7QeTQkKQ7j3bmDMjwSqFL4ri6ae9IFTdpywn5smmtSIyKYDn3/nHtaEn0X1NBj
# L5oP0BjAy1sqxD+uy35B+V8wv5GrxhMDJP8l2QjLtH/UglSTIhLqyt8bUAqVfyfp
# h4COMRvwwjTvChtCnUXXACuCXYHWalOoc0OU2oGN+mPJIJJxaNQc1sjBsMbGIWv3
# cmgSHkCEmrMv7yaidpePt6V+yPMik+eXw3IfZ5eNOiNgL1rZzgSJfTnvUqiaEQ0X
# dG1HbkDv9fv6CTq6m4Ty3IzLiwGSXYxRIXTxT4TYs5VxHy2uFjFXWVSL0J2ARTYL
# E4Oyl1wXDF1PX4bxg1yDMfKPHcE1Ijic5lx1KdK1SkaEJdto4hd++05J9Bf9TAmi
# u6EK6C9Oe5vRadroJCK26uCUI4zIjL/qG7mswW+qT0CW0gnR9JHkXCWNbo8ccMk1
# sJatmRoSAifbgzaYbUz8+lv+IXy5GFuAmLnNbGjacB3IMGpa+lbFgih57/fIhamq
# 5VhxgaEmn/UjWyr+cPiAFWuTVIpfsOjbEAww75wURNM1Imp9NJKye1O24EspEHmb
# DmqCUcq7NqkOKIG4PVm3hDDED/WQpzJDkvu4FrIbvyTGVU01vKsg4UfcdiZ0fQ+/
# V0hf8yrtq9CkB8iIuk5bBxuPMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq
# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x
# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG
# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG
# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg
# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03
# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr
# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg
# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy
# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9
# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh
# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k
# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB
# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn
# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90
# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w
# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o
# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD
# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa
# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny
# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG
# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t
# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV
# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3
# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG
# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl
# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb
# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l
# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6
# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0
# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560
# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam
# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa
# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah
# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA
# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt
# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr
# /Xmfwb1tbWrJUnMTDXpQzTGCGiUwghohAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBIDIwMTECEzMAAAQEbHQG/1crJ3IAAAAABAQwDQYJYIZIAWUDBAIB
# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO
# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIGQqk0Uoa8FvTR+xcBiPeWW0
# 7mcWGn4gqU3zJQ5EoIiXMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A
# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB
# BQAEggEAUvtn/ynA8UQIAHXyRGnAUrGSeP6HFwozO3lwGeKelq5UUegWwplM8y48
# f4IroreaALzkSsRIvEKICqnmh8D8cyWMSYx21P7bNYQfTPR+eAAQl0PYUoaQ65JW
# E94TQ8J6wtJWPmCeUc56ymEAdJJCxYY2q38lm487vdHH7Ti5WSfwTNgdvTq2fLMa
# 1Ca9ORYoKPVT0pprkmht6KnGW8Hkp2R2SjZ8/CNs01JKs+Ktw5W/tp5TKJznD4O8
# q8xYnVzaT5bLCVYAUuawLBQXypGxB9yX34GYYZO0bZAqqt5KXRJ5aj4I1xYzGoiV
# pKZIpdL1VZUCdyw6N7xhR6O6zv5kZaGCF68wgherBgorBgEEAYI3AwMBMYIXmzCC
# F5cGCSqGSIb3DQEHAqCCF4gwgheEAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsq
# hkiG9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl
# AwQCAQUABCDZ6SAf9dhxGNtCqjzaGyiIGDf/FMVKc8vjDFBwX/uwkgIGZ0oHGn6T
# GBIyMDI0MTIwNDE1MDM1MS43NlowBIACAfSggdmkgdYwgdMxCzAJBgNVBAYTAlVT
# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVs
# YW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNO
# OjQwMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT
# ZXJ2aWNloIIR/jCCBygwggUQoAMCAQICEzMAAAH+0KjCezQhCwEAAQAAAf4wDQYJ
# KoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x
# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjQw
# NzI1MTgzMTE4WhcNMjUxMDIyMTgzMTE4WjCB0zELMAkGA1UEBhMCVVMxEzARBgNV
# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv
# c29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3Bl
# cmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NDAxQS0w
# NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Uw
# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC8vCEXFaWoDjeiWwTg8J6B
# niZJ+wfZhNIoRi/wafffrYGZrJx1/lPe1DGk/c1abrZgdSJ4hBfD7S7iqVrLgA3c
# iicj7js2mL1+jnbF0BcxfSkatzR6pbxFY3dt/Nc8q/Ts7XyLYeMPIu7LBjIoD0WZ
# Zt4+NqF/0zB3xCDKCQ+3AOtVAYvI6TIzdVOIcqqEa70EIZVF0db2WY8yutSU9aJh
# X0tUIHlVh34ARS11+oB2qXNXEDncSDFKqGnolt8QqdN1x8/pPwyKvQevBNO1XaHb
# IMG2NdtAhqrJwo5vrfcZ9GSfbXos4MGDfs//HCGh1dPzVkLZoc3t7EQOaZuJayyM
# a8UmSWLaDp23TV5KE6IaaFuievSpddwF6o1vpCgXyNf+4NW1j2m8viPxoRZLj2Ep
# QfSbOwK5wivBRL7Hwy5PS5/tVcIU0VuIJQ1FOh/EncHjnh4YmEvR/BRNFuDIJuku
# AowoOIJG5vrkOFp4O9QAAlP3cpIKh4UKiSU9q9uBDJqEZkMv+9YBWNflvwnOGXL2
# AYJ0r+qLqL5zFnRLzHoHbKM9tl90FV8f80Gn/UufvFt44RMA6fs5P0PdQa3Sr4qJ
# aBjjYecuPKGXVsC7kd+CvIA7cMJoh1Xa2O+QlrLao6cXsOCPxrrQpBP1CB8l/Bee
# vdkqJtgyNpRsI0gOfHPbKQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFG/Oe4n1JTaD
# mX/n9v7kIGJtscXdMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8G
# A1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv
# Y3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBs
# BggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0
# LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUy
# MDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUH
# AwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQCJPg1S87aXD7R0
# My2wG7GZfajeVVCqdCS4hMAYgYKAj6yXtmpk5MN3wurGwfgZYI9PO1ze2vwCAG+x
# gjNaMXCKgKMJA4OrWgExY3MSwrNyQfEDNijlLN7s4+QwDcMDFWrhJJHzL5NELYZw
# 53QlF5nWU+WGU+X1cj7Pw6C04+ZCcsuI/2rOlMfAXN76xupKfxx6R24xl0vIcmTc
# 2LDcCeCVT9ZPMaxAB1yH1JVXgseJ9SebBN/SLTuIq1OU2SrdvHWLJaDs3uMZkAFF
# ZPaZf5gBUeUrbu32f5a1hufpw4k1fouwfzE9UFFgAhFWRawzIQB2g/12p9pnPBca
# aO5VD3fU2HMeOMb4R/DXXwNeOTdWrepQjWt7fjMwxNHNlkTDzYW6kXe+Jc1HcNU6
# VL0kfjHl6Z8g1rW65JpzoXgJ4kIPUZqR9LsPlrI2xpnZ76wFSHrYpVOWESxBEdlH
# AJPFuLHVjiInD48M0tzQd/X2pfZeJfS7ZIz0JZNOOzP1K8KMgpLEJkUI2//OkoiW
# wfHuFA1AdIxsqHT/DCfzq6IgAsSNrNSzMTT5fqtw5sN9TiH87/S+ZsXcExH7jmsB
# kwARMmxEM/EckKj/lcaFZ2D8ugnldYGs4Mvjhg2s3sVGccQACvTqx+Wpnx55XcW4
# Mp0/mHX1ZScZbA7Uf9mNTM6hUaJXeDCCB3EwggVZoAMCAQICEzMAAAAVxedrngKb
# SZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQI
# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv
# ZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmlj
# YXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIy
# NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT
# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE
# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEB
# AQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXI
# yjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjo
# YH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1y
# aa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v
# 3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pG
# ve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viS
# kR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYr
# bqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlM
# jgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSL
# W6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AF
# emzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIu
# rQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIE
# FgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWn
# G1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEW
# M2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5
# Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBi
# AEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV
# 9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3Js
# Lm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAx
# MC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8v
# d3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2
# LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv
# 6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZn
# OlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1
# bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4
# rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU
# 6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDF
# NLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/
# HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdU
# CbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKi
# excdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTm
# dHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZq
# ELQdVTNYs6FwZvKhggNZMIICQQIBATCCAQGhgdmkgdYwgdMxCzAJBgNVBAYTAlVT
# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVs
# YW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNO
# OjQwMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT
# ZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQCEY0cP9rtDRtAtZUb0m4bGAtFex6CBgzCB
# gKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH
# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV
# BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUA
# AgUA6vp0KDAiGA8yMDI0MTIwNDA2MjQ0MFoYDzIwMjQxMjA1MDYyNDQwWjB3MD0G
# CisGAQQBhFkKBAExLzAtMAoCBQDq+nQoAgEAMAoCAQACAhDyAgH/MAcCAQACAhXe
# MAoCBQDq+8WoAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAI
# AgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAHVudUl53CxX
# vV2ARnYjgT42y2w/aJWq3vn8Nl1OhLEHmH1QaVHaL9t3dRE6MKPf9zyE0B0rRDLc
# EL5f5emd9ULGA28A/DcATJcSh9MyP8k0pTIZIsbUe1fkrU/RVkAmwBZJGLnChNnP
# fbfAKffTkJ7X3GXaggxyEfas7Jc2DBVn9w9Iu/ZlXixe9K0EG92bSHoyaXTRW7VA
# Q2steuuoQCO4/mQ4AUV00zifRYdQ37n9Lh0vx6ZQjCq4CoVdqC8E2FnUmBVwdTE8
# KNl3kNnH7EooKwVLXs8cpiqEoftANcKrTsJZRc2+5u68g0qUCRXXbcdwSGG89JcU
# LgAFJijeOMIxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMK
# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0
# IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0Eg
# MjAxMAITMwAAAf7QqMJ7NCELAQABAAAB/jANBglghkgBZQMEAgEFAKCCAUowGgYJ
# KoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCAVt2cRVgD/
# KIRyfaDf2+VZdMwK7bNBOCM1nBRbrnsXpjCB+gYLKoZIhvcNAQkQAi8xgeowgecw
# geQwgb0EIBGFzN38U8ifGNH3abaE9apz68Y4bX78jRa2QKy3KHR5MIGYMIGApH4w
# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl
# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd
# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAH+0KjCezQhCwEAAQAA
# Af4wIgQgg7aGsNjhSgC9VNGomwyY9u8asj3eqJYdrGjxOPF+1IIwDQYJKoZIhvcN
# AQELBQAEggIAdwOO7t6n6MDu4SOM47H7GJc1eAHjvoAnEspTv413KV3kDb3IgboU
# PTRhyT59T//HlJxddFdgM2gcF6TZqVEp0lCYu3UrZt/eJSPya6A59ZX9SPjhOS4g
# SvoC8ZjeBnTp440OA0Vq1sVOPylSsofOoXloahKKgx/egedUL04TVTgFWRffJKZ/
# LGBB5RxQJmRbj2NgzVVHVUvMDdIhG2sxZozIlJ/+RkT/SdcWwk6oczbU5D6nQdje
# gwZJxSQKk4wZoVagnIgFCI4RH+HYkbcSdfNMTrWms5I4yjTt94F3L2KLwCXL46EN
# Sk8uY2+AjdBUzB9Qg0/r8bug/lJGwd1c2yCxCIlXW0FMPFQWpfdBJ/Sw019uVQTM
# a0qiNoYlb9HaG9TfE9LTfd/MrV3GEsk5+e31GFaSbCvXkeLbkFpwkKATkaPrnVJx
# pRMOpsl9+XQ60pLszCVHSx8otsftc5XC0KMHHpaAURQMEozrByOU4lXjYve/DyvL
# 96Xcy+7gHoy3TBUPFfIjvks3UHDXu3k4qyxjs9m2wtx5OBxxC0GBmOLL6LWmg5Sm
# tGoNBTPVUzVzlrglmOptuQssCSHVDS5L60lBdS6llnGsgcmJwI3GIz3uqtjeeR+p
# P74tNzPBNRSJTXVFXLyi8htvf3a/wEYqPCMdKzFnNm2sohaAernmZUk=
# SIG # End signature block