OpenShift docs are moving and will soon only be available at docs.redhat.com, the home of all Red Hat product documentation. Explore the new docs experience today.
  1. Documentation
    2. history
×

Editing boot order

You can update the values for a boot order list by using the web console or the CLI.

With Boot Order in the Virtual Machine Overview page, you can:

  • Select a disk or Network Interface Card (NIC) and add it to the boot order list.

  • Edit the order of the disks or NICs in the boot order list.

  • Remove a disk or NIC from the boot order list, and return it back to the inventory of bootable sources.

Adding items to a boot order list in the web console

Add items to a boot order list by using the web console.

Procedure

  1. Click Workloads → Virtual Machines from the side menu.

  2. Select a virtual machine to open the Virtual Machine Overview screen.

  3. Click the pencil icon that is located on the right side of Boot Order. If a YAML configuration does not exist, or if this is the first time that you are creating a boot order list, the following message displays: No resource selected. VM will attempt to boot disks from YAML by order of appearance in YAMLv file. Please select a boot source.

  4. Click Add Source and select a bootable disk or Network Interface Card (NIC) for the virtual machine.

  5. Add any additional disks or NICs to the boot order list.

  6. Click Save.

Editing a boot order list in the web console

Edit the boot order list in the web console.

Procedure

  1. Click Workloads → Virtual Machines from the side menu.

  2. Select a virtual machine to open the Virtual Machine Overview screen.

  3. Click the pencil icon that is located on the right side of Boot Order.

  4. Choose the appropriate method to move the item in the boot order list:

    • If you do not use a screen reader, hover over the arrow icon next to the item that you want to move, drag the item up or down, and drop it in a location of your choice.

    • If you use a screen reader, press the Up Arrow key or Down Arrow key to move the item in the boot order list. Then, press the Tab key to drop the item in a location of your choice.

  5. Click Save.

Editing a boot order list in the YAML configuration file

Edit the boot order list in a YAML configuration file by using the CLI.

Procedure

  1. Open the YAML configuration file for the virtual machine by running the following command:

    $ oc edit vm example

  2. Edit the YAML file and modify the values for the boot order associated with a disk or Network Interface Card (NIC). For example:

    disks:
  - bootOrder: 1 (1)
    disk:
      bus: virtio
    name: containerdisk
  - disk:
      bus: virtio
    name: cloudinitdisk
  - cdrom:
      bus: virtio
    name: cd-drive-1
interfaces:
  - boot Order: 2 (2)
    macAddress: '02:96:c4:00:00'
    masquerade: {}
    name: default
    1 The boot order value specified for the disk.
    2 The boot order value specified for the Network Interface Card.

  3. Save the YAML file.

  4. Click reload the content to apply the updated boot order values from the YAML file to the boot order list in the web console.

Removing items from a boot order list in the web console

Remove items from a boot order list by using the web console.

Procedure

  1. Click Workloads → Virtual Machines from the side menu.

  2. Select a virtual machine to open the Virtual Machine Overview screen.

  3. Click the pencil icon that is located on the right side of Boot Order.

  4. Click the Remove icon next to the item. The item is removed from the boot order list and saved in the list of available boot sources. If you remove all items from the boot order list, the following message displays: No resource selected. VM will attempt to boot disks from YAML by order of appearance in YAML file. Please select a boot source.