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

Ambiguity of <user> in BareMetal IPI libvirt setup instructions causes installer failures

    • Icon: Bug Bug
    • Resolution: Unresolved
    • Icon: Undefined Undefined
    • None
    • 4.20.z
    • None
    • None
    • False
    • Hide

      None

      Show
      None
    • None
    • Moderate
    • None
    • None
    • None
    • None
    • None
    • None
    • None
    • None
    • None
    • None
    • None
    • None

      Issue Description:

       

      https://docs.redhat.com/en/documentation/openshift_container_platform/4.20/html-single/installing_on_bare_metal/index#preparing-the-provisioner-node-for-openshift-install_ipi-install-installation-workflow

      Point 7: Modify the user to add the libvirt group to the newly created user:
      sudo usermod --append --groups libvirt <user>

      The documentation uses the placeholder `<user>` when instructing users to add a user to the `libvirt` group, but does not define which user this refers to.

      As written, it is ambiguous whether `<user>` refers to:

      • `root`
      • a newly created system user
      • the `kni` user commonly used in examples
      • or another account created by the installer

       

      Suggested Documentation Update:

      Replace the ambiguous instruction with an explicit example, such as:

       

      sudo usermod --append --groups libvirt kni

       

      and note that the user must log out and log back in for group membership to take effect.

       

      Version-Release number of selected component (if applicable):

      4.20.z    

              ocp-docs-bot OCP DocsBot
              rhn-support-asadawar Abhijeet Sadawarte
              Gaoyun Pei Gaoyun Pei
              None
              Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

                Created:
                Updated: