Workarounds for Upgrading VCF Ops Versions Older Than 8.18.x to 9.0.0.0

Products

• VCF Operations
• VCF Operations/Automation (formerly VMware Aria Suite)

Issue/Introduction

This document presents three alternative workarounds for upgrading VCF Ops versions older than 8.18 to version 9.0.

Environment

VMware Aria Operations version older than 8.18

Resolution

Option 1 - Increase Upgrade Pack Size Limit in UI by Updating Apache Configs and Restarting Services

To address the UI size limitation during upgrades, the following steps can be taken:

1. Access the Primary Node: SSH into the primary node of the Ops instance using the root user.
2. Download file: Upload the upload_size_fix.sh script to the node. (File download link)
3. Modify permissions:
   

   chmod +x upload_size_fix.sh

4. Execute the script:
   

   sh upload_size_fix.sh

5. Check status: Once the script execution is successful, you will see the following message:
   

   All file modifications completed!
   Restarting VMware services...
   Service vmware-vcops restarted successfully!
   Service vmware-casa restarted successfully!
   Script execution completed!

 

Option 2 - Upload PAK File Using REST API

To upload the PAK file for the upgrade, use the following instructions:

1. Access the Primary Node: SSH into the primary node of the Ops instance using the root user.
2. Transfer the Upgrade PAK: Move or download the 9.0 upgrade PAK file (.pak) to the current working directory using mv or wget.
3. Upload the PAK File via API: Run the following curl command to upload the PAK file:
   

   curl -s -g --request POST --form "contents=@<UPGRADE_FILE>.pak" -k --user <ADMIN_USERNAME>:<ADMIN_PASSWORD> https://<PRIMARY_IP>/casa/upgrade/cluster/pak/reserved/operation/upload

4. Confirm Upload Success: If the command executes successfully, a PAK_ID will be returned in the response.
5. Proceed with Installation
   • Option 1 (API-based): Use the following command to initiate installation from the terminal:
     

     curl -s -g --request POST --form "contents=force_content_update=true" -k -u <ADMIN_USERNAME>:<ADMIN_PASSWORD> https://<PRIMARY_IP>/casa/upgrade/cluster/pak/<PAK_ID>operation/install

   • Option 2 (UI-based): Open the Admin UI and navigate to
     Software Update > Finish Installation to continue.
     
     

Option 3 - Two Steps Upgrade

To upgrade Ops instance, follow these steps:

1. Upgrade to Version 8.18:
   • First, upgrade to version 8.18.x from versions 8.14.x, 8.16.x, or 8.17.x.
2. Upgrade to Version 9.0:
   • After successfully upgrading to 8.18.x, proceed with the upgrade to version 9.0.0.0.

 

This process ensures that you can successfully upgrade your Ops instance to version 9.0, even when using versions older than 8.18.

Additional Information

For 8.14 and older only: Procedure to replace Remote Collector based Cloud Proxy