AzStackHci.EnvironmentChecker

1.2100.2321.143

AzStackHciObservability/AzStackHci.Observability.Helpers.psm1

                                Import-LocalizedData -BindingVariable lvsTxt -FileName AzStackHci.Observability.Strings.psd1

class HealthModel

{

    # Attributes for Azure Monitor schema

    [string]$Name #Name of the individual test/rule/alert that was executed. Unique, not exposed to the customer.

    [string]$Title #User-facing name; one or more sentences indicating the direct issue.

    [string]$Severity #Severity of the result (Critical, Warning, Informational, Hidden) - this answers how important the result is. Critical is the only update-blocking severity.

    [string]$Description #Detailed overview of the issue and what impact the issue has on the stamp.

    [psobject]$Tags #Key-value pairs that allow grouping/filtering individual tests. For example, "Group": "ReadinessChecks", "UpdateType": "ClusterAware"

    [string]$Status #The status of the check running (i.e. Failed, Succeeded, In Progress) - this answers whether the check ran, and passed or failed.

    [string]$Remediation #Set of steps that can be taken to resolve the issue found.

    [string]$TargetResourceID #The unique identifier for the affected resource (such as a node or drive).

    [string]$TargetResourceName #The name of the affected resource.

    [string]$TargetResourceType #The type of resource being referred to (well-known set of nouns in infrastructure, aligning with Monitoring).

    [datetime]$Timestamp #The Time in which the HealthCheck was called.

    [psobject[]]$AdditionalData #Property bag of key value pairs for additional information.

    [string]$HealthCheckSource #The name of the services called for the HealthCheck (I.E. Test-AzureStack, Test-Cluster).

}

class AzStackHciObservabilityVolumeTarget : HealthModel

{

    # Attribute for performing check

    [string]$ExpectedObservabilityVolumeSize

    [string]$CurrentObservabilityVolumeSize

}

class AzStackHciObservabilityRemoteSupportTarget : HealthModel

{

    #Additional Attribute

    [string]$RemoteSupportSessionEndTime

    [string]$RemoteSupportSessionStartTime

    [string]$RemoteSupportSessionNodeName

}

class AzStackHciObservabilityLogCollectionTarget : HealthModel {}

function Test-ObservabilityVolume

