VMware Aria Suite Lifecycle Manager Upgrade minimum space requirement

Products

• VMware Aria Suite

Issue/Introduction

This article covers symptoms faced during upgrade of VMware Aria Suite Lifecycle Manager 8.x to 8.12.0 due to shortage of free disk space on the appliance, and how to troubleshoot and remediate.

Symptoms:

• VMware Aria Suite Lifecycle Manager upgrade process keeps running for an unusual long time while the user interface shows a message like No update instance is running.
• The Suite Lifecycle application log /var/log/vrlcm/vmware_vrlcm.log has entries similar to the following

  2023-05-05 09:47:50.108 INFO [http-nio-8080-exec-2] c.v.v.l.u.ProcessUtil - -- Execute /opt/vmware/bin/vamicli
  2023-05-05 09:47:50.159 INFO [http-nio-8080-exec-2] c.v.v.l.u.ShellExecutor - -- Result: [No update instance is running.]

• The log file /opt/vmware/var/log/vami/updatecli.log has errors similar to

  05/05/2023 13:06:58 [INFO] Update status: Running installation tests
  05/05/2023 13:06:58 [INFO] Running /opt/vmware/var/lib/vami/update/data/job/3/test_command
  Preparing packages...
   installing package VMware-commonjars-7.0.3.00000-9019451.x86_64 needs 101MB on the / filesystem
   installing package VMware-observability-7.0.3.00000-9019451.x86_64 needs 111MB on the / filesystem
  ...
  ...
  filesystem
          installing package diffutils-3.6-3.ph3.x86_64 needs 665MB on the / filesystem
          installing package dejavu-fonts-2.37-1.ph3.noarch needs 676MB on the / filesystem
          installing package compat-gdbm-1.8.3-3.ph3.x86_64 needs 677MB on the / filesystem
          installing package c-ares-1.19.0-1.ph3.x86_64 needs 677MB on the / filesystem
  05/05/2023 12:01:15 [ERROR] Failed with exit code 65024

Environment

VMware Aria Suite Lifecycle 8.x

Cause

This issue occurs when there is inadequate space in the Suite Lifecycle appliance to run the upgrade process.
As seen in the updatecli.log, the failure is observed before the actual upgrade process starts. The 'test_command' fails which validates if a required package installation runs correctly or not.

Resolution

• A minimum of 3GB of free space is required for the mounted storage for the root location. The available free space can be checked anytime with the command: df -h.

Example:

df -h

Filesystem Size Used Avail Use% Mounted on
devtmpfs 2.9G 0 2.9G 0% /dev
tmpfs 3.0G 20K 3.0G 1% /dev/shm
tmpfs 3.0G 1.1M 3.0G 1% /run
tmpfs 3.0G 0 3.0G 0% /sys/fs/cgroup
/dev/sda4 8.7G 4.8G 3.5G 59% /
tmpfs 3.0G 68K 3.0G 1% /tmp
/dev/sda2 119M 29M 84M 26% /boot
/dev/mapper/stroage_vg-storage 9.8G 84M 9.2G 1% /storage
/dev/mapper/data_vg-data 148G 47G 94G 34% /data
tmpfs 595M 0 595M 0% /run/user/0

If the free space for root '/' is less than 3GB, free up space by deleting files which are not part of Suite Lifecycle deployment.

1. To identify the large files consuming most of the disk space, run the following command

find / -xdev -type f -size +100M -exec du -sh {} ';' | sort -rh | head -n 50

2. If the upgrade process was in progress and the mentioned symptoms are observed, revert to the snapshot created for the Suite Lifecycle appliance to a pre-upgraded state.
   1. Free up the required space and then retry the upgrade process.

If you are not sure about which file to remove to free up space, please contact VMware support.