Upgrade from Aria Operations (formerly vRealize Operations) 8.6.4 to 8.12 hangs while the NSX adapter is updating.

Products

• VMware Aria Suite

Issue/Introduction

When upgrading Aria Operations to 8.12 & 8.10 from 8.6.x, the upgrade becomes stuck on the Management Pack upgrade phase. Specifically the NSX Adapter, preventing the upgrade to 8.10 completing.

Environment

Aria Operations (Formerly vRealize Operations) 8.6.4 upgrading to 8.10 or 8.12

Cause

In pakManager.actions.log we can see an error similar to this;

2024-07-23T14:21:38,981+0000  INFO [Thread-5528] [        ] upgrade.pak.CorePakService:253 - Installing pak file: /data/db/casa/pak/to_install/vmware-MPforNSXTAdapter-8.12.0-21594412.pak, with the ID: NSXTAdapter-812021594412
2024-07-23T14:21:39,314+0000 DEBUG [Thread-5528] [        ] upgrade.pak.CorePakService:452 - Starting validate: NSXTAdapter-812021594412
2024-07-23T14:21:39,314+0000  INFO [Thread-5528] [        ] upgrade.pak.HistoryService:60 - Starting operation PREAPPLY_VALIDATE for pakID NSXTAdapter-812021594412
2024-07-23T14:21:39,314+0000  INFO [Thread-5528] [        ] upgrade.pak.HistoryService:70 - could not read filename /data/log/vcops/log/casa/casa_pak_history_NSXTAdapter-812021594412.json, using empty content, exc=java.io.FileNotFoundException: /data/log/vcops/log/casa/casa_pak_history_NSXTAdapter-812021594412.json (No such file or directory)

This indicated that an NSX adapter json was missing on the appliance; causing the "FileNotFoundException"

Please note, the timestamps will differ.

Resolution

The workaround is to manually remove the NSX adapter before upgrading this Aria Operations instance. As the NSX adapter is an Out of the Box (OOTB) feature, this cannot be removed in the UI and an API call must be used.

1. Open an SSH session to the vROPS master node. 

2. curl -i -k -u admin -X POST https://<VROPS IP or FQDN>/casa/upgrade/cluster/pak/operation/disable -d '{"pak_id":"NSXTAdapter","version":8.6,"remove_content":true}' -H "Accept: application/json" -H "Content-type: application/json"

    

    

   • Replace the FQDN or IP of your Aria Operations cluster
3. You will be prompted for your admin password.
4. In the UI on the Management Pack tab you will see an uninstalling notice.
5. Once that completes proceed with the upgrade to 8.12.
6. As the NSX management pack is OOTB, it will be available in the UI after the upgrade.