Skip to content

Commit 6710122

Browse files
jldohmannjldohmann
committed
OSDOCS-9735: add iscsi procedures
1 parent c4f75a2 commit 6710122

File tree

5 files changed

+133
-0
lines changed

5 files changed

+133
-0
lines changed

‎installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -160,6 +160,11 @@ include::modules/installation-user-infra-machines-static-network.adoc[leveloffse
160160

161161
include::modules/rhcos-enabling-multipath.adoc[leveloffset=+2]
162162

163+
//iscsi using `coreos-installer install`
164+
include::modules/rhcos-install-iscsi-manual.adoc[leveloffset=+2]
165+
166+
include::modules/rhcos-install-iscsi-ibft.adoc[leveloffset=+2]
167+
163168
include::modules/installation-installing-bare-metal.adoc[leveloffset=+1]
164169

165170
[role="_additional-resources"]

‎installing/installing_bare_metal/installing-bare-metal.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -188,6 +188,11 @@ include::modules/installation-user-infra-machines-static-network.adoc[leveloffse
188188

189189
include::modules/rhcos-enabling-multipath.adoc[leveloffset=+2]
190190

191+
//iscsi using `coreos-installer install`
192+
include::modules/rhcos-install-iscsi-manual.adoc[leveloffset=+2]
193+
194+
include::modules/rhcos-install-iscsi-ibft.adoc[leveloffset=+2]
195+
191196
[role="_additional-resources"]
192197
.Additional resources
193198

‎installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -181,6 +181,11 @@ include::modules/installation-user-infra-machines-static-network.adoc[leveloffse
181181

182182
include::modules/rhcos-enabling-multipath.adoc[leveloffset=+2]
183183

184+
//iscsi using `coreos-installer install`
185+
include::modules/rhcos-install-iscsi-manual.adoc[leveloffset=+2]
186+
187+
include::modules/rhcos-install-iscsi-ibft.adoc[leveloffset=+2]
188+
184189
include::modules/installation-installing-bare-metal.adoc[leveloffset=+1]
185190

186191
[role="_additional-resources"]

‎modules/rhcos-install-iscsi-ibft.adoc

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * installing/installing_bare_metal/installing-bare-metal.adoc
4+
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
5+
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
6+
7+
:_mod-docs-content-type: PROCEDURE
8+
[id="rhcos-install-iscsi-ibft_{context}"]
9+
= Installing {op-system} on an iSCSI boot device using iBFT
10+
11+
On a completely diskless machine, the iSCSI target and initiator values can be passed through iBFT. iSCSI multipathing is also supported.
12+
13+
.Prerequisites
14+
. You are in the {op-system} live environment.
15+
. You have an iSCSI target you want to install {op-system} on.
16+
. Optional: you have multipathed your iSCSI target.
17+
18+
.Procedure
19+
20+
. Mount the iSCSI target from the live environment by running the following command:
21+
+
22+
[source,text]
23+
----
24+
$ iscsiadm \
25+
--mode discovery \
26+
--type sendtargets
27+
--portal <IP_address> \ <1>
28+
--login
29+
----
30+
<1> The IP address of the target portal.
31+
32+
. Optional: enable multipathing and start the daemon with the following command:
33+
+
34+
[source,text]
35+
----
36+
$ mpathconf --enable && systemctl start multipathd.service
37+
----
38+
39+
. Install {op-system} onto the iSCSI target by running the following command and using the necessary kernel arguments, for example:
40+
+
41+
[source,text]
42+
----
43+
$ coreos-installer install \
44+
/dev/mapper/mpatha \ <1>
45+
--append-karg rd.iscsi.firmware=1 \ <2>
46+
--append-karg rd.multipath=default \ <3>
47+
--console ttyS0 \
48+
--ignition-file <path_to_file>
49+
----
50+
<1> 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`.
51+
<2> The iSCSI parameter is read from the BIOS firmware.
52+
<3> Optional: include this parameter if you are enabling multipathing.
53+
+
54+
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].
55+
56+
. Unmount the iSCSI disk:
57+
+
58+
[source,text]
59+
----
60+
$ iscsiadm --mode node --logout=all
61+
----
62+
63+
This procedure can also be performed using the `coreos-installer iso customize` or `coreos-installer pxe customize` subcommands.

‎modules/rhcos-install-iscsi-manual.adoc

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
// Module included in the following assemblies:
2+
//
3+
// * installing/installing_bare_metal/installing-bare-metal.adoc
4+
// * installing/installing_bare_metal/installing-bare-metal-network-customizations.adoc
5+
// * installing/installing_bare_metal/installing-restricted-networks-bare-metal.adoc
6+
7+
:_mod-docs-content-type: PROCEDURE
8+
[id="rhcos-install-iscsi-manual_{context}"]
9+
= Installing {op-system} manually on an iSCSI boot device
10+
11+
You can manually install {op-system} on an iSCSI target.
12+
13+
.Prerequisites
14+
. You are in the {op-system} live environment.
15+
. You have an iSCSI target that you want to install {op-system} on.
16+
17+
.Procedure
18+
19+
. Mount the iSCSI target from the live environment by running the following command:
20+
+
21+
[source,text]
22+
----
23+
$ iscsiadm \
24+
--mode discovery \
25+
--type sendtargets
26+
--portal <IP_address> \ <1>
27+
--login
28+
----
29+
<1> The IP address of the target portal.
30+
31+
. Install {op-system} onto the iSCSI target by running the following command and using the necessary kernel arguments, for example:
32+
+
33+
[source,text]
34+
----
35+
$ coreos-installer install \
36+
/dev/disk/by-path/ip-<IP_address>:<port>-iscsi-<target_iqn>-lun-<lun> \ <1>
37+
--append-karg rd.iscsi.initiator=<initiator_iqn> \ <2>
38+
--append.karg netroot=<target_iqn> \ <3>
39+
--console ttyS0,115200n8
40+
--ignition-file <path_to_file>
41+
----
42+
<1> The location you are installing to. 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).
43+
<2> The iSCSI initiator, or client, name in IQN format. The initiator forms a session to connect to the iSCSI target.
44+
<3> The the iSCSI target, or server, name in IQN format.
45+
+
46+
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].
47+
48+
. Unmount the iSCSI disk with the following command:
49+
+
50+
[source,text]
51+
----
52+
$ iscsiadm --mode node --logoutall=all
53+
----
54+
55+
This procedure can also be performed using the `coreos-installer iso customize` or `coreos-installer pxe customize` subcommands.

0 commit comments

Comments
 (0)