AzStackHci.EnvironmentChecker

1.2100.2627.343

Obs/scripts/ScenarioHelper.psm1

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

##  <copyright file="ScenarioHelper.psm1" company="Microsoft">

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

##  </copyright>

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

$gmaPackageContentPath = Get-GmaPackageContentPath

#region Functions

function Set-TenantJsonConfig {

    [CmdletBinding()]

    Param(

        [Parameter(Mandatory=$true)]

        [System.String] $GcsRegionName,

        [Parameter(Mandatory=$true)]

        [System.String] $GcsEnvironment,

        [Parameter(Mandatory=$true)]

        [System.String] $GMACacheFolderPath,

        [Parameter(Mandatory=$False)]

        [System.String] $LogFile

    )

    if (Test-RegKeyExists -Path $MiscConstants.GMAScenarioRegKey.Path -Name $MiscConstants.GMAScenarioRegKey.Name -LogFile $logFile) {

        Set-LocalTenantJsonUsingAlreadyCreatedTenantRegistryKeys `

            -GcsRegionName $GcsRegionName `

            -GcsEnvironment $GcsEnvironment `

            -GMACacheFolderPath $gmaCacheFolderPath `

            -LogFile $LogFile

    }

    else {

        Set-LocalTenantJsonByCreatingNewTenantRegistryKeys `

            -GcsRegionName $GcsRegionName `

            -GcsEnvironment $GcsEnvironment `

            -GMACacheFolderPath $gmaCacheFolderPath `

            -LogFile $LogFile

    }

}

#endregion Functions

#region Local Helper functions

