Running on QEMU

If you want to execute the image without building first, grab the latest release or build artifacts from https://github.com/eclipse-leda/leda-distro/

Recommendations

• A Linux host with 8 vCPUs, 16GB of RAM and SSD storage is recommended
• Your Linux user should be sudoer to allow TAP network interfaces to be set up

QEMU x86_64

• Install Qemu, e.g. for Ubuntu:

  sudo apt-get update -y
  sudo apt-get install -y xz-utils qemu-system-x86-64
  

• Download latest Eclipse Leda release

• Uncompress the archive

  tar xf eclipse-leda-qemu-x86_64.tar.xz
  

• Run QEMU on Linux:

  ./run-leda.sh
  

• Run QEMU on Windows:

  run-leda.cmd
  

  

• Login as root without password on login prompt

• Verify and wait until container runtime is started: systemctl status container-management

• Optional: Check the system health: sdv-health

  

  Note: The status of some containers (e.g. cloud connector) are expected to stay in FAILED status as long as the Device Provisioning steps are not completed.

• Continue with Device Provisioning

QEMU ARM 64-Bit

• Install Qemu, e.g. for ARM 64-Bit: sudo apt install qemu-system-aarch64

• Download latest Eclipse Leda release

• Uncompress the archive

  tar xf eclipse-leda-qemu-arm64.tar.xz
  

• Run QEMU on Linux:

  ./run-leda.sh
  

• Run QEMU on Windows:

  run-leda.cmd
  

• Login as root without password on login prompt

• Verify and wait until container runtime is started: systemctl status container-management

• Optional: Check the system health: sdv-health

  Note: The status of some containers (e.g. cloud connector) are expected to stay in FAILED status as long as the Device Provisioning steps are not completed.

• Continue with Device Provisioning