{

    <#

    .SYNOPSIS

        Check volume free space meets the required observability threshold size

    .DESCRIPTION

        Check volume free space meets the required observability threshold size

    .PARAMETER PsSession

        Specify the PsSession(s) used to validation from.

    .PARAMETER OperationType

        Specify the Operation Type to target for observability validation. e.g. Deployment, Update, etc

    .PARAMETER PhysicalDriveLetter

        Specify PhysicalDriveLetter used to validation observability Volume. Default C drive is used as observability volume.

    #>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $true)]

        [System.Management.Automation.Runspaces.PSSession[]]

        $PsSession,

        [Parameter(Mandatory = $false)]

        [string[]]

        $OperationType,

        [Parameter(Mandatory=$false, ParameterSetName="DefaultSet")]

        [string] $PhysicalDriveLetter = "C"

    )

    try

    {

        $defalutHC4ObservabilityVolumeSize = 40

        $defalutVMObservabilityVolumeSize = 30

        Log-Info -Message ($lvsTxt.ObservabilityVolumeStartInfo) -Type Info

        Log-Info -Message ($lvsTxt.ObservabilityVolumeDriveInfo -f $PhysicalDriveLetter)

        $lowDiskMsg = ($lvsTxt.LowDiskSpaceMsg -f $PhysicalDriveLetter)

        # Scriptblock to test observabilityVolumeSize on each server

        $testVolumeSb = {

            $AdditionalData = @()

            $status = "Succeeded"

            $errorMsg = $null

            $hardwareType = $null

            $expectedObservabilityVolumeSizeInGB = $args[0]

            $freeSpaceInGB = 1

            $resource = $null

            try

            {

                # Check if env is Virtual

                $hardwareType = (Get-WmiObject -Class Win32_ComputerSystem).Model

                if ($hardwareType -eq "Virtual Machine")

                {

                    $expectedObservabilityVolumeSizeInGB = $args[1]

                }

                # Check free space on physical volume

                $totalFreeSpace = (Get-Volume -DriveLetter $args[2]).SizeRemaining

                $freeSpaceInGB = [int]($totalFreeSpace / 1GB)

                if ($freeSpaceInGB -lt $expectedObservabilityVolumeSizeInGB)

                {

                    $resource = "Observability volume '$($args[2])' needs, $($expectedObservabilityVolumeSizeInGB) GB free space."

                    throw $args[3]

                }

            }

            catch

            {

                $errorMsg = $_.Exception.Message

                $resource = "Error occurred in Environment Validator Observability Volume test."

                $status = "Failed"

            }

            finally

            {

                $AdditionalData += New-Object -TypeName PsObject -Property @{

                    HardwareType  = $hardwareType

                    ExpectedObservabilityVolumeSize = $expectedObservabilityVolumeSizeInGB

                    CurrentObservabilityVolumeSize = $freeSpaceInGB

                    Status    = $status

                    Source    = $ENV:COMPUTERNAME

                    Resource  = $resource

                    Detail    = $errorMsg

                }

            }

            return $AdditionalData

        }

        # Run scriptblock

        $observabilityVolumeSizeResult = Invoke-Command -Session $PsSession -ScriptBlock $testVolumeSb -ArgumentList $defalutHC4ObservabilityVolumeSize, $defalutVMObservabilityVolumeSize, $PhysicalDriveLetter, $lowDiskMsg

        # build result

        $now = [datetime]::UtcNow

        $targetComputerName = if ($PsSession.PSComputerName) { $PsSession.PSComputerName } else { $ENV:COMPUTERNAME }

        $aggregateStatus = if ($observabilityVolumeSizeResult.Status -contains 'Succeeded') { 'Succeeded' } else { 'Failed' }

        $volumeResult = New-Object -Type AzStackHciObservabilityVolumeTarget -Property @{

            Name               = 'AzStackHci_Observability_Volume'

            Title              = 'Observability Volume Requirement'

            Severity           = 'Critical'

            Description        = 'Test to check observability volume size requirement is met'

            Tags               =  $OperationType

            Remediation        = 'Free up disk space for Observability Volume'

            TargetResourceID   = $targetComputerName

            TargetResourceName = $targetComputerName

            TargetResourceType = $observabilityVolumeSizeResult.HardwareType | Get-Unique

            Timestamp          = $now

            Status             = $aggregateStatus

            AdditionalData     = $observabilityVolumeSizeResult

            HealthCheckSource  = $ENV:EnvChkrId

            ExpectedObservabilityVolumeSize = $observabilityVolumeSizeResult.ExpectedObservabilityVolumeSize

            CurrentObservabilityVolumeSize = $observabilityVolumeSizeResult.CurrentObservabilityVolumeSize

        }

        return $volumeResult

    }

    catch

    {

        throw $_

    }

}

function Test-LogCollection

