-
Bug
-
Resolution: Unresolved
-
Normal
-
None
-
4.16.z
-
None
-
Important
-
None
-
False
-
Description of problem:
We have suggestions for improving the document “Installing a cluster in an LPAR on IBM Z and IBM LinuxONE” started with OCP version 4.15 and later.
https://docs.openshift.com/container-platform/4.15/installing/installing_ibm_z/installing-ibm-z-lpar.html
There are three sections we’d like to make updates to:
1) Step 3 when working with FCP-type disks, there is a Note about using zfcp.allow_lun_scan.
https://docs.openshift.com/container-platform/4.15/installing/installing_ibm_z/installing-ibm-z-lpar.html#installation-user-infra-machines-iso-ibm-z_installing-ibm-z-lpar
The recommendation and I believe the default is to set this to 1, however, the note seems to push more toward setting it to 0.
2) Step 4 of the same section discusses the files required for bootstrapping RHCOS.
https://docs.openshift.com/container-platform/4.15/installing/installing_ibm_z/installing-ibm-z-lpar.html#installation-user-infra-machines-iso-ibm-z_installing-ibm-z-lpar
The current link provided in the step for further details points to RHEL documentation. These files are necessary for the generic.ins file, for example:
images/kernel.img 0x00000000
images/initrd.img 0x02000000
images/genericdvd.prm 0x00010480
images/initrd.addrsize 0x00010408
There needs to be an example of generic.ins here, since anyone not familiar with native linux installs on LPARs have nothing much to go on.
3) The native lpar installation document is what some consider the manual approach. But we’ve discussed this with Holger, and the recommendation is to steer customers more toward using the Assisted Installer - https://docs.openshift.com/container-platform/4.15/installing/installing_on_prem_assisted/installing-on-prem-assisted.html. An option is to add that recommendation at the top of the Native LPAR installation doc.
Version-Release number of selected component (if applicable):
OCP version 4.15.0 and later
How reproducible:
N/A - suggested documentation updates
Steps to Reproduce:
N/A - suggested documentation updates
1.
2.
3.
Actual results:
N/A - suggested documentation updates
Expected results:
N/A - suggested documentation updates
Additional info: