Skip to content

Commit 27cc758

Browse files
committed
remove step to disable udp aggregation
1 parent f9ef970 commit 27cc758

File tree

2 files changed

+33
-57
lines changed

2 files changed

+33
-57
lines changed

modules/machine-user-infra-machines-ibm-z-kvm.adoc

Lines changed: 1 addition & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -16,31 +16,6 @@ You can create more {op-system-first} compute machines for your cluster by using
1616
* An HTTP or HTTPS server is set up.
1717
1818
.Procedure
19-
// Step 1 is a workaround for https://issues.redhat.com/browse/OCPBUGS-18394
20-
// Can be removed when bug is fixed.
21-
. Disable UDP aggregation.
22-
+
23-
Currently, UDP aggregation is not supported on {ibm-z-name} and is not automatically deactivated on multi-architecture compute clusters with an `x86_64` control plane and additional `s390x` compute machines. To ensure that the addtional compute nodes are added to the cluster correctly, you must manually disable UDP aggregation.
24-
25-
.. Create a YAML file `udp-aggregation-config.yaml` with the following content:
26-
+
27-
[source,yaml]
28-
----
29-
apiVersion: v1
30-
kind: ConfigMap
31-
data:
32-
disable-udp-aggregation: "true"
33-
metadata:
34-
name: udp-aggregation-config
35-
namespace: openshift-network-operator
36-
----
37-
38-
.. Create the ConfigMap resource by running the following command:
39-
+
40-
[source,terminal]
41-
----
42-
$ oc create -f udp-aggregation-config.yaml
43-
----
4419

4520
. Extract the Ignition config file from the cluster by running the following command:
4621
+
@@ -78,7 +53,7 @@ $ curl -LO $(oc -n openshift-machine-config-operator get configmap/coreos-bootim
7853
| jq -r '.architectures.s390x.artifacts.metal.formats.pxe.rootfs.location')
7954
----
8055
81-
. Move the downloaded {op-system-base} live `kernel`, `initramfs` and `rootfs` files to an HTTP or HTTPS server before you launch `virt-install`.
56+
. Move the downloaded {op-system-base} live `kernel`, `initramfs`, and `rootfs` files to an HTTP or HTTPS server before you launch `virt-install`.
8257
8358
. Create the new KVM guest nodes using the {op-system-base} `kernel`, `initramfs`, and Ignition files; the new disk image; and adjusted parm line arguments.
8459
+

modules/machine-user-infra-machines-ibm-z.adoc

Lines changed: 32 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,32 @@
11
// Module included in the following assemblies:
22
//
33
// * post_installation_configuration/configuring-multi-arch-compute-machines/creating-multi-arch-compute-nodes-ibm-z.adoc
4-
4+
ifeval::["{context}" == "creating-multi-arch-compute-nodes-ibm-z"]
5+
:ibm-z:
6+
endif::[]
7+
ifeval::["{context}" == "creating-multi-arch-compute-nodes-ibm-z-lpar"]
8+
:ibm-z-lpar:
9+
endif::[]
510
:_mod-docs-content-type: PROCEDURE
11+
// Assumption is that attribute once outside ifdef works for several level one headings.
612
[id="machine-user-infra-machines-ibm-z_{context}"]
13+
ifdef::ibm-z[]
714
= Creating {op-system} machines on {ibm-z-title} with z/VM
815

916
You can create more {op-system-first} compute machines running on {ibm-z-name} with z/VM and attach them to your existing cluster.
17+
endif::ibm-z[]
18+
ifdef::ibm-z-lpar[]
19+
= Creating {op-system} machines on {ibm-z-title} in an LPAR
20+
21+
You can create more {op-system-first} compute machines running on {ibm-z-name} in a logical partition (LPAR) and attach them to your existing cluster.
22+
endif::ibm-z-lpar[]
1023

1124
.Prerequisites
1225

1326
* You have a domain name server (DNS) that can perform hostname and reverse lookup for the nodes.
1427
* You have an HTTP or HTTPS server running on your provisioning machine that is accessible to the machines you create.
1528
1629
.Procedure
17-
// Step 1 is a workaround for https://issues.redhat.com/browse/OCPBUGS-18394
18-
// Can be removed when bug is fixed.
19-
. Disable UDP aggregation.
20-
+
21-
Currently, UDP aggregation is not supported on {ibm-z-name} and is not automatically deactivated on multi-architecture compute clusters with an `x86_64` control plane and additional `s390x` compute machines. To ensure that the addtional compute nodes are added to the cluster correctly, you must manually disable UDP aggregation.
22-
23-
.. Create a YAML file `udp-aggregation-config.yaml` with the following content:
24-
+
25-
[source,yaml]
26-
----
27-
apiVersion: v1
28-
kind: ConfigMap
29-
data:
30-
disable-udp-aggregation: "true"
31-
metadata:
32-
name: udp-aggregation-config
33-
namespace: openshift-network-operator
34-
----
35-
36-
.. Create the ConfigMap resource by running the following command:
37-
+
38-
[source,terminal]
39-
----
40-
$ oc create -f udp-aggregation-config.yaml
41-
----
4230

