"Child process exited with code: 1" error when attempting to upgrade a Cloud Director Availability 4.x appliance

Products

• VMware Cloud Director

Issue/Introduction

Symptoms:

• When attempting to upgrade Cloud Director Availability 4.x, after clicking FINISH in the update wizard you see the following error:

A child process exited with code: 1

• In the /var/log/upgrade.log file on the Cloud Director Availability appliance you are upgrading, you see entries similar to:

[2024-03-01 05:50:39 UTC] + '[' '!' -f /var/vmware/skip_free_space_check ']'
[2024-03-01 05:50:39 UTC] + /usr/bin/python3 -c 'import sys, shutil; total, _, free = shutil.disk_usage("/"); sys.exit(0 if free / total > 0.6 else 1)'
[2024-03-01 05:50:39 UTC] + '[' 1 '!=' 0 ']'
[2024-03-01 05:50:39 UTC] + /usr/bin/echo 'Not enough free space for upgrade! Please contact customer support!'
[2024-03-01 05:50:39 UTC] Not enough free space for upgrade! Please contact customer support!
[2024-03-01 05:50:39 UTC] + exit 1
[2024-03-01 05:50:39 UTC] Bad exit code: 1
[2024-03-01 05:50:39 UTC] {
    "code": "BadExitCode",
    "msg": "",
    "args": [
        "1"
    ]
}

Note: The preceding log excerpts are only examples. Date, time, and environmental variables may vary depending on your environment.

Environment

VMware Cloud Director Availability 4.x

Cause

This issue occurs when there is not enough free space on the Cloud Director Availability appliance to ensure the upgrade can complete successfully.

Cloud Director Availability 4.x requires there to be at least 60% available free space on the appliance in order to initiate the upgrade.

Resolution

To resolve this issue, free up sufficient space to meet the required 60% threshold and re-attempt the upgrade.

Additional Information

For more information on how to reclaim space on a Cloud Director Availability appliance, see the Free up VMware Cloud Director Availability appliance disk space section of the Cloud Director Availability documentation.

If you need to reclaim further space after applying the steps in the documentation, see Free disk space reports high disk usage in the System Health view on Cloud Director Availability 4.x.