Upgrade deployed products using the VMware Aria Suite Lifecycle API

You can use VMware Aria Suite Lifecycle to upgrade any VMware Aria Suite product that is part of a VMware Aria Suite Lifecycle private cloud environment. To perform the upgrade, you use the Deployed Product Operation API.

The request body to create any product upgrade requires the same input.

Input	Description
productVersion	Currently installed version of the product you are upgrading.
repositoryType	Type of repository that the API checks for the upgrade binaries: lcmRepository CDROM Default
repositoryUrl	Path to the repository that contains the binaries for the product upgrade.
licenseRef	Locker license reference value. This property is only used when a new license is required after upgrading from VMware Aria Operations for Networks 5.x to 6.x.

The following procedure shows how to upgrade VMware Aria Operations from version 7.6 to version 8.0.

Prerequisites

• Verify that all general prerequisites have been satisfied and that you have your environment ID and product ID. See the prerequisites for Performing Day 2 operations using VMware Aria Suite Lifecycle APIs.
• For the product that you are upgrading:
  • Verify that you know the currently installed version.
  • Verify that you have downloaded the binaries and recorded the repository that contains the binaries. See Create an Environment using VMware Aria Suite Lifecycle API.
  • Verify that you have created a snapshot of the installed product that you can revert to if there is an upgrade failure. See Create a Product Snapshot.

Procedure

1. Create the request for your product upgrade.

   curl -X POST \
     '$url/lcm/lcops/api/v2/environments/$environmentId/products/$productId/upgrade' \
     -H 'Authorization: Basic YWRtaW5AbG9jYWw6VGhpc0lzUGFzc3dvcmQ=' \
     -H 'Content-Type: application/json' \
     -d '{
       "productVersion": "7.6.0",
       "repositoryType": "lcmRepository",
       "repositoryUrl": "/data/nfsPath/vrops800.pak",
       "licenseRef" : null
     }' | jq "."

   The request triggers the API. The response shows the request ID.

   {
       "requestId":"1dac194a-6e1f-4772-a97d-af300ad5086c"
   }

2. Assign the variable for the requestId.

   requestId = "1dac194a-6e1f-4772-a97d-af300ad5086c"

3. Use the requestId to track your request.

   curl -X GET '$url /lcm/request/api/v2/requests/$requestId' -H 'Authorization: Basic YWRtaW5AbG9jYWw6VGhpc0lzUGFzc3dvcmQ=' | jq "."

   The request might take some time. After it succeeds, the product is upgraded.

   ...
   },
     "outputMap": {},
     "state": "COMPLETED",
     "executionId": "61274f3c-20cc-47a1-90ec-130635edb7d1",
   ...

What to do next

If the upgrade request request fails, creating a log bundle can help to troubleshoot the problem. See How do I generate a log bundle using the VMware Aria Suite Lifecycle API. Before attempting to upgrade again, revert the product to its snapshot.