--- title: Instalação url: https://doc.pstreamer.tv/pt/install/install.html lang: pt-BR product: Perfect Streamer version: 1.13.3.445 --- # Instalação ## Requisitos do sistema - **Perfect Streamer** funciona em Linux. Requisito principal: GLIBC >= 2.17. - As interfaces de rede utilizadas pelo serviço do streamer devem ter configuração estática. - Os scripts do instalador usam o utilitário **sudo**, portanto ele deve estar instalado no sistema. Para as famílias Red Hat e Debian há pacotes de instalação e repositórios disponíveis. É suportada a versão RHEL 7 e superior (CentOS, etc.), bem como distribuições compatíveis com RPM — por exemplo, openSUSE Leap (veja a observação no final da seção RHEL). Sistemas baseados em Debian (Ubuntu, etc.) devem ter o serviço systemd. Requisitos indicativos: 1 núcleo de 2,4 GHz e 1 GB de RAM para cada 200 Mbit/s de tráfego. Estimativa aproximada que depende dos protocolos e configurações do serviço. **Particularidades da versão Demo gratuita:** - Limitado a 10 fluxos - O transcodificador opera apenas no modo CPU Software - Sem limitações de funcionalidade - Sem limite de tempo As distribuições das versões completa e Demo diferem. Para instalar a versão Demo use o pacote pstreamer-demo correspondente. Ao migrar para a versão completa é necessário primeiro desinstalar a versão Demo e depois instalar a versão completa. O arquivo de configuração da versão Demo é compatível com a versão completa do pacote, mas o arquivo de configuração da versão completa do pstreamer pode ser incompatível com pstreamer-demo, o serviço pode não iniciar e a remoção manual do arquivo pss.json pode ser necessária. ## Instalação em sistemas RHEL Instalar o repositório para RHEL 7: ```sh $ sudo yum install yum-utils $ sudo yum-config-manager --add-repo=http://repo.pstreamer.tv/pub/pstreamer/pstreamer.repo ``` Ou para RHEL 8+: ```sh $ sudo yum config-manager --add-repo=http://repo.pstreamer.tv/pub/pstreamer/pstreamer.repo ``` Instalar o pacote: ```sh $ sudo yum -y install pstreamer or $ sudo yum -y install pstreamer-demo ``` Atualizar o pacote: ```sh $ sudo yum -y update pstreamer or $ sudo yum -y update pstreamer-demo ``` Remover todos os pacotes: ```sh $ sudo yum -y remove pstreamer aksusbd or $ sudo yum -y remove pstreamer-demo ``` > **Nota** > > **openSUSE** (Leap, a versão estável mais recente) é um sistema baseado em RPM. Utiliza-se o mesmo repositório que para o RHEL, mas as operações são realizadas com o gerenciador de pacotes **zypper**: > > ```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 > ``` > > Atualização — `sudo zypper update pstreamer`, remoção — `sudo zypper remove pstreamer aksusbd`. ## Instalação em sistemas Debian Instalar o repositório: ```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 ``` Instalar o pacote: ```sh $ sudo apt-get install pstreamer or $ sudo apt-get install pstreamer-demo ``` Atualizar o pacote: ```sh $ sudo apt install pstreamer or $ sudo apt install pstreamer-demo ``` Remover todos os pacotes: ```sh $ sudo apt-get remove pstreamer aksusbd or $ sudo apt-get remove pstreamer-demo ``` ## Arquivos e serviços ****/usr/local/bin/pss**** Arquivo executável. ****/opt/pss/config/pss.properties**** Configurações globais, logs, caminhos etc. Após alterações, reiniciar o serviço. ****/opt/pss/config/pss.json**** Arquivo principal de configurações. Criado e atualizado automaticamente. Na inicialização, o serviço tenta carregar precisamente este arquivo. ****/opt/pss/config/pss_back.json**** Cópia de segurança da configuração de trabalho anterior. Salva automaticamente ao executar a ação **Restaurar configurações** na interface web e usada como primeira alternativa se o *pss.json* principal não puder ser analisado. ****/opt/pss/config/pss_default.json**** Arquivo de configurações padrão. Entregue com o pacote e usado como última alternativa se nem o *pss.json* principal nem o *pss_back.json* puderem ser carregados. ****/opt/pss/config/pss_back.json**** Arquivo de arquivos *pss.json* corrompidos. Se o arquivo principal de configurações não puder ser analisado na inicialização, ele é movido para cá com um nome do tipo *pss_YYYYMMDD_HHMMSS.json*. O diretório é criado automaticamente. Consulte a seção [Comportamento na inicialização e erros de configuração](../manual/manual.md#startup-config-errors). ****/opt/pss/data**** Pasta de dados. Criada e atualizada automaticamente. Pode ser alterada no arquivo de configurações globais. ****/usr/lib/systemd/system/pss.service**** Arquivo de serviço systemd. ****/var/log/pss**** Pasta de logs. Pode ser alterada no arquivo de configurações globais. Nome do serviço **pss**. Executa sob o usuário **pss**. Durante a instalação é instalado o pacote complementar **aksusbd** do sistema de proteção; ele inclui os serviços **hasplmd** e **aksusbd**. ## Após a instalação Após a instalação do **Perfect Streamer**, [realize a ativação e a configuração inicial do serviço](settings.md#settings). ## Transcodificadores Instalação dos transcodificadores para o Perfect Streamer. Pacotes disponíveis: - pstreamer-tcsw: transcodificação em CPU (Software). - pstreamer-tcnv: transcodificação em GPU Nvidia. Apenas para o pacote *pstreamer* (versão completa com proteção). - pstreamer-tcivpl: transcodificação em GPU Intel. Apenas para o pacote *pstreamer* (versão completa com proteção). Requisito principal: GLIBC >= 2.28. O transcodificador funciona no AlmaLinux 8.9. O transcodificador Intel VPL funciona em sistemas AlmaLinux 10 (RHEL 10). ### RHEL 8+ 1. Instalar pstreamer ou pstreamer-demo. 2. Para Nvidia, instalar os repositórios e atualizar o sistema (se ainda não foram instalados): ```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. - Instalar CUDA: ```sh sudo dnf -y install cuda-toolkit-12-5 ``` - Instalar o driver (escolha uma opção): *Legacy* ```sh sudo dnf -y module install nvidia-driver:latest-dkms ``` *New* ```sh sudo dnf -y module install nvidia-driver:open-dkms ``` Após a instalação é obrigatório reiniciar a máquina: ```sh reboot ``` Após reiniciar, verificar o funcionamento do driver: ```sh nvidia-smi modprobe nvidia sudo lsmod | grep nvidia ``` ou ```sh modprobe nouveau sudo lsmod | grep nouveau ``` 1. Intel VPL Encoder. - Instalação do driver Intel e Intel VPL (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. Instalar os pacotes do transcodificador. - Método CPU Software: ```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. Instalar pstreamer ou pstreamer-demo. 2. NVidia Encoder. - Instalar CUDA Toolkit versão 12.5: ```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 ``` - Instalar o driver (escolha uma opção): *legacy kernel module flavor*: ```sh sudo apt-get install -y cuda-drivers ``` ou *open kernel module flavor*: ```sh sudo apt-get install -y nvidia-driver-555-open sudo apt-get install -y cuda-drivers-555 ``` Após a instalação é obrigatório reiniciar a máquina: ```sh reboot ``` Após reiniciar, verificar o funcionamento do driver: ```sh nvidia-smi ``` Para o funcionamento do transcodificador é necessária a versão CUDA 12.5. No sistema pode já estar instalada outra versão de CUDA. Também ao atualizar o sistema o CUDA pode ser atualizado para uma versão mais recente. Isso não interfere no funcionamento — não é necessário removê-las, pois versões diferentes de CUDA são instaladas em pastas separadas. 1. Instalar os pacotes do transcodificador. - Método CPU Software: ```sh sudo apt-get install -y pstreamer-tcsw ``` - Nvidia GPU: ```sh sudo apt-get install -y pstreamer-tcnv ``` Os pacotes do transcodificador instalam os arquivos: - /usr/local/bin/tcsw — executável do transcodificador SW (CPU). - /usr/local/bin/tcnv — executável do transcodificador Nvidia (GPU). - /opt/pss/config/pss_tc_sw.properties — arquivo de configuração inicial do transcodificador SW (CPU). - /opt/pss/config/pss_tc_nv.properties — arquivo de configuração inicial do transcodificador Nvidia (GPU). 1. Verificar a instalação do transcodificador. A instalação dos pacotes do transcodificador reinicia o serviço pss. A instalação pode ser verificada na seção About — é exibida a versão ou um erro. ### Outros SO baseados em Debian e RHEL Para instalar o transcodificador pstreamer-tcnv em SO diferentes de Ubuntu 22/24 e RHEL 8+, use o configurador no site da Nvidia para escolher a versão de CUDA e o driver: [https://developer.nvidia.com/cuda-toolkit-archive](https://developer.nvidia.com/cuda-toolkit-archive) Ao escolher cada versão de CUDA está disponível a informação sobre quais versões de SO ela suporta. Arquitetura suportada — x86_64. Se for necessária uma versão mais antiga do SO, verifique seu suporte em versões mais antigas de CUDA. O requisito principal do SO — suporte a GLIBC >= 2.28. O driver da Nvidia deve ser instalado a partir do repositório indicado para a versão do seu SO na página da versão de CUDA escolhida. O suporte a placas de vídeo Nvidia para o funcionamento do transcodificador pstreamer-tcnv pode ser verificado no site da Nvidia em [Video Encode and Decode Support Matrix](https://developer.nvidia.com/video-encode-and-decode-gpu-support-matrix-new). Nessa página estão disponíveis a matriz de suporte a formatos de vídeo para decoder e encoder, bem como outras características. ## Remoção da versão antiga do CUDA e do driver Se uma versão incorreta de CUDA e driver for instalada, pode ser necessário trocar por outra versão, removendo antes a instalada. [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) ### Remoção do CUDA 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*" ``` ### Remoção do driver 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\* ```