Microsoft.AzLocal.CSSTools

1.2607.16.2249

modules/AzStack.Insights/analyzers/Windows.Storage.Volume.ps1

                                using module .\..\AzStack.Insights.psm1

<#

.SYNOPSIS

    Consolidated storage volume analyzer.

.DESCRIPTION

    Evaluates storage volumes by running the volume state, data integrity scan (DiScan) and

    volume recommendation checks together under a single target-driven analyzer. Each check is

    executed independently so a failure collecting data for one does not prevent the others from

    running. The volume recommendation checks are cluster-wide and only evaluated from the

    cluster owner node.

#>

[CmdletBinding()]

param ()

# Import localization strings from the locale directory

# this will natively import the psd1 file that has the same name as the script

# and the locale folder that matches the current culture of the user running the script

Import-LocalizedData -BindingVariable 'localizedData' -BaseDirectory "$PSScriptRoot\locale" -UICulture $PSUICulture

$insightAnalyzer = Initialize-InsightAnalyzer -Id $localizedData.Id -Properties $localizedData.Insight

# Ensure the environmental prerequisites declared in the analyzer locale (RequiredModules /

# RequiredWindowsFeatures) are satisfied. An empty requirement set is treated as satisfied; when a

# requirement is not met the analyzer is skipped and reported as NOT_APPLICABLE.

try {

    $null = Test-AzsSupportAnalyzerRequirement -RequiredWindowsFeatures $insightAnalyzer.RequiredWindowsFeatures -RequiredModules $insightAnalyzer.RequiredModules -Terminating

}

catch [System.NotSupportedException] {

    Write-InsightLog -Level 'Informational' -Message $_.Exception.Message

    $insightAnalyzer.Status = [InsightStatus]::NOT_APPLICABLE

    $insightAnalyzer.Duration = New-TimeSpan -Start $insightAnalyzer.OccurrenceTimeUTC -End $([System.DateTime]::UtcNow)

    Set-InsightCache -Type 'Analyzer' -Data $insightAnalyzer

    Write-InsightEvent -Insight $insightAnalyzer

    return $insightAnalyzer

}

<# START ANALYZER LOGIC #>

# Tracks whether any sub-check failed to collect its data so the analyzer can surface UNKNOWN

# when no rule reported a FAILURE or WARNING.

$hadException = $false

# Storage volume state check

try {

    # Retrieve Storage Volume information on this node

    $StorageVolumes = Get-Volume -ErrorAction 'Stop' | Select-Object -Property DriveLetter, FileSystemLabel, FileSystemType, DriveType, HealthStatus, OperationalStatus, SizeRemaining, Size, AllocationUnitSize

    $StorageVolumes | ForEach-Object {

        $insightAnalyzer.Rules += & "$PSScriptRoot\..\rules\Windows.Storage.Volume.ps1" -Object $_ @PSBoundParameters

    }

    $reportObject = Initialize-InsightAnalyzerPropertyReport -Name 'Storage Volume State'

    foreach ($object in $StorageVolumes) {

        $reportObject.Data += [PSCustomObject]@{

            DriveLetter         = $object.DriveLetter

            FriendlyName        = $object.FileSystemLabel

            FileSystemType      = $object.FileSystemType

            DriveType           = $object.DriveType

            HealthStatus        = $object.HealthStatus

            OperationalStatus   = $object.OperationalStatus

            'SizeRemaining(GB)' = if ($object.SizeRemaining -gt 0) { [math]::Round($object.SizeRemaining / 1GB, 2) } else { 0 }

            'Size(GB)'          = if ($object.Size -gt 0) { [math]::Round($object.Size / 1GB, 2) } else { 0 }

            AllocationUnitSize  = $object.AllocationUnitSize

            PercentFree         = if ($object.Size -gt 0) { [math]::Round(($object.SizeRemaining / $object.Size) * 100, 2) } else { 0 }

        }

    }

    $insightAnalyzer.Properties += $reportObject

}

catch {

    $_ | Write-InsightLog -Level 'Exception'

    $stackTrace = Get-FormattedException -Exception $_.Exception

    $insightAnalyzer.ScriptStackTrace = if ($insightAnalyzer.ScriptStackTrace) { $insightAnalyzer.ScriptStackTrace + [Environment]::NewLine + $stackTrace } else { $stackTrace }

    $hadException = $true

}

