Search the VMware Knowledge Base (KB)
View by Article ID

Dealing with vSAN VIB issues in ESXi 6.0 Update 2 and later (2144595)

  • 13 Ratings

Details

With the introduction of vSAN (formerly known as Virtual SAN) 6.2 along with ESXi 6.0 Update 2, a new VIB called vsan.vib is shipped.

The new vsan VIB has a close dependency with the esx-base and the vsanhealth VIBs. As a result of this, a tight coupling is being introduced between esx-base, vsan, and vsanhealth VIBs to maintain them in lock-step from ESXi 6.0 Update 2 onwards.

Due to this new lock-step being introduced between these VIBS, there are some expected failures with commands used for ESXi upgrades.

This article provides details and samples of various methods that you might use when deploying the ESXi 6.0 Update 2 patch or create a customized ESXi 6.0 Update 2 image.
  • ESXCLI Software command

    EXPECTED ERROR: Attempts to update hosts to ESXi 6.0 Update 2 using the following vib update commands fail:

    esxcli software vib update -d <location of zip file>
    esxcli software vib update -n esx-base -d <location of zip file>

    ERROR MESSAGE:

    [DependencyError]
    VIB VMware_bootbank_esx-base_6.0.0-2.34.xxxxx requires vsan << 6.0.0-2.35, but the requirement cannot be satisfied within the ImageProfile.
    VIB VMware_bootbank_esx-base_6.0.0-2.34.xxxxxx requires vsan >= 6.0.0-2.34, but the requirement cannot be satisfied within the ImageProfile.
    Please refer to the log file for more details.
    [root@localhost:~]

    REASON: The reason for the command failure is that the esxcli vib update command is used to update the existing VIBs. As the vsan VIB is newly introduced in ESXi 6.0 Update 2, the esxcli command will skip updating the vsan VIB in turn resulting in a dependency violation error message.
  • PowerCLI command

    EXPECTED ERROR: Attempts to create a customized Image Profile or a customized ISO image with specific vibs using PowerCLI command similar to the following might fail:

    PowerCLI C:\> New-EsxImageProfile -NewProfile -Name CustomImage-ESXi-60u2 -Vendor “VMware Partner” -SoftwarePackage esx-base -AcceptanceLevel PartnerSupported

    ERROR MESSAGE SEEN

    New-EsxImageProfile : VIB VMware_bootbank_esx-base_6.0.0-2.34.3620759 requires vsan << 6.0.0-2.35, but the requirement cannot be satisfied within the ImageProfile. However, additional VIB(s) VMware_bootbank_vsan_6.0.0-2.34.3563498 from depot can satisfy this requirement.
    At line:1 char:1
    + New-EsxImageProfile -NewProfile -Name CustomImage-ESXi-60u2 -Vendor “VMware Partner” ...
    + ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo : InvalidData: (VMware.ImageBuilder.Types.ImageProfile:ImageProfile) [New-EsxImageProfile], Exception
    + FullyQualifiedErrorId : EsxImageProfileValidationError,VMware.ImageBuilder.Commands.NewImageProfile

    New-EsxImageProfile : VIB VMware_bootbank_esx-base_6.0.0-2.34.3620759 requires vsan >= 6.0.0-2.34, but the requirement cannot be satisfied within the ImageProfile. However, additional VIB(s) VMware_bootbank_vsan_6.0.0-2.34.3563498 from depot can satisfy this requirement.

  • ESXi Patch using vSphere Update Manager (VUM)

    There is no impact when deploying ESXi 6.0 Update 2 using the vSphere Update Manager.

  • Update or Upgrade using ESXi the Installer:

    There is no impact when you update or upgrade pre-6.0 Update 2 host.

    Note: Similar to the esx-base, vsan, and vsanhealth VIBs, the misc-drivers, ehci-ehci-hcd, xhci-xhci VIBs are also interdependent on each other.

Solution

To resolve this issue for the different commands, run the commands as shown below:
  • ESXCLI Software Command

    • To resolve this issue, run this command:

      Run the esxcli software sources profile list -d <location_of_the_esxi_zip_bundle_on_the_datastore> command to query the list of available image profiles.

      Run the esxcli software profile update - p <profile name> -d <location of ZIP file> command on the ESXi 6.0 Update 2 depot. For example:

      [root@localhost:~] esxcli software profile update -p < profile name> -d /vmfs/volumes/datastore1/update-from-esxi6.0-6.0_update02.zip

    • To resolve the issue with updating esx-base VIB, run this command:

      Run the esxcli software vib install -n esx-base -n vsan -n vsanhealth -d <location of ZIP file> command on the ESXi 6.0 Update 2 depot. For example:

      [root@localhost:~] esxcli software vib install -n esx-base -n vsan -n vsanhealth -d /vmfs/volumes/datastore1/update-from-esxi6.0 6.0_update02.zip

  • PowerCLI Command

    To resolve the issue:

    1. Add the ESXi 6.0 Update 2 zip bundle as a depot to PowerCLI. For example:

      PowerCLI C:\> Add-EsxSoftwareDepot <location of the update-from-esxi6.0-6.0_update02.zip>

    2. Create an image profile which satisfies esx-base VIB and its dependencies. For example:

      PowerCLI C:\< New-EsxImageProfile -NewProfile -Name 60u2-customImage -SoftwarePackage esx-base, vsan, vsanhealth -Vendor "VMware, Inc." -AcceptanceLevel PartnerSupported

    3. Export the custom image profile into a customized ISO or a ZIP bundle. For example:

      Export-EsxImageProfile -ImageProfile 60u2-customImage -ExportToIso -FilePath c:\ESXi-60u2-customImage.iso

      Or

      Export-EsxImageProfile -ImageProfile 60u2-customImage -ExportToBundle -FilePath c:\ESXi-60u2-customImage.zip

  • Patch ESXi through vSphere Update Manager

    There is no impact when deploying ESXi 6.0 Update 2 using the vSphere Update Manager.

  • Update or Upgrade using the ESXi Installer

    You can use the ISO update or upgrade for existing ESXi host using ESXi Update two 2 ISO file - VMware-VMvisor-Installer-6.0.0.update02-3620759.x86_64.iso. No dependency issue is be observed as the entire 6.0 Update 2 image is handled by the Installer.

    For further details regarding the patching process and best practices, see:

Additional Information

For translated versions of this article, see:

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.

Feedback

  • 13 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)




Please enter the Captcha code before clicking Submit.
  • 13 Ratings
Actions
KB: