Upgrade deployed products using the vRealize Suite Lifecycle Manager API

You can use vRealize Suite Lifecycle Manager to upgrade any vRealize Suite product that is part of a vRealize Suite Lifecycle Manager 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 vRealize Network Insight 5.x to 6.x.

The following procedure shows how to upgrade vRealize Operations Manager 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 vRealize Suite Lifecycle Manager 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 vRealize Suite Lifecycle Manager 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 vRealize Suite Lifecycle Manager API. Before attempting to upgrade again, revert the product to its snapshot.