Configuring Windows Subsystem for Linux

Last Updated : Mar 30, 2026 |

About this task

You can configure WSL2 and import the CCM-provided WSL distribution image. The WSL configuration creates a Linux runtime environment on Windows, which is required to run the CCM air-gap tooling and container-based operations.

Before you begin

Ensure the following:

  • You have local administrator privileges to run PowerShell commands.

  • Download the CCM WSL distribution image (ccm-agn-wsl-x.x.xx.tar) from Avaya support PLDS.

  • Windows features Windows Subsystem for Linux and Virtual Machine Platform are enabled.

Procedure

  1. Click Windows Start icon or Windows Search icon and search Windows PowerShell.
  2. In Windows PowerShell console, run wsl --update to update the WSL feature.
  3. To verify successful completion of WSL 2 configuration, run wsl --status. Ensure that the output displays Default Version: 2.
  4. To create a new directory, do the following:
    1. To navigate to the C drive, run cd C:\.

      You can use any drive available. In this procedure, C drive is used as an example.

    2. To create a new directory, run mkdir "C:\avaya\ccm-wsl" -Force.
  5. Download and copy the ccm-agn-wsl-x.x.xx.tar CCM WSL distribution image file to the C:\avaya\ccm-wsl directory.
  6. To change the directory to C:\avaya\ccm-wsl\, run cd C:\avaya\ccm-wsl\ .
  7. To import the CCM WSL distribution image file (ccm-agn-wsl-x.x.xx.tar), run wsl --import ccm-agn-wsl-x.x.xx C:\avaya\ccm-wsl\ .\ccm-agn-wsl-x.x.xx.tar --version 2.
    Note:

    For example, wsl --import ccm-agn-wsl-1.3.07 C:\avaya\ccm-wsl\ .\ccm-agn-wsl-1.3.07.tar --version 2.

  8. To verify the import of WSL image, run wsl -l -v.
    Note:

    A successful import displays the imported WSL distribution (for example, ccm-agn-wsl-x.x.xx with state as Stopped and Version 2.