Installation¶

System requirements¶

Perfect Streamer runs on OS Linux. The main requirement is GLIBC version >= 2.17.
The system must be compatible with the Gemalto Sentinel protection system.
Network interfaces for streamer must be configured statically.

Installation packages and repositories are available for the Red Hat and Debian families. RHEL version 7 and higher (Centos etc) is supported. Debian based systems (Ubuntu etc) must have systemd service.

Hardware requirements: one 2.4 GHz core and 1 GB of RAM for every 200 Mb of traffic. The estimate is approximate and depends on the used protocols and service configuration.

Demo version features:

Limited by 10 streams
Software CPU transcoding method only
No limitations of functionality
No time limitations

Packages differ for the Demo and original versions. Please use Demo package name to install the Demo version. First uninstall the Demo-version if you are going to install the original version. The configuration file from demo-version is backward compatible with the original version package. But config file from original full version could be not compatible with pstreamer-demo package, service may not start with it and manual removal of pss.json file could be required.

Installation on systems of the RHEL family¶

Install repository for RHEL 7:

$ sudo yum install yum-utils
$ sudo yum-config-manager --add-repo=http://repo.pstreamer.tv/pub/pstreamer/pstreamer.repo

Or for RHEL 8 and 9:

$ sudo yum config-manager --add-repo=http://repo.pstreamer.tv/pub/pstreamer/pstreamer.repo

Install package:

$ sudo yum -y install pstreamer

or

$ sudo yum -y install pstreamer-demo

Update package:

$ sudo yum -y update pstreamer

or

$ sudo yum -y update pstreamer-demo

Removing all packages:

$ sudo yum -y remove pstreamer aksusbd

or

$ sudo yum -y remove pstreamer-demo

Installing on Debian Family Systems¶

Install repository:

$ sudo wget http://repo.pstreamer.tv/pub/deb/dists/pstreamer/pstreamer.list -O /etc/apt/sources.list.d/pstreamer.list
$ sudo apt-get update

Install package:

$ sudo apt-get install pstreamer

or

$ sudo apt-get install pstreamer-demo

Update package:

$ sudo apt install pstreamer

or

$ sudo apt install pstreamer-demo

Removing all packages:

$ sudo apt-get remove pstreamer aksusbd

or

$ sudo apt-get remove pstreamer-demo

Files and services¶

/usr/local/bin/pss: Executable file.
/opt/pss/config/pss.properties: Global settings, logs, paths to folders, etc. When making changes, reload the service.
/opt/pss/config/pss.json: Settings file. Created and updated automatically.
/opt/pss/config/pss_default.json: Default configuration file. It is used in case of damage or deletion of settings.
/opt/pss/config/pss.json: The configuration file saved during restore. It is used if the restored configuration file has errors.
/opt/pss/data: Data folder. Created and updated automatically. Can be changed in the global settings file.
/usr/lib/systemd/system/pss.service: systemd service file.
/var/log/pss: Log recording folder. Can be changed in the global settings file.

Service name pss. Runs as user pss.

The installation process installs the accompanying package aksusbd from the security system, includes the services hasplmd and aksusbd.

After installation¶

After Perfect Streamer installation activate and make initial setup of service.

Transcoders¶

Perfect Streamer transcoders installation.

Packages available:

pstreamer-tcsw: transcoding using CPU (Software).
pstreamer-tcnv: transcoding using NVidia GPU. Full protected pstreamer version only.

Alma Linux 9 (RHEL)¶

Install pstreamer or pstreamer-demo.
Add repository and update the system (if have not done yet):

sudo dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo dnf install -y --nogpgcheck https://download1.rpmfusion.org/free/el/rpmfusion-free-release-9.noarch.rpm
sudo dnf install -y --nogpgcheck https://download1.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-9.noarch.rpm

For NVidia:

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

Install packages for transcoding using CPU Software method:

sudo dnf install -y gstreamer1 gstreamer1-plugins-base \
        gstreamer1-plugin-libav gstreamer1-plugins-good \
        gstreamer1-plugins-ugly gstreamer1-plugins-ugly-free \
        gstreamer1-plugins-bad-free gstreamer1-plugins-bad-freeworld

NVidia Encoder.

Install Cuda:

sudo dnf -y install cuda-toolkit-12-5

Install driver (choose the option):

Legacy

sudo dnf -y module install nvidia-driver:latest-dkms

New

sudo dnf -y module install nvidia-driver:open-dkms

Reboot after installation:

reboot

Check the driver after reboot:

nvidia-smi
modprobe nvidia
sudo lsmod | grep nvidia

or

modprobe nouveau
sudo lsmod | grep nouveau

Install transcoder packages:

CPU Software method:

sudo dnf install pstreamer-tcsw -y

Nvidia GPU:

sudo dnf install pstreamer-tcnv -y

Ubuntu 22/24¶

Install pstreamer or pstreamer-demo.
NVidia Encoder.

Install Cuda toolkit version 12.5:

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

Install driver (choose the option):

legacy kernel module flavor:

sudo apt-get install -y cuda-drivers

or

open kernel module flavor:

sudo apt-get install -y nvidia-driver-555-open
sudo apt-get install -y cuda-drivers-555