Preview Versions

The SOPHiA DDM™ CLI is published as a single rolling artifact at https://ddm.sophiagenetics.com/direct/sg/uploaderv2/sg-upload-v2-latest.jar. The wrapper script downloads this file on every run and verifies it against the matching .md5.

In addition to the rolling latest JAR, individual versions are published side-by-side at the same CDN folder with the version embedded in the filename:

https://ddm.sophiagenetics.com/direct/sg/uploaderv2/sg-upload-v2-<version>.jar
https://ddm.sophiagenetics.com/direct/sg/uploaderv2/sg-upload-v2-<version>.jar.md5

This allows you to:

  • Opt in to a new version before it becomes the default latest.
  • Pin your machine to a specific version, independent of when latest changes.

The currently available versioned files are listed in the Changelog.

Switching the wrapper to a specific version

Open your local copy of sg-upload-v2-wrapper.py and update the two filename constants near the top of the file:

UPLOADER_FILENAME = "sg-upload-v2-latest.jar"
UPLOAD_CHECKSUM_FILENAME = "sg-upload-v2-latest.jar.md5"

Replace them with the versioned filenames you want to pin to. For example, to opt into the preview build 7.21.0-6.12.0:

UPLOADER_FILENAME = "sg-upload-v2-7.21.0-6.12.0.jar"
UPLOAD_CHECKSUM_FILENAME = "sg-upload-v2-7.21.0-6.12.0.jar.md5"

Do not change REMOTE_URL — the versioned files live on the same CDN host as latest.

Delete any previously cached JAR from the wrapper's working directory so the wrapper downloads the new file on the next run:

$ rm sg-upload-v2-latest.jar sg-upload-v2-7.21.0-6.12.0.jar 2>/dev/null
$ python3 sg-upload-v2-wrapper.py --help

The wrapper will fetch the requested versioned file, verify the MD5, and run it.

Switching back

To return to the rolling default, set the constants back to:

UPLOADER_FILENAME = "sg-upload-v2-latest.jar"
UPLOAD_CHECKSUM_FILENAME = "sg-upload-v2-latest.jar.md5"

To pin to the previous stable version (e.g. 7.19.1-6.10.2) after latest has been promoted to a new release, use the versioned filenames for that release:

UPLOADER_FILENAME = "sg-upload-v2-7.19.1-6.10.2.jar"
UPLOAD_CHECKSUM_FILENAME = "sg-upload-v2-7.19.1-6.10.2.jar.md5"

In both cases delete the locally cached JAR before re-running the wrapper so the correct file is downloaded.

Verifying which version is in use

Run the wrapper with the version command to print the version embedded in the JAR:

$ python3 sg-upload-v2-wrapper.py version

The wrapper also prints the remote MD5 it downloaded on every run, which can be cross-checked against the published .md5 file:

$ curl -s https://ddm.sophiagenetics.com/direct/sg/uploaderv2/sg-upload-v2-7.21.0-6.12.0.jar.md5