Transcodificadores¶
Instalación de los transcodificadores para Perfect Streamer.
Paquetes disponibles:
pstreamer-tcsw — transcodificación en la CPU (Software).
pstreamer-tcnv — transcodificación en la GPU NVIDIA.
pstreamer-tcivpl — transcodificación en la GPU Intel (Intel VPL).
El requisito principal es la versión de GLIBC >= 2.28.
El transcodificador funciona en AlmaLinux 8.9. El transcodificador Intel VPL funciona en sistemas AlmaLinux 10 (RHEL 10) y Ubuntu 24.04.
Qué hardware Intel es adecuado para la transcodificación, qué entornos de ejecución y códecs están disponibles en las distintas generaciones de gráficos y cómo comprobar que el hardware ha sido reconocido — en la sección Transcodificador Intel VPL: hardware compatible.
RHEL 8+¶
Instalar pstreamer.
Para NVIDIA, instalar los repositorios y actualizar el sistema (si aún no se han instalado):
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
NVIDIA Encoder.
Instalar CUDA:
sudo dnf -y install cuda-toolkit-12-5
Instalar el controlador (elija una opción):
Legacy
sudo dnf -y module install nvidia-driver:latest-dkms
New
sudo dnf -y module install nvidia-driver:open-dkms
Después de la instalación, es obligatorio reiniciar la máquina:
reboot
Después del reinicio, comprobar el funcionamiento del controlador:
nvidia-smi
modprobe nvidia
sudo lsmod | grep nvidia
o
modprobe nouveau
sudo lsmod | grep nouveau
Intel VPL Encoder.
Instalación del controlador Intel e Intel VPL (RHEL 10):
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
Instalar los paquetes del transcodificador.
Método CPU Software:
sudo dnf install -y pstreamer-tcsw
NVIDIA GPU:
sudo dnf install -y pstreamer-tcnv
Intel VPL GPU:
sudo dnf install -y pstreamer-tcivpl
Ubuntu 22/24¶
Instalar pstreamer.
NVIDIA Encoder.
Instalar el toolkit de CUDA versión 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
Instalar el controlador (elija una opción):
legacy kernel module flavor:
sudo apt-get install -y cuda-drivers
o
open kernel module flavor:
sudo apt-get install -y nvidia-driver-555-open
sudo apt-get install -y cuda-drivers-555
Después de la instalación, es obligatorio reiniciar la máquina:
reboot
Después del reinicio, comprobar el funcionamiento del controlador:
nvidia-smi
El transcodificador requiere la versión CUDA 12.5 para funcionar. En el sistema puede haber ya instalada otra versión de CUDA. Además, al actualizar el sistema es posible que CUDA se actualice a una versión más nueva. Esto no interfiere con el funcionamiento; no es necesario eliminarlas, ya que las distintas versiones de CUDA se instalan en carpetas separadas.
Intel VPL Encoder (Ubuntu 24.04).
Los componentes clave de Intel VPL se toman del repositorio oficial de Intel Graphics: en los repositorios estándar de Ubuntu son más antiguos y no admiten las GPU modernas.
Añadir el repositorio de Intel Graphics:
sudo apt-get update
sudo apt-get install -y ca-certificates gnupg wget
wget -qO - https://repositories.intel.com/gpu/intel-graphics.key | sudo gpg --yes --dearmor --output /usr/share/keyrings/intel-graphics.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/intel-graphics.gpg] https://repositories.intel.com/gpu/ubuntu noble unified" | sudo tee /etc/apt/sources.list.d/intel-gpu-noble.list
sudo apt-get update
Instalar el runtime de Intel VPL y el controlador:
sudo apt-get install -y libvpl2 libmfxgen1 intel-media-va-driver-non-free
Opcionalmente, se pueden instalar las herramientas de diagnóstico:
sudo apt-get install -y libvpl-tools
El usuario pss en cuyo nombre se ejecuta el servicio debe pertenecer a los grupos render y video (acceso a los dispositivos /dev/dri/):
sudo usermod -aG render,video pss
sudo systemctl restart pss
Comprobar que la GPU es visible (con libvpl-tools instalado):
vainfo --display drm --device /dev/dri/renderD128
vpl-inspect
En la salida de vainfo debe estar presente la línea «Driver version: Intel iHD …», y vpl-inspect debe enumerar la implementación por hardware (AccelerationMode VAAPI).
Instalar los paquetes del transcodificador.
Método CPU Software:
sudo apt-get install -y pstreamer-tcsw
NVIDIA GPU:
sudo apt-get install -y pstreamer-tcnv
Intel VPL GPU (Ubuntu 24.04):
sudo apt-get install -y pstreamer-tcivpl
Archivos y verificación de la instalación¶
Los paquetes de los transcodificadores instalarán los siguientes archivos:
/usr/local/bin/tcsw — archivo ejecutable del transcodificador SW (CPU).
/usr/local/bin/tcnv — archivo ejecutable del transcodificador NVIDIA (GPU).
/usr/local/bin/tcivpl — archivo ejecutable del transcodificador Intel VPL (GPU).
/opt/pss/config/pss_tc_sw.properties — archivo de configuración de arranque del transcodificador SW (CPU).
/opt/pss/config/pss_tc_nv.properties — archivo de configuración de arranque del transcodificador NVIDIA (GPU).
/opt/pss/config/pss_tc_ivpl.properties — archivo de configuración de arranque del transcodificador Intel VPL (GPU).
La instalación de los paquetes del transcodificador reiniciará el servicio pss. La instalación de los transcodificadores se puede comprobar en la sección About de la interfaz web: se mostrará la versión de los transcodificadores o un error.
Otros sistemas operativos basados en Debian y RHEL¶
Para instalar el transcodificador pstreamer-tcnv en sistemas operativos distintos de Ubuntu 22/24 y RHEL 8+, utilice el configurador para seleccionar la versión de CUDA y del controlador necesaria en el sitio web de NVIDIA:
https://developer.nvidia.com/cuda-toolkit-archive
Al seleccionar cada versión de CUDA, hay información disponible sobre para qué versión de sistema operativo es adecuada. La arquitectura admitida es x86_64. Si necesita una versión más antigua del sistema operativo, compruebe su compatibilidad en versiones más antiguas de CUDA. El requisito principal para el sistema operativo es la compatibilidad con la versión de GLIBC >= 2.28.
El controlador NVIDIA debe instalarse desde el repositorio que se ofrece para la versión de su sistema operativo en la página de la versión de CUDA seleccionada.
La compatibilidad de las tarjetas gráficas NVIDIA con la funcionalidad del transcodificador pstreamer-tcnv se puede comprobar en el sitio web de NVIDIA en la Video Encode and Decode Support Matrix. En esta página está disponible una matriz de compatibilidad de formatos de vídeo para el decodificador y el codificador, así como otras características.
Eliminación de la versión antigua de CUDA y del controlador¶
En caso de instalar una versión incorrecta de CUDA y del controlador, puede ser necesario instalar otra versión, eliminando previamente la instalada.
Eliminación de CUDA¶
RHEL:
dnf remove "cuda*" "*cublas*" "*cufft*" "*cufile*" "*curand*" "*cusolver*" "*cusparse*" "*gds-tools*" "*npp*" "*nvjpeg*" "nsight*" "*nvvm*" "*nvptx*"
Debian/Ubuntu:
apt remove --autoremove --purge "*cuda*" "*cublas*" "*cufft*" "*cufile*" "*curand*" "*cusolver*" "*cusparse*" "*gds-tools*" "*npp*" "*nvjpeg*" "nsight*" "*nvvm*" "*nvptx*"
Eliminación del controlador¶
Ubuntu 22/24:
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:
dnf module remove --all nvidia-driver
dnf module reset nvidia-driver
RHEL 10:
dnf remove nvidia-driver\*
