Instância de teste no mesmo host¶
Importante
Versão beta 2.1. O que está descrito aqui existe apenas na versão beta 2.1: ela é instalada a partir do repositório beta e somente com uma licença; a versão estável 2.0.2 e a versão de demonstração não têm isso. A versão beta é fornecida sem garantias, e o suporte é prestado na medida do possível (Programa de testes beta).
A partir da versão 2.1.2.612, no host onde roda o serviço de produção pss, é possível iniciar uma segunda instância do streamer, de teste — por exemplo, para verificar uma nova build com as mesmas fontes sem parar o nó de produção. A instância de teste trabalha com seu próprio diretório de configurações e difere da de produção por três opções de linha de comando. Essas opções não vão para o arquivo de configurações, portanto as configurações copiadas do nó de produção não as incluirão. Sem essas opções, o streamer inicia como antes.
Opções de inicialização¶
--instance-tag=<rótulo>Rótulo da instância: de 1 a 16 caracteres, letras latinas minúsculas, dígitos e hífen. Ele separa os canais de troca com os transcodificadores: sem ele, duas instâncias com os mesmos números de fluxos e saídas interferem nos transcodificadores uma da outra.
--bind-address=<endereço IPv4>A interface web, o servidor OTT (HTTP, HTTPS, HTTP/3) e o servidor EPG escutam apenas esse endereço. As entradas e saídas dos fluxos trabalham com seus próprios endereços definidos nas configurações dos fluxos. O servidor RTMP não é afetado por essa opção (passo 3 abaixo).
--isolatedA instância não acessa o exterior: ficam desativados o Meshwork e as conexões com vizinhos, a reserva, os destinatários externos de alertas (Telegram, e-mail, webhook, execução de programa) e a verificação de webhook, a obtenção de certificados ACME, os alertas de emergência CAP (Alertas CAP automáticos), LDAP, PMS e DVB; as operações com a licença (atualização, desvinculação, transferência) respondem com recusa. Também ficam desativados os servidores externos de faturamento (a autorização de espectadores pelo faturamento). As configurações não mudam: tudo isso fica desativado apenas enquanto a instância está em execução. Os fluxos próprios da instância funcionam conforme configurados.
Com a opção --bind-address ou --isolated, uma porta da interface web, do servidor OTT ou EPG que já esteja ocupada por outro processo a instância não compartilha com ele, mas recebe uma recusa: no log aparece o erro Address already in use, na inicialização e a cada aplicação das configurações. Sem elas (apenas --instance-tag), tal porta é compartilhada com o nó de produção, e parte das conexões vai para a instância de teste.
Um valor inválido de opção interrompe a inicialização com uma mensagem de erro.
Como iniciar¶
Crie o diretório de configurações da instância de teste, por exemplo
/opt/pss-test/config, e copie para ele opss.propertiesdo nó de produção.Nesta cópia do
pss.properties, defina caminhos próprios: no mínimo o diretório do loglog-dir, e também cada caminho de dados que estiver definido ali. Caso contrário, as duas instâncias escrevem no mesmo log e no mesmo banco de estatísticas.Defina portas próprias para a instância de teste nas configurações dela: as portas da interface web (Servidor web e contas), do servidor OTT, incluindo HTTPS e HTTP/3 (Servidor HTTP de streaming), e do servidor EPG (Servidor EPG). Uma porta que o nó de produção já escuta não ficará disponível para a instância de teste se a instância for iniciada com a opção
--bind-addressou--isolated. Se o servidor RTMP estiver ativado nas configurações (Servidor RTMP), defina outras portas para ele ou desative-o (porta RTMP 0, RTMPS desativado): as opções--bind-addresse--isolatednão atuam sobre ele.Inicie a instância com o diretório de configurações e as opções:
$ sudo /usr/local/bin/pss -c /opt/pss-test/config --instance-tag=test --bind-address=192.0.2.10 --isolated -C
A opção
-Cexibe o log no console. Para operação permanente, escreva um arquivo de serviço systemd separado — uma cópia dopss.servicecom sua própria linhaExecStart; o pacote não instala um segundo arquivo de serviço.
Se a instância está rodando com essas opções, é possível ver em /data/server: os campos instance-tag, isolated="1" e bind-address existem apenas na instância iniciada com a opção correspondente (Gerenciamento pela API HTTP).
Aviso
--isolated não para os fluxos. As saídas da instância de teste — UDP e multicast, publicações SRT e RTMP e outras — vão para a rede de verdade. Não repita nelas os grupos, as portas e os endereços de publicação do nó de produção. As entradas leem aquilo para que apontam: receber o mesmo multicast que o nó de produção é permitido.
Licença¶
A instância de teste usa a mesma chave de proteção que o nó de produção. Cada instância verifica as restrições da licença pelos seus próprios fluxos, sem somar com a outra. Uma chave de rede com limite de conexões simultâneas pode recusar a segunda instância; uma chave local neste host normalmente não recusa. Com --isolated, a instância de teste não altera a licença do host: não é possível atualizá-la nem transferi-la a partir dela.