packages/AzStackHci.DiagnosticSettings.0.7.1/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 # MIInRAYJKoZIhvcNAQcCoIInNTCCJzECAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCC2Rdkptzi8rouj # zch2f4TU7BTO1QUnbOq5d/OYQtn99KCCDLowggX1MIID3aADAgECAhMzAAACHU0Z # yE7XD1dIAAAAAAIdMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD # b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQzWhcNMjcwNDE1MTg1 # OTQzWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD # VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB # DwAwggEKAoIBAQDQvewXxx9gZZFC6Ys1WBay8BJ8kGA4JQnH5CMafqOASlTpK9H8 # o5ZXTXt0caVQTNMUPt445wXYD+dFtaKWTwDn1I52oUSrC9vJin1Gsqt+zyKJL5Dg # 3eQXbQNR61DmMy20GLTIO3SFed9Rfi/ophgCLGFLDR3r0KvHjwMb/jYWS0celV/4 # Lz27LfAekm8v9E5IXaeiXbAUYZKK090n4CVl3JBtbN+9DtI9SNu/yjvozW52/u7R # X/Ttpa/KDlpuokZ+Zcbvmtd9ur9gFLvZzh41o9MsE/clQtdaFWGvuo6Jua/ntpgk # ey3E5/vBFe+MJPG6phdnuo6r57ZudCudiI1bAgMBAAGjggGbMIIBlzAOBgNVHQ8B # Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O # BBYEFH6QuMwqcPG0hQlQ6c5jCtTTLrVeMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQL # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAxMis1MDc1NTkw # HwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEwYAYDVR0fBFkwVzBVoFOg # UYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0 # JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNybDBtBggrBgEFBQcBAQRh # MF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv # Y2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy # dDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBKTbYOjzwTG/DXGaz9 # s6+fQeaTtDcFmMY+5UyVFCyj7Pv+5i37qfX8lSL/tBIfYQfWsMuBQlfZurJD6r4H # VJ2CeH+1fgiq8dcHdVKoZ3Sa2qXoX3cq9iS8cVb06B7+5/XJ7I0OxHH9fDsvJ3T3 # w5V/ZtAIFmLrl+P0CtG+92uzRsn0nTbdFjOkLMLWPLAU3THohKRlSEMgFJpPkm5n # 5UAZ35xX6FWCrDLsSKb555bTifwa8mJBwdlof0bmfYidH+dxZ1FdDxvLnNl9zeKs # A4kejaaIqqIPguhwAti5Ql7BlTNoJNwxCvBmqW2MQLnCkYN/VVUsR3V2x/rcTNzo # Bf/Z/SpROvdaA2ZOOd1uioXJt3tdLQ7vHpqpib0KfWr/FWXW10q38VxfCnRQBqzb # SuztR7nEMuzX7Ck+B/XaPDXd1qh72+QYyB0Z2VzWmO9zsnb9Uq/dwu8LGeQqnyu6 # 7SDGACvnXii2fb9+US492VTnXSnFKyqwgzUyFMtZK1/sHYTv6bG4TtQUygQxTN+Z # V+aJIlKO2MqZ7bKrAnOzS9m6NgoTdWOq11bTOZwKlIEV/EhV9SWkDmdpR/hPPT2v # 6TEj4F8PT/zHjRezIU5c/DGlt/VhY/pK0XkJtEyMmmS1BMtjU/rqBZVMIm3dnxQs # /TBByr+Cf8Z1r7aifQVQ+WSqzjCCBr0wggSloAMCAQICEzMAAAA5O7Y3Gb8GHWcA # AAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX # YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg # Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl # IEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoXDTM2MDMyMjIyMTMwNFow # VzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEo # MCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAyNDCCAiIwDQYJ # KoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeqlRYHNa265v4IY9fH8TKh # emHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo0dtS/EW6I/yEL/bLSY8h # KpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATvQVL4tcf03aTycsz8QeCd # M0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a1uv1zerOYMnsneRRwCbp # yW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1FyQfK0fVkaya8SmVHQ/t # Of23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfOGSWHIIV4YrTJTT6PNty5 # REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7ttOu1bVnXfHaqPYl2rPs # 20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJuz2MXMCt7iw7lFPG9LXK # Gjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxSCwyoGIq0PhaA7Y+VPct5 # pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOmVQop36wUVUYklUy++vDW # eEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3SkE/xIkgpfl22MM1itkZ # 35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8EBAMCAYYwEAYJKwYBBAGC # NxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPXLQaUEggxMBkGCSsGAQQB # gjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU # ci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny # bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAx # MV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0 # dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx # MV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOCAgEAFJQfOChP7onn6fLI # MKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D5W4wMwYeLystcEqfkjz4 # NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBYnbu0+THSuVHTe0VTTPVh # ily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSIvgn0JksVBVMYVI5QFu/q # hnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6aR9y34aiM1qmxaxBi6OU # nyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4wPKC5OmHm1DQIt/MNokbb # H3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7RTX8AdBPo0I6OEojf39z # uFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK/fg8B2qjW88MT/WF5V5u # vZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSKYBv0VisCzfxgeU+dquXW # 9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkwYTu/9dLeH2pDqeJZAABV # DWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVTQl0v4q8J/AUmQN5W4n10 # 1cY2L4A7GTQG1h32HHAvfQESWP0xghngMIIZ3AIBATBuMFcxCzAJBgNVBAYTAlVT # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv # c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w # DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ # KoZIhvcNAQkEMSIEICsIi9paBPQ5YhfYkVQ1m2ynJ45lKYFgpeqUGAyzDjRpMEIG # CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAwIaZWmnqvmKecXjT # G5RCtefE2xOe25ZsVEY3VG9MmPPqkRCf0JrdD15mmHHiZYuntfIFoJyfmrB5c1cq # xoPeR0QGYUU0MMZ8IgIYIkaL8cGtHx1RdOZRqBDA3tcO6h6S35ceQPrcGNWNrVoB # stJnbCLZqzbCc4n5EsKPLbo5ANchGkuZo0SiVnUHDjFXeaJes2Rh8ZiMX4aUXMD2 # ZOO2B/i0ahc1c/iOsXO+Yo0Uuj+bCG+OXpcUhYmFMgK8YnFNtpTUUxNyWbHKH1YM # 6j8aL/VCYFH7ClOg7j0dDZkYUVl/7tGzp3dwznf4VNCA/oHDt+/0XgZ7oUecNCiP # fSk3ZqGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kw # gheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFF # MIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCDADbzUHherwIzY # hUOIdwR+VNphQ1XydhOxklm6oTNMoQIGat04sIq0GBMyMDI2MTEwMjE0NTAyMC41 # MjNaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo1MjFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIF # EKADAgECAhMzAAACF3H7LqWvAR3qAAEAAAIXMA0GCSqGSIb3DQEBCwUAMHwxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv # c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgyM1oXDTI2MTEx # MzE4NDgyM1owgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # LTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjUyMUEtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF # AAOCAg8AMIICCgKCAgEAwM82sEw+39vYR7iGCIFDnYNhRM+BzF2AYiq5dUpZpJFP # RjCcipQ6RUbI+RAYNRApExx5ygrXbaWtuwvqsqAVSWbU/W6fecujjILkPqn9pngt # WRkfQgbYgvaXALl6PY2yOH9f72MD+6AyxQenSpAMdUzY/Qk/jtjsHdFXVBe+tshl # IkSJ3GZw8VVKqTg3GZElztwbJWNtrhBEvhf6anxMegQMJP7tO8/BJ7ITs4/AV3D2 # bv8eHk81Y+fOmQ8mQ61WLq2wItvlzIT5bzelK9LvEycf5x1lXxAwEw5a7dpS+CKT # anhtv+Q2mwebAybjf9io4k48stTaq1rtcrOiDwddqVm1S9e8h1TszXFzjLLvE9Em # jnNfIewsY+RChUaHnY4FFwwJEnEv/JS76oHT0oGdy7+J60fGOl7A1UoUyAkhpb2B # ja+SwSIiHbQ4FDyJiLlZ6drZZ84MoJ852JSxM0hBjGO6FZlPO8iuNyk680Di8Vnb # SNpIdJN+DhlepeTUMBDHqCmd0mVWRWZPm1pvgty93asNt/Ng6o4m2dnooWOdM3yK # sJaWjyHqic9gfTrZBM+PCXqeTaO1oEiaQ+h4w0nHVdV+XSvI2m1yN4iibqjm5HPa # AO3OJ+OmNLftNVmr4Z6U2T6pIcLBysoKcDUvCqycXj4C/+n1KFBpDGdDMw9gmu8C # AwEAAaOCAUkwggFFMB0GA1UdDgQWBBRQrN9jlwNOoeE5ZQqnF5x8S1bJQzAfBgNV # HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU # aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG # CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV # HRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIH # gDANBgkqhkiG9w0BAQsFAAOCAgEARmgFdhB7xIAIHEEg5I/5S+gx67aR6RiW8ZAw # tE3mz8o0dyn+pIP+lidNR1IKQQ0r+RjYgI9cZ6mbvAyvh3e2q/BV8rjHE3ud9PyY # yq32euFgdZ3vX4b5QXePWlpBAYrdziR27rHz6WwpH5dZsSypbXDBbQkWkNl6g82y # Ty3AbBbKDXBdzxZsEauaOplatK7Er4dhglKBex8JQ2dMSkSZweCNDXqd9r/9W2Vd # RZsDJKP/Xc4UyQlVsboBotKtYESXFkjwR1HVsH+Q0C69/N5CP/Tq3YgI1ub4b9+3 # MJFKWhJXCcJGFZkcLwUmYwoFg1XLo7DLJdGjrIH1jsI2NFXJFQHef6AdRe1ERvYQ # eqtyrBvxIvR+P/83FNYyzx04inUT9TF2AwTOuqCC6Z67oNwR4pEEJyAIEREvkdhj # jfWcgsk/nGTlfahvNY/SOHrNRKo49KDlccNzRCJQyQ+D59r7/qebNSyQPTfwI9++ # jEY0Q/UWKVNLhio55GYBseJ99s7NzkdxOr9Uftp597HEovbA69qGlZ3OpUE3H1RB # GDVp/FvM2uXTum8LrMkPXx5Ap/kbPASsC9ju9oMCe2IEXO2SeD1aD3IqvAOdHFKH # g1vpbPUQSWb6g2xfBV30wFcqaPYgzcbxPWPyZqK+S8l7zw64aO5hmJ7eQwoMfTu0 # Vay6r48wggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3 # DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G # A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIw # MAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAx # MDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVT # MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1l # LVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA # 5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/ # XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1 # hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7 # M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3K # Ni1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy # 1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF80 # 3RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQc # NIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahha # YQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkL # iWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV # 2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIG # CSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUp # zxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBT # MFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jv # c29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYI # KwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGG # MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186a # GMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3Br # aS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsG # AQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29t # L3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcN # AQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1 # OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYA # A7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbz # aN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6L # GYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3m # Sj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0 # SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxko # JLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFm # PWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC482 # 2rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7 # vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDWTCC # AkECAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo1MjFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsO # AwIaAxUAabKAFaKt2haUdqkHfFYzAzfgSMuggYMwgYCkfjB8MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt # ZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO6S6vYwIhgPMjAyNjEx # MDIxMDU2NTRaGA8yMDI2MTEwMzEwNTY1NFowdzA9BgorBgEEAYRZCgQBMS8wLTAK # AgUA7pLq9gIBADAKAgEAAgIBqwIB/zAHAgEAAgIS8zAKAgUA7pQ8dgIBADA2Bgor # BgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAID # AYagMA0GCSqGSIb3DQEBCwUAA4IBAQBABzMKiFx24wQ1+WrV16lhfVJXrgYeqc6v # D/BZQak+M8145wPHAPVzomLCsRzyyK9ebZXDeXWsGaF1CO5/RjtZwUpDVwbed6nH # uPLPbX5fH8C8+sew40HR8/VFARoBcX2DEKNab1q1JTdf9JCWE4jHhzVlOTKwhcyV # ulGZt9ANE31EgCxs77AQN/ALrpXuJMoNmHsDuc9v7TW92bjmTu2eck5Ev30fZDQr # Yc9YbffoJl5Fj//w6LvclRc2yoeFFmsulIf0VTWuEM3RC189/vTTdIrizT+mVysP # FPkNd1eb3vdv4yLOfwvXymoDIF+RoRm7hP9HH+coABHiX7YX5D/cMYIEDTCCBAkC # AQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV # BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG # A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIXcfsupa8B # HeoAAQAAAhcwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG # 9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgX/fJ4gGzewu5HICc2D+RzRQPh9dT08dJ # RbCqEZSMd1wwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCDQ8lBgPl23yZ0S # zUSt5phOIegHPywrkNwevxe2k+RaWzCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0 # YW1wIFBDQSAyMDEwAhMzAAACF3H7LqWvAR3qAAEAAAIXMCIEIIj9CW4BcqKwJEH9 # apUUTQ03OwNM/R5FWPX+KRio3YvSMA0GCSqGSIb3DQEBCwUABIICAAYUpl3qjMGa # 2t2S/Y1RuKvbXeYX2Isx/OrUtjaiwkHupVbkN9dh5XQBX1e4+BZcZJ2B+Wz2NEPi # lNnD1NALHXbAPSH8rWLoWge+qLhjmJm66CUhY36/9uTOj/PWMP9RWuad6ZUiOgjd # O075vi2Rq1ZzXWhgWRAPdKDxBaoPCYFeSU9G3lZvgRx51aOtXX4Zesv9OmaUEqIN # fnDKcic3UjP+uOh9r/OJg1a9vvfQU7CVAqVvbyinJLEKDiIOGF1JzfbkBK9FQ5HT # zr8kZ8skOVWi86gBCLyGvgoJZWBJNFV0nY9D9OrGxBXcX9Yhf+nkK2H5n/OolHOM # B3u6zJdGH4OU1FDj0SohzEgzKydsJDnyGTKtsc6TCGibUTfMPVPU7kr8gl3WQ9wM # aM4U2FyAdGXpCrhF98FWQl16mCgIXEg+6UQ7Vvuat3TmUzdAZOeCPtgpwmpeZvMJ # 0N9Wh7qH1yfYowsswQnSdyIHtvSasBf7vikaLqewwiALfl9Kh4fmr1xUZdsDdnUg # KYMeHqbgq5AS44LSn7DzcHs1R4h7WwmlBpsfYhTuB0ka6oi88H1jSkla57SoofSG # lhrvQCuSvk7gcU2MFozpnTzYUz1I8Babo5ZY12fhSuJdlInXhOOICmPhtnT+1cA4 # gFdWJLs7CTbI8e+pOWVxpi4XSDzdxTZu # SIG # End signature block |