How to easily update your VMware Hypervisor from ESXi 6.5.x to 6.5.0d
Important Update - On Mar 20 2018, VMware VMSA-2018-0004.3 announced that CVE-2017-5715 (Spectre-2) mitigation is now included in the latest patch that you should be using instead of the older patch featured in the original article below. You'll find the newer article that features an even easier update method here:
- How to easily update your VMware Hypervisor from 6.x to 6.5 Update 1 Patch Release ESXi650-201803001 (ESXi Build 7967591) with Spectre mitigation
Article below as it originally appeared.
ESXi 6.5.0d | 18 APRIL 2017 | ISO Build 5310538
- vCenter/VCSA 6.5 should be upgraded to 6.5.0d before upgrading your host(s) to ESXi 6.5.0d Build 5310538, see:
How to easily update your VMware vCenter Server Appliance from VCSA 6.5 to 6.5.0d
Feb 07 2017
- I have only tested this method when upgrading from 6.5.0a Build 5224934 to Build 5310538, your experience from earlier 6.x versions may vary.
- I have been able to replicate a possible issue with the Xeon D 10GbE driver VIB after the upgrade, workaround completed, details below. There is also one report of a Xeon D 1GbE driver issue, he was able to recover by backing out.
- This is not official VMware documentation, it's merely a convenient upgrade technique that may help in lab tests, it's up to you to adhere to the backup-first advice detailed below.
All the background story on how this easy ESXCLI upgrade method came about was covered in my earlier articles about updating 6.0 U2 and 6.5.
If you're in production, beware, this code just came out today. This article is for the lab, where you may want to give this critical patch a try.
- No new license needed to go from 6.0.x or 6.5.x to 6.5.0d Build 5310538
- Users of the free hypervisor and folks who can't download the GA Offline bundle now have a path forward as well, without needing to read TinkerTry's My VMware's "You either are not entitled or do not have permissions to download this product." error, and what to do about it.
Once you've completed ALL of the following preparation steps:
- upgraded to VCSA 6.5.0d
- ensured your ESXi 6.5.x host has a working internet connection
- reviewed the release notes
- reviewed this VMSA-2017-0006 patch
- reviewed How to easily update your VMware Hypervisor to ESXi 6.0 Update 2 for the full back story that includes some warnings about potential gotchas/driver issues
- backed up the ESXi 6.5.x you've already got, if it's USB or SD, then use something like one of the home-lab-friendly methods such as USB Image Tools under Windows, as detailed by Florian Grehl here
you can now continue with this simple approach to upgrading your lab environment. Unsupported, at your own risk, see the full disclaimer at below left.
You should wind up with the same results after this upgrade as folks who upgrade by downloading the full ESXi 6.5.0d ISO and boot from it:
VMware vSphere Hypervisor (ESXi ISO) image (Includes VMware Tools)
File size: 331.09 MB
File type: iso
Release Date: 2017-04-18
Build Number: 5310538
Download and upgrade to 6.5.0d update using the patch directly from the VMware Online Depot
The entire process including reboot is usually well under 10 minutes. Triple-clicking on a line of code below highlights the whole thing, so you can then right-click and copy it into your clipboard:
- Open an SSH session (eg. PuTTY) to your ESXi 6.0.x server
(if you forgot to enable SSH, here's how)
- Turn on maintenance mode, or ensure you've set your ESXi host to automatically gracefully shutdown all VMs upon host reboot, or shutdown all the VMs gracefully that you care about, including VCSA.
- Firewall allow outbound http requests - Paste the one line below into into your SSH session, then press enter:
esxcli network firewall ruleset set -e true -r httpClient
More details about the firewall here.
- Pull down ESXi Image Profile using https and run patch script - Paste the line below into into your SSH session, then hit enter and wait while nothing seems to happen, taking somewhere between roughly 3 to 10 minutes before the completion screen (sample below) appears:
esxcli software profile install -p ESXi-6.5.0-20170404001-standard -d https://hostupdate.vmware.com/software/VUM/PRODUCTION/main/vmw-depot-index.xml
If this command fails, you may want to try changing
install, details below. Thanks Douglas! Wait time for the successful install depending mostly on the the speed of the ESXi's connection to the internet, and a little on the speed of the storage media that ESXi is installed on.
- If you have Xeon D X552/X557, to regain 10GbE driver VIB that works, consider using the easy one-liner fix described below. While I have not yet tested doing this before the reboot, Alastair did, and kindly left a comment below, noting that it worked fine.
- Firewall disallow outbound http requests - Paste the line below into into your SSH session:
esxcli network firewall ruleset set -e false -r httpClient
- If you turned on maintenance mode earlier, remember to turn maintenance mode off.
- If you normally leave SSH access off, go ahead and disable it now.
- Type reboot and hit return (to restart your ESXi server), or use your favorite ESXi UI to restart the host.
- After the reboot is done, it would be a good idea to test login using ESXi host client, pointing your browser to the IP or hostname of your just-graded server, to be sure everthing seems to be working right.
Special thanks to VMware ESXi Patch Tracker by Andreas Peetz at the VMware Front Experience Blog. This upgrade test was performed on a TinkerTry'd VMware HCL system. Yes, on both the very popular 8 core and the rather special 12 core version of the beloved Supermicro SuperServer SYS-5028D-TN4T system.
That's it! When the reboot is complete, you'll see for yourself that you now have the latest ESXi, Build 5310538, as pictured above. Now you have more spare time to read more TinkerTry articles!
Depending upon your ESXi firewall configuration, if the above command results in a network related error such as:
'NoneType' object has no attribute 'close'
then you skipped the firewall configuration step above, try again!
- Notice that the command recommended you use when clicking on the ESXi-6.5.0-20170304101-standard link at VMware ESXi Patch Tracker:
esxcli software profile update -p ESXi-6.5.0-20170404001-standard -d https://hostupdate.vmware.com/software/VUM/PRODUCTION/main/vmw-depot-index.xml
doesn't work, says:
Message: Host is not changed.
but simply changing from
installworked for me, but your results may vary. See also the interesting comment below.
Potential SATA and Realtek NIC gotcha
- If you find some of your SATA/AHCI datastores disappear from view after this upgrade, worry not, the VMFS datastores are still there, you just can't see them. This article should still save you:
For ESXi 6.0, those ESXi 5.1 VIBs for ASMedia SATA ports and Realtek NICs still seem to be working (but unsupported)
Mar 04 2015
Potential Intel Xeon D X552/X557 10GbE Driver gotcha
Apr 19 2017 Update
Getting past this issue was straight-forward, just re-installed my Intel's 4.5.1 X552/X557 10GbE VIB::
then rebooted. Everything working fine again.
Potential Intel Xeon D I-350 1GbE Driver gotcha
Added Apr 19 2017 Update
I haven't encountered this issue reported below, or been able to replicate it, but all the more reason to backup first.
Alternatively, you could have used VMware Update Manager on a Windows system or VM, but for one-off upgrades typical in a small home lab, pasting these 3 lines of code is pretty darn easy.
Looking ahead, since VUM is now built into VCSA 6.5, this will add another way to do future upgrades and patches, even in a small home lab environment.
Apr 19 2017 Update
Two new comments from TinkerTry visitors Alastair Mackinlay and Askar Kopbayev have been incorporated into the article above.
See also at TinkerTry
How to easily update your VMware Hypervisor from ESXi 6.5 to 6.5.0a Build 5224934 Advisory ID VMSA-2017-0006 - Critical Severity
Mar 31 2017
How to easily update your VMware Hypervisor from ESXi 6.x to 6.5.0a
Feb 03 2017
Order a TinkerTry'd Supermicro SuperServer Bundle - powerful and efficient home virtualization lab solutions
- VMware vSphere Taskbar Shortcuts Unleashed - profile switcher isolated and uncluttered Chrome Browser UIs act like native Windows apps!
VMware vSAN 6.6 GA - Download Links Available
Apr 18 2017 by Florian Grehl
ESXi 6.5 Release Notes for free license and white box users
Nov 24 2016 by Andreas Peetz at VMware Front Experience
VMware ESXi Patch Tracker
Nov 24 2016 by Andreas Peetz at VMware Front Experience
- VMware vSphere 6.5 Documentation Center - Upgrade or Update a Host with Image Profiles
Below, I've pasted the full text of my upgrade, helps you see what drivers were touched, use the horizonal scroll bar or shift + mousewheel to look around, Ctrl+F works as needed too:
login as: root Using keyboard-interactive authentication. Password: The time and date of this login have been sent to the system logs. VMware offers supported, powerful system administration tools. Please see www.vmware.com/go/sysadmintools for details. The ESXi Shell can be disabled by an administrative user. See the vSphere Security documentation for more information. [root@xd-1567-5028d:~] esxcli network firewall ruleset set -e true -r httpClient [root@xd-1567-5028d:~] esxcli software profile install -p ESXi-6.5.0-20170404001-standard -d https://hostupdate.vmware.com/software/VUM/PRODUCTION/main/vmw-depot-index.xml Installation Result Message: The update completed successfully, but the system needs to be rebooted for the changes to be effective. Reboot Required: true VIBs Installed: VMW_bootbank_net-ixgbe_188.8.131.52.14iov-20vmw.6184.108.40.20664106, VMware_bootbank_esx-base_6.5.0-0.19.5310538, VMware_bootbank_esx-ui_1.18.0-5270848, VMware_bootbank_vsan_6.5.0-0.19.5310540, VMware_bootbank_vsanhealth_6.5.0-0.19.5310541 VIBs Removed: INT_bootbank_net-ixgbe_4.5.1-1OEM.600.0.0.2494585, VMware_bootbank_esx-base_6.5.0-0.15.5224529, VMware_bootbank_esx-ui_1.15.0-5069532, VMware_bootbank_vsan_6.5.0-0.15.5224529, VMware_bootbank_vsanhealth_6.5.0-0.15.5224529 VIBs Skipped: VMW_bootbank_ata-libata-92_3.00.9.2-16vmw.6220.127.116.1164106, VMW_bootbank_ata-pata-amd_0.3.10-3vmw.618.104.22.16864106, VMW_bootbank_ata-pata-atiixp_0.4.6-4vmw.622.214.171.12464106, VMW_bootbank_ata-pata-cmd64x_0.2.5-3vmw.6126.96.36.19964106, VMW_bootbank_ata-pata-hpt3x2n_0.3.4-3vmw.6188.8.131.5264106, VMW_bootbank_ata-pata-pdc2027x_1.0-3vmw.6184.108.40.20664106, VMW_bootbank_ata-pata-serverworks_0.4.3-3vmw.6220.127.116.1164106, VMW_bootbank_ata-pata-sil680_0.4.8-3vmw.618.104.22.16864106, VMW_bootbank_ata-pata-via_0.3.3-2vmw.622.214.171.12464106, VMW_bootbank_block-cciss_3.6.14-10vmw.6126.96.36.19964106, VMW_bootbank_char-random_1.0-3vmw.6188.8.131.5264106, VMW_bootbank_ehci-ehci-hcd_1.0-4vmw.6184.108.40.20646846, VMW_bootbank_elxnet_220.127.116.11-1vmw.618.104.22.16864106, VMW_bootbank_hid-hid_1.0-3vmw.622.214.171.12464106, VMW_bootbank_i40en_1.1.0-1vmw.6126.96.36.19964106, VMW_bootbank_igbn_0.1.0.0-12vmw.6188.8.131.5264106, VMW_bootbank_ima-qla4xxx_2.02.18-1vmw.6184.108.40.20664106, VMW_bootbank_ipmi-ipmi-devintf_39.1-4vmw.6220.127.116.1164106, VMW_bootbank_ipmi-ipmi-msghandler_39.1-4vmw.618.104.22.16864106, VMW_bootbank_ipmi-ipmi-si-drv_39.1-4vmw.622.214.171.12464106, VMW_bootbank_ixgben_126.96.36.199-9vmw.6188.8.131.5246846, VMW_bootbank_lpfc_184.108.40.206-1vmw.6220.127.116.1164106, VMW_bootbank_lsi-mr3_6.910.18.00-1vmw.618.104.22.16864106, VMW_bootbank_lsi-msgpt2_20.00.01.00-3vmw.622.214.171.12464106, VMW_bootbank_lsi-msgpt3_12.00.02.00-11vmw.6126.96.36.19964106, VMW_bootbank_misc-cnic-register_1.78.75.v60.7-1vmw.6188.8.131.5264106, VMW_bootbank_misc-drivers_6.5.0-0.14.5146846, VMW_bootbank_mtip32xx-native_3.9.5-1vmw.6184.108.40.20664106, VMW_bootbank_ne1000_0.8.0-11vmw.6220.127.116.1146846, VMW_bootbank_nenic_18.104.22.168-1vmw.622.214.171.12464106, VMW_bootbank_net-bnx2_2.2.4f.v60.10-2vmw.6126.96.36.19964106, VMW_bootbank_net-bnx2x_1.78.80.v60.12-1vmw.6188.8.131.5264106, VMW_bootbank_net-cdc-ether_1.0-3vmw.6184.108.40.20664106, VMW_bootbank_net-cnic_1.78.76.v60.13-2vmw.6220.127.116.1164106, VMW_bootbank_net-e1000_18.104.22.168-5vmw.622.214.171.12464106, VMW_bootbank_net-e1000e_126.96.36.199-2vmw.6188.8.131.5264106, VMW_bootbank_net-enic_184.108.40.206-2vmw.6220.127.116.1164106, VMW_bootbank_net-fcoe_18.104.22.168.3-7vmw.622.214.171.12464106, VMW_bootbank_net-forcedeth_0.61-2vmw.6126.96.36.19964106, VMW_bootbank_net-igb_188.8.131.52.1-5vmw.6184.108.40.20664106, VMW_bootbank_net-libfcoe-92_220.127.116.11.4-8vmw.618.104.22.16864106, VMW_bootbank_net-mlx4-core_22.214.171.124-1vmw.6126.96.36.19964106, VMW_bootbank_net-mlx4-en_188.8.131.52-1vmw.6184.108.40.20664106, VMW_bootbank_net-nx-nic_5.0.621-5vmw.6220.127.116.1164106, VMW_bootbank_net-tg3_3.131d.v60.4-2vmw.618.104.22.16864106, VMW_bootbank_net-usbnet_1.0-3vmw.622.214.171.12464106, VMW_bootbank_net-vmxnet3_126.96.36.199-3vmw.6188.8.131.5264106, VMW_bootbank_nhpsa_2.0.6-3vmw.6184.108.40.20664106, VMW_bootbank_nmlx4-core_220.127.116.11-1vmw.618.104.22.16864106, VMW_bootbank_nmlx4-en_22.214.171.124-1vmw.6126.96.36.19964106, VMW_bootbank_nmlx4-rdma_188.8.131.52-1vmw.6184.108.40.20664106, VMW_bootbank_nmlx5-core_220.127.116.11-1vmw.618.104.22.16864106, VMW_bootbank_ntg3_22.214.171.124-1vmw.6126.96.36.19964106, VMW_bootbank_nvme_188.8.131.52-2vmw.6184.108.40.20664106, VMW_bootbank_nvmxnet3_220.127.116.11-1vmw.618.104.22.16864106, VMW_bootbank_ohci-usb-ohci_1.0-3vmw.622.214.171.12464106, VMW_bootbank_pvscsi_0.1-1vmw.6126.96.36.19964106, VMW_bootbank_qedentv_188.8.131.52-1vmw.6184.108.40.20664106, VMW_bootbank_qfle3_220.127.116.11-1vmw.618.104.22.16864106, VMW_bootbank_qflge_22.214.171.124-1vmw.6126.96.36.19964106, VMW_bootbank_qlnativefc_188.8.131.52-11vmw.6184.108.40.20664106, VMW_bootbank_sata-ahci_3.0-22vmw.6220.127.116.1164106, VMW_bootbank_sata-ata-piix_2.12-10vmw.618.104.22.16864106, VMW_bootbank_sata-sata-nv_3.5-4vmw.622.214.171.12464106, VMW_bootbank_sata-sata-promise_2.12-3vmw.6126.96.36.19964106, VMW_bootbank_sata-sata-sil24_1.1-1vmw.6188.8.131.5264106, VMW_bootbank_sata-sata-sil_2.3-4vmw.6184.108.40.20664106, VMW_bootbank_sata-sata-svw_2.3-3vmw.6220.127.116.1164106, VMW_bootbank_scsi-aacraid_18.104.22.168-9vmw.622.214.171.12464106, VMW_bootbank_scsi-adp94xx_126.96.36.199-6vmw.6188.8.131.5264106, VMW_bootbank_scsi-aic79xx_3.1-5vmw.6184.108.40.20664106, VMW_bootbank_scsi-bnx2fc_1.78.78.v60.8-1vmw.6220.127.116.1164106, VMW_bootbank_scsi-bnx2i_2.78.76.v60.8-1vmw.618.104.22.16864106, VMW_bootbank_scsi-fnic_22.214.171.124-3vmw.6126.96.36.19964106, VMW_bootbank_scsi-hpsa_188.8.131.52-1vmw.6184.108.40.20664106, VMW_bootbank_scsi-ips_7.12.05-4vmw.6220.127.116.1164106, VMW_bootbank_scsi-iscsi-linux-92_18.104.22.168-3vmw.622.214.171.12464106, VMW_bootbank_scsi-libfc-92_126.96.36.199.3-5vmw.6188.8.131.5264106, VMW_bootbank_scsi-megaraid-mbox_184.108.40.206-6vmw.6220.127.116.1164106, VMW_bootbank_scsi-megaraid-sas_6.603.55.00-2vmw.618.104.22.16864106, VMW_bootbank_scsi-megaraid2_2.00.4-9vmw.622.214.171.12464106, VMW_bootbank_scsi-mpt2sas_19.00.00.00-1vmw.6126.96.36.19964106, VMW_bootbank_scsi-mptsas_4.23.01.00-10vmw.6188.8.131.5264106, VMW_bootbank_scsi-mptspi_4.23.01.00-10vmw.6184.108.40.20664106, VMW_bootbank_scsi-qla4xxx_5.01.03.2-7vmw.6220.127.116.1164106, VMW_bootbank_shim-iscsi-linux-9-2-1-0_6.5.0-0.0.4564106, VMW_bootbank_shim-iscsi-linux-9-2-2-0_6.5.0-0.0.4564106, VMW_bootbank_shim-libata-9-2-1-0_6.5.0-0.0.4564106, VMW_bootbank_shim-libata-9-2-2-0_6.5.0-0.0.4564106, VMW_bootbank_shim-libfc-9-2-1-0_6.5.0-0.0.4564106, VMW_bootbank_shim-libfc-9-2-2-0_6.5.0-0.0.4564106, VMW_bootbank_shim-libfcoe-9-2-1-0_6.5.0-0.0.4564106, VMW_bootbank_shim-libfcoe-9-2-2-0_6.5.0-0.0.4564106, VMW_bootbank_shim-vmklinux-9-2-1-0_6.5.0-0.0.4564106, VMW_bootbank_shim-vmklinux-9-2-2-0_6.5.0-0.0.4564106, VMW_bootbank_shim-vmklinux-9-2-3-0_6.5.0-0.0.4564106, VMW_bootbank_uhci-usb-uhci_1.0-3vmw.618.104.22.16864106, VMW_bootbank_usb-storage-usb-storage_1.0-3vmw.622.214.171.12464106, VMW_bootbank_usbcore-usb_1.0-3vmw.6126.96.36.19964106, VMW_bootbank_vmkata_0.1-1vmw.6188.8.131.5264106, VMW_bootbank_vmkplexer-vmkplexer_6.5.0-0.0.4564106, VMW_bootbank_vmkusb_0.1-1vmw.6184.108.40.20646846, VMW_bootbank_vmw-ahci_1.0.0-34vmw.6220.127.116.1146846, VMW_bootbank_xhci-xhci_1.0-3vmw.618.104.22.16864106, VMware_bootbank_cpu-microcode_6.5.0-0.0.4564106, VMware_bootbank_emulex-esx-elxnetcli_22.214.171.124-0.0.4564106, VMware_bootbank_esx-dvfilter-generic-fastpath_6.5.0-0.0.4564106, VMware_bootbank_esx-tboot_6.5.0-0.0.4564106, VMware_bootbank_esx-xserver_6.5.0-0.0.4564106, VMware_bootbank_lsu-hp-hpsa-plugin_2.0.0-3vmw.6126.96.36.19964106, VMware_bootbank_lsu-lsi-lsi-mr3-plugin_1.0.0-7vmw.6188.8.131.5264106, VMware_bootbank_lsu-lsi-lsi-msgpt3-plugin_1.0.0-6vmw.6184.108.40.20664106, VMware_bootbank_lsu-lsi-megaraid-sas-plugin_1.0.0-7vmw.6220.127.116.1164106, VMware_bootbank_lsu-lsi-mpt2sas-plugin_2.0.0-5vmw.618.104.22.16864106, VMware_bootbank_native-misc-drivers_6.5.0-0.0.4564106, VMware_bootbank_rste_2.0.2.0088-4vmw.622.214.171.12464106, VMware_bootbank_vmware-esx-esxcli-nvme-plugin_126.96.36.199-0.0.4564106, VMware_locker_tools-light_6.5.0-0.0.4564106 [root@xd-1567-5028d:~] esxcli network firewall ruleset set -e false -r httpClient [root@xd-1567-5028d:~] reboot