Backups

Fotografias online da configuração, uma exportação que leva as senhas guardadas para outra máquina, uma restauração agendada para a próxima partida em vez de aplicada ao vivo, e a reconstrução do índice de histórico de execuções.

Backups é a única linha do grupo DADOS na página Configurações. O cartão tira uma cópia da configuração da estação enquanto tudo continua rodando, escreve o arquivo único que leva também as senhas guardadas para outra máquina, lista tudo o que ele guarda, agenda uma dessas cópias para substituir a configuração na próxima partida, e reconstrói o índice de execuções gravadas quando aquela lista parece errada. Ele abre com "Guarde um retrato da configuração do aplicativo (dispositivos, tags, lógica, dashboards, ajustes e as imagens, ícones e símbolos da sua biblioteca) para poder voltar atrás. As execuções gravadas e o histórico delas ficam em separado e nunca são afetados por um backup ou por uma restauração." A página exige a permissão Alterar configurações.

O que um backup contém

Um backup é uma cópia online do banco de configuração, tirada com o mecanismo de backup do SQLite, então ele é coerente mesmo enquanto o aplicativo escreve (com o log de escrita antecipada incluído). Ele guarda tudo o que aquele banco guarda: os dispositivos e as tags dos drivers, o espaço de endereços da Logic (as variáveis com os valores retentivos delas, as ações, os gatilhos, os alarmes), os dashboards, os modelos, as unidades, os procedimentos, as receitas, as avaliações e os modelos de documento do Process, os usuários e os papéis locais, a configuração do servidor OPC UA, e as configurações desta página. Ao lado do arquivo do banco, a estação copia a pasta de recursos do usuário (as imagens, os ícones e os símbolos da sua biblioteca) para uma pasta irmã, para que uma restauração traga as figuras de volta também, e uma nota opcional vai para um arquivo lateral.

Os arquivos moram na pasta backups da raiz de dados da estação: config-20260902-141500.db (com um sufixo -2 se aquele segundo já tiver um), config-20260902-141500.assets e config-20260902-141500.db.note.json. Uma exportação é um arquivo único ao lado deles, config-export-20260902-141500.glabconfig.

Um backup nunca contém as execuções gravadas e os arquivos delas, o índice de histórico de execuções, o diário durável de eventos, o marcador de falha, os arquivos de log, a posição e o zoom da janela, o armazenamento de token da conta, ou os repositórios de certificados do servidor OPC UA. As credenciais dentro do banco (segredos de dispositivo, a senha do servidor OPC UA) são guardadas como texto cifrado preso ao usuário e à máquina Windows que as digitou: um backup aberto em outro lugar restaura a configuração inteira mas lê cada uma delas como não configurada, a ser digitada de novo. A exportação logo abaixo é o arquivo único que as leva junto.

Criar um backup

Criar um backup é trabalho de engenharia somente leitura: ele roda enquanto uma unidade roda e nunca se sobrepõe a uma mudança de configuração. Enquanto o runtime está parado esta página não é desenhada (veja Configurações), então nenhum comando de backup pode ser alcançado até o runtime voltar. Uma estação cujo banco de configuração ainda não existe é recusada com "O banco de configuração ainda não existe."

Exportação para outra máquina

Sob os botões de backup, um segundo bloco com título próprio, Exportação para outra máquina, abre com a razão de ele existir: "Um backup deixa as senhas guardadas para trás: as senhas de dispositivo e a senha do servidor OPC UA só abrem nesta conta do Windows, nesta máquina. Uma exportação é um arquivo único que leva as senhas junto, selado com uma senha que você escolhe aqui, para que uma máquina nova assuma a estação inteira. Guarde essa senha em lugar seguro: ela é a única coisa que abre o arquivo, e não há como recuperá-la por aqui."

O campo de nota lá de cima é o mesmo: ele viaja dentro da exportação também, e aparece sob a linha dela.

A exportação é um arquivo compactado que carrega uma cópia coerente do banco de configuração, os recursos do usuário ao lado dele e um cabeçalho. Cada coluna que a configuração protege é lida pelo cofre desta máquina na saída e selada de novo sob a senha da exportação; o cabeçalho carrega o sal, o fator de trabalho e uma constante selada com a chave derivada, o que basta para distinguir uma senha certa de uma errada e nada mais. Quais colunas viajam é lido da própria configuração, então uma credencial acrescentada depois viaja sem ninguém precisar lembrar de uma lista. Escrever uma exportação é trabalho de engenharia somente leitura, igual a um backup, então ela roda enquanto uma unidade roda; e fica no diário, porque uma cópia de cada credencial que a estação guarda acabou de sair do cofre.

Uma exportação é restaurada pela lista abaixo, com o Restaurar da linha dela. Isso pergunta "Restaurar a partir de uma exportação": "'…' carrega a configuração da máquina em que foi escrito e as senhas guardadas com ela. Digite a senha com que ele foi escrito: as senhas vão para o cofre desta máquina, e a configuração substitui a atual quando você reiniciar o aplicativo. A configuração atual é salva automaticamente antes, e as execuções gravadas não são afetadas.", com um campo Senha da exportação e sua caixa Mostrar a senha; o Restaurar continua recusado enquanto ele estiver vazio ("Digite a senha com que esta exportação foi escrita."). Uma senha errada não escreve nada e deixa o diálogo aberto, com a razão dita na barra de status, para que a próxima tentativa esteja ali mesmo: "Essa senha não abre esta exportação. É a senha escolhida na máquina onde a exportação foi escrita, e não há como recuperá-la aqui." Uma senha certa abre a exportação num backup comum desta máquina, põe as credenciais que ela carregava no cofre desta máquina, agenda esse backup para a próxima partida e relata "'…' foi aberto e as senhas dele foram guardadas nesta máquina. A configuração é restaurada no próximo reinício."; daí em diante é a restauração comum descrita abaixo, e o backup que fica na lista é o registro do que chegou, então a mesma restauração pode ser repetida depois sem a exportação nem a senha dela. O arquivo da exportação nunca é modificado, então ele ainda abre numa terceira máquina.

Nenhuma das duas metades é do agente: não existe ferramenta de exportação, nem jeito de restaurar uma exportação pela página Agente, porque a senha é do operador e uma que um agente inventasse ou recebesse ficaria numa transcrição. O backup_list marca uma exportação (portableExport), e o backup_restore a recusa nomeando esta página: "'…' é uma exportação de configuração para outra máquina. Ela leva as senhas guardadas seladas com a senha escolhida quando foi escrita, então é restaurada em Configurações, Backups, onde essa senha pode ser digitada."

A lista

Os backups e as exportações dividem uma lista só, do mais recente para o mais antigo, porque a pergunta que eles respondem é a mesma: qual destes eu restauro. Cada linha mostra quando o arquivo foi criado, no formato de data e hora da estação, depois o que ele é (Backup ou Exportação para outra máquina), o nome dele e o tamanho dele, e a nota quando há uma. O tamanho é tudo o que aquele arquivo ocupa, que é tudo o que excluí-lo libera: num backup, a cópia do banco, a nota dela e a fotografia de recursos dela, cujas imagens são a metade maior numa estação que as usa; numa exportação, o arquivo compactado único. A lista é lida quando a página abre e depois acompanha o que a própria estação faz: um backup ou uma exportação feitos aqui ou em outra janela, ou um backup feito por um agente pela página Agente, aparece na lista na hora. Um arquivo posto na pasta backups por fora do aplicativo, copiado à mão por exemplo, não é percebido: ele aparece quando a página é aberta de novo.

Restaurar é recusado, com a razão na barra de status, quando uma gravação está ativa ("Há uma gravação ativa. Pare-a antes de agendar uma restauração de configuração."), quando o arquivo não é um backup de configuração ("'…' não é um backup de configuração do Ganter Lab e não pode ser restaurado."), e quando ele foi escrito por um banco que esta versão não conhece, como o de uma versão mais nova ("'…' não é um backup de configuração que esta versão do Ganter Lab consiga restaurar. Ele pode pertencer a outro banco, ou a uma versão mais nova do aplicativo."). O Excluir recusa o backup que está agendado: "'…' está agendado para ser restaurado. Cancele a restauração pendente primeiro." A retenção é sua: nada aqui exclui backups por conta própria, e um agente pode criar e listar backups mas nunca excluir um.

