---
title: Instância de teste no mesmo host
url: https://doc2.pstreamer.tv/pt/manual/install/test_instance.html
lang: pt-BR
product: Perfect Streamer
version: 2.0.2.423
---

# 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](../extras/beta.md#extras-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).
**`--isolated`**
  A 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](../streamer/cap.md#streamer-cap)), 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

1. Crie o diretório de configurações da instância de teste, por exemplo `/opt/pss-test/config`, e copie para ele o `pss.properties` do nó de produção.
2. Nesta cópia do `pss.properties`, defina caminhos próprios: no mínimo o diretório do log `log-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.
3. Defina portas próprias para a instância de teste nas configurações dela: as portas da interface web ([Servidor web e contas](../webui/administration.md#webui-web-server)), do servidor OTT, incluindo HTTPS e HTTP/3 ([Servidor HTTP de streaming](../webui/administration.md#webui-http-server)), e do servidor EPG ([Servidor EPG](../webui/administration.md#webui-epg-server)). 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-address` ou `--isolated`. Se o servidor RTMP estiver ativado nas configurações ([Servidor RTMP](../webui/administration.md#webui-rtmp-server)), defina outras portas para ele ou desative-o (porta RTMP 0, RTMPS desativado): as opções `--bind-address` e `--isolated` não atuam sobre ele.
4. Inicie a instância com o diretório de configurações e as opções:

   ```sh
   $ sudo /usr/local/bin/pss -c /opt/pss-test/config --instance-tag=test --bind-address=192.0.2.10 --isolated -C
   ```

   A opção `-C` exibe o log no console. Para operação permanente, escreva um arquivo de serviço systemd separado — uma cópia do `pss.service` com sua própria linha `ExecStart`; 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](../extras/api.md#extras-api)).

> **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.
