Merge pull request #90177 from jldohmann/OSDOCS-3494

OSDOCS-3494: add live media validation procedure

Author: jldohmann

installing/validation_and_troubleshooting/validating-an-installation.adoc

@@ -6,7 +6,10 @@ include::_attributes/common-attributes.adoc[]
 
 toc::[]
 
-You can check the status of an {product-title} cluster after an installation by following the procedures in this document.
+You can check the status of an {product-title} cluster after an installation or validate boot artifacts before an installation by following the procedures in this document.
+
+//Validating RHCOS live media
+include::modules/rhcos-validate-live-media.adoc[leveloffset=+1]
 
 //Reviewing the installation log
 include::modules/reviewing-the-installation-log.adoc[leveloffset=+1]

modules/rhcos-validate-live-media.adoc

@@ -0,0 +1,33 @@
+// Module included in the following assemblies:
+//
+// * installing/validation_and_troubleshooting/valiadting-an-installation.adoc
+
+:_mod-docs-content-type: PROCEDURE
+[id="rhcos-validate-live-media_{context}"]
+
+= Validating {op-system} live media
+
+The {product-title} installation program contains pinned versions of {op-system} bootimages. Fully automated installations use these pinned artifacts by default. The mirror registry where you downloaded the installation program contains a `sha256sum` encrypted with the Red{nbsp}Hat product key.
+
+For user-provisioned infrastructure installations, you can access information and use the {product-title} installer to indirectly validate {op-system} bootimage artifacts using their SHA-256 checksums.
+
+.Procedure
+
+* Run the following command to print the metadata for any bootimage artifact:
++
+[source,terminal]
+----
+$ openshift-install coreos print-stream-json | jq <bootimage> <1>
+----
+<1> The query for the bootimage you want to obtain information on. For validation purposes, the bootimage artifact must have a generated `sha256sum`. This can include OVA, VHD, QCOW2 and others. For example, to get information on an `x86_64` architecture `iso` file for bare metal platforms, this value would be `.architectures.x86_64.artifacts.metal.formats.iso`.
++
+.Example output
+[source,text]
+----
+{
+  "disk": {
+    "location": "<url>/art/storage/prod/streams/<release>/builds/rhcos-<release>-live.<architecture>.<artifact>",
+    "sha256": "abc2add9746eb7be82e6919ec13aad8e9eae8cf073d8da6126d7c95ea0dee962"
+  }
+}
+----