Backup Configuration Validation Fails Due to Large File Size Limit - SDDC Manager.

Products

• VMware SDDC Manager / VCF Installer
• VMware Cloud Foundation

Issue/Introduction

SDDC Manager backup configuration fails during validation after an upgrade or in scale environments due to specific files exceeding the default safety threshold.

Backup configuration fails validation immediately, preventing the setup of automated backups.

Error Messages:

• Large files detected in /opt/vmware/vcf that may cause backup timeouts. Files larger than 30 MB found: /opt/vmware/vcf/OSL/open_source_license.txt
• Large files detected in /opt/vmware/vcf that may cause backup timeouts. Files larger than 30 MB found: /opt/vmware/vcf/commonsvcs/data/.ehcache/file/task-aggregator_<UUID>/offheap-disk-store/ehcache-disk-store.data

 

Environment

• Product Versions: VCF 5.2.4, VCF 9.1.1
• Upgrade Paths: Upgrades from VCF 5.0, 5.1, or 5.1.1 to 5.2.4/9.1.1; or 5.2.3 to 9.1.1.
• Configurations: Scale environments or systems with legacy Open Source License (OSL) files.

Cause

1. In VCF 5.0 through 5.1.1, the open_source_license.txt file ranges from 31 MB to 60 MB. Although optimized to 1 MB in newer versions, legacy files retained after an upgrade exceed the 30 MB validation threshold in VCF 5.2.4 and 9.1.1.
2.  In environments scaled to higher capacities, the ehcache-disk-store.data file can naturally grow beyond 30 MB, triggering the same safety threshold validation failure.

Note: Systems upgraded directly from VCF 5.2.0.0 or higher are typically unaffected as the OSL file size was reduced in those builds

Resolution

To allow the backup configuration to pass validation, temporarily increase the file size threshold in the Operations Manager configuration.

Prerequisites

• Ensure you have SSH access to the SDDC Manager VM.
• Take a snapshot of the SDDC Manager VM before modifying configuration files.

Procedure

1. Log in to the SDDC Manager VM via SSH and change to root, then edit the configuration file:

   vi /etc/vmware/vcf/operationsmanager/application-prod.properties

2. Add the following line to the end of the file. In this example, the limit is set to 80 MB, but this value can be adjusted higher if your specific large file exceeds 80 MB:

   backup.validation.large.file.size.threshold.mb=80

3. Apply the new setting by restarting the operationsmanager service:

   systemctl restart operationsmanager

4. Return to the SDDC Manager UI and attempt the configuration backup again.

Additional Information

• VCF 9.0+ versions optimize the OSL file to ~1 MB, but the validation check remains strict to prevent backup timeouts caused by unexpected data growth.