Backup¶

A configuração do Agora — streams com as suas fontes, ajustes do transcodificador, envios, modelos, zonas de entrega, política de acesso, ajustes dos streamers — vive na base de dados do plano de controle. A seção Cluster → Backup baixa-a como arquivo e envia-a de volta.

O backup é necessário em dois casos:

• o equipamento foi perdido — o servidor, um disco ou a base de dados já não existem, e a configuração tem de subir numa máquina nova sem digitar outra vez cem streams;
• reversão — uma alteração infeliz desfaz-se mais facilmente com um backup feito antes dela do que lembrando como estava tudo.

Só um superadministrador vê a seção: o arquivo do backup leva os segredos da instalação.

O que o backup contém¶

• Streams — com todos os seus ajustes: fontes, transcodificador, envios, arquivo.
• Modelos e zonas CDN.
• Política de acesso — como a reprodução é protegida.
• Ajustes do central e políticas de gravação.
• Ajustes dos streamers — o que se edita na ficha do streamer: discos de arquivo e o resto.
• Catálogo VOD — as descrições dos ativos e em que discos de que streamers estão os seus arquivos. Os arquivos de mídia não entram no backup: ficam nos discos.

O backup não contém:

• A composição do cluster — que máquinas entraram e com que chaves. A chave de um streamer é emitida quando a máquina entra e fica guardada no próprio streamer; um backup com as chaves antigas seria inútil depois de uma reinstalação.
• Os administradores. Uma lista de administradores restaurada trancaria do lado de fora quem faz a restauração.
• O histórico — o registo de auditoria, as sessões de espectadores, as estatísticas.
• A mídia — o arquivo e os arquivos VOD.

O arquivo do backup contém segredos: chaves DRM e senhas nos endereços de fontes e envios. Guarde-o com o mesmo cuidado que o próprio servidor: não o envie por e-mail nem o deixe em pastas partilhadas.

Como fazer um backup¶

1. Abra Cluster → Backup e clique em Criar backup.
2. O backup é preparado em segundo plano. Enquanto isso, a sua linha na lista Backups mostra em andamento. Não é preciso ficar na página: o backup pronto pode ser recolhido mais tarde.
3. Quando o status passar a pronto, clique em Baixar. O arquivo chama-se agora-config-<data>-<número>.jsonl.gz.

O backup não fica num diretório do disco, e sim na base de dados do plano de controle, junto com a configuração — por isso qualquer instância do central pode servir o download. Numa instalação com Docker é o volume da base de dados PostgreSQL. Ali os backups ficam 30 dias e depois são excluídos.

A consequência principal: um backup no equipamento morre junto com a base de dados. Num desastre só sobrevive o arquivo baixado — tire-o do equipamento.

Faça um backup antes de uma alteração notável: antes de mover streams, mudar a política de acesso ou editar modelos em bloco.

Como restaurar¶

A restauração tem três passos: enviar o arquivo, rever o plano, confirmar. Antes da confirmação a configuração não muda.

1. No bloco Restaurações clique em Enviar arquivo e escolha o arquivo do backup.
2. O equipamento lê o arquivo e constrói um plano: o que exatamente vai mudar. A linha da restauração passa a aguarda confirmação. Clique nela para abrir o plano.
3. Reveja o plano e clique em Restaurar.

Como ler o plano¶

O plano é uma tabela por seções do backup:

• Criar — não existe no equipamento; vai aparecer.
• Sobrescrever — existe, mas é diferente; a versão do backup substitui a do equipamento.
• Excluir — existe no equipamento, mas não no backup. A restauração devolve a configuração ao momento do backup, por isso os streams criados depois do backup serão excluídos. Os seus nomes aparecem sob a linha da seção; leia-os antes de confirmar.
• Sem mudanças — coincide com o backup.
• Aguarda um streamer — ajustes de um streamer que ainda não tem máquina (veja Streamer adiado).

O catálogo VOD é restaurado só por acréscimo: os ativos que não estão no backup ficam onde estão. Excluir um ativo apaga os seus arquivos dos discos, e uma reversão não deve fazer isso.

Se o plano tiver erros — por exemplo, o backup contém mais streams do que a licença do equipamento novo permite —, o botão Restaurar fica bloqueado até a causa ser corrigida.

Se alguém mudar a configuração entre o momento em que o plano foi mostrado e a confirmação, o equipamento recalcula o plano e pede para confirmá-lo outra vez: só se aplica o plano que você viu.

A restauração deixa rasto no registo de auditoria: uma entrada config_restore.apply e entradas para cada stream, modelo e zona alterados com o número da restauração.

Um cluster de vários streamers¶

Num único equipamento isso é toda a restauração. Num cluster sobra outra pergunta: que máquina recebe os ajustes de que streamer.

Por que os streamers não voltam sozinhos ao seu lugar¶

Cada streamer do cluster tem um número, que o equipamento lhe dá quando a máquina entra. Os ajustes do streamer estão ligados a esse número. Um equipamento novo com a base de dados limpa volta a dar os números pela ordem em que as máquinas entram: a que era o streamer n.º 3 pode passar a n.º 2, e o n.º 3 cabe a outra máquina. Restaurar os ajustes por número entregaria os discos de arquivo de uma máquina a outra.

