Início rápido¶

Esta página leva uma máquina vazia até um stream no ar. Tudo acontece nessa única máquina: o pacote catena a transforma em uma instalação completa —plano de controle e streamer em um mesmo processo— e provisiona o próprio banco de dados pelo caminho.

Aqui você não configura PostgreSQL, nem streamers, nem um cluster. Isso vem depois, quando a instalação cresce além de um único servidor.

O que é necessário¶

• Uma máquina com Ubuntu 24.04 e acesso root.
• Acesso de saída à internet — a licença é ativada online.
• Uma chave de licença. Copie-a na área do cliente em my.flussonic.com: a instalação pede a chave por conta própria, não é preciso criar nenhum license.txt à mão.

Conectar o repositório¶

Os pacotes vêm do repositório da Flussonic:

curl -L http://apt.flussonic.com/repo/master/dev.key > /etc/apt/trusted.gpg.d/dev.gpg
echo "deb http://apt.flussonic.com/branch/sapsan/master repo/" > /etc/apt/sources.list.d/flussonic.list
apt update

Instalar¶

apt install --install-recommends catena

A instalação pede a chave de licença — cole a que você copiou da área do cliente. O pacote a escreve por conta própria em /etc/catena/license.txt (dono root, modo 0600). A resposta pode ficar vazia: o pacote é instalado, mas o serviço não inicia enquanto a chave não estiver lá. Se o arquivo de licença já estiver na máquina, a pergunta não é feita — uma atualização não pergunta nada de novo.

Um pacote basta. O catena torna esta máquina uma instalação Catena e traz junto o que isso exige: o servidor de streaming da versão correspondente e o PostgreSQL.

O --install-recommends importa: os plugins do transcodificador (sapsan-transcoder) são uma dependência recomendada, não obrigatória — o servidor funciona sem eles, mas nada pode ser codificado. O apt instala os pacotes recomendados por padrão, então em um sistema comum a opção não muda nada; em um host configurado com APT::Install-Recommends "false" é ela que mantém a transcodificação disponível.

Durante a instalação, o pacote catena:

• cria a role e o banco de dados catena no PostgreSQL;
• gera uma senha para o banco de dados e outra para o administrador, e grava ambas em /etc/catena/secrets.env (modo 0600, pertencente ao root);
• inicia o catena.service, que aplica o esquema do banco de dados na primeira execução.

As senhas nunca são impressas no terminal — você as lê do arquivo. Reinstalar ou atualizar o pacote reaproveita os segredos existentes em vez de rotacioná-los.

Fazer login¶

Leia a senha do administrador:

grep EDIT_AUTH_PASSWORD /etc/catena/secrets.env

Abra http://<endereço-do-servidor>/ em um navegador e faça login como admin com essa senha. Você chega ao Painel de controle: um streamer — esta máquina — e nenhum stream ainda.

Criar o primeiro stream¶

Vá em Streams. Uma instalação recém-feita não tem nenhum.

Digite quickstart como nome e pressione Criar. O stream abre na aba Fontes, ainda sem nada configurado.

Pressione + Adicionar fonte e defina o protocolo como Synthetic — um gerador embutido, para verificar a reprodução antes de conectar uma fonte real. Marque Generate video (SMPTE bars) e Generate audio (beep/bop): os valores padrão que aparecem (1280×720 a 25 fps, 48 kHz estéreo) são os desejados. Pressione Salvar.

O gerador emite quadros não comprimidos, que nenhum reprodutor comum lê, então o stream também precisa de um transcodificador. Abra a aba Transcodificador e pressione Standard ladder 1080/720/360 + AAC — um único preset cobre todo o trabalho. Pressione Salvar.

O central registra o stream e o entrega ao streamer. Em alguns segundos o stream aparece como em execução.

Reproduzir¶

Volte para a aba Configurações básicas. A página do stream traz um reprodutor embutido: as barras de teste com um relógio correndo significam que todo o caminho funciona — fonte, transcodificador, streamer e reprodução.

O mesmo stream fica disponível para qualquer reprodutor externo em http://<endereço-do-servidor>/streaming/v/quickstart/index.m3u8.

Se algo deu errado¶

Verifique o serviço e o log dele:

systemctl status catena
journalctl -u catena -n 50

• O serviço não está em execução e o log menciona a licença. A chave não foi informada durante a instalação. Coloque-a em /etc/catena/license.txt e execute systemctl start catena.
• A instalação informou que o PostgreSQL estava inacessível. O banco de dados não foi provisionado. Crie-o você mesmo, escreva DATABASE_URL em /etc/catena/secrets.env e execute systemctl restart catena.
• O reprodutor diz que não consegue carregar o vídeo. O stream está em execução, mas nada reproduzível sai dele — quase sempre é um transcodificador ausente: o gerador sintético produz quadros brutos, e um reprodutor precisa de H.264 e AAC. Verifique a aba Transcodificador.
• O transcodificador está configurado e mesmo assim o stream não produz nada. Verifique se os plugins de codificação estão instalados: dpkg -l | grep sapsan-transcoder. Se apenas o pacote -base estiver lá, a máquina foi instalada sem os pacotes recomendados — execute apt install --install-recommends catena.
• O stream existe mas não inicia. Olhe a página do stream: ela mostra se o stream foi colocado em um streamer e se a fonte dele está viva.

Para onde ir depois¶

Tudo isto cabe nesta única máquina, sem configuração adicional:

• conectar fontes reais, configurar fontes reservas e a comutação entre elas;
• acrescentar transcodificação multibitrate, gravação do arquivo e nPVR;
• configurar a reprodução e sua autorização.

Quando uma máquina deixar de bastar, acrescente uma segunda: o plano de controle que você já tem permanece onde está, nada é desmontado.