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+VNphQ1XydhOxklm6oTNMoQIGaq1t29KZGBMyMDI2MTAwNTIwMjkyNi45 # NjhaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjozNjA1LTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIF # EKADAgECAhMzAAACE7BDNWbPr5XoAAEAAAITMA0GCSqGSIb3DQEBCwUAMHwxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv # c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgxN1oXDTI2MTEx # MzE4NDgxN1owgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # LTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjM2MDUtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF # AAOCAg8AMIICCgKCAgEA9Jl64LoZxDINSFgz+9KS5Ozv5m548ePVzc9RXWe4T4/M # plfga4eq12RGdp5cVvnjde5vxfq2ax/jnu7vUW4rZN4mOUm5vh+kcYsQlYQ53Fwg # IB3nEjcQHomrG3mZe/ozjFSAr6JbglKtIeAySPzAcFzyAer5lLNUHBEvQMM8BOjM # yapCvh0xsg4xKFcVEJQLKEfCGBffMZI/amutHFb3CUTZ7aVpG2KHEFUNlZ1vwMKv # xXTPRDnbwPGzyyqJJznfsLNHQ4vXt2ttS1PeCoGI0hN1Peq8yGsIXM9oocwC06DG # NSM/4LAx2uKvwmUn6NwLc0+tmvny6w28rZLejskRfnVWofEv1mWY0jHUnHrwSGBS # 8gVP9gcBs6P5g0OpJPMfxdUkHXRkcMPPW0hIP8NbW8W5Sup8HuwnSKbjpyAlGBUd # M/V5rZb0sZmkn714r6ULGK+cLLAN6R3FhX6N0nj64F27LTK2BbS0pJZaXjo0eDNz # 1QcxeIFLUgF+RBsLYDn8E8cCkexK8Nlt3Gi9zJf55w6UfTZ+kwTMxMqFxh7+Tfx7 # +aBObZ+nx961AtiqAy7zVV69o/LWRdKPZdvZn9ESyGbTnPfjkBERv22prSlETlRw # zP6bmEVOKWLWVwxuwh7bUWUuUb1cj93zvttQYGQat5E9ALLJNmlvLKCskB7raLsC # AwEAAaOCAUkwggFFMB0GA1UdDgQWBBQTnhBKx+FryphQWMRipH49sMFAOjAfBgNV # HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU # aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG # CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV # HRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIH # gDANBgkqhkiG9w0BAQsFAAOCAgEAgmxaJrGqQ2D6UJhZ6Ql2SZFOaNuGbW3LzB+E # S+l2BB1MJtBRSFdi/hVY33NpxsJQhQ5TLVp0DXYOkIoPQc17rH+IVhemO8jCt+U6 # I1TIw6cR7c+tEo/Jjp6EqEU1c4/mraMjgHhQ+raC/OUAm98A1r4bIPHtsBmLROGm # eE5XLIFaBIZWHvh2COXITKObXVd5wGtJ1dZZdwaHACXF506jta+uoUdyzAeuNlTP # LTrZ8nyhxGwk9Vh6eiDQ7CQMWSSa8DJS9PUXjeoi9vTdS7ZMXqu+tv6Qz3xtoBF5 # +YFK4uE+miGs90Fxm0VK2lWrmFhjkRl5zyoHOdwG7spNYkDomCPNWIudUQmQYKpt # /Hsspfcb+xpnWIDQdMzgE8pj1vpwLgWEnH7LtT4dZCeoDo9PK40RxBD8kKJ769ng # kEwfwCD2EX/MQk79eIvOhpnH12GuVByvaKZk5XZvqtPONNwr8q/qA3877IuWwWgn # aeX+prpw0dZ/QLtbGGVrgP+TRQjt+2dcZA5P3X4LwANhiPsy0Ol4XCdj7OxBLFvO # zsCPDPaVnkp+dfDFG+NOBir7aqTJ68622pymg1V+6gc/1RvxC/wgvYyG033ecJqv # 0On0ZRNYr+i/OkwgA3HP1aLD0aHrEpw6lt0263iRkCvrcdcOW8w3jC8TJuaGWyC2 # S9jEjzgwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3 # 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 # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjozNjA1LTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsO # AwIaAxUAmBE8SCjxgjacmy8/VEdk7NxpR6aggYMwgYCkfjB8MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt # ZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO5uVBgwIhgPMjAyNjEw # MDUxNjUxMzZaGA8yMDI2MTAwNjE2NTEzNlowdzA9BgorBgEEAYRZCgQBMS8wLTAK # AgUA7m5UGAIBADAKAgEAAgIpNQIB/zAHAgEAAgISSTAKAgUA7m+lmAIBADA2Bgor # BgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAID # AYagMA0GCSqGSIb3DQEBCwUAA4IBAQAXeR1KMvpVwYiG/qyu6vpWNql1F3C5VcEE # pegceTKTRA8Hrx6d7k1sVKLGxR+45DsEmclNYhrAXjlMa9RfYiVyKxvlZjF03fTC # 2gah/F4VllLZwy+vdvtUQsYjzblxxiIXq/2s06axTzUqZBefgQSIlL1LphAF6jSK # AU8ot/PhIF0jObmxVSQ7NsOQFMpdBahVBhPNbqSuyY+ifMQvI8UtYpPI+REFE7z+ # /q+v7EKlKA1k055PB3zfRmQ3EM6E5w3KEAGNzDrZQCpUPtdQprT8wJPX1nZpdpwo # Fwir/TDRL/ken+9UdpP2n0+/n6ZyZKl19pPidG9pdFFANIk2VhhjMYIEDTCCBAkC # AQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV # BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG # A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAITsEM1Zs+v # legAAQAAAhMwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG # 9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgrgvv6kGE0pQR/BK6ex0qxEx8Y6zffa+5 # zLjM42yY0IkwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCDM4QltFIUz8J4D # jAzP4nVodZvQxYGleUIfp86Oa5xYaDCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0 # YW1wIFBDQSAyMDEwAhMzAAACE7BDNWbPr5XoAAEAAAITMCIEIKwq4cnxYweH4VLo # dqoczsrSYk/NfN0HQQvzbR56NxDuMA0GCSqGSIb3DQEBCwUABIICAK1IVsCNfyoh # pYEi948GTiCiWaGryLabV1NF3iR1Q2zz9D2hxexZor+ZHIhG+fdhScW8ULmooAZw # qHHHv+Psltqn+SZgXOXlgx09iADIx0R69dPKGne0KM8boZfvECg4KhyQWEYCqpiK # a/tCM4qlJvTS+BeaQhyiMN6t/iqF076biicJqCR+Ulxv5ZPRVdXirHCLrgltLMfe # dwrtqxMuF/e3fSWhVzdK98JbpLrRktuT4Q39KSKXv9n+0YrnGy1qq5S6JFv60gQO # L5/UL5dQmG+ccrzaA2mAI+ynw43V00VN5QKqd2FpQ27r3dqUPGZuHhGyC/Ve6bbe # 26M540CqFbJovns/SSYg+ODK5KTs1sCaKbgh7ZVsVDYN+tYKR+dPQQM2ufH2+lKZ # uMnBQQHiKDnthycEGnEsIT9ukZB7/I2k4uVpclLLiROKPMr/SXuL5LqezgQfHl5V # fFvfZRDYqgqve3I4Aq0HoQeljA86A79PGOBpjsrHkJmjndfkPaTWJ1WzonrAL4pE # gHtpVPhVOQi0nLVu6OCHAZhAjBcd3Mn4KD7VSygqjQjF2+lxgbtD8IlcsZWE14lJ # uZ1Hr+3zCsqVniiWdPtcEPCLKTlovxcdHpbmTpBzvsqiChSPWZi6PtAoal66eccw # ceY0BZmGxVaQi2rQ2qagqjP1T0yEzfQN # SIG # End signature block |