system/s390x/bootdevices.rst

8 have to explicitly specify the disk where you want to boot from (or "IPL" from,
12 device where you want to boot from with the ``bootindex`` property, for
18 Multiple devices may have a bootindex. The lowest bootindex is assigned to the
19 device to IPL first.  If the IPL fails for the first, the device with the second
21 remaining boot devices to try.
23 For booting from a CD-ROM ISO image (which needs to include El-Torito boot
24 information in order to be bootable), it is recommended to specify a ``scsi-cd``
31 Note that you really have to use the ``bootindex`` property to select the
44 be incomplete, so that it might fail to detect a bootable device in many cases.
45 It is really recommended to always specify the boot device with the
49 ``-hda``, ``-cdrom`` or ``-drive if=virtio``, since it is not possible to
52 s390x. Due to technical limitations in the QEMU code base, you will get a
55 recommended to specify a CD-ROM device via ``-device scsi-cd`` (as mentioned
63 which can be used to select the kernel on the disk of the guest that the
68 The first way to use this parameter is to use the word ``PROMPT`` as the
70 installed kernels on the disk of the guest and ask the user to enter a number
71 to chose which kernel should be booted -- similar to what can be achieved by
75 sectors, there is not enough space for the zipl loader on the disk to store
78 The second way to use this parameter is to use a number in the range from 0
79 to 31. The numbers that can be used here correspond to the numbers that are
81 to automatically boot the kernel that is associated with the given number.
82 Note that ``0`` can be used to boot the default entry. If the machine
85 By default, the machine ``loadparm`` applies to all boot devices. If multiple
86 devices are assigned a ``bootindex`` and the ``loadparm`` is to be different
96 In this case, the primary boot device will attempt to IPL using the default
98 machine). If that device fails to boot, the secondary device will attempt to
104 is used when attempting to boot without a ``bootindex``.
123 for details how to set up the configuration file on your TFTP server.