AzStackHci.EnvironmentChecker

1.2100.2790.560

Obs/bin/ObsAgent/lib/Artifacts/CollectDiagnosticLogsJEA.psm1

                                <#############################################################

 #                                                           #

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

 #                                                           #

 #############################################################>

<#

.SYNOPSIS

Executes collection Diagnostic logs utilizing the JEA endpoint.

.PARAMETER EndpointName

The name of the JEA endpoint to access.

.PARAMETER ComputerName

The name of the computer on which to invoke the endpoint.

.PARAMETER FromDate

The starting window from which to start collection logs.

By default this value is 4 hours before now.

.PARAMETER ToDate

The ending time window for collecting logs.

.PARAMETER IncludeGetSDDCLogs

If true, collect cluster logs.

.PARAMETER FilterByRole

The roles to filter on.

.PARAMETER FilterByNode

The nodes to filter on.

.PARAMETER SupplementaryLogs

The path to supplementary logs to collect

.PARAMETER TimeoutInMinutes

Timeout for gathering log data.

.PARAMETER TracingContext

Value passed to other script so that traces between components can be correlated.

.PARAMETER IsAutonomous

Whether this is an autonomous log collection.

.PARAMETER LogCollectionJobType

Whether the job is OnDemand or Scheduled

.PARAMETER FallbackNotDistributed

If present, log orchestration should collect logs from all nodes in the cluster.

.PARAMETER $SkipTestObservability

If present, log orchestration should skip invoking Test-Observability cmdlet

.OUTPUTS

A result object continating the results of the log collection.

#>

function CollectDiagnosticLogsJEA

