AzStackHci.EnvironmentChecker

10.2506.0.2017

AzStackHciLLDP/AzStackHci.LLDP.psm1

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

 #                                                           #

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

 #                                                           #

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

 Import-Module $PSScriptRoot\AzStackHci.LLDP.Helpers.psm1 -Force -DisableNameChecking -Global

 Import-Module $PSScriptRoot\..\AzStackHci.EnvironmentChecker.Utilities.psm1 -Force -DisableNameChecking -Global

 Import-Module $PSScriptRoot\..\AzStackHci.EnvironmentChecker.Reporting.psm1 -Force -DisableNameChecking -Global

 function Invoke-AzStackHciLLDPValidation

 {

     <#

     .SYNOPSIS

        Perform AzStackHci LLDP Validation

     .DESCRIPTION

        Perform AzStackHci LLDP Validation by attempting below tests:

        - Validate HCI cluster connection between cluster nodes and network switches.

        - Validate storage vlan configuration from network switch LLDP TLV.

        - Validate DCBX configuration from network switch LLDP TLV.

     .EXAMPLE

        # Using a deployment answer file to validate network configurations

        $answerFilePath = "<ANSWERFILELOCATION>"

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

        [System.String[]]$allServers = $answerFileContent.scaleUnits[0].deploymentData.physicalNodes.Name

        $logOutputPath = "<LOGFILELOCATION>"

        $userName = "<LOCALADMIN>"

        $secPassWord = ConvertTo-SecureString "<LOCALADMINPASSWORD>" -AsPlainText -Force

        $hostCred = New-Object System.Management.Automation.PSCredential($username, $secPassWord)

        [System.Management.Automation.Runspaces.PSSession[]] $allServerSessions = @();

        foreach ($currentServer in $allServers) {

            $currentSession = Microsoft.PowerShell.Core\New-PSSession -ComputerName $currentServer -Credential $hostCred -ErrorAction Stop

            $allServerSessions += $currentSession

        }

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

        Invoke-AzStackHciLLDPValidation -DeployAnswerFile $answerFilePath -PSSession $allServerSessions -OutputPath $logOutputPath

    .EXAMPLE

        # Using indivudual parameter to validate network configurations

        $allServers = "<ARRAY OF SERVERS' IP>" # you need to use IP for the connection

        $logOutputPath = "<LOGFILELOCATION>"

        $userName = "<LOCALADMIN>"

        $secPassWord = ConvertTo-SecureString "<LOCALADMINPASSWORD>" -AsPlainText -Force

        $hostCred = New-Object System.Management.Automation.PSCredential($username, $secPassWord)

        [System.Management.Automation.Runspaces.PSSession[]] $allServerSessions = @();

        [System.Collections.Hashtable] $StorageAdapterVLANIDInfo = @{ "adapter1" = 711; "adapter2" = 712 }

        [System.Management.Automation.Runspaces.PSSession[]] $allServerSessions = @();

        foreach ($currentServer in $allServers) {

            $currentSession = Microsoft.PowerShell.Core\New-PSSession -ComputerName $currentServer -Credential $hostCred -ErrorAction Stop

            $allServerSessions += $currentSession

        }

        Invoke-AzStackHciLLDPValidation -StorageAdapterVLANIDInfo $StorageAdapterVLANIDInfo -PSSession $allServerSessions -OutputPath $logOutputPath

    .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 = $true, ParameterSetName = 'Deploy', HelpMessage = "Specify the PsSession(s) used to validation from.")]

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

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

         $PSSession,

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

         [switch]

         $PassThru,

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

         [ArgumentCompleter({ Get-TestListByFunction -ModuleName AzStackHci.LLDP.Helpers })]

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

         [string[]]

         $Include,

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

         [ArgumentCompleter({ Get-TestListByFunction -ModuleName AzStackHci.LLDP.Helpers })]

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

         [string[]]

         $Exclude,

        # OutputPath for both 'AnswerFile' and 'Deploy'

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

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

        [string]$OutputPath = (Join-Path -Path $env:TEMP -ChildPath "LLDPValidation"),

        # Storage Network Data for 'Deploy'

        [Parameter(Mandatory = $true, ParameterSetName = 'Deploy', HelpMessage = "Manual input Storage network data.")]

        [hashtable]$StorageAdapterVLANIDInfo = @{

            "Ethernet 3" = 711

            "Ethernet 4" = 712

        },

        # ETS and PFC Validation

        [Parameter(Mandatory = $false, HelpMessage = "Input ETS and PFC Configuration to validate.")]

        [hashtable]$DcbxConfigInfo = @{

            "ETS" = @(

                3, 0, 1, 0, 2, 48, 50, 2, 0, 0, 0, 0, 0, 2, 2, 2, 0, 0, 0, 0, 0

            )

            "PFC" = @(8, 8)

        },

         [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

     )

     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 Validation using AnswerFile"

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

             Log-Info -Message "Get Physical Node List"

             $physNodeList = $deployAnswerFileContent.scaleUnits[0].deploymentData.physicalNodes

             if ($null -eq $physNodeList) {

                 Log-Info -Message "No physicalNodes defined in answer file. Initializing empty array."

                 $physNodeList = @()

             }

             $clusterPattern = $deployAnswerFileContent.scaleUnits[0].deploymentData.cluster.clusterPattern

             $localZones = $deployAnswerFileContent.scaleUnits[0].deploymentData.localAvailabilityZones

             Log-Info -Message "Get Storage Network Data"

             [System.Collections.Hashtable] $StorageAdapterVLANIDInfo = @{}

             [PSObject[]] $storageNetworkDefinition = $deployAnswerFileContent.scaleUnits[0].deploymentData.hostNetwork.storageNetworks

             foreach ($storageNetworkInfo in $storageNetworkDefinition)

             {

                 $StorageAdapterVLANIDInfo.Add($storagenetworkInfo.networkAdapterName, $storageNetworkInfo.VlanId)

             }

             $callingTestParam = @{

                PSSession = $PSSession

                OutputPath = $OutputPath

                StorageAdapterVLANIDInfo = $StorageAdapterVLANIDInfo

                DcbxConfigInfo = $DcbxConfigInfo

                PhysicalNodeList = $physNodeList

                ClusterPattern = $clusterPattern

                LocalAvailabilityZones = $localZones

             }

         }

         "Deploy"

         {

            Log-Info "Performing LLDP Validation using Deploy parameters"

            $callingTestParam = @{

                PSSession = $PSSession

                OutputPath = $OutputPath

                StorageAdapterVLANIDInfo = $StorageAdapterVLANIDInfo

                DcbxConfigInfo = $DcbxConfigInfo

                PhysicalNodeList = $physNodeList

                ClusterPattern = $clusterPattern

                LocalAvailabilityZones = $localZones

            }

         }

    }

     try

     {

         $script:ErrorActionPreference = 'Stop'

         Set-AzStackHciOutputPath -Path $OutputPath

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

         # Call/Initialise reporting

         $envcheckerReport = Get-AzStackHciEnvProgress -clean:$CleanReport

         $envcheckerReport = Add-AzStackHciEnvJob -report $envcheckerReport

         Import-Module $PSScriptRoot\AzStackHci.LLDP.Helpers.psm1 -Force -DisableNameChecking -Global

         #region Get test list

         Write-Progress -Id 1 -Activity "Checking AzStackHci Dependancies" -Status "Initializing" -PercentComplete 0 -ErrorAction SilentlyContinue

        #  $TestList = Get-TestListByFunction -ModuleName AzStackHci.LLDP.Helpers

        #  $script:envchktestList = Select-TestList -Include $Include -Exclude $Exclude -TestList $TestList

        $script:envchktestList = @( "Test-LLDPNbrTlvs",

        "Test-MergedLLDPDataToJson",

        "Test-LLDPConnections",

        "Test-LLDPStorageVlan",

        "Test-LLDPDcbxConfiguration",

        "Test-LLDPAvailabilityZoneConnections")

         #endregion

         $TotalTestCount = ($script:envchktestList).Count

         # Run validation

         $i = 0

         $Result = @()

         $ProgressActivity = "Validating AzStackHci Network LLDP Data"

         $i = 0

         $ProgressStatus = "Testing $ENV:ComputerName"

         $progressParams = @{

             Id          = 1

             Activity    = $ProgressActivity

             Status      = $ProgressStatus

             ErrorAction = 'SilentlyContinue'

         }

         Write-Progress @progressParams

         :noTestsBreak foreach ($test in $script:envchktestList)

         {

             $OpMsg = "Run LLDP validator [{0}] on {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[$PSITEM]) {

                     $invokeParameters += @{

                         $PSITEM = $callingTestParam[$PSITEM]

                     }

                 }

             }

             Log-Info -Message ($invokeParameters | Out-String)

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

         }

         # Feedback results - user scenario

         Log-Info "LLDP Validation" -ConsoleOut:(-not $PassThru)

         if (-not $PassThru)

         {

             $progressParams = @{

                 Id              = 3

                 Activity        = "Formating Results"

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

                 PercentComplete = 1

                 ErrorAction     = 'SilentlyContinue'

             }

             Write-Progress @progressParams

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

             Write-Summary -Result $Result -Property1 Detail

         }

         else

         {

             return $Result

         }

     }

     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 $Result)

         {

             Write-ETWResult -Result $r

         }

         # Write validation result to report object and close out report

         $envcheckerReport | Add-Member -MemberType NoteProperty -Name 'LLDP' -Value $Result -Force

         $envcheckerReport = Close-AzStackHciEnvJob -report $envcheckerReport

         Write-AzStackHciEnvReport -report $envcheckerReport

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

     }

 }