{

    <#

    .SYNOPSIS

        Check log collection component mets observability condition for update\upgrade

    .DESCRIPTION

        Check if log collection is in progress, if yes then indicate result with Warning

    .PARAMETER PsSession

        Specify the PsSession used to validation from.

    .PARAMETER OperationType

        Specify the Operation Type to target for observability validation. e.g. Deployment, Update, etc

    #>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $true)]

        $PsSession,

        [Parameter(Mandatory = $false)]

        [string[]]

        $OperationType

    )

    try

    {

        Log-Info -Message ($lvsTxt.LogCollectiontInfo) -Type Info

        $logCollectiontErrMsg = $($lvsTxt.LogCollectiontInfo)

        # Scriptblock to check log collection status

        $testlogCollectionSb = {

            $AdditionalData = @()

            $status = 'Succeeded'

            $errorMsg = $null

            $hardwareType = $null

            $logCollectionTime = $null

            $logCollectionStatus = $null

            $resource = $null

            try

            {

                # Get HardwareType

                    $hardwareType = (Get-WmiObject -Class Win32_ComputerSystem).Model

                    # Check check log collection status

                    $logCollectionHistory = Get-LogCollectionHistory -Verbose:$false -ErrorAction SilentlyContinue

                    if ($logCollectionHistory -ne $null `

                         -and $logCollectionHistory[0] -ne $null `

                         -and $logCollectionHistory[0].Status -eq "Running")

                    {

                        $logCollectionTime = $logCollectionHistory[0].TimeCollected

                        $logCollectionStatus = $logCollectionHistory[0].Status

                        $status = 'Failed'

                        $resource = "Log Collection in progress"

                        throw $args[0]

                    }

            }

            catch

            {

                $errorMsg = $_.Exception.Message

                $resource = "Error occurred in Environment Validator Log Collection test."

                $status = 'Failed'

            }

            finally

            {

                $AdditionalData += New-Object -TypeName PsObject -Property @{

                    LogCollectionTime = $logCollectionTime

                    LogCollectionStatus = $logCollectionStatus

                    HardwareType  = $hardwareType

                    Status    = $status

                    Source    = $ENV:COMPUTERNAME

                    Resource  = $resource

                    Detail    = $errorMsg

                }

            }

            return $AdditionalData

        }

        # Run scriptblock

        $logCollectionResult = Invoke-Command -Session $PsSession -ScriptBlock $testlogCollectionSb -ArgumentList $logCollectiontErrMsg

        # build result

        $now = [datetime]::UtcNow

        $targetComputerName = if ($PsSession.PSComputerName) { $PsSession.PSComputerName } else { $ENV:COMPUTERNAME }

        $aggregateStatus = if ($logCollectionResult.Status -contains 'Succeeded') { 'Succeeded' } else { 'Failed' }

        $logCollectionResultSet = New-Object -Type AzStackHciObservabilityLogCollectionTarget -Property @{

            Name               = 'AzStackHci_Observability_LogCollection'

            Title              = 'Observability Log collection Requirement'

            Severity           = 'Warning'

            Description        = 'Test to check observability log collection requirement is met'

            Tags               =  $OperationType

            Remediation        = 'Stop or Wait for log collection to be completed'

            TargetResourceID   = $targetComputerName

            TargetResourceName = $targetComputerName

            TargetResourceType = $logCollectionResult.HardwareType | Get-Unique

            Timestamp          = $now

            Status             = $aggregateStatus

            AdditionalData     = $logCollectionResult

            HealthCheckSource  = $ENV:EnvChkrId

        }

        return $logCollectionResultSet

    }

    catch

    {

        throw $_

    }

}

function Test-RemoteSupport

