Using the HMC Web Services API to boot in LPAR mode

Red Hat Enterprise Linux 9.2 LPAR mode

You can boot Linux® in LPAR mode remotely by using the HMC Web Services API. For information about the API, see Hardware Management Console Web Services API for your IBM Z® or LinuxONE hardware.

You can find a client application that uses this API at https://github.com/zhmcclient/zhmccli. The examples that follow are based on this application, which provides the zhmc command as its user interface.

Hint: The zhmc command is case sensitive. For hardware and partition specifications, use the capitalization as shown in the HMC interface and the corresponding HMC API queries.

Booting from a SCSI boot device

The following example makes these assumptions about the hardware system, LPAR, and boot device:
  • The name of the IBM Z or LinuxONE system is M35.
  • The name of the LPAR is m35lp55.
  • An FC-attached SCSI disk is prepared, with zipl, as a boot device.
  • The LUN of the disk is 0x5241000000000000
  • The disk is accessed through WWPN 0x5005076300c20b8e.
  • The FCP device to access the disk has a bus ID 0.0.FC00.
To start the IPL and boot process, issue:
# zhmc lpar scsi-load M35 m35lp55 FC00 5005076300c20b8e 5241000000000000
To view the operating system messages, issue:
# zhmc lpar console M35 m35lp55

For information about IPL progress messages that are issued before the Linux kernel gets control, see Small Computer Systems Interface (SCSI) IPL Machine Loader Messages, SC28-7006.