guía de migracion mq series

27
Procedimiento de Migración a WMQ V6 / WMQ V7 1 Gerencia de Soporte Técnico de Productos y Back- End Dirección de Producción GUÍA DE MIGRACIÓN A Websphere MQ V6 y Websphere MQ V7 REALIZADO Javier Rodríguez REVISADO

Upload: falsedad

Post on 27-Nov-2015

177 views

Category:

Documents


6 download

TRANSCRIPT

Page 1: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

1

Gerencia de Soporte Técnico de Productos y Back-End

Dirección de Producción

GUÍA DE MIGRACIÓN A

Websphere MQ V6 y Websphere MQ V7

REALIZADO Javier Rodríguez

REVISADO

Page 2: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

2

Versión Descripción de la Modificación Fecha

1.0 Versión Inicial

Page 3: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

3

Indice de Contenido Introducción ...................................................................................................................... 4 Documentación ................................................................................................................. 4 Versiones disponibles ....................................................................................................... 4 Migración a WMQ V6 / WMQ V7 para HP-UX ............................................................. 5

Prerrequisitos ................................................................................................................ 5 Procedimiento de migración para HP-UX .................................................................... 6

Migración a WMQ V6 / WMQ V7 para AIX ................................................................ 12 Prerrequisitos .............................................................................................................. 12 Procedimiento de migración para AIX ....................................................................... 13

Migración a WMQ V6 / WMQ V7 para Solaris ............................................................ 19 Prerrequisitos .............................................................................................................. 19 Procedimiento de migración para Solaris ................................................................... 20

Anexo I: Recuperación de los objetos del QM ............................................................... 25 Anexo II: Árbol de directorios WMQ para UNIX ......................................................... 27

Page 4: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

4

Introducción Este documento tiene como finalidad proporcionar una operativa básica para realizar el upgrade del producto Websphere MQ Series a sus versiones de soporte (WMB V6 y WMQ V7) por parte de IBM. También se hace referencia a la migración a WMQ v5.3 por estar instalado en varias plataformas dentro de la línea de negocio de sistemas de red. La versión del Sistema Operativo puede ser un factor límite que impida la subida de versión 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

Documentación

• Websphere MQ V6

o Quick Beginnings for HPUX v6

o Quick Beginnings for Solaris v6

o Quick Beginnings for AIX v6

o Quick Beginnings for Windows v6

• Websphere MQ V7

o Quick Beginnings for HPUX v7

o Quick Beginnings for Solaris v7

o Quick Beginnings for AIX v7

o Quick Beginnings for Windows v7

Versiones disponibles

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

Page 5: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

5

Migración a WMQ V6 / WMQ V7 para HP-UX

Prerrequisitos

• Se necesita que exista el usuario y grupo “mqm”. Para realizar la migración también 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 más Dec. 2003 Quality

Pack • HP-UX 11i v2 (11.23) 64 bits

� HP-UX Itanium

• HP-UX 11i v2 (11.23) 64 bits

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)

• Configuración del kernel:

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

Page 6: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

6

o WMQ V7

shmmax 536870912 semmni 1024 (semmni < semmns) shmseg 1024 semmnu 16384 shmmni 1024 semume 256 semaem 16384 max_thread_proc 66 semvmx 32767 maxfiles 10000 semmns 16384 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 instalación del producto. Los datos se almacenarán en el /var/mqm. Para el /opt/mqm se recomienda un tamaño mínimo de:

o 325MB para la instalación de un WMQ v6 / WMQ v7 servidor

El tamaño del file system /var/mqm dependerá en gran medida de:

1. El número máximo de mensajes que manejará el gestor de colas de manea simultánea

2. El tamaño medio que tendrá los mensajes. A esta tamaño habrá que sumarle 500bytes de tamaño de cabecera

3. El número de colas que tendrá el gestor de colas 4. El tamaño de los logs y trazas

Se recomienda un dejar como mínimo un tamaño de 50MB.