# SIG # Begin signature block

# MIIoUgYJKoZIhvcNAQcCoIIoQzCCKD8CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBMfF1Ao0U7/i3a

# YRfUQL68Zxwoz3C+bj/uEN9rj/BnOKCCDYUwggYDMIID66ADAgECAhMzAAAEA73V

# lV0POxitAAAAAAQDMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjQwOTEyMjAxMTEzWhcNMjUwOTExMjAxMTEzWjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCfdGddwIOnbRYUyg03O3iz19XXZPmuhEmW/5uyEN+8mgxl+HJGeLGBR8YButGV

# LVK38RxcVcPYyFGQXcKcxgih4w4y4zJi3GvawLYHlsNExQwz+v0jgY/aejBS2EJY

# oUhLVE+UzRihV8ooxoftsmKLb2xb7BoFS6UAo3Zz4afnOdqI7FGoi7g4vx/0MIdi

# kwTn5N56TdIv3mwfkZCFmrsKpN0zR8HD8WYsvH3xKkG7u/xdqmhPPqMmnI2jOFw/

# /n2aL8W7i1Pasja8PnRXH/QaVH0M1nanL+LI9TsMb/enWfXOW65Gne5cqMN9Uofv

# ENtdwwEmJ3bZrcI9u4LZAkujAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU6m4qAkpz4641iK2irF8eWsSBcBkw

# VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzUwMjkyNjAfBgNVHSMEGDAW

# gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v

# d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw

# MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov

# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx

# XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB

# AFFo/6E4LX51IqFuoKvUsi80QytGI5ASQ9zsPpBa0z78hutiJd6w154JkcIx/f7r

# EBK4NhD4DIFNfRiVdI7EacEs7OAS6QHF7Nt+eFRNOTtgHb9PExRy4EI/jnMwzQJV

# NokTxu2WgHr/fBsWs6G9AcIgvHjWNN3qRSrhsgEdqHc0bRDUf8UILAdEZOMBvKLC

# rmf+kJPEvPldgK7hFO/L9kmcVe67BnKejDKO73Sa56AJOhM7CkeATrJFxO9GLXos

# oKvrwBvynxAg18W+pagTAkJefzneuWSmniTurPCUE2JnvW7DalvONDOtG01sIVAB

# +ahO2wcUPa2Zm9AiDVBWTMz9XUoKMcvngi2oqbsDLhbK+pYrRUgRpNt0y1sxZsXO

# raGRF8lM2cWvtEkV5UL+TQM1ppv5unDHkW8JS+QnfPbB8dZVRyRmMQ4aY/tx5x5+

# sX6semJ//FbiclSMxSI+zINu1jYerdUwuCi+P6p7SmQmClhDM+6Q+btE2FtpsU0W

