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. ...
Instructions
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
.inipara 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_filesylog_file_sizesegú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
- Crear
/DDLogdirectorio:mkdir /DDLogchmod 777 /DDLog
-
Crear
/ddboost_precert.inicon la configuración anterior. -
Asegúrese de que BoostFS esté desmontado y vuelto a montar:
mount -o log-level=debug <mount_point>
Configuración del cliente Windows BOOSTFS
- Crear
C:\ddboost_precert.inicon 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
-
-
Crear
C:\DDLogy asignar permisos completos de lectura/escritura. -
Desmontar y volver a montar BoostFS con el registro de depuración habilitado.
Limpieza y deshabilitación del registro
- Elimine el archivo
ddboost_precert.inide NetWorker. - Elimine el archivo
DDLogdirectorio y su contenido. - Vuelva a montar BoostFS para aplicar los cambios.
- 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.
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
=====================================================================================================
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: