Sun Java Enterprise System 2005Q4 Gu�a de actualizaci�n |
Cap�tulo 7
Message QueueEste cap�tulo describe c�mo actualizar el software de Message Queue desde las versiones anteriores de Java ES a Java ES 2005Q4 (Versi�n 4): Sun Java System Message Queue 3 Enterprise Edition 2005Q4.
Este cap�tulo proporciona una visi�n general de los problemas y los procedimientos de actualizaci�n de Message Queue para los diferentes m�todos de actualizaci�n admitidos por Java ES versi�n 4. Se tratan las actualizaciones tanto en el sistema operativo Solaris como 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 2005Q4 (Versi�n 4):
Acerca de Message Queue de Java ES Versi�n 4
El componente Message Queue de Java ES Versi�n 4 presenta varias soluciones de errores de c�digo poco relevantes, y no incluye ninguna nueva funci�n o mejora. Por este motivo, la Versi�n 4 no presenta ning�n nuevo problema de compatibilidad (consulte Problemas de compatibilidad).
El software de Message Queue incluye dos ediciones, Platform Edition y Enterprise Edition; cada una de ellas se corresponde con un conjunto de caracter�sticas y una funcionalidad bajo licencia distintas. Enterprise Edition permite implementar y ejecutar aplicaciones de mensajer�a en un entorno de producci�n empresarial. Platform Edition se utiliza principalmente para desarrollar y depurar aplicaciones y componentes de mensajer�a, y para probar su carga. Esta edici�n puede descargarse de forma gratuita desde el sitio Web de Sun y se incluye adem�s con el SO Solaris y la plataforma Java ES Application Server. Si se realiza una actualizaci�n desde una versi�n anterior de Java ES a la Versi�n 4, la edici�n Platform Edition instalada se convierte en Enterprise Edition.
Gu�a de actualizaci�n de Message Queue
La Tabla 7-1 muestra las rutas de actualizaci�n compatibles de Message Queue para Java ES Versi�n 4. Esta tabla hace referencia tanto al sistema operativo Solaris como a Linux.
Tabla 7-1 Rutas de actualizaci�n a Message Queue 3.6 SP3 2005Q4 de Java ES Versi�n 4
Versi�n de Java ES
Message Queue Versi�n
Enfoque general
Reconfiguraci�n necesaria
Versi�n 3
Sun Java System Message Queue
2005Q2 (3.6)
S�lo Enterprise EditionActualizaci�n directa:
Se realiza mediante la secuencia de comandos mqupgrade.Ninguna.
Versi�n 2
Sun Java System Message Queue
2004Q2 (3.5)
Platform Edition y Enterprise EditionActualizaci�n directa:
Se realiza mediante la secuencia de comandos mqupgrade.Se realiza autom�ticamente en la plataforma Solaris y, en Linux, se utiliza la secuencia de comandos mqmigrate.
Versi�n 1
Sun Java System Message Queue
3.01 SP2
Platform Edition y Enterprise EditionActualizaci�n directa no certificada:
Aunque puede realizarse mediante la secuencia de comandos mqupgrade.Se realiza autom�ticamente en la plataforma Solaris y, en Linux, se utiliza la secuencia de comandos mqmigrate.
Versiones de Java ES anteriores
Sun Java System Message Queue
3.01 SP1 y versiones anteriores
Platform Edition y Enterprise EditionSin actualizaci�n directa:
Aunque puede actualizar primero a la Versi�n 3 utilizando los procedimientos descritos en 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 4.
Adem�s de las versiones de Java ES deMessage Queue mostradas en la tabla Tabla 7-1, Message Queue Platform Edition tambi�n incluye el software del sistema operativo Solaris. La actualizaci�n de las versiones compiladas de Message Queue a la Versi�n 4 de Enterprise Edition se puede realizar mediante el programa de instalaci�n de Java ES. S�lo tiene que seleccionar Message Queue para instalarlo mediante el programa de instalaci�n, como si se tratase de una nueva instalaci�n, y el software de este programa actualizar� autom�ticamente la versi�n compilada, realizando todas las tareas de reconfiguraci�n necesarias para Message Queue.
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.
Tabla 7-2 muestra la ubicaci�n de los datos en los sistemas Solaris. La ubicaci�n en Linux es parecida y se indica en Message Queue Administration Guide (http://docs.sun.com/doc/819-2571). En la Tabla 7-2, instanceName identifica el nombre de la instancia del agente de Message Queue a los que est�n asociados los datos.
Problemas de compatibilidad
La Versi�n 4 de Message Queue no presenta ninguna nueva incompatibilidad con respecto a la Versi�n 3. Los siguientes problemas de compatibilidad de Message Queue hacen referencia a versiones anteriores a la Versi�n 3.
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 se puede 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 4 puede interactuar con el agente de la Versi�n 3 � 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 4 de Message Queue puede utilizar los datos de la Versi�n 3 y 2, excepto en los sistemas Linux, donde deben migrarse primero los datos de la Versi�n 2 a la 4.
Al actualizar a la Versi�n 4 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 4.
- Si es necesario, todos los datos persistentes de Message Queue (mensajes, destinos o suscripciones duraderas) se convierten en datos de la Versi�n 4 de Message Queue al iniciar un agente por primera vez. Por ejemplo, todos los destinos existentes se convertir�n, si es necesario, en destinos de la Versi�n 4 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 4 de Message Queue, el agente principal debe pertenecer a la Versi�n 2 de Message Queue (o 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 4 son id�nticos a los de la Versi�n 3. 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 4, deber�a tener en cuenta lo siguiente:
- Puede utilizar el mismo almac�n de objetos y los mismos objetos administrados que se crearon con la Versi�n 2, aunque es recomendable migrarlos a la Versi�n 4. 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 4 al realizar una operaci�n de actualizaci�n.
- El tiempo de ejecuci�n de cliente de la Versi�n 4 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 4. 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 y/o componentes), es decir, los clientes que crean directamente instancias para los objetos administrados, en lugar de buscarlos, son compatibles con la Versi�n 4. Sin embargo, si utilizan nuevos atributos de objetos administrados (consulte el cap�tulo 16 de Message Queue Administration Guide, http://docs.sun.com/doc/819-2571, 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 4, se indicar�n los atributos de la Versi�n 2 de Message Queue que han cambiado de nombre en la Versi�n 4. Los nombres antiguos seguir�n funcionando.)
- Las secuencias que inician clientes de Java y establecen los valores de los atributos de objetos mediante las opciones de la l�nea de comandos son compatibles con la Versi�n 4. Sin embargo, si utilizan nuevos atributos de objetos administrados (consulte el cap�tulo 16 de Message Queue Administration Guide, http://docs.sun.com/doc/819-2571, 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 4 (la consola de administraci�n y las utilidades de l�nea de comandos) s�lo funcionan con los agentes de las Versiones 3 y 4. 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 son completamente compatibles con la Versi�n 4 de Message Queue. Sin embargo, al actualizar de la Versi�n 2 a la Versi�n 4, deber�a tener en cuenta los siguientes problemas de compatibilidad relacionados con los clientes de Java:
- Un agente de la Versi�n 4 ser� compatible con un cliente de la Versi�n 2 (pero sin las funciones adicionales de la Versi�n 4).
- Un cliente de la Versi�n 4 se podr� conectar a un agente de la Versi�n 2 (pero sin las funciones adicionales de la Versi�n 4).
- Los programas de cliente C s�lo son compatibles con los agentes de la Versi�n 2, 3 � 4 que se ejecutan con una licencia de prueba (de Platform Edition) o una licencia de Enterprise Edition.
Dependencias de Message Queue
Las dependencias de Message Queue con 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 dependencias en relaci�n con determinados componentes compartidos de Java ES (consulte la Tabla 1-6).
- Directory Server (opcional). Si desea configurar Message Queue para almacenar objetos administrados y/o datos de usuario en un directorio LDAP en lugar de localmente, puede utilizar Directory Server para este fin.
- Contenedor web (opcional). Si necesita un servicio de mensajer�a entre el cliente y el agente, Message Queue necesita disponer de compatibilidad de contenedor web con Java ES Web Server, Java ES Application Server u otros contenedores web de terceros.
Actualizaci�n de Message Queue desde Java ES Versi�n 3En esta secci�n, se incluye informaci�n sobre la actualizaci�n de Message Queue de Java ES 2005 Q1 (Versi�n 3) a Java ES Versi�n 4. En esta secci�n, se describen los siguientes temas:
Introducci�n
Al actualizar Message Queue de Java ES Versi�n 3 a la Versi�n 4, tenga en cuenta los siguientes aspectos relacionados con el proceso de actualizaci�n:
- Enfoque de actualizaci�n general. La actualizaci�n se realiza mediante la secuencia de comandos mqupgrade que sustituye los paquetes de software anteriores por nuevos y migra autom�ticamente los datos de configuraci�n de la Versi�n 3.
- Dependencias de actualizaci�n. Mientras Message Queue presenta una relaci�n de dependencia con una serie de componentes compartidos de Java ES (consulte la Tabla 1-6), la Versi�n 4 de Message Queue es compatible con las versiones de estos componentes compartidos de la Versi�n 3. Por lo tanto, en la actualizaci�n de Message Queue a la Versi�n 4, la actualizaci�n de estos componentes compartidos es completamente opcional.
Adem�s, la Versi�n 4 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. Sin embargo, estas dependencias de actualizaci�n no son determinantes, ya que la actualizaci�n de estos componentes es opcional en relaci�n con la actualizaci�n de Message Queue a la Versi�n 4.
- Compatibilidad con versiones anteriores. La Versi�n 4 de Message Queue es totalmente compatible con la Versi�n 3 (consulte Problemas de compatibilidad).
- Anulaci�n de la actualizaci�n. No existe ninguna utilidad para deshacer la actualizaci�n de Message Queue a la Versi�n 3. 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. Los procedimientos descritos a continuaci�n indican comandos o ubicaciones de archivos espec�ficos para cada plataforma cuando es pertinente.
Actualizaci�n de la Versi�n 3 de Message Queue
En esta secci�n se describe c�mo realizar una actualizaci�n de Message Queue de Java ES Versi�n 3 a Java ES Versi�n 4:
Tareas previas a la actualizaci�n
Antes de actualizar Message Queue, lleve a cabo los procedimientos descritos en las siguientes secciones. Cuando el procedimiento dependa de comandos espec�ficos para una plataforma, la tarea indicar� el sistema operativo al que se hace referencia.
Verifique la informaci�n de versi�n actual (Sistemas Solaris)
Para determinar la versi�n y la edici�n de la instancia de Message Queue instalada en el sistema, inicie el agente de Message Queue con la opci�n -version:
imqbrokerd -version
Actualice 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 4. Sin embargo, como no es necesario actualizar los componentes compartidos de Java ES Versi�n 3 de los que depende Message Queue, esta tarea es opcional.
Sin embargo, si decide actualizar todas las dependencias de Message Queue, deben actualizarse en el siguiente orden antes de actualizar Message Queue. Puede omitir todas aquellas dependencias que ya se hayan actualizado.
- Componentes compartidos. Las instrucciones para actualizar los componentes compartidos de Java ES a la Versi�n 4 est�n disponibles en el Cap�tulo 2, “Actualizaci�n de los componentes compartidos de Java ES”.
- Directory Server (opcional). Las instrucciones para actualizar Directory Server a la Versi�n 4 est�n disponibles en el Cap�tulo 4, “Directory Server y Administration Server”.
- Software de contenedor web (opcional). Las instrucciones para actualizar Web Server o Application Server est�n disponibles en Cap�tulo 6, “Web Server” y Cap�tulo 9, “Application Server” respectivamente.
Copia de seguridad de Message Queue
No existe ninguna secuencia de comandos para restablecer Message Queue a su estado anterior. Como los datos de la Versi�n 4 son compatibles con los de la Versi�n 3, no es necesario realizar una copia de seguridad de los datos de configuraci�n. Adem�s, no existe ning�n motivo para realizar una copia de seguridad de la imagen instalada, ya que puede utilizar el programa de instalaci�n de la Versi�n 3 en caso de que sea necesario deshacer la actualizaci�n a la Versi�n 4 de Message Queue y restablecer la Versi�n 3.
Actualizaci�n de la Versi�n 3 de Message Queue
Durante la actualizaci�n del software de Message Queue a Java ES Versi�n 4, se utiliza la secuencia de comandos mqupgrade, que instala los paquetes aplicados previamente que contienen las revisiones mostradas en la Tabla 7-4.
Tabla 7-4 Revisiones1 de actualizaci�n de Message Queue
Componente
SPARC
Solaris 8, 9 y 10
x86
Solaris 8 y 9
Linux
Message Queue Core
119132-06
119133-06
119136-06
Message Queue C-runtime
119134-04
119135-04
Message Queue jmsclient y xmlclient
119137-04
Traducci�n de Message Queue
119691-03
119692-03
119693-03
1Los n�meros de revisiones suponen la revisi�n m�nima necesaria para actualizar a Java ES Versi�n 4. Si aparecen nuevas revisiones, util�celas en lugar de las que aparecen en la tabla.
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 Application Server tambi�n.
- 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 4 de Message Queue.
- Inicie sesi�n como root.
su -
- Cambie los directorios a la ubicaci�n del directorio Tools (Herramientas) de la distribuci�n de Java ES.
En Solaris SPARC:
cd Solaris_sparc/Product/message_queue/ToolsEn Solaris x86:
cd Solaris_x86/Product/message_queue/ToolsEn Linux x86:
cd Linux_x86/Product/message_queue/Tools- Ejecute la secuencia de comandosmqupgrade.
- Inicie la secuencia de comandos:
./mqupgrade
La secuencia de comandos mqupgrade muestra los componentes compartidos de 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 instalados.
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
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. De lo contrario, no se habr� aplicado ning�n cambio en el servlet de t�nel de HTTP entre la Versi�n 3 y la 4, y no ser� necesario volver a implementarlo despu�s de la actualizaci�n de Message Queue a la Versi�n 4. Consulte Message Queue Administration Guide, (http://docs.sun.com/doc/819-2571) para obtener m�s informaci�n sobre la compatibilidad con HTTP.
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:
Solaris:
pkginfo | grep -i "message queue"Linux:
rpm -qa | grep mq- Elimine los paquetes de Message Queue con el siguiente comando:
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.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� si existe 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 3 de Message Queue.
Utilice el programa de instalaci�n de Java ES Versi�n 3. Los datos de la Versi�n 4 de Message Queue funcionar�n correctamente.
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 cada una de las instancias de Message Queue de la Versi�n 3 a la Versi�n 4. Debe tener en cuenta estas dos condiciones a la hora de 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 2El procedimiento de actualizaci�n del componente Message Queue de Java ES 2004Q2 (Versi�n 2) a la Versi�n 4 es casi igual al procedimiento de actualizaci�n de la Versi�n 3 de Message Queue a la Versi�n 4 (consulte Actualizaci�n de Message Queue desde Java ES Versi�n 3). Sin embargo, existe una peque�a diferencia entre las plataformas de sistema operativo.
Adem�s, entre las tareas previas de actualizaci�n, se debe incluir la actualizaci�n de todos los componentes compartidos de los que depende Message Queue (consulte Tabla 1-6) de las versiones de la Versi�n 2 a la Versi�n 4.
Las instrucciones para actualizar los componentes compartidos de Java ES a la Versi�n 4 est�n disponibles en el Cap�tulo 2, “Actualizaci�n de los componentes compartidos de Java ES”.
Actualizaci�n de la Versi�n 2 de Message Queue (Solaris)
Siga las instrucciones que aparecen en Actualizaci�n de Message Queue desde Java ES Versi�n 3, pero sustituya las referencias a la Versi�n 3 por la Versi�n 2.
Actualizaci�n de la Versi�n 2 de Message Queue (Linux)
En los sistemas Linux, el proceso de actualizaci�n de la Versi�n 2 a la Versi�n 4 incluye la migraci�n de los datos (este paso no es necesario en la actualizaci�n de la Versi�n 3 a la 4), sobre todo, la migraci�n de los datos de la instancia del agente a la ubicaci�n adecuada de la Versi�n 4. Si, al actualizar a la Versi�n 4, desea conservar los datos de la Versi�n 2, Message Queue proporciona una herramienta, mqmigrate, para realizar esta migraci�n.
Procedimiento de actualizaci�n
Para actualizar de la Versi�n 2 a la Versi�n 3, sigas las mismas instrucciones que aparecen en Actualizaci�n de Message Queue desde Java ES Versi�n 3, pero ejecute la secuencia de comandos mqmigrate antes de ejecutar la secuencia de comandos mqupgrade, 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 4 de Message Queue.
- Inicie sesi�n como root o convi�rtase en superusuario.
su -
- Cambie los directorios a la ubicaci�n del directorio Tools (Herramientas) de la distribuci�n de Java ES.
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 de la Versi�n 4.
- Ejecute la secuencia de comandos mqupgrade.
- Inicie la secuencia de comandos:
./mqupgrade
La secuencia de comandos mqupgrade muestra los componentes compartidos de 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 instalados.
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
Si tiene secuencias de comandos o las aplicaciones de cliente de la Versi�n 2 contienen secuencias de comandos que dependen de la ubicaci�n de los archivos instalados de la Versi�n 4, deber� instalar el paquete sun-mq-compat, que contiene v�nculos simb�licos de las ubicaciones de los archivos de la Versi�n 2 a las ubicaciones de la Versi�n 4.
El paquete sun-mq-compat se encuentra en la siguiente ubicaci�n en la que se descomprimi� la distribuci�n de Java ES.
Linux_x86/Product/message_queue/Packages
Lleve a cabo los siguientes pasos para instalar el paquete sun-mq-compat:
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, al actualizar Message Queue de la Versi�n 2 a la Versi�n 4, se actualizar� este servlet. Para ello, es necesario volver a implementarlo una vez realizada la actualizaci�n de Message Queue a la Versi�n 4. Consulte Message Queue Administration Guide, (http://docs.sun.com/doc/819-2571) 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 4 mediante la consola de administraci�n (imqadmin) y/o la utilidad de l�nea de comandos ObjectManager (imqobjmgr) para realizar una operaci�n de actualizaci�n.