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 IP range against K8s reserved networks
        - 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)
        - Validate host network intents requirement and storage connectivity type (for deployment)
    .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 = "<LOCAL_ADMIN>"
        $secPassWord = ConvertTo-SecureString "<LOCAL_ADMIN_PASSWORD>" -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 = "<ANSWER_FILE_LOCATION>" # Like C:\MASLogs\Unattended-2024-07-18-20-44-48.json
        Invoke-AzStackHciNetworkValidation -DeployAnswerFile $answerFilePath -PSSession $allServerSessions -ProxyEnabled $false
    .EXAMPLE
        # Using individual parameter to validate network configurations
 
        $answerFilePath = "<ANSWER_FILE_LOCATION>"
        $managementSubnetCIDR = "<CIDR string for management subnet>"
        $logOutputPath = "<LOG_FILE_LOCATION>"
        $userName = "<LOCAL_ADMIN>"
        $secPassWord = ConvertTo-SecureString "<LOCAL_ADMIN_PASSWORD>" -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] $atcHostNetworkInfo = $answerFileContent.scaleUnits[0].deploymentData.hostNetwork
        [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 -HostNetworkInfo $atcHostNetworkInfo
    .PARAMETER PassThru
        Return PSObject result.
    .PARAMETER HardwareClass
        Hardware class: Small, Medium, or Large.
    .PARAMETER ClusterPattern
        Hardware class: Standard, Stretch, or RackAware.
    .PARAMETER OutputPath
        Directory path for log and report output.
    .PARAMETER CleanReport
        Remove all previous progress and create a clean report.
    .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 = 'EceParameter', HelpMessage = "Specify end infra IP Range pools")]
        [System.Collections.ArrayList]
        $IpPools,

        [Parameter(Mandatory = $true, ParameterSetName = 'EceParameter', HelpMessage = "Specify string of management subnet value in CIDR format")]
        [string] $ManagementSubnetValue,

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

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

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

        [Parameter(Mandatory = $true, ParameterSetName = 'EceParameter', HelpMessage = "How many nodes in the cluster")]
        [System.Int16] $NodesInCluster,

        [Parameter(Mandatory = $false, ParameterSetName = 'EceParameter', HelpMessage = "Specify PSObject of HostNetwork info")]
        [PSObject] $HostNetworkInfo = $null,

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

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

        [Parameter(Mandatory = $true, ParameterSetName = 'AnswerFile', HelpMessage = "System proxy information")]
        [Parameter(Mandatory = $false, ParameterSetName = 'EceParameter', HelpMessage = "System proxy information")]
        [System.Boolean] $ProxyEnabled = $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 = "Hardware class: Small, Medium, or Large")]
        [ValidateSet('Small','Medium','Large')]
        [String] $HardwareClass = "Medium",

        [Parameter(Mandatory = $false, HelpMessage = "Cluster Pattern: Standard, Stretch, or RackAware")]
        [ValidateSet('Standard','Stretch','RackAware')]
        [String]
        $ClusterPattern = "Standard",

        [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 Operation Type")]
        [ValidateSet('AddNode','Deployment','Upgrade', 'PreUpdate')]
        [String]$OperationType = "Deployment"
    )

    $callingTestParam = @{}

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

    # Prepare validator call parameters
    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 answer file `"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 answer file `"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 = (EnvValidatorNormalizeIPv4Subnet -cidrSubnet "$testIP/$prefixLength").ToString()
            Log-Info -Message "Got management subnet CIDR: $managementSubnetCIDR"

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

            # Calculate switchless flag from answer file
            # using "-eq $true" here just in case some deployment does not have this "StorageConnectivitySwitchless" in the JSON
            $switchlessFlag = $hostNetworkInfoFromAnswerFile.storageConnectivitySwitchless -eq $true

            $callingTestParam = @{
                IpPools = $allIpPools
                ManagementSubnetValue = $managementSubnetCIDR
                PSSession = $PSSession
                dhcpEnabled = $deployAnswerFileContent.scaleUnits[0].deploymentData.infrastructureNetwork[0].useDhcp
                AtcHostIntents = $atcHostIntentsInfo
                HostNetworkInfo = $hostNetworkInfoFromAnswerFile
                ProxyEnabled = $ProxyEnabled
                HardwareClass = $HardwareClass
                ClusterPattern = $ClusterPattern
                SwitchlessDeploy = $switchlessFlag
                NodeCount = $deployAnswerFileContent.scaleUnits[0].deploymentData.physicalNodes.Count
                OperationType = $OperationType
            }
        }
        "EceParameter"
        {
            Log-Info -Message "Performing Network Validation using Deploy parameters"

            # If current deployment is switchless, using "-eq $true" here just in case some deployment does not have this "StorageConnectivitySwitchless" in the JSON
            $switchlessFlag = $HostNetworkInfo.StorageConnectivitySwitchless -eq $true

            [PSObject[]] $atcHostIntentsInfo = $null

            if ($HostNetworkInfo -and ($OperationType -eq "Deployment")) {
                Log-Info -Message "Getting ATC Host Intents from HostNetworkInfo for Deployment scenario."
                $atcHostIntentsInfo = $HostNetworkInfo.intents
            } else {
                Log-Info -Message "HostNetworkInfo parameter is null. AddNode, Upgrade or PreUpdate scenario. Getting ATC Host Intents from passed in parameter."
                $atcHostIntentsInfo = $AtcHostIntents
            }

            if ($null -eq $atcHostIntentsInfo)
            {
                throw "No ATC Host Intents found. Please provide ATC Host Intents info. For deployment: provide in unattended JSON; for upgrade: make sure system has intent configured."
            }

            $callingTestParam = @{
                IpPools = $IpPools
                ManagementSubnetValue = $ManagementSubnetValue
                PSSession = $PSSession
                dhcpEnabled = $dhcpEnabled
                AtcHostIntents = $atcHostIntentsInfo
                HostNetworkInfo = $HostNetworkInfo
                ProxyEnabled = $ProxyEnabled
                HardwareClass = $HardwareClass
                ClusterPattern = $ClusterPattern
                SwitchlessDeploy = $switchlessFlag
                NodeToManagementIPMap = $NodeToManagementIPMap
                NodeCount = $NodesInCluster
                OperationType = $OperationType
            }
        }
    }

    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/Initialize reporting
        $envCheckerReport = Get-AzStackHciEnvProgress -clean:$CleanReport
        $envCheckerReport = Add-AzStackHciEnvJob -report $envCheckerReport

        #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.
        Log-Info -Message "[NetworkValidator] [$($OperationType)] scenario"
        switch ($OperationType)
        {
            "Deployment"
            {
                Log-Info -Message "Will check all network configuration needed for a successful deployment"
                $script:envchktestList = @( "Test-NwkValidator_StorageAdapterReadiness",
                                            "Test-NwkValidator_StorageConnection",
                                            "Test-NwkValidator_InfraIpPoolReadiness",
                                            "Test-NwkValidator_AKS_CidrOverlaps",
                                            "Test-NwkValidator_HostNetworkConfigurationReadiness",
                                            "Test-NwkValidator_AdapterDriverMgmtAdapterReadiness",
                                            "Test-NwkValidator_MgmtIpIpPoolRequirement",
                                            "Test-NwkValidator_NetworkIntentRequirement",
                                            "Test-NwkValidator_StorageConnectivityType",
                                            "Test-NwkValidator_StorageVlanFor2NodeSwitchLessDeployment",
                                            "Test-NwkValidator_NetworkGatewayRequirement")

                if (Get-AzStackHciARCGatewaySetting)
                {
                    # Deployment with ArcGateway enabled, will skip Test-NwkValidator_InfraIpPoolReadiness
                    Log-Info -Message "Deployment with ArcGateway enabled, will skip Test-NwkValidator_InfraIpPoolReadiness"
                    $script:envchktestList = $script:envchktestList | Where-Object { $_ -ne "Test-NwkValidator_InfraIpPoolReadiness" }
                }
                Log-Info -Message "Network validator to run: [ $($script:envchktestList -join ', ') ]"
            }
            "AddNode"
            {
                if ($null -eq $callingTestParam.NodeToManagementIPMap)
                {
                    throw "NodeToManagementIPMap parameter is required for AddNode scenario."
                }

                Log-Info -Message "Will check network configuration needed for adding new node(s) into existing cluster"
                $script:envchktestList = @( "Test-NwkValidator_StorageAdapterReadiness",
                                            "Test-NwkValidator_HostNetworkConfigurationReadiness",
                                            "Test-NwkValidator_AdapterDriverMgmtAdapterReadiness",
                                            "Test-NwkValidator_MgmtIpIpPoolRequirement",
                                            "Test-NwkValidator_ClusterNetworkIntentStatus",
                                            "Test-NwkValidator_StorageIntentExistence",
                                            "Test-NwkValidator_NetworkATCFeatureStatusOnNewNode",
                                            "Test-NwkValidator_NetworkGatewayRequirement")

                # 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 "[NetworkValidator][Upgrade] scenario. Only need to run Test-NwkValidator_InfraIpPoolReadiness for non ArcGateway connection type"
                $script:envchktestList = "Test-NwkValidator_InfraIpPoolReadiness"

                if (Get-AzStackHciARCGatewaySetting)
                {
                    # Upgrade with ArcGateway enabled, will skip Test-NwkValidator_InfraIpPoolReadiness
                    Log-Info -Message "Upgrade with ArcGateway enabled, will skip Test-NwkValidator_InfraIpPoolReadiness"
                    $script:envchktestList = $script:envchktestList | Where-Object { $_ -ne "Test-NwkValidator_InfraIpPoolReadiness" }
                }
            }
            "PreUpdate"
            {
                Log-Info -Message "Will check network configuration needed for running a success patch and update operation"
                $script:envchktestList = @( "Test-NwkValidator_HostNetworkConfigurationReadiness",
                                            "Test-NwkValidator_AdapterDriverMgmtAdapterReadiness",
                                            "Test-NwkValidator_ClusterNetworkIntentStatus",
                                            "Test-NwkValidator_StorageAdapterIPConfigurationPreUpdate")
            }
        }
        #endregion

        Log-Info -Message "Network validator to run during [ $($OperationType) ]: [ $($script:envchktestList -join ', ') ]"

        $TotalTestCount = ($script:envchktestList).Count

        if($TotalTestCount -eq 0)
        {
            Log-Info "No test cases need to be run."
            return $result
        }

        # 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 "Parameters used for current validator: [ $test ]"
            foreach ($param in $invokeParameters.GetEnumerator())
            {
                if ($param.Key -ne 'PSSession')
                {
                    Log-Info -Message "Parameter: $($param.Key) = $($param.Value | ConvertTo-Json -Depth 5)"
                }
            }
            $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
# MIIoRgYJKoZIhvcNAQcCoIIoNzCCKDMCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCD5aTKA0FT9/5AY
# XJJnMW6K7yHzHQ1HC0ZxPgIYPi3oaqCCDXYwggX0MIID3KADAgECAhMzAAAEhV6Z
# 7A5ZL83XAAAAAASFMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p
# bmcgUENBIDIwMTEwHhcNMjUwNjE5MTgyMTM3WhcNMjYwNjE3MTgyMTM3WjB0MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
# AQDASkh1cpvuUqfbqxele7LCSHEamVNBfFE4uY1FkGsAdUF/vnjpE1dnAD9vMOqy
# 5ZO49ILhP4jiP/P2Pn9ao+5TDtKmcQ+pZdzbG7t43yRXJC3nXvTGQroodPi9USQi
# 9rI+0gwuXRKBII7L+k3kMkKLmFrsWUjzgXVCLYa6ZH7BCALAcJWZTwWPoiT4HpqQ
# hJcYLB7pfetAVCeBEVZD8itKQ6QA5/LQR+9X6dlSj4Vxta4JnpxvgSrkjXCz+tlJ
# 67ABZ551lw23RWU1uyfgCfEFhBfiyPR2WSjskPl9ap6qrf8fNQ1sGYun2p4JdXxe
# UAKf1hVa/3TQXjvPTiRXCnJPAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE
# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUuCZyGiCuLYE0aU7j5TFqY05kko0w
# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW
# MBQGA1UEBRMNMjMwMDEyKzUwNTM1OTAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci
# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG
# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu
# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0
# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBACjmqAp2Ci4sTHZci+qk
# tEAKsFk5HNVGKyWR2rFGXsd7cggZ04H5U4SV0fAL6fOE9dLvt4I7HBHLhpGdE5Uj
# Ly4NxLTG2bDAkeAVmxmd2uKWVGKym1aarDxXfv3GCN4mRX+Pn4c+py3S/6Kkt5eS
# DAIIsrzKw3Kh2SW1hCwXX/k1v4b+NH1Fjl+i/xPJspXCFuZB4aC5FLT5fgbRKqns
# WeAdn8DsrYQhT3QXLt6Nv3/dMzv7G/Cdpbdcoul8FYl+t3dmXM+SIClC3l2ae0wO
# lNrQ42yQEycuPU5OoqLT85jsZ7+4CaScfFINlO7l7Y7r/xauqHbSPQ1r3oIC+e71
# 5s2G3ClZa3y99aYx2lnXYe1srcrIx8NAXTViiypXVn9ZGmEkfNcfDiqGQwkml5z9
# nm3pWiBZ69adaBBbAFEjyJG4y0a76bel/4sDCVvaZzLM3TFbxVO9BQrjZRtbJZbk
# C3XArpLqZSfx53SuYdddxPX8pvcqFuEu8wcUeD05t9xNbJ4TtdAECJlEi0vvBxlm
# M5tzFXy2qZeqPMXHSQYqPgZ9jvScZ6NwznFD0+33kbzyhOSz/WuGbAu4cHZG8gKn
# lQVT4uA2Diex9DMs2WHiokNknYlLoUeWXW1QrJLpqO82TLyKTbBM/oZHAdIc0kzo
# STro9b3+vjn2809D0+SOOCVZMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq
# 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
# /Xmfwb1tbWrJUnMTDXpQzTGCGiYwghoiAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBIDIwMTECEzMAAASFXpnsDlkvzdcAAAAABIUwDQYJYIZIAWUDBAIB
# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO
# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIIaj62AEzEyE84mqR7/iXsn8
# 5UtNBO6uODyFd3cFrWkBMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A
# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB
# BQAEggEAjkepubkktD9VBObaebZ6LlVLBZxi4twGaX9VuECX7/rfkPswLZIGS/tU
# 84CsIhbxO+DrnoPY8rtEzogidVSv5+ql2NV7Vnki2RWjgNKj/h1SZzmxJsWGISs1
# Zv+FmrNXdfliiFzF0uW95p5hAjfYnt4oK54i5h6+avUg8MI5Cko44/Sabm6LryBw
# BRHgEt9EnI22zgq9jEHmUFUo4Rb2KnwT4aK+5aqvmjmcxzulOxK69Q/U23SgOnYi
# yva75CZCzvYW9wgnCwIjHCtFrV9uee869k/RFq56GgqYcw1OBDMyJcNeTPuQcDwG
# uyNxdMKcDEiYIwRiUyBrmNydD0EQWqGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCC
# F5gGCSqGSIb3DQEHAqCCF4kwgheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsq
# hkiG9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl
# AwQCAQUABCCPE8THipUIoyFnwNzUYVGdaE5UVATdqahEUiFsOOAuiAIGaKOp7zin
# GBMyMDI1MDkwOTE5MjIxNC41MzdaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl
# bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVT
# TjozMjFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg
# U2VydmljZaCCEf4wggcoMIIFEKADAgECAhMzAAAB+KOhJgwMQEj+AAEAAAH4MA0G
# CSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u
# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp
# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI0
# MDcyNTE4MzEwOFoXDTI1MTAyMjE4MzEwOFowgdMxCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9w
# ZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjMyMUEt
# MDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNl
# MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxR23pXYnD2BuODdeXs2C
# u/T5kKI+bAw8cbtN50Cm/FArjXyL4RTqMe6laQ/CqeMTxgckvZr1JrW0Mi4F15rx
# /VveGhKBmob45DmOcV5xyx7h9Tk59NAl5PNMAWKAIWf270SWAAWxQbpVIhhPWCnV
# V3otVvahEad8pMmoSXrT5Z7Nk1RnB70A2bq9Hk8wIeC3vBuxEX2E8X50IgAHsyaR
# 9roFq3ErzUEHlS8YnSq33ui5uBcrFOcFOCZILuVFVTgEqSrX4UiX0etqi7jUtKyp
# gIflaZcV5cI5XI/eCxY8wDNmBprhYMNlYxdmQ9aLRDcTKWtddWpnJtyl5e3gHuYo
# j8xuDQ0XZNy7ESRwJIK03+rTZqfaYyM4XSK1s0aa+mO69vo/NmJ4R/f1+KucBPJ4
# yUdbqJWM3xMvBwLYycvigI/WK4kgPog0UBNczaQwDVXpcU+TMcOvWP8HBWmWJQIm
# TZInAFivXqUaBbo3wAfPNbsQpvNNGu/12pg0F8O/CdRfgPHfOhIWQ0D8ALCY+Lsi
# wbzcejbrVl4N9fn2wOg2sDa8RfNoD614I0pFjy/lq1NsBo9V4GZBikzX7ZjWCRgd
# 1FCBXGpfpDikHjQ05YOkAakdWDT2bGSaUZJGVYtepIpPTAs1gd/vUogcdiL51o7s
# huHIlB6QSUiQ24XYhRbbQCECAwEAAaOCAUkwggFFMB0GA1UdDgQWBBS9zsZzz57Q
# lT5nrt/oitLv1OQ7tjAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBf
# BgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz
# L2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmww
# bAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29m
# dC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El
# MjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUF
# BwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAYfk8GzzpEVnG
# l7y6oXoytCb42Hx6TOA0+dkaBI36ftDE9tLubUa/xMbHB5rcNiRhFHZ93RefdPpc
# 4+FF0DAl5lP8xKAO+293RWPKDFOFIxgtZY08t8D9cSQpgGUzyw3lETZebNLEA17A
# /CTpA2F9uh8j84KygeEbj+bidWDiEfayoH2A5/5ywJJxIuLzFVHacvWxSCKoF9hl
# SrZSG5fXWS3namf4tt690UT6AGyWLFWe895coFPxm/m0UIMjjp9VRFH7nb3Ng2Q4
# gPS9E5ZTMZ6nAlmUicDj0NXAs2wQuQrnYnbRAJ/DQW35qLo7Daw9AsItqjFhbMcG
# 68gDc4j74L2KYe/2goBHLwzSn5UDftS1HZI0ZRsqmNHI0TZvvUWX9ajm6SfLBTEt
# oTo6gLOX0UD/9rrhGjdkiCw4SwU5osClgqgiNMK5ndk2gxFlDXHCyLp5qB6BoPpc
# 82RhO0yCzoP9gv7zv2EocAWEsqE5+0Wmu5uarmfvcziLfU1SY240OZW8ld4sS8fn
# ybn/jDMmFAhazV1zH0QERWEsfLSpwkOXaImWNFJ5lmcnf1VTm6cmfasScYtElpjq
# Z9GooCmk1XFApORPs/PO43IcFmPRwagt00iQSw+rBeIH00KQq+FJT/62SB70g9g/
# R8TS6k6b/wt2UWhqrW+Q8lw6Xzgex/YwggdxMIIFWaADAgECAhMzAAAAFcXna54C
# m0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UE
# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z
# b2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZp
# Y2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMy
# MjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH
# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV
# BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0B
# AQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51
# yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY
# 6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9
# cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN
# 7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDua
# Rr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74
# kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2
# K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5
# TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZk
# i1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9Q
# BXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3Pmri
# Lq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUC
# BBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJl
# pxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIB
# FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9y
# eS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUA
# YgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU
# 1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2Ny
# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIw
# MTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDov
# L3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0w
# Ni0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/yp
# b+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulm
# ZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM
# 9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECW
# OKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4
# FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3Uw
# xTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPX
# fx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVX
# VAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGC
# onsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU
# 5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEG
# ahC0HVUzWLOhcGbyoYIDWTCCAkECAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl
# bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVT
# TjozMjFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg
# U2VydmljZaIjCgEBMAcGBSsOAwIaAxUAtkQt/ebWSQ5DnG+aKRzPELCFE9GggYMw
# gYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD
# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsF
# AAIFAOxqfqgwIhgPMjAyNTA5MDkxMDIzMzZaGA8yMDI1MDkxMDEwMjMzNlowdzA9
# BgorBgEEAYRZCgQBMS8wLTAKAgUA7Gp+qAIBADAKAgEAAgIXJgIB/zAHAgEAAgIT
# ZzAKAgUA7GvQKAIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAow
# CAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUAA4IBAQAOIeSlSzkR
# EuJR+s12DeCz41lQ8W4Ip6S4HsfO5D7rNteCRbXlwl6IRrQ72uaweNjOkdzBgVVZ
# EXDMQXN14ULMIHS4ss5ubJ2h1+OZWFJ6Ksj6o7jGcT8Y9XfR99hdomItDVrONzxb
# Kh/avXUxIkIQfwZCO+46j6A24DDFWKemrtDJEFDs66bE+NETzg2Ognh/UM2GH2Ux
# jUTIkkbecpI0AS2hJWgvRrdiPZHJD604QHHZ1f8qK1rObYXCmslo9TAPcyojtFqv
# IKEqCYO119V4JU00ByF7hcipbsM35zHy6rQMx9iUFq4euWICMZ7ccJGrAo1jzg9k
# aHPiLGayLiAZMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgT
# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m
# dCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB
# IDIwMTACEzMAAAH4o6EmDAxASP4AAQAAAfgwDQYJYIZIAWUDBAIBBQCgggFKMBoG
# CSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQg5F6hO4h5
# gtlVqEekZB5htJD6MsTbwqq6G3kDkSke5dswgfoGCyqGSIb3DQEJEAIvMYHqMIHn
# MIHkMIG9BCDvzDPyXw1UkAUFYt8bR4UdjM90Qv5xnVaiKD3I0Zz3WjCBmDCBgKR+
# MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS
# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT
# HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB+KOhJgwMQEj+AAEA
# AAH4MCIEIFIqISvpmBG+1wV71ZFIFb7SbH7U9P0yj6nwWTXYvMn5MA0GCSqGSIb3
# DQEBCwUABIICALIO2DIMgzt9ugPvfL0nAGeTsQtfM16oSwa+hdz6WZy+SeBbzYHs
# vylwtzaaOu1sR4hA6JUnmrgS1LnZK7TllUXx4f01lNzeLFg6rPsgUJveDKarB74z
# Hm8GvHwH3v3Bax/ykwJ1nBqwICaRvNKObMAM7sP7CAMqov2ZHDWkLDVH6SgUgS6y
# daUeNWNhakike7iHXMs1dfdd6tqYpgAJvylhhRrTAQCnK/9KOJl7ycaVhXNfLoGt
# 4uMq5wyYcGEbDBx2A02AgcTaoMpR5BQdMNnM0vYfujFJfu0jypp1vzLhtBqTAMog
# IiaNQdvbgVfHRDrYB7ZgMwvkD6RiX9gMBjEJMd4vYnoTqNLbwjkoT3k210vxRPfw
# dj63my2IjLZlQDkdwl54QHBS/RH8frbjTQHVKxtMobst7g4CcXQe9ZVaqh0SAiFa
# qRhHvaKnqA0aos9Fs0haQOXcN7aLJvMeh+OKuGzvkEoMQhDo93EsczjO0E6fgm2V
# Zz60Semn7Fy4GSHMIWJPiWTkVA0+s3td46cZb0sC7g7EsG0+bm/jH8EA58wj5l4Y
# +xMbB5S7rujMeesYJxAGd/ddgsAE0nKF4BMqyIbxAd1Qxqlygyv7G09IYTTovNBs
# VFW6Ux3aHUofHWJMmqk3VgehpLOpjwc6FOE9reMTwAoFKp7K7P6Z6wwP
# SIG # End signature block