Installing servers using your own PXE boot environment

Description

Installing servers using your own PXE boot environment


Contents

Introduction

LeaseWeb offers customers to install a dedicated server using their own PXE boot environment. This way an installation can be performed with specific Operating System versions that LeaseWeb currently does not offer or OS versions that are customized.

Technical

LeaseWeb uses an DHCP/iPXE boot environment to install dedicated servers. We now have the option for customers to list, create and delete their own DHCP leases. With creating the leases it is possible to send your own boot file name using the API or customer portal, as well as  boot server details (DHCP option 66 and 67) and DNS server IP address using the API.

This way it is possible to hook your LeaseWeb bare Metal server to any automated installation platform (like TheForeman, FAI, Cobbler and others). LeaseWeb provides the network details, although optionally you can set your own nameserver(s) to use during installation. In all cases the primary public IPv4 address of your server is used.

How to

To fully understand the functionality of iPXE boot and explore the functionality, http://ipxe.org/ has extensive examples and documentation for creating boot environments.

To make use of this feature you will need to have your own HTTP infrastructure and provide the URI to the iPXE instructions. The version of iPXE LeaseWeb uses supports HTTP.


To tell us the location of your iPXE instructions, you can use the an API call to specify the bootFileName to http://1.1.1.1/boot.ipxe

For more details how to use the LeaseWeb API, check developer.leaseweb.com

POST /v1/bareMetals/{id}/leases
HOST: api.leaseweb.com
X-Lsw-Auth: 4e7d4f2d-e683-4192-a113-61dad6ac9a15

bootFileName="http://1.1.1.1/boot.ipxe"

Or you can click the  action on your server's management page in the customer portal:


When you reboot your server, the DHCP server will instruct your bare metal server to boot using that boot file name.

Example ipxe configurations:

Linux: http://1.1.1.1/boot.ipxe


#!ipxe
 
 dhcp
 kernel http://1.1.1.1/boot/x86_64/vmlinuz 
 initrd http://1.1.1.1/boot/x86_64/archiso.img

boot

Windows: http://1.1.1.1/boot.ipxe


#!ipxe
 
 dhcp
 kernel http://1.1.1.1/windows/wimboot
 initrd http://1.1.1.1/windows/boot/bcd         BCD
 initrd http://1.1.1.1/windows/boot/boot.sdi    boot.sdi
 initrd http://1.1.1.1/windows/sources/boot.wim boot.wim

boot


For more information on how to boot into a Windows installer refer to the ipxe.org documentation at http://ipxe.org/howto/winpe

See also

LeaseWeb Blog: Automatically provision your bare metal infrastructure



Keywords
You can click on any of the keywords below this article to see all related articles for that keyword