VCF on VxRail: Install NSX VIB Manually if Installation Fails on ESXi During the VCF Upgrade

Summary: This article explains how to Install NSX VIB Manually if the Installation Fails on ESXi during the VCF Upgrade.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

It is advised to follow the Broadcom article ESXi host in Not Ready state after major ESXi version upgradeThis hyperlink is taking you to a website outside of Dell Technologies.

If the above article does not fix the Issue, proceed with the steps shown below.

VIB:
A VIB is an ESXi software package. VMware and its partners package solutions, drivers, CIM providers, and applications that extend the ESXi platform as VIBs. VIBs are available in software depots. See VMware blog What is in a VIB?This hyperlink is taking you to a website outside of Dell Technologies. 

Image Profile: 
An image profile defines an ESXi image and consists of VIBs. An image profile always includes a base VIB and might include more VIBs.

Software Depot:
A software depot is a collection of VIBs and image profiles. The software depot is a hierarchy of files and folders and can be available through an HTTP URL (online depot) or a ZIP file (offline depot).

A VIB has three parts:

  • VIB: vSphere Installation BundleFile Archive - the main file - The file which gets deployed to the ESXi host.
  • XML descriptor file: This has important info about requirements for installing the VIB (dependencies, compatibility, reboot necessary?)
  • Signature File: Signature which verifies the level of trust (Integrity, Information about the creator and verification that has been done).

There are two methods for getting the NSX VIBs for manual installation.

See Broadcom article: Downloading NSX VIB bundles for ESXi hosts from NSX Manager AppliancesThis hyperlink is taking you to a website outside of Dell Technologies.

Once completed, place the host into maintenance mode and follow the standard instructions to install the VIBs manually on an ESXi host:

Additional Information

More Broadcom articles to review on this topic:

  • esxcli software VIB commands to update an ESXi 6.x or 7.x host

Patching ESXi host using Command LineThis hyperlink is taking you to a website outside of Dell Technologies.

  • NSX Troubleshooting

Host Fails to Install as Transport NodeThis hyperlink is taking you to a website outside of Dell Technologies.

Affected Products

VxRail, VxRail Appliance Series, VxRail E560 VCF, VxRail E560F VCF, VxRail E560N VCF, VxRail G560 VCF, VxRail G560F VCF, VxRail P570 VCF, VxRail P570F VCF, VxRail P580N VCF, VxRail S570 VCF, VxRail V570 VCF, VxRail V570F VCF
Article Properties
Article Number: 000218389
Article Type: How To
Last Modified: 23 Jun 2026
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.