Linux Helper (SCL) Installation

Note:
  • Smart Compatibility Layer is available from Incredibuild for Windows release 10.22 and later.
  • Smart Compatibility Layer is only available via a dedicated license.

Smart Compatibility Layer

Incredibuild Smart Compatibility Layer (SCL) allows users to use Linux machines as Helpers in an Incredibuild for Windows grid. These Linux machines can assist in builds initiated from Windows machines seamlessly.

By using Linux machines instead of Windows machines, users can reduce the cost of their existing Incredibuild infrastructure in the cloud (AWS, Azure, or GCP). In addition, users who were reluctant to grow their on-prem Incredibuild infrastructure in the cloud because of the high cost of cloud instances, can now re-consider and possibly accelerate their builds further.

SCL Agents run as containers on the Linux host. There is no need to install anything other than a standard container environment, such as Docker or Podman, which means that they are extremely simple to deploy and use.

Smart Compatibility Layer utilizes Wine as its foundation layer. However, SCL significantly extends and customizes Wine to integrate seamlessly with Incredibuild’s parallelization, caching, and distribution technologies. This unique combination ensures a robust and efficient environment for accelerating Windows workloads on Linux systems.

Host Requirements

  • Run an Ubuntu 22.04 container (the SCL container runs Ubuntu 22.04)

  • Docker or Podman

  • 8 cores (x64) or more

  • 2-4 GB of RAM per core

  • Do not run additional CPU-intensive processes on the host

  • Do not over-provision cores onto the container beyond the physical cores of the host

  • Other requirements are as described in System Requirements

Running the SCL Container

Run the following command on the Linux host:

Copy 
docker run --detach --restart unless-stopped \
--hostname $HOSTNAME \
--name IncredibuildHelper \
--env COORD_IP=192.168.1.1 \
--network host \
public.ecr.aws/incredibuild/scl:latest_10.22.0

Replace the Coordinator IP address (192.168.1.1) and Incredibuild version (10.22.0) in the script to match the IP address and Incredibuild version of your Coordinator.

Limitations

SCL accelerates the following tools only (tasks using other tools are not supported and are not distributed to SCL Helpers):

  • Cl.exe

  • Cl-filter.exe

  • Clang.exe

  • ShaderCompileWorker.exe (Unreal Engine)