Testinstanz auf demselben Host

Wichtig

Betaversion 2.1. Das hier Beschriebene gibt es nur in der Betaversion 2.1: Sie wird aus dem Beta-Repository und nur mit einer Lizenz installiert; die stabile Version 2.0.2 und die Demoversion enthalten es nicht. Die Betaversion wird ohne Gewähr ausgeliefert, Support gibt es nach Möglichkeit (Betatestprogramm).

Ab Version 2.1.2.612 lässt sich auf einem Host, auf dem der produktive Dienst pss läuft, eine zweite Instanz des Streamers als Testinstanz starten — zum Beispiel, um einen neuen Build mit denselben Quellen zu prüfen, ohne den produktiven Knoten anzuhalten. Die Testinstanz arbeitet mit einem eigenen Einstellungsverzeichnis und unterscheidet sich von der produktiven durch drei Befehlszeilenoptionen. In die Einstellungsdatei gelangen diese Optionen nicht, daher enthalten vom produktiven Knoten kopierte Einstellungen sie nicht. Ohne diese Optionen startet der Streamer wie bisher.

Startoptionen

--instance-tag=<Kennung>

Die Kennung der Instanz: 1 bis 16 Zeichen, lateinische Kleinbuchstaben, Ziffern und Bindestrich. Sie trennt die Austauschkanäle mit den Transcodern: Ohne sie stören zwei Instanzen mit gleichen Stream- und Ausgangsnummern die Transcoder der jeweils anderen.

--bind-address=<IPv4-Adresse>

Die Weboberfläche, der OTT-Server (HTTP, HTTPS, HTTP/3) und der EPG-Server lauschen nur auf dieser Adresse. Die Ein- und Ausgänge der Streams arbeiten mit ihren eigenen Adressen aus den Stream-Einstellungen. Den RTMP-Server betrifft diese Option nicht (Schritt 3 unten).

--isolated

Die Instanz greift nicht nach außen zu: Abgeschaltet sind Meshwork und die Verbindungen zu Nachbarn, die Reserve, externe Empfänger von Alarmen (Telegram, E-Mail, Webhook, Programmstart) und die Webhook-Prüfung, der Bezug von ACME-Zertifikaten, CAP-Notfallwarnungen (Automatische CAP-Warnungen), LDAP, PMS und DVB; Operationen mit der Lizenz (Aktualisierung, Entbindung, Übertragung) werden abgelehnt. Abgeschaltet sind auch externe Abrechnungsserver (Zuschauerautorisierung über Abrechnung). Die Einstellungen ändern sich dabei nicht: All das ist nur während der Laufzeit der Instanz abgeschaltet. Die eigenen Streams der Instanz arbeiten wie konfiguriert.

Mit der Option --bind-address oder --isolated teilt die Instanz einen Port der Weboberfläche, des OTT- oder EPG-Servers, der bereits von einem anderen Prozess belegt ist, nicht mit ihm, sondern erhält eine Ablehnung: Im Protokoll steht der Fehler Address already in use, beim Start und bei jedem Anwenden der Einstellungen. Ohne sie (nur --instance-tag) teilt sich die Instanz einen solchen Port mit dem produktiven Knoten, und ein Teil der Verbindungen landet bei der Testinstanz.

Ein ungültiger Optionswert bricht den Start mit einer Fehlermeldung ab.

Starten

  1. Legen Sie ein Einstellungsverzeichnis für die Testinstanz an, zum Beispiel /opt/pss-test/config, und kopieren Sie die pss.properties des produktiven Knotens hinein.

  2. Legen Sie in dieser Kopie von pss.properties eigene Pfade fest: mindestens das Protokollverzeichnis log-dir sowie jeden Datenpfad, der dort angegeben ist. Andernfalls schreiben beide Instanzen in dasselbe Protokoll und dieselbe Statistikdatenbank.

  3. Weisen Sie der Testinstanz in ihren Einstellungen eigene Ports zu: die Ports der Weboberfläche (Webserver & Konten), des OTT-Servers einschließlich HTTPS und HTTP/3 (Streaming-HTTP-Server) und des EPG-Servers (EPG-Server). Einen Port, auf dem der produktive Knoten bereits lauscht, bekommt die Testinstanz nicht, wenn sie mit der Option --bind-address oder --isolated gestartet wurde. Ist in den Einstellungen der RTMP-Server eingeschaltet (RTMP-Server), weisen Sie ihm andere Ports zu oder schalten Sie ihn aus (RTMP-Port 0, RTMPS ausgeschaltet): Die Optionen --bind-address und --isolated wirken sich auf ihn nicht aus.

  4. Starten Sie die Instanz mit dem Einstellungsverzeichnis und den Optionen:

    $ sudo /usr/local/bin/pss -c /opt/pss-test/config --instance-tag=test --bind-address=192.0.2.10 --isolated -C
    

    Die Option -C gibt das Protokoll auf der Konsole aus. Für den Dauerbetrieb schreiben Sie eine eigene systemd-Dienstdatei — eine Kopie von pss.service mit eigener ExecStart-Zeile; eine zweite Dienstdatei installiert das Paket nicht.

Ob die Instanz mit diesen Optionen läuft, ist in /data/server zu sehen: Die Felder instance-tag, isolated="1" und bind-address gibt es nur bei einer Instanz, die mit der jeweiligen Option gestartet wurde (Steuerung über die HTTP API).

Warnung

--isolated stoppt keine Streams. Die Ausgänge der Testinstanz — UDP und Multicast, SRT- und RTMP-Veröffentlichungen und andere — gehen tatsächlich ins Netz. Wiederholen Sie darin nicht die Gruppen, Ports und Veröffentlichungsadressen des produktiven Knotens. Die Eingänge lesen das, worauf sie zeigen: Denselben Multicast wie der produktive Knoten zu empfangen, ist möglich.

Lizenz

Die Testinstanz verwendet denselben Schutzschlüssel wie der produktive Knoten. Die Lizenzbeschränkungen prüft jede Instanz anhand ihrer eigenen Streams, ohne sie mit der anderen zusammenzurechnen. Ein Netzwerkschlüssel mit einer Begrenzung der gleichzeitigen Verbindungen kann der zweiten Instanz die Verbindung verweigern; ein lokaler Schlüssel auf diesem Host verweigert sie in der Regel nicht. Mit --isolated ändert die Testinstanz die Lizenz des Hosts nicht: Aus ihr heraus lässt sich die Lizenz weder aktualisieren noch übertragen.