Skip to main content

Task 08: Enable ICMP (Ping)

The automated run does this task for you

The automated OS configuration run covers this task in the RemoteManagement step (ICMP echo rules). Use the manual steps below when you can't use the run, or to understand or troubleshoot what it does. See how the run works.

Runbook Azure Dell

DOCUMENT CATEGORY: Runbook
SCOPE: Firewall configuration
PURPOSE: Enable ICMP ping on all cluster nodes so that network connectivity can be tested and validated throughout the deployment process
MASTER REFERENCE: Phase 03: OS Configuration

Status: Active Estimated Time: 2 minutes per node / 5 minutes with the OS configuration (all nodes)


Overview​

Windows Server blocks ICMP by default. Enabling the ICMPv4-In and ICMPv6-In firewall rules allows ping-based connectivity validation from the management server and between nodes — required for cluster health checks, network diagnostics, and Azure Local validation tooling.

What the steps do:

  1. Enable File and Printer Sharing (Echo Request - ICMPv4-In)
  2. Enable File and Printer Sharing (Echo Request - ICMPv6-In)
  3. Verify each rule is enabled and report pass/fail

No configuration variables are required — this task has no values to read from infrastructure.yml.


Prerequisites​

RequirementDescriptionSource
Task 07 completeNTP configured on all nodesTask 07: Configure NTP
Local admin rightsRequired to modify firewall rulesNode credentials

Execution Options​

On the node console, open SConfig if not already running:

sconfig

Navigate the menu:

  1. Select 4 → Configure Remote Management
  2. Select 3 → Configure Windows Firewall to allow ICMPv4 responses (ping)
  3. Confirm the prompt — ICMP ping is now enabled
  4. Select 4 → Back to main menu
IPv6

SConfig only configures ICMPv4. If ICMPv6 is also required, enable the ICMPv6 rule by hand with Enable-NetFirewallRule, or use the Orchestrated tab.


Validation Checklist​

  • ICMPv4-In rule enabled on all nodes (Get-NetFirewallRule -DisplayName "*ICMPv4-In*")
  • ICMPv6-In rule enabled on all nodes (Get-NetFirewallRule -DisplayName "*ICMPv6-In*")
  • Nodes respond to ping from management server (Test-Connection -ComputerName <node-ip> -Count 2)

Values from infrastructure.yml​

The values for this task come from infrastructure.yml (schema 5). Every key, with its type, default and example, is in the variables reference.


Troubleshooting​

IssueRoot CauseRemediation
Rule not foundRule name differs (GPO rename or locale)Run `Get-NetFirewallRule
Rule found but still not enabledGroup Policy overriding local ruleCheck GPO firewall policy; may need to configure via GPO
OS configuration: node unreachableWinRM not enabled or firewall blockingVerify WinRM configured (Task 01); check firewall allows port 5985/5986
Ping still failing after enableLayer-3 routing or switch ACLVerify network path; check switch ACLs and VLAN routing


Alternatives​

The procedures in this task use the methods shown in the tabs above. The toolkit is PowerShell 7 only and has no Bash scripts. A few tasks that act on Azure also have an Azure CLI script written in PowerShell. The script status page of the toolkit lists which task has which script.

← Task 07: Configure NTP↑ Phase 03: OS ConfigurationTask 09: Disable Unused Adapters →

Version Control​

VersionDateAuthorChanges
1.02026-01-31Azure Local CloudInitial document
2.02026-03-04Azure Local CloudFull rewrite to standards — complete frontmatter, bare-node 2-tab structure (Direct, Orchestrated), Standalone tab removed, full embedded scripts, Get-ClusterNodes helper, no configuration variables required