Data Domain: habilitación del registro de API de DD Boost: registros de certificación previa
Sammendrag: En este artículo, se explica cómo habilitar el registro del plug-in de Data Domain Boost (DD Boost) cuando se solucionan problemas relacionados con Boost y BoostFS. Esto se denomina registro de precertificados. ...
Instruksjoner
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.
- Extraiga
.iniPara deshabilitar el registro, haga lo siguiente: - 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 y BoostFS anteriores a 7.0
Crear un archivo vacío ddboost_precert.ini en el lugar adecuado (véase la tabla anterior). Esto permite el registro en la ruta predeterminada.
Para BOOST y BoostFS versión 7.0 y posteriores
Cree un archivo configurado ddboost_precert.ini Cree un 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).
- Ajustabilidad
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 /DDLog
chmod 777 /DDLog
- Crear
/ddboost_precert.inicon la configuración anterior.
- Asegurarse de queBoostFS se desmonta y se vuelve 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 registro de depuración habilitado.
Limpieza y deshabilitación del registro
- Elimine el archivo .
ddboost_precert.inifile. - Elimine el archivo .
DDLogdirectorio y su contenido. - Vuelva a montar BoostFS para aplicar los cambios.
- Recopile registros de BoostFS desde
/opt/emc/boostfs/log.
Tilleggsinformasjon
Preguntas frecuentes
Pregunta: ¿Qué es el registro de certificación previa de DD Boost? El registro de certificación previa de DD Boost es una función de registro de diagnóstico que registra las transacciones de la API de DD Boost entre un cliente de DD Boost y el sistema Data Domain.
Respuesta: Se utiliza comúnmente para solucionar problemas de rendimiento, fallas, latencia y problemas de comunicación.
Pregunta: ¿Qué captura el registro de Precert? El registro de certificación previa captura la actividad de la API de DD Boost, incluidas las operaciones de lectura, las operaciones de escritura, la actividad de respaldo, la actividad de restauración, las interacciones de la biblioteca de DD Boost, la información de tiempo de llamadas a la API y los indicadores de latencia del lado del cliente.
Respuesta: Proporciona visibilidad detallada del comportamiento de la API de DD Boost para la solución de problemas y el análisis de rendimiento.
Pregunta: ¿Por qué no se generan registros de precertificados? Verifique que el archivo ddboost_precert.ini exista, que se encuentre en la raíz del sistema operativo, que exista el directorio de registro, que el directorio de registro tenga capacidad de escritura y que se haya iniciado una nueva operación de respaldo o restauración.
Respuesta: La falta de configuración, la ubicación incorrecta, los problemas de permisos o la falta de actividad nueva de DD Boost son las causas más comunes.
Pregunta: ¿Habilitar el registro de precertificados genera registros de inmediato? La configuración solo habilita la funcionalidad de registro.
Respuesta: No, los archivos de registro se generan solo cuando se reciben nuevas solicitudes de la API de DD Boost.
Pregunta: ¿Por qué mi respaldo en ejecución actual no genera registros de precertificados? El registro de certificación previa solo captura la actividad de la API iniciada después de que se detecta la configuración.
Respuesta: Los trabajos de respaldo o restauración existentes continúan sin generar registros de precertificados.
Pregunta: ¿Debo reiniciar mi trabajo de respaldo o restauración? Si el trabajo ya se estaba ejecutando cuando se habilitó el registro, inicie una nueva operación.
Respuesta: Sí, se requiere un nuevo trabajo de respaldo o restauración para generar registros de precertificados.
Pregunta: ¿Cuál es la razón más común por la que el registro de precertificados no funciona? Algunas causas comunes son las siguientes: ddboost_precert.ini no estar en el nivel raíz, ser nombrado accidentalmente ddboost_precert.ini.txt, falta un directorio de registro o permisos insuficientes.
Respuesta: Los problemas de configuración y del sistema de archivos son las causas más frecuentes.
Pregunta: ¿Dónde se debe colocar el archivo ddboost_precert.ini?
Linux: /ddboost_precert.ini. Windows: C:\ddboost_precert.ini.
Respuesta: El archivo debe residir en el directorio raíz del sistema operativo.
Pregunta: ¿Se puede almacenar el archivo ddboost_precert.ini en otra carpeta? El plug-in de DD Boost solo comprueba el directorio raíz del sistema operativo.
Respuesta: No, el archivo se debe almacenar en la raíz.
Pregunta: ¿Cómo puedo verificar que el archivo no sea realmente
ddboost_precert.ini.txt
Abra el explorador de archivos, habilite las extensiones de nombre de archivo y verifique el nombre del archivo.
Respuesta: Asegúrese de que el archivo tenga un nombre
ddboost_precert.ini and not ddboost_precert.ini.txt.
Pregunta: ¿Por qué es el DDLog ¿El directorio está vacío después de habilitar el registro? Entre las posibles causas, se incluyen que no hay actividad nueva de DD Boost, problemas de permisos o un archivo de configuración que no se detectó.
Respuesta: Ejecute un nuevo respaldo, restauración o DDPCONNCHK Prueba para generar actividad.
Pregunta: ¿Qué es DDPCONNCHK ¿Y por qué es útil? DDPCONNCHK es una herramienta de validación de conectividad de DD Boost.
Respuesta: Puede generar actividad de la API de DD Boost y confirmar rápidamente que el registro de precertificados esté funcionando.
Pregunta: ¿Puede DDPCONNCHK ¿Se usará para probar mi configuración? Los ingenieros ejecutan con frecuencia DDPCONNCHK después de habilitar el registro.
Respuesta: Sí, es una forma común de verificar que los registros se generen antes de reproducir un problema.
Pregunta: ¿Por qué crecen tan rápido mis registros de precertificados? El registro de certificación previa registra cada llamada a la API de DD Boost.
Respuesta: Los ambientes de respaldo de gran tamaño pueden generar un volumen de registro significativo en poco tiempo.
Pregunta: ¿Cuánto espacio de disco debo asignar? Una recomendación común es
num_log_files=3 and log_file_size=500.
Respuesta: Esto proporciona aproximadamente 1,5 GB de almacenamiento de registros antes de que se produzca la rotación.
Pregunta: ¿Pueden los registros de precertificación llenar un sistema de archivos? El registro puede consumir mucho espacio en disco si no se monitorea.
Respuesta: Sí, los sistemas de archivos completos pueden provocar fallas de respaldo, cortes de valor e interrupciones del servicio.
Pregunta: ¿Cuál es el propósito de num_log_files? Este parámetro controla la cantidad de archivos de registro rotados que se conservan.
Respuesta: Por ejemplo, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2.
Pregunta: ¿Cuál es el propósito de log_file_size? Este parámetro define el tamaño máximo de cada archivo de registro en MB.
Respuesta: Por ejemplo, log_file_size=500 permite que cada archivo crezca a 500 MB antes de la rotación.
Pregunta: ¿Qué cierva?s ddcl_logs_include=true Lo que se debe hacer: Habilita la información de registro de la biblioteca de clientes de DD Boost dentro de los registros de precertificados.
Respuesta: La configuración recomendada es ddcl_logs_include=true.
Pregunta: ¿Qué hace ddcl_logs_sev=4 mean Este parámetro controla la gravedad del registro.
Respuesta: El nivel de gravedad 4 proporciona información detallada sobre la solución de problemas y la depuración.
Pregunta: ¿Necesito BoostFS ¿Registro de depuración además del registro de certificación previa? No siempre se requiere un registro adicional.
Respuesta: Para BoostFS-specific problemas, habilitar ambos a menudo proporciona una imagen de diagnóstico más completa.
Pregunta: Para BoostFS, ¿tengo que desmontar y volver a montar? Desmontar y volver a montar reinicializa la actividad de BoostFS.
Respuesta: En muchos casos, sí, esto ayuda a iniciar una nueva actividad de DD Boost.
Pregunta: ¿Cuál es la sintaxis correcta del registro de depuración de BoostFS? La sintaxis correcta es -o log-level=debug.
Respuesta: No utilice --o log-level=debug porque un solo guión es válido.
Pregunta: ¿Por qué volver a montar BoostFS repentinamente hacía que aparecieran registros de precertificación? El remontaje crea un nuevo ciclo de inicialización para BoostFS.
Respuesta: El registro comienza cuando se produce una nueva actividad de la API de DD Boost y el plug-in detecta el archivo de configuración.
Pregunta: ¿Reiniciar una aplicación equivale a volver a montar BoostFS? Cualquier acción que cree una nueva actividad de la API de DD Boost puede desencadenar el registro.
Respuesta: Por lo general, sí, algunos ejemplos incluyen reiniciar RMAN, software de respaldo o en ejecución DDPCONNCHK.
Pregunta: ¿Puede RMAN ¿Desea generar registros de certificación previa sin desmontar BoostFS? RMAN puede iniciar nuevas solicitudes de API de DD Boost directamente.
Respuesta: Sí, comenzar de nuevo RMAN operación es normalmente suficiente.
Pregunta: ¿Cómo desactivo el registro de precertificados? Elimine ddboost_precert.ini o cámbiele el nombre a ddboost_precert.ini.disabled.
Respuesta: El registro solo se activa cuando el nombre de archivo exacto ddboost_precert.ini exists()
Pregunta: ¿Es necesario reiniciar el host después de eliminar el archivo ini? El plug-in comprueba el archivo de configuración durante operaciones futuras.
Respuesta: No, no es necesario reiniciar.
Pregunta: ¿Qué permisos se deben usar en Linux? Entre los ejemplos de permisos se incluyen los siguientes:
mkdir /DDLog, chmod 777 /DDLog, and chmod 777 /ddboost_precert.ini.
Respuesta: El proceso de DD Boost debe ser capaz de leer el archivo de configuración y escribir en el directorio de registro.
Pregunta: ¿Dónde se almacenan los registros de BoostFS de manera predeterminada?
Linux: /opt/emc/boostfs/log. Windows: C:\BoostFS\Log.
Respuesta: Estas ubicaciones son independientes de los registros de certificación previa de DD Boost.
Pregunta: ¿Los registros de BoostFS y los registros de certificación previa son lo mismo? Los registros de BoostFS contienen actividad de montaje, operaciones del sistema de archivos y eventos de aplicaciones.
Respuesta: No, los registros de precertificación contienen transacciones de la API de DD Boost, comunicaciones de librerías y datos de tiempo de I/O.
Pregunta: ¿Qué registros debo proporcionar al servicio de soporte? Según el problema, recopile ddboost_precert.log, registros de precertificados rotados, registros de BoostFS, DDPCONNCHK Salida, registros de aplicaciones y paquetes de soporte solicitados.
Respuesta: Proporcionar todos los registros pertinentes ayuda a acelerar la solución de problemas.
Pregunta: ¿Qué debo hacer si aún no se generan registros después de seguir este artículo de la base de conocimientos? Recopile pruebas como la ubicación del ddboost_precert.ini, la lista de directorios de registro, DDPCONNCHK la salida, el comando de montaje de BoostFS y la información de permisos.
Respuesta: Envíe la información recolectada al soporte técnico de Dell para un análisis más detallado.