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

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


<#
.SYNOPSIS
Evaluates the result of Test-AzureStack
 
.DESCRIPTION
Runs Test-AzureStack on the provided endpoint using the current session's credentials
 
.PARAMETER EndpointName
The name of the JEA endpoint to access
 
.PARAMETER ComputerName
The name of the computer on which to invoke the endpoint
 
.OUTPUTS
$True if Test-AzureStack was successful, $False otherwise
#>


function Get-TestAzureStackResult{
    Param(
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [string]
        $EndpointName,

        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [string]
        $ComputerName
    )

    $testAzureStackResult = $false

    Import-Module $PSScriptRoot\SessionTools.psm1

    try
    {
        $jeaSession = Get-JEASession -EndpointName $EndpointName -ComputerName $ComputerName

        # Run Test Azure Stack to generate MAS logs
        Write-Information "Invoking Test-AzureStack on $ComputerName using session $($jeaSession.InstanceId)"

        $testAzureStackResult = Invoke-Command -Session $jeaSession -ScriptBlock { Test-AzureStack -Ignore AzsStampBMCSummary,AzsHostingInfraFWSummary,AzsGpuConfigurationSummary }

        Write-Information  "Test-AzureStack completed"
    }
    catch
    {
        Write-Error  "Test-AzureStack failed with $_" -Verbose
    }
    finally
    {
        if($jeaSession -ne $null) {
            Write-Information "Removing JEA session $($jeaSession.InstanceId)"
            Remove-PSSession $jeaSession
        }
    }

    return $testAzureStackResult
}

<#
.SYNOPSIS
Executes Get-AzureStackLog
 
.DESCRIPTION
Runs Get-AzureStackLog on the provided endpoint using the current session's credentials
 
.PARAMETER EndpointName
The name of the JEA endpoint to access
 
.PARAMETER ComputerName
The name of the computer on which to invoke the endpoint
 
.PARAMETER ErcsNames
The comma seperated names of ERCS computer
 
.PARAMETER OutputPath
The output path for the logs
 
.PARAMETER FromDate
The starting window from which to start collecting logs
 
.PARAMETER ToDate
The ending time window for collecting logs
 
.PARAMETER $BlobServiceSasUri
Blob Service URI for Azure Storage
 
.PARAMETER $OutputSharePath
Local File Share path
 
.PARAMETER $OutputSharePathUserName
Local File Share path user name
 
.PARAMETER $OutputSharePathPassword
Local File Share path User Password
 
.PARAMETER FilterRoles
The roles to filter on
 
.PARAMETER FilterNodes
The nodes to filter on
 
.PARAMETER FilterLogTypes
The log types to collect
 
.PARAMETER FilterResourceProviders
The resource providers to filter on
 
.PARAMETER AlertBased
Whether the log collection is alert based
 
.OUTPUTS
A result object containing the output path of the logs
#>

