mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
81 lines
2.8 KiB
Plaintext
81 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-manual_{context}"]
|
|
= Installing {op-system} manually on an iSCSI boot device
|
|
|
|
[role="_abstract"]
|
|
To deploy {op-system} by using networked storage, manually install the operating system on an iSCSI target. This configuration enables the system to boot from a remote storage array, eliminating the need for local disks.
|
|
|
|
.Prerequisites
|
|
. You are in the {op-system} live environment.
|
|
. You have an iSCSI target that you want to install {op-system} on.
|
|
|
|
.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.
|
|
|
|
. 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/disk/by-path/ip-<IP_address>:<port>-iscsi-<target_iqn>-lun-<lun> \
|
|
--append-karg rd.iscsi.initiator=<initiator_iqn> \
|
|
--append.karg netroot=<target_iqn> \
|
|
--console ttyS0,115200n8
|
|
--ignition-file <path_to_file>
|
|
endif::[]
|
|
ifdef::restricted[]
|
|
$ coreos-installer install \
|
|
/dev/disk/by-path/ip-<IP_address>:<port>-iscsi-<target_iqn>-lun-<lun> \
|
|
--append-karg rd.iscsi.initiator=<initiator_iqn> \
|
|
--append.karg netroot=<target_iqn> \
|
|
--console ttyS0,115200n8 \
|
|
--ignition-file <path_to_file> \
|
|
--offline
|
|
endif::[]
|
|
----
|
|
+
|
|
where:
|
|
+
|
|
`/dev/disk/by-path/ip`:: Specifies the installation location. You must provide the IP address of the target portal, the associated port number, the target iSCSI node in IQN format, and the iSCSI logical unit number (LUN).
|
|
`<initiator_iqn>`:: Specifies the iSCSI initiator, or client, name in IQN format. The initiator forms a session to connect to the iSCSI target.
|
|
`<target_iqn>`:: Specifies the iSCSI target, or server, name in IQN format.
|
|
+
|
|
For more information about the iSCSI options supported by `dracut`, see the link:https://www.man7.org/linux/man-pages/man7/dracut.cmdline.7.html[`dracut.cmdline` manual page].
|
|
|
|
. Unmount the iSCSI disk with the following command:
|
|
+
|
|
[source,text]
|
|
----
|
|
$ iscsiadm --mode node --logoutall=all
|
|
----
|
|
+
|
|
This procedure can also be performed using the `coreos-installer iso customize` or `coreos-installer pxe customize` subcommands.
|
|
|
|
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
|
|
:!restricted:
|
|
endif::[] |