Skip to content

Revise restore external documentation for accuracy#367

Open
igroene wants to merge 5 commits into
mainfrom
igroene-patch-15
Open

Revise restore external documentation for accuracy#367
igroene wants to merge 5 commits into
mainfrom
igroene-patch-15

Conversation

@igroene
Copy link
Copy Markdown
Member

@igroene igroene commented May 21, 2026

Updated documentation to reflect changes in restore process and clarify usage of 'last_write_time'. Added optional point in time recovery step.

Updated documentation to reflect changes in restore process and clarify usage of 'last_write_time'. Added optional point in time recovery step.
Clarified instructions on saving oplog slices and replaying them on backups, including updates on physical backups and storage-level snapshots.
Updated links in oplog-replay.md to point to the correct restore documentation for physical and snapshot backups.
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates PBM documentation around external (snapshot-based) restores and oplog replay to better reflect the current restore/PITR flow and clarify how last_write_time should be used.

Changes:

  • Switched restore timestamp wording to reference last_write_time and added an optional post-restore oplog replay (PITR) step in the external restore guide.
  • Reworked oplog-replay documentation structure/wording, including clearer separation for physical vs storage-level snapshot scenarios.
  • Minor formatting/link cleanup (e.g., URL whitespace).

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
docs/usage/restore-external.md Clarifies restore timing via last_write_time and adds an optional oplog replay (PITR) post-restore step.
docs/usage/oplog-replay.md Rephrases/restructures oplog replay docs, adding/clarifying storage-level snapshot guidance and updating related links.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread docs/usage/restore-external.md Outdated
Comment thread docs/usage/restore-external.md Outdated
```

4. Start the balancer and start `mongos` nodes.
4. Optional. Perform point in time recovery by running [`pbm oplog-replay`](./oplog-replay.md#oplog-replay-for-physical-backups) using the `last_write_time` as the start, for example:
Comment thread docs/usage/oplog-replay.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@rasika-chivate rasika-chivate temporarily deployed to igroene-patch-15 - pbm-docs PR #367 May 21, 2026 12:42 — with Render Destroyed
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants