Handling Dependency Errors During ESXi Upgrade (7.x → 8.x)

From Notes_Wiki

Home > VMWare platform > VMWare vSphere or ESXi > Creating Handling Dependency Errors During ESXi Upgrade (7.x → 8.x)


Handling Dependency Errors (VIB) During ESXi Upgrade (7.x → 8.x)

When upgrading from ESXi 7.x to 8.x, you may encounter dependency errors due to incompatible third-party OEM VIBs (e.g., Dell drivers/utilities).

Below is an example error: 

[DependencyError]
On platform embeddedEsx, VIB DEL_bootbank_dell-fac-dcui_7.0.3-A02 requires esx-version << 8.0, but the requirement cannot be satisfied within the ImageProfile.
On platform embeddedEsx, VIB DEL_bootbank_dell-osname-idrac_7.0.0-A01 requires esx-version <= 8.0, but the requirement cannot be satisfied within the ImageProfile.
On platform embeddedEsx, VIB DEL_bootbank_dell-configuration-vib_7.0.0-A02 requires esx-version <= 8.0, but the requirement cannot be satisfied within the ImageProfile.

This means certain Dell VIBs are incompatible with ESXi 8.x and must be removed before the upgrade.

Steps to Uninstall Incompatible VIBs (Third-Party Drivers)

Prerequisite: Enable Maintenance Mode and SSH service on the ESXi host.

1. Identify the problematic VIB(s)

To list all installed VIBs on the host: 

# esxcli software vib list

To search for a specific Dell VIB (based on the upgrade error message): 

# esxcli software vib list | grep -i dell-fac-dcui

Repeat for other VIBs such as:

  • dell-osname-idrac
  • dell-configuration-vib

2. Remove the VIB

Use the following command to uninstall the VIB: 

# esxcli software vib remove --vibname=<name>

Example: 

# esxcli software vib remove --vibname=dell-fac-dcui

If multiple versions of the same VIB exist, specify the version along with the name: 

# esxcli software vib remove --vibname=<name>:<version>
# esxcli software vib remove --vibname=dell-fac-dcui:7.0.3-A02

3. Check the Output

A successful removal will display output similar to: 

Removal 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: DEL_bootbank_dell-fac-dcui_7.0.3-A02
   VIBs Skipped:

4. Reboot if Required

If "Reboot Required" is true, restart the host: 

# reboot

5. Exit Maintenance Mode

Once the host reboots (or immediately, if no reboot is required), exit maintenance mode.

From vCenter/ESXi web client:

  • Right-click on the host → Exit Maintenance Mode

From CLI: 

# esxcli system maintenanceMode set --enable false

6. Confirm Removal

After the host is back online, verify the VIB has been removed: 

# esxcli software vib list | grep -i <VIB name>


Once all incompatible VIBs are removed and the host is rebooted (if required), now you can continue with the ESXi upgrade process to version 8.x.



Home > VMWare platform > VMWare vSphere or ESXi > Creating Handling Dependency Errors During ESXi Upgrade (7.x → 8.x)

Retrieved from "http://www.sbarjatiya.com/notes_wiki/index.php?title=Handling_Dependency_Errors_During_ESXi_Upgrade_(7.x_→_8.x)&oldid=9415"