-
Notifications
You must be signed in to change notification settings - Fork 81
Document --remote-address-resolution
#2584
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: dev
Are you sure you want to change the base?
Conversation
6d7bc16
to
0d0cd2a
Compare
This PR includes documentation updates Updated pages: |
When enabled, the DBMS automatically selects the most appropriate servers to act as backup sources for a given database. | ||
|
||
By default, the online backup command requires the user to determine which servers host the target database and direct the command to one of them. | ||
With remote address resolution enabled, the DBMS performs this mapping automatically, removing the need for manual server selection. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
With remote address resolution enabled, the DBMS performs this mapping automatically, removing the need for manual server selection. | |
With remote address resolution enabled, the DBMS performs this mapping automatically, removing the need for manual server selection. | |
The server selection occurs in the following order: | |
* The DBMS first selects all servers hosting the database in secondary mode. | |
* If it is not possible to back up from one of the secondaries, the DBMS attempts to take a backup from the primary followers before finally trying the database primary writer. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@jackwaudby, what do you think? ⬆️ Or it sounds confusing?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
primary reader -> primary follower
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"If those are not available" -> I think we are better saying if unable to take backup from one of the secondaries then the DBMS will attempt to backup from the primary followers, before finally trying the primary writer
|
||
Starting from 2025.09, you can use the `--remote-address-resolution` option to let the DBMS select which servers to use as backup sources. | ||
See xref:backup-restore/online-backup.adoc#_using_remote_address_resolution[] for more details. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it would be good to add info about the new option also on this page, where we talk about some general concepts and planning of backup and restore operations.
No description provided.