AzStackHci.EnvironmentChecker

10.2605.0.2006

AzureLocalNetworkStorageConnection/AzureLocal.NetworkStorageConnection.psm1

                                <#############################################################

 #                                                           #

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

 #                                                           #

 #############################################################>

Import-LocalizedData -BindingVariable lnTxt -FileName AzureLocal.NetworkStorageConnection.Strings.psd1

Import-Module $PSScriptRoot\AzureLocal.NetworkStorageConnection.Helpers.psm1 -DisableNameChecking -Global

Import-Module $PSScriptRoot\..\AzStackHciConnectivity\AzStackHci.Connectivity.Helpers.psm1 -DisableNameChecking -Global

function Invoke-AzStackHciNetworkStorageConnectionValidation

{

    <#

    .SYNOPSIS

        Perform Azure Local network storage connection validation

    .DESCRIPTION

        Perform Azure Local network storage connection validation by attempting below tests:

        - Validate storage adapter connection between each other

    .EXAMPLE

        # Using a deployment answer file to validate network configurations

        $answerFilePath = "<ANSWER_FILE_LOCATION>" # Like C:\MASLogs\Unattended-2024-07-18-20-44-48.json

        Invoke-AzStackHciNetworkStorageConnectionValidation -DeployAnswerFile $answerFilePath

    .EXAMPLE

        # Using individual parameter to validate network configurations

        $answerFilePath = "<ANSWER_FILE_LOCATION>"

        $logOutputPath = "<LOG_FILE_LOCATION>"

        $answerFileContent = Get-Content $answerFilePath -Raw | ConvertFrom-Json

        [PSObject] $atcHostNetworkInfo = $answerFileContent.scaleUnits[0].deploymentData.hostNetwork

        Invoke-AzStackHciNetworkStorageConnectionValidation -HostNetworkInfo $atcHostNetworkInfo -OutputPath $logOutputPath

    .PARAMETER PassThru

        Return PSObject result.

    .PARAMETER HardwareClass

        Hardware class: Small, Medium, or Large.

    .PARAMETER ClusterPattern

        Hardware class: Standard, Stretch, or RackAware.

    .PARAMETER OutputPath

        Directory path for log and report output.

    .PARAMETER CleanReport

        Remove all previous progress and create a clean report.

    .INPUTS

        Inputs (if any)

    .OUTPUTS

        Output (if any)

    .LINK

        https://docs.microsoft.com/en-us/azure-stack/hci/manage/use-environment-checker?tabs=network

    #>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory = $true, ParameterSetName = 'AnswerFile', HelpMessage = "Specify the answer file used for deployment validation.")]

        [ValidateScript({ Test-Path -Path $_ -PathType Leaf })]

        [System.String] $DeployAnswerFile,

        [Parameter(Mandatory = $false, ParameterSetName = 'EceParameter', HelpMessage = "Specify PSObject of HostNetwork info")]

        [PSObject] $HostNetworkInfo = $null,

        [Parameter(Mandatory = $true, ParameterSetName = 'AnswerFile', HelpMessage = "Specify the PSSession(s) used to validation from")]

        [Parameter(Mandatory = $true, ParameterSetName = 'EceParameter', HelpMessage = "Specify the PSSession(s) used to validation from")]

        [System.Management.Automation.Runspaces.PSSession[]]

        $PSSession,

        [Parameter(Mandatory = $false, HelpMessage = "Tests to include.")]

        [ArgumentCompleter({ Get-TestListByFunction -ModuleName AzureLocal.NetworkStorageConnection.Helpers })]

        [ValidateScript({ $_ -in (Get-TestListByFunction -ModuleName AzureLocal.NetworkStorageConnection.Helpers) })]

        [System.String[]] $Include,

        [Parameter(Mandatory = $false, HelpMessage = "Tests to exclude.")]

        [ArgumentCompleter({ Get-TestListByFunction -ModuleName AzureLocal.NetworkStorageConnection.Helpers })]

        [ValidateScript({ $_ -in (Get-TestListByFunction -ModuleName AzureLocal.NetworkStorageConnection.Helpers) })]

        [System.String[]] $Exclude = @(),

        [Parameter(Mandatory = $false, HelpMessage = "Specify the region name to target for connectivity validation.")]

        [System.String] $RegionName,

        [Parameter(Mandatory = $false, HelpMessage = "Return PSObject result.")]

        [Switch] $PassThru,

        [Parameter(Mandatory = $false, HelpMessage = "Hardware class: Small, Medium, or Large")]

        [ValidateSet('Small', 'Medium', 'Large')]

        [System.String] $HardwareClass = "Medium",

        [Parameter(Mandatory = $false, HelpMessage = "Cluster Pattern: Standard, Stretch, or RackAware")]

        [ValidateSet('Standard', 'Stretch', 'RackAware')]

        [System.String] $ClusterPattern = "Standard",

        [Parameter(Mandatory = $false, HelpMessage = "Directory path for log and report output")]

        [System.String] $OutputPath,

        [Parameter(Mandatory = $false, HelpMessage = "Remove all previous progress and create a clean report")]

        [Switch] $CleanReport = $false,

        [Parameter(Mandatory = $false, HelpMessage = "Show only failed results on screen.")]

        [Switch] $ShowFailedOnly,

        [Parameter(Mandatory = $false, HelpMessage = "Indicating Operation Type")]

        [ValidateSet('AddNode', 'Deployment', 'Upgrade', 'PreUpdate')]

        [System.String]$OperationType = "Deployment",

        [Parameter(Mandatory = $false, HelpMessage = "Storage type: S2D or SAN")]

        [System.String] $StorageType = "S2D"

    )

    if ($PSSession.Count -le 1) {

        Log-Info "Only one or zero PSSession provided. Skip storage connection validation."

        return

    }

    $callingTestParam = @{}

    # Prepare validator call parameters

    switch ($PSCmdlet.ParameterSetName) {

        "AnswerFile" {

            # If the function is called with the AnswerFile parameter set, we need to set the other parameters

            Log-Info -Message "Performing Network Storage Connection Validation using AnswerFile"

            $deployAnswerFileContent = Get-Content $DeployAnswerFile -Raw | ConvertFrom-Json

            [PSObject] $hostNetworkInfoFromAnswerFile = $deployAnswerFileContent.scaleUnits[0].deploymentData.hostNetwork

            $callingTestParam = @{

                PSSession = $PSSession

                HostNetworkInfo = $hostNetworkInfoFromAnswerFile

                StorageType = $StorageType

            }

        }

        "EceParameter" {

            Log-Info -Message "Performing Network Storage Connection Validation using ECE parameters"

            $callingTestParam = @{

                PSSession = $PSSession

                HostNetworkInfo = $HostNetworkInfo

                StorageType = $StorageType

            }

        }

    }

    try {

        $script:ErrorActionPreference = 'Stop'

        #region Get Include/Exclude list based on OperationType

        Log-Info -Message "[NetworkStorageConnectionValidator] Scenario [$($OperationType)]"

        switch ($OperationType) {

            "Deployment" {

                Log-Info -Message "Will check all storage connection needed for a successful deployment"

            }

            default {

                throw "Unsupported OperationType [$OperationType] for Network Storage Connection Validator"

            }

        }

        #endregion

        Set-AzStackHciOutputPath -Path $OutputPath

        Write-AzStackHciHeader -invocation $MyInvocation -params $PSBoundParameters -PassThru:$PassThru

        Test-ModuleUpdate -PassThru:$PassThru

        # Call/Initialize reporting

        $envCheckerReport = Get-AzStackHciEnvProgress -clean:$CleanReport

        $envCheckerReport = Add-AzStackHciEnvJob -report $envCheckerReport

        Write-Progress -Id 1 -Activity "Checking Azure Local dependencies" -Status "Network Storage Connection" -PercentComplete 0 -ErrorAction SilentlyContinue

        $validationResult = @()

        # Get list of tests to run

        $testList = Get-TestListByFunction -ModuleName AzureLocal.NetworkStorageConnection.Helpers

        $script:envChkTestList = Select-TestList -Include $Include -Exclude $Exclude -TestList $TestList

        $totalTestCount = ($script:envChkTestList).Count

        if($totalTestCount -eq 0) {

            Log-Info "No test cases need to be run."

            return $validationResult

        }

        Log-Info -Message "Network storage connection validator to run during [ $($OperationType) ]: [ $($script:envChkTestList -join ', ') ]"

        # Run validation

        $i = 0

        $ProgressActivity = "Checking Azure Local Network Storage Connection Compatibility"

        $ProgressStatus = "Testing $ENV:ComputerName"

        $progressParams = @{

            Id          = 1

            Activity    = $ProgressActivity

            Status      = $ProgressStatus

            ErrorAction = 'SilentlyContinue'

        }

        Write-Progress @progressParams

        :noTestsBreak foreach ($test in $script:envChkTestList) {

            $OpMsg = "Run network storage connection validator [ {0} ] on machine [ {1} ]" -f $test, $ENV:ComputerName

            Log-Info -Message $OpMsg

            Write-Progress @progressParams -CurrentOperation $OpMsg -PercentComplete (($i++ / $totalTestCount) * 100)

            $invokeParameters = @{}

            Get-Command $test | Select-Object -ExpandProperty Parameters | Select-Object -ExpandProperty Keys | ForEach-Object {

                if ($callingTestParam.ContainsKey($PSITEM)) {

                    $invokeParameters += @{

                        $PSITEM = $callingTestParam[$PSITEM]

                    }

                }

            }

            # Save parameter information for current validator

            Log-Info "Parameters used for current validator: [ $test ]"

            foreach ($param in $invokeParameters.GetEnumerator()) {

                if ($param.Key -ne 'PSSession') {

                    Log-Info -Message "Parameter: $($param.Key) = $($param.Value | ConvertTo-Json -Depth 5)"

                }

            }

            $validationResult += Invoke-Expression "$test @invokeParameters"

            $OpMsg = "End run of network storage connection validator [ {0} ] on [ {1} ]`n" -f $test, $ENV:ComputerName

            Log-Info -Message $OpMsg

        }

        #region Feedback results - user scenario

        Log-Info "Network storage connection validation finished!" -ConsoleOut:(-not $PassThru)

        if (-not $PassThru) {

            $progressParams = @{

                Id              = 3

                Activity        = "Formatting Results"

                Status          = "Writing Results for $($ENV:ComputerName)"

                PercentComplete = 1

                ErrorAction     = 'SilentlyContinue'

            }

            Write-Progress @progressParams

            Write-AzStackHciResult -Title "$($ENV:COMPUTERNAME):" -Result $validationResult -ShowFailedOnly:$ShowFailedOnly -Seperator ': '

            Write-Summary -Result $validationResult -Property1 Detail

        } else {

            return $validationResult

        }

        #endregion

    } catch {

        Log-Info -Message "" -ConsoleOut

        Log-Info -Message "$($_.Exception.Message)" -ConsoleOut -Type Error

        Log-Info -Message "$($_.ScriptStackTrace)" -ConsoleOut -Type Error

        $cmdletException = $_

        throw $_

    } finally {

        $Script:ErrorActionPreference = 'SilentlyContinue'

        # Write result to telemetry channel

        foreach ($r in $validationResult) {

            Write-ETWResult -Result $r

        }

        # Write validation result to report object and close out report

        $envCheckerReport | Add-Member -MemberType NoteProperty -Name 'NetworkStorageConnection' -Value $validationResult -Force

        $envCheckerReport = Close-AzStackHciEnvJob -report $envCheckerReport

        Write-AzStackHciEnvReport -report $envCheckerReport

        Write-AzStackHciFooter -invocation $MyInvocation -Exception $cmdletException -PassThru:$PassThru

    }

}

