Installing VMware ESXi 5.5 on the Gigabyte Brix

Scope

This article covers the steps required to install VMware ESXi 5.5 on the Gigabyte Brix, and a few other systems that use non-supported NICs that worked in ESXi 5.1.

Background

The driver for the Realtek RTL8111E gigabit NIC was included in the default ESXi 5.1 install ISO. Sadly, with the release of ESXi 5.5, the driver is no longer included, so we have to add it ourselves.

The good news is that this is fairly easy, and should also allow anyone with an RTL8111 NIC or a RTL8168 NIC to install VMware ESXi 5.5 successfully. I can confirm it works on the Gigabyte Brix.

Pre-requisites

You will need PowerCLI 5.5

Steps

Here’s what I did, using PowerCLI:

Add-EsxSoftwareDepot https://hostupdate.vmware.com/software/VUM/PRODUCTION/main/vmw-depot-index.xml
New-EsxImageProfile -CloneProfile "ESXi-5.5.0-1331820-standard" -name "ESXi-5.5.0-1331820-GigabyteBrix" -Vendor "TwistedEthics.com"
Add-EsxSoftwarePackage -ImageProfile "ESXi-5.5.0-1331820-GigabyteBrix" -SoftwarePackage "net-r8168"
Export-ESXImageProfile -ImageProfile "ESXi-5.5.0-1331820-GigabyteBrix" -ExportToISO -filepath C:\Users\Phil\Downloads\ESXi-5.5.0-1331820-GigabyteBrix.iso

Note, you may need to run this command from PowerCLI before running the above (Thanks to Tom for mentioning this in the comments!):

Add-PSSnapin VMware.ImageBuilder

Per Andreas Peetz’s excellent post on upgrading, there may be other non-supported driver bundles you’d like to install in addition to net-r8168, though I have not tested these:

• net-r8169
• net-sky2
• net-s2io

Update 2013-09-24: Andreas just released a new post that covers adding support for all the missing unsupported drivers.

After running the commands above PowerCLI will start downloading the offline bundle from VMware.com and then write the ISO file to your selected destination.

Next, I used Unetbootin to write that ISO file to a USB stick, and then booted from the USB stick to install ESXi 5.5.

What did those PowerCLI commands do?

Here’s roughly what you just ran:

1. Add VMware’s repository
2. Make a copy of the image called ESXi-5.5.0-1331820-standard and clone that to a new image called ESXi-5.5.0-1331820-GigabyteBrix
3. Add the net-r8168 driver, which is stilll on VMware’s servers, but not in the standard ESXi 5.5 install.
4. Export the custom image to an ISO file

Bootnote

This took me quite a while to research, as I had no idea at the time that the r8168 driver provided the RTL8111E driver too (and I had no way to double-check as my Brix was at home  ). Fortunately, VMware still seem to provide the net-r8168 VIB on their repository, so while it’s easy to fix, it’s a shame that VMware have removed the driver in 5.5.