Skip to content

CML Lab Builder 3.0.0

Choose a tag to compare

@Specops13 Specops13 released this 21 Oct 04:12
· 32 commits to main since this release

CML Lab Builder 3.0.0: the full rename. The program, downloads, Debian package, Python package, data folder and the labs it creates in CML are all CML Lab Builder now. ENCOR stays as a track and course name.

This is a one-time full download (new runtime 2), not a patch. ENCOR Lab Builder 1.7 - 2.1 find this release by themselves and show "a full download is needed" with a link to the right file. After 3.0.0, updates are small patches again.

Upgrade

Windows 11: download CMLLabBuilder-3.0.0-windows-x64.zip (the banner's ENCORLab-3.0.0-windows-x64.zip is the same file), close ENCOR Lab Builder, unzip anywhere (e.g. Documents\CMLLabBuilder) and run CMLLabBuilder.exe. Your data moves on the first start. Then delete the old ENCORLab-... folder and shortcuts. SmartScreen: More info > Run anyway (unsigned).

Debian / Ubuntu: close the app, then sudo apt install ./cml-lab-builder_3.0.0_amd64.deb (or the banner's ./encorlab_3.0.0_amd64.deb, the same file). apt replaces the encorlab package; start it from the menu (CML Lab Builder) or with cml-lab-builder / cmllab (encorlab still works until 4.0).

Linux tar.gz: unpack CMLLabBuilder-3.0.0-linux-x64.tar.gz and run ./cml-lab-builder.

What changed

  • CMLLabBuilder.exe / cml-lab-builder; downloads CMLLabBuilder-<v>-windows-x64.zip, CMLLabBuilder-<v>-linux-x64.tar.gz, cml-lab-builder_<v>_amd64.deb; patches cml-lab-builder-patch-<v>.zip.
  • Debian package cml-lab-builder in /opt/cml-lab-builder (Replaces/Breaks/Conflicts/Provides encorlab).
  • Python package cmllab; env vars CMLLAB_* (ENCOR_* still read); labs in CML are created as CML-<lab> (your existing ENCOR-<lab> labs still work: Check, Reset, consoles, snapshots, Destroy; Rebuild replaces them).
  • Installed updates now live in the cml-lab-builder data folder (app/).

Your data

From 2.1: already in cml-lab-builder, nothing copied again. From 1.7 - 2.0: copied from encorlab with a SHA-256 check, the keyring entry copied, MOVED.txt left in the old folder (nothing deleted). From 1.x the former built-in labs are restored from the online library with scores linked.

Compatibility files

ENCORLab-3.0.0-*, encorlab_3.0.0_amd64.deb (byte-identical copies under the old names) and the manifest-only encorlab-patch-3.0.0.zip exist only so 1.7 - 2.1 can show the banner. They install nothing.

Tests: 635 unit tests; Linux and Wine smoke tests; real 1.7/1.9/2.0/2.1 builds upgraded to 3.0.0 on Linux and Windows (Wine) with a 3.0.1 patch round trip; Debian 12 chroot install, upgrade from the encorlab 2.1.0 package, downgrade and purge.

Full details: CHANGELOG · Upgrading