# +r6RdYFf/P+nK6j2otl9Nvr3tWLu+WXmz8MGM+18ynJ+lYbSmFWcAj7SYziAfT0s

# IwlQRFkyC71tsIZUhBHtxPliGUu362lIO0Lpe0DOrg8lspnEWOkHnCT5JEnWCbzu

# iVt8RX1IV07uIveNZuOBWLVCzWJjEGa+HhaEtavjy6i7MIIHejCCBWKgAwIBAgIK

# YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm

# aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw

# OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD

# VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG

# 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la

# UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc

# 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D

# dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+

# lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk

# kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6

# A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd

# X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL

# 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd

# sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3

# T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS

# 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI

# bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL

# BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD

# uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv

# c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf

# MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF

# BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h

# cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA

# YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn

# 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7

# v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b

# pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/

# KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy

# CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp

# mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi

# hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb

# BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS

# oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL

# gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX

# cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCGiMwghofAgEBMIGVMH4x

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p

# Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAQDvdWVXQ87GK0AAAAA

# BAMwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw

# HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIH80

# MECRrfj1/IYcy+2K0dJpdukZZNyv2CS69LC6UTnmMEIGCisGAQQBgjcCAQwxNDAy

# oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20wDQYJKoZIhvcNAQEBBQAEggEANZIYAd7w2+c2b7b9FatNB02AgrkXL9FNQhDC

# XZTzHeoLsSUFGkdqAXvSfj070MXRi6la5JQDhDZb+d1LLDH/EC+Exq33qUF6+M4F

# IYotYv6Mh5uk46X7wWIT7mkCeU1xBJVRGmBzoeVcsMrxlOuFTsEs4eazAfRWyqIk

# APdHy5mKaE21W9OGbmm5HvzHxK1uBGm5ob0rmZiP2yXlfW0GojYhu40orVDHJvAH

# Slzuj9s+7U0D6kHGNIVxU/nzushy/PgUtFsUzVgHewP01ZuZnaL0jTPmIgJIbVc5

# +BEBMd2Agbvd5zQI7/xPHnOMK+2TBRW5w9VV1I377TNsGZdflqGCF60wghepBgor

# BgEEAYI3AwMBMYIXmTCCF5UGCSqGSIb3DQEHAqCCF4YwgheCAgEDMQ8wDQYJYIZI

# AWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGE

# WQoDATAxMA0GCWCGSAFlAwQCAQUABCBV8FM0dDHlLcrXP5/KxwtAgBZqLnoGNr1N

# g3QCXyhmzgIGaC3V5HPpGBMyMDI1MDYxMDE1NDgzNC42MDZaMASAAgH0oIHZpIHW

# MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT

# Hm5TaGllbGQgVFNTIEVTTjozMjFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEfswggcoMIIFEKADAgECAhMzAAAB+KOh

# JgwMQEj+AAEAAAH4MA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w

# IFBDQSAyMDEwMB4XDTI0MDcyNTE4MzEwOFoXDTI1MTAyMjE4MzEwOFowgdMxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jv

# c29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVs

# ZCBUU1MgRVNOOjMyMUEtMDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGlt

# ZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA

# xR23pXYnD2BuODdeXs2Cu/T5kKI+bAw8cbtN50Cm/FArjXyL4RTqMe6laQ/CqeMT

# xgckvZr1JrW0Mi4F15rx/VveGhKBmob45DmOcV5xyx7h9Tk59NAl5PNMAWKAIWf2

# 70SWAAWxQbpVIhhPWCnVV3otVvahEad8pMmoSXrT5Z7Nk1RnB70A2bq9Hk8wIeC3

# vBuxEX2E8X50IgAHsyaR9roFq3ErzUEHlS8YnSq33ui5uBcrFOcFOCZILuVFVTgE

# qSrX4UiX0etqi7jUtKypgIflaZcV5cI5XI/eCxY8wDNmBprhYMNlYxdmQ9aLRDcT

# KWtddWpnJtyl5e3gHuYoj8xuDQ0XZNy7ESRwJIK03+rTZqfaYyM4XSK1s0aa+mO6

# 9vo/NmJ4R/f1+KucBPJ4yUdbqJWM3xMvBwLYycvigI/WK4kgPog0UBNczaQwDVXp

# cU+TMcOvWP8HBWmWJQImTZInAFivXqUaBbo3wAfPNbsQpvNNGu/12pg0F8O/CdRf

# gPHfOhIWQ0D8ALCY+LsiwbzcejbrVl4N9fn2wOg2sDa8RfNoD614I0pFjy/lq1Ns

# Bo9V4GZBikzX7ZjWCRgd1FCBXGpfpDikHjQ05YOkAakdWDT2bGSaUZJGVYtepIpP

# TAs1gd/vUogcdiL51o7shuHIlB6QSUiQ24XYhRbbQCECAwEAAaOCAUkwggFFMB0G

# A1UdDgQWBBS9zsZzz57QlT5nrt/oitLv1OQ7tjAfBgNVHSMEGDAWgBSfpxVdAF5i

# XYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jv

# c29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENB

# JTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRw

# Oi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRp

# bWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1Ud

# JQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsF

# AAOCAgEAYfk8GzzpEVnGl7y6oXoytCb42Hx6TOA0+dkaBI36ftDE9tLubUa/xMbH

# B5rcNiRhFHZ93RefdPpc4+FF0DAl5lP8xKAO+293RWPKDFOFIxgtZY08t8D9cSQp

# gGUzyw3lETZebNLEA17A/CTpA2F9uh8j84KygeEbj+bidWDiEfayoH2A5/5ywJJx

# IuLzFVHacvWxSCKoF9hlSrZSG5fXWS3namf4tt690UT6AGyWLFWe895coFPxm/m0

# UIMjjp9VRFH7nb3Ng2Q4gPS9E5ZTMZ6nAlmUicDj0NXAs2wQuQrnYnbRAJ/DQW35

# qLo7Daw9AsItqjFhbMcG68gDc4j74L2KYe/2goBHLwzSn5UDftS1HZI0ZRsqmNHI

# 0TZvvUWX9ajm6SfLBTEtoTo6gLOX0UD/9rrhGjdkiCw4SwU5osClgqgiNMK5ndk2

# gxFlDXHCyLp5qB6BoPpc82RhO0yCzoP9gv7zv2EocAWEsqE5+0Wmu5uarmfvcziL

# fU1SY240OZW8ld4sS8fnybn/jDMmFAhazV1zH0QERWEsfLSpwkOXaImWNFJ5lmcn

# f1VTm6cmfasScYtElpjqZ9GooCmk1XFApORPs/PO43IcFmPRwagt00iQSw+rBeIH

# 00KQq+FJT/62SB70g9g/R8TS6k6b/wt2UWhqrW+Q8lw6Xzgex/YwggdxMIIFWaAD

# AgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYD

# VQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEe

# MBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3Nv

# ZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIy

# MjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5

# vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64

# NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhu

# je3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl

# 3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPg

# yY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I

# 5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2

# ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/

# TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy

# 16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y

# 1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6H

# XtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMB

# AAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQW

# BBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30B

# ATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz

# L0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYB

# BAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMB

# Af8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBL

# oEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggr

# BgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNS

# b29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1Vffwq

# reEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27

# DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pv

# vinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9Ak

# vUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWK

# NsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2

# kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+

# c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep

# 8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+Dvk

# txW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1Zyvg

# DbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/

# 2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDVjCCAj4CAQEwggEBoYHZpIHW

# MIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsT

# Hm5TaGllbGQgVFNTIEVTTjozMjFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9z

# b2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIaAxUAtkQt/ebWSQ5D

# nG+aKRzPELCFE9GggYMwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz

# aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAx

# MDANBgkqhkiG9w0BAQsFAAIFAOvysIEwIhgPMjAyNTA2MTAxMzI0MTdaGA8yMDI1

# MDYxMTEzMjQxN1owdDA6BgorBgEEAYRZCgQBMSwwKjAKAgUA6/KwgQIBADAHAgEA

# AgIBgzAHAgEAAgIbGjAKAgUA6/QCAQIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgor

# BgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUA

# A4IBAQBh7NSQoPPLIpGCLS8G4rdpLbVyYHEqNQ1pDtCTxlVlGcXC/Xg4o9NHFD6K

# Sbo0PJxh5fJO7N62rBEpfpEzCSxl7WMmFh+1IFUtsFwav3ikBlqdsiKW0yJkTcVs

# /c+0Zlt59HBmo20k/YboppbxVVCS/yeRV9KSgafAE+FVlQKd+pk12ypQ+e5qppNs

# I7KWsxlS6Jw8tTVIXPmAc+0TXME7iuSnF7t+YrFcn6qf2pvWvGieFl9ZOrH7gKd0

# IsnqmXmVlH+FMgAQb8XDO74aHI7kmpRAexBYuo8Sxx9OEPi1EKERZtttMTYJxGZ8

# Dm6PCAYrPQ4cSZAiXJwRSvGEedXWMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgUENBIDIwMTACEzMAAAH4o6EmDAxASP4AAQAAAfgwDQYJYIZIAWUD

# BAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0B

# CQQxIgQgpOVkonqL5nE0ZNhU+fLVXF4+fMXCTvER0TWA0L/OooIwgfoGCyqGSIb3

# DQEJEAIvMYHqMIHnMIHkMIG9BCDvzDPyXw1UkAUFYt8bR4UdjM90Qv5xnVaiKD3I

# 0Zz3WjCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB

# +KOhJgwMQEj+AAEAAAH4MCIEIGiwc8mFzcCHa9gAOkX4PEQzxo1+4VnVRUxZeAgc

# 7BRJMA0GCSqGSIb3DQEBCwUABIICAJ4yNIrT9Pk3dE8jwdPgTe+QMAYJhOPrDRDl

# 3or/xkmKpA6JuS0/sO81yWCAAr9QPoLtM5qF7mVKif5ROs/YtsJLzTQzhp+C31Ab

# /jaD6xKE0uNeuyxpXMdVOsVUdk0wV6BPcrFpACqTVaTIDINyi7CEYpK+RzqakoCy

# y3of9s0NqY8PJbw2uHWrcgQKk49KDTYZWLZWop0terFRX2zTTOBfeSHXr8ubHtRf

# tG9BNTAmz/zy9Ct3otHYKb17qatKwnWMm5q6bPJ6dg6fDmx27rwfmXbQZzpNL5Gb

# o/XZtnz1KykmANIprmqRNf+V7X6gALBZHhazE5ac0kEQiY7oJpDyVpbx3U4v0vbh

# nxcZNTeSRlVRhphIz++nWp6H6U0cRrlTQQWpSDfuVRUjqcAh6U26bjKYg9tYJuDF

# dn0tODBNGr6MBH9d5H+RYmjxzsqiAF0lFuFVVUakM/3cLAZgSb8HH2TXjGOcZa5J

# 1GPHahr5yfRAegpJfDuw7J3kQ9G2UrM9gg+yy6eg0ziTW3Cn9AA2i6GoHnFnrD6I

# lyzdcBQ5asB3lRCKamQH+22Bfs4u3UiM3cREvOWcUob6+aRNtecMHL86xhqr4EM0

# nvgTHsIz1W96XdpZiGgCdFBVwZQkgJxFIaaVsnRM0S1cOQ1gwfxRL/GYjnM18cCb

# hojnieWa

# SIG # End signature block