Diese Anleitungen bilden die Begriffe einer Branche auf die Objekte ab, die die Plattform heute hat (Bouquets, Lines, Pakete, Partnerkonten, Nodes, die API). Es sind konzeptionelle Zuordnungen, keine branchenspezifischen Funktionen, und ein Partnerkonto ist ein delegiertes Konto, kein isolierter Mandant.
Konzeptionelle Zuordnung
Nichts im Panel heißt Kurs oder Studierender. Die Tabelle sagt, welches Objekt welche Rolle spielt; die folgenden Kapitel richten sie in dieser Reihenfolge ein.
| In Ihrer Branche | Auf der Plattform | Wo im Panel |
|---|---|---|
| Schulungszentrum oder Vertriebspartner | Partnerkonto (Reseller): ein delegiertes Dashboard mit Credits, Berechtigungen und eigenen Lines | Users → Reseller hinzufügen; Groups für seine Berechtigungen |
| Kurssammlung | Bouquet: eine benannte Gruppe von Kanälen, Filmen oder Serien, die ein Paket freigibt | Bouquets, aus Streams und Movies / Series |
| Aufgezeichnete Lektionen | VOD-Katalog: Filme und Serien mit Staffeln und Folgen, Kategorien und Metadaten | Movies und Series oder der VOD-Ingest-Job |
| Live-Unterricht | Live-Kanal: ein Stream mit seinen Quellen, EPG und Ausgabeformaten | Streams → Live-Stream hinzufügen (Quell-URL oder RTMP-Push) |
| Zugang für Studierende | Line: ein Zugang mit Paket, Bouquets, Ablaufdatum, Verbindungslimit und Ausgaben | Lines → hinzufügen, oder Aktivierungscodes, oder die Reseller API |
| Kurszugangszeitraum | Ablaufdatum der Line, verlängert durch ein Paket, einen Credit oder die API | Das Ablaufdatum der Line und die Laufzeit des Pakets |
| Limit gleichzeitiger Sitzungen | Max. Verbindungen der Line: wie viele Geräte gleichzeitig schauen dürfen | Die max. Verbindungen der Line |
| LMS- oder Shop-Integration | Reseller API und Webhooks: die Operationen des Panels aus Ihrem eigenen System | Reseller-API-Schlüssel und Webhooks im Dashboard des Resellers |
Voraussetzungen
Was vor der Installation bereitstehen sollte.
- Ein Linux-Server (Ubuntu 22.04 oder 24.04) im Campusnetz mit Postgres, Redis und ffmpeg, vom Installer installiert, sowie eine Domain oder interne Adresse für Panel und Player.
- Die Aufzeichnungen, die Sie veröffentlichen werden (Dateien oder ein Aufzeichnungssystem, das RTMP senden kann), und für den Live-Unterricht ein Encoder in jedem Raum, der streamen soll.
- Ein Lizenzschlüssel: Der Tarif Free braucht keinen; berechtigte Einrichtungen fordern den kostenlosen Professional-Schlüssel per E-Mail von ihrer akademischen Domain an.
Infrastruktur bereitstellen
Installieren Sie den Management-Server, dann einen Node pro Gebäude.
- Führen Sie den Installer auf dem Management-Server aus; er installiert Panel, API, Worker und Origin als systemd-Units und legt den ersten Administrator an.
- Setzen Sie die öffentliche URL der API (API_PUBLIC_URL) und die Wiedergabebasis, damit die Player-Links auf die Campusadresse zeigen.
- Registrieren Sie über Servers → Node hinzufügen einen Node für jedes Gebäude, dessen Hörsäle schauen sollen; das Panel installiert ihn per SSH aus dem Node-Paket.
- Prüfen Sie die Seite Servers: Der Node meldet seinen Heartbeat und Traffic, und die Zuschauer dieses Gebäudes werden auf ihn geleitet.
Inhalte organisieren
Kurse als Serien, Studiengänge als Bouquets und Pakete.
- Legen Sie unter Movies / Series eine Kategorie pro Fakultät oder Fach an.
- Fügen Sie jeden Kurs als Serie hinzu: eine Staffel pro Modul, eine Folge pro Lektion, mit der Aufzeichnung als Quelle (Upload oder der VOD-Ingest-Job).
- Legen Sie aus den hinzugefügten Serien ein Bouquet pro Kurssammlung an (zum Beispiel die Kurse eines Studiengangs für ein Semester).
- Legen Sie ein Paket pro Studiengang an: die Bouquets, die es freigibt, den Zugangszeitraum als Laufzeit und das Limit gleichzeitiger Sitzungen.
Partner-Konfiguration (Reseller)
Ein Schulungszentrum oder eine Fakultät als delegiertes Konto.
- Legen Sie unter Groups eine Gruppe mit den Berechtigungen an, die das Zentrum braucht (eigene Lines, keine Katalogänderungen).
- Fügen Sie das Zentrum unter Users als Reseller mit dieser Gruppe, einem Credit-Guthaben und den Paketen hinzu, die es vergeben darf.
- Geben Sie ihm die Dashboard-Adresse; es verwaltet seine Studierenden von dort, und das Panel führt das Audit-Log.
Studierendenzugang konfigurieren
Eine Line pro Studierendem, bei der Einschreibung angelegt.
- Für kleine Kohorten fügen Sie Lines über Lines → hinzufügen mit dem Paket des Studiengangs hinzu; das Ablaufdatum folgt der Paketlaufzeit.
- Für den Einschreibungstag erzeugen Sie Aktivierungscodes für das Paket; ein Studierender löst einen Code im Player ein und erhält eine Line.
- Für ein Studierendensystem oder ein LMS legen Sie einen Reseller-API-Schlüssel an und lassen das System Lines mit action=create_line und einer Request-ID pro Studierendem anlegen.
- Setzen Sie die max. Verbindungen auf die Zahl der Geräte, die ein Studierender gleichzeitig nutzen darf; der Player lehnt die nächste Verbindung darüber hinaus ab.
VOD-Einrichtung
Aufgezeichnete Lektionen auf Abruf.
- Laden Sie jede Aufzeichnung als Quelle einer Folge hoch, oder richten Sie den VOD-Ingest-Job auf die Datei und lassen Sie den Worker sie herunterladen und in das Medienverzeichnis kodieren.
- Füllen Sie die Metadaten (Titel, Beschreibung, Poster) von Hand oder bei öffentlichem Material aus TMDB; Lektionen brauchen meist nur Titel und Beschreibung.
- Prüfen Sie die Wiedergabe im Web-Player mit einer Test-Line; der Link ist signiert und läuft nach der eingestellten Zeit ab.
Live-Streaming aus dem Unterrichtsraum
Eine Vorlesung als Live-Kanal.
- Fügen Sie unter Streams einen Live-Stream mit dem Encoder des Raums als Quelle hinzu (eine RTMP-Push-Adresse oder eine Pull-URL).
- Legen Sie den Stream in das Bouquet des Kurses, damit nur eingeschriebene Studierende ihn sehen; fügen Sie ihn dem EPG hinzu, wenn Sie einen Stundenplan führen.
- Aktivieren Sie Catch-up oder Timeshift am Stream, wenn Studierende den Unterricht später schauen dürfen; die Aufzeichnung kann auch als Folge hochgeladen werden.
Abonnement und Ablauf des Zugangs
Zugang, der mit dem Kurs endet.
- Geben Sie dem Paket den Zugangszeitraum als Laufzeit; eine daraus angelegte Line läuft am Ende dieses Zeitraums ab.
- Verlängern Sie eine Line für ein neues Semester im Panel, mit einem Credit des Zentrums, oder über die API mit action=renew_line.
- Abonnieren Sie die Webhooks mit Ihrem System: Es wird informiert, wenn eine Line bald abläuft, abgelaufen ist oder deaktiviert wurde.
Integration mit einem externen LMS
Das LMS steuert den Zugang; der Player spielt ab.
- Legen Sie einen Reseller-API-Schlüssel für das LMS an; bewahren Sie ihn in den Geheimnissen des LMS auf, nie in einer Seite.
- Bei der Einschreibung ruft das LMS action=create_line mit dem Paket des Studiengangs und einer Request-ID auf; bei Exmatrikulation action=disable_line.
- Verlinken Sie von der Kursseite des LMS auf den Web-Player oder geben Sie dem Studierenden die Player-Zugangsdaten; zwischen beiden gibt es kein Single Sign-on.
Sicherheitsaspekte
Halten Sie den Dienst innerhalb der Einrichtung.
- Aktivieren Sie die Zwei-Faktor-Anmeldung für jedes Panel-Konto und geben Sie Mitarbeitenden die kleinste Berechtigungsgruppe, die funktioniert.
- Halten Sie personenbezogene Daten der Studierenden im Studierendensystem; die Line braucht nur einen Namen und ein Ablaufdatum.
- Halten Sie die max. Verbindungen niedrig und erwägen Sie, die Wiedergabe an die Adresse des Zuschauers zu binden, um Weitergabe zu verhindern.
- Schalten Sie das verschlüsselte Datenbank-Backup ein und, wenn Sie S3-kompatiblen Speicher haben, die externe Kopie.
Fehlersuche
Die üblichen ersten Prüfungen.
- Ein Studierender kann sich nicht anmelden: Prüfen Sie das Ablaufdatum der Line und ob sie aktiviert ist, dann das Paket und das Bouquet des Kurses.
- Eine Aufzeichnung wird nicht abgespielt: Prüfen Sie das Ergebnis des Ingest-Jobs auf der Seite Jobs, dann die Datei im Medienverzeichnis und das Ablaufdatum des signierten Links.
- Die Zuschauer eines Gebäudes landen beim Origin: Prüfen Sie den Heartbeat des Nodes und ob die Adresse des Zuschauers in das Routing des Nodes fällt.
- Die API lehnt einen Aufruf ab: Prüfen Sie den Schlüssel, die Methode der Aktion (Schreiboperationen sind POST) und die Request-ID eines wiederholten Aufrufs.