Procedimiento de migración para HP-UX NOTA Este procedimiento es compatible para realizar las siguientes migraciones:

• Migración desde WMQ v5.2 / WMQ v5.3 a WMQ v6 / WMQ v7 • Migración desde WMQ v6 a WMQ v7

Tareas previas

• El procedimiento de migración para WMQ consiste en una desinstalación de la

versión actual y una instalación de la versión nueva. Por este motivo, y por fuera necesario hacer una marcha atrás, es recomendable tener el pack de instalación de la versión actual así como los support packs instalados.

Page 7: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

7

A continuación se muestra para cada versión los supports packs que se suprimen y de los que se debería tener una copia en caso de que estuviesen instalados en la versión actual del producto.

SupportPacs suprimidos en WMQ V6

SupportPac Descripción

MA0C MQSeries® Publish/subscribe

MA0R WebSphere MQ transport for SOAP

MA88 MQSeries Classes for Java and WebSphere MQ classes for Java Message Service

MACZ MQSeries Client libraries for HP-UX (64-bit)

SupportPacs suprimidos en WMQ V7

SupportPac Descripción

MA0Y WebSphere MQ Bridge para HTTP

MA6P WebSphere MQ - bibliotecas XA para utilizarlas con TX-series en HP-UX para IPF

Migración

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”.

Page 8: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

8

6. Desinstalar la versión anterior de WMQ Series y sus paquetes adicionales.

a. Hacer login con “root” b. Desinstalar MQ: swremove MQSERIES c. Desinstalar paquetes adiciones: swremove “paquete” d. Comprobar que el directorio “/opt/mqm” no quedan

ficheros. Si los hubiera, borrar dichos ficheros.

7. Instalar la nueva versión de WMQ Series

a. Hacer login con “root” b. Ir a la ruta donde está el paquete de instalación c. Ejecutar la licencia y aceptarla: ./mqlicense.sh d. Ejecutar el siguiente comando para comenzar la instalación:

swinstall -s “archivo de instalación”

• Si se desea instalar todos los componentes seleccionar: Actions > Install

• (Opción recomendada) Si no se desea instalar todos los componentes seleccionar: Actions > Open

Item. Seleccionar los componentes a instalar. Para instalar un servidor, cómo mínimo hay que seleccionar “Runtime y Servidor”. Volvemos al menú inicial y marcamos Actions > Install

e. La instalación comienza. Se mostrará un mensaje de instalación completada cuando finalice.

8. Después de finalizada la instalación, WMQ tiene que reorganizar los

objetos según el formato de la nueva versión. 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-migración.

Page 9: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

9

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 están arrancados. Para ello

realizar en la consola “runmqsc” un “dis chstatus(*)”. Si algún canal estuviera en estado STOPPED, arrancarlo ejecutando “start channel(NOMBRE_CANAL)”

4. Encolar algunos mensajes de prueba. De especial atención serán las colas

que tengan algún 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 de una cola local: “amqsget

nombre_cola”

5. Revisar que en el directorio “/var/mqm/errors” no se estén 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 Versión 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.

Page 10: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

10

Marcha atrás En caso de ser necesario realizar una marcha atrás, será necesario disponer del software de la versión anteriormente instalada, así como sus paquetes adicionales. El procedimiento de marcha atrás es muy parecido al de upgrade, con una fase de desinstalación de la versión actual e instalación de la versión 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 versión anterior de WMQ Series y sus paquetes

adicionales.

a. Hacer login con “root” b. Desinstalar MQ: swremove MQSERIES c. Desinstalar paquetes adiciones: swremove “paquete” d. Comprobar que el directorio “/opt/mqm” no quedan

ficheros. Si los hubiera, borrar dichos ficheros.

4. Instalar la nueva versión de WMQ Series

a. Hacer login con “root” b. Ir a la ruta donde está el paquete de instalación c. Ejecutar la licencia y aceptarla: ./mqlicense.sh d. Ejecutar el siguiente comando para comenzar la instalación:

swinstall -s “archivo de instalación”

