VMware Aria Suite Lifecycle 8.18 Patch 5 Installation Runbook

Products

VMware Aria Suite

Issue/Introduction

Important Pre-Patch Instructions for Aria Suite Lifecycle

This article outlines the steps to install VMware Aria Suite Lifecycle 8.18 Patch 5. Before proceeding, you must complete the following prerequisites to avoid service disruption:

Take Snapshots
Create non-memory snapshots of the VMware Identity Manager and VMware Aria Suite Lifecycle appliances in vCenter. Ensure the environments are in a healthy, stable state before taking the snapshots.
Follow the Correct Patching Sequence
The order of operations is critical. You must patch VMware Identity Manager before patching VMware Aria Suite Lifecycle, and both must be done within the same maintenance window.
- Step 1: First, patch VMware Identity Manager by following the instructions in KB 412021.
- Step 2: After the Identity Manager patch is complete, proceed with patching VMware Aria Suite Lifecycle using the instructions in this article.
Do Not Delete Snapshots Early

Retain the snapshots taken in Step 1 until the entire patching process for both products has been completed and you have verified that the environment is fully functional.

Resolution

Procedure: Aria Suite Lifecycle Patch 5 Installation

Mandatory: Take a Snapshot
Before proceeding, take a non-memory snapshot of the VMware Aria Suite Lifecycle appliance.
Copy the prep-for-upgrade-lcm.sh script (attached to the KB article) to the /data directory on the appliance and execute it:
```
cd /data
chmod +x prep-for-upgrade-lcm.sh
./prep-for-upgrade-lcm.sh
```
(If upgrading from Patch 3 to Patch 5) Delete temporary folders from previous patch attempts by running the following commands:
```
rm -r /data/tmp-patch-8180
rm -r /data/tmp-patch-10318114
rm -r /data/tmp_patch_storage
```
Download the vrslcm-8.18.0-Patch5.patch patch from the Broadcom Support Portal:
Copy the downloaded patch file to the /data directory on the Aria Suite Lifecycle appliance.
Map the patch binary in the UI. Navigate to Lifecycle Operations > Settings > Binary Mapping and click Patch Binaries.
- Delete any old patch binaries that may be listed.
- Enter the local path (e.g., /data) in the Source Location field and click Discover.
- Select the discovered Patch 5 file and click Add.
Install the patch. Navigate to Lifecycle Operations > Settings > System Patches and click Install Patch.
Wait for the installation to complete. The process takes approximately 20 minutes and will conclude with the appliance rebooting.

Validation

After the appliance reboots, log in to the VMware Aria Suite Lifecycle UI, navigate to the About page, and verify that the version is listed as 8.18.0 Patch 5.
(Optional) SSH to the appliance and check the Photon OS version. Note that the build number will not change if you are patching from Patch 3 to Patch 5.
```
# cat /etc/photon-release
VMware Photon OS 5.0
PHOTON_BUILD_NUMBER=b9d98344d
```

Additional Information

Logs to Monitor

You can monitor the progress of the patch installation by tailing the following log files on the Aria Suite Lifecycle appliance:

/var/log/vrlcm/os-package-update.log
/var/log/vrlcm/patchcli.log

Known Issue: /tmp Directory Space

Potential Issue

During the installation, you may encounter an error with code LCMPATCHUPDATE16002. This error indicates that there is not enough free space in the /tmp directory for the patch to be extracted.

If this occurs, please refer to KB 345990 for instructions on how to temporarily increase the space in the /tmp directory.

Attachments

prep-for-upgrade-lcm.sh get_app