# SIG # Begin signature block

# MIInRQYJKoZIhvcNAQcCoIInNjCCJzICAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCfLu4/5El1eLkg

# AwuSgF9aYmqvxnR3E0jS3y4kWWPeS6CCDLowggX1MIID3aADAgECAhMzAAACHU0Z

# 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

# 1cY2L4A7GTQG1h32HHAvfQESWP0xghnhMIIZ3QIBATBuMFcxCzAJBgNVBAYTAlVT

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv

# c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w

# DQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYK

# KwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIAwqR8XG

# oFQN5sthrFmB28i4ZnRRDQcNvMYnxHrgfFafMEIGCisGAQQBgjcCAQwxNDAyoBSA

# EgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20w

# DQYJKoZIhvcNAQEBBQAEggEA0FDQdQCHR4IqplicQoGbfb8R9PZRGdRBSp1Wbx5A

# jZJD3qbenk66b/h7fccaYQ/XBYAexbjtdwsc0X1ZJkUgWwuzrtdXDfTYPROO+xRa

# nQ9HCCoklLjIdA2rPif4iEzFzIah+9CLiIlL1C/GM3aZMsdKIMoIpi/l9OvN1dqN

# WqbMCJsPQd6Ec1ds6wtIboYFdZoKYez4ER1pDB3EDseF8Pqndp+yk8wIkul68yjS