Restauração agendada

Agendar escreve um marcador na raiz de dados, e o cartão mostra o aviso de atenção Restauração agendada: "'…' será restaurado quando você reiniciar o aplicativo. A configuração atual é salva automaticamente antes.", com um botão Cancelar que remove o marcador e relata "Restauração pendente cancelada.". Nada muda até o aplicativo iniciar de novo. Uma restauração agendada em outra janela, ou por um agente pela página Agente, faz este aviso aparecer numa página que já está aberta, e uma cancelada em outro lugar o tira.

Na partida seguinte, antes de qualquer coisa abrir a configuração, o aplicativo valida o arquivo de novo, fotografa a configuração que está sendo substituída como config-pre-restore-<timestamp>.db com a nota "Fotografia automática tirada antes de restaurar '…'." e a cópia de recursos dela (então uma restauração é ela mesma reversível), troca o arquivo do banco, restaura a fotografia de recursos quando o backup carregava uma, e limpa o marcador. Quando a estação termina de subir, uma notificação diz como foi:

Uma restauração que falhou limpa o marcador, para que as partidas seguintes não fiquem presas. Uma vez trocado o banco, a restauração conta como aplicada mesmo que um passo posterior falhe. Quando o próprio marcador não pode ser removido, a mensagem termina com "O Ganter Lab não conseguiu limpar a restauração agendada, então ela pode rodar de novo no próximo início." O diário guarda a causa de cada um desses casos em inglês, para o suporte.

Configuração restaurada: é preciso revisar

Depois de uma restauração aplicada, o cartão mostra um segundo aviso de atenção, Configuração restaurada: é preciso revisar: "Revise os ajustes restaurados, os Modelos, as Unidades, os Procedimentos, os códigos, os contadores e as filas de impressora de etiqueta; confira os Históricos; reconstrua o índice do histórico de execuções só se a lista de históricos estiver faltando ou inconsistente." Ele fica até você pressionar Dispensar. Uma restauração não faz reconciliação nenhuma por conta própria: os nomes de fila voltam como configuração, mas as impressoras do Windows não são descobertas nem corrigidas, e os contadores são o que o backup guardava.

Reconstruir o índice do histórico de execuções

A revarredura devolve a entrada de índice a um arquivo de execução que estava sem ela (a partir da fotografia congelada da própria execução, ou como uma execução com falha se o aplicativo morreu no meio dela), descarta entradas cujo arquivo sumiu, reconstrói as projeções de produtividade a partir de todo arquivo legível, e pula um .db estranho ou corrompido depois de identificá-lo em modo somente leitura, contando-o como ilegível sem modificá-lo. Ela então atualiza as fotografias de produtividade que a página do Process mostra. Ela nunca toca nas evidências gravadas de um arquivo de execução.

A revarredura também lê de novo os valores dos metadados com que cada execução legível foi iniciada (um número de série, um lote), para que a busca da lista de Históricos encontre a execução por eles. É também o caminho de volta para uma execução gravada antes de o índice guardar esses valores cujo arquivo a passagem única em segundo plano depois da atualização não conseguiu ler: essa execução é encontrada só pelo nome até que uma revarredura a leia.

O que esta seção não faz

Não há backup automático nem agendado, não há política de retenção, não há backup para outro lugar (copie os arquivos da pasta), não há restauração parcial, e não há restauração de histórico de execuções: as execuções gravadas são arquivos próprios sob a raiz de dados, e o índice é reconstruído a partir delas. A exportação também não é um backup para outro lugar: ela é escrita na mesma pasta, e levá-la até a máquina que precisa dela continua sendo com você. Importar e exportar execuções se faz na página Históricos.