You can use a TFTP server to PXE boot the ESXi installer. The process differs slightly depending on whether you use UEFI or boot from a legacy BIOS. Because most environments include ESXi hosts that support UEFI boot and hosts that support only legacy BIOS, this topic discusses prerequisites and steps for both types of hosts.

About this task

  • For legacy BIOS machines, the procedure supports booting multiple different versions of the ESXi installer by using the same pxelinux.0 or gpxelinux.0 initial boot loader for all target machines, but potentially different PXELINUX configuration files depending on the target machine's MAC address.

  • For UEFI machines, the procedure supports booting multiple different versions of the ESXi installer by using the same mboot.efi initial boot loader for all target machines, but potentially different boot.cfg files depending on the target machine's MAC address.

Prerequisites

Verify that your environment meets the following prerequisites.

  • ESXi installer ISO image, downloaded from the VMware Web site.

  • Target host with a hardware configuration that is supported for your version of ESXi. See the VMware Compatibility Guide.

  • Network adapter with PXE support on the target ESXi host.

  • DHCP server configured for PXE booting. See Sample DHCP Configurations.

  • TFTP server.

  • Network security policies to allow TFTP traffic (UDP port 69).

  • For legacy BIOS, you can use only IPv4 networking. For UEFI PXE boot, you can use IPv4 or IPv6 networking.

  • (Optional) Installation script (kickstart file).

  • Use a native VLAN in most cases. If you want to specify the VLAN ID to be used with PXE booting, check that your NIC supports VLAN ID specification.

For legacy BIOS systems, version 3.86 of the SYSLINUX package, available from https://www.kernel.org/pub/linux/utils/boot/syslinux/.

Procedure

  1. Configure the DHCP server for TFTP boot.
  2. (Legacy BIOS only) Obtain and configure PXELINUX:
    1. Obtain SYSLINUX version 3.86, unpack it, and copy the pxelinux.0 file to the top-level /tftpboot directory on your TFTP server.
    2. Create a PXELINUX configuration file using the following code model.

      ESXi-6.x.x-XXXXXX is the name of the TFTP subdirectory that contains the ESXi installer files.

      DEFAULT install
      NOHALT 1
      LABEL install
        KERNEL ESXi-6.x.x-XXXXXX/mboot.c32 					
        APPEND -c ESXi-6.x.x-XXXXXX/boot.cfg
        IPAPPEND 2
      
    3. Save the PXELINUX file in the /tftpboot/pxelinux.cfg directory on your TFTP server with a filename that will determine whether all hosts boot this installer by default:

      Option

      Description

      Same installer

      Name the file default if you want for all host to boot this ESXi installer by default.

      Different installers

      Name the file with the MAC address of the target host machine (01-mac_address_of_target_ESXi_host) if you want only a specific host to boot with this file, for example, 01-23-45-67-89-0a-bc.

  3. (UEFI only) Copy the file efi/boot/bootx64.efi from the ESXi installer ISO image to /tftpboot/mboot.efi on your TFTP server.
    Note:

    Newer versions of mboot.efi can generally boot older versions of ESXi, but older versions of mboot.efi might be unable to boot newer versions of ESXi. If you plan to configure different hosts to boot different versions of the ESXi installer, use the mboot.efi from the newest version.

  4. Create a subdirectory of your TFTP server's top-level /tftpboot directory and name it after the version of ESXi it will hold, for example, /tftpboot/ESXi-6.x.x-xxxxx.
  5. Copy the contents of the ESXi installer image to the directory you just created.
  6. Modify the boot.cfg file
    1. Add the following line:
      prefix=ESXi-6.x.x-xxxxxx

      Here, ESXi-6.x.x-xxxxxx is the pathname of the installer files relative to the TFTP server's root directory.

    2. If the filenames in the kernel= and modules= lines begin with a forward slash (/) character, delete that character.
  7. (Optional) : For a scripted installation, in the boot.cfg file, add the kernelopt option to the line after the kernel command, to specify the location of the installation script.

    Use the following code as a model, where XXX.XXX.XXX.XXX is the IP address of the server where the installation script resides, and esxi_ksFiles is the directory that contains the ks.cfg file.

    kernelopt=ks=http://XXX.XXX.XXX.XXX/esxi_ksFiles/ks.cfg
  8. (UEFI only) Specify whether you want for all UEFI hosts to boot the same installer.

    Option

    Description

    Same installer

    Copy or link the boot.cfg file to /tftpboot/boot.cfg

    Different installers

    1. Create a subdirectory of /tftpboot named after the MAC address of the target host machine (01-mac_address_of_target_ESXi_host), for example, 01-23-45-67-89-0a-bc.

    2. Place a copy of (or a link to) the host's boot.cfg file in that directory, for example, /tftpboot/01-23-45-67-89-0a-bc/boot.cfg.