4331
. Extract the Ignition config file from the cluster by running the following command:
4432
+
@@ -76,9 +64,9 @@ $ curl -LO $(oc -n openshift-machine-config-operator get configmap/coreos-bootim
7664
| jq -r '.architectures.s390x.artifacts.metal.formats.pxe.rootfs.location')
7765
----
7866

79-
. Move the downloaded {op-system-base} live `kernel`, `initramfs`, and `rootfs` files to an HTTP or HTTPS server that is accessible from the z/VM guest you want to add.
67+
. Move the downloaded {op-system-base} live `kernel`, `initramfs`, and `rootfs` files to an HTTP or HTTPS server that is accessible from the {op-system} guest you want to add.
8068

81-
. Create a parameter file for the z/VM guest. The following parameters are specific for the virtual machine:
69+
. Create a parameter file for the guest. The following parameters are specific for the virtual machine:
8270
** Optional: To specify a static IP address, add an `ip=` parameter with the following entries, with each separated by a colon:
8371
... The IP address for the machine.
8472
... An empty string.
@@ -129,7 +117,7 @@ If additional LUNs are configured with NPIV, FCP requires `zfcp.allow_lun_scan=0
129117
+
130118
[IMPORTANT]
131119
====
132-
Additional postinstallation steps are required to fully enable multipathing. For more information, see “Enabling multipathing with kernel arguments on {op-system}" in _Postinstallation machine configuration tasks_.
120+
Additional postinstallation steps are required to fully enable multipathing. For more information, see “Enabling multipathing with kernel arguments on {op-system}" in _Machine configuration_.
133121
====
134122
// Add xref once it's allowed.
135123
+
@@ -152,8 +140,8 @@ rd.zfcp=0.0.19C7,0x50050763071bc5e3,0x4008400B00000000
152140
----
153141
+
154142
Write all options in the parameter file as a single line and make sure that you have no newline characters.
155-
156-
. Transfer the `initramfs`, `kernel`, parameter files, and {op-system} images to z/VM, for example, by using FTP. For details about how to transfer the files with FTP and boot from the virtual reader, see link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/installation_guide/sect-installing-zvm-s390[Installing under Z/VM].
143+
ifdef::ibm-z[]
144+
. Transfer the `initramfs`, `kernel`, parameter files, and {op-system} images to z/VM, for example, by using FTP. For details about how to transfer the files with FTP and boot from the virtual reader, see link:https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html-single/interactively_installing_rhel_over_the_network/index#installing-under-z-vm_booting-the-installation-media[Booting the installation on {ibm-z-name} to install {op-system-base} in z/VM].
157145
. Punch the files to the virtual reader of the z/VM guest virtual machine.
158146
+
159147
See link:https://www.ibm.com/docs/en/zvm/latest?topic=commands-punch[PUNCH] in {ibm-name} Documentation.
@@ -171,3 +159,16 @@ $ ipl c
171159
----
172160
+
173161
See link:https://www.ibm.com/docs/en/zvm/latest?topic=commands-ipl[IPL] in {ibm-name} Documentation.
162+
endif::ibm-z[]
163+
ifdef::ibm-z-lpar[]
164+
. Transfer the initramfs, kernel, parameter files, and {op-system} images to the LPAR, for example with FTP. For details about how to transfer the files with FTP and boot, see link:https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html-single/interactively_installing_rhel_over_the_network/index#installing-in-an-lpar_booting-the-installation-media[Booting the installation on {ibm-z-name} to install {op-system-base} in an LPAR].
165+
166+
. Boot the machine
167+
endif::ibm-z-lpar[]
168+
169+
ifeval::["{context}" == "creating-multi-arch-compute-nodes-ibm-z"]
170+
:!ibm-z:
171+
endif::[]
172+
ifeval::["{context}" == "creating-multi-arch-compute-nodes-ibm-z-lpar"]
173+
:!ibm-z-lpar:
174+
endif::[]

0 commit comments

Comments
 (0)