Edit

Backup

Uma cópia de segurança pode ser iniciada de três maneiras:

• Manualmente, utilizando o comando Cópia de segurança... do menu 4D Arquivo ou o botão Cópia de segurança de Centro de manutenção e segurança.
• Automaticamente, usando o agendamento que pode ser estabelecido em Configurações
• Por programação, utilizando o comando BACKUP.

4D Server: é possível iniciar uma cópia de segurança manualmente desde uma máquina remota mediante um método que chama ao comando BACKUP. O comando será executado, em todos os casos, no servidor.

Cópia de segurança manual

1. O estado da última cópia de segurança (correta ou com erro) é armazenada na área de informação da página de cópias de segurança em CSM ou na página de manutenção de 4D Server. Também se registra no banco de dados Backup journal.txt.

• Também pode abrir o Centro de manutenção e segurança de 4D e mostrar a página de cópias de segurança.

O botão Propriedades de Banco de Dados... faz com que seja exibida a página Backup/Configuration das Configurações de Estrutura.

2. Clique em Backup/Cópia de segurança para iniciar a cópia de segurança utilizando os parâmetros atuais.

Backup automático periódico

As cópias de segurança programadas são iniciadas automaticamente. São configurados na página Backup/Scheduler na página Configurações.

As cópias de segurança são feitas automaticamente na hora definida nessa página sem nenhum tipo de intervenção do usuário. Para saber mais sobre o uso desta caixa de diálogo, consulte Definir as cópias de segurança periódicas.

Comando BACKUP

Quando o comando BACKUP da linguagem 4D for executado desde um método, a cópia de segurança se inicia utilizando os parâmetros atuais definidos nas propriedades. Pode utilizar os métodos On Backup Startup e On Backup Shutdown para controlar o processo de cópia de segurança (consulte o manual Linguagem, de 4D).

Gerenciar o processo de backup

Quando iniciar o backup, 4D exibe uma caixa de diálogo com um termômetro indicando o progresso da cópia de segurança:

Esse termômetro também é mostrado na página Backup de CSM se utilizou esta caixa de diálogo.

O botão Parar permite ao usuário interromper a cópia de segurança em qualquer momento (consulte Manejar os problemas da cópia de segurança mais adiante).

O estado da última cópia de segurança (correta ou com erro) é armazenada na área de informação da página de cópias de segurança em CSM ou na página de manutenção de 4D Server. Também se registra no banco de dados Backup journal.txt.

Acesso da aplicação durante o backup

Durante a cópia de segurança, acesso à aplicação é restrito por 4D dependendo do contexto. 4D bloqueia os processos relacionados com os tipos de arquivos incluídos na cópia de segurança: se só fizer uma cópia de segurança dos arquivos do projeto, não se poderá acessar à estrutura mas sim aos dados.

Pelo contrário, se só fizer uma cópia de segurança do arquivo de dados, o acesso à estrutura continua sendo permitido. Nesse caso, as possibilidades de acesso à aplicação são as seguintes:

• Com a versão 4D monousuário, a aplicação é trancada tanto para leitura quanto escrita, todos os processos são congelados. Nenhuma ação é realizada.
• Com 4D Server, a aplicação está bloqueada só para escrita; as máquinas clientes podem ver os dados. Se uma máquina cliente enviar uma petição de adição, eliminação ou mudança ao servidor, uma janela aparece pedindo ao usuário que espere até o final da cópia de segurança. Quando a aplicação for salva, a janela desaparece a ação é realizada. Quando o banco de dados for salvo, a janela desaparece a ação é ralizada Para cancelar a petição em processo e não esperar a que finalize a cópia de segurança, basta dar um clique no botão Cancelar a operação. Entretanto, se a ação que espera ser executada vem de um método lançado antes da cópia de segurança, não deve cancelar a ação porque só são canceladas as operações restantes. Além disso, um método parcialmente executado pode causar inconsistências lógicas nos dados. > Quando a ação que espera ser executada vir de um método e o usuário clicar no botão Cancelar operação, 4D Server devolve o erro -9976 (Este comando não pode ser executardo porque a copia de segurança está em progresso).

Gestão dos problemas das cópias de segurança

