mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
90 lines
2.8 KiB
Plaintext
90 lines
2.8 KiB
Plaintext
// Module included in the following assemblies:
|
|
//
|
|
// * installing/installing_bare_metal/upi/installing-bare-metal.adoc
|
|
// * installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
|
|
// * installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
|
|
|
|
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
|
|
:restricted:
|
|
endif::[]
|
|
|
|
:_mod-docs-content-type: PROCEDURE
|
|
[id="rhcos-install-iscsi-ibft_{context}"]
|
|
= Installing {op-system} on an iSCSI boot device using iBFT
|
|
|
|
[role="_abstract"]
|
|
To configure a completely diskless machine, pass the iSCSI target and initiator values by using the iSCSI Boot Firmware Table (iBFT). With this setup, you can use iSCSI multipathing to ensure storage resilience.
|
|
|
|
.Prerequisites
|
|
|
|
. You are in the {op-system} live environment.
|
|
. You have an iSCSI target you want to install {op-system} on.
|
|
. Optional: You have configured multipathing for your iSCSI target.
|
|
|
|
.Procedure
|
|
|
|
. Mount the iSCSI target from the live environment by running the following command:
|
|
+
|
|
[source,text]
|
|
----
|
|
$ iscsiadm \
|
|
--mode discovery \
|
|
--type sendtargets
|
|
--portal <IP_address> \
|
|
--login
|
|
----
|
|
+
|
|
where:
|
|
+
|
|
`<IP_address>`:: Specifies the IP address of the target portal.
|
|
|
|
. Optional: enable multipathing and start the daemon with the following command:
|
|
+
|
|
[source,text]
|
|
----
|
|
$ mpathconf --enable && systemctl start multipathd.service
|
|
----
|
|
|
|
. Install {op-system} onto the iSCSI target by running the following command and using the necessary kernel arguments, for example:
|
|
+
|
|
[source,text]
|
|
----
|
|
ifndef::restricted[]
|
|
$ coreos-installer install \
|
|
/dev/mapper/mpatha \
|
|
--append-karg rd.iscsi.firmware=1 \
|
|
--append-karg rd.multipath=default \
|
|
--console ttyS0 \
|
|
--ignition-file <path_to_file>
|
|
endif::[]
|
|
ifdef::restricted[]
|
|
$ coreos-installer install \
|
|
/dev/mapper/mpatha \
|
|
--append-karg rd.iscsi.firmware=1 \
|
|
--append-karg rd.multipath=default \
|
|
--console ttyS0 \
|
|
--ignition-file <path_to_file> \
|
|
--offline
|
|
endif::[]
|
|
----
|
|
+
|
|
where:
|
|
+
|
|
`/dev/mapper/mpatha`:: Specifies the path of a single multipathed device. If there are multiple multipath devices connected, or to be explicit, you can use the World Wide Name (WWN) symlink available in `/dev/disk/by-path`.
|
|
`rd.iscsi.firmware=1`:: Specifies that the iSCSI parameter is read from the BIOS firmware.
|
|
`rd.multipath=default`:: Specifies to enable multipathing. Optional parameter.
|
|
+
|
|
For more information about the iSCSI options supported by `dracut`, see the `dracut.cmdline` manual page.
|
|
|
|
. Unmount the iSCSI disk:
|
|
+
|
|
[source,text]
|
|
----
|
|
$ iscsiadm --mode node --logout=all
|
|
----
|
|
+
|
|
You can also perform this procedure by using the `coreos-installer iso customize` or `coreos-installer pxe customize` subcommands.
|
|
|
|
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
|
|
:!restricted:
|
|
endif::[] |