baremetal node inspect steps

Author: syedhaseebahmed

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

@@ -0,0 +1,103 @@
+# Ironic Redfish Inspection Guide
+
+This guide explains how to set a Baremetal node in OpenStack Ironic to use the Redfish inspection interface, run inspection, and view the gathered inspection data.
+
+---
+
+## 1. Set the Node to Use Redfish Inspect
+
+First, update the node to use the `redfish` (or vendor-specific, e.g., `idrac-redfish`) inspect interface:
+
+```bash
+openstack baremetal node set <NODE_UUID_OR_NAME> --inspect-interface idrac-redfish
+```
+
+Note: By default, all our nodes have the following inspection interface:
+
+```json
+"inspect_interface": "idrac-redfish"
+```
+
+---
+
+## 2. Run Inspection
+
+Trigger inspection on the node:
+
+```bash
+openstack baremetal node inspect <NODE_UUID_OR_NAME> --wait
+```
+
+This command tells Ironic to boot the node into the inspection environment and gather hardware details via Redfish.
+
+### Argo Workflow Integration
+
+Our Argo [enroll-server](https://workflows.dev.undercloud.rackspace.net/workflow-templates/argo-events/enroll-server) workflow already runs Redfish inspection.
+Therefore, just running `openstack baremetal node inventory save` is enough to retrieve the inspection data.
+
+---
+
+## 3. Show Inspection Data
+
+After inspection completes, you can view the data Ironic collected.
+
+```bash
+openstack baremetal node inventory save <NODE_UUID_OR_NAME> --file inspection-data.json
+```
+
+Sample inventory data:
+
+```json
+{
+    "inventory": {
+        "memory": {
+            "physical_mb": 98304
+        },
+        "cpu": {
+            "count": 32,
+            "model_name": "AMD EPYC 9124 16-Core Processor",
+            "frequency": 4400,
+            "architecture": "x86_64"
+        },
+        "disks": [
+            {
+                "name": "Solid State Disk 0:1:0",
+                "size": 479559942144
+            },
+            {
+                "name": "Solid State Disk 0:1:1",
+                "size": 479559942144
+            }
+        ],
+        "interfaces": [
+            {
+                "mac_address": "D4:CB:E1:BF:8E:21"
+            },
+            {
+                "mac_address": "D4:CB:E1:BF:8E:20"
+            }
+        ],
+        "system_vendor": {
+            "product_name": "System",
+            "serial_number": "MXVX4003C100KL",
+            "manufacturer": "Dell Inc."
+        },
+        "boot": {
+            "current_boot_mode": "uefi"
+        }
+    },
+    "plugin_data": {}
+}
+```
+
+This will save the inspection data (hardware details, NICs, storage, CPU, etc.) to a JSON file.
+
+You can also query directly:
+
+```bash
+openstack baremetal node show <NODE_UUID_OR_NAME> -f json
+```
+
+Look under fields like `properties`, `extra`, and `driver_internal_info` for inspection results.
+
+---

mkdocs.yml

@@ -149,6 +149,7 @@ nav:
     - operator-guide/index.md
     - 'OpenStack':
       - operator-guide/openstack-ironic.md
+      - operator-guide/openstack-ironic-inspection-guide.md
       - operator-guide/openstack-neutron.md
       - operator-guide/openstack-placement.md
     - 'Networking':