Pode acontecer que uma cópia de segurança não seja executada corretamente. Pode haver várias causas de falha na cópia de segurança: interrupção do usuário, arquivo adjunto não encontrado, problemas no disco de destino, transação incompleta, etc. 4D processa a incidência segundo a causa.

Em todos os casos, lembre que o estado da última copia de segurança (correta ou com falha) se armazena na área de informação da página de cópias de segurança em CSM ou na página de manutenção de 4D Server, assim como Backup journal.txt.

• Interrupção de Usuário: The Botão Parar na caixa de diálogo de progresso permite aos usuários interromper o processo de cópia de segurança a qualquer momento. Nesse caso, a cópia de elementos para e é gerado o erro 1406. Pode interceptar esse erro no método database On Backup Shutdown.
• Arquivo anexo não encontrado: quando não encontrar um arquivo anexo, 4D realiza uma cópia de segurança parcial (cópia de segurança dos arquivos da aplicação e dos arquivos adjuntos acessíveis e devolve um erro.
• Copia de segurança impossível (disco cheio ou protegido contra escrita, disco ausente, falha no disco, transação incompleta, aplicação não lançada no momento da cópia de segurança automática programada, etc.): se for um primeiro erro, 4D fará uma segunda tentativa de realizar a cópia de segurança. A espera entre duas tentativas é definida na página Backup/Backup e Restauração das Propriedades. Se a segunda tentativa falhar, um diálogo de alerta de sistema é exibido e um erro é gerado. Pode interceptar esse erro no método database On Backup Shutdown.

Histórico de cópias de segurança (Backup Journal)

Para facilitar o seguimento e a verificação das cópias de segurança, o módulo de cópia de segurança escreve um resumo de cada operação realizada em um arquivo especial, que é similar a um diário de atividades. Da mesma forma que no manual de bordo, todas as operações (backups, restaurações, integrações de histórico) são escritas nesse arquivo, não importa se a operação foi programada ou manual. A data e hora em que essas operações acontecem também é anotada no histórico.

O histórico de cópia de segurança é chamado "Backup Journal[001].txt" e está localizado na pasta "Logs" do projeto. O histórico de cópias de segurança pode ser aberto com o editor de texto.

Gerenciamento do tamanho de histórico de cópias de segurança.

Em determinadas estratégias de copia de segurança (por exemplo, no caso de que se realizem copias de segurança de numerosos arquivos anexos), o histórico de cópias de segurança pode alcançar rapidamente um grande tamanho. Dois mecanismos podem ser usados para controlar este tamanho:

• Copia de segurança automática: antes de cada copia de segurança, a aplicação examina o tamanho do arquivo historial de cópia de segurança atual. Se for superior a 10 MB, se arquiva o arquivo atual e é criado um arquivo com o número [xxx] incrementado, por exemplo "Backup Journal[002].txt”. Quando o arquivo número 999 for alcançado, a numeração volta para 1 e os arquivos existentes começam a ser substituídos.
• Possibilidade de reduzir a quantidade de informação registrada: para isso, basta com modificar o valor da chave VerboseMode no arquivo Backup.4DSettings do projeto. Como padrão, essa chave é definida como True. Se mudar o valor desta chave a False, só se armazenará no diário de copias de segurança a informação principal: data e hora de inicio da operação e os erros encontrados. As chaves XML relativas a configuração da cópia de segurança são descritos no manual Backup das chaves XML 4D.

backupHistory.json

Toda a informação relativa às últimas operações de cópia de segurança e restauração se armazena no arquivo backupHistory.json da aplicação. Registra a rota de cada arquivo guardado (incluídos os anexos), assim como o número, a data, a hora, a duração e o estado de cada operação. Para limitar o tamanho do arquivo, o número de operações registradas é o mesmo que o número de backups disponíveis ("Keep only the last X backup files") definido nas configurações de backup.

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

$backupHistory:=Get 4D file(arquivo histórico Backup)

AVISO
Apagar ou mover o arquivo backupHistory.json faz com que o próximo número de backup seja resetado. O arquivo backupHistory.json é formatado para ser usado pela aplicação 4D. Se estiver procurando por um relatório que possa ser lido por olhos humanos, o diário de Backup journal é mais preciso.