Por isso o backup guarda os ajustes de cada streamer junto com os sinais da sua máquina: a sua identidade (o identificador do servidor, o mesmo que a licença vê) e o seu nome de host. Ao restaurar, o plano procura uma máquina para eles:

• o streamer local do equipamento recebe os seus ajustes automaticamente;
• a mesma máquina — um streamer que entrou no cluster novo com a mesma identidade é reconhecido automaticamente, seja qual for o número que recebeu;
• o resto é decisão sua: escolhe um streamer no plano ou deixa a decisão para depois.

O nome de host sozinho não leva a uma associação: máquinas instaladas a partir da mesma imagem costumam partilhá-lo. No plano ele é uma pista para você.

Exemplo¶

Um equipamento e dois streamers, edge-1 e edge-2, levam quatro câmaras com arquivo. O backup é feito no cluster em funcionamento:

Depois o equipamento perde-se junto com a sua base de dados. O edge-1 sobrevive, o edge-2 perde-se, e prepara-se uma máquina nova, edge-3, para o substituir.

Enquanto não há equipamento, os streamers continuam a levar os streams que tinham: guardam a última configuração recebida e só deixam de receber alterações.

Ordem da restauração¶

1. Instale um equipamento novo — o pacote agora, como na primeira instalação (veja Instalação). Entre com as credenciais estáticas de /etc/agora/secrets.env e crie o primeiro administrador (veja Administradores): os administradores não estão no backup.
2. Abra a janela de entrada: Cluster → Streamers → Permitir adesão (veja Entrada de um servidor).

3. Traga de volta os streamers sobreviventes. O equipamento novo não conhece a chave emitida pelo perdido, e a máquina não entra sozinha: no registo do streamer isso aparece como node key rejected. Em cada streamer sobrevivente escreva o token novo na linha JOIN_TOKEN= de /etc/agora/secrets.env (e o endereço do equipamento em CENTRAL_URL=, se mudou), apague a chave antiga e reinicie o serviço:

   rm /var/lib/agora/identity.json
   systemctl restart agora
   

   Apague só o arquivo da chave. Não mexa no resto de /var/lib/agora: ali fica também a identidade da máquina, pela qual o plano a reconhece e à qual a licença está ligada. Enquanto reinicia, os streams desta máquina são interrompidos.

4. Instale as máquinas de substituição — o pacote agora-base com o mesmo token, como em qualquer ampliação do cluster (veja Instalação).

5. Verifique a composição em Cluster → Streamers. As máquinas têm números novos: o edge-1 entrou em segundo lugar e recebeu o n.º 2. Os streamers ainda não têm ajustes — nem discos de arquivo nem endereços, daí a marca de endereço em falta: o backup devolve-os.

   

6. Envie o backup e abra o plano. O bloco Streamers mostra para onde vão os ajustes de cada streamer do backup: o local para o local, o edge-1 reconhecido como a mesma máquina e o edge-2 sem máquina, por isso a escolha é sua.

   

7. Escolha uma máquina para o streamer não reconhecido. A lista contém os streamers livres do cluster novo. A marca mesma máquina aparece junto ao candidato com a mesma identidade; o edge-3 não a tem, é outra máquina, e escolhê-lo é decisão sua. Se a máquina de substituição ainda não estiver pronta, deixe Depois.

   

8. Clique em Restaurar. A configuração é aplicada, e o equipamento aloca os streams nos streamers como depois de qualquer outra alteração.

Streamer adiado¶

Os ajustes adiados ficam guardados na ficha da restauração junto com as alocações dos arquivos VOD nos discos dessa máquina. Enquanto não são aplicados, o cluster não tem nenhuma máquina com esses ajustes: os streams com arquivo são alocados nos streamers que já têm discos. No exemplo as quatro câmaras vão para o edge-1.

Quando a máquina de substituição entrar no cluster, abra a ficha da restauração, escolha-a no bloco Streamers aguardando seus ajustes e clique em Aplicar ao streamer.

O streamer recebe os ajustes do backup — discos de arquivo e o resto —, e o equipamento pode voltar a alocar trabalho nele. Uma máquina de substituição mantém os seus próprios endereços: o backup só leva os endereços para a mesma máquina; caso contrário o central continuaria a chamar a perdida. Se o streamer aparecer sem endereço, escreva-o na sua ficha.

Os ajustes adiados só são aplicados por um operador, com o botão. Uma máquina que entra no cluster não toma sozinha os ajustes de outra: a entrada de uma máquina não deve mudar a configuração sem uma pessoa.

Reversão num cluster em funcionamento¶

Se o equipamento estiver intacto e o backup for necessário para desfazer uma alteração infeliz, os passos de reinstalação não são necessários: os streamers ficam no cluster com os seus números e identidade, e o plano associa-os automaticamente. Envie o backup, leia o que diz a coluna Excluir e confirme.