function Get-AzureStackLogResult
{
    Param(
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [string]
        $EndpointName,

        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [string]
        $ComputerName,

        [Parameter(Mandatory=$false)]
        [string]
        $ErcsNames,

        [Parameter(Mandatory=$false)]
        [nullable[DateTime]]
        $FromDate,

        [Parameter(Mandatory=$false)]
        [nullable[DateTime]]
        $ToDate,

        [Parameter(Mandatory=$false)]
        [string]
        $OutputPath,

        [Parameter(Mandatory=$false)]
        [string]
        $BlobServiceSasUri,

        [Parameter(Mandatory=$false)]
        [string]
        $OutputSharePath,

        [Parameter(Mandatory=$false)]
        [string]
        $OutputSharePathUserName,

        [Parameter(Mandatory=$false)]
        [string]
        $OutputSharePathPassword,

        [Parameter(Mandatory=$false)]
        [string[]]
        $FilterRoles,

        [Parameter(Mandatory=$false)]
        [string[]]
        $FilterNodes,

        [Parameter(Mandatory=$false)]
        [string[]]
        $FilterLogTypes,

        [Parameter(Mandatory=$false)]
        [string[]]
        $FilterResourceProviders,

        [Parameter(Mandatory=$false)]
        [bool]
        $AlertBased
    )

    $getAzureStackLogResult = $false;
    $uploadErrors = @()
    $uploadSizeInMb = 0
    $uploadNumberOfFiles = 0
    $uploadDirectory = $null

    Import-Module $PSScriptRoot\SessionTools.psm1

    $customerConfigPath = "$env:SystemDrive\ProgramData\Microsoft\AzureStack\config.xml"

    try {

        # Default value for log collection window start, if not specified, should be 4 hours ago
        if ($FromDate -eq $null)
        {
            $FromDate = (Get-Date).AddHours(-4)
            Write-Information "FromDate parameter not specified. Setting to default value $FromDate"
        }

        # Default value for log collection window end, if not specified, should be now
        if ($ToDate -eq $null)
        {
            $ToDate = Get-Date
            Write-Information "ToDate parameter not specified. Setting to default value $ToDate"
        }

        $getAzureStackLogParameters = @{
            FromDate = $FromDate
            ToDate = $ToDate
            FilterByRole = $FilterRoles
            FilterByNode = $FilterNodes
            FilterByLogType = $FilterLogTypes
            FilterByResourceProvider = $FilterResourceProviders
            AlertBased = $AlertBased
        }

        # Provide the customer configuration file to Get-AzureStackLog if it exists
        Write-Information "Checking if config.xml exists: $customerConfigPath"

        if (Test-Path $customerConfigPath)
        {
            Write-Information "$customerConfigPath exists. Adding to Get-AzureStackLog parameters"
            $getAzureStackLogParameters.Add("CustomerConfigurationFilePath", $customerConfigPath)
        }
        else {
            # Considering this a non-terminating error
            Write-Error "$customerConfigPath does not exist. Continuing without a configuration file"
        }

        if (![string]::IsNullOrEmpty($BlobServiceSasUri))
        {
            Write-Information "Using Blob Service Uri for upload $BlobServiceSasUri"
            $getAzureStackLogParameters.Add("OutputSasUri", $BlobServiceSasUri)
            $jeaSession = Get-JEASession -EndpointName $EndpointName -ComputerName $ComputerName
        }
        elseif (![string]::IsNullOrEmpty($OutputSharePath))
        {
            Write-Information "Using Share Path for upload $OutputSharePath"
            $getAzureStackLogParameters.Add("OutputSharePath", $OutputSharePath)

            Write-Information "Adding share creds"
            $password = ConvertTo-SecureString $OutputSharePathPassword -AsPlainText -Force
            $cred = New-Object -TypeName System.Management.Automation.PSCredential ($OutputSharePathUserName, $password)
            $getAzureStackLogParameters.Add("OutputShareCredential", $cred)

            Write-Information "Checking share access locally first"
            $checkStatus = Test-SharePathAccess -SharePath $OutputSharePath -ShareCreds $cred
            Write-Information "Checking share access locally returned: $checkStatus"
            if(!$checkStatus)
            {
                Write-Information "Getting PEP session from ERCS: $($ErcsNames)"
                $jeaSession = Get-EcePepSession -ErcsComputerNames $ErcsNames
            }
            else
            {
                Write-Information "Getting PEP session from SRNG: $ComputerName"
                $jeaSession = Get-JEASession -EndpointName $EndpointName -ComputerName $ComputerName
            }
        }
        else 
        {
            Write-Information "Using Autonomous Log Archival Location for upload $OutputPath"
             $jeaSession = Get-JEASession -EndpointName $EndpointName -ComputerName $ComputerName
             $getAzureStackLogParameters.Add("OutputPath", $OutputPath)
        }

        $getAzureStackLogCommand = 
        {
            Get-AzureStackLog 6>&1 @using:getAzureStackLogParameters
        }


        Write-Information "Invoking Get-AzureStackLog using session $($jeaSession.InstanceId)"
        $azureStackLog = Invoke-Command -Session $jeaSession -ScriptBlock $getAzureStackLogCommand

        Write-Information "Completed Get-AzureStackLog"
        Write-Information "Collecting diagnostic data from Get-AzureStackLog"

        if($azureStackLog -ne $null) 
        {
            $uploadDetails = Get-AzureStackLogDetails $azureStackLog

            $uploadErrors = $uploadDetails.UploadErrorDetails
            $uploadSizeInMb = $uploadDetails.UploadSize
            $uploadNumberOfFiles = $uploadDetails.UploadNumberOfFiles
            $uploadDirectory = $uploadDetails.UploadDirectory
        }
        else 
        {
            Write-Error "Get-AzureStackLog failed to produce an output stream. Diagnostic data will not be collected."
        }
    }
    catch {
        Write-Error "Get-AzureStackLog failed on $ComputerName with $_"
    }
    finally {
        if($jeaSession -ne $null) {
            Write-Information "Removing JEA session $($jeaSession.InstanceId)"
            Remove-PSSession $jeaSession
        }
    }

    # If we have successfully uploaded files to the storage account consider this run a succes
    if (($uploadSizeInMb -gt 0) -and ($uploadNumberOfFiles -gt 0))
    {
        Write-Information "Get-AzureStackLog successfully uploaded logs to $uploadDirectory"
        $getAzureStackLogResult = $true
    }

    # TODO: remove output path key
    return ConvertTo-Json @{ 
        LogResult = $getAzureStackLogResult
        OutputPath = $uploadDirectory
        UploadDirectory = $uploadDirectory
        UploadSizeInMb = $uploadSizeInMb
        UploadNumberOfFiles = $uploadNumberOfFiles
        UploadErrors = $uploadErrors
    }
}

