Skip to content

docs: update disaster recovery chapter#2310

Merged
BareosBot merged 5 commits intobareos:masterfrom
pstorz:dev/pstorz/master/desaster-recovery-docs
Jul 11, 2025
Merged

docs: update disaster recovery chapter#2310
BareosBot merged 5 commits intobareos:masterfrom
pstorz:dev/pstorz/master/desaster-recovery-docs

Conversation

@pstorz
Copy link
Member

@pstorz pstorz commented Jun 27, 2025

This PR aims to improve the Disaster Recovery chapter

  • It also contain commit to fix broken links
  • It contain also commit to last resource/config name improvement

Please check

  • Short description and the purpose of this PR is present above this paragraph
  • Your name is present in the AUTHORS file (optional)

If you have any questions or problems, please give a comment in the PR.

Helpful documentation and best practices

Checklist for the reviewer of the PR (will be processed by the Bareos team)

Make sure you check/merge the PR using devtools/pr-tool to have some simple automated checks run and a proper changelog record added.

General
  • Is the PR title usable as CHANGELOG entry?
  • Purpose of the PR is understood
  • Commit descriptions are understandable and well formatted
  • Required backport PRs have been created
  • Correct milestone is set
Source code quality
  • Source code changes are understandable
  • Variable and function names are meaningful
  • Code comments are correct (logically and spelling)
  • Required documentation changes are present and part of the PR

@pstorz pstorz added the documentation This PR changes only documentation label Jun 27, 2025
@arogge arogge requested a review from bruno-at-bareos July 1, 2025 09:53
Copy link
Contributor

@bruno-at-bareos bruno-at-bareos left a comment

Choose a reason for hiding this comment

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

First round of lecture, a few details might be to adjusted.
Nice improvements.

I will redo it step by step, and we might want to discuss a bit more in depth about restoring the configuration.
When we do the bextract, we normally get it from the same jobs.

@bruno-at-bareos bruno-at-bareos added this to the 25.0.0 milestone Jul 2, 2025
Copy link
Contributor

@bruno-at-bareos bruno-at-bareos left a comment

Choose a reason for hiding this comment

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

see suggestions for postgres

@bruno-at-bareos
Copy link
Contributor

After a full real testing, there's an issue of chicken and eggs.

We first state

``bextract`` allows you to extract data directly from Bareos media. It does not need a functioning storage daemon configuration file and is therefore suitable as a basic tool when all other restoring methods fail.

but then we have two paragraph later

bextract now extracts the data specified in the <Bootstrap file> to the <output directory> using drive <drive name>. bextract consults the storage daemon configuration file to determine how to address the drive.

🙄

Which means from my understanding and experiments that we have to deeply insist to have a copy of the configuration outside of the volume, otherwise you can't access it from the volume, and replace formulation like

it might be a good idea to have a copy ....

by something more imperious like

a outside copy of the configuration is mandatory

To be done:
in manual disaster recovery, you have to redefine manually the storage device used to write that volume. Of course if it is the default FileStorage, this one come preconfigured with the packages you just reinstalled.
otherwise use your external copy of configuration.

Copy link
Member Author

@pstorz pstorz left a comment

Choose a reason for hiding this comment

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

Please see my comments :)

@bruno-at-bareos bruno-at-bareos force-pushed the dev/pstorz/master/desaster-recovery-docs branch from d7ec09b to 63f218d Compare July 10, 2025 07:52
@bruno-at-bareos bruno-at-bareos self-requested a review July 10, 2025 07:54
Copy link
Contributor

@bruno-at-bareos bruno-at-bareos left a comment

Choose a reason for hiding this comment

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

Nice improvement, great work.

pstorz and others added 3 commits July 11, 2025 14:43
- global improvements removing obsoleted instructions
- use correct syntax for titles
- use ``su postgres`` call for db scripts
- use code-block to separate command from result
- add preliminary step to reinstall the software
- add warning about keeping a separated copy of configuration
- fix bextract and bls requirement (sd configuration is needed)
- improve code block in restore steps
- change ``Bareos uses the same data format for all data carriers``
  as is no more strictly correct for dedupable backend.
  However, the API stays the same that is spoken to the backends.

Co-authored-by: Philipp Storz <philipp.storz@bareos.com>
@BareosBot BareosBot force-pushed the dev/pstorz/master/desaster-recovery-docs branch from 746b93d to 9a19192 Compare July 11, 2025 14:43
@BareosBot BareosBot merged commit d260611 into bareos:master Jul 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants