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® Device Services application. You must update the system layer before upgrading your Avaya Aura® Device Services application.

For software-only deployments, Avaya provides a system layer installer in a package, which also contains an Avaya Aura® Device Services 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 aads-swonly-<AADS_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 aads-swonly-<AADS_VERSION>.tgz

    For example: tar -xzf aads-swonly-10.1.1.0.x.tgz

    The /root/aads-swonly-AADS_RELEASE/ directory contains the following files:

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

    • The Avaya Aura® Device Services application binary aads-<AADS_RELEASE>.bin.

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

    cd aads-swonly-<AADS_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