# GVqykIw7HNIpeimO0ftxiJ6gHpuBz3kK02WQtYXthmb/ZKAzq5ihR5N0QL4fSWDH

# LcwkS6i7AeZmS5/CsSUNcZRBP4Ra63KOTd87Hpc5/I8DoaGCF5MwghePBgorBgEE

# AYI3AwMBMYIXfzCCF3sGCSqGSIb3DQEHAqCCF2wwghdoAgEDMQ8wDQYJYIZIAWUD

# BAIBBQAwggFRBgsqhkiG9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGEWQoD

# ATAxMA0GCWCGSAFlAwQCAQUABCC88qTrC3ZOtPyCrp58WOrPFMgv2kczcW7WAcor

# NK82tAIGaeeNG/EOGBIyMDI2MDUwMzE0MzExMC4xOFowBIACAfSggdGkgc4wgcsx

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1p

# Y3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQgVFNT

# IEVTTjpEQzAwLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3Rh

# bXAgU2VydmljZaCCEeowggcgMIIFCKADAgECAhMzAAACJDuEIbAsrGQiAAEAAAIk

# MA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n

# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y

# YXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4X

# DTI2MDIxOTE5Mzk1OVoXDTI3MDUxNzE5Mzk1OVowgcsxCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNh

# IE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjpEQzAwLTA1RTAt

# RDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCAiIw

# DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKPpbdRpDZmviE29LLuPtQw8VXKz

# toTEYH4kXDKTPNeDeNrJib2A4tcnu02FTZ6aGstAI5lyAu/PoWSqaCHNDHOaSAq0

# tiIpoTOGiA79x7SVOF0s11W0zBA5iCj5e1cBlxWIFfgtweTfxG6xmIXvDFJrm38v

# GJzTj5n+GXLWAlCkh4UOqnhr0+4u3yux8fTm9b2lT26uIZ0PF8lef+Vzj0LFteoD

# cRfXsvbhtzq36YW48MAkoqlqLddeoXacmWlM992sDb2xZNI0qKD0K0ELm3NCPR+V

# uxr/jCo7275GS7CllvdvuqdbkV0WsNHW9CZd+OXJQ/1k7fzzf03BK6Ie2+wUI2RM

# 0hfw4vldWrWewrK7/8Z4hn1i7Gx8sF52obTbg8MRHKsCzSm99RY4tqlVBqMc+gKe

# 41Iq9sSHuzkhDRiC6kaOL4fusgPHb+YgQj7pDxbAG2TdjHKGOPQZfD3T2LQSRORX

# LL7XIAOPBILxvDaozj4xziHLK2VnNJzQg9QGrVgadjAKMjBrn+UxbSkWf8ekl0Hp

