Base de conhecimentoOperar
Backups, recuperação e atualizações
O backup noturno no seu servidor e como o verificar, backups incrementais para bases de dados grandes, a reposição, o cartão do estado do sistema, a retenção de dados e as atualizações a partir da interface.
No seu servidor, os backups e as atualizações são da sua responsabilidade — o SyncTide faz quase tudo sozinho e avisa quando algo está mal. Na nossa cloud tratamos de ambos; veja o fim desta página.
O histórico das medições fica no PostgreSQL, não na pasta do SyncTide. Isso tem uma consequência tranquilizadora — desinstalar o SyncTide mantendo os dados deixa a base de dados onde está — e uma perigosa: remover o PostgreSQL remove tudo. Guarde uma cópia dos backups fora do servidor.
O backup noturno
O instalador regista uma tarefa agendada do Windows, SyncTide Backup, todas as noites às 02:00, a correr como SYSTEM para funcionar sem ninguém com sessão iniciada. Executa o backup_platform.ps1 da pasta de instalação e escreve um .zip por noite na pasta backups\ dessa pasta.
- Cada arquivo contém um dump completo da base de dados, mais as definições (
.env, a configuração de execução), os logs, os modelos de relatório, os logótipos dos cabeçalhos PDF e as fotografias das intervenções. Novo na 1.14.8 — em breve - O dump é lido de volta antes de o arquivo ser guardado. Uma execução que não consegue garantir o arquivo para com o motivo; uma execução que não termina com
Created archive:não produziu backup. - São guardados os 7 arquivos mais recentes, e uma execução recusa-se a começar quando o disco não tem espaço para mais um. Novo na 1.14.7 — em breve
A partir da interface
Em Configuração → Tempo de execução → Retenção, o cartão de backups lista os arquivos com a data e o tamanho, descarrega qualquer um deles e faz um no momento (Fazer backup agora). Faça um antes de cada atualização.
Copie um backup para fora do servidor. Um backup no mesmo disco da base de dados protege de enganos, não de uma avaria do disco. Descarregue um arquivo de vez em quando, ou copie a pasta
backups\para outro disco ou para um NAS.
Manualmente
Numa PowerShell elevada, na pasta de instalação (normalmente C:\Program Files\SyncTide):
| Comando | Para quê |
|---|---|
.\backup_platform.ps1 |
Um backup normal: base de dados e definições |
.\backup_platform.ps1 -SupportBundleOnly |
Logs e definições para enviar ao suporte, sem dados |
.\backup_platform.ps1 -SkipDatabase |
Só as definições |
Se a tarefa agendada não existir (uma política de grupo pode bloqueá-la), a instalação termina na mesma; registe-a de novo numa linha de comandos elevada com schtasks, como descrito no BACKUP_AND_RESTORE.md da pasta de instalação, e confirme que aparece um arquivo na manhã seguinte.
Bases de dados grandes: backups incrementais
Novo na 1.14.7 — em breve
A partir de 100 GB, a mesma tarefa noturna passa a fazer backups incrementais (PostgreSQL 17 ou posterior): na primeira noite copia o servidor de base de dados uma vez e, nas noites seguintes, só os blocos que mudaram — dados novos, mas também um valor editado meses antes, um ficheiro de datalogger atrasado ou uma alteração de definições.
- A cada 7 noites, a cadeia é combinada, no disco de backup, numa nova cópia completa, para que a base de dados nunca mais seja lida por inteiro.
- São guardadas as duas cadeias mais recentes: 8 a 14 pontos de reposição noturnos, cada um verificado antes de os mais antigos serem removidos.
- O
.zipnoturno continua a guardar as definições e os ficheiros, e indica o ponto da base de dados a que corresponde.
Só muda de modo quando o PostgreSQL não tem bases de dados de outro software — um backup físico é o servidor PostgreSQL inteiro. Caso contrário, o dump noturno continua, com um aviso no log.
Verificar um backup sem o repor
Não precisa de confiar num backup que nunca abriu. Descomprima um arquivo e liste o conteúdo do dump; nada é alterado:
& "C:\Program Files\PostgreSQL\17\bin\pg_restore.exe" -l synctide.backup | Select-Object -First 20
Uma saída vazia ou um erro significa que o arquivo não serve — mais vale saber hoje do que durante um incidente.
Repor
Um dump noturno. O TimescaleDB precisa de dois passos extra à volta da reposição; saltá-los é a razão habitual para a reposição de um bom backup parecer falhar.
- Pare o SyncTide:
Stop-Service SyncTide* - Descomprima o arquivo e localize o
synctide.backup. - Crie uma base de dados vazia (ou apague a existente — irreversível, confirme que tem o backup que julga ter).
- Reponha com os auxiliares do TimescaleDB à volta:
$bin = "C:\Program Files\PostgreSQL\17\bin"
& "$bin\psql.exe" -U postgres -c "CREATE DATABASE synctide;"
& "$bin\psql.exe" -U postgres -d synctide -c "CREATE EXTENSION IF NOT EXISTS timescaledb;"
& "$bin\psql.exe" -U postgres -d synctide -c "SELECT timescaledb_pre_restore();"
& "$bin\pg_restore.exe" -U postgres -d synctide --no-owner synctide.backup
& "$bin\psql.exe" -U postgres -d synctide -c "SELECT timescaledb_post_restore();"
- Se estiver a reconstruir a máquina, reponha o
.envdo arquivo. DepoisStart-Service SyncTide*, abra a interface e confirme que os valores mais recentes estão lá.
Os avisos sobre chaves estrangeiras circulares em continuous_agg durante o pg_restore são normais no TimescaleDB.
Um ponto de reposição incremental Novo na 1.14.7 — em breve, como administrador no servidor:
cd "C:\Program Files\SyncTide"
.\restore_platform.ps1 -List
.\restore_platform.ps1 -Point "<a pasta do ponto, da lista>"
Reconstrói o ponto e verifica-o, para o SyncTide e o PostgreSQL, guarda à parte a pasta de dados atual como <dados>.pre-restore-<hora>, coloca a reconstruída no seu lugar e arranca tudo de novo — e repõe os dados anteriores se o PostgreSQL não arrancar. Apague a pasta .pre-restore- quando o SyncTide estiver bem. Precisa de espaço livre no disco do PostgreSQL de cerca do tamanho da base de dados, e só repõe na mesma versão principal do PostgreSQL.
O cartão do estado do sistema
O cartão Estado do sistema (no mesmo ecrã) responde a “esta instalação está a funcionar agora?”, atualizado a cada minuto, e nomeia os problemas em vez de os resumir:
| Verificação | O que significa |
|---|---|
| Equipamentos a comunicar | Cada equipamento face ao seu próprio tempo limite de comunicação — um datalogger calado não se esconde atrás dos outros |
| Serviços ativos | Cada serviço de fundo está a correr e continua a trabalhar |
| Último backup | Idade do arquivo mais recente, assinalada quando está em atraso |
| Disco livre | Espaço livre no volume da base de dados e dos backups — partilham-no, por isso enchê-lo para os dois |
O monitor de saúde também avisa quando esse disco está quase cheio: 90% ocupado ou menos de 2 GB livres. Novo na 1.14.7 — em breve
Retenção de dados
A política de retenção, no mesmo ecrã, faz uma limpeza noturna de dados antigos das séries temporais, do histórico de mensagens e dos ficheiros importados, cada um com o seu limite de idade e o seu interruptor; também pode correr uma passagem de imediato para ver o efeito. As previsões sobre falhas de comunicação são guardadas 180 dias por omissão, para que uma falha ainda possa ser preenchida semanas depois.
Defina uma retenção mais longa do que a rotação dos backups. Os dados apagados que nunca ficaram num arquivo guardado perdem-se.
Atualizações
Quando existe uma versão assinada mais recente, os administradores veem um aviso com quatro opções: Instalar, Instalar às 2:00, Relembrar daqui a 3h e Não relembrar. As duas instalações pedem uma segunda confirmação.
- A transferência é verificada com a assinatura das versões do SyncTide antes de qualquer execução.
- É feito um backup, os serviços param, o instalador atualiza no lugar e os serviços voltam a arrancar.
- O progresso e o resultado aparecem em Configuração → Tempo de execução → Atualizações, que também mostra a versão instalada e cancela uma instalação agendada.
Uma versão mais recente do que o fim do período de atualizações da licença não é oferecida. Se for instalada na mesma, a licença é recusada com uma mensagem clara e não se perdem dados: carregue uma licença renovada, ou reinstale uma versão dentro do período.
Sem acesso à internet no servidor, execute o instalador mais recente: ele encontra a instalação e atualiza-a no lugar, sem páginas do assistente.
Na nossa cloud
Todos os dias, a base de dados e os ficheiros de cada instância são guardados com uma verificação de integridade, durante 30 dias, no mesmo fornecedor na UE; a reposição de uma instância isolada está testada. As atualizações são aplicadas por nós — não há nada a instalar, e um reinício pode interromper a interface web durante alguns minutos.