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 o papel 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; «Limite de tamanho do BD de estatísticas, MB», o volume: zero significa «sem limite», e então a base é aparada apenas pela janela; um valor diferente de zero menor que 16 MB o nó eleva para 16. Abaixo do campo, o nó presta contas da última limpeza — quanto de histórico restou, qual é o tamanho da base e quanto durou a limpeza — e, se o limite de tamanho se mostrou mais rígido do que a janela, ali mesmo é informado quanto de histórico é de fato guardado em relação ao configurado.
- Mosaico
Interruptor geral do nó para a geração do mosaico; o próprio mosaico — 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 e os domínios adicionais — os endereços pelos quais o nó fica acessível a partir do exterior (Nós atrás de NAT). O modelo de identificação — Identidade do nó.
- Peers do Meshwork
Lista dos nós peers e o segredo de assinatura compartilhado para a troca protegida (Peers e segredos).
- Contato Meshwork (avançado)
Parâmetros da sondagem dos peers: o número de threads de trabalho e o tempo limite de contato.
A configuração inicial do nó — 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»);
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»);
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 até onde alcança este interruptor: um alertador desativado silencia também as entregas externas — o processo, o Telegram e o e-mail —, incluindo os alertas replicados dos peers do domínio e 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. A visualização dos alertas ativos — na tela Alertas.
Destinos de alerta¶
A janela de entrega externa dos alertas é aberta a partir da tela Alertador. 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.
- 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 — 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 seus papéis — Admin, Restricted admin, Viewer (Acesso e funções). Para cada uma são definidos o login, a senha e o papel; os registros podem ser adicionados, alterados e excluídos. 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 abre-se já com a entrada realizada. Há várias condições para isso. 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. Quando algo disso não se cumpre, um vizinho acessível abre-se 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: os seus dois um vizinho assim não informa, e os dois alheios não entende — 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 pela cruz e não volta após a recarga da página.
A entrada automática está presa 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 papel, 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 papel, por isso convém ativá-lo com atenção aos direitos dessa conta.
A emissão automática de certificados — 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 — 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 é um listener separado, pega os arquivos do certificado diretamente 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 — 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 fica silencioso mesmo quando o mesmo certificado é distribuído por HTTP/3. A distribuição está descrita em OTT e DVR, 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 — 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. O carregamento de certificados próprios é realizado 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: um caminho terminado em separador o nó não aceitará (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 uma entrada criada com separador em compilações anteriores é corrigida excluindo-a e criando-a 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 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 é observada 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 através do qual a entrada de um fluxo é bombeada por inteiro; ele é armado na entrada (CI/CAM na entrada de um fluxo). O modelo B é um módulo soldado no sintonizador; ele é armado 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 arma um módulo os distingue pelo local onde isso é feito.
A linha «ID do módulo» é o passaporte do 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á trata-se do sintonizador, aqui do arrendamento de um slot.
Liberação de um slot. A tela «Hardware» no restante apenas lê; 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 só poderia falhar. Quando ninguém retém o slot, o botão fica visível, porém travado, 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 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 as bombas são reunidas — o botão exibe ocupação durante esse tempo.
Os desfechos são quatro. O slot foi liberado — a janela se fecha, aparece «Slot CI liberado.» e a lista de slots é relida. Ninguém retinha o slot — isso também é sucesso: a janela se fecha com a mensagem «Ninguém retém o slot.». O slot está mudando de titular neste momento — a janela permanece aberta com «O slot está mudando de titular neste momento. Repita em um instante.», para repetir com um só clique. Qualquer outra recusa — a janela permanece aberta e exibe a mensagem do próprio nó e, se o nó não a enviou, «Não foi possível liberar o slot CI.».
A recepção DVB está descrita em Receptor DVB e Adaptadores, 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 eixo em que não há limite não é exibido de forma alguma. Em uma compilação de demonstração essas mesmas linhas descrevem os próprios tetos embutidos dela, e não uma licença, e esse caso se distingue apenas pelo indicador «Demo». A ativação permanente por chaves SL/HL está descrita em Ativação permanente; o comportamento no vencimento 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 — não importa se 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 um único e 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 vai para o reinício — não dá para adiar, 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.
Uma chave rejeitada deixa a janela aberta e mostra a mensagem do próprio nó — é justamente ela que precisa ser lida, porque as recusas são de tipos diferentes, e suas consequências também. 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 — é o que acontece quando o nó não conseguiu reler o que gravou e quando a licença resultante saiu vencida. A tela de licença não vai se reler 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 vai sozinho para o reinício 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, é realizada pelo utilitário pss_lic (PSS Lic Perfect Streamer Toolkit v2.0 — 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 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 — em Transcodificadores, 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 chamada da documentação também está disponível a partir do painel comum da interface (Barra comum).