Add a note to make sure bootable OS installer ISO is used

[emunn13]

Relates to SSE-185.
Relates to https://github.com/oxidecomputer/docs/issues/759.

[sudomateo]

Thanks for working on this! I left some non-blocking comments and suggestions to, hopefully, make the wording more concise without losing the meaning. Let me know what you think!

[sudomateo]

Looking great! Just some nitpick suggestions and a question.

[qdzlug]

Jumping in via email here - couldn’t we just check to see if the image is bootable? That should probably be enough. On Jan 19, 2026, at 17:34, Matthew Sanabria ***@***.***> wrote: @sudomateo commented on this pull request. In README.adoc:

+

+To validate your Windows ISO, check the `VolumeId` using `7z`: + +```bash +# Correct! +$ 7z l windows.iso | grep VolumeId + VolumeId: UDF Volume + LogicalVolumeId: SSS_X64FREE_EN-US_DV9 + +# Incorrect. +$ 7z l win-server-2022.iso | grep VolumeId + VolumeId: UDF Volume + LogicalVolumeId: SERVER_FOD_LP_X64FRE_MULTI_DV9 +``` + +A valid ISO usually contains `FRE` as the primary descriptor, and should not contain strings that indicate supplemental content, such as `FOD` or `LP`. If you see `FOD` or `LP` in the `VolumeId`, it means you downloaded the wrong ISO. This is not bootable and image build script will fail. I looked at the code snippet again and both the good and bad image have FRE in it. Do we need to further clarify or perhaps just be explicit that the negative cases to watch out for are those with FOD or LP. —Reply to this email directly, view it on GitHub, or unsubscribe.You are receiving this because your review was requested.Message ID: ***@***.***>