VMware Cloud Foundation 5.2

PDF
5.2 5.1 5.0 4.5
Français English

Perform Update Precheck in SDDC Manager

You must perform a precheck in SDDC Manager before applying an update bundle to ensure that your environment is ready for the update.
Bundle-level pre-checks for vCenter are available in
VMware Cloud Foundation
.
Because ESXi bundle-level pre-checks only work in minor-version upgrades (for example: from ESXi 7.x through 7.y, or from ESXi 8.x through 8.y), these prechecks do not run in
VMware Cloud Foundation
.
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:An example of an alert that was silenced in vSAN Skyline Health.
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.
Only silence alerts if you know that they are incorrect. Do not silence alerts for real issues that require remediation.
  1. In the navigation pane, click
    Inventory
    Workload Domains
    .
  2. On the Workload Domains page, click the workload domain where you want to run the precheck.
  3. On the domain summary page, click the
    Updates
     tab.
    (The following image is a sample screenshot and may not reflect current product versions.)
    This screenshot is the management domain summary page. The Updates tab is selected, and the most recent precheck information is shown
    It is recommended that you Precheck your workload domain prior to performing an upgrade.
  4. Click
    RUN PRECHECK
     to select the components in the workload domain you want to precheck.
    1. You can select to run a Precheck only on vCenter or the vSphere cluster. All components in the workload domain are selected by default. To perform a precheck on certain components, choose
      Custom selection
      .
      All components are selected to precheck.
    2. If there are pending upgrade bundles available, then the "Target Version" dropdown contains "General Upgrade Readiness" and the available
      VMware Cloud Foundation
       versions to upgrade to. If there is an available
      VMware Cloud Foundation
       upgrade version, there will be extra checks - bundle-level prechecks for hosts, vCenter Server, and so forth. The version specific prechecks will only run prechecks on components that have available upgrade bundles downloaded."Target Version" dropdown
  5. When the precheck begins, a progress message appears indicating the precheck progress and the time when the precheck began.
    Precheck shows In Progress and is 72% completed, along with the date and time when Precheck was started.
    Parallel precheck workflows are supported. If you want to precheck multiple domains, you can repeat steps 1-5 for each of them without waiting for step 5 to finish.
  6. Once the Precheck is complete, the report appears. Click through
    ALL
    ,
    ERRORS
    ,
    WARNINGS
    , and
    SILENCED
     to filter and browse through the results.
    Precheck report shows the number of resources that passed, errors, warnings, and silenced.
  7. To see details for a task, click the expander arrow.
    If a precheck task failed, fix the issue, and click
    Retry Precheck
     to run the task again. You can also click
    RETRY ALL FAILED RESOURCES
     to retry all failed tasks.
  8. If ESXi hosts display a driver incompatibility issue when updating a VI workload domain using vSphere Lifecycle Manager baselines, perform the following steps:
    1. Identify the controller with the HCL issue.
    2. For the given controller, identify the supported driver and firmware versions on the source and target ESXi versions.
    3. Upgrade the firmware, if required.
    4. Upgrade the driver manually on the ESXi host and retry the task at which the upgrade failed.
  9. 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
     and ESXi in VMware Cloud Foundation by following the steps below.
    1. Log in to SDDC Manager by using a Secure Shell (SSH) client with the user name vcf and password.
    2. Open the
      /opt/vmware/vcf/lcm/lcm-app/conf/application-prod.properties
       file.
    3. Add the following line to the end of the file:
      lcm.nsxt.suppress.dry.run.emm.check=true
      lcm.esx.suppress.dry.run.emm.check.failures=true
    4. Restart
      Lifecycle Management
       by typing the following command in the console window.
      systemctl restart lcm
    5. After
      Lifecycle Management
       is 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 tab.
Ensure that the precheck results are green before proceeding. Although a failed precheck will not prevent the upgrade from proceeding, it may cause the update to fail.

Content feedback and comments