Configuração e arquivos de seguimento

4D v20 R7

Backup.xml

As preferências de backup de 4D estão disponíveis como un arquivo XML associado ao banco de dados. 4D utiliza os dados deste arquivo para configurar as opções de backup (opções que se encontram na caixa de diálogo de Preferências) no momento do início de cada backup (manualmente, automaticamente ou usando o comando BACKUP)) . Este arquivo também pode ser utilizado para ler ou assinar opções adicionais, tais como a quantidade de informação armazenada no diário de backup, através de chaves XML específicas. As chaves XML são descritas no manual 4D Chaves XML Backup. .

backup.4DSettings é criado de forma pré-determinada na pasta "Settings" do banco de dados.

Nota de compatibilidade: o arquivo predeterminado backup.4DSettings se denomina backup.xml e se encontra na pasta Preferências nas versões 4D anteriores a 4D v18. O arquivo se renomeia automaticamente e se move quando o banco de dados for convertido a 4D v18 ou superior.

Podem ser usados dois tipos de arquivos de configuração de backup:

um arquivo de configuração de cópia de segurança predeterminado (configuração estrutura), utilizado para o banco de dados atual.
um arquivo de cópia de segurança de usuário associado com o arquivo de dados. Pode definir um arquivo de configuração de cópia de segurança de usuário para cada arquivo de dados. Esta característica foi criada para permitir que configure cópias de segurança personalizadas para cada cliente/local de produção.

Using a user backup settings file

Se define um arquivo de configuração de cópia de segurança de usuário para um arquivo de dados quando:

a opção de segurança "Autorizar as propriedades usuário em um arquivo externo" está marcada (ver Usando preferências de usuário)
o arquivo de dados não se encontra na mesma pasta que o arquivo de estrutura
existe uma pasta chamada Settings e que contém um arquivo "backup.4DSettings" no mesmo nível que o arquivo de dados (veja abaixo como criar este arquivo).

Nesta configuração, 4D carrega e utiliza o conteúdo de arquivo "backup.4DSettings" localizado na pasta de dados, ao invés do arquivo "backup.4DSettings" na pasta do banco de dados. Este arquivo se utiliza para cópias de segurança assim como para as Propriedades Usuário na caixa de diálogo de arquivo de dados.
Se não respeitar uma das condições anteriores, 4D usa o arquivo pré-determinado "backup.4DSettings" na pasta Settings do banco de dados.

Os arquivos de configuração de backup e o arquivo de configuração de backup pré-determinado possam existir ao mesmo tempo e sãe utilizados segundo o contexto. Pode obter a localização de cada arquivo com o comando:

a rota de arquivo de configuração de backup padrão é devolvida por Get 4D file(Backup settings file).
uma rota de arquivo de configuração de backup usuário é devolvida por Get 4D file(Backup settings file for data).
a rota de arquivo de configuração de backup utilizado atualmente é devolvida por Get 4D file(Current backup settings file)

Pode acontecer que precise editar o arquivo de configuração de backup pré-determinado (configuração da estrutura), enquanto usar um arquivo de configuração de backup para os dados usuário. Neste caso se usará para o arquivo de dados atual, mas se salvará no arquivo "backup.4DSettings" do banco de dados e se utilizará normalmente para todo novo arquivo de dados. Se mostra uma mensagem de advertência no quadro de diálogo Propriedades:

Criar um usuário de configurações de backup

Para criar um arquivo de configurações de backup para o arquivo de dados atual:

Tenha certeza que "User setting mode" esteja ativado (ver )
Selecione a opção User Settings for Data file... no menu Design/Database Settings ou chamar OPEN SETTINGS WINDOW com User settings for data no parâmetro settingsType.
Estabeleça opções de backup apropriadas na janela de configurações, depois clique OK.

4D cria automaticamente o arquivo "backup.4DSettings" em uma pasta Settings no mesmo nível que o arquivo atual de dados.

