Installation und IT

Diese Seite richtet sich an die Personen, die die Arbeitsplätze eines Studios verwalten. Der Player lässt sich kostenlos und ohne Konto von der Download-Seite der Website herunterladen, mit dem SHA-256-Fingerabdruck jeder Datei.

Windows

• System: Windows 10 oder 11, 64 Bit; eine Grafikkarte mit OpenGL 3.0 oder höher (NVIDIA empfohlen für 4K und EXR).

• Installer: BernardReview-<version>-win64.exe, von einem Administrator auszuführen. Er installiert nach C:\Program Files\Bernard Review, das Programm ist bin\BernardReview.exe, und legt den Startmenü-Eintrag Bernard Review an.

• Stille Installation (Deployment-Tools, Skripte): /S installiert ohne Fenster; /D= wählt den Ordner und muss zuletzt stehen, ohne Anführungszeichen, auch bei Leerzeichen:

  start /wait BernardReview-<version>-win64.exe /S /D=C:\Program Files\Bernard Review
  echo %ERRORLEVEL%

  Der Exit-Code sagt, was geschehen ist:

  Code	Bedeutung	Was zu tun ist
  0	installiert	nichts
  3	der Player (oder ein Programm seines Ordners, einschließlich des Streaming-Begleiters) ist aus dem Installationsordner heraus geöffnet: Der Installer hat sofort angehalten und nichts geschrieben	die Installation erneut ausführen, sobald der Player geschlossen ist

  Ein Player, der aus einem anderen Ordner geöffnet ist, hält die Installation nicht an. Der Installer schließt den Player nie selbst: Ein noch nicht gespeichertes Review ginge verloren. In PowerShell liest (Start-Process .\BernardReview-<version>-win64.exe -ArgumentList '/S' -Wait -PassThru).ExitCode den Code.

  Eine stille Installation deinstalliert einen alten BernardPlayer ohne Nachfrage. Findet sie eine der ersten BernardPlayer-Versionen (einen Ordner C:\Program Files\BernardPlayer <version>), fragt eine interaktive Installation, ob diese zuerst deinstalliert werden sollen; /S antwortet für Sie mit Ja und führt deren Deinstaller still aus. Rollen Sie auf einem solchen Arbeitsplatz in Kenntnis dessen aus oder entfernen Sie sie vorher. /NOASSOC installiert, ohne irgendeine Dateizuordnung zu schreiben, was auch immer die Komponentenseite gewählt hätte (eine Pipeline, die selbst entscheidet, welche Dateien im Player geöffnet werden).

• Firewall: Der Installer fügt für das Programm die eingehende Regel Bernard Review (LAN sessions) hinzu, nur für die Profile Domäne und Privat, nie Öffentlich (und Bernard Review (stream companion), wenn er den Streaming-Begleiter mitliefert). Die Deinstallation entfernt sie.

• SmartScreen: Der Installer ist noch nicht mit einem Code-Zertifikat signiert, daher zeigt Windows eventuell „Unbekannter Herausgeber“. Prüfen Sie zuerst den Fingerabdruck:

  Get-FileHash -Algorithm SHA256 .\BernardReview-<version>-win64.exe

  dann Weitere Informationen und Trotzdem ausführen.

• Anwendungssteuerung (AppLocker, WDAC): Das Programm ist nicht signiert; eine Regel nach Pfad oder nach Hash greift, und eine Hash-Regel muss für jede Version erneuert werden.

Linux

Für mit RHEL 8, 9 und 10 kompatible Systeme (Rocky Linux, AlmaLinux, Red Hat Enterprise Linux) auf x86-64-Prozessoren.

• RPM-Paket, für alle Benutzer des Arbeitsplatzes (Administratorrechte):

  sudo dnf install ./bernard-review-<version>-Linux.rpm

  Der Befehl lautet bernard-review.

• Selbstextrahierendes Archiv, in Ihrem Home-Ordner, ohne Administratorrechte:

  mkdir -p ~/bernard-review
  sh ./bernard-review-<version>-Linux.sh --prefix=$HOME/bernard-review --exclude-subdir
  ~/bernard-review/bin/bernard-review

• DEB-Paket für Ubuntu: bald, sobald es unter Ubuntu getestet ist.

• Dialoge: Die Dateiauswahldialoge kommen vom Desktop (zenity, kdialog oder qarma); das Paket empfiehlt zenity. Ist keiner installiert, sagt der Player das beim Start und noch einmal, wenn ein Dialog gebraucht wird: sudo dnf install zenity.

• Kamera-RAW (RED, ARRI, Blackmagic RAW): vorerst nur Windows; Linux und macOS bald.

macOS: bald.

Netzwerk

Der Player arbeitet für Wiedergabe, Annotation, Export und Sitzungen im Studionetz vollständig offline: Eine Internetverbindung ist nicht nötig.

Ein Gast braucht keinen eingehenden Port: Alle seine Verbindungen sind ausgehend. Eine Sitzung „nur dieser Computer“ lauscht ausschließlich auf dem Loopback.

Port 9000 unter Linux öffnen. Die Pakete liefern die Definitionen mit, nie aktiviert:

# 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

Ersetzen Sie <zone> durch die Zone des internen Netzes und <subnet> durch das des Studios. Verwaltet eine Gruppenrichtlinie (GPO) die Windows-Firewall und ignoriert lokale Regeln, fügen Sie die Regel in der Richtlinie hinzu: TCP 9000 eingehend, für das Programm, Profile Domäne und Privat.

Online-Sitzungen. Sie laufen über das Relay des Dienstes, ausschließlich mit ausgehenden Verbindungen:

Mit ausgehendem TCP 443 zu diesen beiden Namen allein funktioniert alles, mit etwas mehr Latenz. Ein Proxy muss CONNECT zu diesen Namen auf Port 443 erlauben, sie von der TLS-Inspektion ausnehmen und eine untätige Verbindung nicht in weniger als 120 Sekunden trennen. So prüfen Sie von einem Arbeitsplatz aus:

curl -sS https://review.bernardengine.com/api/v1/health

Die erwartete Antwort enthält "status":"ok".

Tracker. Kitsu, ftrack und Flow werden über HTTPS an der Adresse ihrer Site erreicht, über den Proxy der Site oder den der Umgebung (HTTPS_PROXY, NO_PROXY). Das Zertifikat wird immer geprüft, gegen den Speicher des Systems oder die Datei der Zertifizierungsstelle der Site.

Wo Einstellungen und Log liegen

Er enthält unter anderem:

• player_debug.log, das Log: Es hält nur echte Ereignisse fest (geladene Clips, Decodierfehler ...) und rotiert ab 8 MB zu player_debug.log.1;
• crashes\, die Absturzberichte: ein .dmp-Minidump unter Windows, ein .txt-Textbericht unter Linux, benannt crash-<date>-<time>-<version> in UTC. Nur die fünf neuesten werden behalten. Die letzte Zeile des Logs nennt den geschriebenen Bericht;
• session_config.json (Einstellungen, letzte Sitzung), keymap.json (Tastenkürzel), naming_rules.json (die Namensregel des Version Boards), trackers.json (Tracker-Sites, ohne Secrets) sowie die Ordner color_presets, export_presets, export_recipes und tracker-media.

Um ein Problem zu melden, zeigt Help > Send Log to the Bernard Team... genau, was den Rechner verlassen würde (das Log, den neuesten Absturzbericht nur, wenn Sie ihn ankreuzen, die Version und das System), nimmt eine optionale Notiz auf und sendet nichts, bis Sie auf Send klicken; danach nennt es eine Berichts-ID zum Angeben. Ohne Netzwerk lässt Open Log Folder Sie die Dateien auf anderem Weg senden. Nach einem Absturz fragt der nächste Start zuerst nach. Help > About... > Copy System Info kopiert eine Zusammenfassung des Rechners und der Bibliotheken, ohne Benutzername, Rechnername, Pfad oder Adresse.

Diagnose. BERNARDPLAYER_VERBOSE=1 in der Umgebung fügt eine ausführliche Ablaufverfolgung hinzu (danach wieder entfernen). BERNARDPLAYER_NO_CRASH_HANDLER=1 lässt einen Debugger den Absturz abfangen. Ein Start mit --self-crash stürzt absichtlich ab, um zu prüfen, dass ein Bericht geschrieben wird.

set BERNARDPLAYER_VERBOSE=1
"C:\Program Files\Bernard Review\bin\BernardReview.exe"

Secrets. Die Secrets der Tracker gehen in den Anmeldedatenspeicher des Systems (Windows-Anmeldeinformationsverwaltung, den Secret Service unter Linux). Anmeldedaten von Konten werden unter Windows mit DPAPI verschlüsselt.

Bildschirmfreigabe

Empfängt ein Fernzugriffs-Tool oder eine Bildschirmfreigabe (Splashtop, Teams, OBS) die Vollbildwiedergabe unter Windows ruckelig, setzen Sie in den Preferences den Haken bei Present through DWM (smooth screen sharing), solange Sie teilen. Standardmäßig ist es aus: Es kostet auf dem lokalen Bildschirm ein paar wiederholte Bilder.

Von BernardPlayer kommend

Der Player hieß in früheren Versionen BernardPlayer. Der Installer ersetzt die alte Installation, und der erste Start kopiert den alten Einstellungsordner (%APPDATA%\BernardPlayer, ~/.config/bernardplayer), ohne ihn zu ändern. BernardPlayer.exe und bernardplayer starten den Player für eine Übergangszeit weiterhin: Skripte, die das Programm nach Namen beenden, sollten beide nennen.

Weiterführend: das vollständige Handbuch, Teile 12 und 13 (Help > User Guide im Player), und die Seite der Website für IT-Teams.

Updates

Beim Start prüft der Player im Hintergrund, ob für Ihr System eine neuere Version existiert (er sendet nur seine Versionsnummer). Wenn ja, bietet ein Banner Update unter Windows (unter Linux und macOS Download, die Download-Seite), What's New (die Release Notes, im Player angezeigt) und Later an. Update lädt den Installer im Hintergrund herunter, prüft seine Größe und seinen SHA-256 gegen das, was die Website ankündigt (bei Abweichung wird er nie ausgeführt), und zählt dann, sobald der Player ruht (keine Wiedergabe, Sitzung, kein Export und keine Eingabe), Restarting to install in 10 s herunter (Restart Now, Not Now): Bei 0 schließt sich der Player, seine Sitzung bleibt erhalten, der Installer läuft still (UAC fragt weiterhin den Administrator), und der Player öffnet sich unter dem eigenen Konto des Benutzers wieder, mit der Sitzung, wie sie verlassen wurde. Ohne den Klick auf Update geschieht nichts, und nie während einer Wiedergabe, einer Sitzung oder eines Exports (es wartet). Not Now oder ein Schließen von Hand: beim Schließen installiert, der Player nicht wieder geöffnet. Preferences > General > Updates: Ask / Never schaltet die Prüfung ab; die IT kann das mit der Variablen BERNARD_NO_UPDATE_CHECK=1, dem Schlüssel HKLM\Software\AArts Lab\Bernard Review\NoUpdateCheck=1 (Windows) oder der Datei /etc/bernard-review/policy.json mit dem Inhalt {"update_check": false} (Linux) durchsetzen.