Skip to content

Commit 341e61a

Browse files
authored
Merge pull request #91124 from slovern/4.19-4.18-TELCODOCS-2008
TELCODOCS-2008 - 4.18/4.19 update coreos-install commands with --offl…
2 parents e72a20a + dc16f1b commit 341e61a

6 files changed

+158
-14
lines changed

modules/installation-user-infra-machines-advanced-enabling-serial-console.adoc

Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@
44
// * installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
55
// * installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
66

7+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
8+
:restricted:
9+
endif::[]
10+
711
:_mod-docs-content-type: PROCEDURE
812
[id="installation-user-infra-machines-advanced-enabling-serial-console_{context}"]
913
= Enabling the serial console for PXE and ISO installations
@@ -18,10 +22,20 @@ By default, the {op-system-first} serial console is disabled and all output is w
1822
+
1923
[source,terminal]
2024
----
25+
ifndef::restricted[]
26+
$ coreos-installer install \
27+
--console=tty0 \//<1>
28+
--console=ttyS0,<options> \//<2>
29+
--ignition-url=http://host/worker.ign /dev/disk/by-id/scsi-<serial_number>
30+
endif::[]
31+
ifdef::restricted[]
2132
$ coreos-installer install \
22-
--console=tty0 \//<1>
23-
--console=ttyS0,<options> \//<2>
24-
--ignition-url=http://host/worker.ign /dev/disk/by-id/scsi-<serial_number>
33+
--console=tty0 \//<1>
34+
--console=ttyS0,<options> \//<2>
35+
--ignition-url=http://host/worker.ign \
36+
--offline \
37+
/dev/disk/by-id/scsi-<serial_number>
38+
endif::[]
2539
----
2640
+
2741
<1> The desired secondary console. In this case, the graphical console. Omitting this option will disable the graphical console.
@@ -36,3 +50,6 @@ A similar outcome can be obtained by using the `coreos-installer install --appen
3650

3751
To configure a PXE installation, make sure the `coreos.inst.install_dev` kernel command line option is omitted, and use the shell prompt to run `coreos-installer` manually using the above ISO installation procedure.
3852

53+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
54+
:!restricted:
55+
endif::[]

modules/installation-user-infra-machines-advanced.adoc

Lines changed: 43 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,9 @@
88
ifeval::["{context}" == "installing-with-agent-based-installer"]
99
:agent:
1010
endif::[]
11+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
12+
:restricted:
13+
endif::[]
1114

1215
:_mod-docs-content-type: PROCEDURE
1316
ifndef::agent[]
@@ -54,8 +57,16 @@ system using available RHEL tools, such as `nmcli` or `nmtui`.
5457
+
5558
[source,terminal]
5659
----
60+
ifndef::restricted[]
5761
$ sudo coreos-installer install --copy-network \
5862
--ignition-url=http://host/worker.ign /dev/disk/by-id/scsi-<serial_number>
63+
endif::[]
64+
ifdef::restricted[]
65+
$ sudo coreos-installer install --copy-network \
66+
--ignition-url=http://host/worker.ign \
67+
--offline \
68+
/dev/disk/by-id/scsi-<serial_number>
69+
endif::[]
5970
----
6071
+
6172
[IMPORTANT]
@@ -232,25 +243,50 @@ This example preserves any partition in which the partition label begins with `d
232243

233244
[source,terminal]
234245
----
246+
ifndef::restricted[]
235247
# coreos-installer install --ignition-url http://10.0.2.2:8080/user.ign \
236-
--save-partlabel 'data*' /dev/disk/by-id/scsi-<serial_number>
248+
--save-partlabel 'data*' \
249+
/dev/disk/by-id/scsi-<serial_number>
250+
endif::[]
251+
ifdef::restricted[]
252+
# coreos-installer install --ignition-url http://10.0.2.2:8080/user.ign \
253+
--save-partlabel 'data*' \
254+
--offline \
255+
/dev/disk/by-id/scsi-<serial_number>
256+
endif::[]
237257
----
238258

239259
The following example illustrates running the `coreos-installer` in a way that preserves
240260
the sixth (6) partition on the disk:
241261

242262
[source,terminal]
243263
----
264+
ifndef::restricted[]
244265
# coreos-installer install --ignition-url http://10.0.2.2:8080/user.ign \
245-
--save-partindex 6 /dev/disk/by-id/scsi-<serial_number>
266+
--save-partindex 6 /dev/disk/by-id/scsi-<serial_number>
267+
endif::[]
268+
ifdef::restricted[]
269+
# coreos-installer install --ignition-url http://10.0.2.2:8080/user.ign \
270+
--save-partindex 6 \
271+
--offline \
272+
/dev/disk/by-id/scsi-<serial_number>
273+
endif::[]
246274
----
247275

248276
This example preserves partitions 5 and higher:
249277

250278
[source,terminal]
251279
----
252-
# coreos-installer install --ignition-url http://10.0.2.2:8080/user.ign
253-
--save-partindex 5- /dev/disk/by-id/scsi-<serial_number>
280+
ifndef::restricted[]
281+
# coreos-installer install --ignition-url http://10.0.2.2:8080/user.ign \
282+
--save-partindex 5- /dev/disk/by-id/scsi-<serial_number>
283+
endif::[]
284+
ifdef::restricted[]
285+
# coreos-installer install --ignition-url http://10.0.2.2:8080/user.ign \
286+
--save-partindex 5- \
287+
--offline \
288+
/dev/disk/by-id/scsi-<serial_number>
289+
endif::[]
254290
----
255291

256292
In the previous examples where partition saving is used, `coreos-installer` recreates the partition immediately.
@@ -310,3 +346,6 @@ endif::agent[]
310346
ifeval::["{context}" == "installing-with-agent-based-installer"]
311347
:!agent:
312348
endif::[]
349+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
350+
:!restricted:
351+
endif::[]

modules/installation-user-infra-machines-iso.adoc

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,9 @@ endif::[]
1313
ifeval::["{context}" == "installing-restricted-networks-ibm-power"]
1414
:ibm-power:
1515
endif::[]
16+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
17+
:restricted:
18+
endif::[]
1619

