ESX/ESXi Express Patch or debug driver rollback instructions
search cancel

ESX/ESXi Express Patch or debug driver rollback instructions

book

Article ID: 324630

calendar_today

Updated On:

Products

VMware

Issue/Introduction

Symptoms:
This article provides the concepts, procedure, and commands generally useful for rollback situations. For illustration, VMware released Express Patch for ESX/ESXi 4.1 is used. For more information about the patch, see VMware ESX 4.1 Patch Release ESX410-201011001 (1029400) or VMware ESXi 4.1 Patch Release ESXi 410-201011001 (1029401).
If you are running a debug driver (bnx2x), you must roll back to the ESX/ESXi 4.1 GA version of the driver before applying the Express Patch. This driver is manually installed because it is not part of the GA package. If you did not manually install this driver, you can ignore this article.
ESX
Run this command to check which version of the driver you are currently using:
# rpm -qa | grep -i bnx2x
If the output contains the word debug, you must remove this driver and install the ESX/ESXi 4.1 GA driver. For more information, see Rollback procedure for ESX in the Resolution section.
The output might be similar to:
vmware-esx-drivers-net-bnx2x-400.1.54.1.v41.1- debug7vmw.0.0.00000.x86_64.rpm
ESXi
Run this command to check which version of the driver you are currently using:
# esxupdate query --v | grep -i bnx2x
If the output contains the word debug, see the Rollback procedure for ESXi section in the Resolution section.
The output might be similar to:
vmware-esx-drivers-net-bnx2x_400.1.54.1.v41.1- debug7vmw.0.0.00000
Note: If you are running ESX 4.1 GA (build# 260247), you can install the Express Patch without performing any other actions. The KB article VMware ESX/ESXi 4.1 host with Broadcom bnx2x (in-box driver version 1.54.1.v41.1-1vmw) experiences a loss of network connectivity and a purple diagnostic screen (1029368) provides a workaround to disable IPv6 Checksum. If you implement this workaround, you do not have to re-enable IPv6 Checksum before installing the Express Patch. There boot step during the patch installation automatically resets IPv6 Checksum back to its default enabled state.


Resolution

Rollback procedure for ESX

To remove the debug driver, run the command:

# rpm -e name_of_the_driver_rpm

For example:

# rpm -e vmware-esx-drivers-net-bnx2x-400.1.54.1.v41.1-debug7vmw.0.0.00000.x86_64.rpm
To install the ESX 4.1 GA version:
  1. Run the command:

    # rpm -Uvh --force --nodeps vmware-esx-drivers-net-bnx2x-400.1.54.1.v41.1-1vmw.0.0.260247.x86_64.rpm

  2. Reboot for the changes to take effect. Run the commands:

    # esxcfg-boot -b
    # reboot

Rollback procedure for ESXi

ESXi permits only one level of rollback. If you reboot your host successfully after applying the debug driver and did not perform any additional ESXi software updates, you can rollback to the previous state. If you completed additional ESXI software updates since applying the debug driver, then you must re-install ESXi.
To rollback to the previous state:
  1. Reboot the ESXi 4.1 host.
  2. Press Shift+r when the screen displays Loading VMware Hypervisor.
  3. Press Y to continue.
  4. Press Enter. The host rolls back to the previous state.

    Note: Press ESC to view the log.PressESC again to return to this screen.

    To confirm that the bnx2x driver of ESX/ESXi 4.1 GA is installed and that the debug driver vib is uninstalled, run the command:

    ~ # esxupdate query --v | grep -i bnx2x
    deb_vmware-esx-drivers-net-bnx2x_400.1.54.1.v41.1-1vmw.0.0.260247 installed <YYYY-MM-DD>T<time>+00:00
    deb_vmware-esx-drivers-net-bnx2_400.2.0.7d-2vmw.0.0.260247 installed <YYYY-MM-DD>T<time>+00:00
    deb_vmware-esx-drivers-scsi-bnx2i_400.1.8.11t5.rc2.8.1-3vmw.0.0.260247 installed <YYYY-MM-DD>T<time>+00:00
    cross_vmware-esx-drivers-net-bnx2x_400.1.54.1.v41.1-debug7vmw.0.0.00000 uninstalled <YYYY-MM-DD>T<time>.404870+00:00
    ~ # </time></time></time></time>

Note: In ESXi 5.5 and later, use this command to display vibs installed:

esxcli software vib list | grep -i bnx2x

This command displays bnx2x drivers installed.

Note: The preceding log excerpts are only examples. Date, time, and environmental variables may vary depending on your environment.


Additional Information

ESX/ESXi Express Patch またはデバッグ ドライバのロールバック手順