Downgrading device drivers in VMware ESXi

Products

VMware vSphere ESXi

Issue/Introduction

This article provides the steps to downgrade a device driver in VMware ESXi.

Environment

VMware vSphere ESXi 6.5
VMware vSphere ESXi 5.0
VMware vSphere ESXi 6.0
VMware vSphere ESXi 5.1
VMware vSphere ESXi 5.5
VMware vSphere ESXi 6.7

Resolution

To downgrade a device driver, download the driver you want to install, uninstall the current driver, and then install the older driver.

For more information on installing device drivers, see How to download and install async drivers in ESXi 5.x/6.x

To obtain the driver installation bundle, remove the existing driver and install the new driver:

Download the driver version you want to downgrade to from VMware Download Page
Copy the offline bundle zip file to the ESXi host using the datastore browser.
Put the ESXi host in maintenance mode.

To put the ESXi host in maintenance mode, right-click the ESXi host and click Enter Maintenance Mode. Alternatively, run this command from the ESXi host command line:

# esxcli system maintenanceMode set --enable true
Run this command to ensure that the host is in maintenance mode:

# esxcli system maintenanceMode get

You see this output:

Enabled
Run this command to remove the current device driver:

# esxcli software vib remove -n <vendor vib name> -f

For example, when removing an HP driver, you see this result:

Message: The update completed successfully, but the system needs to be rebooted for the changes to be effective. Reboot Required: true VIBs Installed: VIBs Removed: Hewlett-Packard_bootbank_scsi-hpsa_5.5.0.58-1OEM.550.0.0.1331820 VIBs Skipped:

Note: The exact vendor vib name can be obtained by running the esxcli software vib list command and checking the output for the VIB related to the driver you want to remove.
Install the vib driver bundle that is downloaded and copied into the ESXi host in Step 1 and 2. Run this command to install the diver:

# esxcli software vib install -d <location of the zip file>

For example:

esxcli software vib install -d /vmfs/volumes/datastore/driver-offine_bundle.zip

After installation, you see output similar to:

Message: The update completed successfully, but the system needs to be rebooted for the changes to be effective. Reboot Required: true VIBs Installed: Hewlett-Packard_bootbank_scsi-hpsa_5.5.0.50-1OEM.550.0.0.1198611 VIBs Removed: VIBs Skipped:
Run this command to reboot the ESXi host:

# esxcli system shutdown reboot -r 'replace driver'
Run this command to check the result:

esxcli software profile get

For example, for HP device, you see output similar to:

Description: 2014-05-27T20:38:44.530790+00:00: The following VIBs are installed: scsi-hpsa 5.5.0.50-1OEM.550.0.0.1198611 ---------- 2014-05-27T20:35:30.656249+00:00: The following VIBs have been removed: scsi-hpsa 5.5.0.58-1OEM.550.0.0.1331820 ----------
Ensure that the correct driver downgrade is successful and the correct version is running, run this command on the ESXi host command line:

esxcli software vib get -n <driver name>

For example:

esxcli software vib get -n scsi-hpsa

You see output similar to:

Hewlett-Packard_bootbank_scsi-hpsa_5.5.0.50-1OEM.550.0.0.1198611 Name: scsi-hpsa Version: 5.5.0.50-1OEM.550.0.0.1198611 Type: bootbank Vendor: Hewlett-Packard Acceptance Level: VMwareCertified Summary: hpsa: scsi driver for VMware ESX Description: HP Smart Array SCSI Driver ReferenceURLs: Creation Date: 2013-08-19 Depends: vmkapi_2_2_0_0, com.vmware.driverAPI-9.2.2.0 Conflicts: Replaces: Provides: Maintenance Mode Required: True Hardware Platforms Required: Live Install Allowed: False Live Remove Allowed: False Stateless Ready: True Overlay: False Tags: driver, module Payloads: scsi-hps
After ensuring that the procedure is successful, exit maintenance mode. To exit maintenance mode using the vSphere Web Client, right-click and select Exit Maintenance mode.

Alternatively, run this command from the ESXi host command line:

# esxcli system maintenanceMode set --enable false
Run this command to ensure that the host is no longer in maintenance mode:

# esxcli system maintenanceMode get

You see this output:

Disabled

Additional Information

To find additional information about a specific driver, run this command:

esxcli software vib get -n <driver name>

For example, to get more information about the HP hpsa driver, run this command:

esxcli software vib get -n scsi-hpsa

You see output similar to:

Hewlett-Packard_bootbank_scsi-hpsa_5.5.0.58-1OEM.550.0.0.1331820
Name: scsi-hpsa
Version: 5.5.0.58-1OEM.550.0.0.1331820
Type: bootbank
Vendor: Hewlett-Packard
Acceptance Level: VMwareCertified
Summary: hpsa: scsi driver for VMware ESX
Description: HP Smart Array SCSI Driver
ReferenceURLs:
Creation Date: 2013-12-16
Depends: vmkapi_2_2_0_0, com.vmware.driverAPI-9.2.2.0
Conflicts:
Replaces:
Provides:
Maintenance Mode Required: True
Hardware Platforms Required:
Live Install Allowed: False
Live Remove Allowed: False
Stateless Ready: True
Overlay: False
Tags: driver, module

“esxcli software vib” commands to patch an ESXi 6.x/7.x host

How to download and install async drivers in ESXi 5.x/6.x
VMware ESXi 5.x でデバイスドライバをダウングレードする方法
将 VMware ESXi 5.x 中的设备驱动程序降级

Impact/Risks:
Do not downgrade driver unless suggested by the vendor. Ensure that you are aware of any caveats of downgrading the driver. For more information, see the related driver release notes in the vendors advisory.