# d4y5O1hM6lo+ijrgWNCvItdaN3ii+nDmU7Dtf6/cT2TA31UEL7AkRIEQILWBkwJL

# lNpXB8TXDimdddvWpP1uOBGw+Dh2SWu5RN2if/dI23RrRDk1zZSX6syVDFeg/2Kx

# fAw2co7kkmSpENFVAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQUcx+RfW7/MksIx7SC

# piK3HW0Ad6gwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYDVR0f

# BFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwv

# TWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwGCCsG

# AQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAx

# MCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAO

# BgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBAD7AdJuaEikzwJFVni2T

# rbiFD4t1lcTiqh5C6LvsJ41reOrUU7OLsxEqSSjp2IQMdc81a8BqDFqy0J7A/Obl

# MI2HWzioIeHhHYb+vjzBT8ylzrz9YOYnLkIhCf8XCmzWxs1QS7sHODTTipQshUn3

# reOj9qbjHAqDCH69JUvv92Gx9Pt2+GlF11tgtBMdmDC40HpCFwQSyCiAtXA1GPft

# URZkOLCgx3HILthitC7owJW2LMec62RJfsWoiiLqOVx+p+jrX24Mf2vyTaoA4cJ4

# QCopcrKYhcMxwYaUR0MVtiINmA8IEzQgeAB6KVRKifTvCMe7R7SywGa0Fp89vgZ3

# 7kW5GdYbdcZ73U0KksqqYVr/gaRXP04zNlSDyhzPEL/glPcd/jkkS2zNOhfA2yRX

# ck0Jy7Ygi2vpIkeaLcQNUAMNFI2F3MVGliamUYSU+XkZGg+0mIMS9Ehu/kwUojDb

# H2Cd6F/ki8GMLhmQGD7gZOmoYTeaafMXech6Q6Rfi6DT/SY3YJJquG5KL02Ycg6l

# Q3Z5AdS2BNv/4aaruCS0IzAir8k4JgiJNiqm/WhuMAYp1Yw8KuVLI0CzSNljOSFr

# nfnXnw0zH7AEa+x8WhWwIwbk5ynq9boJfK5ZFtRWoxTU6tBsd93LMmluEkLU9sBk

# jIkJs35UGANMDNMpjzDghJLBMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJmQAA

# AAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUg

# QXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1WjB8

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N

# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEBBQAD

# ggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjKNVf2

# AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhgfWpS

# g0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJprx2r

# rPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/dvI2k

# 45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka97aSu

# eik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKRHh09

# /SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9ituqBJR

# 6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyOArxC

# aC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItboKaD

# IV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6bMUR

# HXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6tAgMB

# AAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQWBBQq

# p1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacbUzUZ

# 6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYzaHR0

# cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRt

# MBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBB

# MAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP

# 6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWlj

# cm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2

# LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMu

# Y3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/qXBS2

# Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6U03d

# mLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVtI1Tk

# eFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis9/kp

# icO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTpkbKp

# W99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0sHrY

# UP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138eW0QB

# jloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJsWkB

# RH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7Fx0V

# iY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0dFtq

# 0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQtB1V

# M1izoXBm8qGCA00wggI1AgEBMIH5oYHRpIHOMIHLMQswCQYDVQQGEwJVUzETMBEG

# A1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWlj

# cm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBP

# cGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046REMwMC0wNUUwLUQ5

# NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoBATAH

# BgUrDgMCGgMVAKYI8duax4BJ97/9sa1f15Ab7T7joIGDMIGApH4wfDELMAkGA1UE

# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc

# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0

# IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQELBQACBQDtoTL8MCIYDzIw

# MjYwNTAzMDIzNTQwWhgPMjAyNjA1MDQwMjM1NDBaMHQwOgYKKwYBBAGEWQoEATEs

# MCowCgIFAO2hMvwCAQAwBwIBAAICD9owBwIBAAICEg4wCgIFAO2ihHwCAQAwNgYK

# KwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgCAQAC

# AwGGoDANBgkqhkiG9w0BAQsFAAOCAQEAv1A8KWKQLkcEGOQRXyRAJ05iCVp0IQo5

# XGzrFsgdu5aWnRnH3ycLo4p04IMbLq/vZwoXvehNz4wkjKD5X0wLlqbEmFs57ELp

# SEO/YrR7ZQ7b2F3psszAk1I4bZyKRC2sLHYfBQUx8DRwvn+/kmQKsZU4wL352o6X

# dQYlXaQPJS94DxdlNw58TS7GEGL1aojf7ajflzSmKvFINn57hrRjWR8K+ZXxIpfT

# f/g6hsU9EoF7dl6fkbdfirprSTAV1vbT3nwkYNAg7O2lzV72jMem/DoRosYlB/Vc

# GA8FylAdQA/MbZzFrZsV15zNw7FNp1v1+HPnhSOKo/g+UCojacyLSDGCBA0wggQJ

# AgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYD

# VQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAk

# BgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAACJDuEIbAs

# rGQiAAEAAAIkMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZI

# hvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIDHLBR5Zrjrjk0mAu5OY0P3VnAraPoRP

# +vfs5FPA62A3MIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCBvQQgSCE9N2qb91HJ

# nQFzNdx2WhUSogJ1yalU1sf0IRXNZI4wgZgwgYCkfjB8MQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1T

# dGFtcCBQQ0EgMjAxMAITMwAAAiQ7hCGwLKxkIgABAAACJDAiBCAD/+jGbZ+jks6a

# a1g0ctnB90cGsDQl+7V3E5dIWp0FijANBgkqhkiG9w0BAQsFAASCAgA8hwZmaGDW

# dVYWhTWyXO+W9jH8kEPxyiyIcBRJ3dCpbEeZp1SVTB2dfumF8nKrC5AsAzbFNS4n

# IWpo7suwJbaPdDLGWzrc0B/l+TewWCSwXXxTXv/Z3VdaiW3kUUD8MBGf6E6INuK0

# 5jwvJgs6mZQtYhK2H5r/2Aq/S1F1RJ2E8fuTJ7XEcAkLOOVKFJZjcsvmCOooLi1G

# MoKkQlwkVr41XqPvLh/ox9DkZaVNlKwAfKAxd/asrh1z1IcrYrWX8Cw8bxSg8Uzf

# eY+GaJKwbU+PFg4bqwLBx818qkZWdz4k9d2CgxBlxRb+a466rrJkw5iKsoNrVLhZ

# s2xxm/DAPN1oWaah7HMCVpQPPDzShwQjYdN8EbacUQ4ruYvkukTlB3LkMBBjOcJD

# tr0sGjst0sEFynoOfEySlw/mzuY8VgH6ft1pl9350QWbGLKSyetDuQbgLsiKqtm7

# FQDyPx/+LNHNlwWib4roMKXFbBoVgWv4KPcK54xhLQWEgyG9yIyjs0EKqsoEhrLj

# 7uf1OPGTcUb8d/3wvFxPqY/8R8OjsSnOk1TzNThhe6/TWz8pTXbvHGtslR2wIpVV

# T98KE4Uffdr6/0ZKayqsnqMDe0dzk8GA4ZZkprYy5IjGY/3BI7G1UMF7LoWvDWu9

# E7d/rc4swo3I6PuRSHesEU4mmDlpTnfLCQ==

# SIG # End signature block