Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 10 additions & 5 deletions modules/installation-user-infra-machines-advanced.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -272,6 +272,11 @@ or the `ignition.config.url` option will be ignored.
You can embed a live install Ignition config directly in an {op-system} ISO image. When
the ISO image is booted, the embedded config will be applied automatically.

[IMPORTANT]
====
This type of configuration must be created manually and should be avoided if possible, as it is not supported by Red Hat.
====

.Procedure

. Download the `coreos-installer` binary from the following image mirror page: https://mirror.openshift.com/pub/openshift-v4/clients/coreos-installer/latest/.
Expand All @@ -280,15 +285,15 @@ the ISO image is booted, the embedded config will be applied automatically.
+
[source,terminal]
----
# cp rhcos-<version>-live.x86_64.iso bootstrap.ign /mnt/
# cp rhcos-<version>-live.x86_64.iso live.ign /mnt/
# chmod 644 /mnt/rhcos-<version>-live.x86_64.iso
----

. Run the following command to embed the Ignition config into the ISO:
+
[source,terminal]
----
# ./coreos-installer iso ignition embed -i /mnt/bootstrap.ign \
# ./coreos-installer iso ignition embed -i /mnt/live.ign \
/mnt/rhcos-<version>-live.x86_64.iso
----
+
Expand All @@ -304,18 +309,18 @@ Using `coreos-installer iso ignition embed` to embed a file generated by `opensh
+
[source,terminal]
----
# ./coreos-installer iso ignition show /mnt/rhcos-<version>-live.x86_64.iso > mybootstrap.ign
# ./coreos-installer iso ignition show /mnt/rhcos-<version>-live.x86_64.iso > mylive.ign
----
+
[source,terminal]
----
# diff -s bootstrap.ign mybootstrap.ign
# diff -s live.ign mylive.ign
----
+
.Example output
[source,terminal]
----
Files bootstrap.ign and mybootstrap.ign are identical
Files live.ign and mylive.ign are identical
----

. To remove the Ignition config and return the ISO to its pristine state so
Expand Down