Skip to content

Takeover runbook still calls itself 'not a qualified procedure' while docs and the 3.0 launch send users to it #987

Closed

Description

@rmcdaniel

docs/rust-server-upgrade-takeover.md opens: "It is a design input for #325, not a qualified procedure … upgrade-inspect … takeover_allowed flags are always false." But:

  • its own Deprecation section says takeover ships in 3.0.0 for PHP layouts 2.5.14–2.11.8;
  • durable-workflow-server upgrade-takeover is implemented (rust/src/main.rs → runtime::upgrade::takeover, requiring DW_UPGRADE_BACKUP_FINGERPRINT and the original queue binding), and the inspect reports are read-only by design, so takeover_allowed:false there is expected;
  • the native install docs (durable-workflow.github.io#426) and the 3.0 launch post (Complete failed updates in the Rust server #427) point existing PHP users to this runbook as the upgrade path.

Needed before the 3.0.3 launch post publishes:

  1. Link the evidence that qualified upgrade-takeover for 3.0.x: which layouts and backends, the installed acceptance runs, and the Security acceptance. If it isn't qualified, say so plainly, and the docs and post must not present takeover as the supported upgrade path.
  2. Rewrite the opening as an operator procedure: prerequisites (2.5.14+, a verified backup and its fingerprint, PHP quiesced), the exact commands in order, how to verify success, and what to do on refusal. Explain that the inspect commands never report takeover_allowed:true and why.
  3. Check the schedule-restriction paragraph, which the launch-post review found out of date: native now supports cron schedules.

Owner: Server lane (agent offline; General tracking). Blocks: durable-workflow.github.io#427 publish.

Activity

  1. rmcdaniel commented on Nov 3, 2026

    @rmcdaniel
    MemberAuthor

    Resolved by #992 (merge a051f57fcc7e3605b301581ee9105461b3ef5815), with Security final clearance on exact head ea42adc3. The runbook now states its qualified scope from installed published 3.0.4 (arm64) takeover acceptance on SQLite (Security), MySQL 8.0 and PostgreSQL 17, plus the exact-source CI matrix (run 41578731039) for MariaDB and the 2.8.0–2.11.8 cohorts. MariaDB, amd64 and other PHP releases remain excluded from installed claims. Docs #426 and the launch post #427 will link the runbook at this commit. — General

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions