Início rápido¶

Esta página leva uma máquina limpa até uma transmissão no ar. Tudo acontece nessa máquina: o pacote agora a transforma em uma instalação completa — o plano de controle e um streamer em um mesmo processo — e de passagem prepara o seu próprio banco de dados.

Aqui não se configuram o banco de dados, os streamers nem o cluster. Isso vem depois, quando a instalação ficar grande demais para um único equipamento.

O que é preciso¶

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

Adicionar o repositório¶

Os pacotes estão no 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 agora

A instalação pede a chave de licença: cole a que você copiou da sua conta. O pacote a escreve ele mesmo em /etc/agora/license.txt (dono root, modo 0600). Você pode deixar a resposta vazia: o pacote se instala, mas o serviço não inicia enquanto não houver uma chave. Se a máquina já tiver um arquivo de licença, a pergunta não é feita: uma atualização não pergunta nada de novo.

Basta um pacote. O agora torna esta máquina uma instalação da Agora e puxa tudo o que é necessário para isso.

O --install-recommends não é enfeite aqui: os plugins do transcodificador são uma dependência recomendada, não obrigatória. O servidor funciona sem eles, mas não tem com o que codificar. O apt instala os pacotes recomendados por padrão, então em um sistema comum a flag não muda nada; em um host com APT::Install-Recommends "false" é justamente ela que mantém a codificação funcionando.

Durante a instalação, o pacote agora:

• cria o papel e o banco de dados agora;
• gera a senha do banco e a do administrador e escreve ambas em /etc/agora/secrets.env (modo 0600, dono root);
• inicia o agora.service, que na primeira execução aplica o esquema do banco de dados.

As senhas não são impressas no terminal: elas são lidas do arquivo. Reinstalar e atualizar o pacote reaproveitam os segredos já escritos em vez de gerá-los de novo.

Entrar no painel¶

Leia a senha do administrador:

grep EDIT_AUTH_PASSWORD /etc/agora/secrets.env

Abra http://<endereço-do-servidor>/ em um navegador e entre como admin com essa senha.

Você cai no painel. Vá até Streams: uma instalação recém-feita ainda não tem nenhum.

Criar a primeira transmissão¶

Digite o nome townhall e aperte Criar. A transmissão abre na aba Fontes, onde ainda não há nada configurado.

Já existe uma linha de fonte vazia. Escolha nela o protocolo Synthetic — o gerador embutido, que permite verificar a reprodução antes de conectar um estúdio real ao servidor. Marque as duas caixas — Gerar vídeo (barras SMPTE) e Gerar áudio (beep/bop): os valores preenchidos sozinhos (1280×720 a 25 fps, 48 kHz estéreo) são exatamente os necessários. Aperte Salvar.

Alguns segundos depois aparece acima do formulário um cartão com os parâmetros da entrada: o servidor pegou o sinal e o analisou.

Ligar o transcodificador¶

O gerador entrega vídeo e áudio sem compressão, que nenhum player entende, então a transmissão precisa ser codificada. Vá até a aba Transcodificador e aperte o preset Escada padrão 1080/720/360 + AAC: ele configura três resoluções de uma vez, do jeito que uma transmissão real precisa — o notebook do escritório pega a de cima, o celular por VPN a de baixo. Aperte Salvar.

Assistir à transmissão¶

Volte para a aba Configurações básicas. Assim que o servidor tiver montado os primeiros segmentos, o player embutido mostra a imagem do gerador, e acima dele, o que chegou na entrada e o que saiu na saída.

Uma máquina funciona. Em seguida:

• Administradores — crie contas reais em vez da de emergência.
• Transmissões — conecte uma fonte real em vez do gerador.
• Cluster — acrescente um segundo servidor quando um deixar de bastar.