Skip to main content

Migration

Migration Strategy​

  1. Stand up Thermocline in a staging environment.
  2. Replay representative traffic and data.
  3. Validate operator/stage behavior by tier using the compatibility matrix.
  4. Run exhaustive MQL parity tests before production cutover.

Minimum Validation Gate​

make test-fast
make test-local
make e2e-all-local
make mql-exhaustive
make mql-coverage-audit

Application Cutover​

Change only the connection string endpoint:

- mongodb://old-host:27017/appdb
+ mongodb://thermocline-host:27017/appdb

Hot/Cold/Federated Validation​

For each critical query path:

  • Verify result correctness against expected data.
  • Verify behavior across hotOnly, coldArchival, and federated policies.
  • Confirm performance envelopes for your workload.

Compatibility Truth Source​

Use Compatibility as the authoritative support matrix. Avoid assuming "full" support outside the matrix entries and notes.

Source of Truth​

  • docs/COMPATIBILITY.md
  • tests/e2e/matrix/mql_language/test_semantic_parity_hot_cold_federated.py
  • scripts/test/run-e2e-tests.sh