Procedimiento de Migracin a WMQ V6 / WMQ V7

Gerencia de Soporte Tcnico de Productos y BackEnd Direccin de Produccin GUA DE MIGRACIN A Websphere MQ V6 y Websphere MQ V7

REALIZADO Javier Rodrguez

REVISADO

Procedimiento de Migracin a WMQ V6 / WMQ V7 Versin 1.0 Descripcin de la Modificacin Versin Inicial Fecha

Procedimiento de Migracin a WMQ V6 / WMQ V7 Indice de Contenido Introduccin ...................................................................................................................... 4 Documentacin ................................................................................................................. 4 Versiones disponibles ....................................................................................................... 4 Migracin a WMQ V6 / WMQ V7 para HP-UX ............................................................. 5 Prerrequisitos ................................................................................................................ 5 Procedimiento de migracin para HP-UX .................................................................... 6 Migracin a WMQ V6 / WMQ V7 para AIX ................................................................ 12 Prerrequisitos .............................................................................................................. 12 Procedimiento de migracin para AIX ....................................................................... 13 Migracin a WMQ V6 / WMQ V7 para Solaris ............................................................ 19 Prerrequisitos .............................................................................................................. 19 Procedimiento de migracin para Solaris ................................................................... 20 Anexo I: Recuperacin de los objetos del QM ............................................................... 25 Anexo II: rbol de directorios WMQ para UNIX ......................................................... 27

Procedimiento de Migracin a WMQ V6 / WMQ V7

Introduccin
Este documento tiene como finalidad proporcionar una operativa bsica para realizar el upgrade del producto Websphere MQ Series a sus versiones de soporte (WMB V6 y WMQ V7) por parte de IBM. Tambin se hace referencia a la migracin a WMQ v5.3 por estar instalado en varias plataformas dentro de la lnea de negocio de sistemas de red. La versin del Sistema Operativo puede ser un factor lmite que impida la subida de versin a estas ltimas versiones. Para cualquier duda, dirigirse al InfoCenter de IBM accesible desde Internet: InfoCenter WMQ V6: http://publib.boulder.ibm.com/infocenter/wmqv6/v6r0/index.jsp InfoCenter WMQ V7: http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/index.jsp

Documentacin
Websphere MQ V6 o o o o Quick Beginnings for HPUX v6 Quick Beginnings for Solaris v6 Quick Beginnings for AIX v6 Quick Beginnings for Windows v6

Websphere MQ V7 o o o o Quick Beginnings for HPUX v7 Quick Beginnings for Solaris v7 Quick Beginnings for AIX v7 Quick Beginnings for Windows v7

Versiones disponibles
Websphere MQ V6.0 Fin soporte 30-07-2012 Websphere MQ V7.0

Procedimiento de Migracin a WMQ V6 / WMQ V7

Migracin a WMQ V6 / WMQ V7 para HP-UX

Prerrequisitos
Se necesita que exista el usuario y grupo mqm. Para realizar la migracin tambin es necesario tener acceso con usuario root. Las versiones de SO soportadas son: o WMQ V6 HP-UX PA-RISC 2.0 HP-UX 11i v1 (B.11.11) 64 bits ms Dec. 2003 Quality Pack HP-UX 11i v2 (11.23) 64 bits

HP-UX Itanium o WMQ V7 HP-UX PA-RISC 2.0 y HP-UX Itanium HP-UX 11i V2 (11.23) HP-UX 11i V3 (11.31) HP-UX 11i v2 (11.23) 64 bits

Configuracin del kernel: o WMQ V6

shmmax 536870912 shmseg 1024 shmmni 1024 shmem 1 sema 1 semaem 16384 semvmx 32767 semmns 16384 semmni 1024 (semmni < semmns) semmap 1026 (semmni +2) semmnu 16384 semume 256 maxusers 32 max_thread_proc 66 maxfiles 10000 maxfiles_linfile 10000 nfile 10000

Procedimiento de Migracin a WMQ V6 / WMQ V7 o WMQ V7 shmmax 536870912 shmseg 1024 shmmni 1024 semaem 16384 semvmx 32767 semmns 16384 semmni 1024 (semmni < semmns) semmnu 16384 semume 256 max_thread_proc 66 maxfiles 10000 maxfiles_lim 10000 nfile 10000

Deben de existir los file system para el almacenamiento del producto y de los datos que va a manejar. En el /opt/mqm se guardar toda la instalacin del producto. Los datos se almacenarn en el /var/mqm. Para el /opt/mqm se recomienda un tamao mnimo de: o 325MB para la instalacin de un WMQ v6 / WMQ v7 servidor El tamao del file system /var/mqm depender en gran medida de: 1. El nmero mximo de mensajes que manejar el gestor de colas de manea simultnea 2. El tamao medio que tendr los mensajes. A esta tamao habr que sumarle 500bytes de tamao de cabecera 3. El nmero de colas que tendr el gestor de colas 4. El tamao de los logs y trazas Se recomienda un dejar como mnimo un tamao de 50MB.

Procedimiento de migracin para HP-UX

NOTA Este procedimiento es compatible para realizar las siguientes migraciones: Migracin desde WMQ v5.2 / WMQ v5.3 a WMQ v6 / WMQ v7 Migracin desde WMQ v6 a WMQ v7

Tareas previas
El procedimiento de migracin para WMQ consiste en una desinstalacin de la versin actual y una instalacin de la versin nueva. Por este motivo, y por fuera necesario hacer una marcha atrs, es recomendable tener el pack de instalacin de la versin actual as como los support packs instalados.

Procedimiento de Migracin a WMQ V6 / WMQ V7

A continuacin se muestra para cada versin los supports packs que se suprimen y de los que se debera tener una copia en caso de que estuviesen instalados en la versin actual del producto.
SupportPacs suprimidos en WMQ V6

SupportPac MA0C MA0R MA88 MACZ

Descripcin MQSeries Publish/subscribe WebSphere MQ transport for SOAP MQSeries Classes for Java and WebSphere MQ classes for Java Message Service MQSeries Client libraries for HP-UX (64-bit)

SupportPacs suprimidos en WMQ V7

SupportPac MA0Y MA6P

Descripcin WebSphere MQ Bridge para HTTP WebSphere MQ - bibliotecas XA para utilizarlas con TX-series en HP-UX para IPF

Migracin
1. Realizar un backup de los objetos de MQ. Para ello es necesario la utilidad saveqmgr: saveqmgr -m NombreGestor f fichero_salida 2. Realizar un backup de los permisos de los objetos. amqoamd -m NombreGestor -s > permisos.txt 3. Realizar un backup del directorio /var/mqm 4. Detener todas las aplicaciones que hagan uso de los gestores de colas. 5. Finalizar todas las actividades de MQ. Para ello con usuario mqm hacer: a. Parar el gestor de colas: endmqm i NombreGestor b. Parar el listener: endmqlsr m NombreGestor c. Realizar un ps ef|grep mqm para comprobar que no quedan procesos arrancados. Si los hubiera, matar todos los procesos con formato amq o runmq, ignorar los procesos amqi.

Procedimiento de Migracin a WMQ V6 / WMQ V7 6. Desinstalar la versin anterior de WMQ Series y sus paquetes adicionales. a. b. c. d. Hacer login con root Desinstalar MQ: swremove MQSERIES Desinstalar paquetes adiciones: swremove paquete Comprobar que el directorio /opt/mqm no quedan ficheros. Si los hubiera, borrar dichos ficheros.

7. Instalar la nueva versin de WMQ Series a. b. c. d. Hacer login con root Ir a la ruta donde est el paquete de instalacin Ejecutar la licencia y aceptarla: ./mqlicense.sh Ejecutar el siguiente comando para comenzar la instalacin: swinstall -s archivo de instalacin Si se desea instalar todos los componentes seleccionar: Actions > Install (Opcin recomendada) Si no se desea instalar todos los componentes seleccionar: Actions > Open Item. Seleccionar los componentes a instalar. Para instalar un servidor, cmo mnimo hay que seleccionar Runtime y Servidor. Volvemos al men inicial y marcamos Actions > Install

e. La instalacin comienza. Se mostrar un mensaje de instalacin completada cuando finalice. 8. Despus de finalizada la instalacin, WMQ tiene que reorganizar los objetos segn el formato de la nueva versin. Para ello, hay que arrancar el gestor usando nicamente el comando strmqm GESTOR. Comprobar que el gestor de colas ha arrancado verificando con el comando dspmq que se encuentra en estado running. ES IMPORTANTE NO ARRANCAR EL LISTENER EN EL PRIMER ARRANQUE 9. Una vez comprobado que el gestor ha recreado todos objetos. Paramos de nuevo el gestor endmqm i GESTOR y lo arrancamos otra vez. En este nuevo arranque se deben lanzar otros componentes complementarios de WMQ: Listener (runmqlsr), trigger monitor (runmqtrm), iniciador de canal (runmchi), etc.

Tareas finales
Para comprobar el correcto funcionamiento del producto, debemos realizar una serie de tareas post-migracin. 8

Procedimiento de Migracin a WMQ V6 / WMQ V7

1. Comprobar con el comando dspmq que el gestor est en running 2. Comprobar que el listener est arrancado. Para ello podemos: a. Reliazar un ps ef | grep runmlsr, o bien, b. Hacer un netstat an|grep puerto 3. Revisar que los canales de tipo SENDER estn arrancados. Para ello realizar en la consola runmqsc un dis chstatus(*). Si algn canal estuviera en estado STOPPED, arrancarlo ejecutando start channel(NOMBRE_CANAL) 4. Encolar algunos mensajes de prueba. De especial atencin sern las colas que tengan algn tipo de evento asociado. Para dichas colas comprobar que al encolar el mensaje se ejecuta su evento. a. Encolar mensajes en una cola local: amqsput nombre_cola Comprobar que el mensaje ha sido encolado. Desde la consola runmqsc realizar: dis q(nombre_cola) curdepth. El contador deber ser mayor que cero. b. Encolar un mensaje en una cola local que tenga evento asociado: amqsput nombre_cola_con_evento. Comprobar que el evento ha saltado y se han realizado las operaciones esperadas. Si no fuera as, comprobar que el trigger monitor est arrancado ps ef|grep runmqtrm c. Encolar un mensaje en una cola remota: amqsput nombre_cola_remota. Verificar que el mensaje ha salido hacia el gestor destino. d. Recuperar un mensaje nombre_cola de una cola local: amqsget

5. Revisar que en el directorio /var/mqm/errors no se estn generando FDCs continuamente. IMPORTANTE! Archivo JAR (Java archive) com.ibm.mqbind.jar El archivo JAR (Java archive) com.ibm.mqbind.jar se ha dejado de utilizar y ya no se proporciona con WebSphere MQ Versin 6.0 y versiones posteriores. Si las aplicaciones Java se han basado en el contenido de este archivo, necesitar cambiarlas para utilizar el archivo com.ibm.mq.jar a la hora de migrar WebSphere MQ.

Procedimiento de Migracin a WMQ V6 / WMQ V7

Marcha atrs
En caso de ser necesario realizar una marcha atrs, ser necesario disponer del software de la versin anteriormente instalada, as como sus paquetes adicionales. El procedimiento de marcha atrs es muy parecido al de upgrade, con una fase de desinstalacin de la versin actual e instalacin de la versin que se quiere instalar. 1. Detener todas las aplicaciones que hagan uso de los gestores de colas. 2. Finalizar todas las actividades de MQ. Para ello con usuario mqm hacer: a. Parar el gestor de colas: endmqm i NombreGestor b. Parar el listener: endmqlsr m NombreGestor c. Realizar un ps ef|grep mqm para comprobar que no quedan procesos arrancados. Si los hubiera, matar todos los procesos con formato amq o runmq, ignorar los procesos amqi. 3. Desinstalar la versin anterior de WMQ Series y sus paquetes adicionales. a. b. c. d. Hacer login con root Desinstalar MQ: swremove MQSERIES Desinstalar paquetes adiciones: swremove paquete Comprobar que el directorio /opt/mqm no quedan ficheros. Si los hubiera, borrar dichos ficheros.

4. Instalar la nueva versin de WMQ Series a. b. c. d. Hacer login con root Ir a la ruta donde est el paquete de instalacin Ejecutar la licencia y aceptarla: ./mqlicense.sh Ejecutar el siguiente comando para comenzar la instalacin: swinstall -s archivo de instalacin Si se desea instalar todos los componentes seleccionar: Actions > Install (Opcin recomendada) Si no se desea instalar todos los componentes seleccionar: Actions > Open Item. Seleccionar los componentes a instalar. Para instalar un servidor, cmo mnimo hay que seleccionar Runtime y Servidor. Volvemos al men inicial y marcamos Actions > Install

5. Una vez terminada la instalacin, el gestor tiene que reorganizar los objetos. Para ello, el primer arranque del gestor de colas debe realizarse unicamente ejecutando el comando strmqm GESTOR. 10

Procedimiento de Migracin a WMQ V6 / WMQ V7 ES IMPORTANTE NO ARRANCAR EL LISTENER EN EL PRIMER ARRANQUE 6. Comprobar que el gestor de colas ha arrancado verificando con el comando dspmq que se encuentra en estado running 7. Una vez comprobado que el gestor ha recreado todos objetos. Paramos de nuevo el gestor endmqm i GESTOR y arrancamos de nuevo. En este nuevo arranque se deben lanzar otros componentes complementarios de WMQ: Listener (runmqlsr), trigger monitor (runmqtrm), iniciador de canal (runmchi), etc. 8. Si fuera necesario instalar paquetes adicionales, (MA88 por ejemplo). instalarlos siguiendo el procedimiento de instalacin habitual descritos en los puntos del 4, 5, 7, 8 y 9 (exceptuando el punto 6 Desinstalacin) del procedimiento de migracin.

11

Procedimiento de Migracin a WMQ V6 / WMQ V7

Migracin a WMQ V6 / WMQ V7 para AIX

Prerrequisitos
Se necesita que exista el usuario y grupo mqm. Para realizar la migracin tambin es necesario tener acceso con usuario root. Las versiones de SO soportadas son: o WMQ V6 AIX5L v5.2, con el nivel de mantenimiento 3 AIX5L v5.3 o WMQ V7 AIX v5.3, con TL04 AIX v6.1 En AIX los parmetros del kernel se actualizan automticamente. Deben de existir los file system para el almacenamiento del producto y de los datos que va a manejar. En el /usr/mqm se guardar toda la instalacin del producto. Los datos se almacenarn en el /var/mqm. Para el /usr/mqm se recomienda un tamao mnimo de: o 325MB para la instalacin de un WMQ v6 / WMQ v7 servidor El tamao del file system /var/mqm depender en gran medida de: 1. El nmero mximo de mensajes que manejar el gestor de colas de manea simultnea 2. El tamao medio que tendr los mensajes. A este tamao habr que sumarle 500bytes de tamao de cabecera 3. El nmero de colas que tendr el gestor de colas 4. El tamao de los logs y trazas Se recomienda un dejar como mnimo un tamao de 50MB. Para las versiones WMQ v6 y WMQ v7 es posible que adicionalmente se tenga que configurar los siguientes parmetros del SO: o Aumentar el nmero de file descriptor hasta 10.000 para el usuario mqm. o Poner de manera ilimitada los segmentos de pila y datos: ulimit d unlimited y ulimit s unlimited

12

Procedimiento de Migracin a WMQ V6 / WMQ V7

Procedimiento de migracin para AIX

NOTA Este procedimiento es compatible para realizar las siguientes migraciones: Migracin desde WMQ v5.2 / WMQ v5.3 a WMQ v6 / WMQ v7 Migracin desde WMQ v6 a WMQ v7

Tareas previas
El procedimiento de migracin para WMQ consiste en una desinstalacin de la versin actual y una instalacin de la versin nueva. Por este motivo, y por fuera necesario hacer una marcha atrs, es recomendable tener el pack de instalacin de la versin actual as como los support packs instalados. A continuacin se muestra para cada versin los supports packs que se suprimen y de los que se debera tener una copia en caso de que estuviesen instalados en la versin actual del producto.
SupportPacs suprimidos en WMQ V6

SupportPac MA0C MA0R MA88 MACZ

Descripcin MQSeries Publish/subscribe WebSphere MQ transport for SOAP MQSeries Classes for Java and WebSphere MQ classes for Java Message Service MQSeries Client libraries for AIX (64-bit)

SupportPacs suprimidos en WMQ V7

SupportPac MA0Y

Descripcin WebSphere MQ Bridge para HTTP

Migracin
1. Realizar un backup de los objetos de MQ. Para ello es necesario la utilidad saveqmgr: saveqmgr -m NombreGestor f fichero_salida

13

Procedimiento de Migracin a WMQ V6 / WMQ V7

2. Realizar un backup de los permisos de los objetos. amqoamd -m NombreGestor -s > permisos.txt 3. Realizar un backup del directorio /var/mqm 4. Detener todas las aplicaciones que hagan uso de los gestores de colas. 5. Finalizar todas las actividades de MQ. Para ello con usuario mqm hacer: a. Parar el gestor de colas: endmqm i NombreGestor b. Parar el listener: endmqlsr m NombreGestor c. Realizar un ps ef|grep mqm para comprobar que no quedan procesos arrancados. Si los hubiera, matar todos los procesos con formato amq o runmq, ignorar los procesos amqi. 6. Desinstalar la versin anterior de WMQ Series y sus paquetes adicionales. a. Hacer login con root b. Desinstalar MQ usando la utilidad smit c. Desplegar el panel con la siguiente secuencia:
Installation and Maintenance Software Maintenance and Utilities Remove Installed Software
Software

d. Pulsar sobre F4 sobre la opcn SOFTWARE e. Seleccionar los ficheros a desinstalar. Sern aquellos que comienzan por la palabra mqm. Presionar Enter. f. Presionar Enter sobre Remove Installed Software. g. Una vez acabada la desinstalacin, comprobar que el directorio /opt/mqm no quedan ficheros. Si los hubiera, borrar dichos ficheros. 7. Instalar la nueva versin de WMQ Series a. Hacer login con root b. Ejecutar la utilidad smit. Realizar la siguiente secuencia para instalar: Software Installation and Maintenance Install and Update Software Install and Update from ALL Available Software c. Seleccionar List e indicar la ruta donde se encuentra el software.

14

Procedimiento de Migracin a WMQ V6 / WMQ V7 d. Seleccionar los componentes a instalar. Como mnimo se deber de instalar: 1. Para WMQ v7: Runtime, Java y Server components 2. Para WMQ v6: Runtime y Server components e. Cambiar Preview new LICENSE agreements? a Yes. f. Cambiar ACCEPT new license agreements? a Yes. Pulsar Enter para aceptar la licencia y comience la instalacin. 8. Despus de finalizada la instalacin, WMQ tiene que reorganizar los objetos segn el formato de la nueva versin. Para ello, arrancar el gestor usando nicamente el comando strmqm GESTOR. Comprobar que el gestor de colas ha arrancado verificando con el comando dspmq que se encuentra en estado running. ES IMPORTANTE NO ARRANCAR EL LISTENER EN EL PRIMER ARRANQUE. 9. Una vez comprobado que el gestor ha recreado todos objetos. Paramos de nuevo el gestor endmqm i GESTOR y lo arrancamos de nuevo. En este nuevo arranque se deben lanzar otros componentes complementarios de WMQ: Listener (runmqlsr), trigger monitor (runmqtrm), iniciador de canal (runmchi), etc.

Tareas finales
Para comprobar el correcto funcionamiento del producto, debemos realizar una serie de tareas post-migracin. 1. Comprobar con el comando dspmq que el gestor est en running 2. Comprobar que el listener est arrancado. Para ello podemos: a. Reliazar un ps ef | grep runmlsr, o bien, b. Hacer un netstat an|grep puerto 3. Revisar que los canales de tipo SENDER estn arrancados. Para ello realizar en la consola runmqsc un dis chstatus(*). Si algn canal estuviera en estado STOPPED, arrancarlo ejecutando start channel(NOMBRE_CANAL) 4. Encolar algunos mensajes de prueba. De especial atencin sern las colas que tengan algn tipo de evento asociado. Para dichas colas comprobar que al encolar el mensaje se ejecuta su evento. a. Encolar mensajes en una cola local: amqsput nombre_cola

15

Procedimiento de Migracin a WMQ V6 / WMQ V7 Comprobar que el mensaje ha sido encolado. Desde la consola runmqsc realizar: dis q(nombre_cola) curdepth. El contador deber ser mayor que cero. b. Encolar un mensaje en una cola local que tenga evento asociado: amqsput nombre_cola_con_evento. Comprobar que el evento ha saltado y se han realizado las operaciones esperadas. Si no fuera as, comprobar que el trigger monitor est arrancado ps ef|grep runmqtrm c. Encolar un mensaje en una cola remota: amqsput nombre_cola_remota. Verificar que el mensaje ha salido hacia el gestor destino. d. Recuperar un mensaje nombre_cola de una cola local: amqsget

5. Revisar que en el directorio /var/mqm/errors no se estn generando FDCs IMPORTANTE! Archivo JAR (Java archive) com.ibm.mqbind.jar El archivo JAR (Java archive) com.ibm.mqbind.jar se ha dejado de utilizar y ya no se proporciona con WebSphere MQ Versin 6.0 y versiones posteriores. Si las aplicaciones Java se han basado en el contenido de este archivo, necesitar cambiarlas para utilizar el archivo com.ibm.mq.jar a la hora de migrar WebSphere MQ.

Marcha atrs
En caso de ser necesario realizar una marcha atrs, ser necesario disponer del software de la versin anteriormente instalada, as como sus paquetes adicionales. El procedimiento de marcha atrs es muy parecido al de upgrade, con una fase de desinstalacin de la versin actual e instalacin de la versin que se quiere instalar. 1. Finalizar todas las actividades de MQ. Para ello con usuario mqm hacer: a. Parar el gestor de colas: endmqm i NombreGestor b. Parar el listener: endmqlsr m NombreGestor c. Realizar un ps ef|grep mqm para comprobar que no quedan procesos arrancados. Si los hubiera, matar todos los procesos con formato amq o runmq, ignorar los procesos amqi. 2. Desinstalar la versin anterior de WMQ Series y sus paquetes adicionales.

16

Procedimiento de Migracin a WMQ V6 / WMQ V7 a. Hacer login con root b. Desinstalar MQ usando la utilidad smit c. Desplegar el panel con la siguiente secuencia:
Installation and Maintenance Software Maintenance and Utilities Remove Installed Software
Software

d. Pulsar sobre F4 sobre la opcn SOFTWARE e. Seleccionar los ficheros a desinstalar. Sern aquellos que comienzan por la palabra mqm. Presionar Enter. f. Presionar Enter sobre Remove Installed Software. g. Una vez acabada la desinstalacin, comprobar que el directorio /opt/mqm no quedan ficheros. Si los hubiera, borrar dichos ficheros. 3. Instalar la nueva versin de WMQ Series a. Hacer login con root b. Ejecutar la utilidad smit. Realizar la siguiente secuencia para instalar: Software Installation and Maintenance Install and Update Software Install and Update from ALL Available Software c. Seleccionar List e indicar la ruta donde se encuentra el software. d. Seleccionar los componentes a instalar. Como mnimo se deber de instalar: 1. Para WMQ v6: Runtime y Server components 2. Para WMQ v5.3: Runtime, , Server components,Base Kit. e. Cambiar Preview new LICENSE agreements? a Yes. f. Cambiar ACCEPT new license agreements? a Yes. Pulsar Enter para aceptar la licencia y comience la instalacin. 4. Despus de finalizada la instalacin, WMQ tiene que reorganizar los objetos segn el formato de la nueva versin. Para ello, arrancar el gestor usando nicamente el comando strmqm GESTOR. Comprobar que el gestor de colas ha arrancado verificando con el comando dspmq que se encuentra en estado running 5. Una vez comprobado que el gestor ha recreado todos objetos. Paramos de nuevo el gestor endmqm i GESTOR y lo arrancamos de nuevo. En este nuevo arranque se deben lanzar otros componentes

17

Procedimiento de Migracin a WMQ V6 / WMQ V7 complementarios de WMQ: Listener (runmqlsr), trigger monitor (runmqtrm), iniciador de canal (runmchi), etc. 6. Si fuera necesario instalar paquetes adicionales, (MA88 por ejemplo). instalarlos siguiendo el procedimiento de instalacin habitual descritos en los puntos del 4, 5, 7, 8 y 9 (exceptuando el punto 6 Desinstalacin) del procedimiento de migracin.

18

Procedimiento de Migracin a WMQ V6 / WMQ V7

Migracin a WMQ V6 / WMQ V7 para Solaris

Prerrequisitos
Se necesita que exista el usuario y grupo mqm. Para realizar la migracin tambin es necesario tener acceso con usuario root. Las versiones de SO soportadas son: o WMQ V6 SPARC Solaris 8 Solaris 9 o WMQ V7 x86-64 Solaris 10 Parmetros del kernel: SEMMNI 1024 SEMAEM 16384 SEMVMX 32767 SEMMNS 16384 SEMMSL 100 SEMOPM 100 SEMMNU 16384 SEMUME 256 SHMMAX 4294967295 SHMMNI 1024 SHMSEG (Solaris 8 only) 1024 rlim_fd_cur 10000 rlim_fd_max 10000 Deben de existir los file system para el almacenamiento del producto y de los datos que va a manejar. En el /opt/mqm se guardar toda la instalacin del producto. Los datos se almacenarn en el /var/mqm. Para el /opt/mqm se recomienda un tamao mnimo de: o 247MB para la instalacin de un WMQ v6 / WMQ v7 servidor El tamao del file system /var/mqm depender en gran medida de: 1. El nmero mximo de mensajes que manejar el gestor de colas de manea simultnea 2. El tamao medio que tendr los mensajes. A este tamao habr que sumarle 500bytes de tamao de cabecera 19

Procedimiento de Migracin a WMQ V6 / WMQ V7 3. El nmero de colas que tendr el gestor de colas 4. El tamao de los logs y trazas Se recomienda un dejar como mnimo un tamao de 50MB.

Procedimiento de migracin para Solaris

NOTA Este procedimiento es compatible para realizar las siguientes migraciones: Migracin desde WMQ v5.2 / WMQ v5.3 a WMQ v6 / WMQ v7 Migracin desde WMQ v6 a WMQ v7

Tareas previas
El procedimiento de migracin para WMQ consiste en una desinstalacin de la versin actual y una instalacin de la versin nueva. Por este motivo, y por fuera necesario hacer una marcha atrs, es recomendable tener el pack de instalacin de la versin actual as como los support packs instalados. A continuacin se muestra para cada versin los supports packs que se suprimen y de los que se debera tener una copia en caso de que estuviesen instalados en la versin actual del producto.
SupportPacs suprimidos en WMQ V6 y WMQ V7

SupportPac MA0C MA0R MA88 MACZ

Descripcin MQSeries Publish/subscribe WebSphere MQ transport for SOAP MQSeries Classes for Java and WebSphere MQ classes for Java Message Service MQSeries Client libraries for Solaris (64-bit)

20

Procedimiento de Migracin a WMQ V6 / WMQ V7