# Data integrity scan (DiScan) scheduled task check

try {

    $taskObject = Get-AzsSupportDataIntegrityScanState

    $taskObject | ForEach-Object {

        $insightAnalyzer.Rules += & "$PSScriptRoot\..\rules\Windows.System.ScheduledTask.State.ps1" -Object $_ @PSBoundParameters

    }

    $reportObject = Initialize-InsightAnalyzerPropertyReport -Name 'DiScan Check'

    foreach ($object in $taskObject) {

        $reportObject.Data += [PSCustomObject]@{

            ComputerName = $object.ComputerName

            TaskName     = $object.TaskName

            Id           = $object.Id

            Description  = $object.Description

            State        = $object.State

            LastRunTime  = $object.LastRunTime

            NextRunTime  = $object.NextRunTime

        }

    }

    $insightAnalyzer.Properties += $reportObject

}

catch {

    $hadException = $true

}

# Storage volume recommendation checks (cluster-wide, evaluated from the cluster owner node)

try {

    $ComputerName = $Env:COMPUTERNAME

    $ClusterOwner = (Get-ClusterGroup -Name "Cluster Group" -ErrorAction Stop).OwnerNode.Name

    if ($ComputerName -eq $ClusterOwner) {

        # Retrieve the S2D volumes (virtual disks) and cluster node count

        $virtualDisks = @(Get-VirtualDisk -ErrorAction 'Stop' | Select-Object -Property FriendlyName, Size, OperationalStatus, HealthStatus)

        $nodeCount = @(Get-ClusterNode -ErrorAction 'Stop').Count

        $volumeCount = $virtualDisks.Count

        # Determine the reserve capacity recommendation:

        # one capacity drive per node, up to a maximum of four drives.

        $capacityDisks = @(Get-PhysicalDisk -ErrorAction 'Stop' | Where-Object { $_.Usage -ieq 'Auto-Select' })

        $capacityDriveSizeBytes = ($capacityDisks | Measure-Object -Property Size -Maximum).Maximum

        if ($null -eq $capacityDriveSizeBytes) { $capacityDriveSizeBytes = 0 }

        $reserveDriveCount = [math]::Min($nodeCount, 4)

        $reserveRequiredBytes = $capacityDriveSizeBytes * $reserveDriveCount

        # Determine the available (unallocated) pool capacity

        $storagePool = Get-StoragePool -IsPrimordial $false -ErrorAction 'Stop' | Select-Object -First 1

        $poolFreeBytes = if ($storagePool) { [double]$storagePool.Size - [double]$storagePool.AllocatedSize } else { 0 }

        # Rule 1: Maximum 64 volumes per cluster

        $insightAnalyzer.Rules += & "$PSScriptRoot\..\rules\Windows.Storage.VolumeRecommendations.MaxVolumesPerCluster.ps1" -Object ([PSCustomObject]@{

            VolumeCount = $volumeCount

        }) @PSBoundParameters

        # Rule 2: Minimum one volume per node

        $insightAnalyzer.Rules += & "$PSScriptRoot\..\rules\Windows.Storage.VolumeRecommendations.MinVolumesPerNode.ps1" -Object ([PSCustomObject]@{

            VolumeCount = $volumeCount

            NodeCount   = $nodeCount

        }) @PSBoundParameters

        # Rule 3: Recommended volume size less than or equal to 64 TB (per volume)

        foreach ($vDisk in $virtualDisks) {

            $insightAnalyzer.Rules += & "$PSScriptRoot\..\rules\Windows.Storage.VolumeRecommendations.VolumeSize.ps1" -Object $vDisk @PSBoundParameters

        }

        # Rule 4: Reserve capacity equal to one capacity drive per node (up to four drives)

        $insightAnalyzer.Rules += & "$PSScriptRoot\..\rules\Windows.Storage.VolumeRecommendations.ReserveCapacity.ps1" -Object ([PSCustomObject]@{

            ReserveRequiredBytes   = $reserveRequiredBytes

            PoolFreeBytes          = $poolFreeBytes

            ReserveDriveCount      = $reserveDriveCount

            CapacityDriveSizeBytes = $capacityDriveSizeBytes

        }) @PSBoundParameters

        $reportObject = Initialize-InsightAnalyzerPropertyReport -Name 'Storage Volume Recommendations'

        $reportObject.Data += [PSCustomObject]@{

            VolumeCount           = $volumeCount

            NodeCount             = $nodeCount

            'ReserveRequired(TB)' = [math]::Round($reserveRequiredBytes / 1TB, 2)

            'PoolFree(TB)'        = [math]::Round($poolFreeBytes / 1TB, 2)

            ReserveDriveCount     = $reserveDriveCount

        }

        foreach ($vDisk in $virtualDisks) {

            $reportObject.Data += [PSCustomObject]@{

                FriendlyName = $vDisk.FriendlyName

                'Size(TB)'   = [math]::Round([double]$vDisk.Size / 1TB, 2)

            }

        }

        $insightAnalyzer.Properties += $reportObject

    }

}

