Data Domain: Habilitación del registro de API de DD Boost | Registros de Precert

Summary: En este artículo de la base de conocimientos, se explica cómo habilitar el registro del plug-in de DD Boost cuando se solucionan problemas relacionados con Boost y BoostFS. Esto se denomina registro de precertificados. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Nota: El plug-in de DD Boost no registra actividad detallada de la API de manera predeterminada. Habilitación del registro de precertificados mediante ddboost_precert.ini permite realizar diagnósticos más profundos. La ubicación incorrecta de los archivos, la falta de permisos o la configuración incorrecta pueden impedir la generación de registros.

Razones para habilitar el registro en el nivel de API (precertificado):

  • Las operaciones de DD Boost o BoostFS fallan o se comportan de manera inesperada.
  • El equipo de ingeniería o soporte solicita registros detallados en el nivel de API para su análisis.
  • No se generan registros a pesar de la actividad de aumento esperada.

Notas generales:

  • Solo habilite el registro de certificación previa cuando el equipo de ingeniería o soporte lo soliciten explícitamente.
  • Monitoree de cerca el espacio de disco; Los registros pueden crecer rápidamente.
  • Asegúrese de que los permisos y la ubicación de los archivos sean correctos.
  • Quite el .ini para deshabilitar el registro.
  • BoostFS se debe desmontar y volver a montar para que los cambios surtan efecto.

Ubicaciones de archivos por SO

Sistema operativo ddboost_precert.ini Ubicación ddboost_precert.log Ubicación
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris /ddboost_precert.ini /DDLog/ddboost_precert.log
UNIX /ddboost_precert.ini /DDLog/ddboost_precert.log
Windows C:\ddboost_precert.ini C:\DDLog\ddboost_precert.log

Para versiones de BOOST/BoostFS anteriores a 7.0

Cree un archivo vacío denominado ddboost_precert.ini en el lugar adecuado (véase la tabla anterior). Esto permite el registro en la ruta predeterminada.


Para BOOST/BoostFS versión 7.0 y posteriores

Cree un archivo configurado ddboost_precert.ini Archivo con el siguiente contenido:

precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
  • Esta configuración crea cuatro archivos de registro de 512 MB cada uno (2 GB en total).
  • Ajustar num_log_files y log_file_size según sea necesario.
  • Los registros se pueden redirigir a una ubicación diferente si el espacio en disco es limitado.

Configuración del cliente BOOSTFS para Linux

  1. Crear /DDLog directorio:
    • mkdir /DDLog
      chmod 777 /DDLog
  2. Crear /ddboost_precert.ini con la configuración anterior.

  3. Asegúrese de que BoostFS esté desmontado y vuelto a montar:

    • mount -o log-level=debug <mount_point>

Configuración del cliente Windows BOOSTFS

  1. Crear C:\ddboost_precert.ini con el siguiente contenido:
    • precert_enabled=true
      num_log_files=3
      log_file_size=500
      log_file_name=ddboost_precert.log
      log_file_dir=C:\DDLog
      ddcl_logs_include=true
      ddcl_logs_sev=4
  2. Crear C:\DDLog y asignar permisos completos de lectura/escritura.

  3. Desmontar y volver a montar BoostFS con el registro de depuración habilitado.


Limpieza y deshabilitación del registro

  1. Elimine el archivo ddboost_precert.ini de NetWorker.
  2. Elimine el archivo DDLog directorio y su contenido.
  3. Vuelva a montar BoostFS para aplicar los cambios.
  4. Recopile registros de BoostFS desde /opt/emc/boostfs/log.

Additional Information

Para las versiones de BOOST/BoostFS anteriores a 7.0, los registros de precertificados se habilitan mediante la creación de un archivo vacío denominado exactamente "ddboost_precert.ini" en la ubicación indicada en la siguiente tabla. Si lo hace, la API de SDK de DD Boost habilitará este registro en la ubicación y el nombre de archivo predeterminados, como se muestra en la siguiente tabla: 

Esta herramienta solo se debe habilitar cuando lo soliciten los equipos de ingeniería o soporte y, debido a la cantidad de registros generados, se debe tener cuidado para que este registro se deshabilite lo antes posible.

 

Sistema operativo Ubicación del archivo ddboost_precert.ini Ubicación del archivo ddboost_precert.log
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris /ddboost_precert.ini /DDLog/ddboost_precert.log
UNIX /ddboost_precert.ini /DDLog/ddboost_precert.log
Windows C:\ddboost_precert.ini [1] C:\DDLog\ddboost_precert.log


Para BOOST y BoostFS 7.0 y versiones posteriores, el archivo "ddboost_precert.ini" se debe crear en las mismas ubicaciones que se indicó anteriormente, pero no puede estar vacío, se debe inicializar con el contenido a continuación; de lo contrario, no se crearán los registros

: precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log log_file_dir
=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4


Con la configuración anterior, creará 4 archivos de 512 MB cada uno, por lo que en total solo ocupará 2 GB de espacio en disco.

Si 4 archivos de 512 MB cada uno no cubrieron el período de tiempo que se requiere para la solución de problemas, ajuste la cantidad de archivos y su tamaño utilizando los parámetros "num_log_files" y "log_file_size".

Una vez que se muestra la configuración, los registros se crearán en la misma ubicación que en la tabla, pero existe la opción de crear los registros en una ubicación diferente, en caso de que la partición raíz del sistema operativo no sea lo suficientemente grande.

NOTA: Esta carpeta debe estar presente en la misma ruta que el archivo ddboost_precert.ini (pendiente de confirmación por parte de alguien que sepa más; si esto es cierto, sería imposible escribir el registro en alguna partición que no sea la raíz típicamente pequeña) 


Cuando el archivo .ini está presente (y, en el caso de 7.0 o posterior, tiene el contenido adecuado), se genera un archivo de registro denominado ddboost_precert.log en la carpeta /DDLog (si dicha ruta es la configurada).

El ddboost_precert.log puede crecer muy rápidamente a medida que todas las llamadas de API se registran en el archivo; por lo tanto, preste atención a la cantidad de espacio disponible en la ubicación del cliente para los registros, ya que pueden hacer que la partición se llene y provocar tiempo de inactividad e inconvenientes para el cliente.

Para detener el registro, eliminar el archivo ddboost_precert.ini hará que los registros en el archivo configurado se detengan inmediatamente.
 
Cualquier cambio en el archivo ddboost_precert.ini requerirá que BOOSTFS se desmonte y vuelva a montar para que los cambios surtan efecto.
Para otro software de respaldo que utiliza ddboost, es posible que sea necesario reiniciar los servicios si no se crea ningún archivo de registro para detectar la presencia o ausencia de archivos ddboost_precert.ini
 
[1] El archivo ddboost_precert.ini debe colocarse en la raíz del directorio de instalación.  Se puede denominar: D:\ etc.   Si coloca el archivo en una unidad diferente y no se crea ningún archivo de registro, intente C:\ de todos modos.

=====================================================================================================

Pasos para habilitar los registros de precertificados en el servidor

BoostFS de Linux1. Cree un DDLog de directorio como /DDLog

2. Cree una ddboost_precert.ini de archivo en / ruta con el siguiente contenido
 
precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4

 
3. Guarde el contenido anterior en el archivo ddboost_precert.ini

4. Asegúrese de que el directorio /DDLog tenga permisos de escritura. Proporcione todos los archivos en el directorio /DDLog.

a. cambie los permisos tanto en DDLog como en ddboost_precert.ini
b. ejecute 'sudo chmod 777 DDLog/ ddboost_precert.ini'5

. Recopile los registros de BoostFS de nivel de depuración.

un. Desmonte y vuelva a montar el punto de montaje de BoostFS con la opción "-o log-level=debug"
b. También puede actualizar el nivel de registro en el archivo boostfs.conf dentro del directorio /opt/emc/boostfs/etc. Aún necesitará desmontar y montar la unidad BoostFS.
c. Ejecute la operación de respaldo en el punto de montaje de BoostFS.
d. Proporcione todos los archivos dentro del directorio: /opt/emc/boostfs/log


