VMware Cloud Foundation : AsyncPatch Tool Installation Failure with: "ENABLE_ASYNC_PATCH" or "SERVICE_UPGRADE_SCRIPT_FAILED"

Products

• VMware Cloud Foundation

Issue/Introduction

Symptoms:

Using the APTool for an upgrade fails, with errors in the APTool Logs reporting:

"Updating version alias config failed with error failed with error 400 Client Error: for url: https://example.com/v3/__http://localhost/v1/system/settings/version-aliases__;!!Lp"

or

"Caused by: java.io.FilenNotFoundException: /nfs/vmware/vcf/nfs-mount/bundle/depot/local/softwareCompatibiltySets.json (Permission denied)"

You may also observe these generic error(s):

Error while initiating required functionality: ENABLE_ASYNC_PATCH .....

2023-10-25 18:58:36,048 : Failed to upgrade vcf-commonsvcs
2023-10-25 18:58:38.689 [main] INFO [com.vmware.evo.sddc.lcm.tools.telemetry.asyncpatch.AsyncPatchToolTelemetryAdapter]
Telemetry data collection is not enabled
2023-10-25 18:58:38.689 [main] ERROR
[com.vmware.evo.sddc.lcm.tools.asyncpatch.AsyncPatchToolMain]
Error while initiating required functionality: ENABLE_ASYNC_PATCH
2023-10-25 18:58:38.705 [main] ERROR [com.vmware.evo.sddc.lcm.tools.asyncpatch.AsyncPatchToolMain]
SERVICE_UPGRADE_SCRIPT_FAILED

 

 

Environment

VMware Cloud Foundation 4.5.x

Cause

This is caused due to improper permissions and/or ownership on the VersionAlias.yml & softwareCompatibilitySets.json files

Resolution

0. Take a snapshot of the SDDC Manager.
1. SSH to the SDDC Manager as vcf and then su to root.
2. Update the VersionAlias.yml & softwareCompatibilitySets.json permissions correctly:

chmod 640 /opt/vmware/vcf/lcm/lcm-app/conf/VersionAlias.yml
chmod 640 /nfs/vmware/vcf/nfs-mount/bundle/depot/local/softwareCompatibilitySets.json

chown vcf_user:vcf /opt/vmware/vcf/lcm/lcm-app/conf/VersionAlias.yml
chown vcf_user:vcf /nfs/vmware/vcf/nfs-mount/bundle/depot/local/softwareCompatibilitySets.json

3. Restart the CLM service:
systemctl restart lcm

4. Retry the Async Patch Tool Workflow

Additional Information

Async Patch Tool (AP Tool) (88287)