Examples for configuring re-IPL

Red Hat Enterprise Linux 8.6 LPAR mode z/VM guest KVM guest

Typical examples include configuring re-IPL from an FCP device and specifying parameters for re-IPL.

  • To configure a CCW device with bus ID 0.0.7e78 as the re-IPL device:
    # chreipl 0.0.7e78
    Alternatively, you can write directly to sysfs:
    # echo 0.0.7e78 > /sys/firmware/reipl/ccw/device
  • To ensure that memory is cleared during the re-IPL from the CCW device:
    Ensure that the clear attribute exists:
    # ls /sys/firmware/reipl/ccw/clear
    If the clear attribute does not exist, memory is always cleared for re-IPL in your environment, and no further action is needed.
    If the clear attribute exists, write 1 to the attribute to configure memory clearing:
    # echo 1 > /sys/firmware/reipl/ccw/clear
    Hint: If supported in your environment, re-IPL without clearing memory is the default. For large memory sizes, clearing memory can considerably slow down the re-IPL process.
  • To configure an FCP re-IPL device 0.0.5711 with a LUN 0x1711000000000000 and a WWPN 0x5005076303004715 with an additional kernel parameter novx:
    # chreipl 0.0.5711 0x5005076303004715 0x1711000000000000 -p "novx"
    Alternatively, you can write directly to sysfs. For an FCP re-IPL device, additional boot parameters, as specified with the -p option, are stored as scp data. Therefore, the novx kernel parameter of the example is written to /sys/firmware/reipl/fcp/scp_data.
    # echo 0.0.5711 > /sys/firmware/reipl/fcp/device
    # echo 0x5005076303004715 > /sys/firmware/reipl/fcp/wwpn
    # echo 0x1711000000000000 > /sys/firmware/reipl/fcp/lun
    # echo "novx" > /sys/firmware/reipl/fcp/scp_data
    # echo fcp > /sys/firmware/reipl/reipl_type
  • To specify additional kernel parameters for re-IPL of an instance of Linux® on z/VM®:
    Write the parameters to the parm attribute:
    # echo "novx" > /sys/firmware/reipl/ccw/parm