backupHistory.json

Toda informação sobre as últimas operações de backup e restauração são armazenadas no arquivo backupHistory.json do banco de dados. Armazena o histórico de cada arquivo salvo (incluindo anexos) assim como número, data, hora, duração e estado de cada operação. Para limitar o tamanho do arquivo, o número de operações no histórico é o mesmo que o número de backups disponíveis ("Mantenha apenas os últimos X arquivos de backup") definidos nas configurações de backup.

O arquivo backupHistory.json é criado na pasta atual de backup destino. Pode obter a rota para o arquivo usando a declaração:

$backupHistory:=Get 4D file(Backup history file)

Aviso: Apagar ou mover o arquivo backupHistory.json causa que o número do próximo backup seja resetado

Nota: O arquivo backupHistory.json é formatado para ser usado pela aplicação 4D. Se quiser um relatório para ser lido imediatamente por humanos sobre as operações de backup, o Backup journal pode ser mais adequado (ver abaixo).

Diário de backup

Para facilitar o seguimento e a verificação das cópias de segurança de seu banco de dados, o módulo de backup escreve em resumo de cada operação realizada em um arquivo especial, que é similar a um diário de atividades. Como um manual, todas as operações do banco de dados (backups, restaurações, integrações de histórico) são registradas neste arquivo sem importar se as operações foram programadas ou realizadas manualmente. A data e a hora em que ocorreram estas operações também são anotada no diário.

O diário de backup se chama “Backup Journal.txt” e se localiza na pasta "Logs" do banco de dados.

O diário de backup pode ser aberto com qualquer editor de texto. Para facilitar sua análise, a informação no diário é separada por tabulações e cada linha de informação termina com uma quebra de linha.

Gerenciamento do tamanho do diário de backup

Em certas estratégias de backup (por exemplo, no caso de backups de vários arquivos anexos), o tamanho do diário de backup pode crescer rapidamente.
Dois mecanismos permitem controlar o tamanho:

Backup automático: antes de cada backup, o aplicativo examina o tamanho do arquivo de diário de backup atual. Se for maior que 10 MB, o arquivo atual é arquivado e se cria um novo arquivo. Os arquivos salvos se chamam “DiariodeBackup[xxx].txt”, onde xxx é um número de 1 a 999. Uma vez alcançado o número de arquivo 999, começa-se novamente com o número 1 e os arquivos existentes são substituídos.
Reduzir a quantidade de informação armazenada: para fazê-lo, simplesmente modifique o valor da chave VerboseMode no arquivo Backup.xml do banco de dados. Por padrão, esta chave tem o valor True. Se você alterar o valor desta chave para False, somente a informação principal será salva no diário de backup: data e hora de início da operação e os erros encontrados. As chaves XML relacionadas com a configuração do backup são descritas no manual 4D Chaves XML Backup.

Journal_YYYYMMDD_hhmmss_x.json

Este arquivo é gerado logo que uma integração de arquivo log com modo de reparação automática for realizada por 4D. Contém a lista de erros não críticos que foram reparados, se houver. Para saber mais, veja Restituição automática .

O arquivo é sempre gerado depois de uma integração de arquivo de log automática em modo autoreparo, tenham os erros sido manejados ou não. Também pode ser u sado para detectar se uma integração automática aconteceu, por exemplo usando o código abaixo no startup:

 var $logFile : 4D.File

 var $fileContent : 4D.Object

 $logFile:=File(Last journal integration log file)

 If($logFile#Null)

    $fileContent:=JSON Parse($logFile.getText())

    If($fileContent.operations.length=0)

  // Enviar mail alertando para integração automática de journal sem erros.

  //...

    Else

  // Enviar email alertando para integração automática de journal descrevendo problemas.

  //...

    End if

  // Mover arquivo log file para arquivos

    $logFile.moveTo($logFile.parent.folder("Archives"))

 End if