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.

• sudo is required for installation scripts.

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. pstreamer package only (full protected version).

Alma Linux 9 (RHEL)

1. Install pstreamer or pstreamer-demo.

2. 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
sudo dnf update -y
reboot

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

3. Install GStreamer packages for transcoding:

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

4. 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

5. Install transcoder packages:

• CPU Software method:

sudo dnf install -y pstreamer-tcsw

• Nvidia GPU:

sudo dnf install -y pstreamer-tcnv

Ubuntu 22/24

1. Install pstreamer or pstreamer-demo.

2. 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

Reboot after installation:

reboot

Check the driver after reboot:

nvidia-smi

CUDA bersion 12.5 is needed for transcoder. A different version of CUDA may already be installed in the system. It is also possible to upgrade CUDA to a newer version when updating the system. This does not interfere with the work, they do not need to be deleted, different versions of CUDA are installed in separate folders.

3. Install packages for transcoding using CPU Software method:

sudo apt install gstreamer1.0-tools gstreamer1.0-plugins-base \
        gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly \
        gstreamer1.0-plugins-bad gstreamer1.0-tools gstreamer1.0-libav

GStreamer version 1.20 or higher is required for transcoding.

4. Install transcoder packages:

• CPU Software method:

sudo apt-get install -y pstreamer-tcsw

• Nvidia GPU:

sudo apt-get install -y pstreamer-tcnv

Transcoder packages will install files:

• /usr/local/bin/tcsw - SW (CPU) transcoder binary file.

• /usr/local/bin/tcnv - NVidia (GPU) transcoder binary file.

• /opt/pss/config/pss_tc_sw.properties - SW (CPU) transcoder starting config file.

• /opt/pss/config/pss_tc_nv.properties - NVidia (GPU) transcoder starting config file.

5. Check transcoder installed.

Transcoder packages installation leeds to pss service restart. You can check transcoder installation in the About section, where transcoder version will be shown.