configure http-ipxe boot interface

Author: syedhaseebahmed

docs/operator-guide/openstack-ironic-change-boot-interface.md

@@ -0,0 +1,135 @@
+# Runbook: Configure Dell Node Boot Interface (HTTP/iPXE)
+
+**Goal:** Ensure Dell baremetal nodes are configured to boot with `http-ipxe` (with PXE fallback enabled).
+**Applies To:** Dell nodes managed via OpenStack Ironic.
+
+## TL;DR
+
+```bash
+openstack baremetal node manage <NODE>
+openstack baremetal node clean --clean-steps dell-boot-config.yaml <NODE>
+openstack baremetal node set --boot-interface http-ipxe <NODE>
+openstack baremetal node provide <NODE>
+```
+
+---
+
+## Step 1: Put node into manageable state
+
+```bash
+openstack baremetal node manage <NODE>
+```
+
+---
+
+## Step 2: Apply BIOS configuration
+
+Save `dell-boot-config.yaml`:
+
+```yaml
+---
+- interface: bios
+  step: apply_configuration
+  args:
+    settings:
+      - name: PxeDev1EnDis
+        value: Enabled
+      - name: PxeDev1Interface
+        value: NIC.Slot.1-1
+      - name: HttpDev1EnDis
+        value: Enabled
+      - name: HttpDev1Interface
+        value: NIC.Slot.1-1
+      - name: HttpDev1TlsMode
+        value: None
+      - name: TimeZone
+        value: UTC
+  order: 1
+```
+
+Run cleaning with the runbook:
+
+```bash
+openstack baremetal node clean \
+  --clean-steps dell-boot-config.yaml \
+  <NODE>
+```
+
+---
+
+## Step 3: Monitor Cleaning Progress
+
+```bash
+openstack baremetal node show <NODE> -f value -c provision_state
+```
+
+Check the provision state until it returns to `manageable`:
+
+Expected transitions:
+
+- `cleaning`
+- `clean wait`
+- `manageable`
+
+---
+
+- If provision_state is `clean failed`: check the error
+
+  ```bash
+  openstack baremetal node show <NODE> -f value -c last_error
+  ```
+
+---
+
+## Step 4: Switch node to HTTP iPXE boot
+
+```bash
+openstack baremetal node set --boot-interface http-ipxe <NODE>
+```
+
+---
+
+## Step 5: Provide the node (make it available)
+
+```bash
+openstack baremetal node provide <NODE>
+```
+
+---
+
+### (Optional) We can also use runbooks for Cleaning & Servicing
+
+For detailed information, refer to the official OpenStack Ironic runbooks documentation:
+[OpenStack Ironic Runbooks](https://docs.openstack.org/ironic/latest/admin/runbooks.html/)
+
+To run these commands [baremetal Standalone Command-Line Interface (CLI)](https://docs.openstack.org/python-ironicclient/latest/cli/standalone.html) is required
+
+### Check for Existing Runbooks
+
+Before creating a new runbook, verify if it already exists:
+
+```bash
+baremetal runbook list
+```
+
+### Create a New Runbook
+
+```bash
+baremetal runbook create \
+    --name CUSTOM_PXE_INTERFACE_CONFIG \
+    --steps scripts/runbooks/bios_pxe_interface_config.yaml
+```
+
+[scripts/runbooks/bios_pxe_interface_config.yaml](https://raw.githubusercontent.com/rackerlabs/understack/refs/heads/main/scripts/runbooks/bios_pxe_interface_config.yaml)
+
+### Using a Runbook
+
+```bash
+# Using a runbook name
+baremetal node clean --runbook CUSTOM_PXE_INTERFACE_CONFIG node-0
+
+# Or using a runbook UUID
+baremetal node clean --runbook 8aba8375-a08b-4e89-9bae-291a8aa100b0 node-0
+```
+
+---

docs/operator-guide/openstack-ironic-inspection-guide.md

@@ -32,7 +32,7 @@ This command tells Ironic to boot the node into the inspection environment and g
 
 ### Argo Workflow Integration
 
-Our Argo [enroll-server](https://workflows.dev.undercloud.rackspace.net/workflow-templates/argo-events/enroll-server) workflow already runs Redfish inspection.
+Our Argo [enroll-server](https://github.com/rackerlabs/understack/blob/05b7fb1a8ab9efd3b2f6544b5c62874ed39a3de5/workflows/argo-events/workflowtemplates/enroll-server.yaml#L41) workflow already runs Redfish inspection.
 Therefore, just running `openstack baremetal node inventory save` is enough to retrieve the inspection data.
 
 ---

mkdocs.yml

@@ -150,6 +150,7 @@ nav:
     - 'OpenStack':
       - operator-guide/openstack-ironic.md
       - operator-guide/openstack-ironic-inspection-guide.md
+      - operator-guide/openstack-ironic-change-boot-interface.md
       - operator-guide/openstack-neutron.md
       - operator-guide/openstack-placement.md
     - 'Networking':

scripts/runbooks/README.md

@@ -1,19 +1,26 @@
 ---
+# Runbook Name: Dell Boot Interface Reconfiguration
+# Purpose: Ensure Dell baremetal nodes boot via HTTP (http-ipxe) with fallback PXE enabled.
 
 - interface: bios
   step: apply_configuration
   args:
     settings:
+      # Enable PXE boot on NIC 1-1
       - name: PxeDev1EnDis
         value: Enabled
       - name: PxeDev1Interface
         value: NIC.Slot.1-1
+
+      # Enable HTTP boot on NIC 1-1
       - name: HttpDev1EnDis
         value: Enabled
       - name: HttpDev1Interface
         value: NIC.Slot.1-1
       - name: HttpDev1TlsMode
         value: None
+
+      # Set timezone to UTC
       - name: TimeZone
         value: UTC
   order: 1