1720
:_mod-docs-content-type: PROCEDURE
1821
[id="installation-user-infra-machines-iso_{context}"]
@@ -126,7 +129,14 @@ It is possible to interrupt the {op-system} installation boot process to add ker
126129
+
127130
[source,terminal]
128131
----
129-
$ sudo coreos-installer install --ignition-url=http://<HTTP_server>/<node_type>.ign <device> --ignition-hash=sha512-<digest> <1><2>
132+
ifdef::restricted[]
133+
$ sudo coreos-installer install --ignition-url=http://<HTTP_server>/<node_type>.ign <device> \ <1>
134+
--ignition-hash=sha512-<digest> --offline <2>
135+
endif::[]
136+
ifndef::restricted[]
137+
$ sudo coreos-installer install --ignition-url=http://<HTTP_server>/<node_type>.ign <device> \ <1>
138+
--ignition-hash=sha512-<digest> <2>
139+
endif::[]
130140
----
131141
<1> You must run the `coreos-installer` command by using `sudo`, because the `core` user does not have the required root privileges to perform the installation.
132142
<2> The `--ignition-hash` option is required when the Ignition config file is obtained through an HTTP URL to validate the authenticity of the Ignition config file on the cluster node. `<digest>` is the Ignition config file SHA512 digest obtained in a preceding step.
@@ -140,7 +150,16 @@ The following example initializes a bootstrap node installation to the `/dev/sda
140150
+
141151
[source,terminal]
142152
----
143-
$ sudo coreos-installer install --ignition-url=http://192.168.1.2:80/installation_directory/bootstrap.ign /dev/sda --ignition-hash=sha512-a5a2d43879223273c9b60af66b44202a1d1248fc01cf156c46d4a79f552b6bad47bc8cc78ddf0116e80c59d2ea9e32ba53bc807afbca581aa059311def2c3e3b
153+
154+
ifdef::restricted[]
155+
$ sudo coreos-installer install --ignition-url=http://192.168.1.2:80/installation_directory/bootstrap.ign /dev/sda \
156+
--ignition-hash=sha512-a5a2d43879223273c9b60af66b44202a1d1248fc01cf156c46d4a79f552b6bad47bc8cc78ddf0116e80c59d2ea9e32ba53bc807afbca581aa059311def2c3e3b \
157+
--offline
158+
endif::[]
159+
ifndef::restricted[]
160+
$ sudo coreos-installer install --ignition-url=http://192.168.1.2:80/installation_directory/bootstrap.ign /dev/sda \
161+
--ignition-hash=sha512-a5a2d43879223273c9b60af66b44202a1d1248fc01cf156c46d4a79f552b6bad47bc8cc78ddf0116e80c59d2ea9e32ba53bc807afbca581aa059311def2c3e3b
162+
endif::[]
144163
----
145164

146165
. Monitor the progress of the {op-system} installation on the console of the machine.
@@ -181,3 +200,6 @@ endif::[]
181200
ifeval::["{context}" == "installing-restricted-networks-ibm-power"]
182201
:!ibm-power:
183202
endif::[]
203+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
204+
:!restricted:
205+
endif::[]

modules/rhcos-enabling-multipath.adoc

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@
44
// * installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
55
// * installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
66

7+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
8+
:restricted:
9+
endif::[]
10+
711
:_mod-docs-content-type: PROCEDURE
812
[id="rhcos-enabling-multipath_{context}"]
913
= Enabling multipathing with kernel arguments on {op-system}
@@ -49,23 +53,43 @@ $ mpathconf --enable && systemctl start multipathd.service
4953
+
5054
[source,terminal]
5155
----
56+
ifndef::restricted[]
5257
$ coreos-installer install /dev/mapper/mpatha \// <1>
5358
--ignition-url=http://host/worker.ign \
5459
--append-karg rd.multipath=default \
5560
--append-karg root=/dev/disk/by-label/dm-mpath-root \
5661
--append-karg rw
62+
endif::[]
63+
ifdef::restricted[]
64+
$ coreos-installer install /dev/mapper/mpatha \// <1>
65+
--ignition-url=http://host/worker.ign \
66+
--append-karg rd.multipath=default \
67+
--append-karg root=/dev/disk/by-label/dm-mpath-root \
68+
--append-karg rw \
69+
--offline
70+
endif::[]
5771
----
5872
<1> Indicates the path of the single multipathed device.
5973
+
6074
* If there are multiple multipath devices connected to the machine, or to be more explicit, instead of using `/dev/mapper/mpatha`, it is recommended to use the World Wide Name (WWN) symlink available in `/dev/disk/by-id`. For example:
6175
+
6276
[source,terminal]
6377
----
78+
ifndef::restricted[]
6479
$ coreos-installer install /dev/disk/by-id/wwn-<wwn_ID> \// <1>
6580
--ignition-url=http://host/worker.ign \
6681
--append-karg rd.multipath=default \
6782
--append-karg root=/dev/disk/by-label/dm-mpath-root \
6883
--append-karg rw
84+
endif::[]
85+
ifdef::restricted[]
86+
$ coreos-installer install /dev/disk/by-id/wwn-<wwn_ID> \// <1>
87+
--ignition-url=http://host/worker.ign \
88+
--append-karg rd.multipath=default \
89+
--append-karg root=/dev/disk/by-label/dm-mpath-root \
90+
--append-karg rw \
91+
--offline
92+
endif::[]
6993
----
7094
<1> Indicates the WWN ID of the target multipathed device. For example, `0xx194e957fcedb4841`.
7195
+
@@ -95,3 +119,7 @@ sh-4.2# exit
95119
----
96120
+
97121
You should see the added kernel arguments.
122+
123+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
124+
:!restricted:
125+
endif::[]

modules/rhcos-install-iscsi-ibft.adoc

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@
44
// * installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
55
// * installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
66

7+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
8+
:restricted:
9+
endif::[]
10+
711
:_mod-docs-content-type: PROCEDURE
812
[id="rhcos-install-iscsi-ibft_{context}"]
913
= Installing {op-system} on an iSCSI boot device using iBFT
@@ -40,12 +44,23 @@ $ mpathconf --enable && systemctl start multipathd.service
4044
+
4145
[source,text]
4246
----
47+
ifndef::restricted[]
4348
$ coreos-installer install \
4449
/dev/mapper/mpatha \ <1>
4550
--append-karg rd.iscsi.firmware=1 \ <2>
4651
--append-karg rd.multipath=default \ <3>
4752
--console ttyS0 \
4853
--ignition-file <path_to_file>
54+
endif::[]
55+
ifdef::restricted[]
56+
$ coreos-installer install \
57+
/dev/mapper/mpatha \ <1>
58+
--append-karg rd.iscsi.firmware=1 \ <2>
59+
--append-karg rd.multipath=default \ <3>
60+
--console ttyS0 \
61+
--ignition-file <path_to_file> \
62+
--offline
63+
endif::[]
4964
----
5065
<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`.
5166
<2> The iSCSI parameter is read from the BIOS firmware.
@@ -61,3 +76,7 @@ $ iscsiadm --mode node --logout=all
6176
----
6277

