Skip to main content

Task 03: Monitor Bootstrap Process

Runbook Phase 04 Platform

DOCUMENT CATEGORY: Runbook SCOPE: Monitor Arc registration bootstrap status and handle OEM image updates PURPOSE: Monitor Arc registration bootstrap status and handle OEM image updates MASTER REFERENCE: Azure Arc Agent Installation

Status: Active

Overview​

After Arc registration is initiated (Task 02), the bootstrap process runs in the background on each node. It first scans, downloads, and installs OEM updates (which may trigger automatic reboots), then completes Arc configuration. This task monitors all nodes through the full lifecycle until they report Succeeded.

Watch the bootstrap with Azure Local Sonar. The toolkit has no monitoring script of its own for it. On a single node you can also read the status with the commands in the Direct tab (the bootstrap status, the Arc agent, the download folder and the bootstrap log).

Reboots Are Expected

If a node reboots during registration, do not restart the registration script. The bootstrap service resumes automatically using cached SPN credentials. Sonar shows the node as unreachable until it comes back online.


Prerequisites​

RequirementDetails
Task 02 initiatedArc registration started on all target nodes
Node accessRDP or console (Direct tab), or a machine that can reach the nodes (Azure Local Sonar)
Azure sign-inConnect-AzAccount, for the Azure-side view in Sonar

Variables from infrastructure.yml​

PathTypeDescription
nodes[].network_adapters[].ip_addressstringNode management IPs for PSRemoting
azure.subscription_idstringSubscription ID for Azure queries
azure.resource_groupstringResource group for Arc machine lookups

Bootstrap Phases​

PhaseSub-PhaseDescriptionDuration
UpdateScanScans for available LCM/OEM updates1-5 min
UpdateDownloadDownloads packages to C:\bootstrap10-40 min
UpdateInstallInstalls updates, may trigger reboot5-15 min
(reboot)—Node reboots if OS update applied2-5 min
ArcConfigurationArcRegistrationRegisters node with Azure Arc5-10 min

Run on each node individually via RDP or console.

# Task 03 - Check Bootstrap Status (run on each node)

$status = Get-ArcBootstrapStatus
$status.Response | Select-Object Status, StartTime, EndTime

# Show detailed phases
if ($status.Response.DetailedResponse) {
foreach ($phase in $status.Response.DetailedResponse) {
Write-Host "$($phase.Name): $($phase.Status)"
if ($phase.DetailedResponse) {
$phase.DetailedResponse | ForEach-Object { Write-Host " $($_.Name): $($_.Status)" }
}
}
}

# Check Arc agent
Get-Service himds | Select-Object Name, Status
& "$env:ProgramFiles\AzureConnectedMachineAgent\azcmagent.exe" show

# Check download progress
if (Test-Path "C:\bootstrap") {
Get-ChildItem "C:\bootstrap" -Recurse -File |
Measure-Object -Property Length -Sum |
Select-Object Count, @{N='SizeMB'; E={[math]::Round($_.Sum / 1MB, 1)}}
}

Expected Status Values​

StatusMeaningAction
Update: ScanScanning for OEM updatesWait
Update: DownloadDownloading update packagesWait — check download progress
Update: InstallInstalling updatesWait — reboot may follow
UNREACHABLENode is rebootingWait — auto-resumes after reboot
InProgressArc registration runningWait for completion
SucceededNode registered with Azure ArcProceed to Task 04
FailedRegistration or update failedCollect logs, troubleshoot

Troubleshooting​

Collect Support Logs​

# Run on the failed node (RDP/console)
Collect-ArcBootstrapSupportLogs -OutputPath "C:\Logs\ArcBootstrap"

Check Validation Report​

# Check validation report on failed node
$reportPath = "C:\Windows\System32\Bootstrap\DiagnosticsHistory\Bootstrap\AzStackHciEnvironmentReport.json"
if (Test-Path $reportPath) {
$report = Get-Content $reportPath -Raw | ConvertFrom-Json
$report.TestResults | Where-Object { $_.Status -ne "Succeeded" } |
Select-Object Title, Status, @{N='Message';E={$_.AdditionalData.Message}}
}

Inspect Bootstrap Logs​

# Tail the latest bootstrap log on a node
$logDir = "C:\Windows\System32\Bootstrap\Logs"
$latest = Get-ChildItem $logDir -Filter *.log -ErrorAction SilentlyContinue |
Sort-Object LastWriteTime -Descending | Select-Object -First 1
if ($latest) { Get-Content $latest.FullName -Tail 30 }

Common Issues​

IssueResolution
Node unreachable 10+ minCheck iDRAC/BMC console — verify node is booting, not stuck
Download stalled (no size change)Check network connectivity (Task 01), proxy settings, DNS
Auth failed after rebootSPN token cache expired — re-run Task 02 on that node
Validation failuresReview AzStackHciEnvironmentReport.json — fix prerequisites, re-run Task 01
himds service not runningBootstrap incomplete — wait for ArcConfiguration phase
Arc agent shows Disconnected in AzureCheck node clock sync (NTP), outbound connectivity
Timeout (90+ min, no progress)Collect support logs, open Microsoft support case


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 02: Register Nodes with Arc · Task 04: Verify Arc Registration →


Version Control​

VersionDateAuthorChanges
1.0.02025-03-25Azure Local CloudInitial release