Para utilizar la utilidad DSTrace en un entorno de Linux, ejecute el siguiente comando desde el indicador del servidor:
/opt/novell/eDirectory/bin/ndstrace
La sintaxis completa del comando ndstrace es la siguiente:
ndstrace [-l|-u|-c "command1;......"|--version] [-h <local_interface:port>] [--config-file <configuration_file_path>] [thrd <thread ID>] [svty <severity_level>] [conn <connection_ID>]
La utilidad DSTrace tiene tres partes principales:
Las funciones básicas de DSTrace son:
Ver la actividad interna y los mensajes de depuración de eDirectory en Linux.
Iniciar procesos de sincronización limitada.
Puede utilizar la utilidad DSTrace en modo de interfaz de usuario o de línea de comandos. Por defecto, DSTrace se ejecuta en modo de interfaz de usuario. Para iniciar DSTrace en modo de interfaz de usuario, escriba el comando siguiente en el indicador del servidor:
/opt/novell/eDirectory/bin/ndstrace
Para iniciar DSTrace en modo de línea de comandos, escriba el comando siguiente en el indicador:
/opt/novell/eDirectory/bin/ndstrace -l
Para iniciar las funciones básicas de DSTrace, escriba los comandos en el indicador del servidor usando la sintaxis siguiente:
ndstrace command_option
En la tabla siguiente se recogen las opciones de comando que se pueden introducir.
|
Opción |
Descripción |
|---|---|
|
ACTIVO |
Inicia la pantalla de seguimiento de eDirectory con mensajes de seguimiento básicos. |
|
INACTIVO |
Inhabilita la pantalla de seguimiento. |
|
ALL |
Inicia la pantalla de seguimiento de eDirectory y muestra todos los mensajes de seguimiento. |
|
AGENT |
Inicia la pantalla de seguimiento de eDirectory con los mensajes de seguimiento equivalentes a los indicadores ON, BACKLINK, DSAGENT, JANITOR, RESNAME y VCLIENT. |
|
DEBUG |
Activa un conjunto predefinido de mensajes de seguimiento utilizados habitualmente para la depuración. Los indicadores definidos son ON, BACKLINK, ERRORS, EMU, FRAGGER, INIT, INSPECTOR, JANITOR, LIMBER, MISC, PART, RECMAN, REPAIR, SCHEMA, SKULKER, STREAMS y VCLIENT. |
|
NODEBUG (SIN DEPURAR) |
Deja la pantalla de seguimiento habilitada, pero desactiva todos los mensajes de depuración previamente definidos. Esta opción también deja los mensajes definidos con la opción de comando ON. |
Cuando está habilitada la pantalla DSTrace, la información mostrada se basa en un conjunto de filtros por defecto. Si desea ver más o menos información de la establecida por defecto, puede manipular los filtros utilizando los indicadores de mensajes de depuración. Los mensajes de depuración le ayudan a determinar el estado de eDirectory y a comprobar que todo funciona bien.
Cada proceso de eDirectory tiene un conjunto de mensajes de depuración. Para ver los mensajes de depuración de un proceso determinado, utilice un signo más (+) y la opción o el nombre del proceso. Para inhabilitar la visualización de un proceso, utilice un signo menos (-) y la opción o el nombre del proceso. A continuación encontrará algunos ejemplos:
|
Mensaje |
Descripción |
|---|---|
|
set ndstrace = +SYNC |
Habilita los mensajes de sincronización. |
|
set ndstrace = -SYNC |
Inhabilita los mensajes de sincronización. |
|
set ndstrace = +SCHEMA |
Habilita los mensajes de esquema. |
También puede combinar los indicadores de mensajes de depuración mediante los operadores booleanos & (AND) y | (OR). La sintaxis para controlar los mensajes de depuración en la consola del servidor es la siguiente:
set ndstrace = <trace_flag> [parameter]
En la tabla siguiente se describen los indicadores de seguimiento para los mensajes de depuración. Puede introducir abreviaturas para cada uno de los indicadores de seguimiento.
|
Indicador de seguimiento |
Descripción |
|---|---|
|
ABUF |
Mensajes e información relacionados con los buffers de paquetes entrantes y salientes que contienen datos que se reciben con una petición de eDirectory, o bien como respuesta a esta última. |
|
ALOC |
Mensajes que muestran los detalles de asignación de memoria. |
|
AREQ |
Mensajes relacionados con peticiones entrantes de otros servidores o clientes. |
|
AUTH |
Mensajes e informes de errores relacionados con la autenticación. |
|
BASE |
Mensajes de error de depuración al nivel mínimo de depuración. |
|
BLNK |
Informes de errores y mensajes de obituario entrantes y de enlaces en segundo plano. |
|
CBUF |
Mensajes relacionados con peticiones de cliente DS salientes. |
|
CHNG |
Mensajes de caché de cambios. |
|
COLL |
Informes de errores y estado relacionados con la información de actualización de un objeto cuando la actualización se ha recibido con anterioridad. |
|
CONN |
Mensajes que muestran información sobre los servidores con los que intenta establecer conexión su servidor, y sobre los errores y tiempos límite que podrían ser la causa de que el servidor no se conecte. |
|
DNS |
Mensajes acerca de los procesos del servidor DNS integrado en eDirectory. |
|
DRLK |
Mensajes de enlace de referencia distribuida. |
|
DVRS |
Mensajes que muestran las áreas específicas del controlador DirXML® en las que eDirectory podría estar trabajando. |
|
DXML |
Mensajes que muestran los detalles de los sucesos de DirXML. |
|
FRAG |
Mensajes del fragmentador NCP™ que divide los mensajes de eDirectory en mensajes de tamaño NCP. |
|
IN |
Mensajes relacionados con los procesos y las peticiones entrantes. |
|
INIT |
Mensajes relacionados con la inicialización de eDirectory. |
|
INSP |
Mensajes relacionados con la integridad de los objetos de la base de datos local del servidor de origen. La utilización de este indicador supone un aumento en el uso de los recursos de la memoria, el procesador y el sistema de almacenamiento en disco del servidor de origen. No deje este indicador habilitado, a menos que los objetos estén dañados. |
|
JNTR |
Mensajes relacionados con los procesos en segundo plano siguientes: janitor, sincronización de réplica y limpiador. |
|
LDAP |
Mensajes relacionados con el servidor LDAP. |
|
LMBR |
Mensajes relacionados con el proceso limber. |
|
LOCK |
Mensajes relacionados con el uso y la manipulación de bloqueos de la base de datos local del servidor de origen. |
|
LOST |
Mensajes relacionados con entradas perdidas. |
|
MISC |
Mensajes de diferentes orígenes de eDirectory. |
|
MOVE |
Mensajes de las operaciones de movimiento de partición o subárbol. |
|
NCPE |
Mensajes que muestran el servidor que recibe las peticiones de nivel de NCP. |
|
NMON |
Mensajes relacionados con iMonitor. |
|
OBIT |
Mensajes del proceso de obituario. |
|
PART |
Mensajes relacionados con las operaciones de partición de los procesos en segundo plano y del procesamiento de peticiones. |
|
PURG |
Mensajes sobre el proceso de limpieza. |
|
RECM |
Mensajes relacionados con la manipulación de la base de datos del servidor de origen. |
|
RSLV |
Informes relacionados con el procesamiento de peticiones de resolución de nombres. |
|
SADV |
Mensajes relacionados con el registro de nombres y particiones del árbol con el protocolo de localización de servicios (SLP). |
|
SCMA |
Mensajes relacionados con el proceso de sincronización de esquema. |
|
SCMD |
Mensajes que muestran los detalles de las operaciones relacionadas con el esquema. Ofrecen información sobre la sincronización entrante y saliente. |
|
SKLK |
Mensajes relacionados con el proceso de sincronización de réplica. |
|
SPKT |
Mensajes relacionados con la información de nivel de servidor NCP de eDirectory. |
|
STRM |
Mensajes relacionados con el procesamiento de atributos con una sintaxis de flujo. |
|
SYDL |
Mensajes que muestran más información durante el proceso de réplica. |
|
SYNC |
Mensajes acerca del tráfico de sincronización entrante (lo que recibe el servidor). |
|
TAGS |
Muestra la cadena de la etiqueta que identifica la opción de seguimiento que generó el evento en cada línea mostrada por el proceso de seguimiento. |
|
THRD |
Mensajes que muestran el inicio y la finalización de los procesos (hilos) en segundo plano. |
|
HORA |
Mensajes acerca de los vectores transitivos utilizados durante el proceso de sincronización. |
|
TVEC |
Mensajes relacionados con los siguientes atributos: Sincronizada hasta, Réplica hasta y Vector transitivo. |
|
VCLN |
Mensajes relacionados con el establecimiento o la supresión de conexiones con otros servidores. |
Cuando utilice los mensajes de depuración en DSTrace, verá que algunos de los indicadores de seguimiento son más útiles que otros. Uno de los valores favoritos de DSTrace para el servicio de asistencia de NetIQ es en realidad un acceso directo:
set ndstrace = A81164B91
Este valor habilita un grupo de mensajes de depuración.
Además de los mensajes de depuración, que le ayudan a comprobar el estado de eDirectory, hay un conjunto de comandos que obligan a los procesos en segundo plano de eDirectory a ejecutarse. Para forzar la ejecución del proceso en segundo plano, coloque un asterisco (*) delante del comando. Por ejemplo:
set ndstrace = *H
También puede cambiar el estado, la periodicidad y el control de algunos de los procesos en segundo plano. Para cambiar estos valores, coloque un signo de exclamación (!) antes del comando y escriba un parámetro o valor nuevos. Por ejemplo:
set ndstrace = !H 15 (parameter_value_in_minutes)
A continuación se especifica la sintaxis de las diferentes declaraciones que controlan los procesos en segundo plano de eDirectory:
set ndstrace = <trace_flag> [parameter]
En la tabla siguiente se muestran los indicadores de seguimiento para los procesos en segundo plano, los parámetros obligatorios y el proceso al que hacen referencia.
|
Indicador de seguimiento |
Parámetros |
Descripción |
|---|---|---|
|
*Un archivo |
Ninguna |
Restaura la caché de direcciones del servidor de origen. |
|
*AD |
Ninguna |
Inhabilita la caché de direcciones del servidor de origen. |
|
*AE |
Ninguna |
Habilita la caché de direcciones del servidor de origen. |
|
*B |
Ninguna |
Programa el proceso de enlace de segundo plano para iniciar la ejecución en el servidor de origen transcurrido un segundo. |
|
!B |
Hora |
Define el intervalo (en minutos) del proceso de enlace en segundo plano. Valor por defecto = 1500 minutos (25 horas), Rango = de 2 a 10080 minutos (168 horas) |
|
*CT |
Ninguna |
Muestra la tabla de conexiones salientes del servidor de origen y las estadísticas de esta. Estas estadísticas no proporcionan información sobre las conexiones entrantes de otros servidores o clientes al servidor de origen. |
|
*CTD |
Ninguna |
Muestra, en formato delimitado por comas, la tabla de conexiones salientes del servidor de origen y las estadísticas de esta. Estas estadísticas no proporcionan información sobre las conexiones entrantes de otros servidores o clientes al servidor de origen. |
|
*D |
ID de réplica rootEntry |
Quita el ID de entrada local especificado de la lista Enviar todos los objetos del servidor de origen. El ID de entrada debe especificar un objeto Raíz de la partición específico de la base de datos local del servidor. Este comando suele utilizarse únicamente cuando un proceso de actualización de Enviar todo intenta mostrar actualizaciones constantemente y falla porque el servidor es inaccesible. |
|
!D |
Hora |
Define el intervalo de sincronización entrante y saliente en el número de minutos especificado. Valor por defecto = 24 minutos. Rango = de 2 a 10080 minutos (168 horas) |
|
!DI |
Hora |
Define el intervalo de sincronización entrante en el número de minutos especificado. Valor por defecto = 24 minutos Rango = de 2 a 10080 minutos (168 horas) |
|
!DO |
Hora |
Define el intervalo de sincronización saliente en el número de minutos especificado. Valor por defecto = 24 minutos Rango = de 2 a 10080 minutos (168 horas) |
|
*E |
Ninguna |
Vuelve a inicializar la caché de bloques lógicos del servidor de origen. |
|
!E |
Ninguna |
Programa los procesos de sincronización entrante y saliente para iniciar la ejecución. |
|
!EI |
Ninguna |
Programa el proceso de sincronización entrante para iniciar la ejecución. |
|
!EO |
Ninguna |
Programa el proceso de sincronización saliente para iniciar la ejecución. |
|
*F |
Ninguna |
Programa el proceso del limpiador, que forma parte del proceso janitor, para iniciar la ejecución en el servidor de origen transcurridos cinco segundos. |
|
!F |
Hora |
Define el intervalo (en minutos) del proceso del limpiador. Valor por defecto = 240 minutos (4 horas), Rango = de 2 a 10080 minutos (168 horas) |
|
*FL |
1-10 |
Define el número de archivos de registro sobre la marcha que utiliza DSTrace. Si define este parámetro en un valor mayor que 1, una vez que el archivo ndstrace.log del servidor de origen alcance el tamaño de archivo máximo configurado, DSTrace renombra el archivo ndstrace1.log y crea un archivo ndstrace.log nuevo. Cuando dicho archivo alcance su tamaño máximo de archivo, el archivo ndstrace1.log anterior se renombra como ndstrace2.log y el archivo ndstrace.log más reciente se renombra como ndstrace1.log. Este proceso continúa hasta que DSTrace alcanza el número máximo de archivos de registro sobre la marcha definido en esta opción. Una vez que se alcance el límite especificado, los archivos de registro más antiguos se suprimen y se conserva únicamente el número máximo especificado de archivos sobre la marcha. Puede configurar un máximo de 10 archivos de registro sobre la marcha. Por defecto, DSTrace debe utilizar al menos un archivo de registro sobre la marcha. Si define este parámetro en 0, DSTrace usa 1 como valor del parámetro. |
|
*G |
ID de réplica rootEntry |
Reconstruye el caché de cambios de la ID de la partición raíz especificada. |
|
*H |
Ninguna |
Programa el proceso de sincronización de réplicas para iniciar la ejecución inmediatamente en el servidor de origen. |
|
!H |
Hora |
Define el intervalo (en minutos) del proceso de sincronización de pulsación. Valor por defecto = 30 minutos Rango = de 2 a 1440 minutos (24 horas) |
|
*HR |
Ninguna |
Borra el último vector enviado de la memoria. |
|
*I |
ID de réplica rootEntry |
Añade el ID de entrada local especificado a la lista Enviar todos los objetos del servidor de origen. El ID de entrada debe especificar un objeto Raíz de la partición específico de la base de datos local del servidor. El proceso de sincronización de réplicas verifica la lista Enviar todos los objetos. Si el ID de entrada del objeto Raíz de una partición figura en la lista, eDirectory sincroniza todos los objetos y atributos de dicha partición, independientemente del valor del atributo Valores hasta los cuales se sincroniza la réplica. |
|
!I |
Hora |
Define el intervalo (en minutos) del proceso de sincronización de pulsación. Valor por defecto = 30 minutos Rango = de 2 a 1440 minutos (24 horas) |
|
*J |
Ninguna |
Programa el proceso de limpieza, que forma parte del proceso de sincronización de réplicas, para iniciar la ejecución en el servidor de origen. |
|
!J |
Hora |
Define el intervalo (en minutos) del proceso janitor. Valor por defecto = 2 minutos Rango = de 1 a 10080 minutos (168 horas) |
|
*L |
Ninguna |
Programa el proceso limber para iniciar la ejecución en el servidor de origen transcurridos cinco segundos. |
|
*M |
Bytes |
Cambia el tamaño máximo de archivo que utiliza el archivo ndstrace.log del servidor de origen. El comando puede utilizarse independientemente del estado del archivo de depuración. El valor especificado en bytes debe ser un decimal entre 10 000 bytes y 100 MB. Si resulta ser superior o inferior a dicho rango, no se producirá ningún cambio. |
|
!M |
Ninguna |
Informa sobre la cantidad de memoria máxima que ha utilizado eDirectory. |
|
!N |
0|1 |
Define el formato del nombre. 0 = solo hexadecimal 1 = formato de puntos completo |
|
*P |
Ninguna |
Muestra los parámetros ajustables y sus valores por defecto. |
|
*R |
Ninguna |
Restaura el tamaño del archivo ndstrace.log a cero bytes. Este comando es el mismo que el parámetro SET de longitud del archivo de seguimiento de NDS ajustado en cero. |
|
*S |
Ninguna |
Programa el proceso skulker, que comprueba si es necesario sincronizar alguna de las réplicas del servidor. |
|
!SI |
Hora |
Define el intervalo (en minutos) del proceso de sincronización entrante de esquemas. Valor por defecto = 24 minutos Rango = de 2 a 10080 minutos (168 horas) |
|
!SO |
Hora |
Define el intervalo (en minutos) del proceso de sincronización saliente de esquemas. Valor por defecto = 24 minutos Rango = de 2 a 10080 minutos (168 horas) |
|
!SIO |
Hora |
Inhabilita el proceso de sincronización entrante de esquemas en función del número de minutos especificado. Valor por defecto = 24 minutos Rango = de 2 a 10080 minutos (168 horas) |
|
!SO0 |
Hora |
Inhabilita el proceso de sincronización entrante de esquemas en función del número de minutos especificado. Valor por defecto = 24 minutos Rango = de 2 a 10080 minutos (168 horas) |
|
*SS |
Ninguna |
Fuerza la sincronización inmediata del esquema. |
|
*SSA |
Ninguna |
Programa el proceso de sincronización de esquemas para iniciar la operación inmediatamente, y fuerza la sincronización de esquemas con todos los servidores de destino, aunque se hayan sincronizado durante las últimas 24 horas. |
|
*SSD |
Ninguna |
Restaura la lista de sincronización del esquema de destino del servidor de origen. En ella se identifican los servidores con los que debe sincronizarse el servidor de origen durante el proceso de sincronización de esquemas. Un servidor que no retenga réplicas envía una petición de inclusión en la lista de destino de un servidor que contiene una réplica con el objeto Servidor correspondiente. |
|
*SSL |
Ninguna |
Imprime la lista de sincronización de esquemas de los servidores de destino. |
|
*ST |
Ninguna |
Muestra la información de estado de los procesos en segundo plano del servidor de origen. |
|
*STX |
Ninguna |
Muestra la información de estado de los procesos de enlace de segundo plano (referencias externas) del servidor de origen. |
|
*STS |
Ninguna |
Muestra la información de estado de los procesos de sincronización de esquemas del servidor de origen. |
|
*STO |
Ninguna |
Muestra la información de estado de los procesos de enlace de segundo plano (obituarios) del servidor de origen. |
|
*STL |
Ninguna |
Muestra la información de estado del proceso limber del servidor de origen. |
|
!T |
Hora |
Define el intervalo (en minutos) para verificar el estado activo del servidor. Valor por defecto = 30 minutos Rango = de 1 a 720 minutos (12 horas) |
|
*U |
ID opcional del servidor |
Si el comando no incluye ningún ID de entrada, cambia el estado de todos los servidores que previamente hayan pasado de down (inactivo) a up (activo). Si el comando incluye un ID de entrada local, cambia el estado del servidor especificado de down (inactivo) a up (activo). Los ID de entrada son exclusivos de la base de datos del servidor de origen y deben referirse a un objeto que represente un servidor. |
|
!V |
Una lista |
Enumera las versiones restringidas de eDirectory. Si no se enumera ninguna, significa que no existen restricciones. Cada una de las versiones se separa por una coma. |
|
*Z |
Ninguna |
Muestra las tareas programadas. |