5.2 Depuración de archivos LDIF

Si tiene problemas con un archivo LDIF, considere lo siguiente:

5.2.1 Habilitación de referencias de avance

En alguna ocasión puede encontrar archivos LDIF en los que un registro para añadir una entrada precede a un registro para añadir a sus padres. Cuando esto ocurre, se genera un error, ya que el padre de la nueva entrada no existe cuando el servidor LDAP intenta añadir la entrada.

Para solucionar este problema, basta con activar el uso de las referencias de avance. Cuando se habilita la creación de referencias de avance y se va a crear una entrada antes de que exista su padre, se crea un espacio reservado, llamado referencia de avance, para el padre de la entrada con el fin de que la entrada se cree correctamente. Si una operación posterior crea al padre, la referencia de avance se cambia a una entrada normal.

Es posible que una o varias de las referencias de avance permanezca cuando haya finalizado la importación de LDIF (por ejemplo, si el archivo LDIF no creó nunca el padre de una entrada). En este caso, la referencia de avance aparecerá como un objeto desconocido en ConsoleOne y iManager. Se pueden realizar búsquedas en una entrada de referencia de avance, pero no se pueden leer atributos (excepto objectClass) de la entrada de referencia de avance porque esta no tiene atributos ni valores de atributo. Sin embargo, todas las operaciones LDAP funcionarán con normalidad en las entradas del objeto real situadas debajo de la referencia de avance.

Identificación de entradas de referencia de avance

Las entradas de referencia de avance tienen una clase de objeto Desconocido y un indicador de entrada NDS EF_REFERENCE interno definidos. En ConsoleOne y iManager, las entradas con una clase de objeto Desconocido se representan mediante un icono amarillo redondo con un signo de interrogación en el centro. Puede utilizar LDAP para buscar objetos que tengan una clase de objeto Desconocido, aunque actualmente no hay ninguna manera de acceder a la configuración del indicador de entrada a través de LDAP para asegurarse de que son entradas de referencia de avance.

Conversión de entradas de referencia de avance en objetos normales

Para convertir una entrada de referencia de avance en un objeto normal solo tiene que crearlo (por ejemplo, utilizando un archivo LDIF o una petición de cliente LDAP). Cuando solicita a eDirectory la creación de una entrada que ya existe como referencia de avance, eDirectory transforma la entrada de referencia de avance existente en el objeto que ha solicitado crear.

Uso del Asistente ICE (importación/conversión/exportación) de eDirectory de NetIQ

Para habilitar las referencias de avance durante una importación LDIF:

  1. En iManager de NetIQ, haga clic en el botón Funciones y tareas botón Funciones y tareas.

  2. Haga clic en Mantenimiento de eDirectory > Asistente ICE (importación/conversión/exportación).

  3. Haga clic en Import Data (Importar datos) en File on Disk (Archivo en disco) y, a continuación, en Next (Siguiente).

  4. Seleccione LDIF como el tipo de archivo que desea importar.

  5. Especifique el nombre del archivo que contiene los datos que desea importar, especifique las opciones apropiadas y haga clic en Next (Siguiente).

  6. Especifique el servidor LDAP donde se importarán los datos.

  7. Añada las opciones apropiadas, tal como se describe en la tabla siguiente:

    Opción

    Descripción

    Nombre DNS/dirección IP del servidor

    Nombre DNS o dirección IP del servidor LDAP de destino

    Puerto

    Número de puerto entero del servidor LDAP de destino

    Archivo DER

    Nombre del archivo DER que contiene una clave de servidor utilizada para la autenticación SSL

    Método de entrada

    Entrada autenticada o anónima (para la entrada especificada en el campo DN de usuario)

    Nombre completo (DN) de usuario

    Nombre completo de la entrada que se debe utilizar al asociar con la operación de asociación especificada por el servidor

    Contraseña

    Atributo de contraseña de la entrada especificada en el campo DN de usuario

  8. En Ajustes avanzados, haga clic en Permitir referencias de avance.

  9. Haga clic en Siguiente y, a continuación, clic en Finalizar.