catch {

    $_ | Write-InsightLog -Level 'Exception'

    $stackTrace = Get-FormattedException -Exception $_.Exception

    $insightAnalyzer.ScriptStackTrace = if ($insightAnalyzer.ScriptStackTrace) { $insightAnalyzer.ScriptStackTrace + [Environment]::NewLine + $stackTrace } else { $stackTrace }

    $hadException = $true

}

<# END ANALYZER LOGIC #>

# enumerate the rules and set the analyzer status based on the rules status

# we assume that if any rule is in failure, the analyzer is in failure

# if any rule is in warning, the analyzer is in warning

# if all rules are in success or info, the analyzer is in success

# if no rule failed but a sub-check could not collect its data, surface UNKNOWN

if ($insightAnalyzer.Rules.Status -icontains [InsightStatus]::FAILURE) {

    $insightAnalyzer.Status = [InsightStatus]::FAILURE

}

elseif ($insightAnalyzer.Rules.Status -icontains [InsightStatus]::WARNING) {

    $insightAnalyzer.Status = [InsightStatus]::WARNING

}

elseif ($hadException) {

    $insightAnalyzer.Status = [InsightStatus]::UNKNOWN

}

$insightAnalyzer.Duration = New-TimeSpan -Start $insightAnalyzer.OccurrenceTimeUTC -End $([System.DateTime]::UtcNow)

Set-InsightCache -Type 'Analyzer' -Data $insightAnalyzer

Write-InsightEvent -Insight $insightAnalyzer

return $insightAnalyzer

# SIG # Begin signature block

# MIIncQYJKoZIhvcNAQcCoIInYjCCJ14CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCfR1Nhlov3nWDY

# zUsZGli4UVBEs+CeXaUlgNNvIAbrf6CCDMkwggYEMIID7KADAgECAhMzAAACHPrN

# 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/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghn+MIIZ+gIBATBu

# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc

# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwG

# CisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZI

# hvcNAQkEMSIEIMB0q5e8J6YLw8Df4rSRIPiX33qvZpGJMK9HWAsiVLiCMEIGCisG

# AQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAufK5DQjGyPpp8FJCDs90

# JZx0iSp9GOM9tOS6qGIXdY3aWpjgaZd8P279oGJobsGIueT06bPrfhI1K8NbaUSh

# tNP/20Io4m7b/cB69oa35c9Wh5e1+k7lKc8c+UkwQLJANqa1NP5NqIfVeB5AKOwr

# 2tJZxu6KNvhqCmZ2y0n4ljDe9SJGfpECPM69MuvYCWB2wMMSASNZNmCcoUO9db6b

# kUyBnZ58Lk2Y1arw+AXUatuBnxd+K6W96MhFRS0+k2MSQg5CcqGxEWbusca88Fl0

# JwW5pIQ3IkQNDoHE7n+SN3lQYHlnW9ygjLsou+lu6NAiGR5Q6GZOgMVAi3KY9XZa

# PKGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kwgheF

# AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFFMIIB

# QQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCA6VNcY9wc/RoDBUbYL

# irvNw8r6etCTTV0P7vNKFPTJEAIGajUivGCcGBMyMDI2MDcxNjIyNTMwMS4wMjFa

# MASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0

# ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2QjA1LTA1RTAtRDk0NzElMCMG

# A1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIFEKAD

# AgECAhMzAAACEUUYOZtDz/xsAAEAAAIRMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNV

# BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w

# HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m

# dCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgxNDE4NDgxM1oXDTI2MTExMzE4

# NDgxM1owgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD

# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTAr

# BgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUG

# A1UECxMeblNoaWVsZCBUU1MgRVNOOjZCMDUtMDVFMC1EOTQ3MSUwIwYDVQQDExxN

# aWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOC

# Ag8AMIICCgKCAgEAz7m7MxAdL5Vayrk7jsMo3GnhN85ktHCZEvEcj4BIccHKd/NK

# C7uPvpX5dhO63W6VM5iCxklG8qQeVVrPaKvj8dYYJC7DNt4NN3XlVdC/voveJuPP

# hTJ/u7X+pYmV2qehTVPOOB1/hpmt51SzgxZczMdnFl+X2e1PgutSA5CAh9/Xz5NW

# 0CxnYVz8g0Vpxg+Bq32amktRXr8m3BSEgUs8jgWRPVzPHEczpbhloGGEfHaROmHh

# VKIqN+JhMweEjU2NXM2W6hm32j/QH/I/KWqNNfYchHaG0xJljVTYoUKPpcQDuhH9

# dQKEgvGxj2U5/3Fq1em4dO6Ih04m6R+ttxr6Y8oRJH9ZhZ3sciFBIvZh7E2YFXOj

# P4MGybSylQTPDEFAtHHgpkskeEUhsPDR9VvWWhekhQx3qXaAKh+AkLmz/hpE3e0y

# +RIKO2AREjULJAKgf+R9QnNvqMeMkz9PGrjsijqWGzB2k2JNyaUYKlbmQweOabsC

# ioiY2fJbimjVyFAGk5AeYddUFxvJGgRVCH7BeBPKAq7MMOmSCTOMZ0Sw6zyNx4Uh

# h5Y0uJ0ZOoTKnB3KfdN/ba/eKHFeEhi3WqAfzTxiy0rMvhsfsXZK7zoclqaRvVl8

# Q48J174+eyriypY9HhU+ohgiYi4uQGDDVdTDeKDtoC/hD2Cn+ARzwE1rFfECAwEA

# AaOCAUkwggFFMB0GA1UdDgQWBBRifUUDwOnqIcvfb53+yV0EZn7OcDAfBgNVHSME

# GDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1l

# LVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsG

# AQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01p

# Y3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMB

# Af8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDAN

# BgkqhkiG9w0BAQsFAAOCAgEApEKdnMeIIUiU6PatZ/qbrwiDzYUMKRczC4Bp/XY1

# S9NmHI+2c3dcpwH2SOmDfdvIIqt7mRrgvBPYOvJ9CtZS5eeIrsObC0b0ggKTv2wr

# TgWG+qktqNFEhQeipdURNLN68uHAm5edwBytd1kwy5r6B93klxDsldOmVWtw/ngj

# 7knN09muCmwr17JnsMFcoIN/H59s+1RYN7Vid4+7nj8FcvYy9rbZOMndBzsTiosF

# 1M+aMIJX2k3EVFVsuDL7/R5ppI9Tg7eWQOWKMZHPdsA3ZqWzDuhJqTzoFSQShnZe

# nC+xq/z9BhHPFFbUtfjAoG6EDPjSQJYXmogja8OEa19xwnh3wVufeP+ck+/0gxNi

# 7g+kO6WaOm052F4siD8xi6Uv75L7798lHvPThcxHHsgXqMY592d1wUof3tL/eDaQ

# 0UhnYCU8yGkU2XJnctONnBKAvURAvf2qiIWDj4Lpcm0zA7VuofuJR1Tpuyc5p1ja

# 52bNZBBVqAOwyDhAmqWsJXAjYXnssC/fJkee314Fh+GIyMgvAPRScgqRZqV16dTB

# Yvoe+w1n/wWs/ySTUsxDw4T/AITcu5PAsLnCVpArDrFLRTFyut+eHUoG6UYZfj8/

# RsuQ42INse1pb/cPm7G2lcLJtkIKT80xvB1LiaNvPTBVEcmNSvFUM0xrXZXcYcxV

# XiYwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEB

# CwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYD

# VQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAe

# Fw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0

# YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGm

# TOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/H

# ZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDc

# wUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62A

# W36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1w

# jjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCG

# MFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ

# 1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP

# 8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFz

# ymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHz

# NgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3

# xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsG

# AQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/

# LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEG

# DCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29m

# dC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYB

# BQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8G

# A1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQw

# VgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9j

# cmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUF

# BwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3Br

# aS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQEL

# BQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfC

# cTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AF

# vonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l

# 9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn

# 8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5m

# O0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyx

# TkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4

# S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9

# y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM

# +Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhw

# RNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDWTCCAkEC

# AQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0

# ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2QjA1LTA1RTAtRDk0NzElMCMG

# A1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIa

# AxUAKyp8q2VdgAq1VGkzd7PZwV6zNc2ggYMwgYCkfjB8MQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T

# dGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO4DN8wwIhgPMjAyNjA3MTYx

# MDU4MjBaGA8yMDI2MDcxNzEwNTgyMFowdzA9BgorBgEEAYRZCgQBMS8wLTAKAgUA

# 7gM3zAIBADAKAgEAAgIbHAIB/zAHAgEAAgIS0jAKAgUA7gSJTAIBADA2BgorBgEE

# AYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYag

# MA0GCSqGSIb3DQEBCwUAA4IBAQBnCOVKSqVaZhAaxCDt6ZYggnQZEpAnuSCikilh

# 2pQAFQWk6hrHLdzrZ/IDa7VnestzVfjIcvW2PTj1IRgA0948tx0vFJ7AI39E0gE9

# W423UtEH+5ZhyL66L4IwkapDcE2Sbrj8Yqm945NJbwlZffN0dmj/Wc1SMTf/iESX

# 52qlRfDKXt3EMzcD4/feCm1NjE+2wABCDDoiJaHqTgJJzpW1z75ycADfawTFCb9b

# o++IVP8AP/ZDsQFfAu+n+zElIP6ipigVUKOG61FtotnHs4nEnkp3AnjEHlOQgjYG

# ocw4PKaYVvX42eN3SEYhR6Mh6bICM+cx0OcWL4QXLmhDzt7kMYIEDTCCBAkCAQEw

# gZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT

# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE

# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIRRRg5m0PP/GwA

# AQAAAhEwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0B

# CRABBDAvBgkqhkiG9w0BCQQxIgQgWCy7OETcd5QJkY+N6A/3tUV6tVxMudcuJisp

# VfwZfNkwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCAsrTOpmu+HTq1aXFwv

# lhjF8p2nUCNNCEX/OWLHNDMmtzCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwAhMzAAACEUUYOZtDz/xsAAEAAAIRMCIEIFrQ4XeoyOG0J7AzTR21

# zdLkbik8ALdP6Z6a7j+MjcntMA0GCSqGSIb3DQEBCwUABIICAJWtAkZItT1tTj1Y

# i58Pi5Dh9JQUl7HMpa0cCr5e2P2xs7M+l3xeLx6Rh47yD67iIizIwwZvuBGjIuiE

# uQdD+fS+xjzKlYLYem0tsYlx4JNr+jViqR8hYh3K3lsYPnHMpRqIVsdLJpTti2pK

# OhTbql2BvssH7lxlrVwkc5V6OFOCbbezy9B5MiFABdlWGQN8br9uP5pqatdCEV2y

# Gdf9Ex261PGmYoZeJFzjzGHHi7wMtAIgp4cHRlUlsY9ZPYI/uM/5IQ3O9by0YzdV

# s/cApgDe/lG+40mLYHCSRN+QeO5LcELkF77En0jnWkCRQS2PSAfTwHogl+eXYXGq

# WhZZnMBo0Iyp8KVK1gGfBL8XVclnOWbClIfFm8A6lFW/u9IOUDmNtTAyCtH1tlGT

# LSn4t9G9ireZONvmjMCI7fIwvXtGgUStVuvfgZM82WT+MzT5ipKtcBUAvbeOaGKN

# 3QMXJRwWLeOU5yzYvb/76D8vMCvj3sBIWu8FMDs43ytZq5FbwE//GFl3mO1CdOcL

# 6i1D4gyWMm1Tdz4GOARgvakntxdcmElmqAQk3X28hc8Bh9+xbDLkn7PyyGX5kGfk

# pf1E71imfdsNgpd3DDbzOUOZM+n3eHw756ys+OfRGSW3pzMsZVUNt7gbpHoyn/qT

# LUWaPX5TwQyeuxXfVd8eQtWBKPD2

# SIG # End signature block