• Si se desea instalar todos los componentes seleccionar: Actions > Install

• (Opción recomendada) Si no se desea instalar todos los componentes seleccionar: Actions > Open

Item. Seleccionar los componentes a instalar. Para instalar un servidor, cómo mínimo hay que seleccionar “Runtime y Servidor”. Volvemos al menú inicial y marcamos Actions > Install

5. Una vez terminada la instalación, el gestor tiene que reorganizar los

objetos. Para ello, el primer arranque del gestor de colas debe realizarse unicamente ejecutando el comando “strmqm GESTOR”.

Page 11: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

11

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 instalación habitual descritos en los puntos del 4, 5, 7, 8 y 9 (exceptuando el punto 6 – Desinstalación) del procedimiento de migración.

Page 12: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

12

Migración a WMQ V6 / WMQ V7 para AIX

Prerrequisitos

• Se necesita que exista el usuario y grupo “mqm”. Para realizar la migración también 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 parámetros del kernel se actualizan automáticamente.

• 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 instalación del producto. Los datos se almacenarán en el /var/mqm. Para el /usr/mqm se recomienda un tamaño mínimo de:

o 325MB para la instalación de un WMQ v6 / WMQ v7 servidor

El tamaño del file system /var/mqm dependerá en gran medida de:

1. El número máximo de mensajes que manejará el gestor de colas de manea simultánea

2. El tamaño medio que tendrá los mensajes. A este tamaño habrá que sumarle 500bytes de tamaño de cabecera

3. El número de colas que tendrá el gestor de colas 4. El tamaño de los logs y trazas

Se recomienda un dejar como mínimo un tamaño de 50MB.

• Para las versiones WMQ v6 y WMQ v7 es posible que adicionalmente se tenga que configurar los siguientes parámetros del SO:

o Aumentar el número 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”

Page 13: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

13

Procedimiento de migración para AIX NOTA Este procedimiento es compatible para realizar las siguientes migraciones:

• Migración desde WMQ v5.2 / WMQ v5.3 a WMQ v6 / WMQ v7 • Migración desde WMQ v6 a WMQ v7

Tareas previas

• El procedimiento de migración para WMQ consiste en una desinstalación de la

versión actual y una instalación de la versión nueva. Por este motivo, y por fuera necesario hacer una marcha atrás, es recomendable tener el pack de

instalación de la versión actual así como los support packs instalados.

A continuación se muestra para cada versión los supports packs que se suprimen y de los que se debería tener una copia en caso de que estuviesen instalados en la versión actual del producto.

SupportPacs suprimidos en WMQ V6

SupportPac Descripción

MA0C MQSeries® Publish/subscribe

MA0R WebSphere MQ transport for SOAP

MA88 MQSeries Classes for Java and WebSphere MQ classes for Java Message Service

MACZ MQSeries Client libraries for AIX (64-bit)

SupportPacs suprimidos en WMQ V7

SupportPac Descripción

MA0Y WebSphere MQ Bridge para HTTP

Migración

1. Realizar un backup de los objetos de MQ. Para ello es necesario la utilidad “saveqmgr”:

� saveqmgr -m NombreGestor –f fichero_salida

Page 14: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

14

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 versión 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:

“Software Installation and Maintenance �

Software Maintenance and Utilities �

Remove Installed Software” d. Pulsar sobre “F4” sobre la opcíón “SOFTWARE” e. Seleccionar los ficheros a desinstalar. Serán aquellos que

comienzan por la palabra “mqm”. Presionar “Enter”. f. Presionar “Enter” sobre “Remove Installed

Software”. g. Una vez acabada la desinstalación, comprobar que el

directorio “/opt/mqm” no quedan ficheros. Si los hubiera, borrar dichos ficheros.

7. Instalar la nueva versión 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.

Page 15: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

15

d. Seleccionar los componentes a instalar. Como mínimo 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 instalación.

8. Después de finalizada la instalación, WMQ tiene que reorganizar los

objetos según el formato de la nueva versión. 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-migración.

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 están arrancados. Para ello

realizar en la consola “runmqsc” un “dis chstatus(*)”. Si algún canal estuviera en estado STOPPED, arrancarlo ejecutando “start channel(NOMBRE_CANAL)”

4. Encolar algunos mensajes de prueba. De especial atención serán las colas

que tengan algún 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”

Page 16: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

16

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 de una cola local: “amqsget

nombre_cola”

5. Revisar que en el directorio “/var/mqm/errors” no se estén generando FDCs

Marcha atrás En caso de ser necesario realizar una marcha atrás, será necesario disponer del software de la versión anteriormente instalada, así como sus paquetes adicionales. El procedimiento de marcha atrás es muy parecido al de upgrade, con una fase de desinstalación de la versión actual e instalación de la versión 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 versión anterior de WMQ Series y sus paquetes adicionales.

¡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 Versión 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.

Page 17: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

17

a. Hacer login con “root” b. Desinstalar MQ usando la utilidad “smit” c. Desplegar el panel con la siguiente secuencia:

“Software Installation and Maintenance �

Software Maintenance and Utilities �

Remove Installed Software” d. Pulsar sobre “F4” sobre la opcíón “SOFTWARE” e. Seleccionar los ficheros a desinstalar. Serán aquellos que

comienzan por la palabra “mqm”. Presionar “Enter”. f. Presionar “Enter” sobre “Remove Installed

Software”. g. Una vez acabada la desinstalación, comprobar que el

directorio “/opt/mqm” no quedan ficheros. Si los hubiera, borrar dichos ficheros.

3. Instalar la nueva versión 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 mínimo 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 instalación.

4. Después de finalizada la instalación, WMQ tiene que reorganizar los

objetos según el formato de la nueva versión. 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

Page 18: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

18

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 instalación habitual descritos en los puntos del 4, 5, 7, 8 y 9 (exceptuando el punto 6 – Desinstalación) del procedimiento de migración.

Page 19: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

19

Migración a WMQ V6 / WMQ V7 para Solaris

Prerrequisitos

• Se necesita que exista el usuario y grupo “mqm”. Para realizar la migración también 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

• Parámetros 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 instalación del producto. Los datos se almacenarán en el /var/mqm. Para el /opt/mqm se recomienda un tamaño mínimo de:

o 247MB para la instalación de un WMQ v6 / WMQ v7 servidor

El tamaño del file system /var/mqm dependerá en gran medida de:

1. El número máximo de mensajes que manejará el gestor de colas de manea simultánea

2. El tamaño medio que tendrá los mensajes. A este tamaño habrá que sumarle 500bytes de tamaño de cabecera

Page 20: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

20

3. El número de colas que tendrá el gestor de colas 4. El tamaño de los logs y trazas

Se recomienda un dejar como mínimo un tamaño de 50MB.

Procedimiento de migración para Solaris

NOTA Este procedimiento es compatible para realizar las siguientes migraciones:

• Migración desde WMQ v5.2 / WMQ v5.3 a WMQ v6 / WMQ v7 • Migración desde WMQ v6 a WMQ v7

Tareas previas

• El procedimiento de migración para WMQ consiste en una desinstalación de la

versión actual y una instalación de la versión nueva. Por este motivo, y por fuera necesario hacer una marcha atrás, es recomendable tener el pack de

instalación de la versión actual así como los support packs instalados.

A continuación se muestra para cada versión los supports packs que se suprimen y de los que se debería tener una copia en caso de que estuviesen instalados en la versión actual del producto.

SupportPacs suprimidos en WMQ V6 y WMQ V7

SupportPac Descripción

MA0C MQSeries® Publish/subscribe

MA0R WebSphere MQ transport for SOAP

MA88 MQSeries Classes for Java and WebSphere MQ classes for Java Message Service

MACZ MQSeries Client libraries for Solaris (64-bit)

Page 21: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

21

Migración

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 versión 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 desinstalación, comprobar que el directorio

