Skip to content

Commit b9d9775

Browse files
fix(docs): remove pre-fill config requirement and irrelevant static-IP note
Menu collects all values interactively at boot -- no pre-configuration needed before building. Static IP note on boot page was about future node deployment requirements, not Beacon WinPE network bootstrap. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013AZySkzowyq4Ne2hrSRRAL
1 parent 96dfa9f commit b9d9775

3 files changed

Lines changed: 16 additions & 35 deletions

File tree

README.md

Lines changed: 3 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -50,17 +50,10 @@ For non-Dell hardware, supply your own drivers:
5050

5151
## Quick start
5252

53-
### 1. Populate config
53+
!!! tip "No pre-configuration required"
54+
All environment values (DC IPs, DNS, gateway, domain FQDN) are collected interactively by the Beacon menu at boot. Just build the ISO and boot it.
5455

55-
Copy `src/config/validation-config.example.json` to `src/config/validation-config.json` and fill in your deployment values (DNS, AD domain, node IPs, gateway).
56-
57-
Regenerate the Azure endpoint list if needed:
58-
59-
```powershell
60-
.\src\Convert-EndpointsToJson.ps1
61-
```
62-
63-
### 2. Build
56+
### 1. Build
6457

6558
```powershell
6659
# Minimal — downloads PS7, no drivers

docs/getting-started/boot.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -24,15 +24,15 @@ Set the node's one-time boot order to the USB device.
2424
## What happens at boot
2525

2626
```
27-
wpeinit WinPE network stack init
28-
Start-AzlBeacon.ps1 Menu orchestrator
29-
Start-NetworkBootstrap DHCP detect / static IP prompt
30-
Main menu Choose: AD / Local Identity / Network+Firewall / Full sweep
27+
wpeinit <- WinPE network stack init
28+
Start-AzlBeacon.ps1 <- Menu orchestrator
29+
Start-NetworkBootstrap <- DHCP detect / static IP prompt
30+
Main menu <- Choose: AD / Local Identity / Network+Firewall / Full sweep
3131
```
3232

3333
## Network bootstrap
3434

35-
On boot, Beacon waits **15 seconds** for a DHCP lease. If none is detected, you are prompted for:
35+
On boot, Beacon waits **15 seconds** for a DHCP lease on the management NIC. If none is detected, you are prompted for:
3636

3737
| Prompt | Example |
3838
|---|---|
@@ -41,9 +41,7 @@ On boot, Beacon waits **15 seconds** for a DHCP lease. If none is detected, you
4141
| Default gateway | `10.10.0.1` |
4242
| Primary DNS | `10.10.0.10` |
4343

44-
!!! note "Local Identity deployments require static IPs"
45-
Microsoft requires static IP addresses for all cluster nodes in a Local Identity (AD-less) deployment.
46-
DHCP is not supported for node NICs in this mode.
44+
This gives Beacon connectivity to run the validation — it has nothing to do with how the eventual Azure Local cluster nodes will be addressed.
4745

4846
## Results
4947

docs/getting-started/prerequisites.md

Lines changed: 7 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22

33
## Build machine
44

5-
!!! note "Build once, boot anywhere"
6-
You build the ISO once on a Windows machine, then boot it on any node (or on a separate machine on the management network).
5+
!!! note "Build once, boot on any Dell AX node"
6+
You build the ISO once on a Windows machine with ADK installed, then mount it via iDRAC virtual media on each Dell AX node.
77

88
| Requirement | Details |
99
|---|---|
@@ -17,7 +17,7 @@
1717

1818
## Dell AX NIC drivers
1919

20-
NIC drivers for Dell AX 16G nodes are **bundled in the repo** under `drivers/dell-ax/` (extracted from Dell SBE bundle `5.0.2603.1641`). No separate download required.
20+
NIC drivers for Dell AX 16G nodes are **bundled in the repo** under `drivers/dell-ax/` (extracted from Dell SBE bundle `5.0.2603.1641`). No separate download required — the build script picks them up automatically.
2121

2222
| Driver | File | Version |
2323
|---|---|---|
@@ -29,20 +29,10 @@ NIC drivers for Dell AX 16G nodes are **bundled in the repo** under `drivers/del
2929

3030
## Network requirements
3131

32-
The Beacon image needs to reach Azure endpoints to run the full endpoint sweep. Ensure:
32+
The Beacon image needs outbound access to Azure endpoints to run the endpoint sweep. Ensure the management VLAN where Beacon will boot has:
3333

34-
- Management VLAN access from the machine where Beacon boots
3534
- Outbound HTTPS (443) to Azure endpoints (see [Endpoint List](../reference/endpoints.md))
36-
- DNS resolution (UDP/TCP 53) — can be tested interactively if DNS is in question
35+
- DNS resolution (UDP/TCP 53)
3736

38-
## Validation config
39-
40-
Copy `src/config/validation-config.example.json` to `src/config/validation-config.json` before building and fill in your environment's values (DC IPs, gateway, DNS, node IPs, etc.).
41-
42-
```powershell title="Create your validation config"
43-
Copy-Item src\config\validation-config.example.json src\config\validation-config.json
44-
# Edit src\config\validation-config.json with your values
45-
```
46-
47-
!!! warning
48-
`validation-config.json` is gitignored. Never commit it — it contains environment-specific IPs.
37+
!!! tip "No pre-configuration required"
38+
All environment values (DC IPs, DNS servers, gateway, domain FQDN) are collected interactively by the Beacon menu at boot. Nothing needs to be filled in before building the ISO.

0 commit comments

Comments
 (0)