Início rápido¶

Esta página leva uma máquina vazia até um canal 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.
• Um arquivo com a chave de licença (license.txt). O Catena não inicia sem ele.

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

Colocar a licença no lugar¶

Coloque o arquivo de licença antes de instalar, para que o serviço inicie logo após a instalação:

mkdir -p /etc/catena
cp license.txt /etc/catena/license.txt
chmod 600 /etc/catena/license.txt

Se você não tiver o arquivo à mão, pule este passo: a instalação pede a chave e a grava por conta própria.

Instalar¶

apt install --install-recommends catena

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 canal ainda.

Criar o primeiro canal¶

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

Digite quickstart como nome e pressione Criar. O canal 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 canal também precisa de um transcodificador. Abra a aba Processo e pressione Standard ladder 1080/720/360 + AAC — um único preset cobre todo o trabalho. Pressione Salvar.

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

Reproduzir¶

Volte para a aba Configurações básicas. A página do canal 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 canal 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. O arquivo de licença não estava presente no momento da instalação. Coloque-o 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 canal 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 Processo.
• O transcodificador está configurado e mesmo assim o canal 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 canal existe mas não inicia. Olhe a página do canal: ela mostra se o canal 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.