After a pre-validation request finishes successfully, you can retrieve a pre-validation report. Any checks with status FAILED indicate potential problems with the product upgrade. Before proceeding with the upgrade, you should address the issues and pre-validate the upgrade request again.

Prerequisites

Satisfy the following conditions before performing any tasks for this use case.
  • Use POST /lcm/api/v1/login to log in to vRealize Suite Lifecycle Manager.
  • Verify that you have a valid authentication token that matches your login credentials. See Request an Authentication Token.
  • Verify that you have the Product ID for the product you want to upgrade and the Environment ID for the environment where the product is to be upgraded. To obtain the Environment ID and Product ID, see the responses to requests in List All Products in an Environment.

Procedure

Retrieve the pre-validation report. 
curl -X GET "https://LCM-HostName/lcm/api/v1/view/prevalidation/report/upgrade/product?environmentId={Environment-ID}&productId={Product-ID}&requestId={Request-ID}" \
  -H "accept: application/json" \
  -H "x-xenon-auth-token: $token"
  • Environment-ID identifies the environment where the product to be upgraded is deployed.
  • Product-ID identifies the product to upgrade.
  • Request-ID is the Product Upgrade Request ID. See Create Product Upgrade Request.

Results

The report includes two sections with the checkName parameter. These sections display output for Data Validation and Product Validation.
The following report is the response for a pre-validation check for a product upgrade from vRealize Log Insight 4.5.1 to vRealize Log Insight 4.6.0. 
{
  "rootValidations": [
    {
      "checkName": "Data validation",
      "status": "PASSED",
      "elementType": "GROUP",
      "childElements": [
        {
        "checkName": "Version support from LCM.",
        "checkType": "ERROR",
        "status": "PASSED",
        "resultDescription": "Check if the selected version is supported by LCM policy.",
        "elementType": "CHECK"
        },
        {
        "checkName": "File format check.",
        "checkType": "ERROR",
        "status": "PASSED",
        "resultDescription": "Check if a file with valid format is selected.",
        "elementType": "CHECK"
        }
      ]
    },
    {
      "checkName": "vRealize Log Insight Validations",
      "status": "PASSED",
      "elementType": "GROUP",
      "childElements": [
        {
          "checkName": "SSH check.",
          "checkType": "ERROR",
          "status": "PASSED",
          "resultDescription": "Check if SSH is enabled.",
          "elementType": "CHECK"
        },
        {
          "checkName": "Valid IP/FQDN (master) for upgrade.",
          "checkType": "ERROR",
          "status": "FAILED",
          "resultDescription": "An upgrade should be triggered with master node's IP/FQDN. Here IP/FQDN used is wdc-interop29-67.sqa.local.",
          "elementType": "CHECK"
        }
      ]
    }
  ],
  "overallStatus": true,
  "requestState": "COMPLETED",
  "lastUpdateTimeMillis": 1532515260057,
  "startTimeMillis": 1532515060839
}
This example shows a failure in the check for Valid IP/FQDN (master) for upgrade. Follow the instructions in the result description to correct the problem, run the pre-validation request, and review the report again to verify that all checks passed before performing the product upgrade.
Note: Once a check condition fails, no subsequent checks are performed. To correct multiple problems in a product upgrade request, you might need to rerun the pre-validation request several times.