AzStackHci.EnvironmentChecker

1.2100.2627.343

Obs/bin/GMA/GetTelemetryStatusAndEditConfigs.ps1

                                ##------------------------------------------------------------------

##  <copyright file="GetTelemetryStatusAndEditConfigs.ps1" company="Microsoft">

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

##  </copyright>

##------------------------------------------------------------------

Param (

    [Parameter(Mandatory=$true)]

    [System.String] $TaskName,

    [Parameter(Mandatory = $true)]

    [System.String] $GMACacheFolderPath,

    [Parameter(Mandatory = $true)]

    [System.String] $GmaPackageContentPath,

    [Parameter(Mandatory=$false)]

    [System.String] $TranscriptFolderPath = "$env:SystemDrive\Observability\ObsScheduledTaskTranscripts"

)

$functionName = $MyInvocation.MyCommand.Name

$transcriptFileName = "{0}.{1:yyyy-MM-dd}.log" -f $TaskName, $(Get-Date)

$transcriptFilePath = Join-Path -Path $TranscriptFolderPath -ChildPath $transcriptFileName

Start-Transcript -Path $transcriptFilePath -Append

Import-Module (Join-Path -Path $GmaPackageContentPath -ChildPath 'GMATenantJsonHelper.psm1') `

    -DisableNameChecking `

    -Verbose:$false

function Set-RegistryKeyLocal {

    Param (

        [Parameter(Mandatory=$True)]

        [System.Collections.Hashtable] $IdParamsToUpdate

    )

    $functionName = $MyInvocation.MyCommand.Name

    Write-ObservabilityGMAEventSource "[$functionName] Entering. Params: {IdParamsToUpdate = $($IdParamsToUpdate | ConvertTo-Json) }."

    $regPath = [Microsoft.AzureStack.Observability.ObservabilityCommon.TenantConfigGenerator.Constants]::CommonConfigRegistryPath

    Write-ObservabilityGMAEventSource "[$functionName] RegPath value is $regPath."

    foreach ($regKey in $IdParamsToUpdate.Keys) {

        $regValue = $IdParamsToUpdate[$regKey]

        if (Confirm-IsStringNotEmpty $regValue) {

            [Microsoft.AzureStack.Observability.ObservabilityCommon.TenantConfigGenerator.RegistryUtility]::SetRegistryKey($regPath, $regKey, $regValue)

            Write-ObservabilityGMAEventSource -Message "[$functionName] Successfully updated $regKey value ($regValue) in registry."

        }

        else {

            Write-ObservabilityGMAEventSource -Message "[$functionName] $regKey value is either null or empty. Registry value won't be updated."

        }

    }

    Write-ObservabilityGMAEventSource "[$functionName] Exiting."

}

function Set-LastWriteTimeOfFile {

    Param (

        [Parameter(Mandatory=$True)]

        [System.IO.FileInfo] $FileObj

    )

    $functionName = $MyInvocation.MyCommand.Name

    Write-ObservabilityGMAEventSource "[$functionName] Entering. Params: {FileObj = $($FileObj.Name)}."

    $FileObj.LastWriteTime = (Get-Date)

    Write-ObservabilityGMAEventSource -Message "[$functionName] Modified the LastWriteTime of $($FileObj.FullName) to $($FileObj.LastWriteTime)."

    Write-ObservabilityGMAEventSource "[$functionName] Exiting."

}

try

{

    Write-ObservabilityGMAEventSource -Message "[$functionName] Entering."

    $jsonDropLocation = Join-Path $GMACacheFolderPath -ChildPath "JsonDropLocation"

    $configTypesToNotUpdateAsTheyAreStatic = @(

        $MiscConstants.ConfigTypes.Diagnostics,

        $MiscConstants.ConfigTypes.Health

    )

    ## Set telemetry to always be enabled. 

    $telemetryEnabled = $true

    ## Set the Proactive Log collection status to always be enabled.

    $diagnosticLevel = $MiscConstants.HciDiagnosticLevel.Enhanced

    Set-ProactiveLogCollectionStatus -DiagnosticLevel $diagnosticLevel

    ## Keep track of which configs need to be updated

    $configsToBeUpdated = @{}

    $configFilePaths = @{}

    $MiscConstants.ConfigTypes.Values | ForEach-Object {

        $configType = $_

        $jsonConfigFileName = "AEO" + $configType + ".json"

        $configsToBeUpdated[$configType] = $true

        $configFilePaths[$configType] = Join-Path $jsonDropLocation -ChildPath $jsonConfigFileName

    } 

    if (Confirm-ClusterCmdletsAreAvailable) {

        Write-ObservabilityGMAEventSource -Message "[$functionName] As cluster cmdlets are available, evaluate whether the values are changed, if yes then update the reg keys as well as Tenant jsons."

        ## Fetch respective values from cluster cmdlets.

        $azureStackHciDetails = Get-AzureStackHCI

        $deviceArmResourceUri = $azureStackHciDetails.AzureResourceUri

        $stampId = $azureStackHciDetails.AzureResourceName

        $clusterName = (Get-Cluster).Name

        $osBuildVersion = Get-OSBuildVersion

        $assemblyBuild = Get-AssemblyVersion

        $nodeId = $StampId + "-" + (Get-ClusterNode(hostname)).Id

        $valuesFromClusterCmdlets = [ordered] @{

            $MiscConstants.TenantJsonPropertyNames.MONITORING_AEO_DEVICE_ARM_RESOURCE_URI = $deviceArmResourceUri

            $MiscConstants.TenantJsonPropertyNames.MONITORING_AEO_STAMPID = $stampId 

            $MiscConstants.TenantJsonPropertyNames.MONITORING_AEO_CLUSTER_NAME = $clusterName

            $MiscConstants.TenantJsonPropertyNames.MONITORING_AEO_OSBUILD = $osBuildVersion

            $MiscConstants.TenantJsonPropertyNames.MONITORING_AEO_ASSEMBLYBUILD = $assemblyBuild

            $MiscConstants.TenantJsonPropertyNames.MONITORING_AEO_NODEID = $nodeId

        }

        Write-ObservabilityGMAEventSource "[$functionName] Values from cluster cmdlets are as follows: $($valuesFromClusterCmdlets | ConvertTo-Json)"

        ## Check Diagnostics tenant json and evaluate whether any of the ID params have changed, if yes, then update the registry keys and all the json files.

        $diagTenantJsonFilePath = $configFilePaths[$MiscConstants.ConfigTypes.Diagnostics]

        if (-not (Test-Path -Path $diagTenantJsonFilePath))

        {

            Set-TenantConfigJsonFile -ConfigType $MiscConstants.ConfigTypes.Diagnostics -FilePath $diagTenantJsonFilePath

        }

        $jsonFiles = Get-ChildItem $jsonDropLocation

        $diagTenantJsonContent = Get-ContentAsJson $diagTenantJsonFilePath

        $currentJsonIdParams = $diagTenantJsonContent.ConstantVariables

        ## Track the idParams that are to be updated.

        $idParamsToBeUpdated = @{}

        foreach ($idParam in $valuesFromClusterCmdlets.Keys) {

            if ($valuesFromClusterCmdlets.$idParam -ne $currentJsonIdParams.$idParam) {

                $idParamsToBeUpdated.Add($idParam, $valuesFromClusterCmdlets.$idParam)

                Write-ObservabilityGMAEventSource "[$functionName] Value for $idParam is updated, registry will be updated. Current json value = $($currentJsonIdParams.$idParam), New value = $($valuesFromClusterCmdlets.$idParam)."

            }

            else {

                Write-ObservabilityGMAEventSource "[$functionName] Value for $idParam hasn't changed, registry won't be updated."

            }

        }

        ## Update the registry keys with latest values.

        if ($idParamsToBeUpdated.Count -gt 0) {

            Set-RegistryKeyLocal -IdParamsToUpdate $idParamsToBeUpdated

        }

        else {

            Write-ObservabilityGMAEventSource "[$functionName] All the Id params are latest, nothing to update."

        }

        $configTypesToRemoveJsonIfTelemetryIsDisabled = @(

            $MiscConstants.ConfigTypes.Telemetry,

            $MiscConstants.ConfigTypes.Metrics

        )

        foreach ($configType in $MiscConstants.ConfigTypes.Values) {

            Write-ObservabilityGMAEventSource "[$functionName] ConfigType to evaluate is $configType"

            $tenantJsonFilePath = $configFilePaths[$configType]

            ## If configType is the one whose json is to be removed based on Telemetry status and Telemetry is actually disabled, then delete the json if it exists.

            if ($configType -in $configTypesToRemoveJsonIfTelemetryIsDisabled -and (-not $telemetryEnabled)) {

                if ((Confirm-IsStringNotEmpty $tenantJsonFilePath) -and (Test-Path $tenantJsonFilePath)) {

                    Write-ObservabilityGMAEventSource "[$functionName] Telemetry is disabled, however $configType tenant json file exists. Thus, removing the file."

                    Remove-Item $tenantJsonFilePath -Verbose

                }

                else {

                    Write-ObservabilityGMAEventSource "[$functionName] Tenant json for $configType does not exists already, nothing to remove."

                }

                $configsToBeUpdated[$configType] = $false

            }

            else {

                if (Confirm-IsStringEmpty $tenantJsonFilePath) {

                    ## If the json for either telemetry or metrics is not present and telemetry is enabled, then generate the config.

                    Write-ObservabilityGMAEventSource "[$functionName] Tenant json for $configType does not exists, creating config file."

                    $tenantJsonFilePath = "$jsonDropLocation\AEO$configType.json"

                    & "$GmaPackageContentPath\NewMultiTenantJsonForObservabilityGMA.ps1" `

                        -ConfigType $configType `

                        -TelemetryEnabled $telemetryEnabled `

                        -TenantJsonFilePath $tenantJsonFilePath

                }

                else {

                    ## Update the json, only if Id param values are changed. Don't update security as that is done on-demand.

                    if ($idParamsToBeUpdated.Count -gt 0 -and $configType -ne $MiscConstants.ConfigTypes.Security) {

                        Write-ObservabilityGMAEventSource "[$functionName] Updating tenant json for $configType with latest id param values at location $tenantJsonFilePath."

                        Set-TenantConfigJsonFile -ConfigType $ConfigType -FilePath $tenantJsonFilePath

                    }

                    elseif ($configType -notin $configTypesToNotUpdateAsTheyAreStatic -and (Test-Path -Path $tenantJsonFilePath)) {

                        ## If no id params are changed, then just update the LastWriteTime so GMA downloads the latest config.

                        Write-ObservabilityGMAEventSource "[$functionName] Tenant json for $configType already has latest id params. So just updating the LastWriteTime of the file, so GMA downloads latest config."

                        Set-LastWriteTimeOfFile -FileObj $(Get-Item $tenantJsonFilePath)

                    }

                    else {

                        ## Do nothing

                        Write-ObservabilityGMAEventSource "[$functionName] Tenant json for $configType already has latest id param values, so it won't be updated."

                    }

                }

            }

        }

    }

    else {

        Write-ObservabilityGMAEventSource "[$functionName] As cluster cmdlets are not available, we will just modify the LastWriteTime of Tenant json files."

        ## Modify the LastWriteTime of Json files (except some), so that the latest MA configs are pulled down.

        foreach ($tenantJsonFile in $jsonFiles) {

            $isTenantJsonToBeUpdated = $True

            foreach ($configType in $configTypesToNotUpdateAsTheyAreStatic)

            {

                if ($tenantJsonFile.Name -match $configType)

                {

                    Write-ObservabilityGMAEventSource "[$functionName] Not updating LastWriteTime of $($tenantJsonFile.FullName) as config is static."

                    $isTenantJsonToBeUpdated = $False

                }

            }

            if ($isTenantJsonToBeUpdated) {

                Set-LastWriteTimeOfFile -FileObj $tenantJsonFile

            }

        }

    }

    foreach ($configType in $MiscConstants.ConfigTypes.Values) {

        if($configsToBeUpdated[$configType])

        {

            Sync-TenantRegKeysAndConfigFile -ConfigType $configType -FilePath $configFilePaths[$configType]

        }

    }

    Write-ObservabilityGMAEventSource -Message "[$functionName] Exiting."

}

catch

{

    $exceptionDetails = Get-ExceptionDetails -ErrorObject $_

    Write-ObservabilityGMAEventSource -Message "[$functionName] $exceptionDetails" -Level "ERROR"

}

Stop-Transcript

# SIG # Begin signature block

# MIIoPAYJKoZIhvcNAQcCoIIoLTCCKCkCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBqM32Ja22c8UTf

# V5JQ1HmUYMR+sR7LG0XSWFznziH8RaCCDYUwggYDMIID66ADAgECAhMzAAADri01

# UchTj1UdAAAAAAOuMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwODU5WhcNMjQxMTE0MTkwODU5WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQD0IPymNjfDEKg+YyE6SjDvJwKW1+pieqTjAY0CnOHZ1Nj5irGjNZPMlQ4HfxXG

# yAVCZcEWE4x2sZgam872R1s0+TAelOtbqFmoW4suJHAYoTHhkznNVKpscm5fZ899

# QnReZv5WtWwbD8HAFXbPPStW2JKCqPcZ54Y6wbuWV9bKtKPImqbkMcTejTgEAj82

# 6GQc6/Th66Koka8cUIvz59e/IP04DGrh9wkq2jIFvQ8EDegw1B4KyJTIs76+hmpV

# M5SwBZjRs3liOQrierkNVo11WuujB3kBf2CbPoP9MlOyyezqkMIbTRj4OHeKlamd

# WaSFhwHLJRIQpfc8sLwOSIBBAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUhx/vdKmXhwc4WiWXbsf0I53h8T8w

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwMTgzNjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AGrJYDUS7s8o0yNprGXRXuAnRcHKxSjFmW4wclcUTYsQZkhnbMwthWM6cAYb/h2W

# 5GNKtlmj/y/CThe3y/o0EH2h+jwfU/9eJ0fK1ZO/2WD0xi777qU+a7l8KjMPdwjY

# 0tk9bYEGEZfYPRHy1AGPQVuZlG4i5ymJDsMrcIcqV8pxzsw/yk/O4y/nlOjHz4oV

# APU0br5t9tgD8E08GSDi3I6H57Ftod9w26h0MlQiOr10Xqhr5iPLS7SlQwj8HW37

# ybqsmjQpKhmWul6xiXSNGGm36GarHy4Q1egYlxhlUnk3ZKSr3QtWIo1GGL03hT57

# xzjL25fKiZQX/q+II8nuG5M0Qmjvl6Egltr4hZ3e3FQRzRHfLoNPq3ELpxbWdH8t

# Nuj0j/x9Crnfwbki8n57mJKI5JVWRWTSLmbTcDDLkTZlJLg9V1BIJwXGY3i2kR9i

# 5HsADL8YlW0gMWVSlKB1eiSlK6LmFi0rVH16dde+j5T/EaQtFz6qngN7d1lvO7uk

# 6rtX+MLKG4LDRsQgBTi6sIYiKntMjoYFHMPvI/OMUip5ljtLitVbkFGfagSqmbxK

# 7rJMhC8wiTzHanBg1Rrbff1niBbnFbbV4UDmYumjs1FIpFCazk6AADXxoKCo5TsO

# zSHqr9gHgGYQC2hMyX9MGLIpowYCURx3L7kUiGbOiMwaMIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGg0wghoJAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAOuLTVRyFOPVR0AAAAA

# A64wDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIJHu

# trKkBOvXBeNPQDrlUz7mU20QbkgMdSKF0FuSZ5DTMEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEAg8jZVu5rbhJKESFtWzDhnzJmpcQJR+q3zfoQ

# Xh4O71rvAgFO/UxmWP3oHY8UcGHGIws8H3dxYtzYhqKL8TGqCZcVQohz+tdQ1vSH

# 8CDthaaMLCqjY11J4bgFKMWhk0nq8uxX84S+/61lGl9JN1EsfePx9dHLTp+8XLg1

# sl13IPvlUO7M5mxlkexBl8xhLzrGw1xegCnoPRteAIg9maj4jtu2YTPhBqtxfall

# QwvUPueRcfYewAa9Rr5oTkRv6EC1/LzCsIGs93LtyIOdMW0HPn1774zX0ZlDQETP

# 6cNruCqOsnOOfbzQoV0onualmupc05Np4OmOiltyCxg5k2teKKGCF5cwgheTBgor

# BgEEAYI3AwMBMYIXgzCCF38GCSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCAD53wXq082EyfOrPC1Iq+EpEwKbm1MqI36

# zd8pU2ZXHwIGZeeoQKt4GBMyMDI0MDMxMTE4MTgxOC45OTdaMASAAgH0oIHRpIHO

# MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL

# ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk

# IFRTUyBFU046RTAwMi0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2WgghHtMIIHIDCCBQigAwIBAgITMwAAAe4F0wIwspqdpwAB

# AAAB7jANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MDAeFw0yMzEyMDYxODQ1NDRaFw0yNTAzMDUxODQ1NDRaMIHLMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l

# cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046RTAwMi0w

# NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Uw

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC+8byl16KEia8xKS4vVL7R

# EOOR7LzYCLXEtWgeqyOVlrzuEz+AoCa4tBGESjbHTXECeMOwP9TPeKaKalfTU5XS

# GjpJhpGx59fxMJoTYWPzzD0O2RAlyBmOBBmiLDXRDQJL1RtuAjvCiLulVQeiPI8V

# 7+HhTR391TbC1beSxwXfdKJqY1onjDawqDJAmtwsA/gmqXgHwF9fZWcwKSuXiZBT

# bU5fcm3bhhlRNw5d04Ld15ZWzVl/VDp/iRerGo2Is/0Wwn/a3eGOdHrvfwIbfk6l

# VqwbNQE11Oedn2uvRjKWEwerXL70OuDZ8vLzxry0yEdvQ8ky+Vfq8mfEXS907Y7r

# N/HYX6cCsC2soyXG3OwCtLA7o0/+kKJZuOrD5HUrSz3kfqgDlmWy67z8ZZPjkiDC

# 1dYW1jN77t5iSl5Wp1HKBp7JU8RiRI+vY2i1cb5X2REkw3WrNW/jbofXEs9t4bgd

# +yU8sgKn9MtVnQ65s6QG72M/yaUZG2HMI31tm9mooH29vPBO9jDMOIu0LwzUTkIW

# flgd/vEWfTNcPWEQj7fsWuSoVuJ3uBqwNmRSpmQDzSfMaIzuys0pvV1jFWqtqwwC

# caY/WXsb/axkxB/zCTdHSBUJ8Tm3i4PM9skiunXY+cSqH58jWkpHbbLA3Ofss7e+

# JbMjKmTdcjmSkb5oN8qU1wIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFBCIzT8a2dwg

# nr37xd+2v1/cdqYIMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8G

# A1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# Y3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBs

# BggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0

# LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUy

# MDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUH

# AwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQB3ZyAva2EKOWSV

# pBnYkzX8f8GZjaOs577F9o14Anh9lKy6tS34wXoPXEyQp1v1iI7rJzZVG7rpUzna

# y2n9csfn3p6y7kYkHqtSugCGmTiiBkwhFfSByKPI08MklgvJvKTZb673yGfpFwPj

# QwZeI6EPj/OAtpYkT7IUXqMki1CRMJKgeY4wURCccIujdWRkoVv4J3q/87KE0qPQ

# mAR9fqMNxjI3ZClVxA4wiM3tNVlRbF9SgpOnjVo3P/I5p8Jd41hNSVCx/8j3qM7a

# LSKtDzOEUNs+ZtjhznmZgUd7/AWHDhwBHdL57TI9h7niZkfOZOXncYsKxG4gryTs

# hU6G6sAYpbqdME/+/g1uer7VGIHUtLq3W0Anm8lAfS9PqthskZt54JF28CHdsFq/

# 7XVBtFlxL/KgcQylJNnia+anixUG60yUDt3FMGSJI34xG9NHsz3BpqSWueGtJhQ5

# ZN0K8ju0vNVgF+Dv05sirPg0ftSKf9FVECp93o8ogF48jh8CT/B32lz1D6Truk4E

# zcw7E1OhtOMf7DHgPMWf6WOdYnf+HaSJx7ZTXCJsW5oOkM0sLitxBpSpGcj2YjnN

# znCpsEPZat0h+6d7ulRaWR5RHAUyFFQ9jRa7KWaNGdELTs+nHSlYjYeQpK5QSXji

# gdKlLQPBlX+9zOoGAJhoZfrpjq4nQDCCB3EwggVZoAMCAQICEzMAAAAVxedrngKb

# SZkAAAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQI

# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv

# ZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmlj

# YXRlIEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIy

# NVowfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXI

# yjVX9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjo

# YH1qUoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1y

# aa8dq6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v

# 3byNpOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pG

# ve2krnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viS

# kR4dPf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYr

# bqgSUei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlM

# jgK8QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSL

# W6CmgyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AF

# emzFER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIu

# rQIDAQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIE

# FgQUKqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWn

# G1M1GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEW

# M2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5

# Lmh0bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBi

# AEMAQTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV

# 9lbLj+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3Js

# Lm1pY3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAx

# MC0wNi0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2

# LTIzLmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv

# 6lwUtj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZn

# OlNN3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1

# bSNU5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4

# rPf5KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU

# 6ZGyqVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDF

# NLB62FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/

# HltEAY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdU

# CbFpAUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKi

# excdFYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTm

# dHRbatGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZq

# ELQdVTNYs6FwZvKhggNQMIICOAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT

# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJp

# Y2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOkUwMDItMDVF

# MC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMK

# AQEwBwYFKw4DAhoDFQCIo6bVNvflFxbUWCDQ3YYKy6O+k6CBgzCBgKR+MHwxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv

# c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6ZlmfjAi

# GA8yMDI0MDMxMTExMTYxNFoYDzIwMjQwMzEyMTExNjE0WjB3MD0GCisGAQQBhFkK

# BAExLzAtMAoCBQDpmWZ+AgEAMAoCAQACAiBaAgH/MAcCAQACAhOjMAoCBQDpmrf+

# AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSCh

# CjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAG2ZeoCneJTVRJr8Eotj4iIN

# TFIY+w3HKyCD+D+C5yfTDmialNad17rp8mU7VXQYfnJUd2XrUgxfDtcE4HzGjXD/

# b5vz4kVGO19nVWPPqU4qSih5weF35OvFIi4nERAJ62E9MkK30ZkXs0+sqjahztdM

# yt32ujEnFKnmsmCuopEMSM0f+38olXFSL2ebINDMm4GtCRq/F4pMyGgsAs4ovmxE

# kFbU3to66BOrW0V/fHuEM7PEwtEhaTOnZVoYTnSwtz7YqOMnR6+xr7er934J62DN

# iRUl9gGGzCGBAS2blfWEcF65Ao8+Yn4XO+UVU1Ux+HpetNAbEE6a522iZXT8b9kx

# ggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAA

# Ae4F0wIwspqdpwABAAAB7jANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkD

# MQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCAiaUwD5zSPpUx5Pi1bxAua

# nyjoSS/ryIvwxdAEEonmkTCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIE9Q

# dxSVhfq+Vdf+DPs+5EIkBz9oCS/OQflHkVRhfjAhMIGYMIGApH4wfDELMAkGA1UE

# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc

# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0

# IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAHuBdMCMLKanacAAQAAAe4wIgQgcc0i

# ipYuecHTORDGPzOAJbPJic970v2yGbGx3xdP7yYwDQYJKoZIhvcNAQELBQAEggIA

# SjPgT4AfIHkIrGz+gjXREtzmDztH2dyaQsElXLLSB03060F7zlJTAe7VOM4FLREa

# yrNzkhfkWyDifAbgy1wqtPNp3whlbcQnYKDQT7lIjQ8pE4e+Mc6Ji5xPmtKXFb8l

# 6xwsvFZrmxNkt6StKdC6sxFZjJxk9cIpYiHbd57UxFeZRCKDxkn8x8J0kgzpMeEy

# MMS952ZEMnmej5AjZoHNaRIfpeg0cwnavBEB55Kg/1CXbfrxVOTU8iFHXl2Ny8jp

# PM9vkEcFMnWtabRA2+M+sd8AebbXWhzfNTYdNAV4MxDv++wz2asrFA5iwKCFXWub

# bSqwZ1+4rUf7CKkTASvZuT/7jBjkOBDQ/yf+AhrFesSzfmpCpaJR9u6mRBzYorfN

# ZSdnZGRWvAMYasZFN6OR0zTCDHTIOxzp8bxT8InGTGzlkhhlJZYoctZMQz2OZzfc

# GBk1/V3lX8AAEV4O9oMrEdxX54NE2HWdouIa9qnUHE1bw5YDVFPJ8KuZChPwdove

# n2LN/2nZN1+jH4FulKgZ5CQCfca0YOKnG4n18DNWxmPF0gTpQFrjlwtw81+EzboF

# nRJc/Kld9ynn0DopK2rHbGnfnOb6VUbwL+3t+Ketv5RHLRn70JJGDZSbZgnZb2yW

# ZJbUP8Z+SOPnNElI7tPI9oeZ7DOl1OdRqjUlYK2uh1g=

# SIG # End signature block