BigBlueButtonで自動録画クリーンアップを設定する方法

BigBlueButtonサーバーでは、録画データの保存容量が急速に増加する可能性がありますが、「クリーンアップ」には大きく異なる2つの意味があります。1つは録画公開後に元のデータを削除すること、もう1つは保存期間経過後に公開済みの録画データ自体を削除することです。どちらかを誤ると、ディスク容量を無駄に消費したり、ユーザーが想定するよりも早くコンテンツを削除してしまう可能性があります。

このガイドは、公式ドキュメントで2026年10月時点の最新製品版ブランチとして記載されているBigBlueButton 3.0に焦点を当てています。BigBlueButton 4.0のドキュメントは入手可能ですが、まだ開発中とされています。本番システムでは、bbb-conf --check別のブランチのドキュメントから保持設定をコピーする前に、インストールされているバージョンを確認してください。公式のBigBlueButtonインストールドキュメントを参照してください。

変更を加える前に、クリーンアップポリシーを選択してください。

すべての導入形態に適合する単一の保存期間はありません。大学では学期を通して再生アクセスが必要な場合もあれば、社内研修サーバーでは30日間の録画データのみが必要な場合もあります。重要なのは、生の録画データと公開された再生ファイルとの区別です。

BigBlueButtonの公式カスタマイズガイドによると、処理が失敗した場合に管理者が録画を再構築したり、別の録画フォーマットを追加したり、誤って削除してしまった場合に復旧したりできるように、生データが保持されます。ただし、この利点にはストレージコストがかかります。同じドキュメントには、BigBlueButtonはデフォルトで公開された録画の生データを14日後に削除すると記載されています。詳細は、BigBlueButtonの公式ドキュメントの「サーバーのカスタマイズ」を参照してください。

オプション1：公開済みの録音データは残すが、生データは削除する

主な問題がディスク使用量であるものの、ユーザーが再生リンクを必要とする場合は、組み込みの生データ保持設定から始めてください。BigBlueButton の日常メンテナンス スクリプトは にあります/etc/cron.daily/bigbluebutton。ドキュメントに記載されているデフォルト値は次のとおりです。

published_days=14

このスクリプトは、公開された録画データに対して、生の録画データのクリーンアップ機能も呼び出します。この値を大きくするとpublished_days、再構築のための復旧期間が長くなり、小さくすると、ストレージ使用量がより早く削減されます。管理者が録画データの不具合を発見するのに通常時間を要する場合は、30日といった値が妥当でしょう。一方、ストレージ容量が限られており、会議後すぐに公開された出力を確認する場合は、より短い期間の方が適切です。

これは完全なデータ保持ポリシーとは異なります。変更しても、published_days公開された録音データ自体がその日数後に消えるわけではありません。これは、公開後に生データが利用可能な状態を維持する期間を制御するものです。

オプション2：一定期間より古い録画データをすべて削除する

要件が「録画データは30日後に削除する必要がある」である場合、BigBlueButtonは個別の日次クリーンアップスクリプトを文書化しています。公式の例では/etc/cron.daily/bbb-recording-cleanup、ファイルを作成し、公開されたステータスファイルと生の録画データの経過時間を確認し、bbb-record --delete設定された最大経過時間よりも古い録画データに対してコールバックを実行します。

削除を有効にする前に、候補セットを確認してください。30日間のポリシーの場合、この読み取り専用コマンドを使用すると、どの公開済みプレゼンテーションステータスファイルがしきい値よりも古いかを確認できます。

sudo find /var/bigbluebutton/recording/status/published \
  -type f -name '*-presentation.done' -mtime +30 -print

これはBigBlueButtonのドライランコマンドではなく、単なるファイルシステムの安全性チェックです。自動化されたジョブがデータ削除を開始する前に、ポリシーの誤りを検出するために使用してください。

クリーンアップスクリプトを作成する

作成します/etc/cron.daily/bbb-recording-cleanup。以下の実装は、BigBlueButtonの公式カスタマイズガイドに記載されているパスと削除方法に従いつつ、保持値とログファイルを簡単に見つけられるようにしています。

#!/bin/bash
set -u

MAXAGE=30
LOGFILE=/var/log/bigbluebutton/bbb-recording-cleanup.log
NOW=$(date +%s)

shopt -s nullglob

for donefile in /var/bigbluebutton/recording/status/published/*-presentation.done; do
    MTIME=$(stat -c %Y "$donefile")
    AGE=$(( (NOW - MTIME) / 86400 ))

    if [ "$AGE" -gt "$MAXAGE" ]; then
        MEETING_ID=$(basename "$donefile")
        MEETING_ID=${MEETING_ID%-presentation.done}
        echo "$(date --rfc-3339=seconds) deleting $MEETING_ID age=${AGE}d" >> "$LOGFILE"
        bbb-record --delete "$MEETING_ID" >> "$LOGFILE" 2>&1
    fi
done

for eventsfile in /var/bigbluebutton/recording/raw/*/events.xml; do
    MTIME=$(stat -c %Y "$eventsfile")
    AGE=$(( (NOW - MTIME) / 86400 ))

    if [ "$AGE" -gt "$MAXAGE" ]; then
        MEETING_ID=${eventsfile%/events.xml}
        MEETING_ID=${MEETING_ID##*/}
        echo "$(date --rfc-3339=seconds) deleting raw $MEETING_ID age=${AGE}d" >> "$LOGFILE"
        bbb-record --delete "$MEETING_ID" >> "$LOGFILE" 2>&1
    fi
done

ポリシーに基づいて設定してくださいMAXAGE。恣意的に低い数値を設定しないでください。たとえば、30日間は90日間よりもストレージ容量は小さくなりますが、復元およびアクセス可能な期間が短くなります。録音データが正式な保存要件の一部である場合は、削除を有効にする前に、データ所有者とポリシーを確認してください。

日々のスクリプトを実行可能にする

sudo chmod +x /etc/cron.daily/bbb-recording-cleanup
sudo ls -l /etc/cron.daily/bbb-recording-cleanup

ファイル名には意図的に拡張子を付けていません。Ubuntuのデイリージョブの仕組みでは、通常 `.` を使用しますがrun-parts、そのファイル名規則によっては、ドットを含むファイル名がスキップされる場合があります。ドキュメントに記載されているファイル名を使用することで、bbb-recording-cleanupこのような不要な混乱を避けることができます。

トレードオフとなる/etc/cron.dailyのは、正確なタイミングよりもシンプルさです。トラフィックの少ない時間帯にクリーンアップを実行する必要がある場合は、ルートのcronエントリまたはsystemdタイマーを使用することで、より厳密なスケジュール設定が可能になりますが、これはBigBlueButtonのドキュメントに記載されているデフォルト設定ではなく、独自のオペレーティングシステムカスタマイズになります。別途追跡およびテストを行ってください。

自動化を信頼する前に、一度手動でクリーンアップを実行してください。

候補ファイルを確認した後、シェルからスクリプトを一度実行してください。

sudo /etc/cron.daily/bbb-recording-cleanup
sudo tail -n 50 /var/log/bigbluebutton/bbb-recording-cleanup.log

BigBlueButtonのドキュメントにbbb-record --delete <internal-meeting-id>は、このコマンドは会議のデータと録画を削除するコマンドとして記載されています。録画に関するドキュメントには、このコマンドが実行中の会議を消去する可能性があることも警告されています。そのため、適切な保持ポリシーでは、アクティブな会議が決して該当しない十分な期間のしきい値を設定し、古い録画アーティファクトから検出されたIDのみを削除します。詳細については、公式の録画および再生に関するドキュメントを参照してください。

クリーンアップが意図したとおりに機能していることを確認してください。

検証は、ユーザーが確認できる録画とディスク使用量の両方を対象とする必要があります。まずは、BigBlueButton独自の録画コマンドから始めましょう。

sudo bbb-record --list-recent
sudo bbb-record --check

bbb-record --list-recent最新の録画10件を表示します。BigBlueButton bbb-record --check2.5以降で録画構成と権限を確認します。どちらのコマンドもストレージ監視に代わるものではないため、録画ツリーも測定してください。

df -h /var/bigbluebutton
sudo du -sh /var/bigbluebutton/recording /var/bigbluebutton/published

再生時に表示されるディスク使用量と全く同じ量だけディスク使用量が減少するとは限りません。生メディア、処理ファイル、公開プレゼンテーションファイル、ログ、一時データはそれぞれ別々に保存されるため、クリーンアップのタイミングはカテゴリによって異なる場合があります。

保存期間の選び方

適切なデータ保持期間は、ユーザーの期待、復旧ニーズ、利用可能なストレージ容量という3つの制約によって決まります。保持期間を短くするとストレージへの負荷は軽減されますが、管理者が処理上の不具合を発見したり、録画を再構築したりする時間が短くなります。保持期間を長くすると復旧の柔軟性は高まりますが、より多くのディスク容量が必要となり、データ最小化の要件と矛盾する可能性があります。

• 再生機能は維持しつつ、生データの保存容量を最小限に抑える：調整を行いpublished_days、公開済みの録音データはそのまま残す。
• ハード再生期限を強制する:明確に文書化された別の日次クリーンアップスクリプトを使用するMAXAGE。
• コースごと、または顧客ごとのルールが必要です。録画の保持に関する決定はLMSまたはアプリケーション層に置き、すべての録画にサーバー全体で共通の保持期間を強制するのではなく、BigBlueButtonのAPIを意図的に使用してください。
• 再構築の柔軟性が必要：生データを最低限よりも長く保持し、バックアップ容量がその選択に見合うようにする。

避けるべきよくある間違い

よくある間違いの1つ目は、published_days公開済みの録画を削除すると想定することです。これは、公開済みの録画に関連付けられた生データのみを管理します。2つ目は、rm -rfBigBlueButtonの録画ディレクトリを主要な保持メカニズムとして使用することです。これは、録画ツールが持つ会議IDの認識を回避し、矛盾した状態を残す可能性があります。

もう一つの間違いは、実際の成長を測定する前に、保持期間を過度に設定してしまうことです。少なくとも数日分のデータduとdfデータをキャプチャし、異常に忙しい週に備えて十分な余裕を持たせた期間を選択してください。BigBlueButtonの運用要件自体が相当量の記録ストレージを必要とすることからもわかるように、クリーンアップはファイルシステムがほぼ満杯になった後の緊急対応ではなく、容量管理として設計されるべきです。

最終チェックリスト

• インストールされている BigBlueButton のバージョンを で確認してくださいbbb-conf --check。
• 生データのクリーンアップのみが必要なのか、それとも録画データの有効期限を完全に管理する必要があるのか​​を決定してください。
• 保存期間を選択する前に、現在のストレージ使用量を測定してください。
• 削除を有効にする前に、古い録画候補を確認してください。
• 日々のクリーンアップスクリプトを作成し、実行可能にしてください。
• 一度手動で実行して、ログを確認してください。
• bbb-record --list-recent、bbb-record --checkおよびディスク使用量を再確認してください。
• 再生がどのくらいの期間利用可能かユーザーが把握できるよう、保持ポリシーを文書化してください。

ほとんどのシングルサーバー構成のBigBlueButton 3.0では、メンテナンスの手間を最小限に抑えるには、組み込みのデイリージョブで一定期間後に公開済み録画の生データを削除し、bbb-recording-cleanup公開済み録画の有効期限を設定する必要がある場合のみ、ドキュメントに記載されているデイリースクリプトを追加するのが最善の方法です。これにより、2つの異なるストレージに関する決定事項が分離され、すべての古い録画ファイルを同じように扱うのではなく、トレードオフが明確になります。