Updating the system layer for software-only deployments

Last Updated : Jun 05, 2026 |

About this task

The system layer is low-level software that provides the required operational environment for the Avaya Aura® Web Gateway application. You must update the system layer before upgrading your Avaya Aura® Web Gateway application.

For software-only deployments, Avaya provides a system layer installer in a package, which also contains an Avaya Aura® Web Gateway application installer.

For information about installing system layer updates for OVA-based deployments, see System layer (operating system) updates for virtual machines deployed using Avaya-provided OVAs.

Before you begin

Download the latest csa-swonly-<AAWG_VERSION>.tgz software-only installation package from PLDS.

Procedure

  1. Upload the software-only installation package on the virtual machine to the /root directory.

    Use a file transfer program of your choice, such as SFTP, SCP or WinSCP.

  2. Log in to the virtual machine as the root user.
  3. To extract the content of the installation package, run the following command:

    tar -xzf csa-swonly-<AAWG_VERSION>.tgz

    For example: tar -xzf csa-swonly-3.9.1.0.x.tgz

    The /root/csa-swonly-AAWG_RELEASE/ directory contains the following files:

    • The system layer package in TGZ archive ucapp-swonly-system-<VERSION>.tgz.

    • The Avaya Aura® Web Gateway application binary csa-<AAWG_RELEASE>.bin.

  4. Go to the directory with the extracted installation package:

    cd csa-swonly-<AAWG_VERSION>

  5. To extract the content of the archive with the system layer installation files, run the following command:

    tar -xzf ucapp-swonly-system-<SYSTEM_LAYER_VERSION>.tgz

    For example: tar - xzf ucapp-swonly-system-1.0.0.0.8.tgz

  6. Go to the directory with the extracted system layer package:

    cd ucapp-swonly-system-<SYSTEM_LAYER_VERSION>

  7. Run the following command to install the latest system layer:

    ./swOnlyUpdate.sh --patch