Migracin
1. Realizar un backup de los objetos de MQ. Para ello es necesario la utilidad saveqmgr: saveqmgr -m NombreGestor f fichero_salida 2. Realizar un backup de los permisos de los objetos. amqoamd -m NombreGestor -s > permisos.txt 3. Realizar un backup del directorio /var/mqm 4. Detener todas las aplicaciones que hagan uso de los gestores de colas. 5. Finalizar todas las actividades de MQ. Para ello con usuario mqm hacer: a. Parar el gestor de colas: endmqm i NombreGestor b. Parar el listener: endmqlsr m NombreGestor c. Realizar un ps ef|grep mqm para comprobar que no quedan procesos arrancados. Si los hubiera, matar todos los procesos con formato amq o runmq, ignorar los procesos amqi. 6. Desinstalar la versin anterior de WMQ Series y sus paquetes adicionales. a. Hacer login con root b. Desinstalar MQ usando la utilidad pkgrm: pkgrm mqm. c. Desinstalar paquetes adicionales que estuvieran instalados (por ejemplo MA88): pkgrm MA88 d. Una vez acabada la desinstalacin, comprobar que el directorio /opt/mqm no quedan ficheros. Si los hubiera, borrar dichos ficheros. 7. Instalar la nueva versin de WMQ Series a. b. c. d. Hacer login con root Ir a la ruta donde est el paquete de instalacin Ejecutar la licencia y aceptarla: ./mqlicense.sh Ejecutar el siguiente comando para comenzar la instalacin: pkgadd d e. Seleccionar el nmero del paquete mqm f. Si fuese necesario, seleccionar los paquetes adicionales que se necesiten. g. En las siguientes cuestiones, contestar siempre s: yes

Despus de finalizada la instalacin, WMQ tiene que reorganizar los objetos segn el formato de la nueva versin. Para ello, arrancar el gestor usando nicamente el comando strmqm GESTOR. ES

21

Procedimiento de Migracin a WMQ V6 / WMQ V7 IMPORTANTE NO ARRANCAR EL LISTENER EN EL PRIMER ARRANQUE 8. Comprobar que el gestor de colas ha arrancado verificando con el comando dspmq que se encuentra en estado running 9. Una vez comprobado que el gestor ha recreado todos objetos. Paramos de nuevo el gestor endmqm i GESTOR y lo arrancamos de nuevo. En este nuevo arranque se deben lanzar otros componentes complementarios de WMQ: Listener (runmqlsr), trigger monitor (runmqtrm), iniciador de canal (runmchi), etc.

Tareas finales
Para comprobar el correcto funcionamiento del producto, debemos realizar una serie de tareas post-migracin. 1. Comprobar con el comando dspmq que el gestor est en running 2. Comprobar que el listener est arrancado. Para ello podemos: a. Reliazar un ps ef | grep runmlsr, o bien, b. Hacer un netstat an|grep puerto 3. Revisar que los canales de tipo SENDER estn arrancados. Para ello realizar en la consola runmqsc un dis chstatus(*). Si algn canal estuviera en estado STOPPED, arrancarlo ejecutando start channel(NOMBRE_CANAL) 4. Encolar algunos mensajes de prueba. De especial atencin sern las colas que tengan algn tipo de evento asociado. Para dichas colas comprobar que al encolar el mensaje se ejecuta su evento. a. Encolar mensajes en una cola local: amqsput nombre_cola Comprobar que el mensaje ha sido encolado. Desde la consola runmqsc realizar: dis q(nombre_cola) curdepth. El contador deber ser mayor que cero. b. Encolar un mensaje en una cola local que tenga evento asociado: amqsput nombre_cola_con_evento. Comprobar que el evento ha saltado y se han realizado las operaciones esperadas. Si no fuera as, comprobar que el trigger monitor est arrancado ps ef|grep runmqtrm c. Encolar un mensaje en una cola remota: amqsput nombre_cola_remota. Verificar que el mensaje ha salido hacia el gestor destino.

22

Procedimiento de Migracin a WMQ V6 / WMQ V7 d. Recuperar un mensaje nombre_cola de una cola local: amqsget

5. Revisar que en el directorio /var/mqm/errors no se estn generando FDCs IMPORTANTE! Archivo JAR (Java archive) com.ibm.mqbind.jar El archivo JAR (Java archive) com.ibm.mqbind.jar se ha dejado de utilizar y ya no se proporciona con WebSphere MQ Versin 6.0 y versiones posteriores. Si las aplicaciones Java se han basado en el contenido de este archivo, necesitar cambiarlas para utilizar el archivo com.ibm.mq.jar a la hora de migrar WebSphere MQ.

Marcha atrs
En caso de ser necesario realizar una marcha atrs, ser necesario disponer del software de la versin anteriormente instalada, as como sus paquetes adicionales. El procedimiento de marcha atrs es muy parecido al de upgrade, con una fase de desinstalacin de la versin actual e instalacin de la versin que se quiere instalar. 1. Detener todas las aplicaciones que hagan uso de los gestores de colas. 2. Finalizar todas las actividades de MQ. Para ello con usuario mqm hacer: a. Parar el gestor de colas: endmqm i NombreGestor b. Parar el listener: endmqlsr m NombreGestor c. Realizar un ps ef|grep mqm para comprobar que no quedan procesos arrancados. Si los hubiera, matar todos los procesos con formato amq o runmq, ignorar los procesos amqi. 3. Desinstalar la versin anterior de WMQ Series y sus paquetes adicionales. a. Hacer login con root b. Desinstalar MQ usando la utilidad pkgrm: pkgrm mqm. c. Desinstalar paquetes adicionales que estuvieran instalados d. Una vez acabada la desinstalacin, comprobar que el directorio /opt/mqm no quedan ficheros. Si los hubiera, borrar dichos ficheros. 4. Instalar la nueva versin de WMQ Series a. b. c. d. Hacer login con root Ir a la ruta donde est el paquete de instalacin Ejecutar la licencia y aceptarla: ./mqlicense.sh Ejecutar el siguiente comando para comenzar la instalacin: pkgadd d 23

Procedimiento de Migracin a WMQ V6 / WMQ V7 e. Seleccionar el nmero del paquete mqm f. Si fuese necesario, seleccionar los paquetes adicionales que se necesiten. g. En las siguientes cuestiones, contestar siempre s: yes 5. Una vez terminada la instalacin, el gestor tiene que reorganizar los objetos. Para ello, el primer arranque del gestor de colas debe realizarse unicamente ejecutando el comando strmqm GESTOR. Comprobar que el gestor de colas ha arrancado verificando con el comando dspmq que se encuentra en estado running 6. Una vez comprobado que el gestor ha recreado todos objetos. Paramos de nuevo el gestor endmqm i GESTOR y arrancamos de nuevo. En este nuevo arranque se deben lanzar otros componentes complementarios de WMQ: Listener (runmqlsr), trigger monitor (runmqtrm), iniciador de canal (runmchi), etc. 7. Si fuera necesario instalar paquetes adicionales, (MA88 por ejemplo). instalarlos siguiendo el procedimiento de instalacin habitual descritos en los puntos del 4, 5, 7, 8 y 9 (exceptuando el punto 6 Desinstalacin) del procedimiento de migracin.

24

Procedimiento de Migracin a WMQ V6 / WMQ V7

Anexo I: Recuperacin de los objetos del QM

Para el caso en que pudiera haber algn tipo de problema con los objetos del gestor de colas a la hora de migrar o de realizar una marcha atrs, es importante realizar un backup de dichos objetos y de todos los permisos del gestor. Salvando estos datos, garantizaremos una recuperacin inmediata del gestor de colas.

Antes de migrar o actualizar el gestor

Como tarea previa a una migracin o aplicacin de algn tipo de Fix Pack, es necesario realizar un backup del gestor de colas. Con el gestor arrancado, realizar: 1. saveqmgr -m NombreGestor f fichero_backup. En el fichero fichero_backup se guardar toda la informacin sobre los objetos del gestor (definicin del gestor, definicin de canales, definicin de colas, etc). 2. amqoamd -m NombreGestor -s > permisos.txt En el fichero permisos.txt guardaremos todos los permisos de los objetos del gestor.

Aplicacin de los backups en caso de problema

En caso de que se encontrasen problemas con el gestor entero o con alguno de sus objetos (cola daada), podemos recuperar todos o parte de los objetos a partir de los backups previos. 1. Reconstruccin del gestor entero. Este caso aplica cuando el gestor se encuentra en estado running, pero TODOS sus objetos estn daados o no existen por algn fallo: i. Arrancar el gestor de colas: strmqm GESTOR ii. Reconstruir todos los objetos: runmqsc GESTOR < fichero_backup. iii. Aplicar los permisos de seguridad de los objetos: Para ellos basta con ejecutar el fichero ./permisos.txt. 2. Reconstruccin de un objeto. En ocasiones es posible encontrarse con objetos daados. Para la recuperacin de dicho objeto basta con: i. Arrancar el gestor de colas: strmqm GESTOR ii. Identificar en los logs (/var/mqm/qmgrs/GESTOR/errors/) el objeto daado. iii. Borrar el objeto daado. iv. Crear el objeto a partir de la deficin contenida en el fichero fichero_bakcup 25

Procedimiento de Migracin a WMQ V6 / WMQ V7 v. Aplicar sus permisos ejecutando la lnea setmqaut del objeto contenida en el fichero permisos.txt.

NOTA: Tambin, si se ha hecho un backup del /var/mqm, es posible recuperar el gestor recuperando dicho backup.

26

Procedimiento de Migracin a WMQ V6 / WMQ V7

Anexo II: rbol de directorios WMQ para UNIX

27