Windows と Linux への Bernard Review のインストール、開放するポート、オフラインでの利用、設定・ログ・クラッシュレポートの場所。
このページは、スタジオのワークステーションを管理する方向けです。プレーヤーは、サイトのダウンロードページから、アカウント不要で無料でダウンロードでき、各ファイルの SHA-256 フィンガープリントも掲載されています。
システム:Windows 10 または 11(64 ビット)。OpenGL 3.0 以降に対応したグラフィックスカード(4K と EXR には NVIDIA を推奨)。
インストーラー:BernardReview-<version>-win64.exe。管理者が実行します。C:\Program Files\Bernard Review にインストールされ、プログラムは bin\BernardReview.exe で、スタートメニューに Bernard Review のエントリが作成されます。
サイレントインストール(展開ツール、スクリプト向け):/S でウィンドウなしにインストールします。/D= でフォルダーを指定します。必ず最後に置き、スペースを含む場合でも引用符は付けません。
start /wait BernardReview-<version>-win64.exe /S /D=C:\Program Files\Bernard Review
echo %ERRORLEVEL%
終了コードで結果がわかります。
| コード | 意味 | 対処 |
|---|---|---|
| 0 | インストール完了 | なし |
| 3 | インストールフォルダーからプレーヤー(またはストリーミング補助プログラムを含む、そのフォルダー内のプログラム)が起動している。インストーラーは即座に停止し、何も書き込まなかった | プレーヤーを閉じてから、もう一度インストールを実行する |
別のフォルダーから起動しているプレーヤーは、インストールを妨げません。インストーラーがプレーヤーを自分で閉じることはありません。保存していないレビューが失われるためです。PowerShell では、(Start-Process .\BernardReview-<version>-win64.exe -ArgumentList '/S' -Wait -PassThru).ExitCode で終了コードを取得できます。
サイレントインストールは、古い BernardPlayer を確認なしでアンインストールします。 初期の BernardPlayer のバージョン(C:\Program Files\BernardPlayer <version> というフォルダー)が見つかると、対話式のインストールは先にアンインストールするかどうかを尋ねます。/S では「はい」と答えたことになり、それらのアンインストーラーがサイレントで実行されます。このようなワークステーションに展開する場合は、その点を承知のうえで行うか、事前に削除してください。/NOASSOC は、コンポーネントのページでどのように選択されていても、ファイルの関連付けを一切書き込まずにインストールします(どのファイルをプレーヤーで開くかをパイプライン側で決める場合に使います)。
ファイアウォール:インストーラーは、プログラム用の受信規則 Bernard Review (LAN sessions) を、Domain と Private のプロファイルにのみ追加します。Public には追加しません(ストリーミング補助プログラムを同梱している場合は Bernard Review (stream companion) も追加します)。アンインストールすると削除されます。
SmartScreen:インストーラーにはまだコード署名がないため、Windows が「発行元不明」と表示することがあります。まずフィンガープリントを確認してください。
Get-FileHash -Algorithm SHA256 .\BernardReview-<version>-win64.exe
そのうえで 詳細情報 と 実行 を選びます。
アプリケーション制御(AppLocker、WDAC):プログラムには署名がありません。パスまたはハッシュによる規則が適用でき、ハッシュ規則はバージョンごとに更新する必要があります。
RHEL 8、9、10 互換のシステム(Rocky Linux、AlmaLinux、Red Hat Enterprise Linux)の x86-64 プロセッサー向けです。
RPM パッケージ:ワークステーションのすべてのユーザー向け(管理者権限が必要)。
sudo dnf install ./bernard-review-<version>-Linux.rpm
コマンドは bernard-review です。
自己展開アーカイブ:ホームフォルダー内に、管理者権限なしでインストールします。
mkdir -p ~/bernard-review
sh ./bernard-review-<version>-Linux.sh --prefix=$HOME/bernard-review --exclude-subdir
~/bernard-review/bin/bernard-reviewUbuntu 用の DEB パッケージ:Ubuntu でのテスト完了後に、近日対応予定です。
ダイアログ:ファイル選択ダイアログはデスクトップ側のもの(zenity、kdialog、qarma)が使われます。パッケージは zenity を推奨しています。どれもインストールされていない場合、プレーヤーは起動時と、ダイアログが必要になったときに、その旨を表示します:sudo dnf install zenity。
カメラ RAW(RED、ARRI、Blackmagic RAW):現時点では Windows のみです。Linux と macOS は近日対応予定です。
macOS:近日対応予定です。
再生、注釈、書き出し、スタジオのネットワーク上のセッションは、完全にオフラインで動作します。インターネット接続は不要です。
| ポート | 方向 | 使われるとき | 開放が必要か |
|---|---|---|---|
| TCP 9000 | 受信。スタジオのネットワークまたは VPN から | このワークステーションがレビューセッションをホストしている間 | ホストのみ |
| TCP 5556 | ループバック(127.0.0.1) | 常時:オートメーション用ポート。Python API と IPCを参照 | 不要 |
| TCP 8080 | ループバック | Google アカウントのサインイン中(最長 5 分) | 不要 |
| TCP 443 送信 | トラッカーのサイトへ | Tracker ウィンドウを使っている間 | プロキシの構成による |
ゲストに受信ポートは不要です。接続はすべて送信方向です。「このコンピューターのみ」のセッションは、ループバックだけで待ち受けます。
Linux でポート 9000 を開放する。 パッケージには定義ファイルが付属していますが、有効化はされていません。
# firewalld (Rocky Linux, AlmaLinux, RHEL)
sudo firewall-cmd --permanent --zone=<zone> --add-service=bernard-review
sudo firewall-cmd --reload
# ufw (Ubuntu)
sudo ufw allow from <subnet> to any port 9000 proto tcp
<zone> は社内ネットワークのゾーンに、<subnet> はスタジオのサブネットに置き換えてください。Windows のファイアウォールをグループポリシー(GPO)が管理していてローカルの規則が無視される場合は、ポリシー側に規則を追加します。TCP 9000 の受信、対象はこのプログラム、Domain と Private のプロファイルです。
オンラインセッション。 サービスのリレーを経由し、送信接続のみを使います。
| 宛先 | ポート | 役割 | 開放が必要か |
|---|---|---|---|
review.bernardengine.com | TCP 443 | HTTPS と WSS:同期、ゲスト用の Web ページ、ビデオのシグナリング | 必要 |
turn.review.bernardengine.com | TCP 443 | ほかの経路が通らないときのビデオと音声 | 443 しか開いていない場合は必要 |
review.bernardengine.com | UDP 50000-50100 | ライブのビデオと音声 | 推奨 |
review.bernardengine.com | TCP 7881 | UDP が閉じているときの、ビデオと音声のフォールバック | UDP が閉じている場合は推奨 |
turn.review.bernardengine.com | UDP 3478 | UDP 上の TURN | 任意 |
この 2 つの名前への送信 TCP 443 だけでも、すべてが動作します。遅延はわずかに増えます。プロキシは、これらの名前へのポート 443 の CONNECT を許可し、TLS 検査の対象から外し、アイドル状態の接続を 120 秒未満で切断しないようにしてください。ワークステーションから確認するには、次のようにします。
curl -sS https://review.bernardengine.com/api/v1/health
期待される応答には "status":"ok" が含まれます。
トラッカー。 Kitsu、ftrack、Flow へは、各サイトのアドレスに HTTPS で、サイトのプロキシまたは環境のプロキシ(HTTPS_PROXY、NO_PROXY)を通じて接続します。証明書は常に、システムのストア、またはサイトの認証局ファイルに対して検証されます。
| システム | プロファイルフォルダー |
|---|---|
| Windows | %APPDATA%\BernardReview\ |
| Linux | ~/.config/bernard-review/(または $XDG_CONFIG_HOME/bernard-review/) |
ここには、次のようなものが入っています。
player_debug.log(ログ):実際のイベント(クリップの読み込み、デコードエラーなど)だけを記録し、8 MB を超えると player_debug.log.1 にローテーションされます。crashes\(クラッシュレポート):Windows では .dmp のミニダンプ、Linux では .txt のテキストレポートで、名前は UTC の crash-<date>-<time>-<version> です。保持されるのは最新の 5 件だけです。ログの最終行に、書き出されたレポートの名前が記録されます。session_config.json(環境設定、最後のセッション)、keymap.json(ショートカット)、naming_rules.json(Version Board の命名ルール)、trackers.json(シークレットを含まないトラッカーのサイト)、そして color_presets、export_presets、export_recipes、tracker-media の各フォルダー。問題を報告するには、Help > Send Log to the Bernard Team... を使います。マシンから実際に送信される内容(ログ、チェックを入れた場合に限り最新のクラッシュレポート、バージョン、システム情報)がそのまま表示され、任意のメモを添えられ、Send をクリックするまで何も送信されません。送信後は、連絡の際に伝えるレポート ID が表示されます。ネットワークがない場合は、Open Log Folder からファイルを別の方法で送れます。クラッシュのあとの次回起動では、先に確認が表示されます。Help > About... > Copy System Info は、ユーザー名、マシン名、パス、アドレスを含まない、マシンとライブラリの概要をコピーします。
診断。 環境変数 BERNARDPLAYER_VERBOSE=1 を設定すると、詳細なトレースが追加されます(使用後は削除してください)。BERNARDPLAYER_NO_CRASH_HANDLER=1 を設定すると、デバッガーでクラッシュを捕捉できます。--self-crash を付けて起動すると、意図的にクラッシュさせ、レポートが書き込まれることを確認できます。
set BERNARDPLAYER_VERBOSE=1
"C:\Program Files\Bernard Review\bin\BernardReview.exe"
シークレット。 トラッカーのシークレットは、システムの資格情報ストア(Windows の資格情報マネージャー、Linux の Secret Service)に保存されます。アカウントのサインインデータは、Windows では DPAPI で暗号化されます。
リモートアクセスツールや画面共有(Splashtop、Teams、OBS)が、Windows でフルスクリーン再生をカクつきながら受信する場合は、共有している間、環境設定で Present through DWM (smooth screen sharing) にチェックを入れてください。既定ではオフです。ローカルの画面で、フレームが数回繰り返されるという代償があります。
このプレーヤーは、以前のバージョンでは BernardPlayer という名前でした。インストーラーは古いインストールを置き換え、初回起動時に古い設定フォルダー(%APPDATA%\BernardPlayer、~/.config/bernardplayer)を変更せずにコピーします。移行期間中は、BernardPlayer.exe と bernardplayer でもプレーヤーが起動します。名前でプログラムを終了させるスクリプトは、両方の名前を指定してください。
さらに詳しくは、完全版マニュアルのパート 12 と 13(プレーヤーの Help > User Guide)、およびサイトの IT 部門向けページを参照してください。
起動時に、お使いのシステム向けの新しいリリースがあるかどうかを、バックグラウンドで確認します(送信するのはバージョン番号だけです)。新しいリリースがあると、バナーに、Windows では Update(Linux と macOS ではダウンロードページへの Download)、What's New(プレーヤー内に表示されるリリースノート)、Later が表示されます。Update はインストーラーをバックグラウンドでダウンロードし、サイズと SHA-256 をサイトが告知している値と照合します(一致しないものは実行されません)。そのあと、プレーヤーが待機状態(再生、セッション、書き出し、入力のいずれもない状態)になると、Restarting to install in 10 s のカウントダウンが始まります(Restart Now、Not Now)。0 になるとプレーヤーはセッションを保ったまま閉じ、インストーラーがサイレントで実行され(UAC は引き続き管理者の確認を求めます)、プレーヤーはユーザー自身のアカウントで、セッションを元のままにして再び開きます。Update をクリックしない限り何も起こらず、再生、セッション、書き出しの最中に実行されることもありません(待機します)。Not Now を選ぶか、手動で閉じた場合は、閉じるときにインストールされ、プレーヤーは再起動されません。Preferences > General > Updates: Ask / Never で確認をオフにできます。IT 部門は、環境変数 BERNARD_NO_UPDATE_CHECK=1、レジストリキー HKLM\Software\AArts Lab\Bernard Review\NoUpdateCheck=1(Windows)、または {"update_check": false} を含むファイル /etc/bernard-review/policy.json(Linux)で、これを強制できます。