function Set-LocalTenantJsonUsingAlreadyCreatedTenantRegistryKeys {

    [CmdletBinding()]

    Param(

        [Parameter(Mandatory=$true)]

        [System.String] $GcsRegionName,

        [Parameter(Mandatory=$true)]

        [System.String] $GcsEnvironment,

        [Parameter(Mandatory=$true)]

        [System.String] $GMACacheFolderPath,

        [Parameter(Mandatory=$False)]

        [System.String] $LogFile

    )

    $functionName = $MyInvocation.MyCommand.Name

    Write-Log "[$functionName] Entering. Params: {GcsRegionName = $GcsRegionName | GcsEnvironment = $GcsEnvironment | GMACacheFolderPath = $GMACacheFolderPath}"

    $gmaScenario = Test-RegKeyExists `

                        -Path $MiscConstants.GMAScenarioRegKey.Path `

                        -Name $MiscConstants.GMAScenarioRegKey.Name `

                        -LogFile $LogFile `

                        -GetValueIfExists

    if ($gmaScenario -eq $MiscConstants.GMAScenarioRegKey.OneP)

    {

        ## For OneP scenario, we create jsons for Telemetry and Diagnostics tenants only.

        $configTypes = @(

            $MiscConstants.ConfigTypes.Telemetry,

            $MiscConstants.ConfigTypes.Diagnostics

        )

    }

    elseif ($gmaScenario -eq $MiscConstants.GMAScenarioRegKey.Bootstrap)

    {

        ## However, for BootStrap, we create jsons for all the tenants.

        $configTypes = $MiscConstants.ConfigTypes.Values

    }

    ## Generate tenant json files.

    foreach($configType in $configTypes) {

        $gcsTenantJsonValues = Get-LocalGcsTenantJsonValuesByConfigType `

            -ConfigType $configType `

            -GcsRegionName $GcsRegionName `

            -GcsEnvironment $GcsEnvironment `

            -LogFile $LogFile

        New-RegKey `

            -Path $($RegistryConstants.TenantJsonCacheLocalPath.Path -f $configType) `

            -Name $RegistryConstants.TenantJsonCacheLocalPath.Name `

            -PropertyType $RegistryConstants.TenantJsonCacheLocalPath.PropertyType `

            -Value $gcsTenantJsonValues.LocalPath `

            -LogFile $LogFile

        New-LocalCreateTenantJsonFile `

            -ConfigType $configType `

            -TenantJsonFilePath $gcsTenantJsonValues.TenantJsonFilePath `

            -LogFile $LogFile

        if ($configType -eq $MiscConstants.ConfigTypes.Metrics){

            $envInfoFilePath = "$GmaPackageContentPath\EnvironmentInfo.json"

            Set-EnvironmentVariablesForMetrics `

                -EnvInfoFilePath $envInfoFilePath `

                -GcsEnvironment $GcsEnvironment `

                -LogFile $LogFile

        }

    }

    New-LocalObsScheduledTask `

        -GMACacheFolderPath $GMACacheFolderPath `

        -LogFile $LogFile

    Write-Log "[$functionName] Exiting."

}

function Set-LocalTenantJsonByCreatingNewTenantRegistryKeys {

    [CmdletBinding()]

    Param(

        [Parameter(Mandatory=$true)]

        [System.String] $GcsRegionName,

        [Parameter(Mandatory=$true)]

        [System.String] $GcsEnvironment,

        [Parameter(Mandatory=$true)]

        [System.String] $GMACacheFolderPath,

        [Parameter(Mandatory = $False)]

        [System.String] $LogFile

    )

    $functionName = $MyInvocation.MyCommand.Name

    Write-Log "[$functionName] Entering. Params: {GcsRegionName = $GcsRegionName | GcsEnvironment = $GcsEnvironment | GMACacheFolderPath = $GMACacheFolderPath}"

    $idParamsToFetch = $MiscConstants.IdentityParamsToFetchFromPublicSettings

    $retrievedIdParams = @{}

    if (Confirm-ClusterCmdletsAreAvailable) {

        Write-Log "[$functionName] As cluster cmdlets are available, we will use them to fetch the required Identity param values."

        $retrievedIdParams = Get-ClusterRegistrationValuesForIdParams -IdParamsToFetch $idParamsToFetch

    }

    else {

        Write-Log "[$functionName] Cluster cmdlets are not available, checking if Identity params are present in Public Settings or not."

        ## Fetch IdentityParams from public settings if cluster cmdlets are not available.

        $retrievedIdParams = Get-IdenityParametersFromPublicSettings -IdentityParamsToFetch $idParamsToFetch -LogFile $logFile

        ## If the NodeId is empty, use the hashed value until registration takes place and we update the NodeId value using cluster table.

        if (Confirm-IsStringEmpty $retrievedIdParams[$idParamsToFetch.NodeId]) {

            <#

                Note: In bootstrap scenario, we use the [Stampid-hash(hostname)] combination, so we will try to do the same here and for that we need the stamp id as well.

                However, at this stage, we might not have the StampId value and so for that case we will just use the hash(hostName) value as NodeId.

            #>

            $hostNameHash = Get-Sha256Hash -ClearString (hostname)

            if (Confirm-IsStringNotEmpty $retrievedIdParams[$idParamsToFetch.StampId]) {

                $retrievedIdParams[$idParamsToFetch.NodeId] = "$($retrievedIdParams[$idParamsToFetch.StampId])-$hostNameHash"

            }

            else {

                $retrievedIdParams[$idParamsToFetch.NodeId] = $hostNameHash

            }   

        }

    }

    ## If Assembly Version is empty, try to get the value from ECE if available.

    if (Confirm-IsStringEmpty $retrievedIdParams[$idParamsToFetch.AssemblyVersion]) {

        $retrievedIdParams[$idParamsToFetch.AssemblyVersion] = Get-AssemblyVersion -LogFile $logFile

    }

    $arcAgentResourceInfo = Get-ArcAgentResourceInfo -LogFile $logFile

    $arcAgentResourceId = Get-ArcAgentResourceId -ArcAgentInfo $arcAgentResourceInfo -LogFile $logFile

    ## Generate tenant json files.

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

        $gcsTenantJsonValues = Get-LocalGcsTenantJsonValuesByConfigType `

            -ConfigType $configType `

            -GcsRegionName $GcsRegionName `

            -GcsEnvironment $GcsEnvironment `

            -LogFile $LogFile

        Set-TenantConfigRegistryKeys `

            -ConfigType $configType `

            -LogFile $logFile `

            -Version $gcsTenantJsonValues.ConfigVersion `

            -GcsAuthIdType $gcsTenantJsonValues.GcsAuthIdType `

            -GcsEnvironment $gcsTenantJsonValues.GcsEnvironment `

            -GcsGenevaAccount $gcsTenantJsonValues.GcsGenevaAccount `

            -GcsNamespace $gcsTenantJsonValues.GcsNameSpace `

            -GcsRegion $gcsTenantJsonValues.GcsRegion `

            -GenevaConfigVersion $gcsTenantJsonValues.GenevaConfigVersion `

            -LocalPath $gcsTenantJsonValues.LocalPath `

            -DisableUpdate $gcsTenantJsonValues.DisableUpdate `

            -DisableCustomImds $gcsTenantJsonValues.DisableCustomImds `

            -MONITORING_AEO_REGION $gcsRegionName `

            -MONITORING_AEO_DEVICE_ARM_RESOURCE_URI $retrievedIdParams[$idParamsToFetch.DeviceArmResourceUri] `

            -MONITORING_AEO_STAMPID $retrievedIdParams[$idParamsToFetch.StampId] `

            -MONITORING_AEO_CLUSTER_NAME $retrievedIdParams[$idParamsToFetch.ClusterName] `

            -MONITORING_AEO_OSBUILD (Get-OSBuildVersion -LogFile $LogFile) `

            -MONITORING_AEO_ASSEMBLYBUILD $retrievedIdParams[$idParamsToFetch.AssemblyVersion] `

            -MONITORING_AEO_NODEID $retrievedIdParams[$idParamsToFetch.NodeId] `

            -MONITORING_AEO_NODE_ARC_RESOURCE_URI $arcAgentResourceId `

            -MONITORING_AEO_CLUSTER_NODE_NAME $MiscConstants.TenantJsonPropertyStaticValues.MONITORING_AEO_CLUSTER_NODE_NAME

        New-LocalCreateTenantJsonFile `

            -ConfigType $ConfigType `

            -TenantJsonFilePath $gcsTenantJsonValues.TenantJsonFilePath `

            -LogFile $LogFile

        if ($configType -eq $MiscConstants.ConfigTypes.Metrics){

            $envInfoFilePath = "$GmaPackageContentPath\EnvironmentInfo.json"

            Set-EnvironmentVariablesForMetrics `

                -EnvInfoFilePath $envInfoFilePath `

                -GcsEnvironment $GcsEnvironment `

                -AssemblyBuildVersion $retrievedIdParams[$idParamsToFetch.AssemblyVersion] `

                -HciResourceUri $retrievedIdParams[$idParamsToFetch.DeviceArmResourceUri] `

                -ClusterName $retrievedIdParams[$idParamsToFetch.ClusterName] `

                -LogFile $LogFile

        }

    }

    New-LocalObsScheduledTask -GMACacheFolderPath $GMACacheFolderPath -LogFile $LogFile

    Write-Log "[$functionName] Exiting."

}

function Get-LocalGcsTenantJsonValuesByConfigType {

    Param(

        [Parameter(Mandatory=$true)]

        [System.String] $ConfigType,

        [Parameter(Mandatory=$true)]

        [System.String] $GcsRegionName,

        [Parameter(Mandatory=$true)]

        [System.String] $GcsEnvironment,

        [Parameter(Mandatory=$False)]

        [System.String] $LogFile

    )

    $functionName = $MyInvocation.MyCommand.Name

    Write-Log "[$functionName] Entering. Params: {ConfigType = $ConfigType | GcsRegionName = $GcsRegionName | GcsEnvironment = $GcsEnvironment}"

    ## Based on the config type, initialize dynamic variables.

    $envInfoFilePath = "$GmaPackageContentPath\EnvironmentInfo.json"

    $tenantInfoContent = Get-Content $envInfoFilePath -Raw | ConvertFrom-Json

    $envInfo = $tenantInfoContent.$GcsEnvironment

    $gcsTenantJsonValues = @{}

    $gcsTenantJsonValues.ConfigVersion = $MiscConstants.TenantJsonPropertyStaticValues.Version

    $gcsTenantJsonValues.GcsAuthIdType = $MiscConstants.TenantJsonPropertyStaticValues.GcsAuthIdType

    $gcsTenantJsonValues.GcsEnvironment = $envInfo.EndPoint

    $gcsTenantJsonValues.GcsGenevaAccount = $envInfo.Account

    if ($configType -eq $MiscConstants.ConfigTypes.Metrics) {   

        $gcsTenantJsonValues.GcsNameSpace = Get-MetricsNamespaceRegionMapping `

                            -MetricsNamespace $envInfo.Namespaces.$configType `

                            -Region $GcsRegionName `

                            -LogFile $logFile

    }

    else {

        $gcsTenantJsonValues.GcsNameSpace = $envInfo.Namespaces.$configType

    }

    $gcsTenantJsonValues.GcsRegion = $GcsRegionName

    $gcsTenantJsonValues.GenevaConfigVersion = $envInfo.ConfigVersion

    $gcsTenantJsonValues.LocalPath = Join-Path -Path $GMACacheFolderPath -ChildPath $($configType + "Cache")

    $gcsTenantJsonValues.DisableUpdate = $MiscConstants.TenantJsonPropertyStaticValues.DisableUpdate

    $gcsTenantJsonValues.DisableCustomImds = $MiscConstants.TenantJsonPropertyStaticValues.DisableCustomImds

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

    $gcsTenantJsonValues.TenantJsonFilePath = Join-Path -Path $GMACacheFolderPath -ChildPath "JsonDropLocation\$jsonConfigFileName"

    Write-Log "[$functionName] Exiting. Returning $($gcsTenantJsonValues | ConvertTo-Json)"

    return $gcsTenantJsonValues

}

function New-LocalCreateTenantJsonFile {

    Param(

        [Parameter(Mandatory=$true)]

        [System.String] $ConfigType,

        [Parameter(Mandatory=$true)]

        [System.String] $TenantJsonFilePath,

        [Parameter(Mandatory=$False)]

        [System.String] $LogFile

    )

    $functionName = $MyInvocation.MyCommand.Name

    Write-Log "[$functionName] Entering. Params: {ConfigType = $ConfigType | TenantJsonFilePath = $TenantJsonFilePath}"

    Write-Log "[$functionName] Generating tenant json for $ConfigType on $($env:COMPUTERNAME)."

    & "$gmaPackageContentPath\NewMultiTenantJsonForObservabilityGMA.ps1" `

        -ConfigType $ConfigType `

        -TenantJsonFilePath $TenantJsonFilePath `

        -LogFile $LogFile

}

function New-LocalObsScheduledTask {

    Param(

        [Parameter(Mandatory=$true)]

        [System.String] $GMACacheFolderPath,

        [Parameter(Mandatory=$False)]

        [System.String] $LogFile

    )

    $functionName = $MyInvocation.MyCommand.Name

    Write-Log "[$functionName] Entering. Params: {GMACacheFolderPath = $GMACacheFolderPath}"

    $transcriptFolderPath = Join-Path -Path $((Get-CacheDirectories).ObservabilityVolume) -ChildPath $MiscConstants.ObsScheduledTaskDetails.TranscriptsFolderName

    $scriptPath = Join-Path -Path $gmaPackageContentPath -ChildPath $MiscConstants.ObsScheduledTaskDetails.ScriptFileName

    $scriptArguments = "-TaskName `'$($MiscConstants.ObsScheduledTaskDetails.TaskName)`' -GMACacheFolderPath `'$GMACacheFolderPath`' -GMAPackageContentPath `'$gmaPackageContentPath`' -TranscriptFolderPath `'$transcriptFolderPath`'"

    ## Create scheduled task to get telemetry status every hour.

    New-ScheduledTaskForObservability `

        -TaskName $MiscConstants.ObsScheduledTaskDetails.TaskName `

        -TaskPath $MiscConstants.ObsScheduledTaskDetails.TaskPath `

        -Description $MiscConstants.ObsScheduledTaskDetails.Description `

        -ScriptPath $scriptPath `

        -ScriptArguments $scriptArguments `

        -LogFile $LogFile `

        -DisableOnRegistration

    Write-Log "[$functionName] ScheduledTask named ($($MiscConstants.ObsScheduledTaskDetails.TaskName)) is created."

}

#endregion Local Helper functions

#region Exports

Export-ModuleMember -Function Set-TenantJsonConfig

#endregion Exports

# SIG # Begin signature block

# MIIoPAYJKoZIhvcNAQcCoIIoLTCCKCkCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDHVBzeSTxVvDBI

# KQRWRPoEXDak2HD/ncK62OriwSJz3KCCDYUwggYDMIID66ADAgECAhMzAAADri01

# 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

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIH2Z

# wTUSkbe48seBZgDWd2tsn7EbLaSTLDDShe54v959MEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEAHzeIH1OvnubWoRDtAeNoEkz58MLpzsgX/CWR

# j4IEF21HZcsLcHAqpvfIIxcDRLpWjCMj2/QRRVCScT5OsSGMgeA+S+SbwgHUbZd1

# wsjczPKWPBwHs+AgRnSKC9MD+sYZRvCo9E571N0VdG9E2Wj3zZHlrqkDywrcE9Hm

# YNGpb7ZvpHnKdX4yzUiCOP4imYpznZU9G0yZtGEM/rJwzSrEBftiwUGpxuIYQCSN

# B6PDeL9tU1ajXjStgKlF08znRcOfUp6fF9D5LKONzfGb3RdtGAVWpmcF2qXmAn2X

# 7qZkdAunrpM18HESuZhp1SLlJQ6Zw0HB6ZqGXM8otZJNOXN0SKGCF5cwgheTBgor

# BgEEAYI3AwMBMYIXgzCCF38GCSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCCOgHIz1kiipN/3DjPySqUVgoHqMAUP2zTl

# 6BdCmTcbmAIGZeeoE+L0GBMyMDI0MDMxMTE4MTg1Ny43NjZaMASAAgH0oIHRpIHO

# MIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQL

# ExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxk

# IFRTUyBFU046MzcwMy0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1l

# LVN0YW1wIFNlcnZpY2WgghHtMIIHIDCCBQigAwIBAgITMwAAAeqaJHLVWT9hYwAB

# AAAB6jANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MDAeFw0yMzEyMDYxODQ1MzBaFw0yNTAzMDUxODQ1MzBaMIHLMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l

# cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046MzcwMy0w

# NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Uw

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC1C1/xSD8gB9X7Ludoo2rW

# b2ksqaF65QtJkbQpmsc6G4bg5MOv6WP/uJ4XOJvKX/c1t0ej4oWBqdGD6VbjXX4T

# 0KfylTulrzKtgxnxZh7q1uD0Dy/w5G0DJDPb6oxQrz6vMV2Z3y9ZxjfZqBnDfqGo

# n/4VDHnZhdas22svSC5GHywsQ2J90MM7L4ecY8TnLI85kXXTVESb09txL2tHMYrB

# +KHCy08ds36an7IcOGfRmhHbFoPa5om9YGpVKS8xeT7EAwW7WbXL/lo5p9KRRIjA

# lsBBHD1TdGBucrGC3TQXSTp9s7DjkvvNFuUa0BKsz6UiCLxJGQSZhd2iOJTEfJ1f

# xYk2nY6SCKsV+VmtV5aiPzY/sWoFY542+zzrAPr4elrvr9uB6ci/Kci//EOERZEU

# TBPXME/ia+t8jrT2y3ug15MSCVuhOsNrmuZFwaRCrRED0yz4V9wlMTGHIJW55iNM

# 3HPVJJ19vOSvrCP9lsEcEwWZIQ1FCyPOnkM1fs7880dahAa5UmPqMk5WEKxzDPVp

# 081X5RQ6HGVUz6ZdgQ0jcT59EG+CKDPRD6mx8ovzIpS/r/wEHPKt5kOhYrjyQHXc

# 9KHKTWfXpAVj1Syqt5X4nr+Mpeubv+N/PjQEPr0iYJDjSzJrqILhBs5pytb6vyR8

# HUVMp+mAA4rXjOw42vkHfQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFCuBRSWiUebp

# F0BU1MTIcosFblleMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8G

# A1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv

# Y3JsL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBs

# BggrBgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0

# LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUy

# MDIwMTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUH

# AwgwDgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQAog61WXj9+/nxV

# bX3G37KgvyoNAnuu2w3HoWZj3H0YCeQ3b9KSZThVThW4iFcHrKnhFMBbXJX4uQI5

# 3kOWSaWCaV3xCznpRt3c4/gSn3dvO/1GP3MJkpJfgo56CgS9zLOiP31kfmpUdPqe

# kZb4ivMR6LoPb5HNlq0WbBpzFbtsTjNrTyfqqcqAwc6r99Df2UQTqDa0vzwpA8Cx

# iAg2KlbPyMwBOPcr9hJT8sGpX/ZhLDh11dZcbUAzXHo1RJorSSftVa9hLWnzxGzE

# GafPUwLmoETihOGLqIQlCpvr94Hiak0Gq0wY6lduUQjk/lxZ4EzAw/cGMek8J3Qd

# iNS8u9ujYh1B7NLr6t3IglfScDV3bdVWet1itTUoKVRLIivRDwAT7dRH13Cq32j2

# JG5BYu/XitRE8cdzaJmDVBzYhlPl9QXvC+6qR8I6NIN/9914bTq/S4g6FF4f1dix

# UxE4qlfUPMixGr0Ft4/S0P4fwmhs+WHRn62PB4j3zCHixKJCsRn9IR3ExBQKQdMi

# 5auiqB6xQBADUf+F7hSKZfbA8sFSFreLSqhvj+qUQF84NcxuaxpbJWVpsO18IL4Q

# bt45Cz/QMa7EmMGNn7a8MM3uTQOlQy0u6c/jq111i1JqMjayTceQZNMBMM5EMc5D

# r5m3T4bDj9WTNLgP8SFe3EqTaWVMOTCCB3EwggVZoAMCAQICEzMAAAAVxedrngKb

# 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

# Y2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjM3MDMtMDVF

# MC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMK

# AQEwBwYFKw4DAhoDFQCJ2x7cQfjpRskJ8UGIctOCkmEkj6CBgzCBgKR+MHwxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv

# c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6ZlmfjAi

# GA8yMDI0MDMxMTExMTYxNFoYDzIwMjQwMzEyMTExNjE0WjB3MD0GCisGAQQBhFkK

# BAExLzAtMAoCBQDpmWZ+AgEAMAoCAQACAg8eAgH/MAcCAQACAhL0MAoCBQDpmrf+

# AgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSCh

# CjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAAAcbAXx8X0tBj9wnmikwjVT

# d98uRHkrqMk8xsgKo9QRCrKyzXvEfty8jd+gKj/X5NZ47Kc4Vkb+9ZZMuijML3be

# MeFmdrmJNBtQm2JnCmOHR0ZjGpTOVGpBz3+hs0Ukl4IpQNbgVN45u1J0ty5yekJp

# ExdK/K99neHjcDh43kmR7W9ItwZWSySQU0MGHq5cV/rqPjscnausfTtKWzG3ZFep

# aSHqS3kKSWXSvAW43kulKjyWgkzCUDTnrQMQrfksuBWe7FXcKgO04JACLyP595bO

# xZumEHYkjkMco+uqXVzXKt+vwhlWRFvUuBN+/Ian3sLf3xs98sfFF+zG3tTGfBkx

# ggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAA

# AeqaJHLVWT9hYwABAAAB6jANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkD

# MQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCCyunU8E+f+Vzi52eOq5E4e

# wa+ugM5XXIXf9z//GLhKTDCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EICmP

# odXjZDR4iwg0ltLANXBh5G1uKqKIvq8sjKekuGZ4MIGYMIGApH4wfDELMAkGA1UE

# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc

# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0

# IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAHqmiRy1Vk/YWMAAQAAAeowIgQg4iGe

# ly1SmvrVSgxEk2f1t3oBbsL8vnFhQYpEzDqDlmUwDQYJKoZIhvcNAQELBQAEggIA

# ev8QcwEwV14Ur3JYecdKnOCND6yCQXuVDftFfV2xbG2+ZxkZ9Mt3ndbl+lLzKHCb

# Ay5sYuTT0qmu+rvp+qsmOjJGvIMfkRWljI17lUCV8zC5bN3SVd0usWcxo7DRbv5b

# 0iBLiarD60losUYhnFUJI5fuNiK1S23nXKFw9RVtY0qRLGBUrvS97yBMMUwrSsjm

# LJmOK5qSPkJJ21k2Tw55MfEHLF7ld9MWk+XpCa4OD0d9ZLlN6DgURPGH//66xQvY

# yPBtvCGgInMNaTiTcR+Qp75kwarNDIXJDLAtZgBsZdV/1x58itwygtkZR6Nfgwz4

# fPUBuCdf4yWlMCjLkYeW0rUb7B5WBoFhVQVxWZw/iZDY8I9gDHb8Nz+f853wO5nf

# LZirJO13JCXswq/+3+2JoAHHpCqtInDG932XkFV5jW3iE8MlK6hagcg7O1rCfzm+

# amupgC5jRZuXYbBD0nlx1es7liSeaARuWRMbIZ59HVk1hQSEgR7q8Eh47ukxCt61

# S8q2d3yWf4k2+QmpM320QvuCQZGPX4FeqkU4U7ECN/HEKzvF3xLbz4cx0GMxw6q/

# iNVH9sgyg3rWIcZAB2racEGkIlyq9QEh9NUnfzRouVPjq2xBuDF3679QHyZW5Gfm

# PKJH2L5kkJLawOmjlRWFK4GBM942lIWIoJ83F6u3TqY=

# SIG # End signature block