Administração¶
O grupo Administração na área «Nó» reúne os serviços de servidor do nó, os armazenamentos, o equipamento, a licença e a manutenção. As telas do grupo estão disponíveis para a função de administrador. A configuração inicial do nó está descrita em Primeira inicialização e ativação.
Configurações do servidor¶
Configurações do servidor.¶
Parâmetros gerais do nó. A tela reúne vários grupos de configurações sob um único painel de gravação:
- Servidor
Nome do servidor, nível de registro (geral e separadamente para as bibliotecas SRT, RIST e FFmpeg), prazo de retenção dos registros, profundidade e rastreamento das estatísticas do banco de dados, bem como os limites de tamanho de ambos os bancos — registros e estatísticas.
A base de estatísticas é limitada por dois lados. «Retenção de estatísticas, horas» define a janela, e «Limite de tamanho do BD de estatísticas, MB», o volume. Zero no limite significa «sem limite», e então a base é aparada apenas pela janela; o nó eleva para 16 qualquer valor diferente de zero menor que 16 MB. Abaixo do campo, o nó informa os resultados da última limpeza: quanto de histórico restou, qual é o tamanho da base e quanto tempo levou a limpeza. Se o limite de tamanho se mostrou mais rígido do que a janela, ali mesmo é informado quanto de histórico é de fato guardado e quanto está configurado.
- Mosaico
Interruptor geral do nó para a geração do mosaico; o próprio mosaico está descrito em Mosaico.
- Meshwork
Ativação da participação do nó no Meshwork e sua identificação: nome do nó, nota, domínio Meshwork, bem como as portas HTTP e HTTPS públicas pelas quais o nó fica acessível externamente (Nós atrás de NAT), os domínios adicionais do modo super-nó e a interface de anúncio, cujo endereço o nó informa aos vizinhos (Nó com várias redes). O significado desses parâmetros está em Parâmetros do nó.
- Peers do Meshwork
Lista dos nós vizinhos e o segredo de assinatura compartilhado para a troca protegida (Vizinhos e segredos). Para cada vizinho é possível definir uma interface de anúncio própria; abaixo da lista são exibidas as interfaces de anúncio dos nós que não estão nela.
- Contato da Meshwork (avançado)
Parâmetros da sondagem dos peers: o número de threads de trabalho e o tempo limite de contato. Em um nó da versão 2.0.2.417 ou posterior, aqui mesmo ficam dois campos do alerta de vizinho indisponível (Catálogo de códigos de alerta):
«Alerta de nó fora após, s» — por quanto tempo um vizinho pode ficar em silêncio antes do alerta: de 0 a 3600, 60 por padrão; valores menores que 15 contam como 15;
«Carência após parada planejada, s» — por quanto tempo não gerar o alerta depois que um vizinho anunciou uma parada ou reinicialização planejada: de 0 a 86400, 300 por padrão.
Um valor fora do intervalo é sinalizado sob o campo, e não é possível salvar as configurações. Em um nó de versão anterior, esses campos não existem.
A configuração inicial do nó está descrita em Configurações iniciais; a implantação do Meshwork, em Construção de uma rede Meshwork.
Alertador¶
Configurações do Alertador.¶
Limiares de disparo dos alertas do nó e as regras de sua replicação. Além da ativação geral do alertador, são definidos:
limiares dos fluxos — tempo limite de ausência de dados, taxa de bits mínima, contadores de erros CC (pares «aviso / erro»);
em um nó da versão 2.0.2.417 ou posterior, sob a linha dos erros CC, o tempo de retenção do alerta de erros CC: «Disparar o alerta CC após, s» e «Limpar o alerta CC após, s» (de 0 a 3600 segundos, 30 e 60 por padrão; 0 = imediatamente);
em um nó da versão 2.0.2.420 ou posterior (cada campo, se o nó o suportar), o bloco «Ressincronização de entrada (códigos 58, 59, 61)» — limiares por hora: «Ressincronizações com perda por hora (código 58)» (padrão 3), «Ressincronizações sem perda por hora (código 61)» (de 0 a 256, padrão 0) e «Ressincronizações de saída por hora (código 59)» (padrão 6), em todos 0 = desligado; «Limpar após horas calmas» (de 1 a 24, padrão 2);
no mesmo lugar, o bloco «Entradas de reserva (código 65)» — a chave «Alertar sobre entradas de reserva com falha» (ligada por padrão) e «Esquecer o erro de uma entrada de reserva após, min» (de 0 a 525600, padrão 1440; 0 = nunca; indisponível com a chave desligada); o significado dos códigos está em Catálogo de códigos de alerta;
um aviso separado sobre a carga de CPU da thread de trabalho que atende um fluxo ou um adaptador DVB (em porcentagem);
limiares dos recursos — CPU e memória do host, CPU e memória do processo e do transcodificador, carga da rede, GPU, uso do disco (em porcentagem, pares «aviso / erro»); em um nó da versão 2.0.2.416 ou posterior, abaixo da linha «GPU» há uma linha «Memória de vídeo da GPU»: os limiares do alerta de preenchimento da memória de vídeo de uma placa NVIDIA;
em um nó da versão 2.0.2.416 ou posterior, o tempo de retenção dos alertas do sistema: «Disparar o alerta do sistema após, s» e «Limpar o alerta do sistema após, s» (de 0 a 3600 segundos, 30 e 60 por padrão; 0 = imediatamente);
tempo de leitura/gravação dos armazenamentos DVR;
havendo recepção DVB — limiares de qualidade do sinal dos frontends (nível do sinal, SNR, taxa de erros de bit, blocos não corrigidos).
Sob a ativação geral, o nó lembra o que este interruptor abrange: um alertador desativado silencia também a entrega externa (o processo, o Telegram e o e-mail), inclusive para os alertas replicados dos vizinhos do domínio e para o aviso de resolução de um incidente já comunicado.
A replicação dos alertas pelo domínio Meshwork e, separadamente, dos alertas de hardware do sistema é ativada aqui mesmo (Replicação de alertas em todo o domínio). A entrega externa é configurada em uma janela separada (Destinos de alerta).
O modelo de alertas está descrito em Como funciona um alerta, os limiares, em Configurações do alerter. Os alertas ativos podem ser vistos na tela Alertas.
Destinos de alerta¶
A janela de entrega externa dos alertas é aberta a partir da tela Alertador pelo botão «Destinos de alerta…». Os canais estão distribuídos por abas; para cada um define-se o seu próprio limiar de importância mínima do evento:
- Processo
Execução de um comando externo no evento de alerta com o tempo limite definido. Como o comando é executado e o que ele recebe, com modelos de scripts, está descrito em Scripts externos para alertas.
- Telegram
Envio para o Telegram: o token do bot e a lista de ID dos chats.
Envio por SMTP: host e porta do servidor, modo TLS (STARTTLS, TLS implícito ou sem criptografia), verificação do certificado do servidor, credenciais, endereços do remetente e dos destinatários.
Todas as abas da janela estão subordinadas à ativação geral do alertador na tela Alertador: com o serviço desativado, um canal configurado não envia nada. As regras de entrega estão descritas em Entrega externa de alertas.
Servidor web e contas¶
Servidor web e contas.¶
Configuração do servidor web do painel de administração e das contas de acesso. A tela contém as abas:
- Servidor
Porta HTTP e nome do host, ativação de HTTPS com porta separada e escolha do repositório de CA, rastreamento detalhado. Enquanto o HTTPS está desativado, a «Porta HTTPS» e a escolha do repositório de CA aparecem esmaecidas com a explicação «O HTTPS está desativado — ative o TLS para usar o certificado.»; os campos respondem ao próprio comutador, sem esperar pelo salvamento, e os valores inseridos não se perdem. Abaixo ficam as informações sobre o certificado TLS atual (sujeito, emissor, prazo de validade, SAN) com as ações de importação do certificado e da chave privada e de recarga do TLS; com o HTTPS desativado, o painel exibe a mesma explicação em vez das informações, mas a importação continua disponível.
- Contas
Contas locais de acesso ao painel e suas funções — Admin, Restricted admin, Viewer (Acesso e funções). Para cada uma são definidos o login, a senha e a função; as contas podem ser adicionadas, alteradas e excluídas. Na criação a senha é obrigatória; na alteração o campo da senha é exibido vazio e, se não for preenchido, a senha permanece a mesma.
O último seletor de uma conta é «Entrada automática», desativado por padrão. Com ele, um navegador que uma vez entrou com esta conta abre a interface deste nó sem o formulário de entrada nos 14 dias seguintes; as contas com entrada automática são marcadas na lista com a palavra «Entrada automática». O prazo é contado a partir da entrada e não é prolongado pelo trabalho: ao expirar, o formulário volta a aparecer. Um link para um nó vizinho seguido a partir desta interface transmite a sessão adiante: um nó do domínio se abre já com a entrada realizada. Para isso, várias condições precisam ser cumpridas. O vizinho deve publicar o seu ponto de entrada (HTTP ou HTTPS); ele é visível nos detalhes da sua linha na tela «Nós» (Nós). O domínio pelo qual os nós se veem deve ser o próprio de ambos: uma ligação apenas pelo domínio adicional do modo super-nó não transmite a sessão em nenhuma direção. E se o vizinho tiver a sua própria conta com o mesmo login, quem decide é o seletor dele: com a «Entrada automática» desativada, ele não aceita essa sessão. Se o vizinho não tiver essa conta, a sessão é aberta nele com a função Viewer, qualquer que seja a função da conta no nó de origem. Quando algo disso não se cumpre, um vizinho acessível se abre mesmo assim, mas no seu próprio endereço e com o formulário de entrada. Um endereço de vizinho digitado à mão também não transmite a sessão, assim como uma conta sem entrada automática.
O próprio nó explica a recusa: acima do conteúdo aparece uma faixa «Aberto sem entrada: …» com o motivo. Os motivos são de quatro tipos. Dois são apontados pelo nó de onde se veio, outros dois são informados pelo próprio vizinho:
neste navegador não há sessão de entrada automática para o nó de onde se veio;
o domínio comum não é o principal para o nó de onde se veio — é o que acontece com um super-nó que vê o vizinho apenas por um domínio adicional;
o vizinho conhece esta conta, mas nele a entrada automática não está ativada para ela;
o vizinho não aceitou a sessão de transição: ela lhe é desconhecida, expirou ou foi revogada.
Na prática, o terceiro motivo é o mais frequente: a entrada automática vem desativada por padrão, por isso é com ele que termina a transição para um nó onde a mesma conta foi simplesmente criada de novo. A faixa é desenhada pela administração do vizinho, por isso nas compilações anteriores do vizinho não aparece nenhum dos quatro motivos: um vizinho assim não informa os seus dois motivos e não entende os dois alheios, e a transição termina com o formulário de entrada, sem explicação. A faixa aparece quando a administração do vizinho abriu, ou seja, já depois da entrada, se ela foi necessária; fecha-se no X e não volta após a recarga da página.
A entrada automática fica vinculada a um único navegador: entrar com a mesma conta em outro navegador funciona da forma habitual, mas nele não haverá entrada automática. A entrada automática é encerrada pelo botão «Sair», bem como pela desativação do seletor, pela troca de função, pela renomeação e pela exclusão da conta: a sessão é fechada em poucos segundos após salvar. O seletor está disponível para uma conta de qualquer função, por isso convém ativá-lo com atenção aos direitos dessa conta.
A emissão automática de certificados fica na tela Certificados HTTPS; a recarga do TLS sem reinício, também em Manutenção. As portas dos serviços e a configuração inicial estão descritas em Configurações iniciais.
Servidor HTTP de streaming¶
Servidor HTTP de streaming.¶
Configuração do servidor HTTP integrado de entrega de fluxos (distribuição OTT, playlists e segmentos HLS/DASH). Na parte superior fica o status dos listeners (HTTP, HTTPS, HTTP/3). São configurados:
- Servidor
Porta HTTP, nome do host, rastreamento detalhado.
- TLS
Ativação de HTTPS com porta separada e escolha do repositório de CA. A porta e o repositório ficam esmaecidos enquanto o HTTPS está desativado.
- HTTP/3 (QUIC)
Ativação do HTTP/3 em uma porta UDP separada e permissão dos dados antecipados 0-RTT; a porta e o 0-RTT ficam esmaecidos enquanto o próprio HTTP/3 está desativado. Este bloco não depende do HTTPS: o HTTP/3 tem um listener separado, que usa diretamente os arquivos do certificado e funciona com o HTTPS desativado. É justamente isso que o bloco «Status» mostra: o «HTTPS» pode estar em «Desativado» com o «HTTP/3» em funcionamento.
Abaixo fica o painel do certificado TLS atual com a importação e a recarga do TLS. O painel acompanha apenas o HTTPS, por isso, com o HTTPS desativado, ele não exibe nada mesmo quando o mesmo certificado é distribuído por HTTP/3. A distribuição está descrita em OTT e DVR, e o transporte HTTP/3, em HTTP/3 (QUIC).
Servidor EPG¶
Servidor EPG.¶
Configuração do serviço de entrega de EPG (XMLTV) a consumidores externos — middleware e aplicações. São definidos a ativação do serviço, a porta, o nome do host e o rastreamento detalhado, o HTTPS com porta separada e repositório de CA; também está disponível o painel do certificado TLS. A porta HTTPS e o repositório de CA ficam esmaecidos enquanto o serviço está desativado ou o HTTPS está desativado. As contas de acesso ao EPG e os conjuntos de canais são configurados separadamente, na tela Configurações EPG. A integração com middleware está descrita em EPG para middleware OTT.
Certificados HTTPS¶
Certificados HTTPS (ACME).¶
Emissão e renovação automáticas de certificados TLS por meio de ACME (Let’s Encrypt). Na parte superior é exibido o status: o estado da emissão, a hora da última execução, a conta ACME e a lista dos certificados emitidos com seus prazos. São configurados:
- Emissão automática
Ativação e e-mail de contato. A ativação significa a concordância com as condições da autoridade certificadora.
- Avançado
URL do diretório ACME, porta da validação HTTP-01, prazo de renovação antecipada e parâmetros de vinculação externa da conta (EAB).
A ação «Emitir / renovar agora» inicia a emissão imediatamente. Os certificados próprios são carregados nas telas dos serviços correspondentes (Servidor web e contas, Servidor HTTP de streaming, Servidor EPG). A ativação do TLS está descrita em Configurações iniciais.
Armazenamentos DVR¶
Armazenamentos DVR.¶
Diretórios do arquivo DVR. Os armazenamentos podem ser adicionados, alterados e excluídos; para cada um são definidos o nome, o caminho do diretório (imutável após a criação), a observação e o uso máximo do disco. O «Caminho do diretório» é escrito sem / final: o nó não aceita um caminho terminado em separador (a exceção é a própria raiz /), e o texto da recusa vem do nó como está, em inglês. A edição do caminho está fechada, por isso um armazenamento criado com separador em compilações anteriores é corrigido excluindo-o e criando-o novamente. Um grupo separado controla o comportamento em caso de falta de espaço: o intervalo de limpeza, o adiamento e o truncamento em caso de transbordamento, a reserva de emergência e a histerese da limpeza; a reserva de emergência é reservada e não afeta o funcionamento (Armazenamentos DVR). A redução do limite de uso trunca a parte mais antiga do arquivo; a exclusão de um armazenamento deixa os arquivos no disco, mas os fluxos conectados perdem o acesso ao VOD. A ocupação atual dos discos é visível na tela Monitor de DVR. A gravação e a reprodução do arquivo estão descritas em Armazenamentos DVR e OTT e DVR.
Manutenção¶
Manutenção.¶
Operações de serviço do nó, agrupadas por seções:
- Nó
Reinicialização normal do nó com confirmação — interrompe brevemente todos os fluxos.
- Certificados TLS
Releitura do certificado TLS a partir do disco sem reinício — separadamente para o servidor web, o servidor HTTP de streaming e o servidor EPG.
- Cópia de segurança da configuração
Download de um instantâneo gzip da configuração do nó.
- Restauração
Carregamento de uma cópia salva anteriormente: a configuração é substituída e o nó é reinicializado.
Os arquivos e os serviços estão descritos em Arquivos e serviços.
Equipamento¶
Equipamento.¶
O equipamento de recepção detectado disponível para o nó (somente leitura; o botão de atualização relê a lista). Dois blocos:
- Adaptadores DVB
Frontends de recepção DVB: nome, sistemas de entrega suportados, versão da DVB API, capacidades, faixas de frequência e de taxa de símbolos, indicador de ocupação.
- Módulos CAM
Slots CI/CAM: o módulo inserido e seu modelo, o tipo e o estado do slot, os identificadores dos sistemas CA e o status da assinatura (desembaralhamento) por programa.
É aqui também que os dois tipos de módulo se distinguem, e este é o único ponto da interface em que a diferença é nomeada de forma explícita. No cabeçalho recolhido do slot há uma etiqueta «Modelo A» ou «Modelo B», e no corpo expandido uma linha «Modelo» com o valor A (sec-pump) ou B (welded); a letra e a palavra vêm do nó e não são traduzidas. O modelo A é um módulo separado pelo qual passa por inteiro a entrada de um fluxo; ele é configurado na entrada (CI/CAM na entrada de um fluxo). O modelo B é um módulo soldado no sintonizador; ele é configurado no próprio adaptador DVB, pelo programa de adaptador dele (Desembaralhamento). No restante da interface a letra não é exibida em lugar algum: o operador que configura um módulo os distingue pelo local onde isso é feito.
A linha «ID do módulo» descreve o próprio módulo: identificador do fabricante, código do produto e, quando o módulo o informa, o tipo de aplicação EN 50221 (4A60:0001 · type 1). A linha surgiu na 2.0.2.362; na mesma compilação o nó passou a decodificar o nome do módulo, de modo que nomes cirílicos deixaram de chegar corrompidos.
Três linhas do slot dizem respeito ao seu arrendamento: «Arrendamento CI» com o valor «Ocupado» ou «Livre», «Retido por» com o prefixo de serviço do detentor em fonte monoespaçada, e «Mensagem do módulo» com o que o módulo exibiu na tela por último. As linhas aparecem apenas quando o nó comunica um valor, de modo que um slot livre não tem a linha «Retido por». Não confundir com o «livre» e o «ocupado» do bloco de adaptadores DVB: lá se trata do sintonizador, aqui do arrendamento de um slot.
Liberação de um slot. No restante, a tela «Equipamento» serve apenas para visualização; nela há duas ações, e ambas ficam lado a lado no corpo do slot expandido, abaixo de todas as linhas de valores. A primeira é «Liberar». O botão está disponível apenas para o administrador. Um módulo do modelo B não o tem de forma alguma: esse slot não mantém arrendamento, e a chamada seria recusada de qualquer forma. Quando ninguém retém o slot, o botão fica visível, porém indisponível, e ao lado está escrito o porquê: «Não há o que liberar: nenhuma entrada retém o slot.». Em um nó anterior a 2.0.2.361 a ação não existe.
A janela de confirmação «Liberar o slot CI?» traz também a ordem dos passos: «O slot é retido por {holder}. Retire primeiro cam-device nessa entrada: uma entrada em funcionamento tomará o slot de volta em cerca de dois segundos. A própria chamada pode levar alguns segundos.». Vale ler ao pé da letra: a liberação não se fixa. Uma entrada em funcionamento tomará o slot de volta quase imediatamente, por isso primeiro se retira o slot na entrada e só depois se libera. A chamada de fato demora um ou dois segundos enquanto o nó interrompe a troca de dados com o módulo; o botão exibe ocupação durante esse tempo.
Há quatro desfechos. Se o slot foi liberado, a janela se fecha, aparece «Slot CI liberado.» e a lista de slots é relida. Se ninguém retinha o slot, isso também é sucesso: a janela se fecha com a mensagem «Ninguém retém o slot.». Se o slot está mudando de titular neste momento, a janela permanece aberta com a mensagem «O slot está mudando de titular neste momento. Repita em um instante.», para repetir com um só clique. Em qualquer outra recusa, a janela permanece aberta e exibe a mensagem do próprio nó e, se o nó não a enviou, a mensagem «Não foi possível liberar o slot CI.».
A recepção DVB está descrita em Receptor DVB e Adaptadores, e o trabalho com CAM e o desembaralhamento, em Desembaralhamento. Os dispositivos de transcodificação detectados são mostrados na tela Sobre o sistema.
Licença¶
Licença.¶
Informações sobre a licença do nó: cliente, tipo de licença, formato da chave, início da validade e tempo licenciado; quando o nó informa o identificador e o tipo da chave, é exibido o bloco HASP. Os limites exibidos são o que a licença permite, e não o que o nó consome no momento; um parâmetro em que não há limite não é exibido de forma alguma. Na versão de demonstração essas mesmas linhas descrevem os próprios tetos embutidos dela, e não uma licença. Isso é sinalizado pelo indicador «Demo» e pela nota na seção «Atributos da licença»: ao contrário dos atributos da licença, esses tetos de fato limitam o nó. A ativação permanente por chaves SL/HL está descrita em Ativação permanente; o comportamento na expiração da licença — em Ao expirar o prazo da licença anual ou de teste.
A seção «Ativação» funciona em um nó com o sistema de proteção, seja a chave de software ou USB. Se o nó não tem dados de ativação, a seção informa exatamente isso e não mostra botões; esse é um estado normal, não um erro.
«Dados do cliente» — a exportação do estado da chave para o fornecedor: «Baixar arquivo C2V» salva um arquivo nomeado conforme o identificador da chave, «Copiar C2V» coloca o mesmo conteúdo na área de transferência. O nó não envia nada para fora nesse momento: as duas ações apenas entregam ao operador o mesmo texto. Se o navegador negou o acesso à área de transferência, a interface informa isso; o download funciona sempre.
«Ativar licença» — a aplicação da chave V2C enviada pelo fornecedor: «Carregar arquivo V2C…» abre o seletor de arquivos, «Colar V2C…» — um campo para colar o texto. O botão «Ativar» só é habilitado depois que um arquivo é escolhido ou o campo é preenchido.
A aplicação da chave reinicia o nó: alguns segundos depois de a chave ser aceita, o serviço é reiniciado. Não é possível adiar o reinício, e as janelas de ativação avisam sobre isso de antemão. Enquanto o nó está indisponível, a interface mantém uma tela de espera e volta sozinha assim que o nó sobe.
Se a chave for rejeitada, a janela permanece aberta e mostra a mensagem do próprio nó. É justamente ela que precisa ser lida: as recusas são de tipos diferentes, e suas consequências também são diferentes. A chave pode não ter servido de jeito nenhum: então nada mudou na chave. Mas a chave pode já ter sido gravada e a recusa chegar depois disso. Isso acontece quando o nó não conseguiu reler o que gravou e quando a licença resultante já estava vencida. A tela de licença não se relê sozinha: para ver o que está agora na chave, é preciso abrir a página de novo.
Duas recusas são mais perigosas do que as demais, e não podem ser lidas como «não aconteceu nada»: o nó informa que a licença foi aplicada mas já está vencida, ou que ela foi aplicada mas foi considerada não autêntica (o texto, como todas as respostas do nó aqui, chega em inglês). Nos dois casos uma licença imprestável já está na chave, e um nó com essa licença se reinicia sozinho e não volta a subir. Qualquer uma dessas duas recusas significa que é preciso outra chave, e é preciso de imediato.
A transferência da licença para outro nó não está prevista na interface; ela, assim como a aplicação de uma atualização e a exportação do C2V pela linha de comando, é feita pelo utilitário pss_lic (PSS Lic Perfect Streamer Toolkit v2.1 — licença do nó).
Sobre o sistema¶
Sobre o sistema.¶
Resumo sobre o sistema, agrupado por seções:
- Licença
Informações resumidas sobre a licença — os detalhes estão na tela Licença.
- Transcodificadores
Os backends de transcodificação detectados: tipo, versão do módulo executável, prontidão e lista de dispositivos. A instalação dos pacotes do transcodificador está descrita em Transcodificadores, e a escolha do backend, em Backends e codecs.
- Compilação e bibliotecas
Versão da compilação do PSS e versões das bibliotecas integradas, tipo da compilação.
- Identificação
Nome do servidor, o nó e sua observação, a conta atual, o tempo de funcionamento e o momento de inicialização, a restrição por IP de origem.
A documentação também pode ser aberta a partir da barra comum da interface (Barra comum).