{

    <#

    .SYNOPSIS

        Test Remote Support Session Terminal is active

    .DESCRIPTION

        Test if active Remote Support Session is in progress

    .PARAMETER PsSession

        Specify the PsSession used to validation from.

    .PARAMETER OperationType

        Specify the Operation Type to target for observability validation. e.g. Deployment, Update, etc

    #>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $true)]

        $PsSession,

        [Parameter(Mandatory = $false)]

        [string[]]

        $OperationType

    )

    try

    {

        Log-Info -Message ($lvsTxt.RemoteSupportStartInfo) -Type Info

        $remoteSupportErrMsg = $($lvsTxt.RemoteSupportErrMsg)

        # Scriptblock to check remote support status

        $remoteSupportSessionSb = {

            $AdditionalData = @()

            $status = 'Succeeded'

            $errorMsg = $null

            $hardwareType = $null

            $nodeName  = $null

            $startTime = $null

            $endTime = $null

            $resource = $null

            try

            {

                # Get HardwareType information

                $hardwareType = (Get-WmiObject -Class Win32_ComputerSystem).Model

                # Check remote support access state

                $getRemoteSupportAccessState = $(Get-AzStackHCIRemoteSupportAccess -Verbose:$false -ErrorAction SilentlyContinue).State

                if ($getRemoteSupportAccessState -eq "Active")

                {

                    $remoteSupportSessionHistory = Get-AzStackHCIRemoteSupportSessionHistory -Verbose:$false -ErrorAction SilentlyContinue | where { $_.EndTime -gt $(Get-Date) }

                    if ($remoteSupportSessionHistory -ne $null -and $($remoteSupportSessionHistory.count) -gt 0)

                    {

                        $startTime = $remoteSupportSessionHistory.StartTime

                        $endTime = $remoteSupportSessionHistory.EndTime

                        $nodeName = $remoteSupportSessionHistory.NodeName

                        $status = 'Failed'

                        $resource = "Open Remote Support Session terminal."

                        throw $args[0]

                    }

                }

            }

            catch

            {

                $errorMsg = $_.Exception.Message

                $resource = "Error occurred in Environment Validator Remote Support test."

                $status = 'Failed'

            }

            finally

            {

                $AdditionalData += New-Object -TypeName PsObject -Property @{

                    HardwareType  = $hardwareType

                    Status    = $status

                    RemoteSupportSessionEndTime  = $endTime

                    RemoteSupportSessionStartTime = $startTime

                    RemoteSupportSessionNodeName = $nodeName

                    Source = $ENV:COMPUTERNAME

                    Resource = $resource

                    Detail = $errorMsg

                }

            }

            return $AdditionalData

        }

        # Run scriptblock

        $remoteSupportSessionResult = Invoke-Command -Session $PsSession -ScriptBlock $remoteSupportSessionSb -ArgumentList $remoteSupportErrMsg

        # build result

        $now = [datetime]::UtcNow

        $targetComputerName = if ($PsSession.PSComputerName) { $PsSession.PSComputerName } else { $ENV:COMPUTERNAME }

        $aggregateStatus = if ($remoteSupportSessionResult.Status -contains 'Succeeded') { 'Succeeded' } else { 'Failed' }

        $remoteSupportSessionSet = New-Object -Type AzStackHciObservabilityRemoteSupportTarget -Property @{

            Name               = 'AzStackHci_Observability_RemoteSupport'

            Title              = 'Observability RemoteSupport Requirement'

            Severity           = 'Critical'

            Description        = 'Test to check observability RemoteSupport requirement is met'

            Tags               =  $OperationType

            Remediation        = 'Active remote session terminal is open, please contact Microsoft Support.'

            TargetResourceID   = $targetComputerName

            TargetResourceName = $targetComputerName

            TargetResourceType = $remoteSupportSessionResult.HardwareType | Get-Unique

            Timestamp          = $now

            Status             = $aggregateStatus

            AdditionalData     = $remoteSupportSessionResult

            RemoteSupportSessionEndTime  = $remoteSupportSessionResult.RemoteSupportSessionEndTime

            RemoteSupportSessionStartTime = $remoteSupportSessionResult.RemoteSupportSessionStartTime

            RemoteSupportSessionNodeName = $remoteSupportSessionResult.RemoteSupportSessionNodeName

            HealthCheckSource = $ENV:EnvChkrId

        }

        return $remoteSupportSessionSet

    }

    catch

    {

        throw $_

    }

}

Export-ModuleMember -Function Test-ObservabilityVolume

Export-ModuleMember -Function Test-LogCollection

Export-ModuleMember -Function Test-RemoteSupport

# SIG # Begin signature block

# MIInkwYJKoZIhvcNAQcCoIInhDCCJ4ACAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCMEVjoVk84OcBo

# r0/CmVGkSsTtnSMpHcqTweJu0EiquaCCDXYwggX0MIID3KADAgECAhMzAAADTrU8

# esGEb+srAAAAAANOMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjMwMzE2MTg0MzI5WhcNMjQwMzE0MTg0MzI5WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDdCKiNI6IBFWuvJUmf6WdOJqZmIwYs5G7AJD5UbcL6tsC+EBPDbr36pFGo1bsU

# p53nRyFYnncoMg8FK0d8jLlw0lgexDDr7gicf2zOBFWqfv/nSLwzJFNP5W03DF/1

# 1oZ12rSFqGlm+O46cRjTDFBpMRCZZGddZlRBjivby0eI1VgTD1TvAdfBYQe82fhm

# WQkYR/lWmAK+vW/1+bO7jHaxXTNCxLIBW07F8PBjUcwFxxyfbe2mHB4h1L4U0Ofa

# +HX/aREQ7SqYZz59sXM2ySOfvYyIjnqSO80NGBaz5DvzIG88J0+BNhOu2jl6Dfcq

# jYQs1H/PMSQIK6E7lXDXSpXzAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUnMc7Zn/ukKBsBiWkwdNfsN5pdwAw

# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW

# MBQGA1UEBRMNMjMwMDEyKzUwMDUxNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci

# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG

# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0

# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAD21v9pHoLdBSNlFAjmk

# mx4XxOZAPsVxxXbDyQv1+kGDe9XpgBnT1lXnx7JDpFMKBwAyIwdInmvhK9pGBa31

# TyeL3p7R2s0L8SABPPRJHAEk4NHpBXxHjm4TKjezAbSqqbgsy10Y7KApy+9UrKa2

# kGmsuASsk95PVm5vem7OmTs42vm0BJUU+JPQLg8Y/sdj3TtSfLYYZAaJwTAIgi7d

# hzn5hatLo7Dhz+4T+MrFd+6LUa2U3zr97QwzDthx+RP9/RZnur4inzSQsG5DCVIM

# pA1l2NWEA3KAca0tI2l6hQNYsaKL1kefdfHCrPxEry8onJjyGGv9YKoLv6AOO7Oh

# JEmbQlz/xksYG2N/JSOJ+QqYpGTEuYFYVWain7He6jgb41JbpOGKDdE/b+V2q/gX

# UgFe2gdwTpCDsvh8SMRoq1/BNXcr7iTAU38Vgr83iVtPYmFhZOVM0ULp/kKTVoir

# IpP2KCxT4OekOctt8grYnhJ16QMjmMv5o53hjNFXOxigkQWYzUO+6w50g0FAeFa8

# 5ugCCB6lXEk21FFB1FdIHpjSQf+LP/W2OV/HfhC3uTPgKbRtXo83TZYEudooyZ/A

# Vu08sibZ3MkGOJORLERNwKm2G7oqdOv4Qj8Z0JrGgMzj46NFKAxkLSpE5oHQYP1H

# tPx1lPfD7iNSbJsP6LiUHXH1MIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq

# 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

# /Xmfwb1tbWrJUnMTDXpQzTGCGXMwghlvAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp

# Z25pbmcgUENBIDIwMTECEzMAAANOtTx6wYRv6ysAAAAAA04wDQYJYIZIAWUDBAIB

# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO

# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIKgzmwethWIoB8Ors0VFW/7E

# Lbgpf2b/STph3+IL5y6wMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A

# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB

# BQAEggEAuis48Ne90MXH2k5hoDqo5R2M4ICK1bh8cxfmBGjoZtE5yDZf8XowDZzS

# BoD82eREVu36JNh9Aw29uEsYLfKgY/qRg4+259iXQb5fytykvzogYMlqr2oPiZJY

# GLc3zpxr4Gr+FEWGBWHBUGkfuXmSK7LYm59PMpjiPVPEL6t6Hhm/mD58aGm7DUOS

# U3lnO6dxeeRjmoW6PnXh1GEWy22ofh32r0fuxokqZeOTWVNdItewuitiVh4Vdo+w

# G2x1ORGhxS7wk3He0Y0oI0zXsRKNPH8X/3oKqFQnhwnIr/ytZacNr1guVIGxJD7u

# EkiaO5im4dtE1prGzbMLw09X4hgVtaGCFv0wghb5BgorBgEEAYI3AwMBMYIW6TCC

# FuUGCSqGSIb3DQEHAqCCFtYwghbSAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFRBgsq

# hkiG9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl

# AwQCAQUABCD5XyIjfgzf4VaLI7PvydHwmytSkJvImcBBqth4mJoHZgIGZDfqlU2l

# GBMyMDIzMDUxMDE2NTkwMy4zNzRaMASAAgH0oIHQpIHNMIHKMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l

# cmljYSBPcGVyYXRpb25zMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjpFQUNFLUUz

# MTYtQzkxRDElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCC

# EVQwggcMMIIE9KADAgECAhMzAAABw4tv00i/DpFdAAEAAAHDMA0GCSqGSIb3DQEB

# CwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV

# BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTIyMTEwNDE5MDEy