{

    Param(

        [Parameter(Mandatory=$true)]

        [ValidateNotNullOrEmpty()]

        [string]

        $EndpointName,

        [Parameter(Mandatory=$true)]

        [ValidateNotNullOrEmpty()]

        [string]

        $ComputerName,

        [Parameter(Mandatory=$false)]

        [nullable[DateTime]]

        $FromDate,

         [Parameter(Mandatory=$false)]

        [nullable[DateTime]]

        $ToDate,

        [Parameter(Mandatory=$false)]

        [Switch]

        $IncludeGetSDDCLogs,

        [Parameter(Mandatory=$false)]

        [string[]]

        $FilterByRole,

        [Parameter(Mandatory=$false)]

        [string[]]

        $FilterByNode,

         [Parameter(Mandatory=$false)]

        [string]

        $SupplementaryLogs,

        [Parameter(Mandatory=$false)]

        [int]

        $TimeoutInMinutes,

        [Parameter(Mandatory=$false)]

        [Guid]

        $TracingContext = [Guid]::Empty,

        [Parameter(Mandatory=$false)]

        [bool]

        $IsAutonomous,

        [Parameter(Mandatory=$false)]

        [string]

        $LogCollectionJobType,

        [Parameter(Mandatory=$false)]

        [Switch]

        $FallbackNotDistributed,

        [Parameter(Mandatory=$false)]

        [bool]

        $SkipTestObservability

    )

    try

    {

        if ($null -eq $FromDate)

        {

            $FromDate = (Get-Date).AddHours(-4)

            Write-Information "FromDate parameter not specified. Setting to default value: $FromDate"

        }

        if ($null -eq $ToDate)

        {

            $ToDate = Get-Date

            Write-Information "ToDate parameter not specified. Setting to default value: $ToDate"

        }

        $logResult = $null

        $arcAEnvironment = (Get-ItemProperty -Path "HKLM:\Software\Microsoft\ArcA\" -ErrorAction SilentlyContinue).IsArcAEnv

        if (-not $FallbackNotDistributed.IsPresent)

        {

            # Import the module (Get-DiagnosticLog)

            $module = Get-ChildItem -Include *Microsoft.AzureStack.Observability.LogOrchestrator.dll -Recurse

            Write-Information "Importing module: $($module.FullName)"

            Import-Module $module.FullName -Force -Verbose

            # Overrides for Arc-A

            if ($arcAEnvironment)

            {

                $IncludeGetSDDCLogsBool = $false

                $LogCollectionJobType = "OnDemand"

                $LocalMode = $true

                $BypassedObsAgent = $true

            }

            else

            {

                $IncludeGetSDDCLogsBool = $IncludeGetSDDCLogs.IsPresent

                $LocalMode = $true

                $BypassedObsAgent = $false

            }

            $getLogParams = @{

                LogCollectionStartTimeUTC = $FromDate

                LogCollectionEndTimeUTC = $ToDate

                IncludeGetSDDCLogs = $IncludeGetSDDCLogsBool

                FilterByRole = $FilterByRole

                FilterByNode = $FilterByNode

                SupplementaryLogs = $SupplementaryLogs

                TimeoutInMinutes = $TimeoutInMinutes

                TracingContext = $TracingContext

                IsAutonomous = $IsAutonomous

                LogCollectionJobType = $LogCollectionJobType

                LocalMode = $LocalMode

                BypassedObsAgent = $BypassedObsAgent

                SkipTestObservability = $SkipTestObservability

            }

            Write-Information "Invoking Get-DiagnosticLog directly on $($env:COMPUTERNAME) with parameters: $($getLogParams | ConvertTo-Json)"

            $logResult = Get-DiagnosticLog @getLogParams

        }

        else

        {

            $getLogParams = @{

                LogCollectionStartTimeUTC = $FromDate

                LogCollectionEndTimeUTC = $ToDate

                IncludeGetSDDCLogs = $IncludeGetSDDCLogs.IsPresent

                FilterByRole = $FilterByRole

                FilterByNode = $FilterByNode

                SupplementaryLogs = $SupplementaryLogs

                TimeoutInMinutes = $TimeoutInMinutes

                TracingContext = $TracingContext

                IsAutonomous = $IsAutonomous

                LogCollectionJobType = $LogCollectionJobType

                LocalMode = !$FallbackNotDistributed.IsPresent

                BypassedObsAgent = $false

                SkipTestObservability = $SkipTestObservability

            }

            $jeaSession = Get-JEASession -Endpoint $EndpointName -ComputerName $ComputerName

            $getLogScript = { param($pHash) Get-DiagnosticLog 6>&1 @pHash }

            Write-Information "Invoking Get-DiagnosticLog via JEA session with parameters: $($getLogParams | ConvertTo-Json)"

            $logResult = Invoke-Command -Session $jeaSession -ScriptBlock $getLogScript -ArgumentList $getLogParams

        }

        if ($null -ne $logResult)

        {

            Write-Information "Get-DiagnosticLog returned: $($logResult | ConvertTo-Json)"

            $genevaResult = @{

                TotalFileCount = $logResult.GenevaConnector_TotalFileCount

                ParsedFileCount = $logResult.GenevaConnector_ParsedFileCount

                FailedFileCount = $logResult.GenevaConnector_FailedFileCount

                SkippedFileCount = $logResult.GenevaConnector_SkippedFileCount

                NotParsableFileCount = $logResult.GenevaConnector_NotParsableFileCount

                ExcludedFileCount = $logResult.GenevaConnector_ExcludedFileCount

                ParsedFileSizeInMB = $logResult.GenevaConnector_ParsedFileSizeInMB

                ElapsedTimeInMinutes = $logResult.GenevaConnector_ElapsedTimeInMinutes

                Failed = $logResult.GenevaConnector_Failed

                Exception = $logResult.GenevaConnector_Exception

            }

            $saveToPathResult = @{

                MoveLogsToOutputPath_Failed = $logResult.MoveLogsToOutputPath_Failed

                MoveLogsToOutputPath_Exception = $logResult.MoveLogsToOutputPath_Exception

            }

            $prepareLogsForParserResult = @{

                PrepareLogsForParser_Failed = $logResult.PrepareLogsForParser_Failed

                PrepareLogsForParser_Exception = $logResult.PrepareLogsForParser_Exception

            }

            return @{

                OverallSuccess = $logResult.OverallSuccess

                IsClusterLogCollectionSuccessful = $logResult.IsGetSddcCollectionSuccessful

                ClusterLogCollectionExceptionMessage = $logResult.GetSddcCollectionException

                IncludeSDDCLogs = $logResult.IncludeSddcLogs

                IsDiagLogCollectionSuccessful = $logResult.IsGetDiagLogCollectionSuccessful

                DiagLogCollectionExceptionMessage = $logResult.GetDiagLogCollectionError

                LogCollectionExceptionMessage = $logResult.Exception

                SupplementaryLogCollectionFailed = $logResult.SupplementaryLogCollection_Failed

                SupplementaryLogCollectionExceptionMessage = $logResult.SupplementaryLogCollection_Exception

                GenevaResults = $genevaResult

                SaveToPathResults = $saveToPathResult

                PrepareLogsForParserResults = $prepareLogsForParserResult

            }

        }

        else

        {

            Write-Error "Get-DiagnosticLog failed to produce a result. Diagnostics data will not be collected."

            return $null

        }

    }

    catch {

        Write-Error "Get-DiagnosticLog failed with exception on $ComputerName with: $_"

        return $null

    }

    finally {

        if ($null -ne $jeaSession) {

            Write-Information "Removing JEA session $($jeaSession.InstanceId)"

            Remove-PSSession $jeaSession

        }

    }

}

<#

.SYNOPSIS

Initializes a JEA PS session.

.DESCRIPTION

Uses the current user's credentials to create a JEA PowerShell session.

.PARAMETER EndpointName

The name of the JEA endpoint.

.PARAMETER ComputerName

The name of the computer on which to invoke the endpoint.

#>

function Get-JEASession {

    Param(

        [Parameter(Mandatory=$true)]

        [ValidateNotNullOrEmpty()]

        [string]

        $EndpointName,

        [Parameter(Mandatory=$true)]

        [ValidateNotNullOrEmpty()]

        [string]

        $ComputerName

    )

    $currentSessions = Get-PSSession -ComputerName $ComputerName -ConfigurationName $EndpointName

    # Remove any existing JEA sessions to this endpoint

    if ($null -ne $currentSessions) {

        # ASK-CEDRICDA-Couldn't we be closing a session that is currently in use?

        Write-Information "Found $($currentSessions.Count) open sessions for $EndpointName" -Verbose

        # TODO-CEDRICDA-Clean up sessions. See code from Hub

    }

    Write-Information "Opening session on $ComputerName with endpoint $EndpointName" -Verbose

    $psSessionOption = New-PSSessionOption -IdleTimeout 60000

    # ASK-CEDRICDA-Are retries necessary? Hub code has it.

    # TODO-CEDRICDA-retries

    $jeaSession = New-PSSession -ComputerName $ComputerName -ConfigurationName $EndpointName -Verbose -SessionOption $psSessionOption -ErrorAction Stop

    return $jeaSession

}

function Get-EndpointExists {

    Param(

        [Parameter(Mandatory=$true)]

        [string]

        $EndpointName

    )

    return $(Get-PSSessionConfiguration -Name $EndpointName -ErrorAction SilentlyContinue)

}

Export-ModuleMember -Function CollectDiagnosticLogsJEA

# SIG # Begin signature block

# MIIoLQYJKoZIhvcNAQcCoIIoHjCCKBoCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDSBsMA0iA8aUIX

# TnCc8xmFoVtDXPyOJH5QoYJwM81EnKCCDXYwggX0MIID3KADAgECAhMzAAADrzBA

# DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA

# hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG

# 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN

# xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL

# go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB

# tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw

# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW

# MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci

# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG

# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0

# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd

# mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ

# 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY

# 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp

# XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn

# TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT

# e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG

# OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O

# PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk

# ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx

# HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt

# CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq

# 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

# /Xmfwb1tbWrJUnMTDXpQzTGCGg0wghoJAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp

# Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB

# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO

# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIAwSefb48KmM2hutpy+wsBLA

# ZV6/PG44kqhye/f+lD8LMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A

# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB

# BQAEggEAdhGWWPWnroB4i5BydY3ac6kxKBHXw/qOgaDBBGUsiZXtTKCFWj7eJuBk

# O06Efaz99wh4T9z249XIyXaAg4iq+2y5rRsRlCzKwDp1iLe2t3ZCNGuOBBO0Mq6w

# hGKaeuSY2Z3HlPbexaAiST7qMjgqVkswS+B6e2Q4EzJmvBNv01kbS022YcMRY4cJ

# 6ot2dx5DNvQ3/oxXB5RzarqzwtqKiN7An+fG6qalSisHelvwXd7nPf+exdB6NX0/

# a5xZFNklIg7H2gBYlJ6JaJ4MjE6HMNc1I0qPhfuPKgALHaWIQmb2taVyGOaj/aCS

# f8Jtlj+wysHOWBTddIeISrkOaJV7l6GCF5cwgheTBgorBgEEAYI3AwMBMYIXgzCC

# F38GCSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsq

# hkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl

# AwQCAQUABCBBbTuFhSCHEcuwzLum89tiNuRhgCZzXVeFFr4DSrc1pwIGZuMqnjtt

# GBMyMDI0MTAwOTAxMTIzNy4wNzZaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l

# cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046MzMwMy0w

# NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Wg

# ghHtMIIHIDCCBQigAwIBAgITMwAAAebZQp7qAPh94QABAAAB5jANBgkqhkiG9w0B

# AQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD

# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yMzEyMDYxODQ1

# MTVaFw0yNTAzMDUxODQ1MTVaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z

# MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046MzMwMy0wNUUwLUQ5NDcxJTAjBgNV

# BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQC9vph84tgluEzm/wpNKlAjcElGzflvKADZ1D+2d/ie

# YYEtF2HKMrKGFDOLpLWWG5DEyiKblYKrE2nt540OGu35Zx0gXJBE0zWanZEAjCjt

# 4eGBi+uakZsk70zHTQHHyfP+B3m2BSSNFPhgsVIPp6vo/9t6OeNezIwX5E5+VwEG

# 37nZgEexQF2fQZYbxQ1AauqDvRdXsSpK1dh1UBt9EaMszuucaR5nMwQN6sDjG99F

# zdK9Atzbn4SmlsoLUtRAh/768sKd0Y1hMmKVHwIX8/4JuURUBRZ0JWu0NYQBp8kh

# ku18Q8CAQ500tFB7VH3pD8zoA4lcA7JkxTGoPKrufm+lRZAA4iMgbcLZ2P/xSdnK

# FxU8vL31RoNlZJiGL5MqTXvvyBLz+MRP4En9Nye1N8x/lJD1stdNo5wJG+mgXsE/

# zfzg2GaVqQczFHg0Nl8bpIqnNFUReQRq3C1jVYMCScegNzHeYtw5OmZ/7eVnRmjX

# lCsLvdsxOzc1YVn6nZLkQD5y31HYrB9iIHuswhaMv2hJNNjVndkpWy934PIZuWTM

# k360kjXPFwl2Wv1Tzm9tOrCq8+l408KIL6J+efoGNkR8YB3M+u1tYeVDO/TcObGH

# xaGFB6QZxAUpnfB5N/MmBNxMOqzG1N8QiwW8gtjjMJiFBf6iYYrCjtRwF7IPdQLF

# tQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFOUEMXntN54+11ZM+Qu7Q5rg3Fc9MB8G

# A1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCG

# Tmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUy

# MFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4w

# XAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2Vy

# dHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwG

# A1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQD

# AgeAMA0GCSqGSIb3DQEBCwUAA4ICAQBhbuogTapRsuwSkaFMQ6dyu8ZCYUpWQ8iI

# rbi40tU2hK6pHgu0hj0z/9zFRRx5DfhukjvbjA/dS5VYfxz1EIbPlt897MJ2sBGO

# 2YLYwYelfJpDwbB0XS9Zkrqpzq6X/lmDQDn3G5vcYpYQCJ55LLvyFlJ195AVo4Wy

# 8UX5p7g9W3MgNHQMpM+EV64+cszj4Ho5aQmeKGtKy7w72eRY/vWDuptrvzruFNmK

# CIt12UcA5BOsXp1Ptkjx2yRsCj77DSml0zVYjqW/ISWkrGjyeVJ+khzctxaLkklV

# wCxigokD6fkWby0hCEKTOTPMzhugPIAcxcHsR2sx01YRa9pH2zvddsuBEfSFG6Cj

# 0QSvEZ/M9mJ+h4miaQSR7AEbVGDbyRKkYn80S+3AmRlh3ZOe+BFqJ57OXdeIDSHb

# vHzJ7oTqG896l3eUhPsZg69fNgxTxlvRNmRE/+61Yj7Z1uB0XYQP60rsMLdTlVYE

# yZUl5MLTL5LvqFozZlS2Xoji4BEP6ddVTzmHJ4odOZMWTTeQ0IwnWG98vWv/roPe

# gCr1G61FVrdXLE3AXIft4ZN4ZkDTnoAhPw7DZNPRlSW4TbVj/Lw0XvnLYNwMUA9o

# uY/wx9teTaJ8vTkbgYyaOYKFz6rNRXZ4af6e3IXwMCffCaspKUXC72YMu5W8L/zy

# TxsNUEgBbTCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZI

# hvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# MjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAy

# MDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC

# AQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25Phdg

# M/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPF

# dvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6

# GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBp

# Dco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50Zu

# yjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3E

# XzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0

# lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1q

# GFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ

# +QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PA

# PBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkw

# EgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxG

# NSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARV

# MFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj

# cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK

# BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC

# AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX

# zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v

# cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI

# KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG

# 9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0x

# M7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmC

# VgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449

# xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wM

# nosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDS

# PeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2d

# Y3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxn

# GSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+Crvs

# QWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokL

# jzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL

# 6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNQ

# MIICOAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp

# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw

# b3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEn

# MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjMzMDMtMDVFMC1EOTQ3MSUwIwYDVQQD

# ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQDi

# WNBeFJ9jvaErN64D1G86eL0mu6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6q/tpDAiGA8yMDI0MTAwODE3NDMw

# MFoYDzIwMjQxMDA5MTc0MzAwWjB3MD0GCisGAQQBhFkKBAExLzAtMAoCBQDqr+2k

# AgEAMAoCAQACAhLsAgH/MAcCAQACAhxQMAoCBQDqsT8kAgEAMDYGCisGAQQBhFkK

# BAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJ

# KoZIhvcNAQELBQADggEBAFBXawmpTeQHNvTCPLCes7Ip/Il4zRhbeUS3PQcdvyEX

# LNNQ41qqERIpnuEi6j7hYrk+5505RzeeDCwgF0Ya9OJFo/C+HG9sGHW70HGM4MwZ

# K1GucZpUqYWWfxtreNHJxEvD9Xrf/Sf1kLrUcMC3mlQZ0fyHn7E6chVIkMI1pKmd

# +9yiDVvmtTTYg7DZPutyDTQhsSeA8wwP4/xAVeQ8ZnpaEQzWiYCSTxiMBqkOUJxi

# Qc0a8xC3soKF6sgGzOSQ1g9OgXgPXBbsLjpwe/apoQn7mxV/U/mbfoashqbheP+6

# I46Yupa8ttj5owNZVxBXHdOa9I0L2nLM2qHqMLPoukQxggQNMIIECQIBATCBkzB8

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N

# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAebZQp7qAPh94QABAAAB

# 5jANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEE

# MC8GCSqGSIb3DQEJBDEiBCB2Na4X972k3Fzw2iLEh1l2f5KsMo9eRAx9mDD/C6Bo

# mzCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIM+7o4aoHrMJaG8gnLO1q16h

# IYcRnoy6FnOCbnSD0sZZMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgT

# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB

# IDIwMTACEzMAAAHm2UKe6gD4feEAAQAAAeYwIgQglBVHuSb6Tx5fXLiQOTq4WA92

# 3mcexl4Hp+qk57G9TrUwDQYJKoZIhvcNAQELBQAEggIAstn+ek9UdXMt2Un54TED

# dK/MHZqhpVMRvBD9KxTLRIARHJAG2geWn8aBfwx6goiPQap36KgixzalzYIfOZtd

# 2qMkkmpAxjp0RSo8/4D54zQMJ1b/WvK7kwCM8qLP32nf8kqjyYhCY4DaNGJHx0d/

# ySU52C9cahdaPie/RIRydAPjcV6VcwgAqRGrjsa83wfwJ6mR4T1YZdnhUltVi46T

# zgfY7XbYLO+AtwvGbZ1KGKKOQluvg+9a19Aaf+prZs386CqW9SNw3XCgiHL52tCj

# AZgOGETIfKf4gvlzDEu63Tp92AgKDKubwGDWSBzh5mRvUF+tn9utT5voLGdhaOV9

# +eirHwDHE5JdrZJQALTJumtDGpbBaaDZpnzq6ntRicHC0zuWTcIFiJeerOHhYCZw

# vUwoiC+nQ4T1M4jLrgtN/HPB3CojrlbQkEjsFOYg2rf1+oZuqO1euHfTUJc0ikDd

# Vq+4kL5V9+J5xzTvinmw755Q6tBKl1hezG9uJvgxzaUXG6VGy+9lYNg/4K4PMsX1

# l76jNUzdNnauEOZ+wUFN/kxBiY2bvV+RNzYkIgEoYguOzIx6ZS4rH6l6PfuwtO3d

# geM5sJbRNBArX9wfSgzVQzNcBHqVekvgUMpwLB/tkhtCJ28QW3ORRiNF3LXH11ow

# 7NYbUvQ1rnIns9ilEZZHPOg=

# SIG # End signature block