“/opt/mqm” no quedan ficheros. Si los hubiera, borrar dichos ficheros.

7. Instalar la nueva versión de WMQ Series

a. Hacer login con “root” b. Ir a la ruta donde está el paquete de instalación c. Ejecutar la licencia y aceptarla: ./mqlicense.sh d. Ejecutar el siguiente comando para comenzar la instalación:

“pkgadd –d” e. Seleccionar el número del paquete “mqm” f. Si fuese necesario, seleccionar los paquetes adicionales que se

necesiten. g. En las siguientes cuestiones, contestar siempre sí: “yes”

Después de finalizada la instalación, WMQ tiene que reorganizar los objetos según el formato de la nueva versión. Para ello, arrancar el gestor usando únicamente el comando “strmqm GESTOR”. ES

Page 22: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

22

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-migración.

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 están arrancados. Para ello realizar en la consola “runmqsc” un “dis chstatus(*)”. Si algún canal estuviera en estado STOPPED, arrancarlo ejecutando “start channel(NOMBRE_CANAL)”

4. Encolar algunos mensajes de prueba. De especial atención serán las colas

que tengan algún 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.

Page 23: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

23

d. Recuperar un mensaje de una cola local: “amqsget nombre_cola”

5. Revisar que en el directorio “/var/mqm/errors” no se estén

generando FDCs

Marcha atrás En caso de ser necesario realizar una marcha atrás, será necesario disponer del software de la versión anteriormente instalada, así como sus paquetes adicionales. El procedimiento de marcha atrás es muy parecido al de upgrade, con una fase de desinstalación de la versión actual e instalación de la versión 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 versión 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 desinstalación, comprobar que el directorio

“/opt/mqm” no quedan ficheros. Si los hubiera, borrar dichos ficheros.

4. Instalar la nueva versión de WMQ Series

a. Hacer login con “root” b. Ir a la ruta donde está el paquete de instalación c. Ejecutar la licencia y aceptarla: ./mqlicense.sh d. Ejecutar el siguiente comando para comenzar la instalación:

“pkgadd –d”

¡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 Versión 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.

Page 24: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

24

e. Seleccionar el número 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 instalación, 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 instalación habitual descritos en los puntos del 4, 5, 7, 8 y 9 (exceptuando el punto 6 – Desinstalación) del procedimiento de migración.

Page 25: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

25

Anexo I: Recuperación de los objetos del QM Para el caso en que pudiera haber algún tipo de problema con los objetos del gestor de colas a la hora de migrar o de realizar una marcha atrás, es importante realizar un backup de dichos objetos y de todos los permisos del gestor. Salvando estos datos, garantizaremos una recuperación inmediata del gestor de colas. Antes de migrar o actualizar el gestor Como tarea previa a una migración o aplicación de algún 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 información sobre los objetos del gestor (definición del gestor, definición de canales, definición de colas, etc). 2. amqoamd -m NombreGestor -s > permisos.txt En el fichero “permisos.txt” guardaremos todos los permisos de los objetos del gestor.

Aplicación 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 dañada), podemos recuperar todos o parte de los objetos a partir de los backups previos.

1. Reconstrucción del gestor entero. Este caso aplica cuando el gestor se encuentra en estado “running”, pero TODOS sus objetos están dañados o no existen por algún 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. Reconstrucción de un objeto.

En ocasiones es posible encontrarse con objetos dañados. Para la recuperación 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 dañado. iii. Borrar el objeto dañado. iv. Crear el objeto a partir de la defición contenida en el fichero

“fichero_bakcup”

Page 26: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

26

v. Aplicar sus permisos ejecutando la línea “setmqaut” del objeto contenida en el fichero “permisos.txt”.

NOTA: También, si se ha hecho un backup del “/var/mqm”, es posible recuperar el gestor recuperando dicho backup.

Page 27: Guía de Migracion MQ Series

Procedimiento de Migración a WMQ V6 / WMQ V7

27

Anexo II: Árbol de directorios WMQ para UNIX