# OVoXDTI0MDIwMjE5MDEyOVowgcoxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMx

# JjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOkVBQ0UtRTMxNi1DOTFEMSUwIwYDVQQD

# ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF

# AAOCAg8AMIICCgKCAgEAu+u86s3R/q+ikos80aD42Ym21NDOZtldNRxMFUxm4o9k

# VWkSh2c8jOCxJXwV2KFodCTxpGQs9jy5nUI+Lq/bt0HWtSYPMPPtet420gzwM1Es

# R26kbpwlBHxFY4hk3y3AH+1YKf9bhvPs7kPbXbH7gdaciteB+F7FoORt9e0D/dsB

# eG80GZAF2y6LWAj6C2mMqlafXkwbfTyQanuX65Yu+xMpyJ1fAREpuR766rePrqlE

# 0KaaeD0nqOgGrTkSZeCMDPH6OtJ00jXMwbIDyH7l4fYReIsTfzN5Gf3Uairsjea+

# KFy22lU8elnIXjoeyx3pcesH+q5arY1c6HPfeSnkeMok/gxnB7P1Mjt7I9EI9thQ

# tMvy/1SUmLG12rBR/DfheE/VJpcm/TYeoV11NfQQnl/jBbPbSRBp0HGqTIcWDpY6

# MgSdBoQET1DvpE4PX4sndNGc1wGyg45pH62ZMfUF/CzGZ7iV637RtnQFXDzTxoSE

# EkdXMdWDJG+jjxoC16lRk1xFnfkA4uoma4mKso7qvE6d27+K6yzISWQ7TjutYLKJ

# nSzNvfiNiuyv/0xxCASSARvOQ3v9cegvM/pnuU9c6s+4gmK3+5jhcvnWGQqJE0tp

# YHmk3bmmBL1gHm9TjBJz5m/8rvHM3Rw3OUhV4/wmAL32KmPR5Ubb4ww5HNGiuY0C

# AwEAAaOCATYwggEyMB0GA1UdDgQWBBQcGL7N2NdvAaK8TcLrxMTsa8aB1jAfBgNV

# HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o

# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU

# aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG

# CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz

# L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV

# HRMBAf8EAjAAMBMGA1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3DQEBCwUAA4IC

# AQDd8qZbHBqdBFRDxGGwDollnRyd0WmUnjqoP+5QCH4vMPBt4umHVhJuyeRkDELk

# TWZuWqK3U1z2HnGatbnETcHUlywlH+3I7R7fU0zKYw2PLA+VawCcrnsICgE3242E

# sEC/Z0YU740NJ/xbuzrGtTEtUIiQvr2ACPJyhsPote8ItTf4uNW4Mbo1QP0tjcBK

# CgEezIC4DYUM0BYCWCmeZmNwAlxfpTliOFEKB9UaSqHSs51cH8JY0gqL3LwI9LYf

# jEO77++HY/nMqXCMi9ihUKoIp2Tfjfzdm5Ng5V+yw8+wXl29RcW4Q4CvHntNfKxT

# 9oQ3J7YBQQEHWJPg8TNR9w4B82FzmrDd8sL6ETvGux5hFcwmF+Q2rT5Ma8dYUSdC

# Sg/ihoEYUGJZnZL9nyDp1snflSVX7FpLyALzDDlHBW1CJhYVffJRoqz1D4kRooqR

# BNRaMFMPingywwbEghMheJKNoda7AGgq+1HH1afRlE+9qYW9FKMezxeQmf8gcuAu

# hr9IAXyaF9DF0PJ5f4uhzOSvIC1BkJtzF6op45UYaI7V+9X8dcwXbZJnIIAH1cjV

# O8KEChxKIkpk4Qgy0PocgUwaGWqmLWRu1hQ1WJWnQXvvBYeYDGWbj/PtSlywv6m8

# mujLepfMvJcU25KWklSP2FuNx6aOVfeje+pgbwIQIVQ1nTCCB3EwggVZoAMCAQIC

# EzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoX

# DTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0

# b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3Jh

# dGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIi

# MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC

# 0/3unAcH0qlsTnXIyjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VG

# Iwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP

# 2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/P

# XfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361

# VI/c+gVVmG1oO5pGve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwB

# Sru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9

# X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269e

# wvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDw

# wvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr

# 9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+e

# FnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAj

# BgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+n

# FV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEw

# PwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9j

# cy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3

# FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAf

# BgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBH

# hkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNS

# b29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUF

# BzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0Nl

# ckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4Swf

# ZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTC

# j/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu

# 2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/

# GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3D

# YXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbO

# xnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqO

# Cb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I

# 6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0

# zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaM

# mdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNT

# TY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggLLMIICNAIBATCB+KGB0KSBzTCByjEL

# MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v

# bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWlj

# cm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEmMCQGA1UECxMdVGhhbGVzIFRTUyBF

# U046RUFDRS1FMzE2LUM5MUQxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVAPEdL+Ps+h03e+SLXdGzuY7tLu7OoIGD

# MIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG

# A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEF

# BQACBQDoBgANMCIYDzIwMjMwNTEwMTkzNTQxWhgPMjAyMzA1MTExOTM1NDFaMHQw

# OgYKKwYBBAGEWQoEATEsMCowCgIFAOgGAA0CAQAwBwIBAAICDAQwBwIBAAICEe8w

# CgIFAOgHUY0CAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgC

# AQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQAf+NdV5oR2LRCQ

# 6s8CB/OIcn/XJyBrd+IMHEKuoTRJcnfPQqXOSPvl4475U4jvSCLY+rjIDGJOmK2Q

# VvApnrtINc4vQ2YzwfbLb4zhsvAG7oDUalT3RX2MNooyX5n+3v8wWpWxIlryz4g5

# GgFYvoz6gK2nd65ra7HY7n7jVmBz1DGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABw4tv00i/DpFdAAEAAAHDMA0GCWCGSAFl

# AwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcN

# AQkEMSIEIHTK8ozGEWwuzlEAC6mEY61wRqaiMh/wCg6pyCLwsowvMIH6BgsqhkiG

# 9w0BCRACLzGB6jCB5zCB5DCBvQQg0vtTm2+SSerh1KiAkwrJTALxTfJotlPcDZ2Z

# Sn78KkkwgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAA

# AcOLb9NIvw6RXQABAAABwzAiBCCXIK2xFh4j+aV3zavDOfmyVrkuB3yEAlam/1tL

# DtpcRTANBgkqhkiG9w0BAQsFAASCAgC4CU3zAzo8Tim3zeTCgmKpH1mSlwuu/s1t

# fjMNLqc5UM0mN+7JqwA40/ksm3auFDsbkVldzC6urYXpUFLzFeSnlpEiLX/6EyvC

# QzWBE/Bsi7snWAm1LnAwW8VqG2W5S3Me2IiUPKKopYdLVndLAEiJPG8N4cZ0LdIg

# OhxQ1Hg5bnwAqxIGmv47LduDcO1T+GwRMCIgCKZX3QskWMNxQuR6zhNYUCF3FdCA

# BpGvCK+NIyxQ/gqva8XeEx5mqRqoY5Kv52mOIMgGu5kwvgALDOqOrvuyfhW91oV4

# 4JFWs+Pu3IKNtfRqFSa/Cg0YlSiDkLTaYXbeXqPnCHgguvNBi4xivIz2bG6GWgyE

# 1UXNCm/pRyjZfpxwf5jmE54Su3t2WOKQZv36AboaCUSrfjic04rspw1/AoqRma8Q

# m2CS36V6It+Miu01T/2aARCc59M7daTrM5kBGwxdLa562cGqQb1hMXLCOOnj44hd

# VSDopTq5iCh32N/t+8W15Z847e3uOMtLD2W9OiJRwhD7q74SyCFjS79oodqFbWbz

# gKH4kEWmGnwAZneaHlp859AhgRqY2rO1CDzXi376Ih4GeezV9x7SPAdKJlG7STpw

# p1F4blh87phdkE6lU7cTq0yIvEsGbYtMeFjSN9/17jGMlggcSOfMJcO/ap68CzmZ

# lipFCxnXrg==

# SIG # End signature block