AsyncPatch Tool Installation Upgrade fails "ENABLE_ASYNC_PATCH" or "SERVICE_UPGRADE_SCRIPT_FAILED"

Products

• VMware Cloud Foundation

Issue/Introduction

• 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;

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) in AP Tool:
  
  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

1. Take a snapshot of the SDDC Manager.
   
   
2. SSH to the SDDC Manager as vcf and then su to root.
   
   
3. 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
   
   
4. Restart the LCM service:
   systemctl restart lcm
   
   
5. Retry the Async Patch Tool Workflow

Additional Information

Applying individual product updates to VMware Cloud Foundation environments using Async Patch Tool (AP Tool)