--- title: Einrichtung url: https://doc.pstreamer.tv/de/install/install.html lang: de product: Perfect Streamer version: 1.13.3.445 --- # Einrichtung ## Systemanforderungen - **Perfect Streamer** läuft unter Linux. Hauptanforderung: GLIBC >= 2.17. - Die vom Streamer-Dienst genutzten Netzwerkschnittstellen müssen statisch konfiguriert sein. - Die Installer-Skripte nutzen das Werkzeug **sudo** — es muss daher im System installiert sein. Für die Red-Hat- und Debian-Familien stehen Installationspakete und Repositories bereit. Unterstützt werden RHEL 7 und höher (CentOS usw.) sowie RPM-kompatible Distributionen — zum Beispiel openSUSE Leap (siehe die Anmerkung am Ende des RHEL-Abschnitts). Debian-basierte Systeme (Ubuntu usw.) müssen über den systemd-Dienst verfügen. Hardware-Richtwerte: 1 Kern @ 2,4 GHz und 1 GB RAM pro 200 Mbit Datenverkehr. Die Schätzung ist näherungsweise und hängt von den eingesetzten Protokollen und Einstellungen ab. **Eigenschaften der kostenlosen Demo-Version:** - Auf 10 Streams begrenzt - Transkoder läuft nur im CPU-Software-Modus - Ohne Einschränkungen im Funktionsumfang - Ohne Zeitbeschränkung Die Distributionen der Voll- und Demo-Version unterscheiden sich. Verwenden Sie für die Installation der Demo-Version das entsprechende Paket pstreamer-demo. Beim Wechsel auf die Vollversion muss zuerst die Demo-Version deinstalliert und dann die Vollversion installiert werden. Die Konfigurationsdatei der Demo-Version ist mit der Vollversion des Pakets kompatibel, aber die Konfigurationsdatei der vollen pstreamer-Version kann mit pstreamer-demo inkompatibel sein — der Dienst startet möglicherweise nicht und die manuelle Entfernung der Datei pss.json kann erforderlich sein. ## Installation auf RHEL-Systemen Repository für RHEL 7 installieren: ```sh $ sudo yum install yum-utils $ sudo yum-config-manager --add-repo=http://repo.pstreamer.tv/pub/pstreamer/pstreamer.repo ``` Oder für RHEL 8+: ```sh $ sudo yum config-manager --add-repo=http://repo.pstreamer.tv/pub/pstreamer/pstreamer.repo ``` Paket installieren: ```sh $ sudo yum -y install pstreamer or $ sudo yum -y install pstreamer-demo ``` Paket aktualisieren: ```sh $ sudo yum -y update pstreamer or $ sudo yum -y update pstreamer-demo ``` Alle Pakete entfernen: ```sh $ sudo yum -y remove pstreamer aksusbd or $ sudo yum -y remove pstreamer-demo ``` > **Bemerkung** > > **openSUSE** (Leap, die neueste stabile Version) ist ein RPM-basiertes System. Es wird dasselbe Repository wie für RHEL verwendet, die Vorgänge werden jedoch mit dem Paketmanager **zypper** ausgeführt: > > ```sh > $ sudo zypper addrepo http://repo.pstreamer.tv/pub/pstreamer/pstreamer.repo > $ sudo zypper --gpg-auto-import-keys refresh > $ sudo zypper install pstreamer # or pstreamer-demo > ``` > > Aktualisierung — `sudo zypper update pstreamer`, Entfernung — `sudo zypper remove pstreamer aksusbd`. ## Installation auf Debian-Systemen Repository installieren: ```sh $ sudo wget http://repo.pstreamer.tv/pub/deb/dists/pstreamer/pstreamer.list -O /etc/apt/sources.list.d/pstreamer.list $ sudo apt-get update ``` Paket installieren: ```sh $ sudo apt-get install pstreamer or $ sudo apt-get install pstreamer-demo ``` Paket aktualisieren: ```sh $ sudo apt install pstreamer or $ sudo apt install pstreamer-demo ``` Alle Pakete entfernen: ```sh $ sudo apt-get remove pstreamer aksusbd or $ sudo apt-get remove pstreamer-demo ``` ## Dateien und Dienste ****/usr/local/bin/pss**** Ausführbare Datei. ****/opt/pss/config/pss.properties**** Globale Einstellungen, Logs, Pfade usw. Nach Änderungen den Dienst neu starten. ****/opt/pss/config/pss.json**** Hauptkonfigurationsdatei. Wird automatisch erstellt und aktualisiert. Beim Start versucht der Dienst, genau diese Datei zu laden. ****/opt/pss/config/pss_back.json**** Sicherungskopie der vorherigen funktionierenden Konfiguration. Wird automatisch beim Auslösen der Aktion **Einstellungen wiederherstellen** in der Weboberfläche gespeichert und als erste Fallback-Variante verwendet, wenn die Haupt-*pss.json* nicht verarbeitet werden kann. ****/opt/pss/config/pss_default.json**** Standardkonfigurationsdatei. Wird mit dem Paket ausgeliefert und als letzte Fallback-Variante verwendet, wenn weder die Haupt-*pss.json* noch *pss_back.json* geladen werden kann. ****/opt/pss/config/pss_back.json**** Archiv beschädigter *pss.json*-Dateien. Wenn die Hauptkonfigurationsdatei beim Start nicht verarbeitet werden kann, wird sie unter einem Namen der Form *pss_YYYYMMDD_HHMMSS.json* hierher verschoben. Das Verzeichnis wird automatisch angelegt. Näheres siehe Abschnitt [Verhalten beim Start und bei Konfigurationsfehlern](../manual/manual.md#startup-config-errors). ****/opt/pss/data**** Datenverzeichnis. Wird automatisch erstellt und aktualisiert. Kann in der globalen Konfigurationsdatei geändert werden. ****/usr/lib/systemd/system/pss.service**** systemd-Service-Datei. ****/var/log/pss**** Log-Verzeichnis. Kann in der globalen Konfigurationsdatei geändert werden. Dienstname **pss**. Wird unter dem Benutzer **pss** ausgeführt. Während der Installation wird das Begleitpaket **aksusbd** des Schutzsystems installiert; es enthält die Dienste **hasplmd** und **aksusbd**. ## Nach der Installation Nach der Installation von **Perfect Streamer** [Aktivierung und Erstkonfiguration des Dienstes durchführen](settings.md#settings). ## Transkoder Installation der Transkoder für Perfect Streamer. Verfügbare Pakete: - pstreamer-tcsw: Transkodierung auf CPU (Software). - pstreamer-tcnv: Transkodierung auf Nvidia-GPU. Nur für das Paket *pstreamer* (Vollversion mit Schutz). - pstreamer-tcivpl: Transkodierung auf Intel-GPU. Nur für das Paket *pstreamer* (Vollversion mit Schutz). Haupterfordernis: GLIBC >= 2.28. Der Transcoder läuft unter AlmaLinux 8.9. Der Intel-VPL-Transkoder funktioniert auf AlmaLinux-10-Systemen (RHEL 10). ### RHEL 8+ 1. pstreamer oder pstreamer-demo installieren. 2. Für Nvidia die Repositories installieren und das System aktualisieren (falls noch nicht geschehen): ```sh sudo dnf config-manager --add-repo https://developer.download.nvidia.com/compute/cuda/repos/rhel9/x86_64/cuda-rhel9.repo sudo dnf clean all sudo dnf update -y reboot ``` 1. NVidia Encoder. - CUDA installieren: ```sh sudo dnf -y install cuda-toolkit-12-5 ``` - Treiber installieren (Variante wählen): *Legacy* ```sh sudo dnf -y module install nvidia-driver:latest-dkms ``` *New* ```sh sudo dnf -y module install nvidia-driver:open-dkms ``` Nach der Installation den Rechner unbedingt neu starten: ```sh reboot ``` Nach dem Neustart die Treiberfunktion prüfen: ```sh nvidia-smi modprobe nvidia sudo lsmod | grep nvidia ``` oder ```sh modprobe nouveau sudo lsmod | grep nouveau ``` 1. Intel VPL Encoder. - Intel-Treiber und Intel VPL installieren (RHEL 10): ```sh dnf install -y intel-gpu-firmware dnf install -y https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %rhel).noarch.rpm https://mirrors.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-$(rpm -E %rhel).noarch.rpm dnf install -y intel-media-driver dnf install -y intel-vpl-gpu-rt ``` 1. Transkoder-Pakete installieren. - CPU-Software-Methode: ```sh sudo dnf install -y pstreamer-tcsw ``` - Nvidia GPU: ```sh sudo dnf install -y pstreamer-tcnv ``` - Intel VPL GPU: ```sh sudo dnf install -y pstreamer-tcivpl ``` ### Ubuntu 22/24 1. pstreamer oder pstreamer-demo installieren. 2. NVidia Encoder. - CUDA Toolkit Version 12.5 installieren: ```sh wget https://developer.download.nvidia.com/compute/cuda/repos/ubuntu2204/x86_64/cuda-keyring_1.1-1_all.deb sudo dpkg -i cuda-keyring_1.1-1_all.deb sudo apt-get update sudo apt-get -y install cuda-toolkit-12-5 ``` - Treiber installieren (Variante wählen): *legacy kernel module flavor*: ```sh sudo apt-get install -y cuda-drivers ``` oder *open kernel module flavor*: ```sh sudo apt-get install -y nvidia-driver-555-open sudo apt-get install -y cuda-drivers-555 ``` Nach der Installation den Rechner unbedingt neu starten: ```sh reboot ``` Nach dem Neustart die Treiberfunktion prüfen: ```sh nvidia-smi ``` Für den Betrieb des Transkoders ist CUDA 12.5 erforderlich. Im System kann bereits eine andere CUDA-Version installiert sein. Auch beim System-Update ist ein Upgrade auf eine neuere CUDA-Version möglich. Das beeinträchtigt den Betrieb nicht — die alten Versionen müssen nicht entfernt werden, da unterschiedliche CUDA-Versionen in separaten Verzeichnissen installiert werden. 1. Transkoder-Pakete installieren. - CPU-Software-Methode: ```sh sudo apt-get install -y pstreamer-tcsw ``` - Nvidia GPU: ```sh sudo apt-get install -y pstreamer-tcnv ``` Die Transkoder-Pakete installieren folgende Dateien: - /usr/local/bin/tcsw — ausführbare Datei des SW(CPU)-Transkoders. - /usr/local/bin/tcnv — ausführbare Datei des Nvidia-(GPU-)Transkoders. - /opt/pss/config/pss_tc_sw.properties — Startkonfigurationsdatei des SW-(CPU-)Transkoders. - /opt/pss/config/pss_tc_nv.properties — Startkonfigurationsdatei des Nvidia-(GPU-)Transkoders. 1. Transkoder-Installation prüfen. Die Installation der Transkoder-Pakete startet den pss-Dienst neu. Die Installation lässt sich im Bereich About prüfen — Version oder Fehler werden angezeigt. ### Weitere auf Debian und RHEL basierende Systeme Zur Installation des pstreamer-tcnv-Transkoders auf anderen OS als Ubuntu 22/24 und RHEL 8+ verwenden Sie den Konfigurator auf der Nvidia-Website, um passende CUDA- und Treiberversionen zu wählen: [https://developer.nvidia.com/cuda-toolkit-archive](https://developer.nvidia.com/cuda-toolkit-archive) Bei der Auswahl jeder CUDA-Version ist die Information verfügbar, für welche OS-Version sie geeignet ist. Unterstützte Architektur — x86_64. Wenn eine ältere OS-Version benötigt wird, prüfen Sie deren Unterstützung in älteren CUDA-Versionen. Die Hauptanforderung an das OS — Unterstützung von GLIBC >= 2.28. Der Nvidia-Treiber muss aus dem Repository installiert werden, das auf der Seite der gewählten CUDA-Version für Ihre OS-Version angeboten wird. Die Unterstützung von Nvidia-Grafikkarten für die Transkoder-Funktionalität pstreamer-tcnv lässt sich auf der Nvidia-Website unter [Video Encode and Decode Support Matrix](https://developer.nvidia.com/video-encode-and-decode-gpu-support-matrix-new) prüfen. Auf dieser Seite stehen die Matrix der unterstützten Videoformate für Decoder und Encoder sowie weitere Eigenschaften zur Verfügung. ## Entfernen der alten CUDA- und Treiber-Version Bei einer falschen CUDA-/Treiberversion ist ggf. ein Wechsel auf eine andere Version nötig — zuerst die bestehende Installation entfernen. [https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html?highlight=uninstall#removing-cuda-toolkit](https://docs.nvidia.com/cuda/cuda-installation-guide-linux/index.html?highlight=uninstall#removing-cuda-toolkit) ### CUDA entfernen RHEL: ```sh dnf remove "cuda*" "*cublas*" "*cufft*" "*cufile*" "*curand*" "*cusolver*" "*cusparse*" "*gds-tools*" "*npp*" "*nvjpeg*" "nsight*" "*nvvm*" "*nvptx*" ``` Debian/Ubuntu: ```sh apt remove --autoremove --purge "*cuda*" "*cublas*" "*cufft*" "*cufile*" "*curand*" "*cusolver*" "*cusparse*" "*gds-tools*" "*npp*" "*nvjpeg*" "nsight*" "*nvvm*" "*nvptx*" ``` ### Treiber entfernen Ubuntu 22/24: ```sh apt remove --autoremove --purge -V \ cuda-compat\* \ cuda-drivers\* \ libnvidia-cfg1\* \ libnvidia-compute\* \ libnvidia-decode\* \ libnvidia-encode\* \ libnvidia-extra\* \ libnvidia-fbc1\* \ libnvidia-gl\* \ libnvidia-gpucomp\* \ libnvidia-nscq\* \ libnvsdm\* \ libxnvctrl\* \ nvidia-dkms\* \ nvidia-driver\* \ nvidia-fabricmanager\* \ nvidia-firmware\* \ nvidia-headless\* \ nvidia-imex\* \ nvidia-kernel\* \ nvidia-modprobe\* \ nvidia-open\* \ nvidia-persistenced\* \ nvidia-settings\* \ nvidia-xconfig\* \ xserver-xorg-video-nvidia\* ``` RHEL 9: ```sh dnf module remove --all nvidia-driver dnf module reset nvidia-driver ``` RHEL 10: ```sh dnf remove nvidia-driver\* ```