Perform Update Precheck
You must perform a precheck
before applying an update or upgrade bundle to ensure that your environment is ready for the
update.
For an ESXi
bundle, the system performs a bundle level precheck in addition to the environment
precheck. For VI workload domains using vSphere Lifecycle Manager baselines, the
ESXi bundle precheck validates the following.
- Custom ISO is compatible with your environment.
- Custom ISO size is smaller than the boot partition size.
- Third party VIBs are compatible with the environment.
If you silence a vSAN Skyline Health
alert in the 
vSphere Client
, SDDC
Manager
skips the related precheck and indicates which precheck it skipped. Click
Restore Precheck
to include the silenced precheck. For
example:
You can also silence failed vSAN prechecks in the
SDDC Manager
UI
by clicking Silence
Precheck
. Silenced prechecks do not trigger warnings or block
upgrades. You
should only silence alerts if you know that they are incorrect. Do not silence
alerts for real issues that require remediation.
- In the navigation pane, click.
- On the Workload Domains page, click the workload domain where you want to run the precheck.
- On the domain summary page, click theUpdates/Patchestab. The image below is a sample screenshot and may not reflect the correct product versions.
- ClickPrecheckto validate that the environment is ready to be upgraded.Once the precheck begins, a message appears indicating the time at which the precheck was started.
- ClickView Statusto see detailed tasks and their status. The image below is a sample screenshot and may not reflect the correct versions.
- To see details for a task, click the Expand arrow.If a precheck task failed, fix the issue, and clickRetry Precheckto run the task again. You can also clickPrecheck Failed Resourcesto retry all failed tasks.
- If ESXi hosts display a driver incompatibility issue when updating a VI workload domain using vSphere Lifecycle Manager baselines, perform the following steps:
- Identify the controller with the HCL issue.
- For the given controller, identify the supported driver and firmware versions on the source and target ESXi versions.
- Upgrade the firmware, if required.
- Upgrade the driver manually on the ESXi host and retry the task at which the upgrade failed.
- If the workload domain contains a host that includes pinned VMs, the precheck fails at the Enter Maintenance Mode step. If the host can enter maintenance mode through vCenter Server UI, you can suppress this check for NSX-T Data Center and ESXi in VMware Cloud Foundation by following the steps below.
- Log in to SDDC Manager by using a Secure Shell (SSH) client with the user name vcf and password you specified in the deployment parameter workbook.
- Open the/opt/vmware/vcf/lcm/lcm-app/conf/application-prod.propertiesfile.
- Add the following line to the end of the file:lcm.nsxt.suppress.dry.run.emm.check=truelcm.esx.suppress.dry.run.emm.check.failures=true
- RestartLifecycle Managementby typing the following command in the console window.systemctl restart lcm
- AfterLifecycle Managementis restarted, run the precheck again.
The precheck result is displayed at the
top of the Upgrade Precheck Details window. If you click
Exit
Details
, the precheck result is displayed at the top of the Precheck
section in the Updates/Patches tab. Ensure that the precheck results are
green before proceeding. A failed precheck may cause the update to fail.