![]() | |
de actualización de Sun Java Enterprise System 5 para UNIX |
Capítulo5
Directory ServerEn este capítulo se describe cómo actualizar Directory Server a Java ES 5 (Versión 5): Sun Java System Directory Server 6.0.
Este capítulo proporciona una visión general de las consideraciones que hay que tener en cuenta para la actualización de las diferentes rutas de actualización admitidas por la Versión 5. Se tratan las actualizaciones tanto en el sistema operativo Solaris como en Linux.
Visión general de la actualización de Directory ServerEn esta sección se describen los siguientes aspectos generales de Directory Server que afectan a la actualización a Java ES 5 (Versión 5):
Acerca de Java ES Versión 5
Java ES La Versión 5 de Directory Server representa una versión superior con una variedad de nuevas funciones y mejoras. Para obtener más información, consulte Directory Server Enterprise Edition 6 Release Notes, http://docs.sun.com/doc/819-0991.
Guía de actualización deJava ES Versión 5
La Tabla 5-2 muestra las rutas de actualización compatibles de Directory Server para Java ES Versión 5. Esta tabla hace referencia tanto al sistema operativo Solaris como a Linux.
Tabla 5-2 Rutas de actualización a Java ES 5 (Versión 5): Directory Server 6.0
Versión de Java ES
Directory Server Versión
Enfoque general
Reconfiguración necesaria
Versión 4
Sun Java System Directory Server 5.2 2005Q4
Sun Java System Administration Server 5.2 2005Q4
Actualización directa:
Nueva instalación y migración de todos los datos.Función de Administration Server sustituida por el centro de control del servicio de directorios y las utilidades de línea de comandos de Directory Server EE.
Datos de configuración migrados desde una versión anterior a una nueva instalada en Directory Server
Versión 3
Sun Java System Directory Server 5 2005Q1
Sun Java System Administration Server 5 2005Q1
Actualización directa:
Nueva instalación y migración de todos los datos.Función de Administration Server sustituida por el centro de control del servicio de directorios y las utilidades de línea de comandos de Directory Server EE.
Datos de configuración migrados desde una versión anterior a una nueva instalada en Directory Server
Versión 2
Sun Java System Directory Server 5.2 2004Q2
Sun Java System Administration Server 5.2 2004Q2
Actualización directa:
Nueva instalación y migración de todos los datos.Función de Administration Server sustituida por el centro de control del servicio de directorios y las utilidades de línea de comandos de Directory Server EE.
Datos de configuración migrados desde una versión anterior a una nueva instalada en Directory Server
Versión 1
Sun ONE Directory Server 5.2
Sun ONE Administration Server 5.2
Actualización directa no certificada:
Aunque puede utilizar el mismo enfoque que el de la actualización desde la Versión 2.Datos de configuración migrados desde una versión anterior a una nueva instalada en Directory Server
Versiones anteriores de Java ES
Sun ONE Directory Server 5.2
Sun ONE Administration Server 5.2
Actualización directa no certificada:
Aunque puede utilizar el mismo enfoque que el de la actualización desde la Versión 2.Datos de configuración migrados desde una versión anterior a una nueva instalada en Directory Server
Sun ONE Directory Server 5.1
Sun ONE Administration Server 5.1
Sin actualización directa:
Actualice primero a la Versión 3. Consulte la Guía de migración y actualización de Java Enterprise System 2005Q1, http://docs.sun.com/doc/819-0062.A continuación, actualice de la Versión 3 a la Versión 5.
Consulte la Guía de migración y actualización de Java Enterprise System 2005Q1, http://docs.sun.com/doc/819-0062.
Datos de Directory Server
Directory Server 5.Las versiones de x utilizaban Directory Server para el almacenamiento de datos de configuración. Los datos se almacenaban en una estructura de árbol específica dentro del directorio. La instancia de Directory Server que aloja la configuración se denominaba directorio de configuración. Este directorio podía residir en el mismo equipo que otras instancias de Directory Server. Sin embargo, en la mayoría de las arquitecturas de implementación, el directorio de configuración estaba ubicado de forma remota en relación con los demás componentes, que lo utilizan para almacenar información de configuración.
Directory Server 6.0 ya no almacena datos de configuración en un directorio de configuración. La configuración se lleva a cabo mediante el centro de control del servicio de directorios (o las utilidades de línea de comandos de Directory Server EE) y tiene que accederse a ella mediante esta interfaz. El centro de control del servicio de directorios almacena datos de configuración en su propia instancia local de Directory Server.
La siguiente tabla muestra el tipo de datos que puede verse afectado por una actualización del software de Directory Server a la Versión 5.
Estrategia de actualización para Directory Server
La estrategia utilizada para la actualización de Directory Server depende normalmente de las diferentes consideraciones descritas en el Chapter 1, "Planificación de las actualizaciones": ruta de actualización, dependencias entre los componentes de Java ES, actualización selectiva frente a actualización completa, implementaciones de varias instancias, etc.
En esta sección se particulariza la discusión general en torno a Directory Server presentando una serie de problemas que pueden influir en el plan de actualización de Directory Server.
Problemas de compatibilidad
No se han introducido cambios en la interfaz de Directory Server de Java ES Versión 5 y es, por lo tanto, compatible con versiones anteriores. Además es compatible con todos los componentes admitidos por la Versión 4 de Directory Server y por versiones anteriores.
Sin embargo, la Versión 5 introduce cambios en las interfaces administrativas privadas. Las interfaces de la Versión 5 son incompatibles con versiones anteriores de Directory Server. Administration Server en particular, que solía configurar instancias anteriores de Directory Server, ha sido reemplazado por el centro de control de servicios de directorios y por las utilidades de línea de comandos de Directory Server, y ha sido eliminado el sufijo de directorio o=NetscapeRoot, que servía para almacenar información de configuración de Directory Server. Para más información, consulte la Directory Server Enterprise Edition 6 Migration Guide, http://docs.sun.com/doc/819-0994.
Dependencias
En general, las dependencias respecto de otros componentes de Java ES pueden afectar al procedimiento de actualización del software de Directory Server.
Directory Server presenta relaciones de dependencia con los siguientes componentes de Java ES:
- Componentes compartidos. Directory Server presenta relaciones de dependencia con componentes compartidos específicos de Java ES (consulte la Tabla 1-9). La actualización de Directory Server puede depender de las versiones actualizadas de estos componentes compartidos.
- Directory Proxy Server. Directory Server tiene una dependencia conjunta con Directory Proxy Server para proporcionar seguridad y rendimiento mejorados a las solicitudes LDAP.
Actualización doble
Se pueden realizar actualizaciones dobles de dos formas, en las que se actualiza tanto Directory Server como el sistema operativo (como se describe en Actualizaciones dobles: Java ES y software del sistema operativo).
Nueva instalación de sistema operativo
- Copia de seguridad de los datos existentes de Directory Server.
Consulte Cree una imagen de Directory Server (opcional) para obtener más información acerca de Directory Server 5.x.
- Instale el nuevo sistema operativo.
La instalación del sistema operativo puede ser en un nuevo sistema (o zona Solaris 10) o puede sustituir el sistema de archivos existente.
- Restaure los datos de Directory Server de los que se realizó una copia de seguridad en el Step 1.
- Instale la Versión 5 de Directory Server.
- Cree una instancia de Directory Server Versión 5 y migre los datos del directorio a la nueva instancia.
Consulte los pasos correspondientes en el procedimiento para Actualización de la Versión 4 de Directory Server.
Actualización del sistema operativo
- Copia de seguridad de los datos existentes de Directory Server.
Consulte Cree una imagen de Directory Server (opcional) para obtener más información acerca de Directory Server 5.x.
- Actualice el sistema operativo.
La actualización deja el sistema de archivos existentes.
- Actualice a la Versión 5 de Directory Server.
Consulte la sección correspondiente de este capítulo, dependiendo de la ruta de actualización.
Actualización de Directory Server desde Java ES Versión 4En esta sección se incluye información sobre la actualización de Directory Server desde Java ES 2005 Q4 (Versión 4) a Java ES 5 (Versión 5). En esta sección, se describen los siguientes temas:
Introducción
Al actualizar Directory Server de la Versión 4 a la Versión 5 de Java ES, hay que tener en cuenta los siguientes aspectos del proceso de actualización:
- Enfoque general de actualización. La actualización se consigue realizando una nueva instalación de la Versión 5 de Directory Server y, a continuación, utilizando las herramientas de migración para volver a crear las instancias anteriores de Directory Server en instancias nuevas y diferenciadas de la Versión 5 de Directory Server.
- Dependencias de actualización. Directory Server presenta relaciones de dependencia con varios componentes compartidos de Java ES (consulte la Tabla 1-9). Todos estos componentes se actualizan automáticamente a la Versión 5 mediante el programa de instalación de Java ES cuando realice una actualización de Directory Server.
- Compatibilidad con versiones anteriores. La Versión 5 de Directory Server no es compatible con la Versión 4, tal y como se describe en Problemas de compatibilidad. Sin embargo, las herramientas de migración permiten que se migre el sufijo o=NescapeRoot si continúa manteniendo un conjunto de instancias de Directory Server que dependan de la estructura administrativa de Directory Server 5.x.
- Anulación de la actualización. Para deshacer la actualización a la Versión 5 se debe eliminar la versión anterior, que se mantiene intacta al actualizar a la Versión 5.
- Problemas de plataforma. El enfoque general de actualización de Directory Server es idéntico tanto para el sistema operativo Solaris como para Linux.
Actualización de la Versión 4 de Directory Server
En esta sección se describe cómo realizar una actualización de Directory Server de Java ES Versión 4 a Java ES Versión 5 en las plataformas Solaris y Linux. Cuando un tema haga referencia a procedimientos específicos para una plataforma, se indicará el sistema operativo al que se aplica. En esta sección, se describen los siguientes temas:
Tareas previas a la actualización
Antes de actualizar el software de Directory Server, debe realizar las tareas descritas a continuación:
Verifique la información sobre la versión actual
Para verificar la versión actual de Directory Server, reinicie el daemon de Directory Server con la opción -v:
cd serverRoot/bin/slapd/server
./ns-slapd -v
si falla el comando ns-slapd en la plataforma Solaris 10, establezca la ruta de biblioteca en "null" al ejecutar el comando:
LD_LIBRARY_PATH= ./ns-slapd -v
Actualización de las dependencias de Directory Server
Por lo general, se recomienda actualizar todos los componentes de Java ES de un sistema informático (y de un entorno informático) a Java ES Versión 5. Sin embargo, todos los componentes compartidos que necesita Directory Server se actualizan automáticamente cuando se realiza la actualización de Directory Server a la Versión 5.
Obtenga las contraseñas y la información de configuración necesarias
Debe conocer el Id. de usuario y la contraseña del administrador de la versión de Directory Server actualmente instalada. Otra información de configuración se preserva durante el proceso de actualización.
Cree una imagen de Directory Server (opcional)
En los casos en los que la Versión 5 de Directory Server se instala en un equipo diferente del equipo en el que reside la Versión 4, debe crearse una imagen de la Versión 4 en el equipo en el que vaya a instalarse la Versión 5 de Directory Server. La imagen es necesaria para automatizar la migración de datos (mediante el comando dsmig) a las nuevas instancias de la Versión 5 de Directory Server.
La imagen de la Versión 4 incluye todos los archivos de esquema, de configuración, de seguridad y de bases de datos, con un diseño idéntico al de la estructura original de archivo de Directory Server 5.x serverRoot. La imagen es necesaria para llevar a cabo la migración de datos a las nuevas instancias de la Versión 5 de Directory Server.
Actualización de la Versión 4 de Directory Server
En esta sección se abordan diversas consideraciones que afectan al proceso de actualización de Directory Server, además de una descripción del propio procedimiento.
Consideraciones sobre la actualización
Al actualizar el software de Directory Server a Java ES Versión 5, es preciso tener en cuenta las siguientes consideraciones:
- Cualquier componente de Java ES que utilice una instancia de Directory Server (como Access Manager o Portal Server, o los componentes de Sun Java Communications Suite) debe cerrarse y volverse a configurar, si fuera necesario, para acceder a la nueva instancia correspondiente de la Versión 5.
- En una arquitectura de implementación en la que haya varias instancias de Directory Server ejecutándose en un único equipo (todas correspondientes a la misma imagen instalada de Directory Server), sólo tiene que actualizar la imagen de Directory Server una vez. Sin embargo, deberá migrar los datos de cada una de las instancias por separado.
- En muchas arquitecturas de implementación de la Versión 4 de Directory Server, el directorio de configuración es una instancia diferente de Directory Server. Estas instancias no necesitan ser actualizadas porque el directorio de configuración ha sido rechazado por la Versión 5. Por otra parte, la actualización tiene que conllevar la implementación de la consola administrativa de la Versión 5 de Directory Server (el centro de control del servicio de directorios) en un equipo diferente del que utilice para administrar remotamente las instancias de Directory Server.
- Con Directory Server se proporciona una herramienta de línea de comandos que ayuda a automatizar la migración de los datos de esquema, de configuración, de seguridad y de usuario. Esta herramienta de migración permite una migración paso a paso de los diferentes tipos de datos. La mayoría de los escenarios se benefician de la migración automatizada de, al menos, algunos de los datos.
Procedimiento de actualización
El procedimiento que se describe a continuación hace referencia a las instancias de Directory Server que residen localmente en el equipo en el que se vaya a realizar la actualización o, en el caso de que las instancias se vayan a mover a otro equipo, a todas las instancias que se vayan a ejecutar en el equipo de destino.
- Inicie sesión como root o conviértase en superusuario.
su -
- Cierre las instancias de la Versión 4 de Directory Server (5.2).
serverRoot/slapd-instanceName/stop-slapd
Compruebe que el registro de errores (serverRoot/slapd-hostName/logs/errors) proporciona un informe de cierre limpio:
[23/Jan/2006:15:56:47 +0100]: todos los subprocesos de la base de datos están detenidos
[23/Jan/2006:15:56:50 +0100]: slapd detenido.
- Asegúrese de que el equipo host de la Versión 5 de Directory Server dispone de suficiente espacio en el disco.
El cálculo básico es el siguiente:
2 * (espacio para el servidor existente) + (espacio para los archivos LDIF)Por desgracia, no hay ninguna herramienta que permita anticipar el tamaño de un archivo LDIF creado a partir de una base de datos exportada. El tamaño dependerá del número de entradas de datos, de su representación interna, del número de índices, etc.
- Para instalar remotamente la Versión 5, cree una imagen de la Versión 4 y transfiérala al equipo remoto.
Consulte Cree una imagen de Directory Server (opcional).
- Asegúrese de que ha actualizado todos los componentes de Java ES con los queDirectory Server tiene una fuerte relación de dependencia (consulte Actualización de las dependencias de Directory Server).
- Realice una nueva instalación de la Versión 5 de Directory Server.
Lleve a cabo estos pasos:
- Inicie el programa de instalación de Java ES.
donde os_arch coincide con la plataforma como, por ejemplo, Solaris_sparc. (Utilice la opción installer -nodisplay para la interfaz de línea de comandos).
Una vez mostradas las páginas de bienvenida y acuerdo de licencia, aparecerá la página de selección de componentes. (Cuando se detectan componentes instalados que pueden ser actualizados directamente con el programa de instalación de Java ES, éstos aparecen con el estado “actualizables”.)
- Seleccione el subcomponente de Directory Server de Directory Server Enterprise Edition.
Tendrá que instalar también los subcomponentes administrativos (panel de control del servicio de directorios o utilidades de línea de comandos) que desee utilizar.
- Especifique una ruta de instalación diferente de cualquiera existente en la Versión 4 de Directory Server.
- Seleccione Configurar ahora o Configurar más tarde.
No importa qué opción elija, dado que Directory Server no precisa de configuración alguna. Sin embargo, si elije Configurar ahora, no opte por crear una nueva instancia.
- Confirme las opciones de instalación seleccionadas.
Los paquetes de Directory Server se actualizarán y se mostrará un resumen de la actualización.
- Salga del programa de instalación de Java ES.
- Cree una instancia de Directory Server.
DirServer-base/ds6/bin/dsadm create instancePath
donde instancePath es la ruta completa a la instancia de Directory Server.
Para obtener información sobre cómo crear una instancia de Directory Server, consulte la Directory Server Enterprise Edition 6 Administration Guide, http://docs.sun.com/doc/819-0995.
Si no consigue crear una nueva instancia, se creará una nueva automáticamente cuando se migren los datos con el comando dsmig (Step 8).
Si falla el comando dsadm en la plataforma Solaris 10, establezca la ruta de biblioteca en “null” al ejecutar el comando:
LD_LIBRARY_PATH= ./dsadm create instancePath
- Migre la instancia de Directory Server de la Versión 4 a la Versión 5.
Utilice los comandos DirServer-base/ds6/bin/dsmig.
Los comandos dsmig adaptan los datos de la Versión 4 al formato de la Versión 5 y los escriben en las ubicaciones adecuadas. Por ejemplo, la migración típica en un único equipo con una instancia de Directory Server debe tener el siguiente aspecto:
Notas
- Si la instancia de Directory Server que se está migrando guarda datos de configuración de otros componentes de Java ES como, por ejemplo, el componente Messaging Server de Sun Java Communications Suite, tendrá que migrar una parte específica del árbol de información del directorio con el nombre o=netscaperoot. Este sufijo raíz no se migra de forma predeterminada. Para migrar o=netscaperoot, utilice la opción -N de dsmig migrate-config y los comandos dsmig migrate-data . Por ejemplo:
- Si está migrando desde una instancia de una arquitectura de 32 bits a otra de 64 bits, no es posible utilizar el comando (herramienta de migración automática) dsmig migrate-data. Tiene que migrar los datos manualmente, como se describe en la Guía de migración a la que se hace referencia a continuación. No obstante, todavía puede realizar una migración automática de los datos de esquema, de configuración y de seguridad.
- En algunos casos, cuando se inicia Directory Server después de que se hayan migrado los datos de directorio, la nueva comprobación de errores de la Versión 5 detecta definiciones circulares en las entradas de grupo de Directory Server. Estas definiciones circulares son funcionalmente benignas, pero pueden provocar un gran número de errores que pueden quedar registrados en el archivo de errores.
Para obtener más detalles sobre el proceso de migración, los comandos dsmig y la migración manual, consulte la Directory Server Enterprise Edition 6 Migration Guide, http://docs.sun.com/doc/819-0994.
Verificación de la actualización
Puede verificar si se ha realizado con éxito la actualización de Directory Server de la siguiente manera:
- Inicie la nueva instancia de Directory Server:
DirServer-base/ds6/bin/dsadm -V
Consulte la Tabla 5-4 para obtener los valores de salida.
- Compruebe los mensajes de inicio en el registro de errores de Directory Server:
instancePath/logs/errors
Tareas posteriores a la actualización
No hay tareas posteriores a la actualización, aparte de las descritas en Procedimiento de actualización, excepto que todos los componentes de Java ES que dependen de Directory Server deben volver a configurarse para que señalen a las nuevas instancias de Directory Server.
Anulación de la actualización
Para deshacer la actualización a la Versión 5 se debe eliminar la versión anterior, que se mantiene intacta al actualizar a la Versión5.
Actualización de varias instancias
Los procedimientos descritos en Actualización de la Versión 4 de Directory Server no abordan de forma explícita las arquitecturas de implementación en las que Directory Server se replica para obtener disponibilidad o escalabilidad. Entre estas arquitecturas se incluye la repetición de Directory Server o la implementación de Directory Server como servicio de datos en un entorno de Sun Cluster.
Actualización por turnos de réplicas de Directory Server
Se pueden actualizar de forma secuencial (una instancia cada vez) varias instancias de Directory Server en diferentes sistemas informáticos, del mismo modo que en las arquitecturas de implementación de repetición de réplicas principales. Después de la primera sincronización de todas las réplicas de Directory Server, debe actualizar cada instancia en el equipo host respectivo mientras las demás instancias se dejan en ejecución. Esta actualización por turnos permite que el servicio de directorio permanezca en línea mientras se actualizan las instancias de Directory Server que proporcionan el servicio.
Actualización de Directory Server como servicio de datos
La información relativa a la actualización y la anulación de la actualización de Directory Server como servicio de datos en un entorno de Sun Cluster no está disponible todavía.
Actualización de Directory Server desde Java ES Versión 3El procedimiento para actualizar Directory Server de Java ES 2003Q1 (Versión 3) a la Versión 5 es el mismo que el que se sigue para actualizar Directory Server de la Versión 4 a la Versión 5.
Para actualizar Directory Server de la Versión 3 a la Versión 5, siga las instrucciones que aparecen en Actualización de Directory Server desde Java ES Versión 4 y sustituya toda referencia a la Versión 4 por la Versión 3.
Actualización de Directory Server desde Java ES Versión 2El procedimiento para actualizar Directory Server de Java ES 2004Q2 (Versión 2) a la Versión 5 es el mismo que el procedimiento de actualización de Directory Server de la Versión 4 a la Versión 5, con la excepción de que las tareas previas a la actualización deben incluir la actualización de todos los componentes compartidos a la Versión 5 (consulte la Tabla 1-9).
Las instrucciones para actualizar los componentes compartidos de Java ES a la Versión 5 están disponibles en el Chapter 2, "Actualización de los componentes compartidos de Java ES".
Para actualizar Directory Server de la Versión 2 a la Versión 5, siga las instrucciones que aparecen en Actualización de Directory Server desde Java ES Versión 4 y sustituya toda referencia a la Versión 4 por la Versión 2.
Nota
Si va a actualizar desde la Versión 2 de Directory Server en la plataforma Linux, tendrá que realizar una actualización doble, en la que se actualice tanto Directory Server como el sistema operativo (no se admite la Versión 5 de Directory Server en RHEL 2.1). Consulte Actualización doble para obtener más información.