Task 01: Visual Hardware Inspection
DOCUMENT CATEGORY: Runbook
SCOPE: Physical infrastructure verification
PURPOSE: Verify all hardware is properly installed before network validation
MASTER REFERENCE: Dell AX Installation Guide
Status: Active Estimated Time: 30 minutes
Overview
Perform visual inspection of all physical infrastructure to verify installation matches the Low-Level Design (LLD) specifications before proceeding with network validation.
Performed by: On-site technician or remote validation via photos/video
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.
Execution Options
- On-Site Inspection
- Orchestrated Script
Walk the data center and verify each checklist item below. Take photos of:
- Overall rack layout
- Server front panels (LED status)
- Cable routing and management
- OpenGear installation
Photo storage location: artifacts/phase-02-enterprise-readiness/hardware-photos/
PowerShell
No script in this task folder. The folder holds only a placeholder. A placeholder prints
NOT IMPLEMENTED, changes nothing and exits with code 3. The earlierTest-HardwareInspection.ps1is removed. Two schema 5 scripts do the work.
Script
| Script | What it does |
|---|---|
scripts/deploy/04-cluster-deployment/phase-01-hardware-provisioning/task-02-hardware-discovery-via-dell-redfish-api/powershell/Get-HardwareInventory.ps1 | Reads the hardware of every node from its BMC over the standard Redfish API and writes one inventory file: model, serial, CPU, memory, drives, network ports with MAC addresses, GPU, TPM, BIOS, firmware and BMC version. Read only. |
scripts/deploy/04-cluster-deployment/phase-05-cluster-deployment/Invoke-AzureLocalPreClusterVerification.ps1 | The pre-cluster verification. Read only. Check ND-008 covers processors and memory; ND-011 covers Secure Boot, TPM 2.0 and the same BIOS version on all nodes. |
The BMC login comes from hardware.bmc (or nodes[].bmc) in infrastructure.yml; the password is a secret reference. No script prompts.
Run
./Get-HardwareInventory.ps1 -InfrastructureFile ./infrastructure.yml
./Invoke-AzureLocalPreClusterVerification.ps1 -InfrastructureFile ./infrastructure.yml -Mode Verify -Category nodes
Server Installation Checklist
| Check | Description | Status |
|---|---|---|
| Rack position | Servers installed in correct rack units per LLD | ☐ |
| Power connections | Dual PSU connected to redundant PDUs | ☐ |
| Power status | All servers powered on, no amber LEDs | ☐ |
| Front panel | LCD/LED status indicators normal | ☐ |
| Cable management | Cables routed through management arms | ☐ |
Network Cabling Checklist
Management Network
| Node | Port | Destination | Cable Type | Status |
|---|---|---|---|---|
| Node 1 | iDRAC | OpenGear sw0p1 | Cat6 | ☐ |
| Node 2 | iDRAC | OpenGear sw0p2 | Cat6 | ☐ |
| Node 3 | iDRAC | OpenGear sw0p3 | Cat6 | ☐ |
| Node 4 | iDRAC | OpenGear sw0p4 | Cat6 | ☐ |
Storage/Compute Network (25/100GbE)
| Node | Port 1 | Port 2 | Cable Type | Status |
|---|---|---|---|---|
| Node 1 | TOR1 Eth1/1/1 | TOR2 Eth1/1/1 | DAC/AOC | ☐ |
| Node 2 | TOR1 Eth1/1/2 | TOR2 Eth1/1/2 | DAC/AOC | ☐ |
| Node 3 | TOR1 Eth1/1/3 | TOR2 Eth1/1/3 | DAC/AOC | ☐ |
| Node 4 | TOR1 Eth1/1/4 | TOR2 Eth1/1/4 | DAC/AOC | ☐ |
VLT Peer Link (TOR1 ↔ TOR2)
| Connection | Ports | Cable Type | Status |
|---|---|---|---|
| VLTi Link 1 | Eth1/1/11 ↔ Eth1/1/11 | DAC/AOC | ☐ |
| VLTi Link 2 | Eth1/1/12 ↔ Eth1/1/12 | DAC/AOC | ☐ |
OpenGear Console Server Checklist
| Check | Description | Status |
|---|---|---|
| Rack position | OpenGear installed per LLD | ☐ |
| Power | Power LED solid green | ☐ |
| NET1 | Connected to internet-routable network | ☐ |
| NET2 | Connected to OOB management network | ☐ |
| Serial ports | Console cables connected to switches | ☐ |
| Integrated switch | iDRAC cables connected to sw0p1-sw0p4 | ☐ |
Top-of-Rack Switch Checklist
| Check | TOR1 | TOR2 | Status |
|---|---|---|---|
| Power | Dual PSU connected | Dual PSU connected | ☐ |
| Status LEDs | Normal operation | Normal operation | ☐ |
| Console cable | Connected to OpenGear | Connected to OpenGear | ☐ |
| Management port | Connected to mgmt network | Connected to mgmt network | ☐ |
| Uplinks | Connected to core/distribution | Connected to core/distribution | ☐ |
Issues Log
Document any discrepancies found during inspection:
| Issue | Location | Severity | Resolution Required |
|---|---|---|---|
Acceptance Criteria
- All checklist items verified and documented
- Photos uploaded to deployment folder:
artifacts/phase-02-enterprise-readiness/hardware-photos/ - Any discrepancies logged in Issues table
Troubleshooting
| Issue | Possible Cause | Resolution |
|---|---|---|
| Server not powering on | PDU circuit breaker tripped or power cable loose | Verify PDU status lights, reseat power cables, check circuit allocation |
| iDRAC not accessible | Incorrect IP assignment or VLAN tagging | Verify iDRAC IP matches LLD, confirm OOB VLAN is trunked to management switch |
| Missing serial port labels | Cable labels not applied during rack installation | Cross-reference OpenGear port mapping document and re-label |
| Network link LED not lit | SFP+ module not seated or wrong cable type | Reseat SFP+, verify DAC cable type matches switch port requirements |
Validation
All checks passed?
- ☐ YES - Proceed to Task 2: Network Service Verification
- ☐ NO - Document issues and coordinate with site team for resolution before proceeding
Next Steps
| Step Complete? | Next Action |
|---|---|
| ✅ Yes | Proceed to Task 2: Network Service Verification |
| ❌ No | Resolve physical infrastructure issues before continuing |
Scripts for this task are located in the azurelocal-toolkit repository under scripts/deploy/ in the appropriate task folder.
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.
Navigation
| ← Phase 02: Enterprise Readiness | ↑ Part 3: On-Premises Readiness | Task 02: Network Service Verification → |
Version Control
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0 | 2026-01-31 | Azure Local Cloud | Initial document |
| 1.1 | 2026-03-03 | Azure Local Cloud | Standardized runbook format |
End of Task