Uploaded image for project: 'OpenShift Bugs'
  1. OpenShift Bugs
  2. OCPBUGS-43563

Suggested improvements to the OCP Native LPAR installation

XMLWordPrintable

    • Icon: Bug Bug
    • Resolution: Unresolved
    • Icon: Normal Normal
    • None
    • 4.16.z
    • None
    • Important
    • None
    • False
    • Hide

      None

      Show
      None

      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:

              sniemann@redhat.com Silke Niemann
              phchan@redhat.com Phil Chan
              Doug Slavens Doug Slavens
              Votes:
              0 Vote for this issue
              Watchers:
              5 Start watching this issue

                Created:
                Updated: