packages/AzStackHci.DiagnosticSettings.0.6.9/Private/AzStackHci.Artifact.Helpers.ps1
|
# //////////////////////////////////////////////////////////////////////////// # Diagnostic artifact path, ownership, and retention helpers. # //////////////////////////////////////////////////////////////////////////// function Get-AzStackHciArtifactDirectory { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [ValidateSet('Connectivity', 'OsConfig', 'VMCheckpointHealth', 'PageFile', 'MemoryDump', 'UserModeCrashDump')] [string]$ArtifactType, [Parameter(Mandatory = $false)] [string]$RootPath = $script:DEFAULT_DIAG_EXPORT_PATH, [Parameter(Mandatory = $false)] [switch]$Create ) $rootFullPath = [System.IO.Path]::GetFullPath($RootPath).TrimEnd('\') $artifactPath = Join-Path $rootFullPath $script:DIAG_ARTIFACT_RELATIVE_PATHS[$ArtifactType] if ($Create -and -not (Test-Path -LiteralPath $artifactPath -PathType Container)) { New-Item -Path $artifactPath -ItemType Directory -Force -ErrorAction Stop | Out-Null } return $artifactPath } function New-AzStackHciUniqueRunDirectory { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$BasePath, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [string]$Prefix, [Parameter(Mandatory = $false)] [ValidateNotNullOrEmpty()] [string]$Timestamp = ([DateTime]::UtcNow.ToString('yyyy-MM-dd_HHmmss') + 'Z') ) if (-not (Test-Path -LiteralPath $BasePath -PathType Container)) { New-Item -ItemType Directory -Path $BasePath -Force -ErrorAction Stop | Out-Null } for ($collisionIndex = 0; $collisionIndex -lt 1000; $collisionIndex++) { $runStamp = if ($collisionIndex -eq 0) { $Timestamp } else { '{0}-{1:00}' -f $Timestamp, $collisionIndex } $candidatePath = Join-Path $BasePath ("{0}_{1}" -f $Prefix, $runStamp) try { New-Item -ItemType Directory -Path $candidatePath -ErrorAction Stop | Out-Null return $candidatePath } catch { if (Test-Path -LiteralPath $candidatePath -PathType Container) { continue } throw } } throw "Could not allocate a unique '$Prefix' run directory beneath '$BasePath'." } function Test-AzStackHciArtifactPath { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$Path, [Parameter(Mandatory = $false)] [string]$RootPath = $script:DEFAULT_DIAG_EXPORT_PATH ) try { $rootFullPath = [System.IO.Path]::GetFullPath($RootPath).TrimEnd('\') $rootItem = Get-Item -LiteralPath $rootFullPath -Force -ErrorAction Stop $item = Get-Item -LiteralPath $Path -Force -ErrorAction Stop $itemFullPath = [System.IO.Path]::GetFullPath($item.FullName) } catch { return $false } if (($rootItem.Attributes -band [System.IO.FileAttributes]::ReparsePoint) -ne 0) { return $false } $requiredPrefix = $rootFullPath + '\' if (-not $itemFullPath.StartsWith($requiredPrefix, [System.StringComparison]::OrdinalIgnoreCase)) { return $false } $relativePath = $itemFullPath.Substring($requiredPrefix.Length) $currentPath = $rootFullPath foreach ($segment in @($relativePath -split '[\\/]')) { if ([string]::IsNullOrWhiteSpace($segment) -or $segment -eq '.' -or $segment -eq '..') { return $false } $currentPath = Join-Path $currentPath $segment $currentItem = Get-Item -LiteralPath $currentPath -Force -ErrorAction Stop if (($currentItem.Attributes -band [System.IO.FileAttributes]::ReparsePoint) -ne 0) { return $false } } return $true } function Test-AzStackHciArtifactTree { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [System.IO.DirectoryInfo]$Directory ) $pendingDirectories = [System.Collections.Stack]::new() $pendingDirectories.Push($Directory) try { while ($pendingDirectories.Count -gt 0) { $currentDirectory = $pendingDirectories.Pop() foreach ($child in @(Get-ChildItem -LiteralPath $currentDirectory.FullName -Force -ErrorAction Stop)) { if (($child.Attributes -band [System.IO.FileAttributes]::ReparsePoint) -ne 0) { return $false } if ($child.PSIsContainer) { $pendingDirectories.Push($child) } } } } catch { return $false } return $true } function Get-AzStackHciBackupFile { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [ValidateSet('PageFile', 'MemoryDump', 'UserModeCrashDump')] [string]$ArtifactType, [Parameter(Mandatory = $false)] [string]$RootPath = $script:DEFAULT_DIAG_EXPORT_PATH ) $filePattern = switch ($ArtifactType) { 'PageFile' { 'PageFile_Settings_*.json' } 'MemoryDump' { 'MemoryDump_Settings_*.json' } 'UserModeCrashDump' { 'UserModeCrashDump_Settings_*.json' } } $newDirectory = Get-AzStackHciArtifactDirectory -ArtifactType $ArtifactType -RootPath $RootPath $searchDirectories = @($newDirectory, [System.IO.Path]::GetFullPath($RootPath).TrimEnd('\')) foreach ($directory in $searchDirectories) { if (-not (Test-Path -LiteralPath $directory -PathType Container)) { continue } $latestBackup = Get-ChildItem -LiteralPath $directory -Filter $filePattern -File -ErrorAction SilentlyContinue | Sort-Object LastWriteTime -Descending | Select-Object -First 1 if ($latestBackup) { return $latestBackup } } return $null } function Resolve-AzStackHciBackupPath { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$Path, [Parameter(Mandatory = $true)] [ValidateSet('PageFile', 'MemoryDump', 'UserModeCrashDump')] [string]$ArtifactType, [Parameter(Mandatory = $false)] [string]$RootPath = $script:DEFAULT_DIAG_EXPORT_PATH ) $item = Get-Item -LiteralPath $Path -Force -ErrorAction Stop if ($item.PSIsContainer) { throw "Backup path must identify a file, not a directory: '$Path'." } if (-not (Test-AzStackHciArtifactPath -Path $item.FullName -RootPath $RootPath)) { throw "Backup file must resolve beneath the canonical diagnostic root without reparse points. Got: '$($item.FullName)'." } $rootFullPath = [System.IO.Path]::GetFullPath($RootPath).TrimEnd('\') $newDirectory = [System.IO.Path]::GetFullPath((Get-AzStackHciArtifactDirectory -ArtifactType $ArtifactType -RootPath $RootPath)).TrimEnd('\') $resolvedPath = [System.IO.Path]::GetFullPath($item.FullName) $resolvedDirectory = [System.IO.Path]::GetDirectoryName($resolvedPath).TrimEnd('\') if (-not [string]::Equals($resolvedDirectory, $newDirectory, [System.StringComparison]::OrdinalIgnoreCase) -and -not [string]::Equals($resolvedDirectory, $rootFullPath, [System.StringComparison]::OrdinalIgnoreCase)) { throw "Backup file must be directly beneath '$newDirectory' or the legacy root '$rootFullPath'. Got: '$resolvedPath'." } $namePattern = switch ($ArtifactType) { 'PageFile' { '^PageFile_Settings_\d{8}(?:-\d{4})?\.json$' } 'MemoryDump' { '^MemoryDump_Settings_(?:\d{8}-\d{4}|\d{4}-\d{2}-\d{2}-\d{2}-\d{2})\.json$' } 'UserModeCrashDump' { '^UserModeCrashDump_Settings_(?:\d{8}-\d{4}|\d{4}-\d{2}-\d{2}-\d{2}-\d{2})\.json$' } } if ([System.IO.Path]::GetFileName($resolvedPath) -notmatch $namePattern) { throw "Backup filename is not valid for artifact type '$ArtifactType'. Got: '$resolvedPath'." } return $resolvedPath } function Test-AzStackHciBackupArtifact { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [ValidateSet('PageFile', 'MemoryDump', 'UserModeCrashDump')] [string]$ArtifactType, [Parameter(Mandatory = $true)] [System.IO.FileInfo]$File ) try { $backup = Get-Content -LiteralPath $File.FullName -Raw -ErrorAction Stop | ConvertFrom-Json -ErrorAction Stop if ($backup.BackupSchemaVersion -ne 1 -or [string]$backup.Checksum -notmatch '^[0-9a-fA-F]{64}$') { return $false } $verifyObject = switch ($ArtifactType) { 'PageFile' { [PSCustomObject][ordered]@{ BackupSchemaVersion = $backup.BackupSchemaVersion BackupDate = $backup.BackupDate Node = $backup.Node PageFileAutoManaged = $backup.PageFileAutoManaged PageFileConfig = $backup.PageFileConfig PageFileUsage = $backup.PageFileUsage } } 'MemoryDump' { [PSCustomObject][ordered]@{ BackupSchemaVersion = $backup.BackupSchemaVersion BackupDate = $backup.BackupDate Node = $backup.Node CrashDumpMode = $backup.CrashDumpMode Settings = $backup.Settings } } 'UserModeCrashDump' { [PSCustomObject][ordered]@{ BackupSchemaVersion = $backup.BackupSchemaVersion BackupDate = $backup.BackupDate Node = $backup.Node Settings = $backup.Settings } } } $verifyJson = $verifyObject | ConvertTo-Json -Depth 3 -Compress $sha256 = [System.Security.Cryptography.SHA256]::Create() try { $hashBytes = $sha256.ComputeHash([System.Text.Encoding]::UTF8.GetBytes($verifyJson)) $computedChecksum = ([System.BitConverter]::ToString($hashBytes)).Replace('-', '').ToLowerInvariant() } finally { $sha256.Dispose() } return $computedChecksum -eq ([string]$backup.Checksum).ToLowerInvariant() } catch { return $false } } function Test-AzStackHciArtifactUnlocked { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [System.IO.FileSystemInfo]$Item ) try { $files = if ($Item.PSIsContainer) { @(Get-ChildItem -LiteralPath $Item.FullName -File -Recurse -Force -ErrorAction Stop) } else { @($Item) } } catch { return $false } foreach ($file in $files) { $stream = $null try { $stream = [System.IO.File]::Open($file.FullName, [System.IO.FileMode]::Open, [System.IO.FileAccess]::Read, [System.IO.FileShare]::None) } catch { return $false } finally { if ($stream) { $stream.Dispose() } } } return $true } function Get-AzStackHciOwnedArtifact { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [ValidateSet('Connectivity', 'OsConfig', 'VMCheckpointHealth', 'PageFile', 'MemoryDump', 'UserModeCrashDump')] [string]$ArtifactType, [Parameter(Mandatory = $false)] [string]$RootPath = $script:DEFAULT_DIAG_EXPORT_PATH ) $rootFullPath = [System.IO.Path]::GetFullPath($RootPath).TrimEnd('\') if (-not (Test-Path -LiteralPath $rootFullPath -PathType Container)) { return } $typedDirectory = Get-AzStackHciArtifactDirectory -ArtifactType $ArtifactType -RootPath $rootFullPath $searchDirectories = @($typedDirectory) if ($ArtifactType -ne 'VMCheckpointHealth' -or $typedDirectory -ne $rootFullPath) { $searchDirectories += $rootFullPath } $seenPaths = @{} foreach ($directory in $searchDirectories) { if (-not (Test-Path -LiteralPath $directory -PathType Container)) { continue } foreach ($item in @(Get-ChildItem -LiteralPath $directory -Force -ErrorAction SilentlyContinue)) { if ($seenPaths.ContainsKey($item.FullName) -or -not (Test-AzStackHciArtifactPath -Path $item.FullName -RootPath $rootFullPath)) { continue } $owned = $false $isBackup = $ArtifactType -in @('PageFile', 'MemoryDump', 'UserModeCrashDump') if ($isBackup -and -not $item.PSIsContainer) { $namePattern = switch ($ArtifactType) { 'PageFile' { '^PageFile_Settings_\d{8}(?:-\d{4})?\.json$' } 'MemoryDump' { '^MemoryDump_Settings_(?:\d{8}-\d{4}|\d{4}-\d{2}-\d{2}-\d{2}-\d{2})\.json$' } 'UserModeCrashDump' { '^UserModeCrashDump_Settings_(?:\d{8}-\d{4}|\d{4}-\d{2}-\d{2}-\d{2}-\d{2})\.json$' } } $owned = $item.Name -match $namePattern -and (Test-AzStackHciBackupArtifact -ArtifactType $ArtifactType -File $item) } elseif ($ArtifactType -eq 'Connectivity' -and -not $item.PSIsContainer) { $owned = $item.Name -match '^(?:Transcript_)?AzureLocal_ConnectivityTest_[A-Za-z0-9]+_[A-Za-z0-9._-]+_\d{4}-\d{2}-\d{2}-\d{2}-\d{2}-\d{2}\.(?:html|json|csv|log)$' } elseif ($ArtifactType -eq 'OsConfig') { if ($item.PSIsContainer -and $item.Name -match '^.+-\d{8}-\d{6}$') { $reportFiles = @(Get-ChildItem -LiteralPath $item.FullName -File -Force -ErrorAction SilentlyContinue | Where-Object { $_.Name -match '^.+_AzureLocal_OsConfigReport-\d{4}-\d{2}-\d{2}-\d{2}-\d{2}-\d{2}\.(?:html|json)$' }) $owned = $reportFiles.Count -gt 0 } elseif (-not $item.PSIsContainer) { $owned = $item.Name -match '^.+_AzureLocal_OsConfigReport-\d{4}-\d{2}-\d{2}-\d{2}-\d{2}-\d{2}\.(?:html|json)$' } } elseif ($ArtifactType -eq 'VMCheckpointHealth') { if ($item.PSIsContainer) { $owned = $item.Name -match '^CheckpointAudit_\d{4}-\d{2}-\d{2}_\d{6}Z$' } else { $owned = $item.Name -match '^VMCheckpointAudit-[A-Za-z0-9._-]+-\d{4}-\d{2}-\d{2}\.html$' } } if (-not $owned) { continue } if ($item.PSIsContainer -and -not (Test-AzStackHciArtifactTree -Directory $item)) { continue } $seenPaths[$item.FullName] = $true $lastWriteTime = if ($item.PSIsContainer) { $latestChild = Get-ChildItem -LiteralPath $item.FullName -File -Recurse -Force -ErrorAction SilentlyContinue | Sort-Object LastWriteTime -Descending | Select-Object -First 1 if ($latestChild) { $latestChild.LastWriteTime } else { $item.LastWriteTime } } else { $item.LastWriteTime } [PSCustomObject]@{ ArtifactType = $ArtifactType Path = $item.FullName LastWriteTime = $lastWriteTime IsBackup = $isBackup IsDirectory = [bool]$item.PSIsContainer } } } } function Write-AzStackHciStaleArtifactWarning { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [ValidateSet('Connectivity', 'OsConfig', 'VMCheckpointHealth')] [string]$ArtifactType, [Parameter(Mandatory = $false)] [string]$CurrentRunPath ) $cutoff = (Get-Date).AddDays(-$script:DIAG_REPORT_RETENTION_DAYS) $stale = @(Get-AzStackHciOwnedArtifact -ArtifactType $ArtifactType | Where-Object { $_.LastWriteTime -lt $cutoff -and (-not $CurrentRunPath -or -not [string]::Equals($_.Path, $CurrentRunPath, [System.StringComparison]::OrdinalIgnoreCase)) }) if ($stale.Count -gt 0) { Write-Warning ("{0} module-owned {1} artifact(s) are older than {2} days. Review them with Remove-AzStackHciDiagnosticArtifact -ArtifactType {1} -WhatIf." -f $stale.Count, $ArtifactType, $script:DIAG_REPORT_RETENTION_DAYS) } } # SIG # Begin signature block # MIInUgYJKoZIhvcNAQcCoIInQzCCJz8CAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCC2Rdkptzi8rouj # zch2f4TU7BTO1QUnbOq5d/OYQtn99KCCDMkwggYEMIID7KADAgECAhMzAAACHPrN # xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD # b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1 # OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD # VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB # DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP # oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC # /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf # rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j # qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT # xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B # Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O # BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL # EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT # DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw # YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w # cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy # bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z # b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl # MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC # AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN # rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK # 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK # Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY # BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu # uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE # msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz # 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6 # U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO # 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD # 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC # EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT # AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS # b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX # DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ # Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq # lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo # 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv # QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a # 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1 # FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO # GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7 # ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ # uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS # CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm # VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3 # SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E # BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX # LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB # Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP # oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv # TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw # TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv # TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC # AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D # 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY # nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI # vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6 # aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w # PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7 # RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK # /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK # YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw # YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT # Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghnfMIIZ2wIBATBu # MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc # +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG # CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEICsIi9paBPQ5YhfYkVQ1m2ynJ45l # KYFgpeqUGAyzDjRpMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv # AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE # ggEAxDz3phKv6lRw48tBK3939wwzxNk7acZhmv7gnSg5jlNbJRMa2MX2sTpkeJaz # gH6ax0IErBvOAmOV+hIqxkYvzSo1Pk8SYfhUhjVdDoJB8tTyNrzltgAzIoIwJOWX # kAkzsmId40O15mAL8XGi5xpqBErIQ2bPtLudzk9Zhrk6Gu8NuYVciSAygAa2x8Tc # S0lRVVEPzj9kWH3BTl5+tN6w09zV0v3LpK9UMptYojRbt3iwshz6UEz9JoWE/G/m # NjBqZqTRCDP+d0FxksSMjgGpUi2p2RHrdUDiL0lLcXJYvGpTo2N76hGGbXOpBs74 # WgtYl+lOUPkVXFYd7TfbxPI9O6GCF68wgherBgorBgEEAYI3AwMBMYIXmzCCF5cG # CSqGSIb3DQEHAqCCF4gwgheEAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsqhkiG # 9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC # AQUABCC6ZRSqaLSrZ+TIjiK4Ntyx0i7nxHXhlO3Wpx435lnecQIGaomzuzYxGBIy # MDI2MDkwMjE1MjczNS43MlowBIACAfSggdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k # IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjU1 # MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2 # aWNloIIR/jCCBygwggUQoAMCAQICEzMAAAIb0LK4Amf3cs8AAQAAAhswDQYJKoZI # hvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO # BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEm # MCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjUwODE0 # MTg0ODMwWhcNMjYxMTEzMTg0ODMwWjCB0zELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0 # aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NTUxQS0wNUUw # LUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIi # MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCOxZ3nZlmTMHld7mD+XYaw6MDP # fSyDqNXF8UlX7DjEgNXJojcs7xsimbNi6XcBkeDnRQhDw+tJFkalCoWRE276jdgo # niDa4ZgFGSwecdhHS5VIJCDnxOGRjJ6mUZfegC8ZFW48ilC0CJOxHvoD+B2hTscP # ARtvvdsnBPKtsoeFH5ZozL0NAcjiTlCjj5tkOzSSPvpu+Em90ZT5LzPFAGntQCGM # mcWorEi6xIhMTvMIJHjbYQuGSFVU4WorbDqHUwC8gt7vqHFEhw+PRIEvavw723Hm # eNTj62DasB1TXnembKGprN2lRxxgET3ANEVR3970KhbHtN2dSJwH4xqLtFPqqx7t # 7loapfUHtueP9ke+ut8X4EkQiVL2INcBSB6S9dn4VmaO8vA/5037T9yuH76vh7wW # ScXsRfogl+eY14M3/rxnn2RtonV/4/macph/J0J5mbGsalLS1paQOTfoPeM9Vl+W # /Gtz7WuEIiUzm/1qAsQUjXZCIFN+k4E4GvcAYI+T54fT6Vq2NBqO6D7b8EPXapvz # bnTQtDK1RZPai1r8didGBK/WO9nT92aXUWzFZjM6cKuN90H/s3qk3JK3i+f48Y3p # 0UuKbuTGiz4H1Z9A97MmLd+4rLIMAH3NIc+PVm7ydl95xkn26bjOPsMWC8ldMNOc # bmqUbhl1sVFr+ut/OQIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFLa+n3f+XEumk0rw # 6Rq4nYC82YhQMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1Ud # HwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3Js # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggr # BgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNv # bS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIw # MTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgw # DgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQBmRTVfFAPg5MzcZOG3 # fZNdKEh88Ggx9KwWwFCoU5mosk7HIk6WUgEWmam860Y0+QLlnyV0bxoKm+AU2j+M # NZ5PkWJbnd0CP0qdnGmxDc9/l9HNIYdFzEQw51chXMMnBxlRfRyN/GdrvJ02/x5c # H9eTobpLKtHY4fpLUscxbXWbdS8oX54uMg+XjmvGKa4MKgR35p3SU4BcDn+9k4o3 # mf949h4/QtFyFlfRDofyf9mZI8yVuWLcw7znVDT1GZP9kYdr78V3L5YsOvBxjKRX # 2ZTL/hNvArDoW11Hpk8fEx0iLWmTxjaYL8bMKrQsKwfS5MV5DpDs1zcxGYRH/eYt # ZSFtpYeBfUVthyG9HbZv4G6n5g9HlD/QGFpoA3oAgF9waz67+cmggHLJkoDxxPIK # adQj/i9boPi/LCDdcEV/h/YPAUfL96+wL7nwoyX6TbBrTlfaQrRP9sI8uFqi/1lf # KhtrB804tgaJq4pPYVa9vBnMcgUJPGMHDDo+3m5G8IT+OdRx//GGU4YyfqIo71e3 # j29lMTZJ8gGT/fiItNEEnoftoY9NNCfNrc59a7X91HJwLpaXmiezc+OcZdNIpLFe # WUk+aDpH+6Uaic/9QJignqY34ReN/IMs9cuqyv3X5VMbWtjNEKM/AEUAe/gQjBoT # RqMKt/vl5QYjf6hdTRQ/quWhnzCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkA # AAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX # YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg # Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl # IEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVow # fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl # ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd # TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUA # A4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX # 9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1q # UoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8d # q6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byN # pOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2k # rnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4d # Pf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgS # Uei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8 # QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6Cm # gyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzF # ER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQID # AQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQU # KqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1 # GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0 # dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0 # bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMA # QTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbL # j+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1p # Y3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0w # Ni0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3 # Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIz # LmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwU # tj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN # 3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU # 5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5 # KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGy # qVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB6 # 2FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltE # AY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFp # AUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcd # FYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRb # atGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQd # VTNYs6FwZvKhggNZMIICQQIBATCCAQGhgdmkgdYwgdMxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5k # IE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjU1 # MUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2 # aWNloiMKAQEwBwYFKw4DAhoDFQCGhXqvj0zgYF3jUrVFgHVnR/jO4KCBgzCBgKR+ # MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS # ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT # HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA # 7kKxlTAiGA8yMDI2MDkwMjE0MzA0NVoYDzIwMjYwOTAzMTQzMDQ1WjB3MD0GCisG # AQQBhFkKBAExLzAtMAoCBQDuQrGVAgEAMAoCAQACAgYOAgH/MAcCAQACAhJqMAoC # BQDuRAMVAgEAMDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEA # AgMHoSChCjAIAgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAHBa9rRKPJMuEWgA # lyXaC1TzqEBpHhmakhKLIOEkskYDRMhzDB47cDMwGT1JbHHkgGzCYdhGrtqdzl7E # 6ctkaWeWJuUVVzKT3AYrNnuHZ8yJ/KOkU1EEUXUQS7QLdU7RpyP7s5308uHg1kpc # 0NwPXd5BPeFHdeNsbtbFNY7svrn0Q8a035rKfGQfihgJaynlPJN7NS2l+hUNi8bG # uNsiVN9MmWcows//piEwy2bxEJ4zHDNaDUobg0Mc8r8D+GsQyjtoQDOTQRnigkvO # boyJk+fZe+QRnar/jntUBZFLrHSpNUSLhVJP/BRlrgYC5ZT/c7QSNV97U3mQUjW8 # yo7n44kxggQNMIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx # MAITMwAAAhvQsrgCZ/dyzwABAAACGzANBglghkgBZQMEAgEFAKCCAUowGgYJKoZI # hvcNAQkDMQ0GCyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCBTkhR3r2xDhNws # jKZYP6nKL+cC0fhbeqi1RFUwcqmhtjCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQw # gb0EIDAlFJW4PaOYxxAIVd0u4kDAOlRU1nptzp18lTzdDYuAMIGYMIGApH4wfDEL # MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v # bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWlj # cm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIb0LK4Amf3cs8AAQAAAhsw # IgQgW+f0TDBJSYFvFC9GsAsdJ9pfBcdWr+DHda7iL7RntpEwDQYJKoZIhvcNAQEL # BQAEggIAUcEg9ZQJubnVUE3aQXrFTWAZBPLGsOj2AoNT/nUuDLBk/nNXpQdAdAr2 # TcdJFcCUttKM9/EWYPGdS4WDL4c4TMY/v8t/c5iM1/iYOE1nQYjsGZ7D2GwO6Qct # qLO7XcNqtSNVOPIhVY/njF16mNDbYgEuUnYC5kioGslPee74LxI1hyt3quqey4tP # B33LnzpGaBQWD8oVVUg+hINop4nqUwuT5SpI14y9Z+Z8KUZJ77DTjlTYGvTriaxv # CMMksVWdg440NPAbcdxxh1UrlBIa4FcTCiVgtFk1YBJU9R5Zs05yNGkEdxyeSD2A # 6SPxpOjrLy4ybtSnbP5YFzZ++yjLcBazk0uTNguszNMG2dtX6vD/yBjgxjH64vd4 # j+pTgYPJJU4Em/rEp8GdoBoIstJGnMjXnx80NpcuZKGKtNBKnOkTnL31xBFlgFqd # 2J9pO5TdJ+a18mQ3IaTAjHEQfjoKL2Xo2gz5HDbDLuUDPMKI1VtyBiDJ2h9x0Q/5 # 3KasAkE1KFOdWyu71o/upj+vwGXI99Myy7W+Mvzy+lPFYPNtTXRi5HbSvOw6xRdb # p7r/XnlEYjvzpkJOYF9YSDIe8EjrGbCgQ54Yn6bKLVbEAsZdxOErwTUiK7wQkkqn # OEeEmoOJI4BU1ngLt3WVjxUkf5wyFoSt8tr1BoyBCNdTxqhm2Ag= # SIG # End signature block |