Para habilitar las referencias de avance durante una migración de servidor de datos a datos:

  1. En iManager de NetIQ, haga clic en el botón Funciones y tareas botón Funciones y tareas.

  2. Haga clic en Mantenimiento de eDirectory > Asistente ICE (importación/conversión/exportación).

  3. Haga clic en Migrar datos entre servidores y, a continuación, en Siguiente.

  4. Especifique el servidor LDAP que incluye las entradas que desea migrar.

  5. Añada las opciones apropiadas, tal como se describe en la tabla siguiente:

    Opción

    Descripción

    Nombre DNS/dirección IP del servidor

    Nombre DNS o dirección IP del servidor LDAP de origen

    Puerto

    Número de puerto entero del servidor LDAP de origen

    Archivo DER

    Nombre del archivo DER que contiene una clave de servidor utilizada para la autenticación SSL

    Método de entrada

    Entrada autenticada o anónima (para la entrada especificada en el campo DN de usuario)

    Nombre completo (DN) de usuario

    Nombre completo de la entrada que se debe utilizar al asociar con la operación de asociación especificada por el servidor

    Contraseña

    Atributo de contraseña de la entrada especificada en el campo DN de usuario

  6. En Ajustes avanzados, haga clic en Permitir referencias de avance.

  7. Haga clic en Siguiente.

  8. Especifique los criterios de búsqueda (descritos a continuación) para las entradas que desea migrar:

    Opción

    Descripción

    DN de base

    Nombre completo base de la petición de búsqueda

    Si este campo se deja en blanco, se toma el valor por defecto de DN base " " (cadena vacía).

    Ámbito

    Ámbito de la petición de búsqueda

    Filtro

    Filtro de búsqueda compatible con RFC

    El valor por defecto es objectclass=*.

    Atributos

    Atributos que desea que se devuelvan para cada entrada de búsqueda

  9. Haga clic en Siguiente.

  10. Especifique el servidor LDAP al que se migrarán los datos.

  11. Haga clic en Siguiente y, a continuación, clic en Finalizar.

    NOTA:Asegúrese de que el esquema es coherente en todos los servicios LDAP.

Uso de la interfaz de línea de comandos de la utilidad de importación, conversión y exportación de NetIQ

Para habilitar las referencias de avance en la interfaz de línea de comandos, utilice la opción ‑F del gestor de destino LDAP.

Para obtener más información, consulte la sección LDIF Destination Handler Options (Opciones del gestor de destino LDIF) de la NetIQ eDirectory 8.8 SP8 Administration Guide (Guía de administración de eDirectory 8.8 SP8 de NetIQ).

5.2.2 Comprobación de la sintaxis de los archivos LDIF

Puede comprobar la sintaxis de un archivo LDIF antes de procesar los registros del archivo mediante la opción Muestra las opciones pero no las ejecuta del gestor de origen LDIF.

El gestor de origen LDIF comprueba siempre la sintaxis de los registros de un archivo LDIF cuando los procesa. Esta opción inhabilita el procesamiento de los registros y le permite comprobar la sintaxis.

Uso del Asistente ICE (importación/conversión/exportación) de eDirectory de NetIQ

  1. En iManager de NetIQ, haga clic en el botón Funciones y tareas botón Funciones y tareas.

  2. Haga clic en Mantenimiento de eDirectory > Asistente ICE (importación/conversión/exportación).

  3. Haga clic en Import Data (Importar datos) en File on Disk (Archivo en disco) y, a continuación, en Next (Siguiente).

  4. Seleccione LDIF como el tipo de archivo que desea importar.

  5. Especifique el nombre del archivo que contiene los datos que desea importar y especifique las opciones apropiadas.

  6. En Ajustes avanzados, haga clic en Muestra las opciones pero no las ejecuta y después en Siguiente.

  7. Especifique el servidor LDAP donde se importarán los datos.

  8. Añada las opciones apropiadas, tal como se describe en la tabla siguiente:

    Opción

    Descripción

    Nombre DNS/dirección IP del servidor

    Nombre DNS o dirección IP del servidor LDAP de destino

    Puerto

    Número de puerto entero del servidor LDAP de destino

    Archivo DER

    Nombre del archivo DER que contiene una clave de servidor utilizada para la autenticación SSL

    Método de entrada

    Entrada autenticada o anónima (para la entrada especificada en el campo DN de usuario)

    Nombre completo (DN) de usuario

    Nombre completo de la entrada que se debe utilizar al asociar con la operación de asociación especificada por el servidor

    Contraseña

    Atributo de contraseña de la entrada especificada en el campo DN de usuario

  9. Haga clic en Siguiente y, a continuación, clic en Finalizar.

