Skip to content

Update backup documentation for foremanctl#4850

Draft
aneta-petrova wants to merge 1 commit into
theforeman:masterfrom
aneta-petrova:foremanctl-backup-restore
Draft

Update backup documentation for foremanctl#4850
aneta-petrova wants to merge 1 commit into
theforeman:masterfrom
aneta-petrova:foremanctl-backup-restore

Conversation

@aneta-petrova
Copy link
Copy Markdown
Member

What changes are you introducing?

Updating backup documentation to use foremanctl rather than foreman-maintain.

Why are you introducing these changes? (Explanation, links to references, issues, etc.)

The foremanctl backup command will replace foreman-maintain backup.

TBD: The other backup scenarios.

Anything else to add? (Considerations, potential downsides, alternative solutions you have explored, etc.)

This PR depends on #4846, which is why I cherry-picked the changes from the other PR so that I could start the foremanctl part already.

Contributor checklists

  • I am okay with my commits getting squashed when you merge this PR.
  • I am familiar with the contributing guidelines.

Please cherry-pick my commits into:

  • Foreman 3.19/Katello 4.21
  • Foreman 3.18/Katello 4.20 (Satellite 6.19)
  • Foreman 3.17/Katello 4.19
  • Foreman 3.16/Katello 4.18 (Satellite 6.18; orcharhino 7.6, 7.7, and 7.8)
  • Foreman 3.15/Katello 4.17
  • Foreman 3.14/Katello 4.16 (Satellite 6.17; orcharhino 7.4; orcharhino 7.5)
  • Foreman 3.13/Katello 4.15 (EL9 only)
  • Foreman 3.12/Katello 4.14 (Satellite 6.16; orcharhino 7.2 on EL9 only; orcharhino 7.3)
  • We do not accept PRs for Foreman older than 3.12.

@github-actions github-actions Bot added Needs tech review Requires a review from the technical perspective Needs style review Requires a review from docs style/grammar perspective Needs testing Requires functional testing labels May 18, 2026
@aneta-petrova aneta-petrova removed Needs tech review Requires a review from the technical perspective Needs style review Requires a review from docs style/grammar perspective Needs testing Requires functional testing labels May 18, 2026
When you run the `{foreman-maintain} backup offline` command, the following default backup directories are created:
When you run the
ifdef::foremanctl[`foremanctl backup offline`]
ifndef::foremanctl[`{foreman-maintain} backup offline`]
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Based on theforeman/foremanctl#507, it looks like backup offline is going away as a separate command and a plain backup will handle the offline backups, with backup online still being available as an alternative.

@aneta-petrova aneta-petrova force-pushed the foremanctl-backup-restore branch from f90b224 to 2f9ff86 Compare May 19, 2026 09:45
@aneta-petrova aneta-petrova force-pushed the foremanctl-backup-restore branch from 2f9ff86 to 04a382e Compare May 20, 2026 08:10
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.

1 participant