docs: clarify operational differences between throttling and postponing cut-over (#1766) by soepic1 · Pull Request #1767 · github/gh-ost

soepic1 · 2026-09-15T14:49:04Z

Resolves #1766

This PR improves the operational documentation for large-scale migrations (100M+ rows / multi-hour executions):

Throttling vs. Postponing Cut-Over: Adds a clear comparison table and best-practice operational workflow detailing why --postpone-cut-over-flag-file is preferred over long-term --throttle-additional-flag-file during scheduled maintenance windows (preventing MySQL wait_timeout disconnects while maintaining real-time binlog sync).
UUID / String Primary Key Guidance: Documents progress percentage behavior (e.g., overshoot past 100% and ETA: due) on tables with lexicographical/UUID primary keys and explains how operators can verify boundary progress.

Closes #1766

docs: clarify replica selection requirements for --throttle-control-replicas

soepic1 added 4 commits July 30, 2026 23:18

docs-clarify-throttle-control-replicas

5114010

Merge pull request #1 from soepic1/soepic1-patch-1

fdef1b0

docs: clarify replica selection requirements for --throttle-control-replicas

docs: condense throttle-control-replicas note per review feedback

ba308c0

Create postpone-cut-over.md

8177de0

soepic1 requested a review from timvaillancourt as a code owner September 15, 2026 14:49

Navigation Menu