Boot Order Policy

A Boot Order Policy defines the sequence in which devices are attempted during server startup. It supports UEFI and Legacy boot modes and a wide range of device types including PXE, local disk, SAN, HTTP boot, and virtual media. The policy is applied to servers via a Server Profile Template.

Location in Intersight GUI: Policies » Boot Order

Diagram

Classes

policies (compute.intersight.organizations)

Name	Type	Constraint	Mandatory	Default Value
boot_order	List	[boot_order]	No

boot_order (compute.intersight.organizations.policies)

Name	Type	Constraint	Mandatory	Default Value
name	String	Regex: ^[a-zA-Z0-9_.:-]{1,64}$	Yes
description	String		No
managed	Boolean	true, false	No	true
tags	List	[tags]	No
boot_mode	Choice	Uefi, Legacy	No	Uefi
secure_boot	Boolean	true, false	No	true
boot_devices	List	[boot_devices]	No

tags (compute.intersight.organizations.policies.boot_order)

Name	Type	Constraint	Mandatory	Default Value
key	String		Yes
value	String		Yes

boot_devices (compute.intersight.organizations.policies.boot_order)

Name	Type	Constraint	Mandatory	Default Value
name	String	Regex: ^[a-zA-Z0-9_-]{1,30}$	Yes
device_type	Choice	flex_mmc, http_boot, iscsi_boot, local_cdd, local_disk, nvme, pch_storage, pxe_boot, san_boot, sd_card, uefi_shell, usb, virtual_media	Yes
enabled	Boolean	true, false	No	true
slot	String		No
lun	Integer	min: 0, max: 255	No
subtype	Choice	None, flex-util, flex-flash, SDCARD, cimc-mapped-dvd, cimc-mapped-hdd, kvm-mapped-dvd, kvm-mapped-hdd, kvm-mapped-fdd, usb-cd, usb-fdd, usb-hdd, flexmmc-mapped-dvd, flexmmc-mapped-hdd	No
interface_name	String		No
interface_source	Choice	name, mac, port	No
ip_type	Choice	None, IPv4, IPv6	No
ip_config_type	Choice	DHCP, Static	No
mac_address	String		No
port	Integer	min: -1, max: 255	No
protocol	Choice	HTTP, HTTPS	No
target_wwpn	String		No
uri	String		No
ipv4_config	Class	[ipv4_config]	No
ipv6_config	Class	[ipv6_config]	No
bootloader	Class	[bootloader]	No

ipv4_config (compute.intersight.organizations.policies.boot_order.boot_devices)

Name	Type	Constraint	Mandatory	Default Value
ip	IP		Yes
network_mask	String		Yes
gateway_ip	IP		Yes
dns_ip	IP		No

ipv6_config (compute.intersight.organizations.policies.boot_order.boot_devices)

Name	Type	Constraint	Mandatory	Default Value
ip	IP		Yes
prefix_length	Integer	min: 1, max: 128	Yes
gateway_ip	IP		Yes
dns_ip	IP		No

bootloader (compute.intersight.organizations.policies.boot_order.boot_devices)

Name	Type	Constraint	Mandatory	Default Value
name	String		Yes
path	String		Yes
description	String		No

Examples

Example-1: The example below demonstrates a UEFI policy that first attempts PXE boot on a named interface, then falls back to a local disk with a specified UEFI bootloader path.

compute:
  intersight:
    organizations:
      - name: MyOrganization
        policies:
          boot_order:
            - name: pxe-then-local
              boot_mode: Uefi
              secure_boot: true
              boot_devices:
                - name: pxe-primary
                  device_type: pxe_boot
                  interface_name: eth0
                  interface_source: name
                  ip_type: IPv4
                - name: local-disk
                  device_type: local_disk
                  slot: MSTOR-RAID
                  bootloader:
                    name: bootx64.efi
                    path: \EFI\BOOT\
              tags:
                - key: env
                  value: prod

Example-2: The example below demonstrates a SAN boot policy for stateless servers where the OS resides on a remote LUN.

compute:
  intersight:
    organizations:
      - name: MyOrganization
        policies:
          boot_order:
            - name: san-boot
              boot_mode: Uefi
              boot_devices:
                - name: san-primary
                  device_type: san_boot
                  interface_name: vhba0
                  lun: 0
                  target_wwpn: "20:00:00:25:b5:00:00:01"
                  bootloader:
                    name: bootx64.efi
                    path: \EFI\BOOT\