1Boot devices on s390x 2===================== 3 4Booting with bootindex parameter 5-------------------------------- 6 7For classical mainframe guests (i.e. LPAR or z/VM installations), you always 8have to explicitly specify the disk where you want to boot from (or "IPL" from, 9in s390x-speak -- IPL means "Initial Program Load"). In particular, there can 10also be only one boot device according to the architecture specification, thus 11specifying multiple boot devices is not possible (yet). 12 13So for booting an s390x guest in QEMU, you should always mark the 14device where you want to boot from with the ``bootindex`` property, for 15example:: 16 17 qemu-system-s390x -drive if=none,id=dr1,file=guest.qcow2 \ 18 -device virtio-blk,drive=dr1,bootindex=1 19 20For booting from a CD-ROM ISO image (which needs to include El-Torito boot 21information in order to be bootable), it is recommended to specify a ``scsi-cd`` 22device, for example like this:: 23 24 qemu-system-s390x -blockdev file,node-name=c1,filename=... \ 25 -device virtio-scsi \ 26 -device scsi-cd,drive=c1,bootindex=1 27 28Note that you really have to use the ``bootindex`` property to select the 29boot device. The old-fashioned ``-boot order=...`` command of QEMU (and 30also ``-boot once=...``) is not supported on s390x. 31 32 33Booting without bootindex parameter 34----------------------------------- 35 36The QEMU guest firmware (the so-called s390-ccw bios) has also some rudimentary 37support for scanning through the available block devices. So in case you did 38not specify a boot device with the ``bootindex`` property, there is still a 39chance that it finds a bootable device on its own and starts a guest operating 40system from it. However, this scanning algorithm is still very rough and may 41be incomplete, so that it might fail to detect a bootable device in many cases. 42It is really recommended to always specify the boot device with the 43``bootindex`` property instead. 44 45This also means that you should avoid the classical short-cut commands like 46``-hda``, ``-cdrom`` or ``-drive if=virtio``, since it is not possible to 47specify the ``bootindex`` with these commands. Note that the convenience 48``-cdrom`` option even does not give you a real (virtio-scsi) CD-ROM device on 49s390x. Due to technical limitations in the QEMU code base, you will get a 50virtio-blk device with this parameter instead, which might not be the right 51device type for installing a Linux distribution via ISO image. It is 52recommended to specify a CD-ROM device via ``-device scsi-cd`` (as mentioned 53above) instead. 54 55 56Booting from a network device 57----------------------------- 58 59Beside the normal guest firmware (which is loaded from the file ``s390-ccw.img`` 60in the data directory of QEMU, or via the ``-bios`` option), QEMU ships with 61a small TFTP network bootloader firmware for virtio-net-ccw devices, too. This 62firmware is loaded from a file called ``s390-netboot.img`` in the QEMU data 63directory. In case you want to load it from a different filename instead, 64you can specify it via the ``-global s390-ipl.netboot_fw=filename`` 65command line option. 66 67The ``bootindex`` property is especially important for booting via the network. 68If you don't specify the the ``bootindex`` property here, the network bootloader 69firmware code won't get loaded into the guest memory so that the network boot 70will fail. For a successful network boot, try something like this:: 71 72 qemu-system-s390x -netdev user,id=n1,tftp=...,bootfile=... \ 73 -device virtio-net-ccw,netdev=n1,bootindex=1 74 75The network bootloader firmware also has basic support for pxelinux.cfg-style 76configuration files. See the `PXELINUX Configuration page 77<https://wiki.syslinux.org/wiki/index.php?title=PXELINUX#Configuration>`__ 78for details how to set up the configuration file on your TFTP server. 79The supported configuration file entries are ``DEFAULT``, ``LABEL``, 80``KERNEL``, ``INITRD`` and ``APPEND`` (see the `Syslinux Config file syntax 81<https://wiki.syslinux.org/wiki/index.php?title=Config>`__ for more 82information). 83