From 6b1979941de33fad6439688765ec589be0ee504f Mon Sep 17 00:00:00 2001 From: anish bista Date: Fri, 22 May 2026 22:11:24 +0530 Subject: [PATCH] docs: add CD-ROM boot documentation for Redfish, IPMI, and virtual media guides [ci skip] Signed-off-by: anish bista --- docs/ipmi-guide.md | 8 ++++++++ docs/redfish-guide.md | 15 +++++++++++++++ docs/virtual-media.md | 28 ++++++++++++++++++++++++++++ 3 files changed, 51 insertions(+) diff --git a/docs/ipmi-guide.md b/docs/ipmi-guide.md index 3a556b4..e3fdcf5 100644 --- a/docs/ipmi-guide.md +++ b/docs/ipmi-guide.md @@ -107,12 +107,20 @@ ipmitool -I lan -U admin -P password -H testvm-virtbmc.default.svc.cluster.local ```bash ipmitool -I lan -U admin -P password -H testvm-virtbmc.default.svc.cluster.local chassis bootdev disk ``` + +### Set Boot to CD-ROM + +```bash +ipmitool -I lan -U admin -P password -H testvm-virtbmc.default.svc.cluster.local chassis bootdev cdrom +``` + ### Supported Boot Devices | Device | Description | |--------|-------------| | `pxe` | Network boot (PXE) | | `disk` | Boot from disk | +| `cdrom` | Boot from CD-ROM | ## Next Steps diff --git a/docs/redfish-guide.md b/docs/redfish-guide.md index ef0c4c0..498b3fa 100644 --- a/docs/redfish-guide.md +++ b/docs/redfish-guide.md @@ -243,6 +243,21 @@ curl -i -X PATCH \ }' ``` +### Set Boot to CD-ROM (One-time) + +```bash +curl -i -X PATCH \ + -H "Content-Type: application/json" \ + -H "X-Auth-Token: $TOKEN" \ + http://testvm-virtbmc.default.svc.cluster.local/redfish/v1/Systems/1 \ + -d '{ + "Boot": { + "BootSourceOverrideTarget": "Cd", + "BootSourceOverrideEnabled": "Once" + } + }' +``` + ### Set Boot Mode ```bash diff --git a/docs/virtual-media.md b/docs/virtual-media.md index 54b4fc6..1cce24a 100644 --- a/docs/virtual-media.md +++ b/docs/virtual-media.md @@ -152,6 +152,34 @@ curl -i -X POST \ }' ``` +## Booting from Virtual Media + +After inserting virtual media, a DataVolume is created and the ISO image begins downloading. Once the download is complete, configure the VM to boot from the CD-ROM and restart it: + +```bash +# Watch the DataVolume download progress +kubectl get datavolume testvm -n default -w + +# Set boot override to CD-ROM +curl -i -X PATCH \ + -H "Content-Type: application/json" \ + -H "X-Auth-Token: $TOKEN" \ + http://testvm-virtbmc.default.svc/redfish/v1/Systems/1 \ + -d '{ + "Boot": { + "BootSourceOverrideTarget": "Cd", + "BootSourceOverrideEnabled": "Once" + } + }' + +# Restart the VM to boot from CD-ROM +curl -i -X POST \ + -H "Content-Type: application/json" \ + -H "X-Auth-Token: $TOKEN" \ + http://testvm-virtbmc.default.svc/redfish/v1/Systems/1/Actions/ComputerSystem.Reset \ + -d '{"ResetType":"GracefulRestart"}' +``` + ### Request Parameters | Parameter | Type | Required | Description |