|
| |
| de actualización de Sun Java Enterprise System 5 para UNIX | |
Capítulo10
Message QueueEn este capítulo se describe cómo actualizar el software de Message Queue desde las versiones anteriores de Java ES a Java ES 5 (Versión 5): Sun Java System Message Queue 3.7 UR1.
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 Message QueueEn esta sección se describen los siguientes aspectos generales de Message Queue que afectan a la actualización a Java ES 5 (Versión 5):
Acerca de Message Queue de Java ES Versión 5
El componente Message Queue deJava ES Versión 5 representa una actualización menor en comparación con la Versión 4. Contiene principalmente correcciones del código sin mejoras en las funciones menores.
El software de Message Queue ha incluido siempre dos ediciones, Platform Edition y Enterprise Edition; cada una de ellas se correspondía con un conjunto de características y una funcionalidad bajo licencia distintas. Enterprise Edition permitía implementar y ejecutar aplicaciones de mensajería en un entorno de producción empresarial. Platform Edition se utilizaba principalmente para desarrollar y depurar aplicaciones y componentes de mensajería, así como para probar su carga. Con la Versión 5 de Message Queue, Platform Edition ha sido rechazada y Message Queue incluye todas las funciones de Enterprise Edition. Si se realiza una actualización desde una versión anterior de Java ES a la Versión 5, cualquier edición instalada de Platform Edition se convierte en una edición con funciones completas del ámbito empresarial de Message Queue.
Guía de actualización de Message Queue
La Tabla 10-2 muestra las rutas de actualización compatibles de Message Queue para Java ES Versión 5. Esta tabla hace referencia tanto al sistema operativo Solaris como a Linux.
Tabla 10-2 Rutas de actualización a Java ES 5 (Versión 5): Message Queue 3.7 UR1
Versión de Java ES
Message Queue Versión
Enfoque general
Reconfiguración necesaria
Versión 4
Sun Java System Message Queue
2005Q4 (3.6 SP3))
Sólo Enterprise EditionActualización directa:
se realiza mediante el programa de instalación de Java ES.Conversión automática de datos.
Versión 3
Sun Java System Message Queue
2005Q1 (3.6)
Sólo Enterprise EditionActualización directa:
se realiza mediante el programa de instalación de Java ES.Conversión automática de datos.
Versión 2
Sun Java System Message Queue
2004Q2 (3.5 SP1)
Platform Edition y Enterprise EditionActualización directa:
se realiza mediante la secuencia de comandos mqupgrade.Se realiza automáticamente en la plataforma Solaris, mientras que en Linux se utiliza la secuencia de comandos mqmigrate.
Versión 1
Sun Java System Message Queue
2003Q4 (3.0.1 SP2)
Platform Edition y Enterprise EditionActualización directa no certificada:
Aunque puede realizarse mediante la secuencia de comandos mqupgrade.1Se realiza automáticamente en la plataforma Solaris, mientras que en Linux se utiliza la secuencia de comandos mqmigrate.
Versiones anteriores de Java ES
Sun Java System Message Queue
3.0.x y versiones anteriores
Platform Edition y Enterprise EditionActualización directa no certificada:
Aunque puede realizarse mediante el programa de instalación de Java ES.
1Antes y después de ejecutar la secuencia de comandos mqupgrade será necesario realizar copias de seguridad y, seguidamente, un restablecimiento de los siguientes archivos: por ejemplo, en el SO Solaris: restauración de /etc/imq/passwd y /etc/imq/accesscontrol.properties a /var/imq/instances/instanceName/etc/
Además de las versiones de Java ES deMessage Queue mostradas en la Tabla 10-2, Message Queue también incluye el software del sistema operativo Solaris. La actualización de las versiones integradas de Message Queue a la Versión 5 se puede realizar mediante el programa de instalación de Java ES.
Datos de Message Queue
Message Queue, al igual que otros componentes Java ES, utiliza diversos tipos de datos para una actualización específica que es posible que se deban migrar a una versión actualizada. La siguiente tabla muestra el tipo de datos que puede verse afectado por una actualización del software de Message Queue.
La Tabla 10-3 muestra la ubicación de los datos en los sistemas Solaris. La ubicación en sistemas Linux es similar, pero depende de la versión de Message Queue:
Para obtener más información, consulte la Message Queue 3.7 UR1 Administration Guide, http://docs.sun.com/doc/819-4467/6n6k98brl?a=view.
En la Tabla 10-3, instanceName identifica el nombre de la instancia del agente de Message Queue al que están asociados los datos.
Estrategia de actualización para Message Queue
La estrategia utilizada para la actualización de Message Queue 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 Message Queue presentando una serie de problemas que pueden influir en el plan de actualización de Message Queue.
Problemas de compatibilidad
La Versión 5 de Message Queue no introduce nuevas incompatibilidades con respecto a la Versión 3 ni a la Versión 4. Sin embargo, existen algunos problemas de compatibilidad significativos en relación con la Versión 2 y versiones anteriores. Éstos se muestran en Problemas de compatibilidad con la Versión 2.
Además, como regla general, si se combinan los agentes de la Versión 4 y de versiones anteriores de Message Queue con agentes de la Versión 5 de Message Queue en un clúster, el agente maestro debe pertenecer a la versión más antigua y el clúster se ejecutará como un clúster de la versión más antigua de Message Queue.
Dependencias de Message Queue
Las dependencias de Message Queue con respecto a otros componentes de Java ES pueden afectar al procedimiento de actualización y reconfiguración del software de Message Queue. Por ejemplo, los cambios en las interfaces o las funciones de Message Queue pueden requerir las versiones actualizadas de los componentes de los que depende Message Queue. La actualización de dichos componentes será necesaria en función de la ruta de actualización específica.
Message Queue presenta relaciones de dependencia con los siguientes componentes de Java ES:
- Componentes compartidos. Message Queue presenta relaciones de dependencia con determinados componentes compartidos de Java ES (consulte la Tabla 1-9).
- Directory Server. Message Queue tiene una dependencia opcional con Directory Server: puede configurar Message Queue para que se almacenen los objetos administrados o los datos de usuario en un directorio LDAP (Directory Server) en lugar de ser almacenados localmente.
- Contenedor web. Message Queue tiene una dependencia opcional con Web Server, Application Server o con un contenedor web de terceros para poder admitir mensajería HTTP entre el cliente y el agente.
- Bases de datos. Message Queue tiene una dependencia opcional con Java DB (o bases de datos de terceros) para proporcionar un almacenamiento de datos accesible desde JDBC, en lugar de un almacenamiento de mensajes de archivos simples, para la capa de persistencia de Message Queue.
- Sun Cluster. Message Queue tiene una dependencia opcional con Sun Cluster para proporcionar compatibilidad con alta disponibilidad.
Actualización doble
Se pueden realizar actualizaciones dobles de dos formas, en las que se actualiza tanto Message Queue 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 Message Queue.
Consulte la ubicación de los datos esenciales en Datos de Message Queue.
- 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.
- Instale la Versión 5 de Message Queue.
- Restaure los datos de Message Queue de los que se realizó una copia de seguridad en Step 1.
Al actualizar desde la Versión 2 de Message Queue en Linux, los datos se almacenan en la ubicación de la Versión 5.
Actualización del sistema operativo
- Copia de seguridad de los datos existentes de Message Queue.
Consulte la ubicación de los datos esenciales en Datos de Message Queue.
- Actualice el sistema operativo.
La actualización deja el sistema de archivos existentes.
- Actualice Message Queue a la Versión 5.
Consulte la sección adecuada de este capítulo; dependiendo de la ruta de actualización, ésta debe dejar intactos los datos existentes de Message Queue.
Sin embargo, al actualizar desde la Versión 2 de Message Queue en Linux, los datos deben moverse a la ubicación de la Versión 5.
Actualización de Message Queue desde Java ES Versión 4En esta sección, se incluye información sobre la actualización de Message Queue desde Java ES 2005Q4 (Versión 4) a Java ES 5 (Versión 5). En esta sección, se describen los siguientes temas:
Introducción
Al actualizar Message Queue de Java ES de la Versión 4 a la Versión 5, tenga en cuenta los siguientes aspectos relacionados con el proceso de actualización:
- Enfoque general de actualización . La actualización se lleva a cabo mediante el programa de instalación de Java ES. El programa de instalación migra automáticamente los datos de configuración desde la Versión 4. Además, los datos de aplicación dinámicos asociados con la Versión 4 se convertirán automáticamente la primera vez que se ejecute imqbrokerd. En el caso de un almacén basado en archivos, esto significa que el contenido del directorio fs350 se copiará en un directorio nuevo fs370. En el caso de un almacén JDBC, se producirá una actualización simple de la versión en las tablas de las bases de datos existentes.
- Dependencias de actualización. Message Queue 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 Message Queue.
Además, la Versión 5 de Message Queue presenta relaciones de dependencia con los componentes de productos de Java ES, como se describe en Dependencias de Message Queue. Sin embargo, no es necesaria la actualización de estos componentes para actualizar Message Queue a la Versión 5.
- Compatibilidad con versiones anteriores. La Versión 5 de Message Queue es totalmente compatible con la Versión 4 en lo que se refiere a protocolos, compatibilidad del agente, objetos administrados, herramientas de administración y aplicaciones de cliente.
- Anulación de la actualización. No existe ninguna utilidad para deshacer la actualización de Message Queue a la Versión 4. Debe eliminar los componentes actualizados y restaurar manualmente la versión y los datos de configuración anteriores.
- Problemas de plataforma. El enfoque de actualización general de Message Queue es idéntico tanto en el sistema operativo Solaris como en Linux.
Actualización de la Versión 4 de Message Queue
En esta sección se describe cómo realizar una actualización de Message Queue de Java ES Versión 4 a Java ES Versión 5:
Tareas previas a la actualización
Antes de actualizar el software de Message Queue, debe realizar las tareas descritas a continuación:
Verifique la información sobre la versión actual
Para determinar la versión y la edición de Message Queue instalada en el sistema, inicie el agente de Message Queue con la opción -version:
imqbrokerd -version
Actualización de las dependencias de Message Queue
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. Message Queue presenta fuertes relaciones de dependencia únicamente con un par de componentes compartidos.
Al actualizar las dependencias de Message Queue, debe seguir el orden que le mostramos a continuación (omitiendo cualquiera que ya se haya actualizado), antes de actualizar Message Queue. El programa de instalación de Java ES realiza automáticamente la actualización de los componentes compartidos.
- Componentes compartidos. Las instrucciones para sincronizar los componentes compartidos de Java ES en la Versión 5 están disponibles en Actualización de los componentes compartidos de Java ES. Sin embargo, el programa de instalación de Java ES actualiza automáticamente todos los componentes compartidos que requiere Message Queue cuando realiza una actualización a la Versión 5 de Message Queue.
- Sun Cluster (dependencia leve de actualización). Las instrucciones para actualizar Sun Cluster a la Versión 5 están disponibles en el Chapter 3, "Software de Sun Cluster".
- Directory Server (dependencia leve de actualización). Las instrucciones para actualizar Directory Server a la Versión 5 están disponibles en el Chapter 5, "Directory Server".
- Java DB (dependencia leve de actualización). Tiene que realizar una nueva instalación de la Versión 5 de Java DB cuando actualice Message Queue.
- Software de contenedor web (dependencia leve de actualización). Las instrucciones para actualizar Web Server o Application Server están disponibles en el Chapter 7, "Web Server" y en el Chapter 11, "Application Server", respectivamente.
Copia de seguridad de Message Queue
Antes de llevar a cabo la actualización, es recomendable realizar siempre una copia de seguridad de los datos de aplicación en un entorno de producción. Tenga en cuenta la ubicación del almacén persistente de datos de aplicación dinámicos indicada en la Tabla 10-3.
Actualización de la Versión 4 de Message Queue
El proceso de actualización consta de los siguientes pasos:
- Detenga todas las aplicaciones de cliente de Message Queue.
Si se utiliza Message Queue en un entorno de Application Server, cierre también Application Server.
- Detenga cualquier agente que esté en ejecución. Se le pedirá el nombre de usuario de administrador y la contraseña.
imqcmd shutdown bkr [-b hostName:port]
- Si no desea conservar los datos dinámicos, el depósito de usuarios de archivos simples de Message Queue y el archivo de control de acceso de Message Queue asociado a cada instancia del agente, elimine estos datos con el siguiente comando:
imqbrokerd -name instanceName -remove instance
De lo contrario, se conservarán los datos dinámicos y la información de configuración para la Versión 5 de Message Queue.
- Inicie sesión como root.
su -
- Inicie el programa de instalación de Java ES.
cd Java ES Release 5 distribution/os_arch
./installerdonde 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 Message Queue en la página de selección de componentes.
- Confirme el tipo de actualización que desee llevar a cabo.
Los paquetes de Message Queue se actualizarán y se mostrará un resumen de la actualización.
- Salga del programa de instalación de Java ES.
Verificación de la actualización de Message Queue
Una vez finalizado el proceso de actualización, compruebe que se ha realizado con éxito. Para ello, inicie el agente de Message Queue con la opción -version.
El comando devuelve el número de versión de Java ES, así como el número de versión específico de Message Queue.
Tareas posteriores a la actualización
Si ha actualizado el contenedor web y utiliza el servlet de túnel de HTTP de Message Queue, es posible que deba implementarlo otra vez en el nuevo contenedor web. No se produce ningún cambio en el servlet de túnel de HTTP entre la Versión 4 y la Versión 5. Para más información sobre compatibilidad HTTP, consulte la Message Queue 3.7 UR1 Administration Guide, http://docs.sun.com/doc/819-4467.
Si está seguro de que no tendrá que deshacer la actualización, puede eliminar de la Versión 4 los datos basados en archivo que se encuentran en el directorio fs350 (consulte la Tabla 10-3).
Anulación de la actualización
No se proporciona ninguna secuencia de comandos para restablecer Message Queue al estado anterior a la actualización. Este proceso debe realizarse manualmente mediante los siguientes pasos:
- Detenga todas las aplicaciones de cliente de Message Queue.
- Detenga cualquier agente que esté en ejecución. Se le pedirá el nombre de usuario de administrador y la contraseña.
imqcmd shutdown bkr [-b hostName:port]
- Si desea conservar los datos dinámicos, el depósito de usuarios de archivos simples de Message Queue y el archivo de control de acceso de Message Queue asociado a cada instancia del agente, elimine estos datos con el siguiente comando:
imqbrokerd -name instanceName -remove instance
- Inicie sesión como root o conviértase en superusuario.
su -
- Recupere la lista de los paquetes de Message Queue instalados con el siguiente comando:
En Solaris:
pkginfo | grep -i "message queue"En Linux:
rpm -qa | grep mq- Elimine los paquetes de Message Queue con el siguiente comando:
En Solaris:
pkgrm packageName
donde packageName hace referencia a cualquiera de los paquetes de Message Queue. Para eliminar varios paquetes, separe los nombres de los paquetes mediante un espacio.En Linux:
rpm -e --nodeps RPMName
donde RPMName hace referencia a cualquiera de los componentes rpm de Message Queue. Para eliminar varios componentes, separe los nombres de los RPM mediante un espacio.Tenga cuidado a la hora de eliminar los paquetes de Message Queue, ya que pueden estar siendo utilizados por otros productos. El comando pkgrm le avisará en caso de que exista alguna dependencia con respecto a un paquete antes de proceder a su eliminación. Cuando se le solicite, confirme la eliminación escribiendo y (sí).
- Escriba “q” para salir.
- Salga del intérprete de comandos root.
- Vuelva a instalar la Versión 4 de Message Queue.
Utilice el programa de instalación de Java ES Versión 4.
- Restaure la copia de seguridad de los datos de la Versión 4 de Message Queue en Copia de seguridad de Message Queue.
La Versión 4 de Message Queue funcionará adecuadamente con la copia de seguridad de los datos antes de actualizar a la Versión 5.
Actualización de varias instancias
Para actualizar un clúster de Message Queue, en el que varios agentes interactúan para proporcionar un servicio de mensajería escalable, puede realizar una actualización por turnos en la que el clúster permanezca en línea mientras se actualizan todas las instancias de Message Queue de la Versión 4 a la Versión 5. Debe tener en cuenta las dos condiciones siguientes cuando vaya a actualizar el clúster:
Por lo demás, el procedimiento es sencillo: se cierran, actualizan y reinician los agentes uno a uno hasta que se han actualizado todos.
Actualización de Message Queue desde Java ES Versión 3El procedimiento para actualizar Message Queue de Java ES 2005Q1 (Versión 3) a la Versión 5 es el mismo que el que se sigue para actualizar Message Queue de la Versión 4 a la Versión 5.
Para actualizar Message Queue de la Versión 3 a la Versión 5, siga las instrucciones que aparecen en Actualización de Message Queue desde Java ES Versión 4 y sustituya toda referencia a la Versión 4 por la Versión 3.
Actualización de Message Queue desde Java ES Versión 2En esta sección se incluye información sobre la actualización de Message Queue desde Java ES 2004Q2 (Versión 2) a Java ES Versión 5. Además se abordan los siguientes temas:
Nota
Si va a actualizar desde la Versión 2 de Message Queue en la plataforma Linux, tendrá que realizar una actualización doble, en la que se actualice tanto Message Queue como el sistema operativo (no se admite la Versión 5 de Message Queue en RHEL 2.1). Consulte Actualización doble para obtener más información.
Introducción
Al actualizar Message Queue de Java ES Versión 2 a la Versión 5, tenga en cuenta los siguientes aspectos relacionados con el proceso de actualización:
- Enfoque general de actualización. La actualización se realiza mediante la secuencia de comandos mqupgrade que sustituye los paquetes de software anteriores por otros nuevos y migra automáticamente los datos de configuración de la Versión 2.
- Dependencias de actualización. Para actualizar los componentes de Java ES en un equipo desde la Versión 2, es necesario actualizar todos los demás componentes de Java ES alojados por el equipo; no se permite la actualización selectiva de componentes de Java ES de la Versión 2 a la Versión 5. Deben actualizarse especialmente todos los componentes compartidos de Java ES utilizados por Message Queue.
Además, la Versión 5 de Message Queue depende, de forma opcional, de Directory Server y Web Server (o Application Server), tal y como se describe en Dependencias de Message Queue. Si todos estos componentes están instalados en el mismo equipo, entonces tendrán que actualizarse a la Versión 5.
- Compatibilidad con versiones anteriores. La Versión 5 de Message Queue no es totalmente compatible con la Versión 2, como se describe a continuación en Problemas de compatibilidad con la Versión 2,.
- Anulación de la actualización. Actualmente no está permitido deshacer la actualización de la Versión 5 a la 2 (consulte Anulación de la actualización).
- Problemas de plataforma. El enfoque general de actualización de Message Queue es idéntico tanto en el sistema operativo Solaris como en Linux. No obstante, Linux requiere algunos procedimientos adicionales. Los procedimientos que se describen a continuación indican comandos, ubicaciones de archivos o procedimientos específicos para cada plataforma cuando sea pertinente.
Problemas de compatibilidad con la Versión 2
La Versión 5 de Message Queue introduce los siguientes problemas generales de compatibilidad de Message Queue en relación con la Versión 2 y con versiones anteriores.
Compatibilidad con los protocolos
Message Queue presenta una relación de dependencia con un contenedor web para proporcionar compatibilidad del protocolo HTTP entre los clientes de Message Queue y el agente. Debido a un cambio en el protocolo, al utilizar Sun Java System Web Server para proporcionar un contenedor web para la aplicación imqhttp.war de Message Queue, no es posible actualizar el componente Web Server sin actualizar además Message Queue (consulte Tareas posteriores a la actualización en la (more...) y la (more...) .
Compatibilidad del agente
El agente de Message Queue de la Versión 5 puede interoperar con el agente de la Versión 4, la Versión 3 o la Versión 2. Sin embargo, los cambios efectuados en las propiedades del agente y el esquema del almacén persistente con respecto a la Versión 2 pueden afectar a la compatibilidad.
La Versión 5 de Message Queue puede utilizar los datos de la Versión 4, la Versión 3 y la Versión 2, excepto en los sistemas Linux, en los que es necesario migrar primero los datos de la Versión 2 a la 5.
Al actualizar a la Versión 5 de Message Queue, tenga en cuenta lo siguiente:
- Puede utilizar archivos config.properties de versiones anteriores de Message Queue. También puede copiarlos en otra ubicación y consultar la configuración de las propiedades que contienen al configurar los agentes de Message Queue de la Versión 5.
- Si es necesario, todos los datos persistentes de Message Queue (mensajes, destinos o suscripciones duraderas) se convierten automáticamente en datos de la Versión 5 de Message Queue al iniciar un agente por primera vez. Por ejemplo, todos los destinos existentes se convertirán, si es preciso, en destinos de la Versión 5 de Message Queue, conservando los atributos existentes y utilizando los valores predeterminados de los nuevos atributos.
- Si se combinan los agentes de la Versión 2 de Message Queue y los agentes de la Versión 5 de Message Queue en un clúster, el agente maestro debe pertenecer a la Versión 2 de Message Queue (o a aquella que sea menos reciente) y el clúster se ejecutará como un clúster de la Versión 2 de Message Queue.
Compatibilidad de objetos administrados
Los objetos administrados de Message Queue de la Versión 5 son idénticos a los de la Versión 3 y la Versión 4. Sin embargo, se ha cambiado el nombre de algunos objetos administrados de la Versión 3 o se han mejorado con nuevos atributos con respecto a las versiones anteriores. Por lo tanto, al actualizar Message Queue de la Versión 2 a la Versión 5, debería tener en cuenta lo siguiente:
- Puede utilizar el mismo almacén de objetos y los mismos objetos administrados que se crearon en la Versión 2, aunque es recomendable migrar los objetos administrados a la Versión 5. La consola de administración (imqadmin) y la utilidad de línea de comandos de ObjectManager (imqobjmgr) convertirán los objetos administrados de la Versión 2 a la Versión 5 al realizar una operación de actualización.
- El tiempo de ejecución de cliente de la Versión 5 buscará los objetos administrados de la Versión 2 y creará una instancia para ellos y, a continuación, los convertirá para que puedan ser utilizados por los clientes de la Versión 5. Sin embargo, esta acción no convertirá los objetos administrados de la Versión 2 que se encuentren en el almacén de objetos desde el que se realizó la búsqueda.
- Los clientes existentes de la Versión 2 (aplicaciones o componentes), es decir, los clientes que crean directamente instancias para los objetos administrados en lugar de buscarlos, son compatibles con la Versión 5. No obstante, si van a utilizar atributos nuevos de objetos administrados (consulte el capítulo 16 de la Message Queue 3.7 UR1 Administration Guide , http://docs.sun.com/doc/819-4467 para obtener información sobre los atributos de objetos administrados), éstos deberán reescribirse. (Al volver a compilar los clientes de la Versión 2 con los de la Versión 5, se mostrarán los atributos de la Versión 2 de Message Queue que han cambiado de nombre en la Versión 5. Los nombres antiguos seguirán funcionando.)
- Las secuencias de comandos que inician clientes de Java y establecen los valores de los atributos de objetos administrados mediante las opciones de la línea de comandos son compatibles con la Versión 5. No obstante, si utilizan atributos nuevos de objetos administrados (consulte el capítulo 16 de la Message Queue 3.7 UR1 Administration Guide, http://docs.sun.com/doc/819-4467 para obtener información sobre los atributos de objetos administrados), éstos deberán reescribirse.
Compatibilidad de herramientas de administración
Debido a la adición de nuevos comandos y nuevas funciones administrativas en la Versión 3, las herramientas administrativas de la Versión 5 (la consola de administración y las utilidades de línea de comandos) sólo funcionan con los agentes de las Versiones 3, 4 y 5. No obstante, se siguen admitiendo todos los comandos y las opciones de comando de la Versión 2.
Compatibilidad de cliente
Los clientes de la Versión 3 y la Versión 4 son completamente compatibles con la Versión 5 de Message Queue. Sin embargo, al actualizar de la Versión 2 a la Versión 5, debería tener en cuenta los siguientes problemas de compatibilidad relacionados con los clientes de Java:
- Un agente de la Versión 5 es compatible con un cliente de la Versión 2 (pero sin las funciones adicionales de la Versión 5).
- Un cliente de la Versión 5 de Java se puede conectar a un agente de la Versión 2 (pero sin las funciones adicionales de la Versión 5).
- Los programas de cliente C sólo son compatibles con los agentes de la Versión 5 y de la Versión 2, 3 ó 4 que se ejecutan con una licencia de prueba de Platform Edition o una licencia de Enterprise Edition.
Actualización de la Versión 2 de Message Queue
En esta sección se describe cómo realizar una actualización de Message Queue de Java ES Versión 2 a Java ES Versión 5:
Tareas previas a la actualización
Antes de actualizar el software de Message Queue, debe realizar las tareas descritas a continuación:
Verifique la información sobre la versión actual
Para determinar la versión y la edición de Message Queue instalada en el sistema, inicie el agente de Message Queue con la opción -version:
imqbrokerd -version
Actualización de las dependencias de Message Queue
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. Message Queue presenta fuertes relaciones de dependencia únicamente con un par de componentes compartidos.
Al actualizar las dependencias de Message Queue, debe seguir el orden que le mostramos a continuación (omitiendo cualquiera que ya se haya actualizado), antes de actualizar Message Queue.
- Componentes compartidos. 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").
- Sun Cluster (dependencia leve de actualización). Las instrucciones para actualizar Sun Cluster a la Versión 5 están disponibles en el Chapter 3, "Software de Sun Cluster".
- Directory Server (dependencia leve de actualización). Las instrucciones para actualizar Directory Server a la Versión 5 están disponibles en el Chapter 5, "Directory Server".
- Java DB (dependencia leve de actualización). Tiene que realizar una nueva instalación de la Versión 5 de Java DB cuando actualice Message Queue.
- Software de contenedor web (dependencia leve de actualización). Las instrucciones para actualizar Web Server o Application Server están disponibles en el Chapter 7, "Web Server" y en el Chapter 11, "Application Server", respectivamente.
Copia de seguridad de Message Queue
Antes de llevar a cabo la actualización, es recomendable realizar siempre una copia de seguridad de los datos de aplicación en un entorno de producción. En la plataforma del SO Solaris, los datos dinámicos se almacenan en el directorio siguiente:
/var/imq/instances/instanceName.Para obtener información sobre otros sistemas operativos, consulte la Message Queue 3.7 UR1 Administration Guide, http://docs.sun.com/doc/819-4467.
Actualización de la Versión 2 de Message Queue (Solaris)
La actualización del software de Message Queue a Java ES Versión 5 utiliza la secuencia de comandos mqupgrade para instalar los paquetes de la Versión 5.
El proceso de actualización consta de los siguientes pasos:
- Detenga todas las aplicaciones de cliente de Message Queue.
Si se utiliza Message Queue en un entorno de Application Server, cierre también Application Server.
- Detenga cualquier agente que esté en ejecución. Se le pedirá el nombre de usuario de administrador y la contraseña.
imqcmd shutdown bkr [-b hostName:port]
- Si no desea conservar los datos dinámicos, el depósito de usuarios de archivos simples de Message Queue y el archivo de control de acceso de Message Queue asociado a cada instancia del agente, elimine estos datos con el siguiente comando:
imqbrokerd -name instanceName -remove instance
De lo contrario, se conservarán los datos dinámicos y la información de configuración para la Versión 5 de Message Queue.
- Inicie sesión como root.
su -
- Cambie los directorios a la ubicación del directorio Tools de la distribución de Java ES Versión 5.
En Solaris SPARC:
cd Solaris_sparc/Product/message_queue/ToolsEn Solaris x86:
cd Solaris_x86/Product/message_queue/Tools- Ejecute la secuencia de comandos mqupgrade .
- Inicie la secuencia de comandos:
./mqupgrade
La secuencia de comandos mqupgrade muestra los componentes instalados en Message Queue.
- Introduzca y (sí) para actualizar los componentes de Message Queue.
La secuencia de comandos mqupgrade detecta y muestra los archivos de traducción.
Si no desea actualizar los componentes de Message Queue, introduzca n (no). La secuencia de comandos mqupgrade saldrá sin actualizar los componentes de Message Queue.
- Si se le solicita, introduzca y (sí) para actualizar los archivos de traducción.
La secuencia de comandos mqupgrade envía el resultado a un archivo de registro en la siguiente ubicación:
/var/sadm/install/logs/Message_Queue_upgrade_'date'.log
Actualización de la Versión 2 de Message Queue (Linux)
La actualización de Message Queue de la Versión 2 a la Versión 5 en la plataforma Linux se complica por el hecho de que Java ES Versión 2 sólo se admite en RHEL 2.1, pero Java ES Versión 5 no se admite en RHEL 2.1. Por lo tanto, es necesaria una actualización doble: deben actualizarse tanto el sistema operativo como Message Queue. Consulte Actualizaciones dobles: Java ES y software del sistema operativo
El procedimiento básico es actualizar primero el sistema operativo Linux, a continuación todas las dependencias de Message Queue y, por último, Message Queue.
La actualización de Message Queue de la Versión 2 a la Versión 5 incluye un paso de migración de datos que no es necesario en el caso de los sistemas Solaris; se trata, concretamente, de la migración de datos de la instancia del agente a la ubicación apropiada de la Versión 5. Si desea conservar los datos de la Versión 2 al actualizar a la Versión 5, Message Queue proporciona una herramienta, mqmigrate, para realizar esta migración.
Para actualizar de la Versión 2 a la Versión 5, siga las mismas instrucciones que aparecen en Actualización de la Versión 2 de Message Queue (Solaris) y ejecute la secuencia de comandos mqmigrate (Step 6) antes de ejecutar la secuencia de comandos mqupgrade (Step 7), como se detalla en el siguiente procedimiento.
- Detenga todas las aplicaciones de cliente de Message Queue.
- Detenga cualquier agente que esté en ejecución. Se le pedirá el nombre de usuario de administrador y la contraseña.
imqcmd shutdown bkr [-b hostName:port]
- Si no desea conservar los datos dinámicos, el depósito de usuarios de archivos simples de Message Queue y el archivo de control de acceso de Message Queue asociado a cada instancia del agente, elimine estos datos con el siguiente comando:
imqbrokerd -name instanceName -remove instance
De lo contrario, se conservarán los datos dinámicos y la información de configuración para la Versión 5 de Message Queue.
- Inicie sesión como root o conviértase en superusuario.
su -
- Cambie los directorios a la ubicación del directorio Tools de la distribución de Java ESVersión 5.
cd Linux_x86/Product/message_queue/Tools
- Migre los datos de la instancia del agente con el siguiente comando:
./mqmigrate
La secuencia de comandos mqmigrate transferirá los datos de configuración de la instancia del agente de la Versión 2 a la ubicación adecuada R4.
- Ejecute la secuencia de comandosmqupgrade.
- Inicie la secuencia de comandos:
./mqupgrade
La secuencia de comandos mqupgrade muestra los componentes instalados en Message Queue.
- Introduzca y (sí) para actualizar los componentes de Message Queue.
La secuencia de comandos mqupgrade detecta y muestra los archivos de traducción.
Si no desea actualizar los componentes de Message Queue, introduzca n (no). La secuencia de comandos mqupgrade saldrá sin actualizar los componentes de Message Queue.
- Si se le solicita, introduzca y (sí) para actualizar los archivos de traducción.
La secuencia de comandos mqupgrade envía el resultado a un archivo de registro en la siguiente ubicación:
/var/sadm/install/logs/Message_Queue_upgrade_'date'.log
Instalación del paquete de compatibilidad (Linux)
Si tiene secuencias de comandos de la Versión 2, o las aplicaciones de cliente contienen secuencias de comandos de dicha versión que dependen de la ubicación de los archivos instalados de la Versión 5, deberá instalar el paquete sun-mq-compat, que contiene enlaces simbólicos desde las ubicaciones de los archivos de la Versión 2 a las de la Versión 5.
El paquete sun-mq-compat se encuentra en la siguiente ubicación en la que se descomprimió la distribución de Java ES Versión 5.
Linux_x86/Product/message_queue/Packages
Lleve a cabo los siguientes pasos para instalar el paquete sun-mq-compat:
Verificación de la actualización de Message Queue
Una vez finalizado el proceso de actualización, compruebe que se ha realizado con éxito. Para ello, inicie el agente de Message Queue con la opción -version.
El comando devuelve el número de versión de Java ES, así como el número de versión específico de Message Queue.
Tareas posteriores a la actualización
Si utiliza el servlet de túnel de HTTP para proporcionar compatibilidad con el servicio de conexión HTTP, este servlet se actualizará cuando se actualice Message Queue de la Versión 2 a la Versión 5. Para ello, es necesario volver a implementarlo una vez realizada la actualización de Message Queue a la Versión 5. Consulte la Message Queue Administration Guide, (http://docs.sun.com/doc/819-4467) para obtener más información sobre la compatibilidad con HTTP.
Migre los objetos administrados de la Versión 2 a las versiones de la Versión 5 mediante la consola de administración (imqadmin) o la utilidad de línea de comandos de ObjectManager (imqobjmgr) para realizar una operación de actualización.
Anulación de la actualización
No se permite actualmente deshacer la actualización de Message Queue de la Versión 2 a la Versión 5. Por lo general, el procedimiento para deshacer la actualización es similar al aplicado de la Versión 5 a la Versión 4 (consulte Anulación de la actualización). Sin embargo, ya que la actualización de Message Queue de la Versión 2 a la Versión 5 no actualiza el registro de producto de Java ES, el programa de instalación de Java ES no puede volver a instalar la Versión 2 de Message Queue.
Para obtener información sobre soluciones temporales a este problema, consulte Sun Services.
Actualización de varias instancias
Para actualizar un clúster de Message Queue, en el que varios agentes interactúan para proporcionar un servicio de mensajería escalable, puede realizar una actualización por turnos en la que el clúster permanezca en línea mientras se actualizan todas las instancias de Message Queue de la Versión 2 a la Versión 5. Debe tener en cuenta las dos condiciones siguientes cuando vaya a actualizar el clúster:
Por lo demás, el procedimiento es sencillo: se cierran, actualizan y reinician los agentes uno a uno hasta que se han actualizado todos.