Skip to content

add media_vault tool to contrib#2357

Merged
BareosBot merged 6 commits intomasterfrom
dev/bruno/master/media_vault
Oct 8, 2025
Merged

add media_vault tool to contrib#2357
BareosBot merged 6 commits intomasterfrom
dev/bruno/master/media_vault

Conversation

@bruno-at-bareos
Copy link
Contributor

@bruno-at-bareos bruno-at-bareos commented Sep 2, 2025

Media Vault Management

This utility aims to help administrator to select and export tapes from an autoloader and then placed into an external vault location.

It is written in python3 (minimal version 3.6), and use python_bareos module to interact with the director over a dedicated console.

It has a lot of options you can setup in the dedicated media_vault.ini config file.
Documentation is contained in related README.md file

It is proposed to be packaged and distributed with the bareos-contrib-tools packages available for deb and rpm systems.

Thank you for contributing to the Bareos Project!

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
Tests
  • On a fail, output of the test leads quickly to the origin of the fault

@bruno-at-bareos bruno-at-bareos added this to the 25.0.0 milestone Sep 2, 2025
@bruno-at-bareos bruno-at-bareos added enhancement python Pull requests that update Python code requires no backport This will not be backported labels Sep 2, 2025
@bruno-at-bareos bruno-at-bareos self-assigned this Sep 2, 2025
@bruno-at-bareos bruno-at-bareos force-pushed the dev/bruno/master/media_vault branch 2 times, most recently from fd64c6c to 68da31e Compare September 8, 2025 11:44
@arogge arogge removed this from the 25.0.0 milestone Sep 9, 2025
@bruno-at-bareos bruno-at-bareos force-pushed the dev/bruno/master/media_vault branch from 07c0988 to 5e19956 Compare September 18, 2025 09:00
Copy link
Contributor

@sebsura sebsura left a comment

Choose a reason for hiding this comment

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

I just looked at the documentation a bit. There are some parts that I think could be cleared up.

There were also some files missing the copyright header, so dont forget to add them!

- minimal size the tape need to have (for example 4TB)
- max age backward period considered (up to which date in the past,
for example 21 days)
- min age, minimal wait time (don't considered volumes more fresh
Copy link
Contributor

Choose a reason for hiding this comment

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

At least for me, i would not be able to tell with 100% certainty what the "freshness"/"age" of a volume is.
"time since lastwritten makes sense ofc, but so would "time since last use" etc.

I added some suggestions to the ini file which may clear this up.

@bruno-at-bareos bruno-at-bareos force-pushed the dev/bruno/master/media_vault branch 2 times, most recently from cc1b19f to 58c7fea Compare October 1, 2025 09:31
bruno-at-bareos and others added 4 commits October 2, 2025 16:56
media_vault utility helps administrators to select and export tapes
from autoloader for placement into an external vault location.

It is written in Python 3 (minimum version 3.6) and uses the
``python_bareos`` module to interact with the Director.

Signed-off-by: Bruno Friedmann <bruno.friedmann@bareos.com>
Co-authored-by: Sebastian Sura <124262655+sebsura@users.noreply.github.com>
@bruno-at-bareos bruno-at-bareos force-pushed the dev/bruno/master/media_vault branch from 053edc7 to 38faf24 Compare October 2, 2025 14:59
- volume size
- volume return date
@bruno-at-bareos bruno-at-bareos force-pushed the dev/bruno/master/media_vault branch from 03cfed1 to 0984e69 Compare October 6, 2025 11:41
Copy link
Contributor

@sebsura sebsura left a comment

Choose a reason for hiding this comment

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

looks good to me! Thanks for the great work.

@BareosBot BareosBot merged commit 8b7d39a into master Oct 8, 2025
1 check was pending
@BareosBot BareosBot deleted the dev/bruno/master/media_vault branch October 8, 2025 18:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement python Pull requests that update Python code requires no backport This will not be backported

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants