Skip to content

RDoc-3818 - Document responsible-node and grace-period behavior for backup tasks - #2459

Merged
ppekrol merged 2 commits into
ravendb:mainfrom
reebhub:RDoc-3818
Jun 11, 2026
Merged

RDoc-3818 - Document responsible-node and grace-period behavior for backup tasks#2459
ppekrol merged 2 commits into
ravendb:mainfrom
reebhub:RDoc-3818

Conversation

@reebhub

@reebhub reebhub commented May 21, 2026

Copy link
Copy Markdown
Contributor

Issue link

RDoc-3818

Additional description

Document backup behavior: cluster node can start backup while another cluster node already runs backup

Type of change

  • Content - docs
  • Content - cloud
  • Content - guides
  • Content - start pages/other
  • New docs feature (consider updating /templates or readme)
  • Bug fix
  • Optimization
  • Other

Changes in docs URLs

  • No changes in docs URLs
  • Articles are restructured, URLs will change, mapping is required (update /scripts/redirects.json file, set Documents Moved PR label)

Changes in UX/UI

  • No changes in UX/UI
  • Changes in UX/UI (include screenshots and description)

@reebhub
reebhub requested a review from grisha-kotler May 21, 2026 23:42

When the current responsible node enters the `Rehab` state,
the cluster observer waits a configurable grace period (30 minutes by default)
before moving the task to another node.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

An exception is a task pinned to its mentor node (PinToMentorNode),
which is not reassigned while the node remains in the database group.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

added clarifications in backup/faq and highly available tasks pages

Comment thread docs/backup/faq.mdx
Instead, it waits a grace period (30 minutes by default) before reassigning the task
to another database-group member.
The grace period gives the original node a chance to recover,
and prevents the same backup from running on two nodes at once.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Worth mentioning the pinned case here — a pinned task behaves differently from what this section implies:
If the task is **pinned** to its mentor node (PinToMentorNode), it is not reassigned as long as that node remains in the database group — even while in Rehab, and even after the grace period expires. It is only moved to another node if the pinned node is removed from the database group.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

done

@ppekrol
ppekrol merged commit 659ef74 into ravendb:main Jun 11, 2026
1 check passed
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