ERROR: "UC is not updated on node" when performing prechecks on manager upgrade
search cancel

ERROR: "UC is not updated on node" when performing prechecks on manager upgrade

book

Article ID: 403863

calendar_today

Updated On:

Products

VMware NSX

Issue/Introduction

  • The following error is encountered when performing prechecks on NSX Manager upgrade:
    UC is not updated on node <HOSTNAME>-<IP>. Please upload upgrade bundle and trigger Begin Upgrade on one of these nodes to ensure the version of UC is same across all MP nodes.
  • A .pub file was utilized to perform pre-upgrade checks.

Environment

VMware NSX

Cause

The upgrade coordinator service (UC) is updated during the precheck task that is performed by a .pub file in the first section of the upgrade UI. If an appliance node is redeployed or was in a disconnected state when the .pub was first uploaded and ran it will be out of sync with the remaining nodes.

The following API call can be ran from inside NSX Manager to confirm the issue:

curl -k -u 'admin:<PASSWORD>' -H "Content-Type: application/json" -X GET https://<MANAGER_NODE_IP>/api/v1/upgrade/summary

Expected Output for an In Sync Node:

  "system_version" : "3.2.2.0.0.20737185",
  "upgrade_coordinator_version" : "4.1.1.0.0.22224317",
  "pre_upgrade_bundle_version" : "4.1.1.0.0.22224312",
  "upgrade_status" : "PAUSED",
  "target_version" : "4.1.1.0.0.22224312",
  "upgrade_bundle_file_name" : "VMware-NSX-upgrade-bundle-4.1.1.0.0.22224312.mub",
  "component_target_versions" : [ {
    "component_type" : "EDGE",
    "target_version" : "4.1.1.0.0.22224325"
  }, {
    "component_type" : "HOST",
    "target_version" : "4.1.1.0.0.22224315"
  }, {
    "component_type" : "MP",
    "target_version" : "4.1.1.0.0.22224317"
  } ],
  "upgrade_coordinator_updated" : true

Output for an Out Of Sync Node:

  "system_version" : "3.2.2.0.0.20737185",
  "upgrade_coordinator_version" : "3.2.2.0.0.20737190",
  "upgrade_status" : "PAUSED",
  "target_version" : "4.1.1.0.0.22224312",
  "component_target_versions" : [ {
    "component_type" : "EDGE",
    "target_version" : "4.1.1.0.0.22224325"
  }, {
    "component_type" : "HOST",
    "target_version" : "4.1.1.0.0.22224315"
  }, {
    "component_type" : "MP",
    "target_version" : "4.1.1.0.0.22224317"
  } ],
  "upgrade_coordinator_updated" : false

Resolution

Within the NSX upgrade UI, upload the .pub (precheck upgrade bundle) once more into the upgrade workflow, this will trigger the UC update across all the manager nodes to bring them back into sync.

Additional Information

Powered by Wolken Software