Task 05: BIOS and iDRAC Settings Remediation
DOCUMENT CATEGORY: Runbook
SCOPE: Azure Local hardware provisioning
PURPOSE: Apply required BIOS and iDRAC settings to non-compliant nodes via Redfish API and confirm 100% compliance before OS installation
MASTER REFERENCE: Phase 01: Hardware Provisioning
Status: Active
Overview
BIOS changes require a system reboot (~10 minutes per node). Schedule this task during a maintenance window if nodes are accessible to end users.
Remediate non-compliant BIOS or iDRAC settings identified in Task 04 using Dell iDRAC Redfish API calls. Reads the Task 04 compliance report and Task 02 discovery inventory, applies required settings to each non-compliant node, schedules reboots where required for BIOS changes, and re-validates configuration to confirm 100% compliance.
This task does not apply if all nodes passed Task 04 validation.
Prerequisites
| Requirement | Description | Source |
|---|---|---|
| Task 02 Complete | Discovery JSON files present for all nodes | configs/network-devices/bmc/<service-tag>.json |
| Task 04 Complete | Compliance report identifying non-compliant settings | configs/network-devices/bmc/bios-compliance-report.json |
| iDRAC Access | Redfish API reachable on port 443 | infrastructure.yml: nodes[].bmc.ip_address |
| iDRAC Credentials | iDRAC admin credentials in Azure Key Vault | infrastructure.yml: key_vaults[] |
| Maintenance Window | Nodes can be rebooted (~10 min per node for BIOS changes) | Scheduled with customer |
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.
Workflow Integration
| Task | Action | Output |
|---|---|---|
| Task 02 | Collected BIOS/iDRAC configuration via Redfish API | configs/network-devices/bmc/<service-tag>.json |
| Task 04 | Validated configuration against Azure Local baseline | configs/network-devices/bmc/bios-compliance-report.json |
| Task 05 (this task) | Applies remediation via Redfish API, reboots, re-validates | Updated JSON + re-run Task 04 confirms PASS |
Execution Options
- Dell iDRAC UI
- Orchestrated Script
For each node listed as FAIL in the Task 04 compliance report, apply remediation via the iDRAC web interface.
BIOS Remediation
- Open
https://<idrac-ip>and log in with iDRAC credentials - Navigate to Configuration → BIOS Settings
- Compare against the failed settings in
configs/network-devices/bmc/bios-compliance-report.json - Apply each required setting
- Click Apply → Create a Configuration Job
- Select Reboot System → Yes
- Monitor job completion via Lifecycle Controller → Job Queue
- After reboot, re-run Task 02 to collect fresh configuration
- Re-run Task 04 validation to confirm compliance
iDRAC Remediation
- Navigate to iDRAC Settings → Services
- Apply required settings from Task 04 compliance report (no reboot required for iDRAC-only changes)
- Click Apply
- Re-run Task 02 to collect fresh iDRAC configuration
- Re-run Task 04 validation to confirm compliance
PowerShell
When to use: Run the task with the script below, from the place its help names (a management workstation, or the node itself).
Script
| Script | What it does |
|---|---|
scripts/deploy/04-cluster-deployment/phase-01-hardware-provisioning/task-05-bios-and-idrac-settings-remediation/powershell/Set-BiosIdracSettings.ps1 | Remediates non-compliant BIOS and iDRAC settings via Dell Redfish API. Supports -WhatIf. |
The BMC login comes from hardware.bmc (a node's nodes[].bmc wins) in infrastructure.yml. The password is a secret reference. -Credential overrides it. The script never prompts: without either, it stops with exit code 2.
Requires: PowerShell 7.
Run
.\Set-BiosIdracSettings.ps1 -InfrastructureFile .\infrastructure.yml -RebootAfterBios
TPM Activation (If Required)
If TPM cannot be enabled via Redfish, manual iDRAC console access is required:
- Open iDRAC Virtual Console
- Reboot the node and press F2 to enter BIOS setup
- Navigate to System Security → TPM Security
- Set TPM Status to
Enabledand TPM Activation toEnabled - Save and exit
- After reboot, re-run Task 02 and Task 04 to confirm compliance
Validation Checklist
- All non-compliant BIOS settings applied successfully
- All non-compliant iDRAC settings applied successfully
- Required reboots completed (for BIOS changes)
- Task 02 re-run to collect fresh post-remediation configuration
- Task 04 re-run shows 100% compliance (all nodes PASS)
- All nodes operational after remediation
- No Lifecycle Controller jobs pending or failed
Troubleshooting
| Issue | Cause | Resolution |
|---|---|---|
| BIOS job fails | Setting conflict or unsupported value on this platform | Check Lifecycle Controller job message for details |
| Settings not applied | BIOS job did not execute | Verify reboot occurred; check Job Queue |
| TPM not activating | Physical presence required | Use iDRAC Virtual Console for manual BIOS entry |
| Reboot not completing | Node hung during POST | Check iDRAC console; power cycle if needed |
| Config job stuck | Lifecycle Controller issue | Reset iDRAC (racadm racreset) and retry |
| Redfish Unauthorized | Incorrect credentials | Verify iDRAC credentials in Key Vault |
| Compliance report missing | Task 04 not complete | Run Task 04 before Task 05 |
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
| ← Task 04: BIOS/iDRAC Validation | ↑ Phase 01: Hardware Provisioning | Phase 02: OS Installation → |
Version Control
| Version | Date | Author | Changes |
|---|---|---|---|
| 1.0 | 2026-01-31 | Azure Local Cloud | Initial document |
| 1.1 | 2026-03-04 | Azure Local Cloud | Fix tab labels, script paths, input/output paths, Step→Task references, standards alignment |