Skip to content

Commit 96dfa9f

Browse files
fix(docs): correct stale category numbers and NIC driver instructions
- README: 7→6 categories, fix NIC driver section (bundled in repo, not export-from-node), fix boot step (menu launches, not auto-run) - network-firewall.md: AD ports = Category 3 not 4 - environment-checker.md: EnvChecker = Cat-5, Arc = Cat-6 (not 6/7) - results-schema.md: example shows Cat-3-AD not Cat-4-AD - build.md: air-gap note references Category 5 not 6 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013AZySkzowyq4Ne2hrSRRAL
1 parent 5bae969 commit 96dfa9f

5 files changed

Lines changed: 13 additions & 13 deletions

File tree

README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Boot it on bare metal before you touch the deployment wizard. Know your environm
99

1010
## What it does
1111

12-
On boot, `Start-AzlValidation.ps1` runs 7 validation categories grounded in Microsoft and Dell source documents:
12+
On boot, `Start-AzlBeacon.ps1` presents an interactive menu. Choose your deployment path — it calls `Start-AzlValidation.ps1` to run the applicable categories from these 6, all grounded in Microsoft and Dell source documents:
1313

1414
| # | Category | What it checks |
1515
|---|---|---|
@@ -36,16 +36,16 @@ Results land at `X:\results\` on the WinPE RAM drive in JSON format. Copy off be
3636
| Administrator rights | DISM mount requires elevation |
3737
| Internet access | For PS7 download + `Save-Module` (skippable — see air-gap build) |
3838

39-
### NIC drivers (recommended)
39+
### NIC drivers
4040

41-
Inject 25 GbE NIC drivers so ports come up on first boot. Export from a provisioned node:
41+
Dell AX 16G NIC drivers are **bundled in the repo** at `drivers/dell-ax/` (extracted from Dell SBE bundle `5.0.2603.1641`). The build script picks them up automatically — no separate download or driver export required.
42+
43+
For non-Dell hardware, supply your own drivers:
4244

4345
```powershell
44-
Export-WindowsDriver -Online -Destination C:\drivers
46+
.\src\Build-WinPEImage.ps1 -DriverPath C:\my-drivers
4547
```
4648

47-
Or download the full driver pack for your hardware and point `-DriverPath` at the extracted folder.
48-
4949
---
5050

5151
## Quick start
@@ -88,7 +88,7 @@ Output: `src/output/azl-validate-<yyyyMMdd>.iso`
8888
2. Open **Virtual Console → Virtual Media → Connect Virtual Media**.
8989
3. Under **Map CD/DVD**, select the ISO and click **Map Device**.
9090
4. Reboot: power menu → one-time boot (F11) → **Virtual CD/DVD**.
91-
5. WinPE loads, `startnet.cmd` runs, validation starts automatically.
91+
5. WinPE loads, `startnet.cmd` runs, the Beacon menu appears.
9292

9393
To preserve results before reboot:
9494

docs/getting-started/build.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ If your build machine has limited or no internet access, pre-download the PS7 LT
2929
```
3030

3131
!!! warning "Module not included in air-gapped builds"
32-
Without `AzStackHci.EnvironmentChecker`, Category 6 (environment checker) is skipped.
32+
Without `AzStackHci.EnvironmentChecker`, Category 5 (environment checker) is skipped.
3333
Pre-stage the module at `<WorkspacePath>\mount\Tools\Modules` before the unmount step, or
3434
run the module-based tests from a staging server post-OS.
3535

docs/reference/environment-checker.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@ AzL Beacon bundles and calls the Microsoft `AzStackHci.EnvironmentChecker` Power
1212

1313
| Validator | Cmdlet | When called |
1414
|---|---|---|
15-
| Connectivity | `Invoke-AzStackHciConnectivityValidation` | Category 6, all paths |
16-
| Network | `Invoke-AzStackHciNetworkValidation` | Category 6, all paths |
17-
| Arc integration | `Invoke-AzStackHciArcIntegrationValidation` | Category 7 — optional, requires Azure sign-in |
15+
| Connectivity | `Invoke-AzStackHciConnectivityValidation` | Category 5, all paths |
16+
| Network | `Invoke-AzStackHciNetworkValidation` | Category 5, all paths |
17+
| Arc integration | `Invoke-AzStackHciArcIntegrationValidation` | Category 6 — optional, requires Azure sign-in |
1818

1919
## WinPE limitations
2020

docs/reference/results-schema.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Beacon saves results to `X:\results\validation-<timestamp>.json`.
2828
"DurationMs": 38
2929
},
3030
{
31-
"Category": "Cat-4-AD",
31+
"Category": "Cat-3-AD",
3232
"Name": "AD-LDAP-10.10.0.10",
3333
"Target": "10.10.0.10:389",
3434
"Status": "Fail",

docs/validation/network-firewall.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ Select **option 3** from the Beacon main menu to run a focused networking and fi
44

55
## What it covers
66

7-
This path runs everything except the AD port tests (Category 4). It's ideal for:
7+
This path runs everything except the AD port tests (Category 3). It's ideal for:
88

99
- Verifying firewall policy before any identity configuration
1010
- Checking endpoint reachability from the management VLAN

0 commit comments

Comments
 (0)