======================================================================================================

Habilitar registros de precertificados en Windows Boostfs Server

1. Cree ddboost_precert.ini en C:  unidad con el siguiente contenido:

precert_enabled=true
num_log_files=3
log_file_size=500
log_file_name=ddboost_precert.log
log_file_dir=C:\DDLog
ddcl_logs_include=true
ddcl_logs_sev=4

2. Cree una carpeta con el nombre DDLog en la unidad C:. Los archivos de registro de certificados previos se crearán en esta carpeta. Proporcione todos los permisos de lectura/escritura al directorio DDLog para que se puedan crear y agregar archivos de registro.


NOTA:
La configuración anterior creará un máximo de 3 archivos de registro de precertificación de aproximadamente 500 MB cada uno.
Se pueden utilizar diferentes valores para num_log_files y log_file_size según se considere adecuado.  Pero 3 archivos de 500 MB cada uno deberían ser suficientes para el propósito.
Si no es posible liberar 1,5 GB en el sistema cliente, el valor de log_file_size se puede reducir a 200.
Asegúrese de que haya suficiente espacio de disco disponible en el sistema cliente antes de habilitar los registros de precertificados.

3. Desmonte y vuelva a montar el punto de montaje de BoostFS con la opción "-o log-level=debug"


Actividad de limpieza y deshabilitación del registro

de certificación previaUna vez que se recopilen los registros de certificación previa después del problema, deshabilite el registro de certificación previa con los siguientes pasos.  Esto se debe hacer antes de volver a montar la SU de BoostFS.
1. Elimine la carpeta DDLog de C: y su contenido
2. Eliminar ddboost_precert.ini archivo de C:



=====================================================================================================Habilite los registros de precertificados en el servidor Linux con una aplicación de respaldo ddboost.

Procedimiento para habilitar el registro de certificación previa de DDBoost en un servidor ddboost de Linux: 

Cree el directorio /DDLog

2. Otorgue todos los permisos a todos los usuarios para el directorio /DDLog mediante el siguiente comando:

       $ chmod 777 /DDLog

3. Cree archivos/ddboost_precert.ini con el siguiente contenido:

       precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log log_file_dir
=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4

, 4. Los registros de certificación previa se generarán dentro del directorio /DDLog.
=======================================================================================


Habilite los registros de precertificados en el servidor de Windows con una aplicación de respaldo ddboost.  

1. Cree ddboost_precert.ini en C:  unidad con el siguiente contenido:

precert_enabled=true
num_log_files=3
log_file_size=500
log_file_name=ddboost_precert.log
log_file_dir=C:\DDLog
ddcl_logs_include=true
ddcl_logs_sev=4

2. Cree una carpeta con el nombre DDLog en la unidad C:. Los archivos de registro de certificados previos se crearán en esta carpeta. Proporcione todos los permisos de lectura/escritura al directorio DDLog para que se puedan crear y agregar archivos de registro.


NOTA:
La configuración anterior creará un máximo de 3 archivos de registro de precertificación de aproximadamente 500 MB cada uno.
Se pueden utilizar diferentes valores para num_log_files y log_file_size según se considere adecuado.  Pero 3 archivos de 500 MB cada uno deberían ser suficientes para el propósito.
Si no es posible liberar 1,5 GB en el sistema cliente, el valor de log_file_size se puede reducir a 200.
Asegúrese de que haya suficiente espacio de disco disponible en el sistema cliente antes de habilitar los registros de precertificados.
 

Actividad de limpieza y deshabilitación del registro

de certificación previaUna vez que se recopilen los registros de certificación previa después del problema, deshabilite el registro de certificación previa con los siguientes pasos. 
1. Elimine la carpeta DDLog de C: y su contenido
2. Eliminar ddboost_precert.ini archivo de C:

Affected Products

Data Domain

Products

Data Domain
Article Properties
Article Number: 000020437
Article Type: How To
Last Modified: 10 Nov 2025
Version:  7
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.