Uso de la interfaz de línea de comandos de la utilidad de importación, conversión y exportación de NetIQ

Para comprobar la sintaxis de un archivo LDIF en la interfaz de línea de comandos, utilice la opción ‑n del gestor de origen LDIF.

Para obtener más información, consulte la sección LDIF Destination Handler Options (Opciones del gestor de origen LDIF) de la NetIQ eDirectory 8.8 SP8 Administration Guide (Guía de administración de eDirectory 8.8 SP8 de NetIQ).

5.2.3 Uso del archivo de error LDIF

La utilidad de importación, conversión y exportación de NetIQ crea automáticamente un archivo LDIF donde se especifican los registros que el gestor de destino no haya podido procesar. Puede editar el archivo de error LDIF generado por la utilidad, corregir los errores y después volver a aplicarlo al servidor para finalizar una importación o migración de datos que contuviese registros con errores.

Uso del Asistente ICA (importación/conversión/exportación) de NetIQ

Esta función solo está disponible en ConsoleOne.

  1. En ConsoleOne, haga clic en Wizard > NDS Import/Export (Asistente > Importación/exportación de NDS).

  2. Haga clic en la tarea que desea realizar.

  3. Haga clic en Avanzado.

  4. En el campo Log File (Archivo de registro), especifique un nombre de archivo para el registro de los mensajes de salida (incluidos los mensajes de error).

  5. En el campo LDIF Output File for Failed Records (Archivo de salida LDIF para registros con fallos), especifique un nombre de archivo para la anotación de las entradas con fallos en formato LDIF.

    Puede utilizar este archivo para analizar o corregir errores. También puede volver a aplicar en el directorio una versión modificada (corregida) de este archivo.

  6. Haga clic en Cerrar.

  7. Siga las instrucciones en línea para finalizar la tarea seleccionada.

Uso de la interfaz de línea de comandos de la utilidad de importación, conversión y exportación de NetIQ

Para configurar las opciones de registro de errores en la utilidad de línea de comandos, utilice la opción general ‑l.

Para obtener más información, consulte la sección General Options (Opciones generales) de la NetIQ eDirectory 8.8 SP8 Administration Guide (Guía de administración de eDirectory 8.8 SP8 de NetIQ).

5.2.4 Uso de indicadores de depuración SDK de LDAP

Para entender algunos problemas de LDIF, quizás deba conocer el funcionamiento del SDK del cliente LDAP. Puede establecer los siguientes indicadores de depuración para el gestor de origen LDAP, el gestor de destino LDAP o ambos.

Valor

Descripción

0x0001

Hacer un seguimiento de las llamadas de función LDAP.

0x0002

Imprimir información acerca de los paquetes.

0x0004

Imprimir información acerca de los argumentos.

0x0008

Imprimir información de las conexiones.

0x0010

Imprimir información sobre la codificación y descodificación BER.

0x0020

Imprimir información del filtro de búsqueda.

0x0040

Imprimir información de configuración.

0x0080

Imprimir información de ACL.

0x0100

Imprimir información estadística.

0x0200

Imprimir información estadística adicional.

0x0400

Imprimir información del shell.

0x0800

Imprimir información de análisis.

0xFFFF (-1 decimal)

Habilitar todas las opciones de depuración.

Para habilitar esta funcionalidad, utilice la opción ‑e para los gestores de origen LDAP y destino LDAP. El valor entero para la opción -e es una máscara de bits que permite varios tipos de información de depuración en el SDK de LDAP.

Para obtener más información, consulte las secciones LDAP Source Handler Options (Opciones del gestor de origen LDAP) y LDAP Destination Handler Options (Opciones del gestor de destino LDAP) de la NetIQ eDirectory 8.8 SP8 Administration Guide (Guía de administración de eDirectory 8.8 SP8 de NetIQ).