# Extracts a valid folder name from an InformationRecord
function Find-FolderNameMatch {
    Param(
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [PSObject]
        $LogDetail,

        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [string]
        $LogDetailsLabel
    )

    Write-Information "Finding match for $LogDetailsLabel"

    $folderMatch = "[a-zA-Z0-9](?:[a-zA-Z0-9_ -]*[a-zA-Z0-9]){1}$"
    $folderName = ($LogDetail | Select-String -pattern $folderMatch).Matches[0].Value

    if($folderName -eq $null)
    {
        Write-Error "Unable to find a valid folder name"
    }

    return $folderName
}

# Extracts the latest numerical match from an InformationRecord
function Find-LatestNumericalMatch {
    Param(
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [PSObject[]]
        $LogDetails,

        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [string]
        $LogDetailsLabel
    )

    $measureMatch = "\d+(\.\d+)?$"
    $maximum = 0

    Write-Information "Finding the latest match for $LogDetailsLabel"

    $measureMatches = $LogDetails `
    | Select-String -pattern $measureMatch `
    | ForEach {$_.Matches } `
    | ForEach {[decimal]$_.Value}

    #report the maximum in case multiple log messages exist
    $latestDetail = $measureMatches | Measure-Object -Maximum
    if ($latestDetail -ne $null) {
    $maximum = $latestDetail.Maximum
    }
    else {
        Write-Error "Unable to find a maximum for $LogDetailsLabel"
    }

    return $maximum
}

# Retrieves diagnostic data from a Get-AzureStackLog output stream
function Get-AzureStackLogDetails{
    Param(
       [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [PSObject[]]
        $azureStackLog
    )

    # Get-AzureStackLog output tags
    $sizeTag = "LogCollectionUploadFileSizeInMb"
    $numberOfFilesTag = "LogCollectionUploadNumberOfFiles"
    $errorDetailsTag = "LogCollectionUploadErrorDetails"
    $directoryTag = "LogCollectionUploadDirectory"

    # Data capture matches
    $errorDetailsMatch = "$errorDetailsTag.*$"
    $sizeMatch = "FileSizeInMb.*";
    $numberOfFilesMatch = "NumberOfFiles.*"
    $directoryMatch = "$directoryTag.*"

    $logCollectionMatch = "($sizeTag|$numberOfFilesTag|$errorDetailsTag|$directoryTag).*"

    # Default values
    $errorDetails = @()
    $uploadSize = 0
    $uploadNumberOfFiles = 0
    $uploadDirectory = $null

    try 
    {
        # Search the output stream for the output tags
        $uploadDetails = $azureStackLog | Where-Object { $_.MessageData -match $logCollectionMatch }

        if ($uploadDetails -ne $null) 
        {
            # Find all upload error details if present
            $errorDetails += $uploadDetails `
            | Select-String -pattern $errorDetailsMatch  `
            | ForEach { $_.Matches } `
            | ForEach { $_.Value }

            # Find the latest record for upload size
            $uploadSizeMatches = $uploadDetails | Where-Object { $_.MessageData -match $sizeMatch }
            if ($uploadSizeMatches -ne $null)
            {
                $uploadSize = [int](Find-LatestNumericalMatch $uploadSizeMatches $sizeTag)
                Write-Information "${sizeTag}: $uploadSize"
            }
            else 
            {
                Write-Error "$sizeTag details were not present"
            }

            # Find the latest record for the number of files uploaded
            $uploadNumberOfFilesMatches = $uploadDetails | Where-Object { $_.MessageData -match $numberOfFilesMatch }
            if ($uploadNumberOfFilesMatches -ne $null)
            {
                $uploadNumberOfFiles = Find-LatestNumericalMatch $uploadNumberOfFilesMatches $numberOfFilesTag
                Write-Information "${numberOfFilesTag}: $uploadNumberOfFiles"
            }
            else
            {
                Write-Error "$numberOfFilesTag details were not present"
            }

            # Find the upload directory
            $uploadDirectoryMatches = $uploadDetails | Where-Object { $_.MessageData -match $directoryMatch }
            if ($uploadDirectoryMatches -ne $null)
            {
                 $uploadDirectory = Find-FolderNameMatch $uploadDirectoryMatches[0] $directoryTag
                Write-Information "${directoryTag}: $uploadDirectory"
            }
            else{
                Write-Error "$uploadDirectoryTag details were not present"
            }
        }
        else {
            Write-Error "Log collection upload details were not present in the output provided."
        }
    }
    catch
    {
        Write-Error "An error occured while attempting to collect log collection upload details: $_"
    }

    return @{ 
        UploadErrorDetails = $errorDetails
        UploadSize = $uploadSize
        UploadNumberOfFiles = $uploadNumberOfFiles
        UploadDirectory = $uploadDirectory
    }
}

# Checks if share is reachable from given node
function Test-SharePathAccess {
    Param(
        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [string]
        $SharePath,

        [Parameter(Mandatory=$true)]
        [ValidateNotNullOrEmpty()]
        [PSCredential]
        $ShareCreds
    )

    Write-Information "Test-ShareAccessFromNode: Testing SharePath $SharePath access locally"
    $status = $true
    try
    {
        $drive = Get-PSDrive | Where-Object DisplayRoot -eq $SharePath
        if ($null -eq $drive)
        {
            Write-Information "Creating new PS drive: $SharePath."
            $bstr = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($ShareCreds.Password)
            $password = [System.Runtime.InteropServices.Marshal]::PtrToStringAuto($bstr)
            $null = net use * $SharePath /user:$($ShareCreds.UserName) $password
            $drive = Get-PSDrive | Where-Object DisplayRoot -eq $SharePath
            if(!$drive)
            {
                throw "net use is not successful"
            }
        }

        Write-Information "Net Use did not return null. So considering success: $($netuseResult)"
    }
    catch
    {
        Write-Information "Failed to access the share. $_"
        $status = $false
    }
    finally
    {
        Write-Information "Test-ShareAccessFromNode : Cleanup mapped drive"
        if($drive)
        {
            $driveName = $drive.Root -replace "\\",""
            Write-Information "Test-ShareAccessFromNode : Cleaning mapped drive: $driveName"
            $null = net use $driveName /delete /yes
            Write-Information "Test-ShareAccessFromNode : Successfully delete mapped drive"
        }
    }

    $status
}

