Skip to main content

Smoke-test matrix

Run smoke tests from the downloaded release media, not only from local build outputs. This catches publishing mistakes as well as installer mistakes.

Installer Media

PlatformFileBasic checks
macOSDeepPhe-7.1.dmgMounts, opens DeepPhe Installer.app, installs without Gatekeeper errors.
WindowsDeepPhe_windows-7.1.exeStarts with elevation, installs to a no-space path such as C:\DeepPhe.
LinuxDeepPhe_linux-x64-7.1.shStarts with sh DeepPhe_linux-x64-7.1.sh, installs to the chosen directory.

Verify downloaded media before testing:

PlatformSHA-256
macOS7ab36501f824bc20605f4075c0bfb7cc5e0fa6481c632784b0225b550f7d0f6e
Windowsa1f55ad0ad200aa3ff7882796d10f755e9075074a892473d06e995bb26953558
Linux53171da4f4d78565da4fabd6e8d5fdc297e588f580835271e01beda936958895

Install Checks

For each platform:

  1. Install from the downloaded media.
  2. Confirm the installer downloads payloads from GitHub.
  3. Confirm <install dir>/.DeepPhe/ exists.
  4. Confirm ~/DeepPheDocs/ exists.
  5. Confirm the current platform's visualizer, data API, and DB-creator binaries are present under .DeepPhe/tools/.
  6. Confirm Unix tool binaries are executable on macOS and Linux.

Launcher Checks

For each platform:

  1. Open DeepPhe Launcher.
  2. Confirm the GUI starts without a Java or classpath error.
  3. Confirm the example project is listed.
  4. Run the example flow far enough to verify the NLP pipeline, DB creator, data API, and visualizer can be started.
  5. Check .DeepPhe/logs/launcher/, .DeepPhe/logs/deepphe/, and .DeepPhe/logs/viz/ for obvious startup errors.

Uninstall Checks

For each platform:

  1. Run the platform uninstaller.
  2. Leave the DeepPheDocs deletion checkbox unchecked.
  3. Confirm .DeepPhe and the launcher are removed.
  4. Confirm ~/DeepPheDocs/ remains.
  5. Reinstall, then uninstall again with the deletion checkbox checked on a test machine.
  6. Confirm ~/DeepPheDocs/ is removed only when the checkbox is checked.

Downloadable Windows Payloads

After running sign-windows-assets.sh, smoke-test each signed Windows payload at least once:

Release tagAsset
deepphe-visualizer-v2-7.1deepphe-visualizer-v2-win-x64.exe
dphe-data-api-7.1dphe-data-api-win-x64.exe
dphe-db-pipeline-7.1DeepPheVizDbCreator-windows-x86_64.exe

These are single-file bundles. Authenticode signing usually works, but can break payloads that store data in the executable overlay.