AzStackHciNetwork/AzStackHci.Network.Helpers.psm1
Import-LocalizedData -BindingVariable lnTxt -FileName AzStackHci.Network.Strings.psd1 ################################################################################################# # Network Validators # - Test-NwkValidator_StorageAdapterReadiness # - Test-NwkValidator_StorageConnection # - Test-NwkValidator_InfraIpPoolReadiness # - Test-NwkValidator_AKS_CidrOverlaps # - Test-NwkValidator_HostNetworkConfigurationReadiness # - Test-NwkValidator_AdapterDriverMgmtAdapterReadiness # - Test-NwkValidator_MgmtIPIPPoolRequirement # - Test-NwkValidator_MgmtIPForNewNode # - Test-NwkValidator_ClusterNetworkIntentStatus # - Test-NwkValidator_NetworkIntentRequirement # - Test-NwkValidator_StorageIntentExistance # - Test-NwkValidator_StorageConnectivityType # - Test-NwkValidator_NetworkATCFeatureStatusOnNewNode # - Test-NwkValidator_StorageAdapterIPConfigurationPreUpdate # # Note that the validator names are used in AzStackHci.Network.psm1 file to define which validators # to be run in different scenarios. Please make sure to keep the validator names consistent between # the files. # Check the comments there for more information. ################################################################################################# function Test-NwkValidator_StorageAdapterReadiness { [CmdletBinding()] param ( [System.Management.Automation.Runspaces.PSSession[]] $PSSession, [PSObject[]] $AtcHostIntents ) try { [System.Management.Automation.Runspaces.PSSession[]] $allNodeSessions = EnsureTestSessionOpen -PSSessions $PSSession # For the AtcHostIntents object array, we only need to check the storage only intents [PSObject[]] $storageIntents = $AtcHostIntents | Where-Object { $_.TrafficType.Contains("Storage") -and (-not $_.TrafficType.contains("Management")) -and (-not $_.TrafficType.contains("Compute")) } [String[]] $allPhysicalAdaptersToCheck = @() if ($storageIntents.Count -eq 1) { $allPhysicalAdaptersToCheck = $storageIntents[0].Adapter Log-Info "Will try to check storage adatpers readiness for [ $($allPhysicalAdaptersToCheck -join ',') ]" } elseif ($storageIntents.Count -gt 1) { # Should not get into here as ATC does not support multiple storage intent, so the input $AtcHostIntents # object should not have multiple storage intent in it, but keep it here as a safe guard throw "More than one storage intent found in the AtcHostIntents object array. Fail the storage adapter configuration validation." } else { Log-Info "No storage only intent found in the AtcHostIntents object array. Skip the storage adapter configuration validation." return } $storageAdapterReadinessResults = @() #region Test storage adatper configuration # Now, check every session and make sure that storage pNIC don't have IP or VLANID foreach ($testSession in $allNodeSessions) { Log-Info "Checking storage adapter IP status on $($testSession.ComputerName)" $adapterReadinessResult = Invoke-Command -Session $testSession -ScriptBlock ${function:CheckStorageAdapterReadiness} -ArgumentList @(, $allPhysicalAdaptersToCheck) Log-Info "Got storage adapter readiness validation results from $($testSession.ComputerName)" $storageAdapterReadinessValidationStatus = if ($adapterReadinessResult.Pass) { 'SUCCESS' } else { 'FAILURE' } $storageAdapterReadinessValidationDetailMessage = $adapterReadinessResult.Message $storageAdapterReadinessRstObject = @{ Name = 'AzStackHci_Network_Test_StorageAdapterReadiness' Title = 'Test storage adapter readiness on node' DisplayName = 'Test storage adapter readiness on node' Severity = 'CRITICAL' Description = 'Test storage adapter readiness on node: no pre-defined IP on it, no VLANID configured on it' Tags = @{} Remediation = "Remove any pre-defined IP on the storage adapter, remove any VLANID configured on the storage adapter" TargetResourceID = "StorageAdapterReadiness" TargetResourceName = "StorageAdapterReadiness" TargetResourceType = "StorageAdapterReadiness" Timestamp = [datetime]::UtcNow Status = $storageAdapterReadinessValidationStatus AdditionalData = @{ Source = $testSession.ComputerName Resource = 'StorageAdapterReadiness' Detail = $storageAdapterReadinessValidationDetailMessage Status = $storageAdapterReadinessValidationStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $storageAdapterReadinessResults += New-AzStackHciResultObject @storageAdapterReadinessRstObject } #endregion return $storageAdapterReadinessResults } catch { throw $_ } } function Test-NwkValidator_StorageConnection { <# .SYNOPSIS Test stamp storage connection for deployment .DESCRIPTION This validator tests the storage connection for the deployment using Test-Cluster or ping MESH. It will only be run if the end user provides one storage intent: If the storage intent is not converged intent, we check pNIC connection only. If the storage intent is converged intent (a.k.a., with management or compute intent combined), we create VMSwitch and storage vNIC for connection testing. The validation run ping mesh on each host for storage adapters using APIPA (Automatic Private IP Addressing) (address in subnet 169.254.0.0/16). We only run “ping” test and check if the results have “Reply from <TARGETIP>: bytes=” string in it. With this test, there will be 1 validation result generated for each of the server in the stamp. After the validation is finished, we clean the test artifacts created during the validation (like the VLANID configuration on pNIC, VMSwitch itself, etc.) .PARAMETER PSSession The remote session array to the nodes to be validated .PARAMETER HostNetworkInfo The ATC host network info object, which contains the all the necessary host network configuration information for the nodes, like intent, storage network, etc. Easiest way to get this is to convert from the "HostNetwork" object in the unattended JSON file. .EXAMPLE Test-NwkValidator_StorageConnection -PSSession $PSSession -HostNetworkInfo $HostNetworkInfo #> [CmdletBinding()] param ( [System.Management.Automation.Runspaces.PSSession[]] $PSSession, [PSObject] $HostNetworkInfo, [Parameter(Mandatory = $false)] [System.Boolean] $SwitchlessDeploy = $false ) try { if (-not $HostNetworkInfo) { throw "HostNetworkInfo is required for the storage connection validation." } Log-Info "Start to run Test-NwkValidator_StorageConnection function" [PSObject[]] $AtcHostIntents = $HostNetworkInfo.intents [System.Collections.Hashtable] $storageAdapterVLANIDInfo = @{} [PSObject[]] $storageNetworkDefinition = $HostNetworkInfo.storageNetworks foreach ($storageNetworkInfo in $storageNetworkDefinition) { $storageAdapterVLANIDInfo.Add($storagenetworkInfo.networkAdapterName, $storageNetworkInfo.VlanId) } [System.Management.Automation.Runspaces.PSSession[]] $newTestSessionsBeforeChecking = EnsureTestSessionOpen -PSSessions $PSSession #region Define variables used during the validation [PSObject[]] $allStorageAdaptersToCheck = @() [System.Collections.Hashtable] $storageAdapterVlanIdToConfig = @{} [System.Boolean] $needStorageVMSwitch = $false [System.String] $storageVMSwitchName= "" # If we need to create VMSwitch, we will use only 1 pNIC for the VMSwitch [System.String] $adapterForStorageVMSwitch = "" [System.Boolean] $needMgmtOnStorageVMSwitch = $false #endregion #region Prepare variables # Only need to worry about storage intent [PSObject[]] $tmpStorageIntents = $AtcHostIntents | Where-Object { $_.TrafficType.Contains("Storage") } [String[]] $tmpStorageIntentPhysicalAdapters = @() # Prepare $allStorageAdaptersToCheck, $needStorageVMSwitch, $storageVMSwitchName, $adapterForStorageVMSwitch, $needMgmtOnStorageVMSwitch, $storageAdapterVlanIdToConfig if ($tmpStorageIntents.Count -eq 1) { Log-Info "Found storage intent [ $($tmpStorageIntents[0].Name) ]. Need to run storage adapter connection validation." $tmpStorageIntentPhysicalAdapters = $tmpStorageIntents[0].Adapter if ($tmpStorageIntentPhysicalAdapters.Count -eq 0) { # Ideally should not come to here but keep it here as a safe guard Log-Info "No physical adapter found in the storage intent. Fail the storage adapter connection validation." throw "No physical adapter found in the storage intent. Fail the storage adapter connection validation." } Log-Info "Found physical adapter list [ $($tmpStorageIntentPhysicalAdapters -join ",") ] in the intent." # If it is a converged intent, we will need to create VMSwitch/vNIC for validation # if it is storage only intent, we just check the physical storage adapter if ($tmpStorageIntents[0].TrafficType.Contains("Management") -or $tmpStorageIntents[0].TrafficType.Contains("Compute")) { # Converged intent with storage, will need to create vNIC for storage Log-Info "Converged intent. Will need to create VMSwitch/vNIC for storage connection validation." foreach ($tempName in $tmpStorageIntentPhysicalAdapters) { # Pre-define the storage vNIC to be checked $allStorageAdaptersToCheck += "vStorage($($tempName))" $storageAdapterVlanIdToConfig.Add("vStorage($($tempName))", $StorageAdapterVLANIDInfo[$tempName]) } $needStorageVMSwitch = $true $tmpGuid = [System.Guid]::NewGuid() $storageVMSwitchName = "StorageTestVMSwitch$($tmpGuid)" Log-Info "Will need to create VMSwitch with name $($storageVMSwitchName) for storage connection validation." $adapterForStorageVMSwitch = $tmpStorageIntentPhysicalAdapters[-1] if ($tmpStorageIntentPhysicalAdapters.Count -eq 1) { $needMgmtOnStorageVMSwitch = $true Log-Info "Only one adapter in the converged intent. Will need make sure mgmt connection vNIC configured correctly on the VMSwitch." } } else { Log-Info "Storage only intent. Will need to run storage connection validation on pNIC only." $allStorageAdaptersToCheck = $tmpStorageIntentPhysicalAdapters $storageAdapterVlanIdToConfig = $StorageAdapterVLANIDInfo } Log-Info "Storage adapter NAME list used for the validation:" Log-Info "$($allStorageAdaptersToCheck -join ",")" Log-Info "Storage adapter VLANID list used for the validation:" Log-Info "$($storageAdapterVlanIdToConfig | Out-String)" } elseif ($tmpStorageIntents.Count -gt 1) { # Should not get into here as ATC does not support multiple storage intent, so the input $AtcHostIntents # object should not have multiple storage intent in it, but keep it here as a safe guard Log-Info "More than one storage intent found in the AtcHostIntents object array. Fail the storage adapter connection validation." throw "More than one storage intent found in the AtcHostIntents object array. Fail the storage adapter connection validation." } else { Log-Info "No storage intent found in the AtcHostIntents object array. Skip the storage adapter connection validation." return } #endregion # validation results to be returned $storageAdapterConnectionResults = @() [System.Boolean] $needCleanUpStorageVMSwitch = $false if ($needStorageVMSwitch) { # First make sure all the nodes have same configuration Log-Info "Need to create storage VMSwitch for the validation. Make sure same configuration on all host(s)." [System.Boolean] $allNodeSameConfig = $true [System.String] $allNodeVMSwitchStatus = $null [System.String] $existingVMSwitchOnMachine = $null [System.String] $nodesVMSwitchConfigStatusMessage = "Server VMSwitch Configuration Status:" foreach ($testSession in $newTestSessionsBeforeChecking) { Log-Info "Checking VMSwitch configuration on node $($testSession.ComputerName)" $currentNodeConfig = Invoke-Command -Session $testSession -ScriptBlock { param ($AdapterForStorageVMSwitch) $retVal = New-Object PSObject -Property @{ retValVMSwitchStatus = "" existingVMSwitchName = "" } [System.String] $retValVMSwitchStatus = "" [System.String] $existingVMSwitchName = "" $storageadapterGuidOnCurrentNode = (Get-NetAdapter -Physical -Name $AdapterForStorageVMSwitch -ErrorAction SilentlyContinue).InterfaceGuid.Trim('{').Trim('}') try { $vmSwitchTeam = Get-VMSwitchTeam -ErrorAction SilentlyContinue if ($vmSwitchTeam -and ($vmSwitchTeam.NetAdapterInterfaceGuid.Guid -contains $storageadapterGuidOnCurrentNode)) { # Already have a VMSwitch that contains the storage physical adapter, no need to create a new one $retValVMSwitchStatus = "EXIST_VMSWITCH" $existingVMSwitchName = $vmSwitchTeam.Name } else { # Need to create VMSwitch on node for storage connection validation $retValVMSwitchStatus = "NEED_CREATE_VMSWITCH" } } catch { # In case the Hyper-V PowerShell module is not ready, we cannot do anything here # This current validator will fail. Considering current it is only WARNING, so should be fine here. $retValVMSwitchStatus = "HYPER_V_POWERSHELL_NOT_READY" } $retVal.retValVMSwitchStatus = $retValVMSwitchStatus $retVal.existingVMSwitchName = $existingVMSwitchName return $retVal } -ArgumentList $adapterForStorageVMSwitch Log-Info "Current node $($testSession.ComputerName) with VMSwitch status $($currentNodeConfig.retValVMSwitchStatus)" if (-not $allNodeVMSwitchStatus) { $allNodeVMSwitchStatus = $currentNodeConfig.retValVMSwitchStatus $existingVMSwitchOnMachine = $currentNodeConfig.existingVMSwitchName } else { if ($allNodeVMSwitchStatus -ne $currentNodeConfig.retValVMSwitchStatus) { Log-Info "VMSwitch status is different with other nodes. Will fail the validation." $nodesVMSwitchConfigStatusMessage += "`n Server $($testSession.ComputerName): $($currentNodeConfig.retValVMSwitchStatus)" $allNodeSameConfig = $false } } } if ((-not $allNodeSameConfig) -or ($allNodeVMSwitchStatus -notin @("EXIST_VMSWITCH", "NEED_CREATE_VMSWITCH"))) { # In case the node VMSwitch configuration is different between each other, we cannot do anything here # Should not be here, but will fail the validation just in case end user did not configure the system correctly $nodesVMSwitchConfigStatusMessage += "`nCannot check virtual switch configuration between servers for storage adapters." $nodesVMSwitchConfigStatusMessage += "`nPlease make sure the storage adapter configuration are the same across all servers." $nodesVMSwitchConfigStatusMessage += "`n If the adapters are teamed within a virtual switch, the teaming should be same on all servers." $nodesVMSwitchConfigStatusMessage += "`n The virtual Switch might be a left over of previous environment validator run. You could clean it up manually." $nodesVMSwitchConfigStatusMessage += "`n For example: Remove-VMSwitch -Name `"StorageTestVMSwitch`" -Force" Log-Info $nodesVMSwitchConfigStatusMessage -Type 'WARNING' $storageAdapterConnectionRstObject = @{ Name = "AzStackHci_Network_Test_StorageConnections_VMSWITCH_CONFIG_DIFFERENT" Title = 'VMSwitch configuration different between nodes for storage adpaters.' DisplayName = 'VMSwitch configuration different between nodes for storage adpaters.' Severity = 'CRITICAL' Description = 'VMSwitch configuration different between nodes for storage adpaters' Tags = @{} Remediation = 'To validate storage connections, make sure the storage adapter configuration are the same across all nodes. If storage adapters are teamed within a VMSwitch, the teaming should be same on all nodes.' TargetResourceID = 'CannotFindSameStorageAdapterConfiguration' TargetResourceName = 'CannotFindSameStorageAdapterConfiguration' TargetResourceType = 'CannotFindSameStorageAdapterConfiguration' Timestamp = [datetime]::UtcNow Status = 'FAILURE' AdditionalData = @{ Source = '' Resource = 'CannotFindSameStorageAdapterConfiguration' Detail = $nodesVMSwitchConfigStatusMessage Status = 'FAILURE' TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $storageAdapterConnectionResults += New-AzStackHciResultObject @storageAdapterConnectionRstObject return $storageAdapterConnectionResults } if ($allNodeVMSwitchStatus -eq "EXIST_VMSWITCH") { $needCleanUpStorageVMSwitch = $false # Just need to create new storage vNIC to test the storage connection foreach ($testSession in $newTestSessionsBeforeChecking) { Invoke-Command -Session $testSession -ScriptBlock { New-Item -Path "Function:\CreateStorageVNIC" -Value ${using:function:CreateStorageVNIC} -Force | Out-Null CreateStorageVNIC -StorageVMSwitchName $using:existingVMSwitchOnMachine ` -StorageVNICNames $using:allStorageAdaptersToCheck ` -StorageAdapterVLANIDInfo $using:storageAdapterVlanIdToConfig } } } elseif ($allNodeVMSwitchStatus -eq "NEED_CREATE_VMSWITCH") { $needCleanUpStorageVMSwitch = $true # Need to create VMSwitch on each node for storage connection validation Log-Info "Prepare VMSwitch for storage connection validation on all nodes" Log-Info " VMSwitch name: $($storageVMSwitchName)" Log-Info " Physical adapter to be teamed: $($adapterForStorageVMSwitch)" Log-Info " Storage vNIC will be created: $($allStorageAdaptersToCheck)" Log-Info " Storage VLANID will be used: $($storageAdapterVlanIdToConfig | Out-String)" Log-Info " Need to create management VNIC: $($needMgmtOnStorageVMSwitch)" foreach ($testSession in $newTestSessionsBeforeChecking) { Log-Info "Trying to prepare storage connection validation VMSwitch/vNIC on $($testSession.ComputerName)" if ($needMgmtOnStorageVMSwitch) { Log-Info " Might lost computer connection momentarily..." } Log-Info " Make sure function ConfigureVMSwitchForTesting and CreateStorageVNIC exist in remote session on the machine..." Invoke-Command -Session $testSession -ScriptBlock { New-Item -Path "Function:\ConfigureVMSwitchForTesting" -Value ${using:function:ConfigureVMSwitchForTesting} -Force | Out-Null New-Item -Path "Function:\CreateStorageVNIC" -Value ${using:function:CreateStorageVNIC} -Force | Out-Null } $invokeCommandCreateStorageVMSwitchParam = @{ Session = $testSession ScriptBlock = ${function:ConfigureStorageVMSwitchVNICForTesting} ArgumentList = @($adapterForStorageVMSwitch, $storageVMSwitchName, $allStorageAdaptersToCheck, $storageAdapterVlanIdToConfig, $needMgmtOnStorageVMSwitch) } Log-Info " Calling ConfigureStorageVMSwitchVNICForTesting to create VMSwitch/storage vNIC on the machine..." $vmSwitchCreationInfo = Invoke-Command @invokeCommandCreateStorageVMSwitchParam Log-Info " Done with machine $($testSession.ComputerName)!" } } } else { Log-Info "No need to create VMSwitch for storage connection validation. Will need to set the VLANID on pNIC on all nodes for the validation." foreach ($testSession in $newTestSessionsBeforeChecking) { Log-Info "Trying to set storage adapter VLANID on $($testSession.ComputerName)" Invoke-Command -Session $testSession -ArgumentList $storageAdapterVlanIdToConfig -ScriptBlock { param ([System.Collections.Hashtable] $StorageAdapterVLANIDInfo) foreach ($adapterName in $StorageAdapterVLANIDInfo.Keys) { $vlanId = $StorageAdapterVLANIDInfo[$adapterName] if ($vlanId -ne 0) { $adapter = Get-NetAdapter -Name $adapterName -ErrorAction SilentlyContinue if ($adapter) { Set-NetAdapterAdvancedProperty -Name $adapterName -RegistryKeyword "VLANID" -RegistryValue $vlanId } } } } Log-Info "Done with $($testSession.ComputerName)!" } } # Need to make sure we have the pre-req that needed for the storage connection validation # Feature Failover-Clustering is installed, or storage adapter has IPv4 APIPA address # If converged intent with storage, then hyper-v feature should be there in the system. $usePingMeshOnIPv4 = $true [System.Collections.Hashtable] $hostIPv4AddressTable = @{} $checkHostIPv4AddressScript = { [CmdletBinding()] param ([String[]] $StorageAdaptersToCheck) $retVal = New-Object PSObject -Property @{ Pass = $true ComputerNetBIOSName = $env:COMPUTERNAME AdapterIPv4Mapping = @{} } foreach ($storageAdapter in $StorageAdaptersToCheck) { #region Wait for storage adapter to get IPv4 APIPA address [System.Boolean] $currentAdapterIPReady = $false $ipStopWatch = [System.diagnostics.stopwatch]::StartNew() while (-not $currentAdapterIPReady -and ($ipStopWatch.Elapsed.TotalSeconds -lt 60)) { # Using Get-NetIPConfiguration here as Get-NetIPAddress seems has issue while executed for local machine in Invoke-Command [PSObject[]] $adapterIpv4Addresses = (Get-NetIPConfiguration -InterfaceAlias $storageAdapter).IPV4Address ` | Where-Object { $_.AddressState -eq "Preferred" -and $_.PrefixOrigin -eq "WellKnown" -and $_.IPAddress -like "169.254.*" } if ($adapterIpv4Addresses.Count -gt 0) { $currentAdapterIPReady = $true break } else { Start-Sleep -Seconds 3 } } #endregion if ($adapterIpv4Addresses.Count -gt 0) { $retVal.AdapterIPv4Mapping.Add($storageAdapter, $adapterIpv4Addresses[0].IPAddress) } else { $retVal.Pass = $false break } } return $retVal } # In case of VMSwitch creation scenario, the old PSSession might be in state of "Broken", so trying to re-open the session00 [System.Management.Automation.Runspaces.PSSession[]] $newTestSessions = EnsureTestSessionOpen -PSSessions $newTestSessionsBeforeChecking foreach ($testSession in $newTestSessions) { Log-Info "Check if we could use ping mesh by using IPv4 APIPA address on stroage adapter to validate storage connection on $($testSession.ComputerName)" $storageAdapterIPv4ForCurrentNode = Invoke-Command -Session $testSession -ScriptBlock $checkHostIPv4AddressScript -ArgumentList @(, $allStorageAdaptersToCheck) if (-not $storageAdapterIPv4ForCurrentNode.Pass) { Log-Info "Cannot find IPv4 APIPA address on storage adapter on $($testSession.ComputerName). Will not run the validation." $usePingMeshOnIPv4 = $false } else { Log-Info "IPv4 APIPA address found on storage adapter on $($testSession.ComputerName)." $hostIPv4AddressTable.Add($storageAdapterIPv4ForCurrentNode.ComputerNetBIOSName, $storageAdapterIPv4ForCurrentNode.AdapterIPv4Mapping) } } if ($usePingMeshOnIPv4) { [System.Collections.Hashtable] $allHostStorageAdapterLinkConnections = @{} # Calculate link connections for switchless configuration only: for switched configuration, we always expect the storage # adapter with same name are in the same subnet, so don't need to generate the link connections. if (($storageNetworkDefinition.StorageAdapterIPInfo.Count -gt 0) -and $SwitchlessDeploy) { foreach ($adapterInfo in $storageNetworkDefinition) { $adapterName = $adapterInfo.NetworkAdapterName foreach ($storageAdapterIPInfoEntry in $adapterInfo.StorageAdapterIPInfo) { $currentNode = $storageAdapterIPInfoEntry.PhysicalNode $currentEntryPrefixLength = ConvertTo-PrefixLength -SubnetMask $storageAdapterIPInfoEntry.SubnetMask $currentSubnet = EnvValidatorNormalizeIPv4Subnet -cidrSubnet "$($storageAdapterIPInfoEntry.IPv4Address)/$($currentEntryPrefixLength)" if (-not $allHostStorageAdapterLinkConnections.ContainsKey($currentNode)) { $allHostStorageAdapterLinkConnections[$currentNode] = @() } $link = @{ SrcAdapter = $adapterName DestinationInfo = @() } foreach ($otherAdapter in $storageNetworkDefinition) { foreach ($otherEntry in $otherAdapter.StorageAdapterIPInfo) { $otherNode = $otherEntry.PhysicalNode $otherEntryPrefixLength = ConvertTo-PrefixLength -SubnetMask $otherEntry.SubnetMask $otherSubnet = EnvValidatorNormalizeIPv4Subnet -cidrSubnet "$($otherEntry.IPv4Address)/$($otherEntryPrefixLength)" if ($otherSubnet -eq $currentSubnet -and $otherNode -ne $currentNode) { $link.DestinationInfo += @{ DestNode = $otherEntry.PhysicalNode DestAdapter = $otherAdapter.NetworkAdapterName } } } } $allHostStorageAdapterLinkConnections[$currentNode] += $link } } } else { Log-Info "Switchless env: [ $SwitchlessDeploy ] - No need to calculate link connections." } $validationFunctionParams = @{ allNodeSessions = $newTestSessions HostIPv4Table = $hostIPv4AddressTable HostStorageAdapterLinkConnections = $allHostStorageAdapterLinkConnections } $storageAdapterConnectionResults = ValidateStorageConnections @validationFunctionParams } else { $tmpMessage = "No valid method available to test storage connection. Skip the validation." Log-Info $tmpMessage -Type 'WARNING' $tmpRemediationMsg = "To validate storage connections, make sure only IPv4 APIPA address is available on all storage adapters on all servers." $tmpRemediationMsg += "`nIf you have DHCP enabled on storage adapter, please disable it." $tmpRemediationMsg += "`n Set-NetIPInterface -InterfaceAlias <StorageAdapterAlias> -Dhcp Disabled" $tmpRemediationMsg += "`nIf you configured static IP on storage adapter, please remove it." $tmpRemediationMsg += "`n Remove-NetIPAddress -InterfaceAlias <StorageAdapterAlias>" $storageAdapterConnectionRstObject = @{ Name = "AzStackHci_Network_Test_StorageConnections_NO_VALID_METHOD" Title = 'Cannot find valid validation method to test storage adapter connections' DisplayName = 'Cannot find valid validation method to test storage adapter connections' Severity = 'CRITICAL' Description = 'Cannot find valid validation method to test storage adapter connections' Tags = @{} Remediation = $tmpRemediationMsg TargetResourceID = 'CannotValidateStorageConnections' TargetResourceName = 'CannotValidateStorageConnections' TargetResourceType = 'CannotValidateStorageConnections' Timestamp = [datetime]::UtcNow Status = 'FAILURE' AdditionalData = @{ Source = '' Resource = 'CannotValidateStorageConnections' Detail = $tmpMessage Status = 'FAILURE' TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $storageAdapterConnectionResults += New-AzStackHciResultObject @storageAdapterConnectionRstObject } return $storageAdapterConnectionResults } catch { throw $_ } finally { # Need to clean the storage vNIC Log-Info "Done with validation run. Now clean up test artifacts created during validation." Log-Info "Try to clean up storage vNIC and/or storage pNIC VLANID" foreach ($testSession in $newTestSessions) { Log-Info "Working to remove storage vNIC and or storage pNIC VLANID on $($testSession.ComputerName)" Invoke-Command -Session $testSession -ScriptBlock { foreach ($adapterName in $using:allStorageAdaptersToCheck) { Remove-VMNetworkAdapter -ManagementOS -Name $adapterName -ErrorAction SilentlyContinue } if (-not $using:needStorageVMSwitch) { foreach ($adapterName in $using:allStorageAdaptersToCheck) { Set-NetAdapterAdvancedProperty -Name $adapterName -RegistryKeyword "VLANID" -RegistryValue 0 -ErrorAction SilentlyContinue } } # Device Management Service might need to be restarted to refresh the nic details # It also might not be there if (Get-Service -Name DeviceManagementService -ErrorAction SilentlyContinue) { Restart-Service -Name DeviceManagementService -Force -ErrorAction SilentlyContinue Start-Sleep -Seconds 20 } } Log-Info " Done with $($testSession.ComputerName)!" } if ($needCleanUpStorageVMSwitch) { Log-Info "Need to clean up VMSwitch created during the validation" $mgmtVlanIdToRestore = $vmSwitchCreationInfo.MgmtVlanId foreach ($testSession in $newTestSessions) { Log-Info "Working to remove VMSwitch on $($testSession.ComputerName)..." if ($needMgmtOnStorageVMSwitch) { Log-Info " Might lost computer connection momentarily..." if ( $mgmtVlanIdToRestore -ne 0) { Log-Info " Need to restore management VLANID to: $mgmtVlanIdToRestore" } } Invoke-Command -Session $testSession -ScriptBlock { Remove-VMSwitch -Name $using:storageVMSwitchName -Force if ($using:needMgmtOnStorageVMSwitch) { # Need to restore the mgmt VLANID on the mgmt adapter if ($using:mgmtVlanIdToRestore -ne 0) { Set-NetAdapterAdvancedProperty -Name $using:adapterForStorageVMSwitch -RegistryKeyword "VlanID" -RegistryValue $using:mgmtVlanIdToRestore } #region Wait for the NIC to get the IP address back # In case of DHCP scenario, after VMSwitch removed, the pNIC might not get the IP address immediately # Wait for some time (60 seconds) to make sure the new IP is settled correctly. [System.Boolean] $currentIPReady = $false $ipStopWatch = [System.diagnostics.stopwatch]::StartNew() while (-not $currentIPReady -and ($ipStopWatch.Elapsed.TotalSeconds -lt 60)) { # If the pNIC has Manual or Dhcp IPv4 address with "Preferred" state, we consider it as "ready" $ipConfig = Get-NetIPAddress -InterfaceAlias $using:adapterForStorageVMSwitch -ErrorAction SilentlyContinue | Where-Object { ($_.PrefixOrigin -eq "Manual" -or $_.PrefixOrigin -eq "Dhcp") -and $_.AddressFamily -eq "IPv4" -and $_.AddressState -eq "Preferred" } if ($ipConfig) { $currentIPReady = $true break } else { Start-Sleep -Seconds 3 } } #endregion if (-not $currentIPReady) { # should not get into here, but keep it here for safety $ipInfoAll = Get-NetIPAddress -AddressFamily IPv4 -ErrorAction SilentlyContinue | Format-Table IPAddress, InterfaceAlias, PrefixLength, PrefixOrigin -AutoSize Write-Host "$($ipInfoAll | Out-String)" Write-Host "Cannot get the IP address back to the pNIC after VMSwitch removed. Please check the system manually." throw "Cannot get the IP address back to the pNIC after VMSwitch removed. Please check the system manually." } else { Write-Host "IP address back to the pNIC after VMSwitch removed. System is ready for connection." } } # Same need to restart Device Management Service to refresh the nic details here if (Get-Service -Name DeviceManagementService -ErrorAction SilentlyContinue) { Restart-Service -Name DeviceManagementService -Force -ErrorAction SilentlyContinue Start-Sleep -Seconds 20 } } Log-Info " Done with machine $($testSession.ComputerName)!" } } else { Log-Info "No VMSwitch created during the storage connection validation. Skip clean up." } Log-Info "End of Test-NwkValidator_StorageConnection function" } } function Test-NwkValidator_InfraIpPoolReadiness { [CmdletBinding()] param ( [Parameter(Mandatory = $false, HelpMessage = "Specify starting Management IP Range")] [System.Collections.ArrayList] $IpPools, [Parameter(Mandatory = $false, HelpMessage = "Specify Management Subnet")] [string] $ManagementSubnetValue, [Parameter(Mandatory = $false, HelpMessage = "Specify the region name to target for connectivity validation.")] [string] $RegionName, [int[]] $port = @(5986, 5985, 22), [int] $Timeout = 1000, [int] $Minimum = 6, [int] $Maximum = 255, [PSObject[]] $AtcHostIntents, [System.Boolean] $ProxyEnabled = $false ) try { $instanceResults = @() # Check no repeating ips in pool and all in management subnet Log-Info "Test no repeating ips in all IP pools" $TestMgmtIpPools = TestMgmtIpPools -IpPools $IpPools -ManagementSubnetValue $ManagementSubnetValue $Status = if ($TestMgmtIpPools) { 'SUCCESS' } else { 'FAILURE' } $params = @{ Name = "AzStackHci_Network_Test_IP_Pools_Subnet_No_Duplicates" Title = 'Test IP Pools in Management Subnet and No duplicate IPs in IpPools' DisplayName = "Test IP Pools $ManagementSubnetValue" Severity = 'CRITICAL' Description = 'Checking start and end address are on the same subnet' Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = "IpPool-$ManagementSubnetValue" TargetResourceName = "ManagementIPRange" TargetResourceType = 'Network Range' Timestamp = [datetime]::UtcNow Status = $Status AdditionalData = @{ Source = 'CustomerNetwork' Resource = 'CustomerSubnet' Detail = if ($TestMgmtIpPools) { $lnTxt.TestIpPoolPass -f $ManagementSubnetValue } else { $lnTxt.TestIpPoolFail -f $ManagementSubnetValue } Status = $status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params Log-Info "Test all IP in IP pools are in management subnet, and no IP in IP pools are in use" foreach ($ipPool in $IpPools) { $StartingAddress = $ipPool.StartingAddress $EndingAddress = $ipPool.EndingAddress # Check ip in management subnet $TestMgmtSubnet = (TestIPInSubnet -IpToCheck $StartingAddress -ExpectedSubnetCIDR $ManagementSubnetValue) -and (TestIPInSubnet -IpToCheck $EndingAddress -ExpectedSubnetCIDR $ManagementSubnetValue) $Status = if ($TestMgmtSubnet) { 'SUCCESS' } else { 'FAILURE' } $params = @{ Name = 'AzStackHci_Network_Test_Management_IP_Range_Subnet' Title = 'Test Management IP Subnet' DisplayName = "Test Management IP Subnet $StartingAddress - $EndingAddress" Severity = 'CRITICAL' Description = 'Checking start and end address are on the same subnet' Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = "$StartingAddress-$EndingAddress" TargetResourceName = "ManagementIPRange" TargetResourceType = 'Network Range' Timestamp = [datetime]::UtcNow Status = $Status AdditionalData = @{ Source = 'CustomerNetwork' Resource = 'CustomerSubnet' Detail = if ($TestMgmtSubnet) { $lnTxt.TestMgmtSubnetPass -f $StartingAddress, $EndingAddress } else { $lnTxt.TestMgmtSubnetFail -f $StartingAddress, $EndingAddress } Status = $status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params # Test IP in Range are not in use $MgmtIpRange = GetMgmtIpRange -StartingAddress $StartingAddress -EndingAddress $EndingAddress foreach ($Ip in $MgmtIpRange) { $result = @{} $result += @{ 'Ping' = Test-NetConnection -ComputerName $Ip -InformationLevel Quiet -WarningAction SilentlyContinue } foreach ($p in $port) { $result += @{ $p = IsTcpPortInUse -Ip $ip -Port $p -Timeout $Timeout } } $Status = if ($true -notin $result.Values) { 'SUCCESS' } else { 'FAILURE' } $msg = $lnTxt.ActiveHostCheck -f $ip, (($result.Keys | ForEach-Object { "{0}:{1}" -f $psitem,$result[$psitem] }) -join ', ') $Type = if ($result.Values -contains $true) { 'WARNING' } else { 'INFORMATIONAL' } Log-Info $msg -Type $Type $params = @{ Name = 'AzStackHci_Network_Test_Management_IP_No_Active_Hosts' Title = 'Test Management IP Range for Active Hosts' DisplayName = "Test Management IP Range $Ip for Active Hosts" Severity = 'CRITICAL' Description = 'Checking no hosts respond on Management IP range' Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = $Ip TargetResourceName = "ManagementIPRange" TargetResourceType = 'Network Range' Timestamp = [datetime]::UtcNow Status = $Status AdditionalData = @{ Source = $Ip Resource = 'ICMP/SSH/WINRM' Detail = ($result.Keys | ForEach-Object { "{0}:{1}" -f $psitem,$result[$psitem] }) -join ', ' Status = $Status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } } # Check range size Log-Info "Test infra pool range size" $TestMgmtRangeSize = TestMgmtRangeSize -IpPools $IpPools -Minimum $Minimum -Maximum $Maximum $status = if ($TestMgmtRangeSize) { 'SUCCESS' } else { 'FAILURE' } $allIps = GetMgmtIpRangeFromPools -IpPools $IpPools $ipCount = $allIps.Count $params = @{ Name = 'AzStackHci_Network_Test_Management_IP_Range_Size' Title = 'Test Management IP Range Size' DisplayName = "Test Management IP Range Size of all the pools. $ipCount ips found." Severity = 'CRITICAL' Description = "Checking management IP range size is between $minimum-$maximum" Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = "Size:$ipCount " TargetResourceName = "ManagementIPRange" TargetResourceType = 'Network Range' Timestamp = [datetime]::UtcNow Status = $Status AdditionalData = @{ Source = 'CustomerNetwork' Resource = 'CustomerRange' Detail = if ($TestMgmtRangeSize) { $lnTxt.TestMgmtRangeSizePass -f $Minimum, $Maximum } else { $lnTxt.TestMgmtRangeSizeFail -f $Minimum, $Maximum } Status = if ($TestMgmtRangeSize) { 'SUCCESS' } else { 'FAILURE' } TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params # Check pool sizes Log-Info "Test infra pool size" $TestMgmtRangePoolCount = TestMgmtRangePoolCount -IpPools $IpPools -Minimum $Minimum $poolCount = $IpPools.Count $status = if ($TestMgmtRangePoolCount) { 'SUCCESS' } else { 'FAILURE' } $params = @{ Name = 'AzStackHci_Network_Test_Management_IP_Range_Pool_Count' Title = 'Test Management IP Pool Count' DisplayName = "Test Management IP Range Number of IP Pools." Severity = 'CRITICAL' Description = "Checking management IP pools has one or two pools. First pool must only have 1 ip if 2 pools" Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = "Count:$poolCount " TargetResourceName = "ManagementIPRange" TargetResourceType = 'Network Range' Timestamp = [datetime]::UtcNow Status = $Status AdditionalData = @{ Source = 'CustomerNetwork' Resource = 'CustomerRange' Detail = if ($TestMgmtRangePoolCount) { $lnTxt.TestMgmtRangePoolCountPass -f $poolCount} else { $lnTxt.TestMgmtRangePoolCountFail -f $poolCount, ($Minimum - 1) } Status = if ($TestMgmtRangePoolCount) { 'SUCCESS' } else { 'FAILURE' } TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params #region check infra IP conneciton # A new vSwitch and management vNIC is created using Network ATC naming standards. The vSwitch is created using the intents configuration provided by the customer in the deployment json. # We will rotate the vNIC IP with the infra IPs to be tested. # Whatever is the Mgmt intent, we will create the vSwitch using the selected pNICs from the customer. # curl tool seems to provide the solution to test from specific source IP and allows to check TCP ports and also URLs # Only the first 9 IPs from the infra range will be tested. # DNS registration must be avoided on the IPs tested from the vNIC Log-Info "Test infra IP connections" $infraIPRangeToValidate = GetMgmtIpRangeFromPools -IpPools $IpPools if ($ProxyEnabled) { Log-Info "Proxy is enabled on the host. Will check public endpoint connection via proxy." } else { Log-Info "Proxy is not enabled on the host. Will check public endpoint connetion directly." } if ((Get-Command Get-VMSwitch -ErrorAction SilentlyContinue) -and (Get-WindowsFeature -Name Hyper-V -ErrorAction SilentlyContinue).Installed) { [PSObject[]] $mgmtIntent = $AtcHostIntents | Where-Object { $_.TrafficType.Contains("Management") } [System.String] $mgmtIntentName = $mgmtIntent[0].Name [System.String[]] $mgmtAdapters = GetSortedMgmtIntentAdapter -MgmtAdapterNames $mgmtIntent[0].Adapter [System.Guid[]] $intentAdapterGuids = (Get-NetAdapter -Name $mgmtAdapters -ErrorAction SilentlyContinue).InterfaceGuid try { $needCleanUpVMSwitch = $false $mgmtVlanIdToRestore = 0 #region prepare VMSwitch for testing infra IP connection [PSObject[]] $allExistingVMSwitches = Get-VMSwitch -SwitchType External $externalVMSwitchsCount = $allExistingVMSwitches.Count [PSObject] $foundVMSwitchToUse = $null if ($externalVMSwitchsCount -eq 0) { # if we found 0 VMSwitch, we will need to create one for this testing # Note that this operation will have the host disconnected from network for a moment (due to VMSwitch/vNIC creation) # Since the code is executed locally, this disconnection should not affect the execution Log-Info "No VMSwitch exists in system. Will create VMSwitch for testing infra IP connection." $tmpVMSwitchConfigInfo = ConfigureVMSwitchForTesting -SwitchAdapterNames $mgmtAdapters -MgmtIntentName $mgmtIntentName $foundVMSwitchToUse = $tmpVMSwitchConfigInfo.VMSwitchInfo $needCleanUpVMSwitch = $tmpVMSwitchConfigInfo.NeedCleanUp $mgmtVlanIdToRestore = $tmpVMSwitchConfigInfo.MgmtVlanId if (-not $tmpVMSwitchConfigInfo.IPReady) { Log-Info "Cannot get a VMSwitch ready on $($env:COMPUTERNAME) with valid IP on the vNIC created. Fail the validation" throw "Cannot get a VMSwitch ready on $($env:COMPUTERNAME) with valid IP on the vNIC created. Fail the validation" } } else { # if we found at least 1 VMSwitch in the system, we then need to check # If there is one VMSwitch that has the same mgmt intent adapters Log-info "Found $($externalVMSwitchsCount) VMSwitch in the system. Need to check if a valid one could be used for validation." foreach ($externalVMSwitch in $allExistingVMSwitches) { # Need to check the switch is good for deployment: using same adapter as the intent [System.Guid[]] $switchAdapterGuids = $externalVMSwitch.NetAdapterInterfaceGuid if (Compare-Object -ReferenceObject $switchAdapterGuids -DifferenceObject $intentAdapterGuids) { # Adapters used in pre-defined VMSwitch and the intent are different. Ignore that VMSwitch Log-Info "Found $($externalVMSwitch.Name) with different adapters than the mgmt intent. Skip it." } else { # if the system already have a VMSwitch with the same mgmt adpaters in its teaming, we will just use that adpater $foundVMSwitchToUse = $externalVMSwitch break } } if (-not $foundVMSwitchToUse) { Log-info "No valid VMSwitch found! Check if we could create a new VMSwitch for validaton." # At this moment, we need further checking: # If all adapters in the mgmt intent is not used by any adapter, we will need to create a new VMSwitch # If any of the adapter in the mgmt intent is used by any adapter, we will need to error out as this is not a supported scenario [System.Guid[]] $allSwitchAdapterGuids = $allExistingVMSwitches.NetAdapterInterfaceGuid [System.Boolean] $intentAdapterAlreadyUsed = $false foreach ($tmpAdapterGuid in $intentAdapterGuids) { if ($allSwitchAdapterGuids.Contains($tmpAdapterGuid)) { $intentAdapterAlreadyUsed = $true break } } if (-not $intentAdapterAlreadyUsed) { # if none of the adapter in the mgmt intent is used by any adapter, we will create a new VMSwitch Log-Info "VMSwitch found, but no VMSwitch mgmt adapters in the system. Will create VMSwitch for testing infra IP connection." $tmpVMSwitchConfigInfo = ConfigureVMSwitchForTesting -SwitchAdapterNames $mgmtAdapters -MgmtIntentName $mgmtIntentName $foundVMSwitchToUse = $tmpVMSwitchConfigInfo.VMSwitchInfo $needCleanUpVMSwitch = $tmpVMSwitchConfigInfo.NeedCleanUp $mgmtVlanIdToRestore = $tmpVMSwitchConfigInfo.MgmtVlanId if (-not $tmpVMSwitchConfigInfo.IPReady) { Log-Info "Cannot get a VMSwitch ready on $($env:COMPUTERNAME) with valid IP on the vNIC created. Fail the validation" throw "Cannot get a VMSwitch ready on $($env:COMPUTERNAME) with valid IP on the vNIC created. Fail the validation" } } else { # This is an error situation: some of the mgmt intent adapters is already used by an existing VMSwitch, some other mgmt # intent adapter is still "free" in the system. We don't know what to do with this, so need to error out Log-Info "VMSwitch found, mgmt adapter list is not matching to any VMSwitch adapter list. Wrong configuration. Will to fail the validation" } } } #endregion if ($RegionName -eq "AzureLocal") { $allPublicEndpointServicesToCheck = Get-AzstackHciConnectivityTarget -LocalOnly:$true -RegionName $RegionName | Where-Object { $_.Name -Like "Azure_Kubernetes_Service_*" -or $_.Name -Like "AzStackHci_MOCStack_*" -or $_.Name -Like "Vm_Management_HCI_*" } } else { $allPublicEndpointServicesToCheck = Get-AzstackHciConnectivityTarget | Where-Object { $_.Name -Like "Azure_Kubernetes_Service_*" -or $_.Name -Like "AzStackHci_MOCStack_*" -or $_.Name -Like "Vm_Management_HCI_*" } } if ($foundVMSwitchToUse) { Log-Info "Got VMSwitch $($foundVMSwitchToUse.Name) to use for validating infra IP connection. Start the validation..." $mgmtAlias = "vManagement($($MgmtIntentName))" [PSOBject[]] $mgmtAdapterIP = Get-NetIPAddress -InterfaceAlias $mgmtAlias -ErrorAction SilentlyContinue | Where-Object { ($_.PrefixOrigin -eq "Manual" -or $_.PrefixOrigin -eq "Dhcp") -and $_.AddressFamily -eq "IPv4" -and $_.AddressState -eq "Preferred" } if ($mgmtAdapterIP -and $mgmtAdapterIP.Count -gt 0) { $prefixLength = $mgmtAdapterIP[0].PrefixLength[0] $mgmtIPConfig = Get-NetIPConfiguration -InterfaceAlias $mgmtAlias $defaultGateway = $mgmtIPconfig.IPv4DefaultGateway[0].NextHop # Try to get DNS server IP from running system [PSObject[]] $getDNSServers = Get-DnsClientServerAddress -InterfaceAlias $mgmtAlias -AddressFamily IPv4 -ErrorAction SilentlyContinue if ($getDNSServers -and ($getDNSServers.Count -gt 0) -and ($getDNSServers[0].ServerAddresses.Count -gt 0)) { # Get up to 3 DNS servers to check [System.String[]] $dnsServersIPToCheck = $getDNSServers[0].ServerAddresses[0..2] try { #region configure vNIC for testing infra IP connection $tmpGuid = [System.Guid]::NewGuid() $newVNICName = "TestvNIC$($tmpGuid)" Log-Info "Prepare vNIC $($newVNICName) on the VMSwitch to use for infra IP connection validation" if (Get-VMNetworkAdapter -All | where-Object { $_.Name -eq $newVNICName }) { Remove-VMNetworkAdapter -ManagementOS -SwitchName $foundVMSwitchToUse.Name -Name $newVNICName -Confirm:$false } Add-VMNetworkAdapter -ManagementOS -SwitchName $foundVMSwitchToUse.Name -Name $newVNICName Get-NetAdapter -name "vEthernet ($($newVNICName))" -ErrorAction SilentlyContinue | Rename-NetAdapter -NewName $newVNICName Set-DnsClient -InterfaceAlias $newVNICName -RegisterThisConnectionsAddress $false # There is a possibility that the mgmt VMNetworkAdapter is not there # (NOTE: we have the validation in Test-NwkValidator_AdapterDriverMgmtAdapterReadiness, however if the result failed there, the current test will still run. # So there is a chance that below call will throw exception out if we do not specify -ErrorAction SilentlyContinue) $tempVMNetworkAdapterIsolation = Get-VMNetworkAdapterIsolation -ManagementOS -VMNetworkAdapterName $mgmtAlias -ErrorAction SilentlyContinue if ($tempVMNetworkAdapterIsolation -and $tempVMNetworkAdapterIsolation.DefaultIsolationID -ne 0) { Set-VMNetworkAdapterIsolation -ManagementOS ` -VMNetworkAdapterName $newVNICName ` -IsolationMode Vlan ` -AllowUntaggedTraffic $true ` -DefaultIsolationID $tempVMNetworkAdapterIsolation.DefaultIsolationID } Set-NetIPInterface -InterfaceAlias $newVNICName -Dhcp Disabled # Need to wait until the DHCP is disabled on the adapter. Otherwise, following call might fail [System.Boolean] $vNicReady = $false $stopWatch = [System.diagnostics.stopwatch]::StartNew() while (-not $vNicReady -and ($stopWatch.Elapsed.TotalSeconds -lt 30)) { if ((Get-VMNetworkAdapter -ManagementOS -Name $newVNICName -ErrorAction SilentlyContinue) -and ((Get-NetIPInterface -InterfaceAlias $newVNICName -AddressFamily IPv4).Dhcp -eq "Disabled")) { $vNicReady = $true break } else { Start-Sleep -Seconds 3 } } #endregion if ($vNICReady) { Log-Info "VMNetworkAdapter [ $($newVNICName) ] ready and DHCP is disabled on the adapter." $retryTimes = 10 Log-Info "Will check connection from Infra IP to DNS server(s) port 53 and public endpoints for max of $($retryTimes) times" Log-Info "DNS Server to check: $($dnsServersIPToCheck | Out-String)" ################################### # Start testing infra IP connection ################################### # Magic number: we will test only first 9 IPs from the infra range as: # 6 are the one we requested right now for services running in HCI cluster # 3 are the additional that might be used in the future (for example, SLB VM, etc.) # We don't want to test all the infra IP as it will requires a lot of time to finish the validation $ipNumberToCheck = 9 if ($infraIPRangeToValidate.Count -lt $ipNumberToCheck) { $ipNumberToCheck = $infraIPRangeToValidate.Count } for ($i=0; $i -lt $ipNumberToCheck; $i++) { $endpointIndex = 1 $ipToCheck = $infraIPRangeToValidate[$i] Log-Info "`nCheck IP $($i+1) / $($ipNumberToCheck): [ $($ipToCheck) ]" #region Set new IP on the adapter # Make sure no IP on the adapter $oldIpAddresses = Get-NetIPAddress -InterfaceAlias $newVNICName -ErrorAction SilentlyContinue foreach ($ip in $oldIpAddresses) { Remove-NetIPAddress -InterfaceAlias $newVNICName -IPAddress $ip.IPAddress -Confirm:$false -ErrorAction SilentlyContinue } if (Get-NetRoute -InterfaceAlias $newVNICName -DestinationPrefix 0.0.0.0/0 -ErrorAction SilentlyContinue) { New-NetIPAddress -InterfaceAlias $newVNICName -IPAddress $ipToCheck -PrefixLength $prefixLength -SkipAsSource $true | Out-Null } else { New-NetIPAddress -InterfaceAlias $newVNICName -IPAddress $ipToCheck -PrefixLength $prefixLength -DefaultGateway $defaultGateway -SkipAsSource $true | Out-Null } #region Wait for the new IP to be ready [System.Boolean] $currentIPReady = $false $ipStopWatch = [System.diagnostics.stopwatch]::StartNew() while (-not $currentIPReady -and ($ipStopWatch.Elapsed.TotalSeconds -lt 60)) { $ipConfig = Get-NetIPAddress -InterfaceAlias $newVNICName -ErrorAction SilentlyContinue | Where-Object { $_.IPAddress -eq $ipToCheck -and $_.PrefixOrigin -eq "Manual" -and $_.AddressFamily -eq "IPv4" -and $_.AddressState -eq "Preferred" } if ($ipConfig) { $currentIPReady = $true break } else { Start-Sleep -Seconds 3 } } #endregion #endregion #region Check connection from infra IP to DNS server # Note that we cannot use Resolve-DnsName or nslookup here directly, as those call cannot specify the source IP foreach ($currentDNSServerToCheck in $dnsServersIPToCheck) { Log-Info " >> Trying DNS connection to $($currentDNSServerToCheck) port 53." [System.Boolean] $isDnsConnected = $false $retry = 1 while ((-not $isDnsConnected) -and ($retry -le $retryTimes)) { try { $src = [System.Net.IPEndPoint]::new([ipaddress]::Parse($ipToCheck),0) $tc = [System.Net.Sockets.TcpClient]::new($src) $tc.Connect($currentDNSServerToCheck, 53) if ($tc.Connected) { Log-Info " == DNS connection ESTABLISHED to $($currentDNSServerToCheck) on attempt $($retry)" $isDnsConnected = $true break } else { Log-Info " ?? FAILED DNS connection to $($currentDNSServerToCheck) on attempt $($retry)" } } catch { Log-Info " ?? FAILED! Got exception while checking DNS connection on attempt ($($retry))!" } finally { if ($tc) { $tc.Dispose() } } Start-Sleep -Seconds 3 $retry++ } if ($isDnsConnected) { Log-Info " == Found valid DNS connection" break } } #endregion $dnsConnectionRstParams = @{ Name = 'AzStackHci_Network_Test_Infra_IP_Connection_DNS_Server_Port_53' Title = 'Test DNS server port connection for all IP in infra IP pool' DisplayName = "Test DNS server port connection for all IP in infra IP pool" Severity = 'CRITICAL' Description = 'Test DNS server port connection for all IP in infra IP pool' Tags = @{} Remediation = "Make sure infra IP $ipToCheck could connect to your DNS server correctly." TargetResourceID = "Infra_IP_Connection_$($ipToCheck)" TargetResourceName = "Infra_IP_Connection_$($ipToCheck)" TargetResourceType = "Infra_IP_Connection_$($ipToCheck)" Timestamp = [datetime]::UtcNow Status = "FAILURE" AdditionalData = @{ Source = $env:COMPUTERNAME Resource = $($ipToCheck) Detail = "[FAILED] Connection from $ipToCheck to DNS server port 53 failed after 3 attempts. DNS server used: $($dnsServersIPToCheck | Out-String)" Status = "FAILURE" TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } if ($ProxyEnabled) { # In case proxy is enabled, we will downgrade the severity to WARNING as the DNS resolution might happen on proxy server $dnsConnectionRstParams.Severity = 'WARNING' } if ($isDnsConnected) { $dnsConnectionRstParams.Status = "SUCCESS" $dnsConnectionRstParams.AdditionalData.Detail = "[PASSED] Connection from $ipToCheck to DNS server port 53 passed. DNS server used: $($dnsServersIPToCheck | Out-String)" $dnsConnectionRstParams.AdditionalData.Status = "SUCCESS" #region Check connection from infra IP to well known endpoints # Since we rely on DNS naming resolution, we put the checking here in this if statement foreach ($service in $allPublicEndpointServicesToCheck) { foreach ($endpointInService in $service.EndPoint) { if (($endpointInService -match "(:[\d]+)$") -and $ProxyEnabled) { Log-Info " >> Need to skip checking connection to $($endpointInService) in a proxy enabled environment as proxy might not allow HTTP/HTTPS query to non-standard port via curl.exe." continue } # Will try $retryTimes curl connection to the remote endpoint # Note that curl.exe honor the system HTTP_PROXY/HTTPS_PROXY settings, so we don't need to specify "--proxy" parameter here if ($RegionName -eq "AzureLocal") { $endpointToCheck = "$($service.Protocol[0])://$($endpointInService)" $curlGetExpression = "curl.exe -sS --connect-timeout 15 -m 18 --ssl-revoke-best-effort `"$($endpointToCheck)`" --interface $($ipToCheck)" $curlHeaderExpression = "curl.exe -i -sS --connect-timeout 15 -m 18 --ssl-revoke-best-effort `"$($endpointToCheck)`" --interface $($ipToCheck)" } else { $endpointToCheck = "$($service.Protocol[0])://$($endpointInService)" $curlGetExpression = "curl.exe -sS --connect-timeout 15 -m 18 `"$($endpointToCheck)`" --interface $($ipToCheck)" $curlHeaderExpression = "curl.exe -i -sS --connect-timeout 15 -m 18 `"$($endpointToCheck)`" --interface $($ipToCheck)" } # If Arcgateway is enabled, then we need to ensure the endpoint is reachable via the Arc proxy. # Detailed Explanation: The curl command uses the proxy settings from the HTTP_PROXY/HTTPS_PROXY environment variables, # which is pointing to Arc proxy on Arc gateway enabled system. Thus, Without the --interface parameter it will just make sure # the endpoint is reachable via the Arc proxy. $azcmagent = "$env:ProgramW6432\AzureConnectedMachineAgent\azcmagent.exe" if (Test-Path $azcmagent) { $arcConnectionType = & $azcmagent config get connection.type if ( $arcConnectionType -eq "gateway") { # Just check if Arc proxy is able to route this traffic $curlGetExpression = "curl.exe -sS --connect-timeout 15 -m 18 `"$($endpointToCheck)`" " $curlHeaderExpression = "curl.exe -i -sS --connect-timeout 15 -m 18 `"$($endpointToCheck)`" " } } Log-Info " >> Trying public Endpoint connection $($endpointIndex) to $($endpointToCheck)." [System.Boolean] $isPublicEndpointConnected = $false $retry = 1 while ((-not $isPublicEndpointConnected) -and ($retry -le $retryTimes)) { try { Log-Info " == Run $($curlGetExpression)" $curlGetContent = Invoke-Expression $curlGetExpression if (-not [System.String]::IsNullOrWhiteSpace($curlGetContent)) { Log-Info " == Connection ESTABLISHED with GET on attempt $($retry)" $isPublicEndpointConnected = $true break } else { Log-Info " == Run $($curlHeaderExpression)" $curlHeaderContent = Invoke-Expression $curlHeaderExpression # Need to analyze the output of $curlHeaderContent to see if the connection is established # If proxy enabled, the response will need to contain something in addition to the "HTTP/1.1 200 Connection established" if ($ProxyEnabled) { $curlHeaderContent = $curlHeaderContent -replace "^HTTP\/\d\.\d 200 Connection established", "" } if (-not [System.String]::IsNullOrWhiteSpace($curlHeaderContent)) { Log-Info " == Connection ESTABLISHED with HEADER only on attempt $($retry)" $isPublicEndpointConnected = $true break } else { Log-Info " ?? FAILED connection on attempt $($retry)" } } } catch { Log-Info " ?? FAILED! Got exception while checking public endpoint connection on attempt ($($retry))!" Log-Info " ?? FAILED! $($_)!" } Start-Sleep -Seconds 3 $retry++ } if ([System.String]::IsNullOrEmpty($service.Severity) -or [System.String]::IsNullOrWhiteSpace($service.Severity)) { $currentSeverity = "CRITICAL" } else { $currentSeverity = $service.Severity } $publicEndpointRstParams = @{ Name = 'AzStackHci_Network_Test_Infra_IP_Connection_' + $service.Name Title = 'Test outbound connection for IP in infra IP pool' DisplayName = "Test outbound connection for IP in infra IP pool" + $service.Title Severity = $currentSeverity Description = 'Test connection for IP in infra IP pool ' + $service.Description Tags = @{} Remediation = "Make sure infra IP $ipToCheck could connect to public endpoint $endpointToCheck correctly. `nhttps://learn.microsoft.com/en-us/azure/azure-arc/servers/network-requirements?tabs=azure-cloud#urls" TargetResourceID = $service.TargetResourceID TargetResourceName = $service.TargetResourceName TargetResourceType = $service.TargetResourceType Timestamp = [datetime]::UtcNow Status = "FAILURE" AdditionalData = @{ Source = $env:COMPUTERNAME Resource = $($ipToCheck) Detail = "[FAILED] Connection from $ipToCheck to $endpointToCheck failed after $retryTimes attempts" Status = "FAILURE" TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } if ($isPublicEndpointConnected) { $publicEndpointRstParams.Status = "SUCCESS" $publicEndpointRstParams.AdditionalData.Detail = "[PASSED] Connection from $ipToCheck to $endpointToCheck passed." $publicEndpointRstParams.AdditionalData.Status = "SUCCESS" } else { Log-info "Public Endpoint connection failed for infra IP $ipToCheck." } $instanceResults += New-AzStackHciResultObject @publicEndpointRstParams $endpointIndex++ } } #endregion } else { Log-info "DNS connection failed for infra IP $ipToCheck." } $instanceResults += New-AzStackHciResultObject @dnsConnectionRstParams } } else { # vNIC creation failure. Normally won't hit this path, but keep it here for safety Log-Info "Cannot get a vNIC ready on VMSwitch $($foundVMSwitchToUse.Name) in $($env:COMPUTERNAME) for validating infra IP connection. Fail the validation" $params = @{ Name = 'AzStackHci_Network_Test_Infra_IP_Connection_vNIC_Readiness' Title = 'Test virtual adapter readiness for all IP in infra IP pool' DisplayName = "Test virtual adapter readiness for all IP in infra IP pool" Severity = 'CRITICAL' Description = 'Test virtual adapter readiness for all IP in infra IP pool' Tags = @{} Remediation = "Make sure Add/Get-VMNetworkAdapter on $($env:COMPUTERNAME) can run correctly." TargetResourceID = "Infra_IP_Connection_VNICReadiness" TargetResourceName = "Infra_IP_Connection_VNICReadiness" TargetResourceType = "Infra_IP_Connection_VNICReadiness" Timestamp = [datetime]::UtcNow Status = "FAILURE" AdditionalData = @{ Source = $env:COMPUTERNAME Resource = 'VNICReadiness' Detail = "[FAILED] Cannot test connection for infra IP. VM network adapter is not configured correctly on host $($env:COMPUTERNAME)." Status = "FAILURE" TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } } finally { # Best effort to clean the IP used, as the last IP checked might not be cleaned in the previous checking for ($i=0; $i -lt $ipNumberToCheck; $i++) { Remove-NetIPAddress -IPAddress $infraIPRangeToValidate[$i] -ErrorAction SilentlyContinue -Confirm:$false } # Clean up the vNIC if (Get-VMNetworkAdapter -ManagementOS -Name $newVNICName -ErrorAction SilentlyContinue) { Remove-VMNetworkAdapter -ManagementOS -SwitchName $foundVMSwitchToUse.Name -Name $newVNICName -Confirm:$false } } } else { # No DNS client server address found on the adapter Log-Info "Cannot get DNS client server address correctly on $($env:COMPUTERNAME) for validating infra IP connection. Fail the validation" $params = @{ Name = 'AzStackHci_Network_Test_Infra_IP_Connection_DNSClientServerAddress_Readiness' Title = 'Test DNS client server addresses readiness for all IP in infra IP pool' DisplayName = "Test DNS client server addresses readiness for all IP in infra IP pool" Severity = 'CRITICAL' Description = 'Test DNS client server addresses readiness for all IP in infra IP pool' Tags = @{} Remediation = "Set DNS client server address correctly on management adapter [ $($mgmtAlias) ] on $($env:COMPUTERNAME). Check it using Get-DnsClientServerAddress" TargetResourceID = "Infra_IP_Connection_DNSClientReadiness" TargetResourceName = "Infra_IP_Connection_DNSClientReadiness" TargetResourceType = "Infra_IP_Connection_DNSClientReadiness" Timestamp = [datetime]::UtcNow Status = "FAILURE" AdditionalData = @{ Source = $env:COMPUTERNAME Resource = 'DNSClientReadiness' Detail = "[FAILED] Cannot find correctly DNS client server address on host $($env:COMPUTERNAME)." Status = "FAILURE" TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } } else { Log-Info "Got VMSwitch, but cannot get a valid vNIC to use on $($env:COMPUTERNAME) for validating infra IP connection. Fail the validation" $params = @{ Name = 'AzStackHci_Network_Test_Infra_IP_Connection_MANAGEMENT_VNIC_Readiness' Title = 'Test VMSwitch/Management VMNetworkAdapter readiness for all IP in infra IP pool' DisplayName = 'Test VMSwitch/Management VMNetworkAdapter readiness for all IP in infra IP pool' Severity = 'CRITICAL' Description = 'Test VMSwitch/Management VMNetworkAdapter readiness for all IP in infra IP pool' Tags = @{} Remediation = "Make sure at least one management VMNetworkAdapter with name $($mgmtAlias) configured correctly on the host $($env:COMPUTERNAME)." TargetResourceID = "Infra_IP_Connection_ManagementVMNetworkAdapterReadiness" TargetResourceName = "Infra_IP_Connection_ManagementVMNetworkAdapterReadiness" TargetResourceType = 'Infra_IP_Connection_ManagementVMNetworkAdapterReadiness' Timestamp = [datetime]::UtcNow Status = "FAILURE" AdditionalData = @{ Source = $env:COMPUTERNAME Resource = 'ManagementVMNetworkAdapterReadiness' Detail = "[FAILED] Cannot test connection for infra IP with wrong management VMNetworkAdapter configured on host $($env:COMPUTERNAME)." Status = "FAILURE" TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } } else { Log-Info "Cannot get a VMSwitch to use on $($env:COMPUTERNAME) for validating infra IP connection. Fail the validation" $params = @{ Name = 'AzStackHci_Network_Test_Infra_IP_Connection_VMSwitch_Readiness' Title = 'Test VMSwitch readiness for all IP in infra IP pool' DisplayName = "Test VMSwitch readiness for all IP in infra IP pool" Severity = 'CRITICAL' Description = 'Test VMSwitch readiness for all IP in infra IP pool' Tags = @{} Remediation = "Make sure at least one VMSwitch preconfigured on the host $($env:COMPUTERNAME) has the same set of adapters defined in management intent." TargetResourceID = "Infra_IP_Connection_VMSwitchReadiness" TargetResourceName = "Infra_IP_Connection_VMSwitchReadiness" TargetResourceType = 'Infra_IP_Connection_VMSwitchReadiness' Timestamp = [datetime]::UtcNow Status = "FAILURE" AdditionalData = @{ Source = $env:COMPUTERNAME Resource = 'VMSwitchReadiness' Detail = "[FAILED] Cannot test connection for infra IP with wrong VMSwitch configured on host $($env:COMPUTERNAME)." Status = "FAILURE" TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } } finally { if ($needCleanUpVMSwitch) { # Clean up the VMSwitch created for testing Log-Info "Clean up VMSwitch $($foundVMSwitchToUse.Name) created during the testing" Remove-VMSwitch -Name $foundVMSwitchToUse.Name -Force -ErrorAction SilentlyContinue if ($mgmtVlanIdToRestore -ne 0) { foreach ($tmpAdapter in $mgmtAdapters) { Log-Info "Restore VlanId for adapter $tmpAdapter to $mgmtVlanIdToRestore" Set-NetAdapterAdvancedProperty -Name $tmpAdapter -RegistryKeyword "VlanID" -RegistryValue $mgmtVlanIdToRestore } } #region Wait for the IP address back to the pNIC # In case of DHCP scenario, after VMSwitch removed, the pNIC might not get the IP address immediately # Wait for some time (60 seconds) to make sure the new IP is settled correctly. Log-Info "Check if IP address is back to the pNIC after VMSwitch removed." [System.Boolean] $currentIPReady = $false $ipStopWatch = [System.diagnostics.stopwatch]::StartNew() while (-not $currentIPReady -and ($ipStopWatch.Elapsed.TotalSeconds -lt 60)) { # If the pNIC has Manual or Dhcp IPv4 address with "Preferred" state, we consider it as "ready" $ipConfig = Get-NetIPAddress -InterfaceAlias $mgmtAdapters[0] -ErrorAction SilentlyContinue | Where-Object { ($_.PrefixOrigin -eq "Manual" -or $_.PrefixOrigin -eq "Dhcp") -and $_.AddressFamily -eq "IPv4" -and $_.AddressState -eq "Preferred" } if ($ipConfig) { $currentIPReady = $true break } else { Log-Info "$($ipInfoAll | Out-String)" Log-Info "IP not ready yet on the pNIC. Will check again in 3 seconds..." Start-Sleep -Seconds 3 } } #endregion if (-not $currentIPReady) { # should not get into here, but keep it here for safety $ipInfoAll = Get-NetIPAddress -AddressFamily IPv4 -ErrorAction SilentlyContinue | Format-Table IPAddress, InterfaceAlias, PrefixLength, PrefixOrigin -AutoSize Log-Info "$($ipInfoAll | Out-String)" Log-Info "Cannot get the IP address back to the pNIC after VMSwitch removed. Please check the system manually." throw "Cannot get the IP address back to the pNIC after VMSwitch removed. Please check the system manually." } else { Log-Info "IP address back to the pNIC after VMSwitch removed. System is ready for next validation." } } else { Log-Info "VMSwitch $($foundVMSwitchToUse.Name) pre-exist in the system. No need to clean up." } } } else { Log-Info "Hyper-V is not working correctly on $($env:COMPUTERNAME). Fail testing infra IP connection." $params = @{ Name = 'AzStackHci_Network_Test_Infra_IP_Connection_Hyper_V_Readiness' Title = 'Test Hyper-V readiness for all IP in infra IP pool' DisplayName = "Test Hyper-V readiness for all IP in infra IP pool" Severity = 'CRITICAL' Description = 'Test Hyper-V readiness for all IP in infra IP pool' Tags = @{} Remediation = "Make sure that Hyper-V is installed on host $($env:COMPUTERNAME) and rerun the validation." TargetResourceID = "Infra_IP_Connection_HYPERVReadiness" TargetResourceName = "Infra_IP_Connection_HYPERVReadiness" TargetResourceType = 'Infra_IP_Connection_HYPERVReadiness' Timestamp = [datetime]::UtcNow Status = "FAILURE" AdditionalData = @{ Source = $env:COMPUTERNAME Resource = 'HYPERVReadiness' Detail = "[FAILED] Cannot test connection for infra IP without Hyper-V on host $($env:COMPUTERNAME)." Status = "FAILURE" TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } #endregion return $instanceResults } catch { throw $_ } finally { # Device Management Service might need to be restarted to refresh the nic details # It also might not be there if (Get-Service -Name DeviceManagementService -ErrorAction SilentlyContinue) { Restart-Service -Name DeviceManagementService -Force -ErrorAction SilentlyContinue Start-Sleep -Seconds 20 Log-Info "Restarted the Device Management Service successfully and waited 20 seconds which should refresh the nic details" } } } function Test-NwkValidator_AKS_CidrOverlaps { <# .SYNOPSIS 1. POD CIDR subnet shall not overlap with customer network 2. Service CIDR subnet shall warn overlaps with customer network. #> [CmdletBinding()] param ( [Parameter(Mandatory = $false, HelpMessage = "Specify starting Management IP Range")] [System.Collections.ArrayList] $IpPools, [Parameter(Mandatory = $false, HelpMessage = "Specify POD CIDR if not default setting: 10.244.0.0/16")] [string] $PODCidr = "10.244.0.0/16" ) try { $instanceResults = @() $ServiceCidr = "10.96.0.0/12" Log-Info "Test for overlaps with POD CIDR range $PODCidr" -ConsoleOut foreach ($ipPool in $IpPools) { $StartingAddress = $ipPool.StartingAddress $EndingAddress = $ipPool.EndingAddress $Status = "FAILURE" # Check IPs in range are not in Kubernetes POD subnet range. $TestCidrSubnet = (TestIPInSubnet -IpToCheck $StartingAddress -ExpectedSubnetCIDR $PODCidr) -or (TestIPInSubnet -IpToCheck $EndingAddress -ExpectedSubnetCIDR $PODCidr) if ($TestCidrSubnet) { Log-Info "IP Range: $StartingAddress - $EndingAddress overlaps with K8s Default POD CIDR: $PODCidr. Please reconfigure the network to resolve this conflict." -Type 'Error' -ConsoleOut } else { $Status = 'SUCCESS' } $params = @{ Name = 'AzStackHci_Network_Test_AKS_Subnet_POD_CIDR_IP_Range_Overlap' Title = "Test for overlaps with POD CIDR Subnet $PODCidr" DisplayName = "Test for overlaps with POD CIDR Subnet $PODCidr" Severity = 'CRITICAL' Description = 'Checking start and end address are not within the POD CIDR Subnet $PODCidr' Tags = @{} Remediation = '"Verify IP pool(s) are not overlapping with AKS pre-defined POD subnet. Check https://learn.microsoft.com/en-us/azure/aks/aksarc/aks-hci-ip-address-planning for more information.' TargetResourceID = "IpPool-$ManagementSubnetValue" TargetResourceName = "ManagementIPRange" TargetResourceType = 'Network Range' Timestamp = [datetime]::UtcNow Status = $Status AdditionalData = @{ Source = 'CustomerNetwork' Resource = 'CustomerSubnet' Detail = if ($TestCidrSubnet) { $lnTxt.TestPodCidrSubnetFail -f $StartingAddress, $EndingAddress, $PODCidr } else { $lnTxt.TestPodCidrSubnetPass -f $StartingAddress, $EndingAddress, $PODCidr } Status = $Status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } Log-Info "Test for overlaps with Service CIDR range $ServiceCidr" -ConsoleOut foreach ($ipPool in $IpPools) { $StartingAddress = $ipPool.StartingAddress $EndingAddress = $ipPool.EndingAddress $Status = "FAILURE" # Check IPs in range are not in Kubernetes Service subnet range. $TestCidrSubnet = (TestIPInSubnet -IpToCheck $StartingAddress -ExpectedSubnetCIDR $ServiceCidr) -or (TestIPInSubnet -IpToCheck $EndingAddress -ExpectedSubnetCIDR $ServiceCidr) if ($TestCidrSubnet) { Log-Info "IP Range: $StartingAddress - $EndingAddress overlaps with K8s Default Service CIDR: $ServiceCidr. Be aware that this many result in suboptimal network conditions." -Type 'WARNING' -ConsoleOut } else { $Status = 'SUCCESS' } $params = @{ Name = 'AzStackHci_Network_Test_AKS_Subnet_Service_CIDR_IP_Range_Overlap' Title = "Test for overlaps with Service CIDR IP Subnet $ServiceCidr" DisplayName = "Test for overlaps with Service CIDR IP Subnet $ServiceCidr" Severity = 'WARNING' Description = 'Checking start and end address are not within the Service CIDR Subnet' Tags = @{} Remediation = "Verify IP pool(s) are not overlapping with AKS pre-defined Service subnet. Check https://learn.microsoft.com/en-us/azure/aks/aksarc/aks-hci-ip-address-planning for more information." TargetResourceID = "IpPool-$ManagementSubnetValue" TargetResourceName = 'ManagementIPRange' TargetResourceType = 'Network Range' Timestamp = [datetime]::UtcNow Status = $Status AdditionalData = @{ Source = 'CustomerNetwork' Resource = 'CustomerSubnet' Detail = if ($TestCidrSubnet) { $lnTxt.TestServiceCidrSubnetFail -f $StartingAddress, $EndingAddress, $ServiceCidr } else { $lnTxt.TestServiceCidrSubnetPass -f $StartingAddress, $EndingAddress, $ServiceCidr } Status = $Status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } } catch { throw $_ } } function Test-NwkValidator_HostNetworkConfigurationReadiness { [CmdletBinding()] param ( [System.Management.Automation.Runspaces.PSSession[]] $PSSession, [PSObject[]] $AtcHostIntents, [ValidateSet('Small','Medium','Large')] [System.String] $HardwareClass = "Medium" ) try { Log-Info "Start running Test-NwkValidator_HostNetworkConfigurationReadiness" if (($PSSession.Count -eq 0) -or ($AtcHostIntents.Count -eq 0)) { Log-Info "No PSSession or AtcHostIntents provided. Skip run of Test-NwkValidator_HostNetworkConfigurationReadiness" return } else { Log-Info "Will check host network adapter RDMA status, adapter symmetry and bandwidth, and other host network" Log-Info "configuration (include DNS client configuraion, Hyper-V is running correctly, VMSwitch (if exists)" Log-Info "has mgmt intent adapters, VlanId for adapters, physical adapter used in JSON." } [System.Management.Automation.Runspaces.PSSession[]] $allPSSessions = EnsureTestSessionOpen -PSSessions $PSSession switch ($HardwareClass) { "Small" { $expectedAdapterMinBandWidth = 1000000000 } # 1Gbps "Medium" { $expectedAdapterMinBandWidth = 10000000000 } # 10Gbps "Large" { $expectedAdapterMinBandWidth = 10000000000 } # 10Gbps Default { $expectedAdapterMinBandWidth = 10000000000 } # 10Gbps } # Check host network readiness status $hostNetworkReadinessTestResults = @() foreach ($session in $allPSSessions) { Log-Info ">>> Running HostNetworkConfigurationReadiness validator on $($session.ComputerName)" #region Check RDMA status Log-Info "Checking NetAdapter RDMA status on $($session.ComputerName)" $rdmaResult = Invoke-Command -Session $session -ScriptBlock ${function:CheckNetAdapterRDMAStatus} -ArgumentList @(, $AtcHostIntents) if ($null -ne $rdmaResult) { Log-Info "Got RDMA validation results from $($session.ComputerName)" $currentMachineRdmaStatus = if ($rdmaResult.Pass) { 'SUCCESS' } else { 'FAILURE' } $currentMachineRdmaTestDetailMessage = $rdmaResult.Message Log-Info " Result: $($currentMachineRdmaTestDetailMessage)" } else { Log-Info "NO RDMA validation results found from $($session.ComputerName)" $currentMachineRdmaStatus = 'FAILURE' $currentMachineRdmaTestDetailMessage = "NO RDMA validation results returned by function CheckNetAdapterRDMAStatus from server $($session.ComputerName)" } $rdmaRstObject = @{ Name = 'AzStackHci_Network_Test_NetAdapter_RDMA_Operational' Title = 'Test NetAdapter RDMA requirement' DisplayName = "Test if RDMA requirement meets for the deployment on all servers" Severity = 'CRITICAL' Description = 'Checking RDMA Operational Status on {0}' -f $session.ComputerName Tags = @{} Remediation = 'Make sure adapter RDMA is operational. Use Get-NetAdapterRdma cmdlet to check the status of RDMA for the network adapter in the system.' TargetResourceID = $session.ComputerName TargetResourceName = "NetAdapter" TargetResourceType = 'Network Adapter RDMA' Timestamp = [datetime]::UtcNow Status = $currentMachineRdmaStatus AdditionalData = @{ Source = $session.ComputerName Resource = 'Network Adapter RDMA Operational Status' Detail = $currentMachineRdmaTestDetailMessage Status = $currentMachineRdmaStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $hostNetworkReadinessTestResults += New-AzStackHciResultObject @rdmaRstObject #endregion #region Check adapter symmetry and bandwidth requirement Log-Info "Checking NetAdapter symmetry bandwidth requirement on $($session.ComputerName)" $adapterSymmetryAndBandwidthResult = Invoke-Command -Session $session -ScriptBlock ${function:CheckAdapterSymmetryAndBandwidth} -ArgumentList $AtcHostIntents, $expectedAdapterMinBandWidth if ($null -ne $adapterSymmetryAndBandwidthResult) { Log-Info "Got adapter symmetry and bandwidth validation results from $($session.ComputerName)" $currentMachineAdapterSymmetryBandwidthStatus = if ($adapterSymmetryAndBandwidthResult.Pass) { 'SUCCESS' } else { 'FAILURE' } $currentMachineAdapterSymmetryBandwidthTestDetailMessage = $adapterSymmetryAndBandwidthResult.Message } else { Log-Info "NO adapter symmetry and bandwidth validation results found from $($session.ComputerName)" $currentMachineAdapterSymmetryBandwidthStatus = 'FAILURE' $currentMachineAdapterSymmetryBandwidthTestDetailMessage = "NO adapter symmetry and bandwidth validation results returned by function CheckAdapterSymmetryAndBandwidth from server $($session.ComputerName)" } $adapterSymmetryRstObject = @{ Name = 'AzStackHci_Network_Test_NetAdapter_Symmetry_Bandwidth' Title = 'Test NetAdapter symmetry and bandwidth requirement' DisplayName = "Test if network adapters used in one intent is symmetry and if bandwidth meets minimum requirement" Severity = 'CRITICAL' Description = 'Checking network adapters and bandwidth Status on {0}' -f $session.ComputerName Tags = @{} Remediation = 'Make sure adapters used in intent are symmetry and mininum bandwidth to use for RDMA is 10G. Use Get-NetAdapter cmdlet on the system to check the adapter information.' TargetResourceID = $session.ComputerName TargetResourceName = "NetAdapter" TargetResourceType = 'Network Adapter Symmetry and Bandwidth' Timestamp = [datetime]::UtcNow Status = $currentMachineAdapterSymmetryBandwidthStatus AdditionalData = @{ Source = $session.ComputerName Resource = 'Network Adapter Symmetry and Bandwidth' Detail = $currentMachineAdapterSymmetryBandwidthTestDetailMessage Status = $currentMachineAdapterSymmetryBandwidthStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $hostNetworkReadinessTestResults += New-AzStackHciResultObject @adapterSymmetryRstObject #endregion #region Host network configuration readiness Log-Info "Checking host network readiness configuration on $($session.ComputerName)" $networkReadinessResult = Invoke-Command -Session $session -ScriptBlock ${function:CheckHostNetworkConfigurationReadiness} -ArgumentList @(, $AtcHostIntents) if ($null -ne $networkReadinessResult) { Log-Info "Network readiness check results from $($session.ComputerName)" $currentMachineNetworkReadinessStatus = if ($networkReadinessResult.Pass) { 'SUCCESS' } else { 'FAILURE' } $currentMachineNetworkReadinessTestDetailMessage = $networkReadinessResult.Message } else { Log-Info "NO host network configuration readiness validation results found from $($session.ComputerName)" $currentMachineNetworkReadinessStatus = 'FAILURE' $currentMachineNetworkReadinessTestDetailMessage = "NO host network configuration readiness validation results returned by function CheckHostNetworkConfigurationReadiness from $($session.ComputerName)" } $networkReadinessRstObject = @{ Name = 'AzStackHci_Network_Test_HostNetworkConfigurationReadiness' Title = 'Test host network configuration readiness' DisplayName = "Test if host network requirement meets for the deployment on all servers" Severity = 'CRITICAL' Description = 'Checking host network configuration readiness status on {0}' -f $session.ComputerName Tags = @{} Remediation = 'Make sure host network configuration readiness is correct. Review detail message to find out the issue.' TargetResourceID = $session.ComputerName TargetResourceName = "HostNetworkReadiness" TargetResourceType = 'HostNetworkReadiness' Timestamp = [datetime]::UtcNow Status = $currentMachineNetworkReadinessStatus AdditionalData = @{ Source = $session.ComputerName Resource = 'HostNetworkReadiness configuration status' Detail = $currentMachineNetworkReadinessTestDetailMessage Status = $currentMachineNetworkReadinessStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $hostNetworkReadinessTestResults += New-AzStackHciResultObject @networkReadinessRstObject #endregion #region Host intent configuration readiness Log-Info "Checking if intent configuration is able to be applied on $($session.ComputerName)" $intentConfigurationReadinessResult = Invoke-Command -Session $session -ScriptBlock ${function:CheckIntentConfigurationReadiness} -ArgumentList @(, $AtcHostIntents) if ($null -ne $intentConfigurationReadinessResult) { Log-Info "Got intent configuration readiness validation results from $($session.ComputerName)" $intentConfigurationReadinessValidationStatus = if ($intentConfigurationReadinessResult.Pass) { 'SUCCESS' } else { 'FAILURE' } $intentConfigurationReadinessValidationDetailMessage = $intentConfigurationReadinessResult.Message Log-Info " Result: $($intentConfigurationReadinessValidationDetailMessage)" } else { Log-Info "NO intent configuration readiness validation results found from $($session.ComputerName)" $intentConfigurationReadinessValidationStatus = 'FAILURE' $intentConfigurationReadinessValidationDetailMessage = "NO intent configuration readiness validation results returned by function CheckIntentConfigurationReadiness from server $($session.ComputerName)" } $intentConfigruationRemediationMsg = "Please doulbe check your adapters advanced property." $intentConfigruationRemediationMsg += "`n Get adapter name: Get-NetAdapter | ft Name" $intentConfigruationRemediationMsg += "`n Get-NetAdapterAdvancedProperty -Name <ADAPTERNAME> -RegistryKeyword <Property To Check>" $intentConfigruationRemediationMsg += "`n <Adapter Name>: Name of the adapter, got from the above Get-NetAdapter call" $intentConfigruationRemediationMsg += "`n <Property To Check>: what property to check. We are validating below properties:" $intentConfigruationRemediationMsg += "`n *NetworkDirectTechnology: check `"ValidDisplayValues`" in it to see if a specific NetworkDirect technology is supported by the adapter" $intentConfigruationRemediationMsg += "`n Valid value should be the combination of the following: iWARP, RoCE, RoCEv2" $intentConfigruationRemediationMsg += "`n Sample: Check what NetworkDirect technology is supported by adapter `"Ethernet`"" $intentConfigruationRemediationMsg += "`n (Get-NetAdapterAdvancedProperty -Name `"Ethernet`" -RegistryKeyword `"*NetworkDirectTechnology`").ValidDisplayValues" $intentConfigurationReadinessRstObject = @{ Name = 'AzStackHci_Network_Test_HostIntentConfigurationReadiness' Title = 'Test host intent configuration readiness' DisplayName = 'Test if intent configuration is ready to be configured on all servers' Severity = 'CRITICAL' Description = 'Test network intent configuration could be possible applied on host {0}' -f $session.ComputerName Tags = @{} Remediation = $intentConfigruationRemediationMsg TargetResourceID = $session.ComputerName TargetResourceName = "IntentConfigurationReadiness" TargetResourceType = "IntentConfigurationReadiness" Timestamp = [datetime]::UtcNow Status = $intentConfigurationReadinessValidationStatus AdditionalData = @{ Source = $session.ComputerName Resource = 'IntentConfigurationReadiness' Detail = $intentConfigurationReadinessValidationDetailMessage Status = $intentConfigurationReadinessValidationStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $hostNetworkReadinessTestResults += New-AzStackHciResultObject @intentConfigurationReadinessRstObject #endregion Log-Info ">>> Done with all HostNetworkConfigurationReadiness validator on $($session.ComputerName)" } return $hostNetworkReadinessTestResults } catch { throw $_ } } function Test-NwkValidator_AdapterDriverMgmtAdapterReadiness { [CmdletBinding()] param ( [System.Management.Automation.Runspaces.PSSession[]] $PSSession, [PSObject[]] $AtcHostIntents, [System.Boolean] $DhcpEnabled, [System.String] $OperationType ) try { [System.Management.Automation.Runspaces.PSSession[]] $allPSSessions = EnsureTestSessionOpen -PSSessions $PSSession $inboxDriverMgmtIPTestResults = @() $checkInboxDriverScript = { [CmdletBinding()] param ( [String[]] $AdapterNames ) $retVal = New-Object PSObject -Property @{ Pass = $true Message = "Adapter inbox driver check on $($ENV:COMPUTERNAME)" } [PSObject[]] $allAdaptersInfo = Get-NetAdapter -Name $AdapterNames -ErrorAction SilentlyContinue if (($allAdaptersInfo.Count -eq 0) -or ($allAdaptersInfo.Count -ne $AdapterNames.Count)) { $retVal.Pass = $false $retVal.Message += "`nFailed: Adapter(s) not found on the system" $retVal.Message += "`nExpected adapter(s): $($AdapterNames | Out-String)" $retVal.Message += "`nFound adapter(s): $($allAdaptersInfo | Out-String)" } else { $adaptersUsingInboxDriver = $allAdaptersInfo | Where-Object { $_.DriverProvider -match "Microsoft" -or $_.DriverProvider -match "Windows" } $hardwareType = (Get-WmiObject -Class Win32_ComputerSystem).Model # Check adatper is not inbox driver for physical environment only if (-not $adaptersUsingInboxDriver -or ($hardwareType -eq "Virtual Machine")) { $retVal.Message += "`nPassed: No adapter using inbox driver found, or current system is a virtual environment." $retVal.Message += "`nAdapter(s) checked: $($AdapterNames)" } else { $retVal.Pass = $false $retVal.Message += "`nFailed: Adapter(s) using inbox driver found on non-virtual environment`n" $retVal.Message += ($adaptersUsingInboxDriver.Name | Out-String) } } return $retVal } $checkMgmtAdapterScript = { [CmdletBinding()] param ( [String[]] $MgmtAdapterNames, [String] $MgmtIntentName, [System.Boolean] $DhcpEnabled, [System.String] $OperationType ) $retVal = New-Object PSObject -Property @{ Pass = $true Message = "Management adapter IP and DNS check on $($ENV:COMPUTERNAME)" } $mgmtVNicName = "vManagement($($MgmtIntentName))" [PSObject[]] $allExistingVMSwitches = @() try { $allExistingVMSwitches = Get-VMSwitch -SwitchType External -ErrorAction SilentlyContinue } catch { } [System.Boolean] $expectedVMSwitchReadyInSystem = $false if ($allExistingVMSwitches.Count -gt 0) { # VMSwitch should contains 0 or all of the mgmt adapters # if VMSwitch contains all mgmt adapters, then there should be 1 vNIC named as "vManagement(mgmtintentname)"" foreach ($externalVMSwitch in $allExistingVMSwitches) { # Need to check the switch is good for deployment: using same adapter as the intent [System.Guid[]] $switchAdapterGuids = $externalVMSwitch.NetAdapterInterfaceGuid [System.Guid[]] $intentAdapterGuids = (Get-NetAdapter -Name $MgmtAdapterNames -Physical -ErrorAction SilentlyContinue).InterfaceGuid if (Compare-Object -ReferenceObject $switchAdapterGuids -DifferenceObject $intentAdapterGuids) { # Adapters used in pre-defined VMSwitch and the intent are different. Need to make sure 0 mgmt adapter used by VMSwitch foreach ($mgmtAdapter in $intentAdapterGuids) { if ($switchAdapterGuids -contains $mgmtAdapter) { $retVal.Pass = $false $retVal.Message += "`n !!! FAILED: Adapter with GUID $($mgmtAdapter) defined in management intent is used by VMSwitch $($externalVMSwitch.Name). Please make sure VMSwitch use ALL adapters defined in the management intent." } } } else { $retVal.Message += "`n Passed: Found one VMSwitch [ $($externalVMSwitch.Name) ] in the system that uses all physical adapters defined in the management intent." $expectedVMSwitchReadyInSystem = $true # VMSwitch uses same set of adapters defined in mgmt intent, will need to check there is a vNIC named as "vManagement(mgmtintentname)" [PSObject[]] $expectedVMNetworkAdapterMgmtNIC = Get-VMNetworkAdapter -ManagementOS -Name $mgmtVNicName -ErrorAction SilentlyContinue if ($expectedVMNetworkAdapterMgmtNIC.Count -ne 1) { $retVal.Pass = $false $retVal.Message += "`n !!! FAILED: Expected 1 VMNetworkAdapter with name [ $($mgmtVNicName) ] in the system. But found $($expectedVMNetworkAdapterMgmtNIC.Count). Please check by running Get-VMNetWorkAdapter." } else { $retVal.Message += "`n Passed: Found one VMNetworkAdapter named as $mgmtVNicName in the system" } [PSObject[]] $expectedNetAdapterMgmtNIC = Get-NetAdapter -Name $mgmtVNicName -ErrorAction SilentlyContinue if ($expectedNetAdapterMgmtNIC.Count -ne 1) { $retVal.Pass = $false $retVal.Message += "`n !!! FAILED: Expected 1 NetAdapter with name [ $($mgmtVNicName) ] in the system. But found $($expectedNetAdapterMgmtNIC.Count). Please check by running Get-NetAdapter." } else { $retVal.Message += "`n Passed: Found one NetAdapter named as $mgmtVNicName in the system" } } } } [String[]] $adaptersToCheck = @() if ($expectedVMSwitchReadyInSystem) { $adaptersToCheck = @($mgmtVNicName) } else { $adaptersToCheck = $MgmtAdapterNames } # Following checks only be performed on the 1st adapter in the list as other adapters might not have # valid IP address configured on it during the test: # Deployment or Add-Server: Might only configured on the 1st adapter # PreUpdate: Only need to check vManagement(<intentname>) $firstMgmtAdapter = $adaptersToCheck[0] # Adapter IP checking if ($DhcpEnabled) { $prefixOriginExpected = "Dhcp" $prefixOriginNotExpected = "Manual" $wrongIpTypeMsg = "Expecting DHCP IP on mgmt adapters, but found static IP." } else { $prefixOriginExpected = "Manual" $prefixOriginNotExpected = "Dhcp" $wrongIpTypeMsg = "Expecting static IP on mgmt adapters, but found DHCP IP." } [PSObject[]] $currentAdapterAddresses = Get-NetIPAddress -InterfaceAlias $firstMgmtAdapter -AddressFamily IPv4 -PolicyStore ActiveStore -ErrorAction SilentlyContinue ` | Where-Object { ($_.PrefixOrigin -eq $prefixOriginExpected) -and ($_.AddressState -eq "Preferred") } if ($currentAdapterAddresses.Count -ge 2) { $retVal.Message += "`n !!! WARNING: Found [ $($currentAdapterAddresses.Count) ] valid IP addresses on management adapter $($firstMgmtAdapter)." $retVal.Message += "`n IP addresses found: $($currentAdapterAddresses.IPAddress -join `",`")" $retVal.Message += "`n Make sure one IP is your machine IP and you should have additional cluster service running in the system and those IP are expected." $retVal.Message += "`n Run `"Get-NetIPAddress -InterfaceAlias `"$($firstMgmtAdapter)`"`" and check the IP address." } if ($currentAdapterAddresses.Count -eq 2) { # When we have only 2 IP addresses on the management adapter, if cluster is up and running and cluster IP on it [System.String] $tmpClusterIp = "" try { $tmpClusterIp = (Get-ClusterResource -Name "Cluster IP Address" | Get-ClusterParameter -Name Address).Value } catch { $tmpClusterIp = "" } if ($tmpClusterIp -in $currentAdapterAddresses.IPAddress) { $retVal.Message += "`n Passed: Got 2 valid IP addresses on management adapter $($firstMgmtAdapter) in the cluster." $retVal.Message += "`n IP address found: $($currentAdapterAddresses.IPAddress -join `",`")" $retVal.Message += "`n include cluster IP: $($tmpClusterIp)" } } # For all mgmt adapter, in deployment time # if DHCP enabled, we should not have static IP address configured on it, otherwise, cluster creation will have problem # Similar, if static IP scenario, we should not have DHCP IP address configured on it. # Note that we don't check this in other scenarios, like PreUpdate, because it is possible that the adapter have # different IP type on it. if ($OperationType -eq "Deployment") { foreach ($mgmtAdatper in $adaptersToCheck) { [PSObject[]] $currentAdapterInValidAddresses = Get-NetIPAddress -InterfaceAlias $mgmtAdatper -AddressFamily IPv4 -PolicyStore ActiveStore -ErrorAction SilentlyContinue ` | Where-Object { ($_.PrefixOrigin -eq $prefixOriginNotExpected) -and ($_.AddressState -eq "Preferred") } if ($currentAdapterInValidAddresses.Count -gt 0) { $retVal.Pass = $false $retVal.Message += "`n !!! FAILED: Found invalid IP address type on adapter $($mgmtAdatper). $($wrongIpTypeMsg)" $retVal.Message += "`n IP addresses found: $($currentAdapterInValidAddresses.IPAddress -join `",`")" $retVal.Message += "`n Run `"Get-NetIPAddress -InterfaceAlias `"$($mgmtAdatper)`"`" and check the IP address configuration." } else { $retVal.Message += "`n Passed: No invalid IP address type found on adapter $($mgmtAdatper)" } } } else { $retVal.Message += "`n INFO: Skipped IP type checking on mgmt adapter(s) during $($OperationType))" } # Adapter default gateway checking [PSObject[]] $currentAdapterNetIPConfiguration = Get-NetIPConfiguration -InterfaceAlias $firstMgmtAdapter -ErrorAction SilentlyContinue if ($currentAdapterNetIPConfiguration) { [PSObject[]] $allDefaultGateway = $currentAdapterNetIPConfiguration[0].IPv4DefaultGateway if ($allDefaultGateway.Count -ne 1) { $retVal.Pass = $false $retVal.Message += "`n !!! FAILED: Cannot find correctly number of default gateway for management adapter $($FirstMgmtPNICName) or $($firstMgmtAdapter)" $retVal.Message += "`n Expect [ 1 ], got [ $($allDefaultGateway.Count) ] default gateway(s)." $retVal.Message += "`n Run `"Get-NetIPConfiguration -InterfaceAlias $($firstMgmtAdapter)`" and check property `"IPv4DefaultGateway`"." } else { $retVal.Message += "`n Passed: Found correct default gateway information for management adapter $($firstMgmtAdapter)" } } else { $retVal.Pass = $false $retVal.Message += "`n !!! FAILED: Cannot find valid IP configuration for management adapter $($firstMgmtAdapter)" $retVal.Message += "`n Run `"Get-NetIPConfiguration -InterfaceAlias $($firstMgmtAdapter)`" to check the IP configuration." } # Adapter DNS server checking. [PSObject[]] $mgmtAdapterDNSClientServerAddresses = Get-DnsClientServerAddress -InterfaceAlias $firstMgmtAdapter -AddressFamily IPv4 -ErrorAction SilentlyContinue if ($mgmtAdapterDNSClientServerAddresses -and ($mgmtAdapterDNSClientServerAddresses.Count -gt 0) -and ($mgmtAdapterDNSClientServerAddresses[0].ServerAddresses.Count -gt 0)) { $retVal.Message += "`n Passed: DNS client server addresses found on management adapter $($firstMgmtAdapter)" $retVal.Message += "`n IP address found: $($mgmtAdapterDNSClientServerAddresses.ServerAddresses | Out-String)" } else { $retVal.Pass = $false $retVal.Message += "`n !!! FAILED: Cannot find any DNS client server addresses on management adapter $($firstMgmtAdapter)" $retVal.Message += "`n Run `"Get-DnsClientServerAddress -InterfaceAlias $firstMgmtAdapter -AddressFamily IPv4`" to check DNS client server address configuration." } return $retVal } Log-Info "DHCP enabled environment? [ $($DhcpEnabled) ]" foreach ($sessionToCheck in $allPSSessions) { #region TEST1: Check inbox driver for all intent adapters in the host Log-Info "Check intent adapter(s) inbox driver on $($sessionToCheck.ComputerName)" [System.String[]] $allIntentAdapters = $AtcHostIntents | Select-Object -ExpandProperty Adapter if ($allIntentAdapters.Count -gt 0) { $tmpInboxDriverCheckRst = Invoke-Command -Session $sessionToCheck -ScriptBlock $checkInboxDriverScript -ArgumentList @(, $allIntentAdapters) if ($null -ne $tmpInboxDriverCheckRst) { Log-Info "Got inbox driver validation results from $($sessionToCheck.ComputerName)" $currentMachineInboxDriverTestStatus = if ($tmpInboxDriverCheckRst.Pass) { 'SUCCESS' } else { 'FAILURE' } $currentMachineInboxDriverTestDetailMessage = $tmpInboxDriverCheckRst.Message } else { # Should not come here, just a safe guard Log-Info "NO inbox driver validation results found from $($sessionToCheck.ComputerName)" $currentMachineInboxDriverTestStatus = 'FAILURE' $currentMachineInboxDriverTestDetailMessage = "NO inbox driver validation results returned from server $($session.ComputerName)" } $inboxDriverCheckRstObject = @{ Name = 'AzStackHci_Network_Test_AdapterDriver' Title = 'Test system adapter driver provider' DisplayName = 'Test system adapter driver provider' Severity = 'CRITICAL' Description = 'Checking adapter driver on {0}' -f $sessionToCheck.ComputerName Tags = @{} Remediation = 'https://learn.microsoft.com/en-us/azure-stack/hci/concepts/host-network-requirements#driver-requirements' TargetResourceID = $sessionToCheck.ComputerName TargetResourceName = "AdapterDriver" TargetResourceType = 'AdapterDriver' Timestamp = [datetime]::UtcNow Status = $currentMachineInboxDriverTestStatus AdditionalData = @{ Source = $sessionToCheck.ComputerName Resource = 'AdapterDriver' Detail = $currentMachineInboxDriverTestDetailMessage Status = $currentMachineInboxDriverTestStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $inboxDriverMgmtIPTestResults += New-AzStackHciResultObject @inboxDriverCheckRstObject } else { # Should not got here. But just keep it here for safe guard Log-Info "No adapter found in intent definition for host $($sessionToCheck.ComputerName). Skip inbox driver check for intent adapter." } #endregion #region TEST2: Check no more than 1 IP address and DNS client server address on mgmt adapter, IP type is correct Log-Info "Check on mgmt adapter readiness on $($sessionToCheck.ComputerName)" [PSObject[]] $mgmtIntent = $AtcHostIntents | Where-Object { $_.TrafficType.Contains("Management") } [System.String] $mgmtIntentName = $mgmtIntent[0].Name [System.String[]] $mgmtAdapters = GetSortedMgmtIntentAdapter -MgmtAdapterNames $mgmtIntent[0].Adapter $tmpMgmtAdapterIPCheckRst = Invoke-Command -Session $sessionToCheck -ScriptBlock $checkMgmtAdapterScript -ArgumentList @($mgmtAdapters, $mgmtIntentName, $DhcpEnabled, $OperationType) if ($null -ne $tmpMgmtAdapterIPCheckRst) { Log-Info "Got mgmt adapter IP validation results from $($sessionToCheck.ComputerName)" $currentMachineMgmtIPTestStatus = if ($tmpMgmtAdapterIPCheckRst.Pass) { 'SUCCESS' } else { 'FAILURE' } $currentMachineMgmtIPTestDetailMessage = $tmpMgmtAdapterIPCheckRst.Message } else { # Should not come here, just a safe guard Log-Info "NO mgmt adapter IP validation results found from $($sessionToCheck.ComputerName)" $currentMachineMgmtIPTestStatus = 'FAILURE' $currentMachineMgmtIPTestDetailMessage = "NO mgmt adapter IP validation results returned from server $($sessionToCheck.ComputerName)" } $mgmtAdapterCheckRstObject = @{ Name = 'AzStackHci_Network_Test_MgmtAdapterReadiness' Title = 'Test system management adapter readiness' DisplayName = 'Test system management adapter readiness' Severity = 'CRITICAL' Description = 'Checking there is one valid management adapter on {0}: make sure it has only one valid IP assigned on it on and DNS server/Gateway are set correctly on it' -f $sessionToCheck.ComputerName Tags = @{} Remediation = 'Make sure there is one valid outbound management adapter on host and have only one valid IP with correct type (DHCP or static) assigned to it and DNS server/Gateway are set correctly on it as well.' TargetResourceID = $sessionToCheck.ComputerName TargetResourceName = "MgmtAdapterIP" TargetResourceType = 'MgmtAdapterIP' Timestamp = [datetime]::UtcNow Status = $currentMachineMgmtIPTestStatus AdditionalData = @{ Source = $sessionToCheck.ComputerName Resource = 'MgmtAdapterIP' Detail = $currentMachineMgmtIPTestDetailMessage Status = $currentMachineMgmtIPTestStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $inboxDriverMgmtIPTestResults += New-AzStackHciResultObject @mgmtAdapterCheckRstObject #endregion } #region TEST3 # Check all adapters used in same intent across all nodes are using same driver version foreach ($intentToCheck in $ATCHostIntents) { [System.String] $intentName = $intentToCheck.Name [System.String[]] $intentAdapters = $intentToCheck.Adapter [System.Boolean] $validIntentAdapterDriverConfigAcrossNodes = $true [System.String] $expectedDriverInfoForCurrentIntentAdapters = "" [System.String] $currentIntentAdapterDriverInfoTestDetailMessage = "Intent [ $($intentName) ] driver info checking:" foreach ($sessionToCheck in $allPSSessions) { # First, check the driver version within each nodes $currentSessionAdapterDriverInfoRst = Invoke-Command -Session $sessionToCheck -ScriptBlock ${function:CheckNetAdapterDriverInfo} -ArgumentList @(, $intentAdapters) # The driver info should also matches across nodes if ($null -ne $currentSessionAdapterDriverInfoRst) { Log-Info "Got intent adapter driver info validation results from $($sessionToCheck.ComputerName)" $validIntentAdapterDriverConfigAcrossNodes = $currentSessionAdapterDriverInfoRst.Pass $currentIntentAdapterDriverInfoTestDetailMessage += $currentSessionAdapterDriverInfoRst.Message if ([System.String]::IsNullOrEmpty($expectedDriverInfoForCurrentIntentAdapters)) { $expectedDriverInfoForCurrentIntentAdapters = $currentSessionAdapterDriverInfoRst.DriverInfo Log-Info "Expected driver info $($expectedDriverInfoForCurrentIntentAdapters)" } else { $currentMachineIntentAdapterDriverVersion = $currentSessionAdapterDriverInfoRst.DriverInfo if ($expectedDriverInfoForCurrentIntentAdapters -ne $currentMachineIntentAdapterDriverVersion) { $validIntentAdapterDriverConfigAcrossNodes = $false $currentIntentAdapterDriverInfoTestDetailMessage += "`nDriver version mismatch between nodes for intent $($intentName)." $currentIntentAdapterDriverInfoTestDetailMessage += "`n Expected driver version: [ $($expectedDriverInfoForCurrentIntentAdapters) ]" $currentIntentAdapterDriverInfoTestDetailMessage += "`n Found driver version: [ $($currentMachineIntentAdapterDriverVersion) ]" } else { $currentIntentAdapterDriverInfoTestDetailMessage += "`nAll nodes have same driver version for intent $($intentName)" $currentIntentAdapterDriverInfoTestDetailMessage += "`n Found driver version: [ $($currentMachineIntentAdapterDriverVersion) ]" } } } else { # Should not get to here, just a safe guard Log-Info "NO intent adapter driver info validation result returned from $($sessionToCheck.ComputerName)" $validIntentAdapterDriverConfigAcrossNodes = $false $currentIntentAdapterDriverInfoTestDetailMessage += "`nNO intent adapter driver info validation result returned from server $($session.ComputerName)" } } if ($validIntentAdapterDriverConfigAcrossNodes) { $currentMachineAdapterDriverInfoTestStatus = 'SUCCESS' } else { $currentMachineAdapterDriverInfoTestStatus = 'FAILURE' } $adapterDriverVersionCheckRstObject = @{ Name = 'AzStackHci_Network_Test_IntentAdapter_DriverVersion' Title = 'Test driver version used in intent adapters' DisplayName = 'Test driver version used in intent adapters' Severity = 'CRITICAL' Description = 'Checking the driver version is same across all the nodes for network intent adapter(s)' Tags = @{} Remediation = '' TargetResourceID = $sessionToCheck.ComputerName TargetResourceName = "MgmtAdapterIP" TargetResourceType = 'MgmtAdapterIP' Timestamp = [datetime]::UtcNow Status = $currentMachineAdapterDriverInfoTestStatus AdditionalData = @{ Source = $sessionToCheck.ComputerName Resource = $intentName Detail = $currentIntentAdapterDriverInfoTestDetailMessage Status = $currentMachineAdapterDriverInfoTestStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $inboxDriverMgmtIPTestResults += New-AzStackHciResultObject @adapterDriverVersionCheckRstObject } #endregion return $inboxDriverMgmtIPTestResults } catch { throw $_ } } function Test-NwkValidator_MgmtIPIPPoolRequirement { <# .SYNOPSIS Run during both Deployment and AddNode 1. Mgmt NIC IP should not be overlapping with IP Pool 2. Ensure Mgmt NIC IPs and IP Pool are in the same subnet #> [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = "Specify starting Management IP Range")] [System.Collections.ArrayList] $IpPools, [Parameter(Mandatory = $false, HelpMessage = "Specify Management Subnet")] [string] $ManagementSubnetValue, [System.Management.Automation.Runspaces.PSSession[]] $PSSession ) try { [System.Management.Automation.Runspaces.PSSession[]] $allPSSessions = EnsureTestSessionOpen -PSSessions $PSSession $instanceResults = @() foreach ($ipPool in $IpPools) { $StartingAddress = $ipPool.StartingAddress $EndingAddress = $ipPool.EndingAddress foreach ($currentSession in $allPSSessions) { $sb = { $env:COMPUTERNAME ( Get-NetIPConfiguration | Where-Object { $null -ne $_.IPv4DefaultGateway -and $_.NetAdapter.Status -eq "Up" } ).IPv4Address.IPAddress } $NewNodeData = Invoke-Command $currentSession -ScriptBlock $sb $NodeName = $NewNodeData[0] # Check for all of the IPs found on the Host, note that array $NewNodeData is having IPAddress info from item with index 1 for ($i = 1; $i -lt $NewNodeData.count; $i++) { $NodeManagementIPAddress = $NewNodeData[$i] Log-Info "Node Name retrieved from session: $NodeName" Log-Info "Node Management IP Address retrieved from session: $NodeManagementIPAddress" #region Check node management IP is not in infra pool range [System.String] $mgmtIpOverlapStatus = "" Log-Info "Start testing Mgmt IP on $($currentSession.ComputerName) is not in Infra IP Pool..." $ip = [system.net.ipaddress]::Parse($NodeManagementIPAddress).GetAddressBytes() [array]::Reverse($ip) $ip = [system.BitConverter]::ToUInt32($ip, 0) $from = [system.net.ipaddress]::Parse($StartingAddress).GetAddressBytes() [array]::Reverse($from) $from = [system.BitConverter]::ToUInt32($from, 0) $to = [system.net.ipaddress]::Parse($EndingAddress).GetAddressBytes() [array]::Reverse($to) $to = [system.BitConverter]::ToUInt32($to, 0) $mgmtIPOutsideRange = ($ip -le $from) -or ($ip -ge $to) if ($mgmtIPOutsideRange) { $TestMgmtIPInfraRangeDetail = $lnTxt.TestMgmtIPInfraRangePass -f $NodeManagementIPAddress, $StartingAddress, $EndingAddress } else { $TestMgmtIPInfraRangeDetail = $lnTxt.TestMgmtIPInfraRangeFail -f $NodeManagementIPAddress, $StartingAddress, $EndingAddress Log-Info $TestMgmtIPInfraRangeDetail -Type Warning } $mgmtIpOverlapStatus = if ($mgmtIPOutsideRange) { 'SUCCESS' } else { 'FAILURE' } $params = @{ Name = 'AzStackHci_Network_Test_Validity_MgmtIp_NotIn_Infra_Pool' Title = 'Test Validity Management IP not in Infra Pool' DisplayName = "Test Validity Management IP not in Infra Pool" Severity = 'CRITICAL' Description = 'Checking management IPs are not in infra IP pool' Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = "$StartingAddress-$EndingAddress" TargetResourceName = "ManagementIPIPPoolConfiguration" TargetResourceType = 'ManagementIPIPPoolConfiguration' Timestamp = [datetime]::UtcNow Status = $mgmtIpOverlapStatus AdditionalData = @{ Source = $currentSession.ComputerName Resource = 'NodeManagementIP' Detail = $TestMgmtIPInfraRangeDetail Status = $mgmtIpOverlapStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params #endregion #region Check node management IP is within the same subnet as the IP pools [System.String] $mgmtSubnetOverlapStatus = "" Log-Info "Start testing Mgmt IP on $($currentSession.ComputerName) is within the same subnet as that of Infra IP Pool..." $TestMgmtSubnet = TestIPInSubnet -IpToCheck $NodeManagementIPAddress -ExpectedSubnetCIDR $ManagementSubnetValue $mgmtSubnetOverlapStatus = if ($TestMgmtSubnet) { 'SUCCESS' } else { 'FAILURE' } $params = @{ Name = 'AzStackHci_Network_Test_Validity_MgmtIp_In_Infra_Subnet' Title = 'Test Validity Management IP in same infra subnet as IP pools' DisplayName = "Test Validity Management IP in same infra subnet as IP pools" Severity = 'CRITICAL' Description = 'Checking management IPs are in same subnet as infra IP pool' Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = "$StartingAddress-$EndingAddress" TargetResourceName = "ManagementIPIPPoolConfiguration" TargetResourceType = 'ManagementIPIPPoolConfiguration' Timestamp = [datetime]::UtcNow Status = $mgmtSubnetOverlapStatus AdditionalData = @{ Source = "$($currentSession.ComputerName)AndCustomerNetwork" Resource = 'NodeManagementIPAndCustomerSubnet' Detail = if ($TestMgmtSubnet) { $lnTxt.TestMgmtSubnetPass -f $NodeManagementIPAddress, $EndingAddress } else { $lnTxt.TestMgmtSubnetFail -f $NodeManagementIPAddress, $EndingAddress } Status = $mgmtSubnetOverlapStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params #endregion } } } return $instanceResults } catch { throw $_ } } # Initial tests to determine if Mgmt IP of new Node is OK # Below Tests are for Static IP Allocation (Non-DHCP) function Test-NwkValidator_MgmtIPForNewNode { [CmdletBinding()] param ( [Parameter(Mandatory = $false, HelpMessage = "Specify starting Management IP Range")] [System.Collections.ArrayList] $IpPools, [System.Management.Automation.Runspaces.PSSession[]] $PSSession, [Hashtable] $NodeToManagementIPMap, [PSObject[]] $AtcHostIntents ) try { [System.Management.Automation.Runspaces.PSSession[]] $allPSSessions = EnsureTestSessionOpen -PSSessions $PSSession $instanceResults = @() $newNodeSession = $allPSSessions[0] [PSObject[]] $mgmtIntent = $AtcHostIntents | Where-Object { $_.TrafficType.Contains("Management") } $intentName = $mgmtIntent[0].Name $firstAdapterName = $mgmtIntent[0].Adapter[0] $sb = { $env:COMPUTERNAME ( Get-NetIPConfiguration | Where-Object { $null -ne $_.IPv4DefaultGateway -and $_.NetAdapter.Status -eq "Up" } ).IPv4Address.IPAddress } $NewNodeData = Invoke-Command $newNodeSession -ScriptBlock $sb $NodeName = $NewNodeData[0] $NodeManagementIPAddress = $NewNodeData[1] Log-Info "Node Name retrieved from PSSession: $NodeName" Log-Info "Node Management IP Address retrieved from PSSession: $NodeManagementIPAddress" foreach ($ipPool in $IpPools) { $StartingAddress = $ipPool.StartingAddress $EndingAddress = $ipPool.EndingAddress # Check node management IP is not in infra pool range Log-Info "Starting Test Mgmt IP is not in Infra IP Pool for $($newNodeSession.ComputerName)" $ip = [system.net.ipaddress]::Parse($NodeManagementIPAddress).GetAddressBytes() [array]::Reverse($ip) $ip = [system.BitConverter]::ToUInt32($ip, 0) $from = [system.net.ipaddress]::Parse($StartingAddress).GetAddressBytes() [array]::Reverse($from) $from = [system.BitConverter]::ToUInt32($from, 0) $to = [system.net.ipaddress]::Parse($EndingAddress).GetAddressBytes() [array]::Reverse($to) $to = [system.BitConverter]::ToUInt32($to, 0) $mgmtIPOutsideRange = ($ip -le $from) -or ($ip -ge $to) if ($mgmtIPOutsideRange) { $TestMgmtIPInfraRangeDetail = $lnTxt.TestMgmtIPInfraRangePass -f $NodeManagementIPAddress, $StartingAddress, $EndingAddress $status = 'SUCCESS' } else { $TestMgmtIPInfraRangeDetail = $lnTxt.TestMgmtIPInfraRangeFail -f $NodeManagementIPAddress, $StartingAddress, $EndingAddress Log-Info $TestMgmtIPInfraRangeDetail -Type Warning $status = 'FAILURE' } $params = @{ Name = 'AzStackHci_Network_Test_New_Node_Validity_Outside_Mgmt_Range' Title = 'Test New Node Configuration Outside Management Range' DisplayName = "Test New Node Configuration Outside Management Range" Severity = 'CRITICAL' Description = 'Checking New Node IP' Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = $NodeManagementIPAddress TargetResourceName = "IPAddress" TargetResourceType = 'IPAddress' Timestamp = [datetime]::UtcNow Status = $status AdditionalData = @{ Source = $NodeName Resource = 'NewNodeManagementIP' Detail = $TestMgmtIPInfraRangeDetail Status = $status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } # Check that no management IPs are the same (Mgmt IP shouldn't conflict with existing node) Log-Info "Starting Test for No Mgmt IPs are the same for any Nodes" $duplicateIPs = $false $numDuplicates = $NodeToManagementIPMap.GetEnumerator() | Group-Object Value | Where-Object { $_.Count -gt 1 } if ($null -ne $numDuplicates) { $duplicateIPs = $true Log-Info 'Duplicate IPs found for Node Management IPs' -Type Warning } if ($duplicateIPs) { $dtl = 'Duplicate IPs found for Node Management IPs' $status = 'FAILURE' } else { $dtl = 'No Duplicate IPs found for Node Management IPs' $status = 'SUCCESS' } $params = @{ Name = 'AzStackHci_Network_Test_New_Node_Validity_Duplicate_IP' Title = 'Test New Node Configuration Duplicate IP' DisplayName = "Test New Node Configuration Duplicate IP" Severity = 'CRITICAL' Description = 'Checking New Node IP is not a duplicate' Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = $NodeManagementIPAddress TargetResourceName = "IPAddress" TargetResourceType = 'IPAddress' Timestamp = [datetime]::UtcNow Status = $status AdditionalData = @{ Source = 'NodeAndManagementIPMapping' Resource = 'NodeManagementIPs' Detail = $dtl Status = $status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params # Check that host name exists, and the name and mgmt IP both match current node Log-Info "Starting Test to check if Mgmt IP is on a different node as $NodeName" Log-Info "Starting simultaneous Test to check if HostName and Mgmt IP Match for $NodeName" $ipOnAnotherNode = $false $NodeNameAndIPMatches = $false $nodeNameForIP = $null foreach ($NodeIP in $NodeToManagementIPMap.GetEnumerator()) { Write-Host "$($NodeIP.Name): $($NodeIP.Value)" if ($NodeIP.Name -eq $NodeName) { if ($NodeIP.Value -eq $NodeManagementIPAddress) { $NodeNameAndIPMatches = $true $nodeNameForIP = $NodeIP.Name } } else { if ($NodeIP.Value -eq $NodeManagementIPAddress) { $ipOnAnotherNode = $true $nodeNameForIP = $NodeIP.Name } } } if ($ipOnAnotherNode) { $CheckMgmtIPNotOnOtherNodeDetail = $lnTxt.CheckMgmtIPNotOnOtherNodeFail -f $NodeManagementIPAddress, $nodeNameForIP Log-Info $CheckMgmtIPNotOnOtherNodeDetail -Type Warning } else { $CheckMgmtIPNotOnOtherNodeDetail = $lnTxt.CheckMgmtIPNotOnOtherNodePass -f $NodeManagementIPAddress, $nodeNameForIP } $status = if ($ipOnAnotherNode) { 'FAILURE' } else { 'SUCCESS' } $params = @{ Name = 'AzStackHci_Network_Test_New_Node_Validity_IP_Conflict' Title = 'Test New Node Configuration Conflicting IP' DisplayName = "Test New Node Configuration Conflicting IP" Severity = 'CRITICAL' Description = 'Checking New Node IP is not on another node' Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = $NodeManagementIPAddress TargetResourceName = "IPAddress" TargetResourceType = 'IPAddress' Timestamp = [datetime]::UtcNow Status = $status AdditionalData = @{ Source = 'NodeAndManagementIPMapping' Resource = 'NodeNameAndManagementIP' Detail = $CheckMgmtIPNotOnOtherNodeDetail Status = $status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params if ($NodeNameAndIPMatches) { $CheckMgmtIPOnNewNodeDetail = $lnTxt.CheckMgmtIPOnNewNodePass -f $NodeManagementIPAddress, $nodeNameForIP $status = 'SUCCESS' } else { $CheckMgmtIPOnNewNodeDetail = $lnTxt.CheckMgmtIPOnNewNodeFail -f $NodeManagementIPAddress, $nodeNameForIP Log-Info $CheckMgmtIPOnNewNodeDetail -Type Warning $status = 'FAILURE' } $params = @{ Name = 'AzStackHci_Network_Test_New_Node_And_IP_Match' Title = 'Test New Node Configuration Name and IP Match' DisplayName = "Test New Node Configuration Name and IP Match" Severity = 'CRITICAL' Description = 'Checking New Node Name and IP match' Tags = @{} Remediation = 'https://aka.ms/hci-envch' TargetResourceID = $NodeManagementIPAddress TargetResourceName = "IPAddress" TargetResourceType = 'IPAddress' Timestamp = [datetime]::UtcNow Status = $status AdditionalData = @{ Source = 'NodeAndManagementIPMapping' Resource = 'NewNodeNameAndManagementIP' Detail = $CheckMgmtIPOnNewNodeDetail Status = $status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params # Check that New Node has the first physical adapter and the physical adapter has the mgmt IP Log-Info "Starting Test to see if $firstAdapterName on $NodeName has the correct Mgmt IP" $adapterSB = { param($adapterName) $returnDict = @{} $returnDict["GetNetIPAddressOutput"] = Get-NetIPAddress -ErrorAction SilentlyContinue $returnDict["GetNetAdapterOutput"] = Get-NetAdapter $AdapterIPObject = Get-NetIPAddress -InterfaceAlias $adapterName -AddressFamily IPv4 -ErrorAction SilentlyContinue if ($null -eq $AdapterIPObject) { $returnDict["Result"] = $false $returnDict["AdapterName"] = $adapterName return $returnDict } $returnDict["Result"] = $true $returnDict["AdapterName"] = $adapterName $returnDict["AdapterIP"] = $AdapterIPObject.IPAddress return $returnDict } $AdapterContainsMgmtIP = $false $physicalAdapterExists = $false $VirtualNICName = "vManagement($intentName)" try { $NewNodeAdapterData = Invoke-Command $newNodeSession -ScriptBlock $adapterSB -ArgumentList $firstAdapterName Log-Info "Data found for New Node Adapter ($firstAdapterName): $($NewNodeAdapterData | Out-String)" if ($NewNodeAdapterData['Result'] -eq $false) { Log-Info "Physical Adapter Not Found" Log-Info "Get-NetIPAddress output: $($NewNodeAdapterData['GetNetIPAddressOutput'] | Out-String)" Log-Info "Get-NetAdapter output: $($NewNodeAdapterData['GetNetAdapterOutput'] | Out-String)" } elseif ($NewNodeAdapterData['Result'] -eq $true -and $NewNodeAdapterData['AdapterIP'] -eq $NodeManagementIPAddress) { Log-Info "Physical Adapter found with Correct IP: $($NewNodeAdapterData['AdapterIP'] | Out-String)" $physicalAdapterExists = $true $AdapterContainsMgmtIP = $true $CheckAdapterContainsIPDetail = $lnTxt.CheckAdapterContainsIPPass -f $firstAdapterName, $NodeManagementIPAddress } else { Log-Info "Physical Adapter found but with incorrect IP" Log-Info "Get-NetIPAddress output: $($NewNodeAdapterData['GetNetIPAddressOutput'] | Out-String)" Log-Info "Get-NetAdapter output: $($NewNodeAdapterData['GetNetAdapterOutput'] | Out-String)" } # In certain cases, new node will be set up with the vNIC instead and need to check that for mgmt IP if (!$physicalAdapterExists) { Log-Info "Physical Adapter does not exist or mgmt IP is wrong. Checking Virtual Adapter" -Type Warning $NewNodeVirtualAdapterData = Invoke-Command $newNodeSession -ScriptBlock $adapterSB -ArgumentList $VirtualNICName Log-Info "Data found for New Node Virtual Adapter ($VirtualNICName): $($NewNodeVirtualAdapterData | Out-String)" if ($NewNodeVirtualAdapterData['Result'] -eq $false) { Log-Info "Virtual Adapter Not Found" Log-Info "Get-NetIPAddress output: $($NewNodeVirtualAdapterData['GetNetIPAddressOutput'] | Out-String)" Log-Info "Get-NetAdapter output: $($NewNodeVirtualAdapterData['GetNetAdapterOutput'] | Out-String)" } elseif ($NewNodeVirtualAdapterData['Result'] -eq $true -and $NewNodeVirtualAdapterData['AdapterIP'] -eq $NodeManagementIPAddress) { Log-Info "Virtual Adapter found with Correct IP: $($NewNodeVirtualAdapterData['AdapterIP'] | Out-String)" $AdapterContainsMgmtIP = $true $CheckAdapterContainsIPDetail = $lnTxt.CheckAdapterContainsIPPass -f $VirtualNICName, $NodeManagementIPAddress } else { Log-Info "Virtual Adapter found but with incorrect IP" Log-Info "Get-NetIPAddress output: $($NewNodeVirtualAdapterData['GetNetIPAddressOutput'] | Out-String)" Log-Info "Get-NetAdapter output: $($NewNodeVirtualAdapterData['GetNetAdapterOutput'] | Out-String)" } } } catch { Log-Info "Exception thrown when checking New Node Adapter: $_" -Type Warning } if (!$AdapterContainsMgmtIP) { $CheckAdapterContainsIPDetail = $lnTxt.CheckAdapterContainsIPFail -f $firstAdapterName, $VirtualNICName, $NodeManagementIPAddress Log-Info $CheckAdapterContainsIPDetail -Type Warning $status = 'FAILURE' } else { $status = 'SUCCESS' } $params = @{ Name = 'AzStackHci_Network_Test_New_Node_First_Adapter_Validity' Title = 'Test New Node Configuration First Network Adapter has Management IP' DisplayName = "Test New Node Configuration First Network Adapter has Management IP" Severity = 'CRITICAL' Description = 'Checking New Node first adapter has management IP' Tags = @{} Remediation = 'https://learn.microsoft.com/en-us/azure-stack/hci/deploy/deployment-tool-checklist' TargetResourceID = $NodeManagementIPAddress TargetResourceName = $firstAdapterName TargetResourceType = 'Network Adapter' Timestamp = [datetime]::UtcNow Status = $status AdditionalData = @{ Source = 'NewNodeAdapter' Resource = 'NewNodeAdapterIP' Detail = $CheckAdapterContainsIPDetail Status = $status TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params return $instanceResults } catch { throw $_ } } function Test-NwkValidator_ClusterNetworkIntentStatus { <# .SYNOPSIS This test is run in the AddNode/PreUpdate context only. This test validates if the intents configured on the existing cluster are in good state. .DESCRIPTION This test performs the following Validations: 1) Check the ATC Intent status on existing nodes are successfully allocated #> try { $instanceResults = @() [System.String] $mgmtIntentRstStatus = "" [PSObject[]] $mgmtIntent = @() [PSObject[]] $mgmtIntent = Get-NetIntent | Where-Object { $_.IsManagementIntentSet -eq $true } if ($mgmtIntent.Count -eq 1) { $mgmtIntentRstStatus = "SUCCESS" $mgmtIntentRstDetail = "Found one management intent $($mgmtIntent.IntentName) on the cluster." } else { $mgmtIntentRstStatus = "FAILURE" $mgmtIntentRstDetail = "There are [ $($mgmtIntent.Count) ] management intent(s) on the cluster. Expecting [ 1 ]. Please check the cluster network intent configuration." } $tmpMgmtIntentRemediationMsg = "To check cluster network intent status, run below cmdlet on your cluster:" $tmpMgmtIntentRemediationMsg += "`n Get-NetIntent" $tmpMgmtIntentRemediationMsg += "`n Make sure one and only one intent is managment intent: IsManagementIntentSet == `"True`"" $mgmtIntentExists = @{ Name = 'AzStackHci_Network_Test_Network_Cluster_MgmtIntent_Exists' Title = 'Test one management intent exists on cluster' DisplayName = 'Test one management intent exists on cluster' Severity = 'CRITICAL' Description = 'Checking if there is one and only one management intent on existing cluster' Tags = @{} Remediation = $tmpMgmtIntentRemediationMsg TargetResourceID = 'NetworkIntent' TargetResourceName = 'NetworkIntent' TargetResourceType = 'NetworkIntent' Timestamp = [datetime]::UtcNow Status = $mgmtIntentRstStatus AdditionalData = @{ Source = 'ClusterMgmtIntent' Resource = 'ClusterMgmtIntent' Detail = $mgmtIntentRstDetail Status = $mgmtIntentRstStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @mgmtIntentExists # Get the names of all nodes with an Up Status $activeNodes = (Get-ClusterNode | Where-Object {$_.State -eq "Up"}).Name Log-Info "Active nodes: $($activeNodes | Out-String)" Log-Info "Checking ATC Intent status on existing nodes." # Get all intents on the active nodes $intents = Get-NetIntentStatus | Where-Object {$activeNodes -contains $_.Host} $tmpRemediationMsg = "To check cluster network intent status, run below cmdlet on your cluster:" $tmpRemediationMsg += "`n Get-NetIntentStatus" $tmpRemediationMsg += "`n ConfigurationStatus should be `"Success`"" $tmpRemediationMsg += "`n ProvisioningStatus should be `"Completed`":" # Checks the intent status on the existing nodes. foreach ($intent in $intents) { $intentHealthy = $true if ($intent.ConfigurationStatus -ne "Success" -or $intent.ProvisioningStatus -ne "Completed") { $intentHealthy = $false $TestNetworkIntentStatusDetail = $lnTxt.TestNetworkIntentStatusFail -f $intent.IntentName, $intent.Host, $intent.ConfigurationStatus, $intent.ProvisioningStatus Log-Info $TestNetworkIntentStatusDetail -Type Warning } else { $intentHealthy = $true $TestNetworkIntentStatusDetail = $lnTxt.TestNetworkIntentStatusPass -f $intent.IntentName, $intent.Host, $intent.ConfigurationStatus, $intent.ProvisioningStatus Log-Info $TestNetworkIntentStatusDetail -Type Success } $params = @{ Name = 'AzStackHci_Network_Test_Network_Cluster_Intent_Status' Title = 'Test Network intent on existing cluster nodes' DisplayName = 'Test Network intent on existing cluster nodes' Severity = 'CRITICAL' Description = 'Checking if network intent is healthy on existing nodes' Tags = @{} Remediation = $tmpRemediationMsg TargetResourceID = 'NetworkIntent' TargetResourceName = 'NetworkIntent' TargetResourceType = 'NetworkIntent' Timestamp = [datetime]::UtcNow Status = if ($intentHealthy) { 'SUCCESS' } else { 'FAILURE' } AdditionalData = @{ Source = $intent.Host Resource = $intent.IntentName Detail = $TestNetworkIntentStatusDetail Status = if ($intentHealthy) { 'SUCCESS' } else { 'FAILURE' } TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params } return $instanceResults } catch { throw $_ } } function Test-NwkValidator_StorageIntentExistance { <# .SYNOPSIS This test is run in the AddNode context only. This test validates if there is a storage intent configured on the cluster .DESCRIPTION This test performs the following Validation: 1) Check if the existing cluster have storage intent configured in them. If not, fail the test. We require the storage intent for 2+ node cluster, thus user must make sure storage intent is there #> try { $instanceResults = @() # Get the names of all nodes with an Up Status $activeNodes = (Get-ClusterNode | Where-Object {$_.State -eq "Up"}).Name Log-Info "Active nodes: $($activeNodes | Out-String)" # Get all intents on the active nodes $intents = Get-NetIntentStatus | Where-Object {$activeNodes -contains $_.Host} Log-Info "Checking if the storage intent is configured on the existing cluster before add node." $tmpRemediationMsg = "Storage intent is required for 2+ nodes Azure Local cluster." $tmpRemediationMsg += "`nPlease run below PowerShell cmdlet to add storage intent into the cluster:" $tmpRemediationMsg += "`n Add-NetIntent" $tmpRemediationMsg += "`nCheck https://learn.microsoft.com/en-us/azure/azure-local/ for more information!" $storageIntent = $intents | Where-Object {$_.IsStorageIntentSet -eq $true} try { $source = Get-Cluster } catch { $source = $Env:COMPUTERNAME Log-Info "Error getting the cluster, we could be running this test in standalone mode on $($source)" } if ($null -eq $storageIntent) { $TestNetworkIntentStatusDetail = $lnTxt.TestStorageIntentNotConfigured -f $source Log-Info $TestNetworkIntentStatusDetail -Type Warning } else { $TestNetworkIntentStatusDetail = $lnTxt.TestStorageIntentConfigured -f $source Log-Info $TestNetworkIntentStatusDetail -Type Success } $params = @{ Name = 'AzStackHci_Network_Test_Network_Cluster_StorageIntentExistance' Title = 'Test Storage intent existance' DisplayName = 'Test Storage intent should exists on current cluster' Severity = 'CRITICAL' Description = 'Check if the storage intent is configured on the existing cluster' Tags = @{} Remediation = $tmpRemediationMsg TargetResourceID = 'StorageIntent' TargetResourceName = 'StorageIntent' TargetResourceType = 'StorageIntent' Timestamp = [datetime]::UtcNow Status = if ($null -eq $storageIntent) { 'FAILURE' } else { 'SUCCESS' } AdditionalData = @{ Source = $source Resource = 'AddNodeStorageIntentCheck' Detail = $TestNetworkIntentStatusDetail Status = if ($null -eq $storageIntent) { 'FAILURE' } else { 'SUCCESS' } TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params return $instanceResults } catch { throw $_ } } function Test-NwkValidator_NetworkATCFeatureStatusOnNewNode { <# .SYNOPSIS This test is run in the AddNode context only. This test validates if the NetworkATC services in good state on the new nodes to be added. .DESCRIPTION This test performs the following Validations: 1) Check if NetworkATC service is running on the new node .PARAMETERS [System.Management.Automation.Runspaces.PSSession[]] $PSSession #> [CmdletBinding()] param ( [System.Management.Automation.Runspaces.PSSession[]] $PSSession ) try { [System.Management.Automation.Runspaces.PSSession[]] $allPSSessions = EnsureTestSessionOpen -PSSessions $PSSession $sessionToCheck = $allPSSessions[0] Log-Info "Checking NetworkATC feature/service status on the new nodes." $instanceResults = @() # Check if NetworkATC service is running on the new node $sb = { $retVal = New-Object psobject -Property @{ Pass = $true Status = [string]::Empty } $atcFeature = Get-WindowsFeature -Name NetworkATC if ($atcFeature.Installstate -eq "Installed") { $atcService = Get-Service NetworkATC -ErrorAction SilentlyContinue $retVal.Status = "Feature Installed Service $($atcService.Status)" } elseif ($atcFeature.Installstate -eq "Available") { $retVal.Status = "Feature Available" } else { $retVal.Pass = $false } return $retVal } $NetworkATCStatus = Invoke-Command $sessionToCheck -ScriptBlock $sb $ATCStatusHealthy = $true if (!$NetworkATCStatus.Pass) { # NetworkATC feature not Installed, not Available on the system $ATCStatusHealthy = $false $TestNetworkATCServiceDetail = $lnTxt.TestNetworkATCFeatureNotInSystem -f $sessionToCheck.ComputerName Log-Info $TestNetworkATCServiceDetail -Type Warning } elseif (-not (($NetworkATCStatus.Status -eq 'Feature Installed Service Running') -or ($NetworkATCStatus.Status -eq 'Feature Available'))) { # NetworkATC feature installed but service not 'Running', or feature not available $ATCStatusHealthy = $false $TestNetworkATCServiceDetail = $lnTxt.TestNetworkATCFeatureServiceStatus -f $NetworkATCStatus.Status, $sessionToCheck.ComputerName Log-Info $TestNetworkATCServiceDetail -Type Warning } else { $ATCStatusHealthy = $true $TestNetworkATCServiceDetail = $lnTxt.TestNetworkATCFeatureServiceStatus -f $NetworkATCStatus.Status, $sessionToCheck.ComputerName Log-Info $TestNetworkATCServiceDetail -Type Success } $params = @{ Name = 'AzStackHci_Network_Test_Network_AddNode_NetworkATC_Service' Title = 'Test NetworkATC service is running on new node' DisplayName = 'Test NetworkATC service is running on new node' Severity = 'CRITICAL' Description = 'Check NetworkATC service is running on new node' Tags = @{} Remediation = 'https://learn.microsoft.com/en-us/azure-stack/hci/deploy/deployment-tool-checklist' TargetResourceID = 'NetworkATCService' TargetResourceName = 'NetworkATCService' TargetResourceType = 'NetworkATCService' Timestamp = [datetime]::UtcNow Status = if ($ATCStatusHealthy) { 'SUCCESS' } else { 'FAILURE' } AdditionalData = @{ Source = $sessionToCheck.ComputerName Resource = 'AddNodeNewNodeNetworkATCServiceCheck' Detail = $TestNetworkATCServiceDetail Status = if ($ATCStatusHealthy) { 'SUCCESS' } else { 'FAILURE' } TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params return $instanceResults } catch { throw $_ } } function Test-NwkValidator_NetworkIntentRequirement { <# .SYNOPSIS This test is run in the Deployment context only. This test validates that at least one storage-only intent must be defined for Rack Aware Cluster. .DESCRIPTION This test performs the following Validations: 1) For a Rack Aware cluster, at least one storage-only intent is present. .PARAMETER ClusterPattern The pattern of the cluster. It can be 'Standard', 'Stretch', or 'RackAware'. .PARAMETER AtcHostIntents The ATC host intents to be applied during deployment. #> [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [ValidateSet('Standard','Stretch','RackAware')] [String] $ClusterPattern, [Parameter(Mandatory = $true)] [PSObject[]] $AtcHostIntents ) try { $networkIntentRequirementResults = @() # For the AtcHostIntents object array, we only need to check the storage only intents [PSObject[]] $storageIntents = $AtcHostIntents | Where-Object { $_.TrafficType.Contains("Storage") -and (-not $_.TrafficType.contains("Management")) -and (-not $_.TrafficType.contains("Compute")) } $networkIntentRequirementRstObject = @{ Name = 'AzStackHci_Network_Test_NetworkIntentRequirement' Title = 'Test host network intent requirements for Rack Aware cluster' DisplayName = 'Test host network intent requirements for Rack Aware cluster' Severity = 'CRITICAL' Description = 'Test that only one storage-only intent is present for Rack Aware cluster' Tags = @{} Remediation = "" TargetResourceID = "NetworkIntentRequirement" TargetResourceName = "NetworkIntentRequirement" TargetResourceType = "NetworkIntentRequirement" Timestamp = [datetime]::UtcNow Status = 'SUCCESS' AdditionalData = @{ Source = $Env:COMPUTERNAME Resource = 'NetworkIntentRequirement' Detail = 'Only one storage-only intent is present for Rack Aware cluster as expected.' Status = 'SUCCESS' TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } if ('RackAware' -eq $ClusterPattern) { if (($null -eq $storageIntents) -or ($storageIntents.Count -eq 0)) { Log-Info 'No storage-only intent is present for Rack Aware cluster. Test is failed.' -Type Warning $networkIntentRequirementRstObject.Status = 'FAILURE' $networkIntentRequirementRstObject.AdditionalData.Detail = 'No storage-only intent is present for Rack Aware cluster.' $networkIntentRequirementRstObject.AdditionalData.Status = 'FAILURE' } elseif ($storageIntents.Count -gt 1) { Log-Info 'More than 1 storage-only intents are present for Rack Aware cluster. Test is failed.' -Type Warning $networkIntentRequirementRstObject.Status = 'FAILURE' $networkIntentRequirementRstObject.AdditionalData.Detail = 'More than 1 storage-only intents are present for Rack Aware cluster.' $networkIntentRequirementRstObject.AdditionalData.Status = 'FAILURE' } else { Log-Info "Only one storage-only intent is present for Rack Aware cluster as expected. Test is passed." } } else { Log-Info "Cluster pattern is not RackAware, so skip the storage intent requirement check." $networkIntentRequirementRstObject = @{ Name = 'AzStackHci_Network_Test_NetworkIntentRequirement' Title = 'Test host network intent requirements for Rack Aware cluster' DisplayName = 'Test host network intent requirements for Rack Aware cluster' Severity = 'CRITICAL' Description = 'Test that only one storage-only intent is present for Rack Aware cluster' Tags = @{} Remediation = "" TargetResourceID = "NetworkIntentRequirement" TargetResourceName = "NetworkIntentRequirement" TargetResourceType = "NetworkIntentRequirement" Timestamp = [datetime]::UtcNow Status = 'SUCCESS' AdditionalData = @{ Source = $Env:COMPUTERNAME Resource = 'NetworkIntentRequirement' Detail = 'This is not a RackAware cluster, so skip the storage intent requirement check.' Status = 'SUCCESS' TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } } $networkIntentRequirementResults += New-AzStackHciResultObject @networkIntentRequirementRstObject return $networkIntentRequirementResults } catch { throw $_ } } function Test-NwkValidator_StorageConnectivityType { <# .SYNOPSIS This test is run in the Deployment context only. This test validates that switched storage connectivity is used for Rack Aware Cluster. .DESCRIPTION This test performs the following Validations: 1) For a Rack Aware cluster, the storage must be switched instead of switchless . .PARAMETER ClusterPattern The pattern of the cluster. It can be 'Standard', 'Stretch', or 'RackAware'. .PARAMETER SwitchlessDeploy Whether switchless configuration is used for storage connectivity . #> [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [ValidateSet('Standard','Stretch','RackAware')] [String] $ClusterPattern, [Parameter(Mandatory = $false)] [System.Boolean] $SwitchlessDeploy = $false ) $storageConnectivityTypeResults = @() $storageConnectivityTypeRstObject = @{ Name = 'AzStackHci_Network_Test_StorageConnectivityType' Title = 'Test storage connectivity type for Rack Aware cluster' DisplayName = 'Test storage connectivity type for Rack Aware cluster' Severity = 'CRITICAL' Description = 'Test that switchless storage connectivity is NOT used for Rack Aware cluster.' Tags = @{} Remediation = "" TargetResourceID = "StorageConnectivityType" TargetResourceName = "StorageConnectivityType" TargetResourceType = "StorageConnectivityType" Timestamp = [datetime]::UtcNow Status = 'SUCCESS' AdditionalData = @{ Source = $Env:COMPUTERNAME Resource = 'StorageConnectivityType' Detail = 'Switchless storage connectivity is NOT used for Rack Aware cluster.' Status = 'SUCCESS' TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } if ('RackAware' -eq $ClusterPattern) { if ($SwitchlessDeploy) { Log-Info 'Switchless storage connectivity is used for Rack Aware cluster. Test is failed.' -Type Warning $storageConnectivityTypeRstObject.Status = 'FAILURE' $storageConnectivityTypeRstObject.AdditionalData.Detail = 'Switchless storage connectivity is used for Rack Aware cluster.' $storageConnectivityTypeRstObject.AdditionalData.Status = 'FAILURE' } else { Log-Info "Switchless storage connectivity is NOT used for Rack Aware cluster as expected. Test is passed." } } else { Log-Info "Cluster pattern is not RackAware, so skip the storage connectivity type check." $storageConnectivityTypeRstObject = @{ Name = 'AzStackHci_Network_Test_StorageConnectivityType' Title = 'Test storage connectivity type for Rack Aware cluster' DisplayName = 'Test storage connectivity type for Rack Aware cluster' Severity = 'CRITICAL' Description = 'Test that switchless storage connectivity is NOT used for Rack Aware cluster.' Tags = @{} Remediation = "" TargetResourceID = "StorageConnectivityType" TargetResourceName = "StorageConnectivityType" TargetResourceType = "StorageConnectivityType" Timestamp = [datetime]::UtcNow Status = 'SUCCESS' AdditionalData = @{ Source = $Env:COMPUTERNAME Resource = 'StorageConnectivityType' Detail = 'This is not a RackAware cluster, so skip the storage connectivity type check.' Status = 'SUCCESS' TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } } $storageConnectivityTypeResults += New-AzStackHciResultObject @storageConnectivityTypeRstObject return $storageConnectivityTypeResults } function Test-NwkValidator_StorageAdapterIPConfigurationPreUpdate { <# .SYNOPSIS This test is run in the Patch and Update context only to check the storage adapter IP configuration This test validates storage adapters should have only 1 IP address configured. Or if it has multiple IP addresses, they should be in the same subnet. .DESCRIPTION During patch and update, we will check the IP configuration on the storage adapters. All storage adapters should have only 1 IP address configured on eash of them. Or if an adapter has multiple IP addresses, they should be in the same subnet. #> [CmdletBinding()] param ( [Parameter(Mandatory = $false)] [System.Management.Automation.Runspaces.PSSession[]] $PSSession ) try { [System.Management.Automation.Runspaces.PSSession[]] $allNodeSessions = EnsureTestSessionOpen -PSSessions $PSSession $storageAdapterIpConfigResults = @() # Get storage adapter names from the storage intent [PSObject[]] $storageIntent = Get-NetIntent | Where-Object { $true -eq $_.IsStorageIntentSet } if ($storageIntent.Count -eq 0) { Log-Info "No storage intent found in the system. Skip the storage adapter IP configuration check." return $storageAdapterIpConfigResults } # Only 1 Storage intent allowed. So use index [0] here $storageIntentName = $storageIntent[0].IntentName [System.String[]] $storagePhysicalAdapters = $storageIntent[0].NetAdapterNamesAsList [System.String[]] $storageAdaptersToCheck = @() if (($true -eq $storageIntent.IsManagementIntentSet) -or ($true -eq $storageIntent.IsComputeIntentSet)) { foreach ($pStorageNic in $storagePhysicalAdapters) { $storageAdaptersToCheck += "vSMB($($storageIntentName)#$($pStorageNic))" } } else { $storageAdaptersToCheck = $storagePhysicalAdapters } Log-Info "Active storage intent: $($storageIntentName)" Log-Info "Storage intent adapter(s) in the system: $($storageAdaptersToCheck -join `",`")" $tmpRemediationMsg = "Storage intent adapters should have only 1 IPv4 address configured or all IPs should be in the same subnet." $tmpRemediationMsg += "`nPlease run below PowerShell cmdlet to check the IP configuration on the adapter:" $tmpRemediationMsg += "`n Get-NetIPaddress -InterfaceAlias <INTERFACEALIAS> -AddressFamily IPv4 -PrefixOrigin Manual" foreach ($testSession in $allNodeSessions) { Log-Info "Checking correct storage IP configured on storage adapter(s) on $($testSession.ComputerName)" $storageAdapterIpConfigResult = Invoke-Command -Session $testSession -ScriptBlock ${function:CheckStorageAdapterIPConfig} -ArgumentList @(, $storageAdaptersToCheck) Log-Info "Got storage adapter readiness validation results from $($testSession.ComputerName)" $storageAdapterIpConcifgValidationStatus = if ($storageAdapterIpConfigResult.Pass) { 'SUCCESS' } else { 'FAILURE' } $storageAdapterIpConfigValidationDetailMessage = $storageAdapterIpConfigResult.Message $storageAdapterIpConfigRstObject = @{ Name = 'AzStackHci_Network_Test_StorageAdapterIpConfiguration' Title = 'Test storage adapter IP configuration on node' DisplayName = 'Test storage adapter IP configuration on node' Severity = 'CRITICAL' Description = 'Test storage adapter IP configuration on node: should have only 1 IPv4 address configured or all IPs should be in the same subnet.' Tags = @{} Remediation = $tmpRemediationMsg TargetResourceID = "StorageAdapterIpConfiguration" TargetResourceName = "StorageAdapterIpConfiguration" TargetResourceType = "StorageAdapterIpConfiguration" Timestamp = [datetime]::UtcNow Status = $storageAdapterIpConcifgValidationStatus AdditionalData = @{ Source = $testSession.ComputerName Resource = $storageAdaptersToCheck -join "," Detail = $storageAdapterIpConfigValidationDetailMessage Status = $storageAdapterIpConcifgValidationStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $storageAdapterIpConfigResults += New-AzStackHciResultObject @storageAdapterIpConfigRstObject } return $storageAdapterIpConfigResults } catch { throw $_ } } function Test-MwkValidator_StorageVlanFor2NodeSwitchLessDeployment { [CmdletBinding()] param ( [PSObject] $HostNetworkInfo, [System.Int16] $NodeCount, [System.Boolean] $SwitchlessDeploy = $false ) $instanceResults = @() if ($SwitchlessDeploy -and $NodeCount -eq 2) { Log-info "2-Node switchless deployment detected. Will check VLANID for 2-node switchless deployment." } else { Log-info "Node Count: [ $($NodeCount) ]" Log-info "Switchless Deployment? [ $($SwitchlessDeploy) ]" Log-info "Not a 2-node switchless deployment. Skip the VLANID check." return $instanceResults } try { [System.String[]] $storageVlanIdList = @() [System.String] $validationRst = "" [System.String] $validationDetailInfo = "" [System.String] $validationRemediation = "" if ($HostNetworkInfo.storageNetworks -and ($HostNetworkInfo.storageNetworks.Count -gt 0)) { $storageVlanIdList = $HostNetworkInfo.storageNetworks.vlanId | Select-Object -Unique [System.Int16] $storageVlanidProvided = $storageVlanIdList.Count $validationDetailInfo = "Found [ $($storageVlanidProvided) ] storage VLANID in the configuration: $($storageVlanIdList -join ',')" if ($storageVlanidProvided -eq 2) { $validationRst = 'SUCCESS' } else { $validationRst = 'FAILURE' } $validationRemediation = "You provided [ $($storageVlanidProvided) ] stroage VLANID. Make sure you provide 2 different storage VLANID for 2-node switchless deployment." } else { $validationRst = 'FAILURE' $validationDetailInfo = "No storageNetworks section or valid storage VLANID info provided in the configuration." $validationRemediation = "Please provide valid storageNetworks and storage VLANID information in your deployment configuration file." } Log-Info $validationDetailInfo $params = @{ Name = 'AzStackHci_Network_Test_Network_StorageVlanFor2NodeSwitchLess' Title = 'Test storage VLANID requirement for 2-node switchless deployment' DisplayName = 'Test storage VLANID requirement for 2-node switchless deployment' Severity = 'CRITICAL' Description = 'Check user provided 2 different VLANID for 2-node switchless deployment' Tags = @{} Remediation = $validationRemediation TargetResourceID = 'StorageVlanIdFor2NodeSwitchLess' TargetResourceName = 'StorageVlanIdFor2NodeSwitchLess' TargetResourceType = 'StorageVlanIdFor2NodeSwitchLess' Timestamp = [datetime]::UtcNow Status = $validationRst AdditionalData = @{ Source = $env:COMPUTERNAME Resource = 'StorageVlanIdFor2NodeSwitchLess' Detail = $validationDetailInfo Status = $validationRst TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $instanceResults += New-AzStackHciResultObject @params return $instanceResults } catch { throw $_ } } ################################################################################################# # Helper Functions ################################################################################################# function TestIPInSubnet { param ( [System.Net.IPAddress]$IpToCheck, [System.String]$ExpectedSubnetCIDR ) # $ExpectedSubnetCIDR should be normalized CIDR format # Get prefix length from expected CIDR $expectedCIDRParts = $ExpectedSubnetCIDR -split '/' $prefixLength = [int]$expectedCIDRParts[1] $networkMask = [Convert]::ToUInt32(("1" * $prefixLength).PadRight(32, "0"), 2) # Trying to get the normalized CIDR for the $IpToCheck and $prefexLength # Calculate the network address $inputIpBytes = $IpToCheck.GetAddressBytes() [Array]::Reverse($inputIpBytes) $inputIpValue = [BitConverter]::ToUInt32($inputIpBytes, 0) $transformedValue = $inputIpValue -band $networkMask $networkIpBytes = [BitConverter]::GetBytes($transformedValue) [Array]::Reverse($networkIpBytes) $networkAddress = New-Object System.Net.IPAddress -ArgumentList (, $networkIpBytes) # Construct the normalized CIDR string $ipSubnetCIDR = $networkAddress.IPAddressToString + '/' + $prefixLength return ($ipSubnetCIDR -eq $ExpectedSubnetCIDR) } function TestMgmtIpPools { <# .SYNOPSIS Ensure all ip are in management subnet. #> param ( [Parameter(Mandatory = $false, HelpMessage = "Specify starting Management IP Range")] [System.Collections.ArrayList] $IpPools, [Parameter(Mandatory = $false, HelpMessage = "Specify Management Subnet")] [string] $ManagementSubnetValue ) try { $allIps = GetMgmtIpRangeFromPools -IpPools $IpPools $uniqueIPs = @{} $firstIp = $IpPools[0].StartingAddress $match = $firstIp -replace "\.[0-9]{1,3}$", "" foreach ($ip in $allIps) { $ipString = $ip.ToString() if ($uniqueIPs.ContainsKey($ipString)) { return $false } else { $uniqueIPs[$ipString] = $true } # Test to make sure all ips in the management subnet in the DHCP scenario $toMatch = $ip -replace "\.[0-9]{1,3}$", "" if ($toMatch -ne $match) { return $false } } # More reliable test to make sure all ips in the management pool in non-DHCP scenarios if (-not ([string]::IsNullOrEmpty($ManagementSubnetValue))) { foreach ($ipPool in $IpPools) { $StartingAddress = $ipPool.StartingAddress $EndingAddress = $ipPool.EndingAddress if (!(CheckIPInRange -IPAddress $StartingAddress -Range $ManagementSubnetValue)) { return $false } if (!(CheckIPInRange -IPAddress $EndingAddress -Range $ManagementSubnetValue)) { return $false } } } return $true } catch { throw "Failed to check ip pools. Error: $_" } } function CheckIPInRange { param( [Parameter(Mandatory=$true)] [string] $IPAddress, # Range in which to search using CIDR notation. (ippaddr/bits) [Parameter(Mandatory=$true)] [string] $Range ) # Split range into the address and the CIDR notation [String]$CIDRAddress = $Range.Split('/')[0] [int]$CIDRBits = $Range.Split('/')[1] # Address from range and the search address are converted to Int32 and the full mask is calculated from the CIDR notation. [int]$BaseAddress = [System.BitConverter]::ToInt32((([System.Net.IPAddress]::Parse($CIDRAddress)).GetAddressBytes()), 0) [int]$Address = [System.BitConverter]::ToInt32(([System.Net.IPAddress]::Parse($IPAddress).GetAddressBytes()), 0) [int]$Mask = [System.Net.IPAddress]::HostToNetworkOrder(-1 -shl ( 32 - $CIDRBits)) return (($BaseAddress -band $Mask) -eq ($Address -band $Mask)) } function GetMgmtIpRangeFromPools { param ( [Parameter(Mandatory = $false, HelpMessage = "Specify starting Management IP Range")] [System.Collections.ArrayList] $IpPools ) $result = @() foreach ($ipPool in $IpPools) { $result += GetMgmtIpRange -StartingAddress $ipPool.StartingAddress -EndingAddress $ipPool.EndingAddress } return $result } function GetMgmtIpRange { param ( [Parameter(Mandatory = $false, HelpMessage = "Specify starting Management IP Range")] [System.Net.IPAddress] $StartingAddress, [Parameter(Mandatory = $false, HelpMessage = "Specify end Management IP Range")] [System.Net.IPAddress] $EndingAddress ) try { $first3 = $StartingAddress -replace "\.[0-9]{1,3}$", "" $start = $StartingAddress -split "\." | Select-Object -Last 1 $end = $EndingAddress -split "\." | Select-Object -Last 1 $range = $start..$end | ForEach-Object { ([System.Net.IPAddress]("{0}.{1}" -f $first3, $PSITEM)).IPAddressToString } Log-info "Start: $start and end: $end gives range: $($range -join ',')" return $range } catch { throw "Failed to get Mgmt range. Error: $_" } } function TestMgmtRangeSize { <# .SYNOPSIS Ensure IP range is within boundaries. #> param ( [Parameter(Mandatory = $false, HelpMessage = "Specify starting Management IP Range")] [System.Collections.ArrayList] $IpPools, [int] $Minimum = 6, [int] $Maximum = 16 ) try { $totalCount = 0 foreach ($ipPool in $IpPools) { $StartingAddress = $ipPool.StartingAddress $EndingAddress = $ipPool.EndingAddress $start = $StartingAddress -split "\." | Select-Object -Last 1 $end = $EndingAddress -split "\." | Select-Object -Last 1 $hostCount = ($start..$end).count Log-info "Start: $start and end: $end gives host count: $hostcount" $totalCount += $hostCount } if ($totalCount -gt $Maximum -or $totalCount -lt $Minimum) { return $false } else { return $true } } catch { throw "Failed to check range size. Error: $_" } } function TestMgmtRangePoolCount { <# .SYNOPSIS #1, either one single pool that is big enought (>= Minimum IPs) (for both DHCP and static scenario) <== for general customers , or #2, 2 pools with 1 pool having 1 IP and 2 pool have at least (Minimum - 1 IPs) (for non-DHCP scenario only) <== for specific customers? #> param ( [Parameter(Mandatory = $false, HelpMessage = "Specify starting Management IP Range")] [System.Collections.ArrayList] $IpPools, [int] $Minimum = 5 ) try { $poolCount = $IpPools.Count if ($poolCount -gt 2) { Log-info "Found more than 2 IP pools. Test Failed" return $false } elseif ($poolCount -eq 1) { Log-info "Found only 1 IP Pool. Test Passed" return $true } else # 2 pools { $StartingAddress = $IpPools[0].StartingAddress $EndingAddress = $IpPools[0].EndingAddress $start = $StartingAddress -split "\." | Select-Object -Last 1 $end = $EndingAddress -split "\." | Select-Object -Last 1 $ipCount = ($start..$end).count Log-info "Start: $start and end: $end" if ($ipCount -ne 1) { Log-info "Found more than 1 ip in first IP pool. Test Failed" return $false } $StartingAddress = $IpPools[1].StartingAddress $EndingAddress = $IpPools[1].EndingAddress $start = $StartingAddress -split "\." | Select-Object -Last 1 $end = $EndingAddress -split "\." | Select-Object -Last 1 $ipCount = ($start..$end).count if ($ipCount -lt ($Minimum - 1)) { Log-info "Found less then enough IPs in second IP pool. Test Failed" return $false } Log-info "Test Passed" return $true } } catch { throw "Failed to check IP Pool Count. Error: $_" } } function IsTcpPortInUse { param( [System.Net.IPAddress] $Ip, [int] $Port = 5986, [int] $Timeout = 500 ) try { $tcpClient = New-Object System.Net.Sockets.TcpClient $portOpened = $tcpClient.ConnectAsync($ip, $Port).Wait($timeout) $tcpClient.Dispose() return ($portOpened -contains $true) } catch { throw "Failed to check TCP ports. Error: $_" } } function CheckNetAdapterDriverInfo { param ([System.String[]] $AdaptersToCheck) $retVal = New-Object psobject -Property @{ Pass = $true DriverInfo = "" Message = "on $($ENV:COMPUTERNAME)" } [System.Boolean] $validAdapterDriverConfig = $true [System.String] $expectedAdapterDriverInfo = "" foreach ($adapter in $AdaptersToCheck) { [System.String] $currentAdapterDriverInfo = Get-NetAdapter -Name $adapter | Select-Object -ExpandProperty DriverInformation if ([System.String]::IsNullOrEmpty($expectedAdapterDriverInfo)) { $expectedAdapterDriverInfo = $currentAdapterDriverInfo $retVal.Message += "`n Correct configuration for adapter $($adapter): DriverInfo - [ $currentAdapterDriverInfo ]" } else { if ($currentAdapterDriverInfo -ne $expectedAdapterDriverInfo) { $validAdapterDriverConfig = $false $retVal.Message += "`n Wrong configuration for adapter $($adapter): DriverInfo - [ $(currentAdapterDriverInfo) ], Expected - [ $($expectedAdapterDriverInfo) ]" } else { $retVal.DriverInfo = $expectedAdapterDriverInfo $retVal.Message += "`n Correct configuration for adapter $($adapter): DriverInfo - [ $currentAdapterDriverInfo ]" } } } if (-not $validAdapterDriverConfig) { $retVal.Pass = $false $retVal.Message = "`nERROR: Intent adapter(s) driver info are invalid " + $retVal.Message } else { $retVal.Pass = $true $retVal.Message = "`nPASS: Intent adapter(s) driver info are valid " + $retVal.Message } return $retVal } function CheckNetAdapterRDMAStatus { param ( [PSObject[]] $IntentsInfoFromJson ) $retVal = New-Object psobject -Property @{ Pass = $true Message = "on $($ENV:COMPUTERNAME)" } enum NetworkDirectEnabledState { Disabled = 0; Enabled = 1 } # Read RDMA state info for all adapters [PSObject[]] $allAdapterRdmaInfo = Get-NetAdapterRdma [System.Boolean] $validSystemRdmaConfig = $true # need to check each adapter for all intents foreach ($currentIntent in $IntentsInfoFromJson) { [System.String[]] $adaptersToCheck = $currentIntent.Adapter [PSObject[]] $rdmaInfoForAdaptersToCheck = $allAdapterRdmaInfo | Where-Object { $_.Name -in $adaptersToCheck } [Boolean] $currentIntentAdapterOverride = $currentIntent.OverrideAdapterProperty [System.Int32] $currentIntentNetworkDirectOverride = 0 if (-Not [System.String]::IsNullOrEmpty($currentIntent.AdapterPropertyOverrides.NetworkDirect)) { $currentIntentNetworkDirectOverride = [System.Int32] [NetworkDirectEnabledState] $currentIntent.AdapterPropertyOverrides.NetworkDirect } $retVal.Message += "`n Intent $($currentIntent.Name) Adapter Override - [ $currentIntentAdapterOverride ]; NetworkDirect - [ $currentIntentNetworkDirectOverride ]" if ($rdmaInfoForAdaptersToCheck.Count -ne $adaptersToCheck.Count) { # End user provided adapter(s) that don't have RDMA support (a.k.a, Get-NetAdapterRdma returns nothing for the adapter) # So the intent adapter override should have NetworkDirect Disabled. Otherwise the configuration will fail the ATC configuration if (($currentIntentAdapterOverride -and $currentIntentNetworkDirectOverride -eq 0) -or ($rdmaInfoForAdaptersToCheck.Count -eq 0)) { $retVal.Message += "`n Correct configuration for adapters $($adaptersToCheck | Out-String): RDMA not supported, and configured with intent adapter override to disable NetworkDirect" $retVal.Message += "`n Or Get-NetAdapterRdma call returned nothing for the adapter(s) $($adaptersToCheck | Out-String)" } else { $retVal.Message += "`n Wrong configuration for adapters $($adaptersToCheck | Out-String): RDMA not supported, but not configured with intent adapter override to disable NetworkDirect" $validSystemRdmaConfig = $false } } else { foreach ($currentRdmaInfo in $rdmaInfoForAdaptersToCheck) { # The following conditions are valid for RDMA configuration: # RDMA Enabled | RDMA OperationalStatus | Override | OverrideValue # True | True | - | - # - | False | True | 0 $rdmaEnabled = $currentRdmaInfo.Enabled $rdmaOperationalState = $currentRdmaInfo.OperationalState $validRdmaForCurrentAdapter = ($rdmaEnabled -and $rdmaOperationalState) -or ((-not $rdmaOperationalState) -and $currentIntentAdapterOverride -and $currentIntentNetworkDirectOverride -eq 0) if (-not $validRdmaForCurrentAdapter) { $retVal.Message += "`n Wrong configuration for adapter $($currentRdmaInfo.Name): RDMA Enabled - [ $rdmaEnabled ]; RDMA OperationalState - [ $rdmaOperationalState ]" } else { $retVal.Message += "`n Correct configuration for adapter $($currentRdmaInfo.Name): RDMA Enabled - [ $rdmaEnabled ], RDMA OperationalState - [ $rdmaOperationalState ]" } $validSystemRdmaConfig = $validSystemRdmaConfig -and $validRdmaForCurrentAdapter } } } if (-not $validSystemRdmaConfig) { $retVal.Pass = $false $retVal.Message = "`nERROR: RDMA setting on adapters are invalid " + $retVal.Message } else { $retVal.Pass = $true $retVal.Message = "`nPASS: RDMA setting on adapters are valid " + $retVal.Message } return $retVal } function CheckAdapterSymmetryAndBandwidth { param ( [PSObject[]] $IntentsInfoFromJson, [System.Int64] $ExpectedBandWidth = 10000000000 ) enum NetworkDirectEnabledState { Disabled = 0; Enabled = 1 } $nodeName = $env:COMPUTERNAME $retVal = New-Object psobject -Property @{ Pass = $true Message = "on $($nodeName)`n" } [PSObject[]] $allAdapterInfo = Get-NetAdapter foreach ($currentIntent in $IntentsInfoFromJson) { [System.String[]] $adaptersToCheck = $currentIntent.Adapter $intentAdapterInfoToCheck = $allAdapterInfo | Where-Object { $_.Name -in $adaptersToCheck } # Check adapter symmetry $retVal.Message += "`n--- Adapter Symmetry Check: Link speed and Component ID should be same for all adapters in the intent" $compIDFail = $false $linkSpeedFail = $false $expectedSpeed = $null $expectedComponentID = $null foreach ($nicInfo in $intentAdapterInfoToCheck) { if ($null -eq $expectedSpeed) { $expectedSpeed = $nicInfo.Speed } if ($null -eq $expectedComponentID) { $expectedComponentID = $nicInfo.ComponentID } if ($expectedSpeed -ne $nicInfo.Speed) { $linkSpeedFail = $true } if ($expectedComponentID -ne $nicInfo.ComponentID) { $compIDFail = $true } if ($linkSpeedFail -Or $compIDFail) { $retVal.Pass = $false } $retVal.Message += "`n -- $nodeName ($($nicInfo.Name),`t$($nicInfo.LinkSpeed),`t$($nicInfo.ComponentID))" } # Check adapter bandwidth # This is needed if current intent is for storage traffic and adapter property is not overridden with NetworkDirect Disabled [Boolean] $currentIntentAdapterOverride = $currentIntent.OverrideAdapterProperty [System.Int32] $currentIntentNetworkDirectOverride = 0 if (-Not [System.String]::IsNullOrEmpty($currentIntent.AdapterPropertyOverrides.NetworkDirect)) { $currentIntentNetworkDirectOverride = [System.Int32] [NetworkDirectEnabledState] $currentIntent.AdapterPropertyOverrides.NetworkDirect } $needCheckBandwidth = $currentIntent.TrafficType.Contains("Storage") -and (-not $currentIntentAdapterOverride -or $currentIntentNetworkDirectOverride -ne 0) if ($needCheckBandwidth) { $retVal.Message += "`n--- Adapter Bandwidth Check for storage adapters when RDMA enabled: Need to be 10Gbps or higher" foreach ($nicInfo in $intentAdapterInfoToCheck) { if ($nicInfo.Speed) { if ([System.Int64] $nicInfo.Speed -lt $ExpectedBandWidth) { $retVal.Pass = $false } $retVal.Message += "`n -- $nodeName ($($nicInfo.Name),`t$($nicInfo.LinkSpeed))" } else { $retVal.Pass = $false $retVal.Message += "`n -- $nodeName ($($nicInfo.Name), Speed not available)" } } } } if ($retVal.Pass) { $retVal.Message = "`nPASS: Network adapter(s) are symmetric and meet bandwidth requirement " + $retVal.Message } else { $retVal.Message = "`nERROR: Network adapter(s) are not symmetric or do not meet bandwidth requirement " + $retVal.Message } return $retVal } function CheckHostNetworkConfigurationReadiness { param ( [PSObject[]] $IntentsInfoFromJson ) $retVal = New-Object psobject -Property @{ Pass = $true Message = "On $($ENV:COMPUTERNAME):" } [System.String[]] $intentAdapters = $IntentsInfoFromJson | ForEach-Object { $_.Adapter } | Select-Object -Unique [PSObject[]] $extSwitchInfo = @() if ((Get-Command Get-VMSwitch -ErrorAction SilentlyContinue) -and (Get-WindowsFeature -Name Hyper-V -ErrorAction SilentlyContinue).Installed) { $extSwitchInfo = Get-VMSwitch -SwitchType External } [System.String] $interimPassMessage = "" #region Check DNS client configuration [PSObject[]] $adapterDnsClientInfo = Get-DNSClient [System.String[]] $adpaterWithDNSClientInfo = $adapterDnsClientInfo.InterfaceAlias | Select-Object -Unique [System.String[]] $adaptersToCheck = @() if ($extSwitchInfo.Count -eq 0) { # In case there is no VMSwitch in the system, we will need to make sure all adapters used in intents are in the result of Get-DNSClient $adaptersToCheck = $intentAdapters } else { # if there is a VMSwitch, we will need to make sure that those adapters not in VMSwitch but in intent are in the result of Get-DNSClient [System.Guid[]] $switchAdapterGuids = $extSwitchInfo | ForEach-Object { $_.NetAdapterInterfaceGuid } [System.String[]] $adaptersNotInVMSwitchNames = Get-NetAdapter -Physical | Where-Object { $_.InterfaceGuid -notin $switchAdapterGuids } | ForEach-Object { $_.Name } $adaptersToCheck = $intentAdapters | Where-Object { $_ -in $adaptersNotInVMSwitchNames } } if ($adaptersToCheck.Count -eq 0) { #This means all the adapters defined in intent are used in VMSwitch $intentAdapterMissingDnsClient = $null } else { $intentAdapterMissingDnsClient = Compare-Object $adaptersToCheck $adpaterWithDNSClientInfo | Where-Object { $_.SideIndicator -eq "<=" } | ForEach-Object { $_.InputObject } } if ($intentAdapterMissingDnsClient.Count -gt 0) { $retVal.Pass = $false $retVal.Message += "`nERROR: DNS Client configuration is missing for the following adapter(s): $($intentAdapterMissingDnsClient -join ', ')" } else { $interimPassMessage += "`nPASS: DNS Client configuration has valid data for all adapters defined in intent" } #endregion #region Check Hyper-V running status by calling Get-VMHost if ((Get-Command Get-VMHost -ErrorAction SilentlyContinue) -and (Get-WindowsFeature -Name Hyper-V -ErrorAction SilentlyContinue).Installed) { [PSObject[]] $vmHostInfo = Get-VMHost -ErrorAction SilentlyContinue if ($vmHostInfo.Count -eq 0) { $retVal.Pass = $false $retVal.Message += "`nERROR: Hyper-V is not running correctly on the system" } else { $interimPassMessage += "`nPASS: Hyper-V is running correctly on the system" } } else { $interimPassMessage += "`nWARNING: Hyper-V-PowerShell might not installed correctly on the system. Will skip VM host check." } #endregion #region Check VMSwitch readiness if ($extSwitchInfo.Count -ge 1) { # Should not have any VMSwitch defined in the system but do not have any VMNetworkAdapter attached to it # For each VMSwitch found, we should have at least 1 VM Network adatper attached to it. Otherwise, it will fail the Test-Cluster later. foreach ($currentSwitchInfo in $extSwitchInfo) { [System.String] $currentSwitchName = $currentSwitchInfo.Name [System.String[]] $currentSwitchAdapterNames = Get-VMNetworkAdapter -All -ErrorAction SilentlyContinue | Where-Object { $_.SwitchName -eq $currentSwitchName } | ForEach-Object { $_.Name } if ($currentSwitchAdapterNames.Count -eq 0) { $retVal.Pass = $false $retVal.Message += "`nERROR: External VMSwitch $($currentSwitchName) is not having any VMNetworkAdapter attached to it." $retVal.Message += "`nERROR: Please remove the VMSwich, or add at least one VMNetworkAdapter to it." } else { $interimPassMessage += "`nPASS: External VMSwitch $($currentSwitchName) have $($currentSwitchAdapterNames.Count) VMNetworkAdapter(s) attached to it" } } # At leas 1 VMSwitch is having the network adapter defined in the management intent # Or management intent adapters are not included in any VMSwitch [System.String[]] $mgmtIntentAdapterNames = $IntentsInfoFromJson | Where-Object { $_.TrafficType.Contains("Management") } | ForEach-Object { $_.Adapter } | Select-Object -Unique [System.Boolean] $foundMgmtVMSwitch = $false foreach ($currentSwitchInfo in $extSwitchInfo) { [System.Guid[]] $currentSwitchAdapterGuids = $currentSwitchInfo | ForEach-Object { $_.NetAdapterInterfaceGuid } [System.String[]] $currentSwitchAdapterNames = Get-NetAdapter -Physical | Where-Object { $_.InterfaceGuid -in $currentSwitchAdapterGuids } | ForEach-Object { $_.Name } $tempRst = Compare-Object $mgmtIntentAdapterNames $currentSwitchAdapterNames | Where-Object { $_.SideIndicator -eq "<=" } | ForEach-Object { $_.InputObject } if ($tempRst.Count -eq 0) { $foundMgmtVMSwitch = $true break } } if ($foundMgmtVMSwitch) { $interimPassMessage += "`nPASS: At least 1 VMSwitch is having the network adapter defined in the management intent" } else { $retVal.Pass = $false $retVal.Message += "`nERROR: No VMSwitch is having the network adapter defined in the management intent" } } #endregion #Region Check advanced property VlanId on adapters foreach ($pNIC in $intentAdapters) { $currentAdapterAdvancedPropertyVlanId = Get-NetAdapterAdvancedProperty -Name $pNIC -RegistryKeyword VlanId -ErrorAction SilentlyContinue if (($null -eq $currentAdapterAdvancedPropertyVlanId) -or ($null -eq $currentAdapterAdvancedPropertyVlanId.RegistryValue)) { $retVal.Pass = $false $retVal.Message += "`nERROR: Cannot find valid advanced property VlanId for adapter $pNIC. Use Get-NetAdapterAdvancedProperty/Set-NetAdapterAdvancedProperty with parameter RegistryKeyword set to VlanId to verify and configure it." } } if ($retVal.Pass) { $interimPassMessage += "`nPASS: Advanced property VlanId exist for all adapters defined in intent" } #endregion #region Check RSS property on adapters foreach ($pNIC in $intentAdapters) { [PSOBject[]] $currentAdapterRSSSetting = Get-NetAdapterRss -Name $pNIC -ErrorAction SilentlyContinue if (($null -eq $currentAdapterRSSSetting) -or ($currentAdapterRSSSetting.Count -eq 0)) { $retVal.Pass = $false $retVal.Message += "`nERROR: Cannot find valid RSS property for adapter $pNIC. Adapter need support RSS. Use Get-NetAdapterRss to verify it." } } if ($retVal.Pass) { $interimPassMessage += "`nPASS: RSS property exists for all adapters defined in intent" } #endregion #region Check pNIC are in the intent adapters [System.String[]] $allpNicUpInSystem = Get-NetAdapter -Physical -Name $intentAdapters -ErrorAction SilentlyContinue | Where-Object { $_.Status -eq "Up" } | ForEach-Object { $_.Name } $adapterCompareResult = Compare-Object $intentAdapters $allpNicUpInSystem | Where-Object { $_.SideIndicator -eq "<=" } | ForEach-Object { $_.InputObject } if ($adapterCompareResult.Count -gt 0) { $retVal.Pass = $false $retVal.Message += "`nERROR: The following adapter(s) are not physical adapter or not Up in the system: $($adapterCompareResult -join ', '). Intent adapters should be physical adapters and Up in the system." } else { $interimPassMessage += "`nPASS: All adapters defined in intent are physical NICs and Up in the system" } #endregion #region Check intent adapter should not be used by other intent in the system [PSObject[]] $allIntentsOnCurrentMachine = @() try { $allIntentsOnCurrentMachine = Get-NetIntent } catch { # Catch here in case NetworkATC service is not installed in the system, in which case should be OK for initial deployment scenario } if ($allIntentsOnCurrentMachine.Count -gt 0) { # For each intent to be checked: # If intent with same name already defined in the system, we need to make sure that the adapters used are the same # If intent with same name not defined in the system, we need to make sure that the adapters used are not used by any other intent in the system [System.String[]] $existingIntentAdapterNames = $allIntentsOnCurrentMachine | ForEach-Object { $_.NetAdapterNamesAsList } | Select-Object -Unique foreach ($intentToCheck in $IntentsInfoFromJson) { [PSObject[]] $existingIntentWithSameName = @() # Try to get intent with same name $existingIntentWithSameName = $allIntentsOnCurrentMachine | Where-Object { $_.IntentName -eq $intentToCheck.Name } if ($existingIntentWithSameName.Count -gt 0) { # if we have intent with same name, then the adapters we used should have same infomation if (Compare-Object -ReferenceObject $intentToCheck.Adapter -DifferenceObject $existingIntentWithSameName.NetAdapterNamesAsList -ErrorAction SilentlyContinue) { # The compare returns something, menas the adapters are different between the intent passed in and the existing intent on the system: same name, but different adapters. $retVal.Pass = $false $retVal.Message += "`nERROR: Intent $($intentToCheck.Name) is already defined in the system with different adapter(s)." $retVal.Message += "`n Please use different intent name or remove the existing intent first." } else { $interimPassMessage += "`nPASS: Intent $($intentToCheck.Name) is already defined in the system with same adapter(s)" } } else { # if we don't have intent with same name, then the adapters for current $intentToCheck should not be used by any existing intent $adapterCompareResult = Compare-Object -ReferenceObject $intentToCheck.Adapter -DifferenceObject $existingIntentAdapterNames -IncludeEqual | Where-Object { $_.SideIndicator -eq "==" } if ($adapterCompareResult.Count -gt 0) { $retVal.Pass = $false $retVal.Message += "`nERROR: The following adapter(s) are already used by other intent in the system: $($adapterCompareResult.InputObject -join ', ')." $retVal.Message += "`n Intent adapters should not be used by other intent in the system." } else { $interimPassMessage += "`nPASS: Intent $($intentToCheck.Name) adapter(s) are not used by any other intent in the system" } } } } else { $interimPassMessage += "`n--- No intent found in the system. Skip intent adapter check." } #endregion $retVal.Message += $interimPassMessage return $retVal } function ConfigureVMSwitchForTesting { [CmdletBinding()] param ( [System.String[]] $SwitchAdapterNames, [System.String] $MgmtIntentName = "", [System.Boolean] $UpdateMgmtAdapter = $true, [System.String] $ExpectedVMSwitchName = "ConvergedSwitch($($MgmtIntentName))", [System.String] $ExpectedMgmtVNicName = "vManagement($($MgmtIntentName))" ) [PSObject] $retVal = New-Object PSObject -Property @{ VMSwitchInfo = $null MgmtVlanId = 0 NeedCleanUp = $false IPReady = $false } # Make sure VMMS service is running [System.Boolean] $vmmsRunning = $false $vmmsStopWatch = [System.diagnostics.stopwatch]::StartNew() while (-not $vmmsRunning -and ($vmmsStopWatch.Elapsed.TotalSeconds -lt 60)) { $vmmsRunning = (Get-Service -Name vmms -ErrorAction SilentlyContinue).Status -eq "Running" if ($vmmsRunning) { break } else { Start-Service -Name vmms Start-Sleep -Seconds 5 } } $tmpVMSwitch = New-VMSwitch -Name $ExpectedVMSwitchName -NetAdapterName $SwitchAdapterNames -EnableEmbeddedTeaming $true -AllowManagementOS $UpdateMgmtAdapter if ($tmpVMSwitch) { $retVal.VMSwitchInfo = $tmpVMSwitch $retVal.MgmtVlanId = 0 $retVal.NeedCleanUp = $true if ($UpdateMgmtAdapter) { $mgmtVlanId = 0 $existingPNICVlanId = Get-NetAdapterAdvancedProperty -RegistryKeyword VlanID -Name $SwitchAdapterNames[0] -ErrorAction SilentlyContinue if ($existingPNICVlanId -and $existingPNICVlanId.RegistryValue) { $mgmtVlanId = $existingPNICVlanId.RegistryValue[0] } Rename-VMNetworkAdapter -ManagementOS -Name $ExpectedVMSwitchName -NewName $ExpectedMgmtVNicName Get-NetAdapter -name "vEthernet ($($ExpectedMgmtVNicName))" -ErrorAction SilentlyContinue | Rename-NetAdapter -NewName $ExpectedMgmtVNicName if ($mgmtVlanId -ne 0) { $retVal.MgmtVlanId = $mgmtVlanId Set-VMNetworkAdapterIsolation -ManagementOS ` -VMNetworkAdapterName $ExpectedMgmtVNicName ` -IsolationMode Vlan ` -AllowUntaggedTraffic $true ` -DefaultIsolationID $mgmtVlanId } # In case of DHCP scenario, the new adapter might not get the IP address immediately # Wait for some time (60 seconds) to make sure the new IP is settled correctly. [System.Boolean] $currentIPReady = $false $ipStopWatch = [System.diagnostics.stopwatch]::StartNew() while (-not $currentIPReady -and ($ipStopWatch.Elapsed.TotalSeconds -lt 60)) { # If the vNIC has Manual or Dhcp IPv4 address with "Preferred" state, we consider it as "ready" $ipConfig = Get-NetIPAddress -InterfaceAlias $ExpectedMgmtVNicName -ErrorAction SilentlyContinue | Where-Object { ($_.PrefixOrigin -eq "Manual" -or $_.PrefixOrigin -eq "Dhcp") -and $_.AddressFamily -eq "IPv4" -and $_.AddressState -eq "Preferred" } if ($ipConfig) { $currentIPReady = $true $retVal.IPReady = $true break } else { Start-Sleep -Seconds 3 } } if (-not $currentIPReady) { # should not get into here, but keep it here for safety Write-Host "Cannot get the IP address bind to the vNIC after VMSwitch created. Please check the system manually." } else { Write-Host "VMSwitch created successfully. VMSwitch: $($ExpectedVMSwitchName), MgmtVNic: $($ExpectedMgmtVNicName)" } } } return $retVal } function New-PsSessionWithRetriesInternal { param ( [System.String] $Node, [PSCredential] $Credential, [System.Int16] $Retries = 60, [System.Int16] $WaitSeconds = 10 ) for ($i=1; $i -le $Retries; $i++) { try { Trace-Execution "Creating PsSession ($i/$Retries) to $Node as $($Credential.UserName)..." $psSessionCreated = Microsoft.PowerShell.Core\New-PSSession -ComputerName $Node -Credential $Credential -ErrorAction Stop $computerNameFromSession = Microsoft.PowerShell.Core\Invoke-Command -Session $psSessionCreated -ScriptBlock { $ENV:COMPUTERNAME } -ErrorAction Stop $isAdminSession = Microsoft.PowerShell.Core\Invoke-Command -Session $psSessionCreated -ScriptBlock { ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] 'Administrator') } -ErrorAction Stop if (-not $isAdminSession) { throw ("PsSession was successful but user: {0} is not an administrator on computer {1} " -f $psSessionCreated.Runspace.ConnectionInfo.Credential.Username, $computerName) } break } catch { Trace-Execution "Creating PsSession ($i/$Retries) to $Node failed: $($_.exception.message)" $errMsg = $_.tostring() Start-Sleep -Seconds $WaitSeconds } } if ($psSessionCreated -and $computerNameFromSession -and $isAdminSession) { Trace-Execution ("PsSession to {0} created after {1} retries. (Remote machine name: {2})" -f $Node, ("$i/$retries"), $computerNameFromSession) return $psSessionCreated } else { throw "Unable to create a valid session to $Node`: $errMsg" } } function GetSortedMgmtIntentAdapter { param ( [System.String[]] $MgmtAdapterNames ) Log-Info "Make sure 1st mgmt intent adapter is the one with valid IP address in it" Log-Info "$($MgmtAdapterNames -join ",")" # Re-arrange the order in $MgmtAdapterNames to make sure the nic having a valid IPv4 address appears before the other NIC in the array $mgmtNicNamesTemp = [System.Collections.ArrayList] $MgmtAdapterNames foreach($name in $MgmtAdapterNames) { $a = Get-NetIPAddress -InterfaceAlias $name -AddressFamily ipv4 -Type Unicast -AddressState Preferred -PrefixOrigin Dhcp -ErrorAction SilentlyContinue $b = Get-NetIPAddress -InterfaceAlias $name -AddressFamily ipv4 -Type Unicast -AddressState Preferred -PrefixOrigin Manual -ErrorAction SilentlyContinue if (($null -ne $a) -or ($null -ne $b)) { # move the NIC name to the top $mgmtNicNamesTemp.Remove($name) $mgmtNicNamesTemp.Insert(0, $name) break } } [System.String[]] $retVal = [System.String[]] $mgmtNicNamesTemp Log-Info "Got sorted adapters list:" Log-Info "$($retVal -join ",")" return $retVal } function CheckStorageAdapterReadiness { param ([String[]] $AdaptersToCheck) $retVal = New-Object PSObject -Property @{ Pass = $true Message = "Storage adapter IP and VLAN check on $($ENV:COMPUTERNAME)" } foreach ($expectedAdapter in $AdaptersToCheck) { [PSObject[]] $currentAdapterInfo = Get-NetAdapter -Physical -Name $expectedAdapter -ErrorAction SilentlyContinue if ($currentAdapterInfo.Count -ne 1) { $retVal.Pass = $false $retVal.Message += "`n !! Expect [ 1 ] adapter with name [ $expectedAdapter ]. But found [ $($currentAdapterInfo.Count) ]." $retVal.Message += "`n !! Get-NetAdapter -Physical -Name $($expectedAdapter)" } else { [PSObject[]] $currentAdapterIPAddressInfo = Get-NetIPAddress -AddressFamily IPv4 -InterfaceIndex $currentAdapterInfo.InterfaceIndex -PrefixOrigin @("Dhcp", "Manual") -ErrorAction SilentlyContinue if ($currentAdapterIPAddressInfo.Count -ne 0) { $retVal.Pass = $false $retVal.Message += "`n !! Found valid Dhcp/Manual IP address(es) [ $($currentAdapterIPAddressInfo.IPAddress) ] on storage adapter [ $expectedAdapter ]. Please remove the IP from the adapter and disable DHCP on it." $retVal.Message += "`n !! Set-NetIPInterface -InterfaceIndex $($currentAdapterInfo.InterfaceIndex) -Dhcp Disabled" $retVal.Message += "`n !! Remove-NetIPAddress -InterfaceIndex $($currentAdapterInfo.InterfaceIndex)" } else { $retVal.Message += "`n Passed: Storage adapter [ $expectedAdapter ] don't have any IP address on it." } [String[]] $currentAdapterVlanInfo = (Get-NetAdapterAdvancedProperty -Name $expectedAdapter -RegistryKeyword VLANID -ErrorAction SilentlyContinue).RegistryValue if (-not $currentAdapterVlanInfo) { $retVal.Pass = $false $retVal.Message += "`n !! Cannot get info of advanced property `"VLANID`" from adapter [ $expectedAdapter ]. Please make sure the adapter support VLANID." $retVal.Message += "`n !! Get-NetAdapterAdvancedProperty -Name $($expectedAdapter)" } else { if (($currentAdapterVlanInfo.Count -gt 1) -or ($currentAdapterVlanInfo[0] -ne "0")) { $retVal.Pass = $false $retVal.Message += "`n !! Found VLANID [ $($currentAdapterVlanInfo) ] on [ $expectedAdapter ]. Please remove the VLANID from the adapter" $retVal.Message += "`n !! Set-NetAdapterAdvancedProperty -Name $($expectedAdapter) -RegistryKeyword VLANID -RegistryValue 0" } else { $retVal.Message += "`n Passed: Storage adapter [ $expectedAdapter ] don't have any VLANID configured on it." } } } } return $retVal } function CheckStorageAdapterIPConfig { param ([String[]] $StorageAdaptersToCheck) $retVal = New-Object PSObject -Property @{ Pass = $true Message = "Storage adapter IP configuration check on $($ENV:COMPUTERNAME)" } foreach ($expectedAdapter in $StorageAdaptersToCheck) { [PSObject[]] $currentAdapterIPAddressInfo = Get-NetIPaddress -InterfaceAlias $expectedAdapter -AddressFamily IPv4 -PrefixOrigin Manual -ErrorAction SilentlyContinue if ($currentAdapterIPAddressInfo.Count -eq 1) { $retVal.Message += "`n Passed: Storage adapter [ $expectedAdapter ] have one and only one valid IPv4 defined on it." } elseif ($currentAdapterIPAddressInfo.Count -eq 0) { $retVal.Pass = $false $retVal.Message += "`n !! Expect one valid IPv4 address configured on storage adapter [ $($expectedAdapter) ]." $retVal.Message += "`n !! Please run below command to confirm:" $retVal.Message += "`n !! Get-NetIPaddress -InterfaceAlias $($expectedAdapter) -AddressFamily IPv4 -PrefixOrigin Manual" } else { # Multiple IP address found on the adapter, we need to make sure that all the IP are in same subnet [System.String] $expectedIpSubnet = "" foreach ($currentIp in $currentAdapterIPAddressInfo) { [System.String] $currentCidr = EnvValidatorNormalizeIPv4Subnet -cidrSubnet "$($currentIp.IPAddress)/$($currentIp.PrefixLength)" if ([System.String]::IsNullOrEmpty($expectedIpSubnet)) { $expectedIpSubnet = $currentCidr } else { if ($expectedIpSubnet -ne $currentCidr) { $retVal.Pass = $false $retVal.Message += "`n !! Expect all IP address on storage adapter [ $($expectedAdapter) ] to be in same subnet." $retVal.Message += "`n !! But found [ $($currentCidr) ] and [ $expectedIpSubnet ]." $retVal.Message += "`n !! Get-NetIPaddress -InterfaceAlias $($expectedAdapter) -AddressFamily IPv4 -PrefixOrigin Manual" } else { $retVal.Message += "`n Passed: Storage adapter [ $expectedAdapter ] have multiple valid IPv4 address(es) [ $($currentIp.IPAddress) ] configured on it. All in same subnet [ $($currentCidr) ]." } } } } } return $retVal } function ConfigureStorageVMSwitchVNICForTesting { [CmdletBinding()] param ( [System.String] $StorageVMSwitchAdapter, [System.String] $StorageVMSwitchName, [System.String[]] $StorageVNICNames, [System.Collections.Hashtable] $StorageAdapterVLANIDInfo, [System.Boolean] $IncludeMgmt = $false ) $tmpRst = ConfigureVMSwitchForTesting -SwitchAdapterNames @($StorageVMSwitchAdapter) -UpdateMgmtAdapter $IncludeMgmt -ExpectedVMSwitchName $StorageVMSwitchName CreateStorageVNIC -StorageVMSwitchName $tmpRst.VMSwitchInfo.Name ` -StorageVNICNames $StorageVNICNames ` -StorageAdapterVLANIDInfo $StorageAdapterVLANIDInfo return $tmpRst } function ValidateStorageConnections { [CmdletBinding()] param ( [Parameter(Mandatory = $true, HelpMessage = "Specify PSSession array of all validation session needed for ping mesh testing.")] [System.Management.Automation.Runspaces.PSSession[]] $AllNodeSessions, [Parameter(Mandatory = $true, HelpMessage = "Specify host IPV4 table of all nodes.")] [System.Collections.Hashtable] $HostIPv4Table, [Parameter(Mandatory = $false, HelpMessage = "Specify host IPV4 table of all nodes.")] [System.Collections.Hashtable] $HostStorageAdapterLinkConnections = @{} ) $retVal = @() Log-Info "Use ping mesh to check storage adapter connections." foreach ($sourceMachineSession in $AllNodeSessions) { $validationRst = New-Object PSObject -Property @{ Pass = $true Message = "Storage adapter connection validation using ping test on $($sourceMachineSession.ComputerName)." } Log-Info "Run ping mesh on $($sourceMachineSession.ComputerName)." $nodePingRst = Invoke-Command -Session $sourceMachineSession -ScriptBlock { param ($HostAdapterIPv4Table, $HostStorageAdapterLinkConnections) $pingRst = New-Object PSObject -Property @{ Pass = $true Message = "Ping result from [ $($ENV:COMPUTERNAME) ] to other host(s):" } $sourceAdapterIPv4 = $HostAdapterIPv4Table[$ENV:COMPUTERNAME] if ($HostStorageAdapterLinkConnections.Count -eq 0) { # No storage adapter link connection defined, need to run a full ping mesh on storage adapters $sourceAdapterIPv4 = $HostAdapterIPv4Table[$ENV:COMPUTERNAME] foreach ($destHost in $HostAdapterIPv4Table.Keys) { if ($destHost -ne $env:COMPUTERNAME) { $pingRst.Message += "`n === Destination host [ $($destHost) ]" $destAdapterIPv4 = $HostAdapterIPv4Table[$destHost] foreach ($adapter in $sourceAdapterIPv4.Keys) { $pingRst.Message += "`n adapter [ $($adapter) ]" $sourceIp = $sourceAdapterIPv4[$adapter] $destIp = $destAdapterIPv4[$adapter] # Check ping result: if contains string like "Reploy from 169.254.123.12: bytes=", then it's successful $output = ping $destIp -S $sourceIp -n 2 $success = $output | Select-String "Reply from $($destIp): bytes=" -Quiet if (-not $success) { $pingRst.Pass = $false $pingRst.Message += "`n !!! FAILED: Ping from adapter [ $adapter ] with IP [ $sourceIp ] to adapter [ $adapter ] with IP [ $destIp ] on host [ $destHost ] !!!" } else { $pingRst.Message += "`n PASSED: Ping from adapter [ $adapter ] with IP [ $sourceIp ] to adapter [ $adapter ] with IP [ $destIp ] on host [ $destHost ]" } } } } } else { # Storage adapter link connections defined, need to use that data for ping test # Find all info for current node: value should be of an array: # $allHostStorageAdapterLinkConnections[$currentNode] = @() # Each item is of below format: # $link = @{ # SrcAdapter = $adapterName # DestinationInfo = @() # } # $link.DestinationInfo += @{ # DestNode = $otherEntry.PhysicalNode # DestAdapter = $otherAdapter.NetworkAdapterName # } $storageConnectionInfoForCurrentNode = $HostStorageAdapterLinkConnections[$ENV:COMPUTERNAME] foreach ($adapterLinkInfo in $storageConnectionInfoForCurrentNode) { $sourceIp = $sourceAdapterIPv4[$adapterLinkInfo.SrcAdapter] $allDestinationForCurrentAdapter = $adapterLinkInfo.DestinationInfo foreach ($destinationInfo in $allDestinationForCurrentAdapter) { $allAdapterIPv4OnDestHost = $HostAdapterIPv4Table[$destinationInfo.DestNode] $destIp = $allAdapterIPv4OnDestHost[$destinationInfo.DestAdapter] # Check ping result: if contains string like "Reploy from 169.254.123.12: bytes=", then it's successful $output = ping $destIp -S $sourceIp -n 2 $success = $output | Select-String "Reply from $($destIp): bytes=" -Quiet if (-not $success) { $pingRst.Pass = $false $pingRst.Message += "`n !!! FAILED: Ping from adapter [ $($adapterLinkInfo.SrcAdapter) ] with IP [ $sourceIp ] to adapter [ $($destinationInfo.DestAdapter) ] with IP [ $destIp ] on host [ $($destinationInfo.DestNode) ] !!!" } else { $pingRst.Message += "`n PASSED: Ping from adapter [ $($adapterLinkInfo.SrcAdapter) ] with IP [ $sourceIp ] to adapter [ $($destinationInfo.DestAdapter) ] with IP [ $destIp ] on host [ $($destinationInfo.DestNode) ]" } } } } return $pingRst } -ArgumentList $HostIPv4Table, $HostStorageAdapterLinkConnections if (-not $nodePingRst.Pass) { Log-Info " Ping test failed on $($sourceMachineSession.ComputerName)." $validationRst.Pass = $false } else { Log-Info " Ping test passed on $($sourceMachineSession.ComputerName)." } $validationRst.Message += "`n$($nodePingRst.Message)" $validationRstStatus = if ($validationRst.Pass) { 'SUCCESS' } else { 'FAILURE' } $storageAdapterConnectionRstObject = @{ Name = "AzStackHci_Network_Test_StorageConnections_PING_MESH" Title = "Test storage adapter connections with ping mesh on $($sourceMachineSession.ComputerName)" DisplayName = "Test storage adapter connections with ping mesh on $($sourceMachineSession.ComputerName)" Severity = 'CRITICAL' Description = "Run ping mesh to validate storage adapter connections from $($sourceMachineSession.ComputerName) to other servers" Tags = @{} Remediation = "Make sure network used by storage adapter is configured correctly so the adapters could be pinged each other" TargetResourceID = 'ValidateStorageConnectionsPingMesh' TargetResourceName = 'ValidateStorageConnectionsPingMesh' TargetResourceType = 'ValidateStorageConnectionsPingMesh' Timestamp = [datetime]::UtcNow Status = $validationRstStatus AdditionalData = @{ Source = $sourceMachineSession.ComputerName Resource = 'ValidateStorageConnectionsPingMesh' Detail = $validationRst.Message Status = $validationRstStatus TimeStamp = [datetime]::UtcNow } HealthCheckSource = $ENV:EnvChkrId } $retVal += New-AzStackHciResultObject @storageAdapterConnectionRstObject Log-Info " Finsihed ping test on $($sourceMachineSession.ComputerName)." } return $retVal } function CreateStorageVNIC { [CmdletBinding()] param ( [System.String] $StorageVMSwitchName, [System.String[]] $StorageVNICNames, [System.Collections.Hashtable] $StorageAdapterVLANIDInfo ) foreach ($tmpStorageVNIC in $StorageVNICNames) { Add-VMNetworkAdapter -ManagementOS -SwitchName $StorageVMSwitchName -Name $tmpStorageVNIC Get-NetAdapter -name "vEthernet ($($tmpStorageVNIC))" -ErrorAction SilentlyContinue | Rename-NetAdapter -NewName $tmpStorageVNIC Set-NetIPInterface -InterfaceAlias $tmpStorageVNIC -Dhcp Disabled Set-DnsClient -InterfaceAlias $tmpStorageVNIC -RegisterThisConnectionsAddress $false Set-VMNetworkAdapterIsolation -ManagementOS ` -VMNetworkAdapterName $tmpStorageVNIC ` -IsolationMode Vlan ` -AllowUntaggedTraffic $true ` -DefaultIsolationID $StorageAdapterVLANIDInfo[$tmpStorageVNIC] } } function EnsureTestSessionOpen { <# .SYNOPSIS Make sure the test session is opened for the given PSSessions .DESCRIPTION Make sure the test session is opened for the given PSSessions. If the session is not opened, open a new session for it. .PARAMETER PSSessions The PSSessions to be checked .EXAMPLE EnsureTestSessionOpen -PSSessions $PSSessions #> [CmdletBinding()] param ( [System.Management.Automation.Runspaces.PSSession[]] $PSSessions ) [System.Management.Automation.Runspaces.PSSession[]] $newTestSessionsAfterChecking = @() foreach ($testSession in $PSSessions) { [System.Management.Automation.Runspaces.PSSession] $sessionToReturn = $null Log-Info "[EnsureTestSessionOpen] Clean up PSSession on $($testSession.ComputerName) and create a new session" Remove-PSSession -Session $testSession -ErrorAction SilentlyContinue $sessionCredential = $testSession.Runspace.ConnectionInfo.Credential $sessionToReturn = New-PsSessionWithRetriesInternal -Node $testSession.ComputerName -Credential $sessionCredential $newTestSessionsAfterChecking += $sessionToReturn } return $newTestSessionsAfterChecking } function CheckIntentConfigurationReadiness { param ( [PSObject[]] $IntentsInfoFromJson ) enum NetworkDirectEnabledState { Disabled = 0; Enabled = 1 } enum NetworkDirectTechnologyState { iWARP = 1; RoCE = 3; RoCEv2 = 4 } $nodeName = $env:COMPUTERNAME $retVal = New-Object psobject -Property @{ Pass = $true Message = "on $($nodeName)" } [PSObject[]] $allAdapterAdvancedPropertyInfo = Get-NetAdapterAdvancedProperty [System.Boolean] $currentIntentPass = $true foreach ($currentIntent in $IntentsInfoFromJson) { $currentIntentPass = $true $retVal.Message += "`n--- Check intent $($currentIntent.Name):" # Check network direct technology is supported by the adapter if user choose to override if ($currentIntent.overrideAdapterProperty -eq $true) { [NetworkDirectEnabledState] $currentIntentNetworkDirectOverride = [NetworkDirectEnabledState]::Disabled [System.Boolean] $networkDirectConfigured = -not ([System.String]::IsNullOrEmpty($currentIntent.AdapterPropertyOverrides.NetworkDirect)) if ($networkDirectConfigured) { # Only check below if the NetworkDirect property is set. # If it is not set by end user then the value read from the input JSON could be either "" or $null try { $currentIntentNetworkDirectOverride = [NetworkDirectEnabledState] $currentIntent.AdapterPropertyOverrides.NetworkDirect } catch { $retVal.Pass = $false $currentIntentPass = $false $retVal.Message += "`n--- !!! Invalid NetworkDirect string $($currentIntent.AdapterPropertyOverrides.NetworkDirect) defined: use `"Enabled`" or `"Disabled`"" } } else { $retVal.Message += "`n--- NetworkDirect not configured" } if ($currentIntentPass) { if ($networkDirectConfigured -and ($currentIntentNetworkDirectOverride -eq [NetworkDirectEnabledState]::Enabled)) { $retVal.Message += "`n--- NetworkDirect: Enabled" try { [System.String] $intentNetworkDirectTechnology = [System.String] [NetworkDirectTechnologyState] $currentIntent.adapterPropertyOverrides.NetworkDirectTechnology } catch { $retVal.Pass = $false $currentIntentPass = $false $retVal.Message += "`n--- !!! Invalid NetworkDirectTechnology string $($currentIntent.adapterPropertyOverrides.NetworkDirectTechnology) defined while NetworkDirect enabled: use `"iWARP`", `"RoCE`" or `"RoCEv2`"" } if ($currentIntentPass) { [System.String[]] $adaptersToCheck = $currentIntent.Adapter foreach ($currentAdapter in $adaptersToCheck) { [PSObject] $adapterNetworkDirectTechnologyInfo = $allAdapterAdvancedPropertyInfo | Where-Object { $_.Name -eq $currentAdapter -and $_.RegistryKeyword -eq "*NetworkDirectTechnology" } [System.String[]] $adapterSupportedNetworkDirectTechnology = $adapterNetworkDirectTechnologyInfo.ValidDisplayValues if ($intentNetworkDirectTechnology -in $adapterSupportedNetworkDirectTechnology) { $retVal.Message += "`n--- NetworkDirect technology $($intentNetworkDirectTechnology) supported by adapter $($currentAdapter)" } else { $retVal.Pass = $false $retVal.Message += "`n--- !!! NetworkDirect technology $($intentNetworkDirectTechnology) NOT supported by adapter $($currentAdapter)" } } } } else { # Intent NetworkDirect disabled $retVal.Message += "`n--- NetworkDirect not configured or Disabled. Skip NetworkDirectTechnology checking." } } } else { # In case of no override, we just skip the checking for this intent $retVal.Message += "`n--- Adapter property override for intent $($currentIntent.Name) not configured. Skip adapter override property checking." } } if ($retVal.Pass) { $retVal.Message = "`nPASS: Network intent configuration checking " + $retVal.Message } else { $retVal.Message = "`nERROR: Network intent configuration checking " + $retVal.Message } return $retVal } function EnvValidatorNormalizeIPv4Subnet { param ( [Parameter(Mandatory=$true)][string]$cidrSubnet ) # $cidrSubnet is IPv4 subnet in CIDR format, such as 192.168.10.0/24 $subnet, $prefixLength = $cidrSubnet.Split('/') $addr = $null if (([System.Net.IPAddress]::TryParse($subnet, [ref]$addr) -ne $true) -or ($addr.AddressFamily -ne [System.Net.Sockets.AddressFamily]::InterNetwork)) { throw "$subnet is not a valid IPv4 address." } if ([System.Int16] $prefixLength -lt 0 -or [System.Int16] $prefixLength -gt 32) { throw "$prefixLength is not a valid IPv4 subnet prefix-length." } $networkAddress = Get-NetworkAddress $subnet $prefixLength return $networkAddress.ToString() + '/' + $prefixLength } # SIG # Begin signature block # MIIoRgYJKoZIhvcNAQcCoIIoNzCCKDMCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDg8UF2GyJiWtnw # lhAcgaUNCFyBMN2CbqIXc6NM9WhHy6CCDXYwggX0MIID3KADAgECAhMzAAAEBGx0 # Bv9XKydyAAAAAAQEMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjQwOTEyMjAxMTE0WhcNMjUwOTExMjAxMTE0WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQC0KDfaY50MDqsEGdlIzDHBd6CqIMRQWW9Af1LHDDTuFjfDsvna0nEuDSYJmNyz # NB10jpbg0lhvkT1AzfX2TLITSXwS8D+mBzGCWMM/wTpciWBV/pbjSazbzoKvRrNo # DV/u9omOM2Eawyo5JJJdNkM2d8qzkQ0bRuRd4HarmGunSouyb9NY7egWN5E5lUc3 # a2AROzAdHdYpObpCOdeAY2P5XqtJkk79aROpzw16wCjdSn8qMzCBzR7rvH2WVkvF # HLIxZQET1yhPb6lRmpgBQNnzidHV2Ocxjc8wNiIDzgbDkmlx54QPfw7RwQi8p1fy # 4byhBrTjv568x8NGv3gwb0RbAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQU8huhNbETDU+ZWllL4DNMPCijEU4w # RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW # MBQGA1UEBRMNMjMwMDEyKzUwMjkyMzAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci # tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG # CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0 # MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAIjmD9IpQVvfB1QehvpC # Ge7QeTQkKQ7j3bmDMjwSqFL4ri6ae9IFTdpywn5smmtSIyKYDn3/nHtaEn0X1NBj # L5oP0BjAy1sqxD+uy35B+V8wv5GrxhMDJP8l2QjLtH/UglSTIhLqyt8bUAqVfyfp # h4COMRvwwjTvChtCnUXXACuCXYHWalOoc0OU2oGN+mPJIJJxaNQc1sjBsMbGIWv3 # cmgSHkCEmrMv7yaidpePt6V+yPMik+eXw3IfZ5eNOiNgL1rZzgSJfTnvUqiaEQ0X # dG1HbkDv9fv6CTq6m4Ty3IzLiwGSXYxRIXTxT4TYs5VxHy2uFjFXWVSL0J2ARTYL # E4Oyl1wXDF1PX4bxg1yDMfKPHcE1Ijic5lx1KdK1SkaEJdto4hd++05J9Bf9TAmi # u6EK6C9Oe5vRadroJCK26uCUI4zIjL/qG7mswW+qT0CW0gnR9JHkXCWNbo8ccMk1 # sJatmRoSAifbgzaYbUz8+lv+IXy5GFuAmLnNbGjacB3IMGpa+lbFgih57/fIhamq # 5VhxgaEmn/UjWyr+cPiAFWuTVIpfsOjbEAww75wURNM1Imp9NJKye1O24EspEHmb # DmqCUcq7NqkOKIG4PVm3hDDED/WQpzJDkvu4FrIbvyTGVU01vKsg4UfcdiZ0fQ+/ # V0hf8yrtq9CkB8iIuk5bBxuPMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq # hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 # IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG # EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG # A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg # Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC # CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03 # a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr # rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg # OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy # 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9 # sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh # dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k # A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB # w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn # Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90 # lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w # ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o # ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD # VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa # BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny # bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG # AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t # L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV # HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG # AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl # AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb # C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l # hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6 # I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0 # wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560 # STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam # ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa # J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah # XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA # 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt # Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr # /Xmfwb1tbWrJUnMTDXpQzTGCGiYwghoiAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAAQEbHQG/1crJ3IAAAAABAQwDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIBLZHUcl/+r2Hk6vATjLnhbJ # 2SPTLyXg/ECoKo7Fh5TqMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAfIjN2GV4OzKTyaId88S5qfZ0j3BCvlP2DEqebtCoE/wxvL4Eu/eqWz3L # MeD3HJLfCIxmg4Zb9ogL7y9ehyHfMKjjj16pGVbA4yXAH8oXhBhUGjIpqvUFP+Mg # 4coQnnwVh95hX5E1Fr8fi3mgB3LblK60IqCm0HzQQeBO713jEEGg9hqchRBpdXl6 # JbnvQpfkr/syxsSVp+lczyN8FSafTTX++pYOEut8REdOybs00txEvZ2S+5t+AH9L # x1vKWJMU+ACI9e76wdCp0hcdcjsbUxS3UIzr1vUJCtla9DOp20jUue1CadSNgb4K # IHEL26WKvoRl8ZnBH1Nk4Nkq+YdLh6GCF7AwghesBgorBgEEAYI3AwMBMYIXnDCC # F5gGCSqGSIb3DQEHAqCCF4kwgheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsq # hkiG9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCA7ijbVP9m8FV8SenPh1j7mbv4Aid/wgnfLV55YdCup2gIGaC3l6IlT # GBMyMDI1MDYxMDE1NDgzMy40NDVaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl # bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVT # TjoyRDFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg # U2VydmljZaCCEf4wggcoMIIFEKADAgECAhMzAAAB/XP5aFrNDGHtAAEAAAH9MA0G # CSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u # MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp # b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI0 # MDcyNTE4MzExNloXDTI1MTAyMjE4MzExNlowgdMxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9w # ZXJhdGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjJEMUEt # MDVFMC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNl # MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAoWWs+D+Ou4JjYnRHRedu # 0MTFYzNJEVPnILzc02R3qbnujvhZgkhp+p/lymYLzkQyG2zpxYceTjIF7HiQWbt6 # FW3ARkBrthJUz05ZnKpcF31lpUEb8gUXiD2xIpo8YM+SD0S+hTP1TCA/we38yZ3B # EtmZtcVnaLRp/Avsqg+5KI0Kw6TDJpKwTLl0VW0/23sKikeWDSnHQeTprO0zIm/b # tagSYm3V/8zXlfxy7s/EVFdSglHGsUq8EZupUO8XbHzz7tURyiD3kOxNnw5ox1eZ # X/c/XmW4H6b4yNmZF0wTZuw37yA1PJKOySSrXrWEh+H6++Wb6+1ltMCPoMJHUtPP # 3Cn0CNcNvrPyJtDacqjnITrLzrsHdOLqjsH229Zkvndk0IqxBDZgMoY+Ef7ffFRP # 2pPkrF1F9IcBkYz8hL+QjX+u4y4Uqq4UtT7VRnsqvR/x/+QLE0pcSEh/XE1w1fcp # 6Jmq8RnHEXikycMLN/a/KYxpSP3FfFbLZuf+qIryFL0gEDytapGn1ONjVkiKpVP2 # uqVIYj4ViCjy5pLUceMeqiKgYqhpmUHCE2WssLLhdQBHdpl28+k+ZY6m4dPFnEoG # cJHuMcIZnw4cOwixojROr+Nq71cJj7Q4L0XwPvuTHQt0oH7RKMQgmsy7CVD7v55d # OhdHXdYsyO69dAdK+nWlyYcCAwEAAaOCAUkwggFFMB0GA1UdDgQWBBTpDMXA4ZW8 # +yL2+3vA6RmU7oEKpDAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBf # BgNVHR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3Bz # L2NybC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmww # bAYIKwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29m # dC5jb20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0El # MjAyMDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUF # BwMIMA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAY9hYX+T5AmCr # YGaH96TdR5T52/PNOG7ySYeopv4flnDWQLhBlravAg+pjlNv5XSXZrKGv8e4s5dJ # 5WdhfC9ywFQq4TmXnUevPXtlubZk+02BXK6/23hM0TSKs2KlhYiqzbRe8QbMfKXE # DtvMoHSZT7r+wI2IgjYQwka+3P9VXgERwu46/czz8IR/Zq+vO5523Jld6ssVuzs9 # uwIrJhfcYBj50mXWRBcMhzajLjWDgcih0DuykPcBpoTLlOL8LpXooqnr+QLYE4Bp # Uep3JySMYfPz2hfOL3g02WEfsOxp8ANbcdiqM31dm3vSheEkmjHA2zuM+Tgn4j5n # +Any7IODYQkIrNVhLdML09eu1dIPhp24lFtnWTYNaFTOfMqFa3Ab8KDKicmp0Ath # RNZVg0BPAL58+B0UcoBGKzS9jscwOTu1JmNlisOKkVUVkSJ5Fo/ctfDSPdCTVaIX # XF7l40k1cM/X2O0JdAS97T78lYjtw/PybuzX5shxBh/RqTPvCyAhIxBVKfN/hfs4 # CIoFaqWJ0r/8SB1CGsyyIcPfEgMo8ceq1w5Zo0JfnyFi6Guo+z3LPFl/exQaRubE # rsAUTfyBY5/5liyvjAgyDYnEB8vHO7c7Fg2tGd5hGgYs+AOoWx24+XcyxpUkAajD # hky9Dl+8JZTjts6BcT9sYTmOodk/SgIwggdxMIIFWaADAgECAhMzAAAAFcXna54C # m0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UE # CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z # b2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZp # Y2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMy # MjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH # EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV # BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0B # AQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51 # yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY # 6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9 # cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN # 7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDua # Rr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74 # kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2 # K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5 # TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZk # i1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9Q # BXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3Pmri # Lq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUC # BBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJl # pxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIB # FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9y # eS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUA # YgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU # 1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2Ny # bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIw # MTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDov # L3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0w # Ni0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/yp # b+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulm # ZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM # 9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECW # OKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4 # FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3Uw # xTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPX # fx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVX # VAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGC # onsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU # 5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEG # ahC0HVUzWLOhcGbyoYIDWTCCAkECAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl # bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVT # TjoyRDFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg # U2VydmljZaIjCgEBMAcGBSsOAwIaAxUAoj0WtVVQUNSKoqtrjinRAsBUdoOggYMw # gYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD # VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsF # AAIFAOvywIYwIhgPMjAyNTA2MTAxNDMyMzhaGA8yMDI1MDYxMTE0MzIzOFowdzA9 # BgorBgEEAYRZCgQBMS8wLTAKAgUA6/LAhgIBADAKAgEAAgIQcgIB/zAHAgEAAgIY # 1DAKAgUA6/QSBgIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAow # CAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUAA4IBAQCEjr5JJ+GQ # gRvPkZWlb+6sg0atBBaqlR3uwQxnuh3M9B+mtYmoWymvS9W2Bv1tHpWZ7iHeskP5 # kX2Q9fVhtvgyogipGTpxSexA4mreFRzsvEJwwbLsi33ZkGpwnSWVszyihk77g6bs # TQwXMjfaysTPFj3dUKQsTVq8e7q1oTuLvEilyjjckmzRdUNwRB+4Goeg3QV0k5e1 # jHKhcVnYPrAFljKVdgiSi2X1dYp0iHLPguEu5+1p9Dkq9fV3K7G9HVjp3yTq7+zL # 4JOj9Pp96DYxJE8JNkZGGE0qkRhfyYpSFYvurCARjeEWWKUvhhhreCM4qdNl8g9w # 4IraOuVadUMcMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB # IDIwMTACEzMAAAH9c/loWs0MYe0AAQAAAf0wDQYJYIZIAWUDBAIBBQCgggFKMBoG # CSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgy6qtfAqg # QHn8Qcqwd3M6ILHUiNgIBq1c6i/DoWFKwPswgfoGCyqGSIb3DQEJEAIvMYHqMIHn # MIHkMIG9BCCAKEgNyUowvIfx/eDfYSupHkeF1p6GFwjKBs8lRB4NRzCBmDCBgKR+ # MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS # ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT # HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB/XP5aFrNDGHtAAEA # AAH9MCIEIPrkelhbrZZ7CbIFksM8Y6wu0baxBpB0xTXoCaLUGuiBMA0GCSqGSIb3 # DQEBCwUABIICAJ8EDA1gIMAoiiS4Cc29We5uNFCNSJfeBXwpVpiemLOmxlWyF4F4 # dnMW4DHjt1rl052CIuVE0N/UvuYJ/Nep4HVOv35T5n/TtF7jyFqrxrWMoAWo+t9Z # GR02/FPs3PbA99hrQMgG1eBhWRYgC5hZnoPm1uGxCZ0avuisfEg1kjeow0iDNv5y # IKsYhqCFnpUm7szd2fpNgO2UU8HCPunazAe9JceHWpNuqqXMTeCmf6h4+ft/2xoy # kJ5HeSUhwB7okiiEe3FJ9kaKrdhofKHQGVBOmJ7xh/g50DXoA6ACbjJBHm0Jvmz5 # sJ0BEP+2kk6Bb8mk4jBh5dr3U0qNw2Ph0QSrUJTeoOblFKJLN/xWaKFVGTVug1YV # 7gdf35vXo7jaiEgyObe5fLWah23/jkDLFSaezTqFrETvjCBgO56qpFjA6KRPcgC7 # 1N68owQJnk9D2clpCP28ZzMJoK8vl1UBad7fIocmnVxoRIT9PShEDXHx4XSDE/ca # /oHGKbunbuOLET7NB6OOJknyoJ8lBIhFrWlIuyjqrgkIHG/KFgVf0z12cDGcUE79 # hjxmdK4NKyg+zblxdOM6zwYEH3UAZkhYGAl75+hzdw+JANR9vt96yIfLMvxLjgUf # Olhkt4A+sgt+JNI8cridvMZ6RQr7drC9YxarbnvB9ikJGqOIjFN3WU+c # SIG # End signature block |