# Available commands
Export-ModuleMember -Function Get-TestAzureStackResult
Export-ModuleMember -Function Get-AzureStackLogResult
# SIG # Begin signature block
# MIInvgYJKoZIhvcNAQcCoIInrzCCJ6sCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDYaQv7Gh3Wj9OQ
# byFBNOmQggQWNZy+m8z6kLS0crndTqCCDXYwggX0MIID3KADAgECAhMzAAADTrU8
# 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
# /Xmfwb1tbWrJUnMTDXpQzTGCGZ4wghmaAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBIDIwMTECEzMAAANOtTx6wYRv6ysAAAAAA04wDQYJYIZIAWUDBAIB
# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO
# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIE8JzdgMuK4CjUrE6OmRbjx1
# rgJDx4jk6VBAspXDkkj3MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A
# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB
# BQAEggEAZOSYuW1cTthidloAsRm/xTWlirpvU/K3qQIXWjJceJMRVa0PrvNS0XFl
# mjA4NdTw2mGFEpwiITgvi2P6s0gI5shJ5AA7zIxUSDQAQ/tSzOHxJAIDSqhHtCzM
# p4TFV/R4eb9viVBOuVSi4UMli8ubD/BOg152ej9pgurNsjErBUXJoGRvjcZw+29Z
# 9hxrz6nBT9eIO7LVF+Rk+fNyN6Kuf7SozqJIWW8A2djFh3j9b69MVFwFLijE3iEL
# WDymIHLYz8XAFkoeI/EW3cC4v7HS6qPSt5WYTilatVQZ6hzpi5YbmCN9Z9CIbfx8
# IvXZwE8uXbcLf8IP3AXWf9R/hr+caqGCFygwghckBgorBgEEAYI3AwMBMYIXFDCC
# FxAGCSqGSIb3DQEHAqCCFwEwghb9AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsq
# hkiG9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl
# AwQCAQUABCDuCYB86ATE9xPPtFevaahdHV2rzUF9404htGikEv+LbwIGZQr18fE5
# GBMyMDIzMDkyMjA4MzIyMS40NjhaMASAAgH0oIHYpIHVMIHSMQswCQYDVQQGEwJV
# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE
# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl
# bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNO
# OjA4NDItNEJFNi1DMjlBMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT
# ZXJ2aWNloIIRdzCCBycwggUPoAMCAQICEzMAAAGybkADf26plJIAAQAAAbIwDQYJ
# KoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x
# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjIw
# OTIwMjAyMjAxWhcNMjMxMjE0MjAyMjAxWjCB0jELMAkGA1UEBhMCVVMxEzARBgNV
# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv
# c29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3Bl
# cmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjowODQyLTRC
# RTYtQzI5QTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC
# AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMqiZTIde/lQ4rC+Bml5f/Wu
# q/xKTxrfbG23HofmQ+qZAN4GyO73PF3y9OAfpt7Qf2jcldWOGUB+HzBuwllYyP3f
# x4MY8zvuAuB37FvoytnNC2DKnVrVlHOVcGUL9CnmhDNMA2/nskjIf2IoiG9J0qLY
# r8duvHdQJ9Li2Pq9guySb9mvUL60ogslCO9gkh6FiEDwMrwUr8Wja6jFpUTny8tg
# 0N0cnCN2w4fKkp5qZcbUYFYicLSb/6A7pHCtX6xnjqwhmJoib3vkKJyVxbuFLRhV
# XxH95b0LHeNhifn3jvo2j+/4QV10jEpXVW+iC9BsTtR69xvTjU51ZgP7BR4YDEWq
# 7JsylSOv5B5THTDXRf184URzFhTyb8OZQKY7mqMh7c8J8w1sEM4XDUF2UZNy829N
# VCzG2tfdEXZaHxF8RmxpQYBxyhZwY1rotuIS+gfN2eq+hkAT3ipGn8/KmDwDtzAb
# nfuXjApgeZqwgcYJ8pDJ+y/xU6ouzJz1Bve5TTihkiA7wQsQe6R60Zk9dPdNzw0M
# K5niRzuQZAt4GI96FhjhlUWcUZOCkv/JXM/OGu/rgSplYwdmPLzzfDtXyuy/GCU5
# I4l08g6iifXypMgoYkkceOAAz4vx1x0BOnZWfI3fSwqNUvoN7ncTT+MB4Vpvf1QB
# ppjBAQUuvui6eCG0MCVNAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQUmfIngFzZEZlP
# kjDOVluBSDDaanEwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYD
# VR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9j
# cmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwG
# CCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQu
# Y29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIw
# MjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcD
# CDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBANxHtu3FzIabaDbW
# qswdKBlAhKXRCN+5CSMiv2TYa4i2QuWIm+99piwAhDhADfbqor1zyLi95Y6GQnvI
# WUgdeC7oL1ZtZye92zYK+EIfwYZmhS+CH4infAzUvscHZF3wlrJUfPUIDGVP0lCY
# Vse9mguvG0dqkY4ayQPEHOvJubgZZaOdg/N8dInd6fGeOc+0DoGzB+LieObJ2Q0A
# tEt3XN3iX8Cp6+dZTX8xwE/LvhRwPpb/+nKshO7TVuvenwdTwqB/LT6CNPaElwFe
# KxKrqRTPMbHeg+i+KnBLfwmhEXsMg2s1QX7JIxfvT96md0eiMjiMEO22LbOzmLMN
# d3LINowAnRBAJtX+3/e390B9sMGMHp+a1V+hgs62AopBl0p/00li30DN5wEQ5If3
# 5Zk7b/T6pEx6rJUDYCti7zCbikjKTanBnOc99zGMlej5X+fC/k5ExUCrOs3/VzGR
# CZt5LvVQSdWqq/QMzTEmim4sbzASK9imEkjNtZZyvC1CsUcD1voFktld4mKMjE+u
# DEV3IddD+DrRk94nVzNPSuZXewfVOnXHSeqG7xM3V7fl2aL4v1OhL2+JwO1Tx3B0
# irO1O9qbNdJk355bntd1RSVKgM22KFBHnoL7Js7pRhBiaKmVTQGoOb+j1Qa7q+ci
# xGo48Vh9k35BDsJS/DLoXFSPDl4mMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJ
# mQAAAAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT
# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m
# dCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNh
# dGUgQXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1
# WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD
# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEB
# BQADggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjK
# NVf2AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhg
# fWpSg0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJp
# rx2rrPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/d
# vI2k45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka9
# 7aSueik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKR
# Hh09/SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9itu
# qBJR6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyO
# ArxCaC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItb
# oKaDIV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6
# bMURHXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6t
# AgMBAAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQW
# BBQqp1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacb
# UzUZ6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYz
# aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnku
# aHRtMBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIA
# QwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2
# VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwu
# bWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEw
# LTA2LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93
# d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYt
# MjMuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/q
# XBS2Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6
# U03dmLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVt
# I1TkeFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis
# 9/kpicO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTp
# kbKpW99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0
# sHrYUP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138e
# W0QBjloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJ
# sWkBRH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7
# Fx0ViY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0
# dFtq0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQ
# tB1VM1izoXBm8qGCAtMwggI8AgEBMIIBAKGB2KSB1TCB0jELMAkGA1UEBhMCVVMx
# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT
# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxh
# bmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjow
# ODQyLTRCRTYtQzI5QTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy
# dmljZaIjCgEBMAcGBSsOAwIaAxUAjhJ+EeySRfn2KCNsjn9cF9AUSTqggYMwgYCk
# fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD
# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF
# AOi3bmowIhgPMjAyMzA5MjIwOTM3NDZaGA8yMDIzMDkyMzA5Mzc0NlowczA5Bgor
# BgEEAYRZCgQBMSswKTAKAgUA6LduagIBADAGAgEAAgFlMAcCAQACAhRiMAoCBQDo
# uL/qAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMH
# oSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQEFBQADgYEApC9XNPqDY0huGxN+PBHJ
# yLTxWLjVM73f/dotvupO/g0nInapT4q7BoONwMSS8ueL+bEL4cHOVZjDoeWV0eRI
# 1crmWwk96vrxBxq9NDxZbZgbfilKNa28VzLSBzjjYw+ACtCzrX5JzV6EwK+mqNDC
# bDnOLLlXMouQmgYTJU0omXQxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzET
# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV
# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T
# dGFtcCBQQ0EgMjAxMAITMwAAAbJuQAN/bqmUkgABAAABsjANBglghkgBZQMEAgEF
# AKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEi
# BCAOkaGyi9zkfT9uCbp3Etneiv+S8o/yC1vEOQJlAGdsMDCB+gYLKoZIhvcNAQkQ
# Ai8xgeowgecwgeQwgb0EIFN4zjzn4T63g8RWJ5SgUpfs9XIuj+fO76G0k8IbTj41
# MIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO
# BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEm
# MCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAGybkAD
# f26plJIAAQAAAbIwIgQgUJ01CNs15HXo5B55Nvrjm0jjn8iH8oSRGqAC4edRqR0w
# DQYJKoZIhvcNAQELBQAEggIAMrDzNNcU7huTUdd7Y5rB3LtPuvRe2mM49wOtfu4H
# BqztcQmLTJSJ/O3ISE+WF0LOQeIdsZvEtMbDfu4pHwaEl221b0HrGaYcLKvYvH31
# ULgQfTXENC3XGOBdqSJq297uEEc4O9RfloSAI2uOVPyOx1A+ltEyJMoBQXrsXkFt
# +jdSPg60s+mtA95mAT5v+gVH+p5WtT8VxCXk85VSLtLeqxO0PLMgz+7f1yXiSeFn
# juN9oIJg1dEbfUF3OqckVnf1w+t3EISJ2/+mdB0jJKIKHMag7IQuMe2u3d/URkU5
# l7kILHWD51B5eASQVue01fY9OTqnlZrvk+dXZGYvE57ppxogmXNexx81MnGjN00S
# fKZBQKidLjukwYXHd7eLE6LYZtD76N0MbsqesF8INy+GH6SQJFfRexEIzSHMF6Bo
# xH1DL0pBnk0yGt684a+Wo8hH4IOlVtA2tBM/StOSCJLSwFRMkQlE+YVCSLoqsgPW
# hxfEfNK3u7z2e15tRjO6kxrgXspfVWKPY82cGlSiBFzjZ4bu5Q0agTQIQLAwYiBi
# Uo3CLO5UxnKEArIFPiyyq8UuDiY8C3AbuontW8TMqkGX7n4sNdQX3huXWq4+1+ai
# NwHGDwlETCGHNMf/hos//NB/U+hoH2O/YB8zOh2M+PNkGKD+slxTNZZtVeziWdTL
# Oas=
# SIG # End signature block