Configuración y archivos de seguimiento

4D v20 R7

backup.4DSettings

Las preferencias de backup están disponibles como un archivo XML llamado backup.4DSettings. 4D utiliza los datos de este archivo para configurar las opciones de backup (opciones que se encuentran en la caja de diálogo de Propiedades de la base) en el momento del lanzamiento de cada backup (manualmente, automáticamente, o utilizando el comando BACKUP). Este archivo también puede utilizarse para leer o asignar opciones adicionales, tales como la cantidad de información almacenada en el historial de backup, a través de llaves XML específicas. Las llaves XML se describen en el manual 4D Llaves XML Backup.

backup.4DSettings se crea de forma predeterminada en la carpeta "Settings" de la base de datos.

Nota de compatibilidad: el archivo predeterminado backup.4DSettings se denomina backup.xml y se encuentra en la carpeta Preferencias en las versiones 4D anteriores a 4D v18. El archivo se renombra automáticamente y se mueve cuando la base de datos se convierte a 4D v18 o superior.

Se pueden usar dos tipos de archivos de configuración de backup:

un archivo de configuración de copia de seguridad predeterminado (configuración estructura), utilizado para la base actual.
un archivo de copia de seguridad de usuario asociado con el archivo de datos. Puede definir un archivo de configuración de copia de seguridad del usuario para cada archivo de datos. Esta característica está diseñada para permitirle configurar copias de seguridad personalizadas para cada cliente/sitio de producción.

Utilizar un archivo de configuración de backup usuario

Se define un archivo de configuración de copia de seguridad de usuario para un archivo de datos cuando:

la opción de seguridad "Autorizar las propiedades usuario en un archivo externo" está marcada (ver Utilizar las propiedades usuario)
el archivo de datos no se encuentra en la misma carpeta que el archivo de estructura
existe una carpeta llamada Settings y que contiene un archivo "backup.4DSettings" en el mismo nivel que el archivo de datos (vea a continuación cómo crear este archivo).

En esta configuración, 4D carga y utiliza el contenido del archivo "backup.4DSettings" ubicado en la carpeta de datos, en lugar del archivo "backup.4DSettings" en la carpeta de la base. Este archivo se utiliza para copias de seguridad así como también para las Propiedades Usuario en la caja de diálogo del archivo de datos.
Si no se respeta una de las condiciones anteriores, 4D utiliza el archivo predeterminado "backup.4DSettings" en la carpeta Settings de la base.

Los archivos de configuración de backup y el archivo de configuración de backup predeterminado pueden existir al mismo tiempo y se utilizan según el contexto. Puede obtener la ubicación de cada archivo con el comando:

la ruta del archivo de configuración de backup por defecto es devuelta por Get 4D file(Backup settings file).
una ruta de archivo de configuración de backup usuario es devuelta por Get 4D file(Backup settings file for data).
la ruta del archivo de configuración de backup utilizada actualmente es devuelta por Get 4D file(Current backup settings file)

Puede suceder que necesite editar el archivo de configuración de backup predeterminado (configuración de la estructura), mientras se utiliza un archivo de configuración de backup para los datos usuario. En este caso, se utilizará para el archivo de datos actual, pero se guardará en el archivo "backup.4DSettings" de la base y se utilizará por defecto para todo nuevo archivo de datos. Se muestra un mensaje de advertencia en el cuadro de diálogo Propiedades:

Crear un archivo de configuración de backup

Para crear un archivo de configuración de copia de seguridad usuario para el archivo de datos actual:

Asegúrese de que el modo "Propiedades usuario" esté activo (ver )
Seleccione la opción Configuración usuario para el archivo de datos... en el menú Configuración Diseño/base de datos o llame a OPEN SETTINGS WINDOW con los User settings for data en el parámetro settingsType.
Defina las opciones de copia de seguridad apropiadas en la ventana de configuración, luego haga clic en Aceptar.

4D crea automáticamente el archivo "backup.4DSettings" en una carpeta Settings al mismo nivel que el archivo de datos actual.

backupHistory.json

Toda la información sobre las últimas operaciones de copia de seguridad y restauración se almacena en el archivo backupHistory.json de la base. Este último registra la ruta de cada archivo de backup (incluye adjuntos) así como también el número, la fecha, la hora, la duración y el estado de cada operación. Para limitar el tamaño del archivo, el número de operaciones registradas y el número de copias de seguridad disponibles son iguales ("Conservar solo los últimos X archivos de copia de seguridad") a los definidos en la configuración de la copia de seguridad.

El archivo backupHistory.json se crea en la carpeta de destino de backup actual. Puede obtener la ruta actual para este archivo utilizando:

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

Atención: eliminar o mover el archivo backupHistory.json, restablecerá el siguiente número de copia de seguridad.

Nota: el archivo backupHistory.json está formateado para ser utilizado por la aplicación 4D. Si está buscando un informe legible por humanos sobre las operaciones de copia de seguridad, es posible que el historial de copia de seguridad sea más preciso (ver a continuación).

Diario de backup

Para facilitar el seguimiento y la verificación de las copias de seguridad de su base, el módulo de backup escribe un resumen de cada operación realizada en un archivo especial, el cual es similar a un diario de actividades. Como un manual, todas las operaciones de la base (backups, restauraciones, integraciones de historial) se registran en este archivo sin importar si las operaciones fueron programadas o realizadas manualmente. La fecha y la hora en que ocurrieron estas operaciones también se anotan en el diario.

El diario de backup se llama “Backup Journal.txt” y se ubica en la carpeta "Logs" de la base.

El diario de backup puede abrirse con cualquier editor de texto. Para facilitar su análisis, la información en el diario está separada por tabulaciones y cada línea de información termina con un retorno de carro.

Gestión del tamaño del historial de backup

En ciertas estrategias de backup (por ejemplo, en el caso de backups a varios archivos adjuntos), el tamaño del diario de backup puede crecer rápidamente.
Dos mecanismos permiten controlar el tamaño:

Backup automático: antes de cada backup, la aplicación examina el tamaño del archivo de diario de backup actual. Si es mayor a 10 MB, el archivo actual se archiva y se crea un nuevo archivo. Los archivos guardados se llaman “Diario de Backup[xxx].txt”, donde xxx es un número de 1 a 999. Una vez se alcanza el número de archivo 999, se comienza nuevamente con el número y se reemplazan los archivos existentes.
Reducir la cantidad de información almacenada: para hacerlo, simplemente modifique el valor de la llave VerboseMode en el archivo backup.4DSettings. Por defecto, esta llave tiene el valor True. Si cambia el valor de esta llave por False, sólo la información principal se guardará en el diario de backup: fecha y hora de inicio de la operación y los errores encontrados. Las llaves XML relacionadas con la configuración del backup se describen en el manual 4D Llaves XML Backup.

Journal_YYYYMMDD_hhmmss_x.json

Este archivo se genera automáticamente tan pronto como la integración de un archivo de registro es ejecutada por 4D con el modo de reparación automática. Contiene la lista de los errores no críticos que han sido reparados, si los hay. Para más información, consulte el párrafo Restauración automática.

El archivo siempre se genera después de una integración automática de un archivo de registro en modo de auto-reparación, independientemente de que se hayan tratado errores no críticos o no. También puede utilizarse para detectar si se produjo una integración automática, por ejemplo utilizando el siguiente código al inicio:

 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)

  // Envía una alerta por correo para la integración automática del diario sin ningún error.

  //...

    Else

  // Envía una alerta por correo para la integración automática del registro describiendo los errores.

  //...

    End if

  // Move log file to archives

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

 End if