6378
This procedure can also be performed using the `coreos-installer iso customize` or `coreos-installer pxe customize` subcommands.
79+
80+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
81+
:!restricted:
82+
endif::[]

modules/rhcos-install-iscsi-manual.adoc

Lines changed: 24 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,10 @@
44
// * installing/installing_bare_metal/upi/installing-bare-metal-network-customizations.adoc
55
// * installing/installing_bare_metal/upi/installing-restricted-networks-bare-metal.adoc
66

7+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
8+
:restricted:
9+
endif::[]
10+
711
:_mod-docs-content-type: PROCEDURE
812
[id="rhcos-install-iscsi-manual_{context}"]
913
= Installing {op-system} manually on an iSCSI boot device
@@ -32,12 +36,23 @@ $ iscsiadm \
3236
+
3337
[source,text]
3438
----
39+
ifndef::restricted[]
40+
$ coreos-installer install \
41+
/dev/disk/by-path/ip-<IP_address>:<port>-iscsi-<target_iqn>-lun-<lun> \ <1>
42+
--append-karg rd.iscsi.initiator=<initiator_iqn> \ <2>
43+
--append.karg netroot=<target_iqn> \ <3>
44+
--console ttyS0,115200n8
45+
--ignition-file <path_to_file>
46+
endif::[]
47+
ifdef::restricted[]
3548
$ 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>
49+
/dev/disk/by-path/ip-<IP_address>:<port>-iscsi-<target_iqn>-lun-<lun> \ <1>
50+
--append-karg rd.iscsi.initiator=<initiator_iqn> \ <2>
51+
--append.karg netroot=<target_iqn> \ <3>
52+
--console ttyS0,115200n8 \
53+
--ignition-file <path_to_file> \
54+
--offline
55+
endif::[]
4156
----
4257
<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).
4358
<2> The iSCSI initiator, or client, name in IQN format. The initiator forms a session to connect to the iSCSI target.
@@ -53,3 +68,7 @@ $ iscsiadm --mode node --logoutall=all
5368
----
5469

5570
This procedure can also be performed using the `coreos-installer iso customize` or `coreos-installer pxe customize` subcommands.
71+
72+
ifeval::["{context}" == "installing-restricted-networks-bare-metal"]
73+
:!restricted:
74+
endif::[]

0 commit comments

Comments
 (0)