Atualização¶

Atualizar o Catena é atualizar pacotes; a configuração, os segredos e o banco sobrevivem sem participação do operador.

Uma máquina¶

apt update && apt install catena

O pacote catena atualiza o servidor de streaming exatamente para a sua versão. O serviço em execução não é tocado — o processo continua rodando no binário anterior, e um reinício manual o passa para o novo:

systemctl restart catena

Vale saber:

• O momento da interrupção é você quem escolhe: os canais da máquina são interrompidos só durante o reinício do processo — a partida a quente os levanta logo depois. Reinicie numa janela conveniente para a transmissão.
• Os segredos não são rotacionados: /etc/catena/secrets.env sobrevive a qualquer atualização, as senhas não mudam.
• O central aplica o esquema do banco sozinho na partida — não há passo de migração à parte.

Nos streamers, o pacote catena-streamer atualiza do mesmo jeito; o reinício é o mesmo comando.

O cluster¶

Atualize as máquinas uma de cada vez. É seguro por construção:

• o protocolo de troca cresce só por adição — os lados ignoram campos desconhecidos, e central e streamers de versões vizinhas trabalham juntos;
• o esquema do banco é compatível numa janela de duas versões atrás — código N−1 e N−2 roda contra um esquema mais novo.

Fique dentro dessa janela: não deixe a dispersão de versões dentro do cluster passar de duas. Não há ordem obrigatória «primeiro o central, depois os streamers» — as garantias são simétricas; na prática convém começar pelo central, para o console mostrar logo as capacidades da versão nova.

Rollback¶

Esquema de banco mais novo sob código mais velho é a norma: voltar o binário uma ou duas versões não exige voltar o banco. Instale a versão anterior do pacote — e pronto. O próprio banco só volta junto com uma restauração do dump, e isso já não é rollback de versão, é recuperação de avaria.