Uploaded image for project: 'Hybrid Cloud Infrastructure Documentation'
  1. Hybrid Cloud Infrastructure Documentation
  2. HCIDOCS-258

Document Troubleshooting minimal ISO boot failures

XMLWordPrintable

    • HCIDOCS 2024#4
    • 1

      Task scope: Add procedure for debugging minimal ISO boot failure by interrupting the boot process.

      Procedure will probably look like this:

      1. Add the `spec.kernelArguments` stanza to the `infraEnv` object to interrupt the kernel boot and gain access to the root console:

      # ...
      spec:
        clusterRef:
          name: sno1
          namespace: sno1
        cpuArchitecture: x86_64
        ipxeScriptType: DiscoveryImageAlways
        kernelArguments:
        - operation: append
          value: rd.break=initqueue [1]
        nmStateConfigLabelSelector:
          matchLabels:
            nmstate-label: sno1
        pullSecretRef:
          name: assisted-deployment-pull-secret
      

      [1] `rd.break=initqueue` interrupts the boot at the dracut main loop. See rd.break options for debugging kernel boot for details.

      2. Run the journalctl command to diagnose the error: `# journalctl -p err` or crit or warning.

       

      SME: Jose Gato Luis


      Original description:
      We already have a section for  "Troubleshooting minimal ISO boot failures".

      https://access.redhat.com/documentation/en-us/assisted_installer_for_openshift_container_platform/2024/html/installing_openshift_container_platform_with_the_assisted_installer/assembly_troubleshooting#troubleshooting_minimal_iso_boot_failures
       

      It could be extended to cover

      • How to break the boot process before the 'rootfs' image is download it
      • Some usual debuging tips here
      • How to use 'InfraEnv' object to interrupt the boot process in the correct stage. So you will have a debugging root session

      I wrote/Sketeched something like: https://github.com/jgato/jgato/blob/main/random_docs/debugging_AI_installation.md#interrupts-rhcos-boot-in-different-stages

              rhn-support-tshwartz Talia Shwartzberg
              lgamliel liat gamliel
              Jose Gato Luis
              Benny Kopilov Benny Kopilov
              Jose Gato Luis Jose Gato Luis
              Votes:
              0 Vote for this issue
              Watchers:
              5 Start watching this issue

                Created:
                Updated:
                Resolved: