Skip to content

2.12.10 Test Plan

Kevin O'Gorman edited this page Sep 22, 2025 · 1 revision

2.12.10 QA Checklist

For both upgrades and fresh installs, here is a list of functionality that requires testing. You can use this for copy/pasting into your QA report.

This release is Tails-only, enabling the migration from Tails 6 to 7 - no server installs are required.

Environment

  • Install target:
  • Tails version:
  • Test Scenario:
    • Migration from Tails 6
    • Fresh install on Tails 7
  • SSH over Tor:
  • Release candidate:
  • General notes:

2.12.10 release-specific changes

Test plan

Migration from Tails 6:

  • On an admin workstation, check out the latest RC (cd ~/Persistent/securedrop && git fetch && git checkout <latest RC tag>:
    • Confirm that ./securedrop-admin and its subcommands display an error that indicates the user has to run the tool on Tails 7
  • Check out 2.12.9:
    • Smoke test that ./securedrop-admin subcommands work again (change is reversible)
  • Check out the latest RC again.
  • Back up the Persistent Volume (PV)
  • Create a fresh Tails 7 stick and restore the PV to it
  • Do a manual update via the following commands:
    • sudo apt update && ./securedrop-admin setup - confirm that the Tails 6 venv is destroyed and a Tails 7 version created
    • ./securedrop-admin tailsconfig - confirm that ssh targets, icons, and menu are created
  • Confirm that ./securedrop-admin logs completes successfully, capturing the expected logs
  • Verify that:
    • ./securedrop-admin sdconfig lists the expected config settings
    • A rerun of ./securedrop-admin install completes successfully (may take time over Tor)
  • reboot the admin workstation and verify that:
    • The network hook runs successfully on network connection, and the ssh targets, JI/SI shortcuts, and SecureDrop menu are available.
  • Submit via the source interface, create a journalist account, and reply via the journalist interface. Then, confirm that:
    • ./securedrop-admin backup completes successfully
  • Reply again, run ./securedrop-admin restore <backupname> and confirm that
    • the restore command completes successfully
    • the second reply is not present.

Fresh install on Tails 7

  • On an admin workstation, check out the latest RC and perform a production install, and verify that:
    • ./securedrop-admin setup completes successfully, installing required apt packages and creating a virtualenv with updated dependencies listed above
    • ./securedrop-admin --force sdconfig completes successfully
    • ./securedrop-admin --force install completes successfully
    • ./securedrop-admin --force tailsconfig completes successfully with ssh targets, JI/SI shortcuts (reachable via GNOME search), and SecureDrop menu available.
    • ./securedrop-admin setup -t && ./securedrop-admin verify completes successfully
  • reboot the admin workstation and verify that:
    • The network hook runs successfully on network connection, and the ssh targets, JI/SI shortcuts, and SecureDrop menu are available.
  • Submit via the source interface, create a journalist account, and reply via the journalist interface. Then, confirm that:
    • ./securedrop-admin backup completes successfully
  • Reply again, run ./securedrop-admin restore <backupname> and confirm that
    • the restore command completes successfully
    • the second reply is not present.
  • Confirm that ./securedrop-admin logs completes successfully, capturing the expected logs

Preflight testing

  • On a Tails 6 Admin Workstation:

    • The updater GUI appears on boot
    • The update successfully occurs to 2.12.10 ( but the updater returns an error when trying to run the setup subcommand)
    • After reboot, updater GUI no longer appears
    • securedrop-admin subcommands prompt user to upgrade to Tails 7, and then exit.
  • On a Tails 7 Admin Workstation:

    • After checking out 2.12.10, sudo apt update && ./securedrop-admin setup complete successfully
    • Subsequent securedrop-admin subcommands give their expected responses, without a prompt to upgrade to Tails 7

Clone this wiki locally