Cómo resolver el error de copia de seguridad automática de configuración en Fortinet: variable ‘%%log.time%%’ no funciona

En este artículo, abordaremos un problema que afecta a los dispositivos FortiGate, específicamente relacionado con la falla en la realización de copias de seguridad de configuraciones cuando el nombre de host o el nombre del archivo de respaldo incluyen la variable ‘%%log.time%%’. Este tema es crucial ya que la correcta gestión de las configuraciones es esencial para la estabilidad y continuidad de servicios en cualquier red. A través de este artículo, proporcionaremos una guía paso a paso para diagnosticar y resolver esta situación de manera efectiva.

Descripción del problema

Este artículo describe un problema en el que FortiGate no puede realizar copias de seguridad de la configuración cuando el nombre de host o el nombre del archivo de respaldo incluye la variable ‘%%log.time%%’. Esto es relevante porque la inclusión de marcas de tiempo en los nombres de archivo es una práctica común para mantener un seguimiento adecuado de los respaldos realizados.

Alcance

Este problema se ha identificado en las versiones de FortiGate v7.4.4 y v7.4.5.

Diagnóstico paso a paso

Cuando se utiliza un script de automatización para realizar copias de seguridad de configuraciones con la variable ‘%%log.time%%’, que está destinada a incluir una marca de tiempo en el nombre del archivo, la copia de seguridad falla debido a caracteres especiales no soportados:

execute backup full-config usb MV-FW-Z3-fullconfig-USB-daily-%%log.time%%.txt<—– Usando log.time.

__cli_script_close()-121: cli script:
autod.16
output:
########## script name: autod.16, offset: 389##########
========= 1, 2024-10-29 08:19:36 ==========
FortiGate-60F execute backup full-config usb MV-FW-Z3-fullconfig-USB-daily-08:19:29.txt <—– Tiempo analizado correctamente.
Please wait...

Copy config MV-FW-Z3-fullconfig-USB-daily-08:19:29.txt to USB disk ...
Copy config file to USB disk failed. <—– Fallo en la copia.
Command fail. Return code 1

Sin embargo, la copia de seguridad de la configuración se realiza con éxito utilizando la variable ‘%%log.date%%’:

execute backup full-config usb MV-FW-Z3-fullconfig-USB-daily-%%log.date%%.txt<—– Usando solo log.date.

pid:225-__handle_msg()-414: Subscriber:4 received package. pubid:0 pkgid:178 pkg_index:191
pid:225-__handle_pkg_logs()-356: Subscriber:4 processing package size:948 logs:2 pickup:2
pid:225-__subscr_close_cur_pkg()-140: close package size:948 logs:2
__cli_script_close()-121: cli script:
autod.15
output:
########## script name: autod.15, offset: 361##########
========= 1, 2024-10-29 08:19:31 ==========
FortiGate-60F execute backup full-config usb MV-FW-Z3-fullconfig-USB-daily-2024-10-29.txt <—– Fecha analizada correctamente.
Please wait...

Copy config MV-FW-Z3-fullconfig-USB-daily-2024-10-29.txt to USB disk ...
Copy config file to USB disk OK. <—– Escrito correctamente en USB, y también es visible en la unidad USB.

Desde la versión v7.6.1, se ha introducido la variable ‘%%log.eventtime%%’ en lugar de ‘%%log.time%%’, permitiendo la inclusión de la marca de tiempo de Unix en el nombre del archivo sin usar caracteres especiales no soportados.

Solución recomendada

Para evitar estos problemas, se recomienda no usar la variable ‘%%log.time%%’ en nombres de archivo para las copias de seguridad de configuración. En su lugar, use ‘%%log.date%%’ o, si es posible, actualice a una versión más reciente que soporte ‘%%log.eventtime%%’.

La configuración correcta para la copia de seguridad sería:

execute backup full-config usb MV-FW-Z3-fullconfig-USB-daily-%%log.date%%.txt<—– Usando log.date.

Comandos CLI utilizados

1. diagnose debug application autod -1 – Este comando permite habilitar el depurador de la aplicación específica para capturar información durante el fallo.
2. diagnose debug console timestamp enable – Activa la marca de tiempo para los mensajes de la consola, útil para rastrear la secuencia de eventos.
3. diagnose debug enable – Habilita el depurador en general.
4. diagnose debug reset – Resetea el estado del depurador después de la prueba.
5. execute tac report – Genera un informe que puede ser útil para el soporte técnico.

Buenas prácticas y recomendaciones

Al trabajar con archivos de configuración y respaldos en dispositivos FortiGate, es recomendable seguir estas buenas prácticas:

• No utilice caracteres especiales en los nombres de archivo.
• Mantenga un registro de las versiones de firmware y utilice variables compatibles.
• Realice pruebas periódicas de los backups para asegurar su integridad.

Notas adicionales

Recuerde consultar la documentación oficial de Fortinet para actualizaciones sobre variables disponibles y mejores prácticas en la gestión de configuraciones.