[HCX] OSAM Sentinel software remains listed as installed on VMs where it was uninstalled
search cancel

[HCX] OSAM Sentinel software remains listed as installed on VMs where it was uninstalled

book

Article ID: 414599

calendar_today

Updated On:

Products

VMware HCX

Issue/Introduction

  • You have uninstalled/removed the Sentinel Agent from a VM after rolling back or canceling its OS assisted migration.
  • From the GuestOS, you have confirmed that the "VMware HCX OSAM Sentinel Service" is not running nor installed anymore.
  • From HCX UI -> Interconnect -> Service Mesh (view Appliances) -> Sentinel Management, the removed/uninstalled VM is still present with the Connection State: Disconnected
  • Trying to remove/uninstall from the HCX UI does not take any action, and the VMs remain listed.
  • From HCX -> Migration, by switching to the Legacy display you see that migration tasks for the affected VMs are still running, in state "Cancelling Migration"

Environment

VMware HCX 4.11

Cause

This is a known issue impacting VMware HCX 4.11. The persisting migration task is preventing the OSAM status from completing its cleanup in the HCX Manager, or a version mismatch between the Sentinel software that was present on the VMs and the version of the HCX manager may affect the expected workflow.

Resolution

You can safely ignore the VMs still listed in Sentinel Management when there was a stuck migration showing the status "Cancelling Migration" or a version mismatch.

If you need to reinstall the OSAM sentinel agent, follow the steps:

  • Select the affected VM from HCX UI (Migration tab), and click on the Force Cleanup, for more information: Force Cleanup for a Failed or Canceled Migration
    Note: The migration will remain in the “Canceling Migration” state in the legacy HCX migration UI; however, the force cleanup is required to clean up the backend state. This will allow the migration to be triggered again from the new UI.
  • Install the sentinel bundle which will show up as new system: Downloading and Installing HCX Sentinel Agent Software
    Note: The VM will display again with the status 'Connected'; however, it will not remove the stale VM with connection state: 'Disconnected'.

Additional Information