WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Mandato mqsimigratecomponents

Utilice el mandato mqsimigratecomponents para migrar un componente de una versión del producto a otra versión en el mismo sistema.

Plataformas soportadas

  • Windows.
  • Sistemas Linux y UNIX.
  • z/OS. Ejecute este mandato personalizando y sometiendo BIPMGCMP.

Finalidad

Migrar componentes a WebSphere Message Broker Versión 8.0 desde una versión anterior:
  • Si realiza una migración de la Versión 6.1, debe tener instalada la Versión 6.1.0.3 (fixpack 3) o posterior.

    Si está utilizando WebSphere Application Server con WebSphere Message Broker o si dispone de aplicaciones de publicación/suscripción que utilicen la opción SubIdentity, deberá actualizar WebSphere Message Broker Versión 6.1 por el fixpack 4 antes de poder migrar a WebSphere Message Broker Versión 8.0.

También puede utilizar el mandato mqsimigratecomponents para restaurar un intermediario de la WebSphere Message Broker Versión 8.0 a WebSphere Message Broker Versión 7.0 o Versión 6.1 para revertir los efectos de la migración hacia adelante. Al restaurar un intermediario a la Versión 6.1, el intermediario se restaura con la configuración que estaba activa en el momento de la migración hacia adelante, y las actualizaciones que haya realizado después de la migración no quedan reflejadas en la base de datos que está asociada con el intermediario en la versión anterior. Debe conservar la base de datos de intermediario relevante para poder utilizar el intermediario en la versión anterior.

Cuando restaure un intermediario a la versión 7.0, los cambios que haya realizado en el estado del intermediario que sean compatibles con la versión 7.0 se conservarán. Sin embargo, los cambios que haya realizado que no sean compatibles con la versión 7.0 no se verán reflejados en el estado del intermediario restaurado, lo que podría causar errores.

Debe ejecutar este mandato desde la versión posterior del producto, independientemente de si es la versión de origen o la versión de destino.

Para emitir este mandato satisfactoriamente, debe tener una instalación del producto tanto en la versión de destino como en la de origen, con el código de componente necesario instalado.

Antes de iniciar la migración, detenga el intermediario y todas las sesiones de depuración activas de WebSphere Message Broker Toolkit. No puede migrar flujos de mensajes que se estén depurando.

Especifique las opciones apropiadas en este mandato para realizar una de las acciones siguientes:
  • Comprobar que un componente es adecuado para la migración necesaria, sin cambiar dicho componente (-c).
  • Mover un componente a una versión diferente, total o parcialmente (-s y -t).
  • Deshacer un paso de migración anómalo (-u).
  • Verificar si un traslado se ha realizado de forma satisfactoria (-v).

Notas de uso

Si ha especificado un ID de usuario y una contraseña de origen de datos en el mandato mqsicreatebroker correspondiente al intermediario que está migrando, los valores de estos parámetros también se migrarán y se guardarán en el formato que se utiliza en el mandato mqsisetdbparms. Los valores los utiliza el intermediario para acceder a las bases de datos de usuario para las cuales no haya establecido valores alternativos utilizando el mandato mqsisetdbparms. Tras la migración, si desea cambiar los ID de usuario o las contraseñas que el intermediario utiliza para acceder a las bases de datos, mqsisetdbparms.

Si actualiza los valores de ID de usuario y contraseña y migra el intermediario a la versión anterior, los nuevos valores también se migrarán al intermediario original.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
                          .-| Move |---.   
>>-mqsimigratecomponents--+-| Check |--+------------------------>
                          +-| Undo |---+   
                          '-| Verify |-'   

>----NombreComponente----+-----+-------------------------------><
                         '- -q-'   

Check

|-- -c --+--------------------+--+---------------------+--------|
         '- -s--VersiónOrigen-'  '- -t--VersiónDestino-'   

Move

   .-------------.                           
   V             |                           
|----+---------+-+--+--------------------+---------------------->
     +- -1-----+    '- -s--VersiónOrigen-'   
     +- -2-----+                             
     |     (1) |                             
     '- -3-----'                             

>--+---------------------+--------------------------------------|
   '- -t--VersiónDestino-'   

Undo

        .-------------.                       
        V             |                       
|-- -u----+- -1-----+-+-- -s--VersiónOrigen--------------------->
          +- -2-----+                         
          |     (1) |                         
          '- -3-----'                         

>-- -t--VersiónDestino------------------------------------------|

Verify

|-- -v--+---------------------+---------------------------------|
        '- -t--VersiónDestino-'   

Notas:
  1. Válido sólo para la migración hacia adelante a la Versión 8.0

Parámetros

-c
(Opcional) Comprobar un componente especificado antes de la migración para asegurarse de que se cumplen las condiciones siguientes:
  • La versión detectada automáticamente del intermediario coincide con cualquier versión que esté especificada en la línea de mandatos.
  • Las tablas de base de datos a las que se accede en un release anterior no contienen ninguna fila que estén indexada incorrectamente.

Puede comprobar un componente en ejecución. La comprobación no afecta al componente, a parte de una ligera degradación del rendimiento.

El mandato de comprobación se ejecuta correctamente o falla e imprime un mensaje que indica si la migración se realizará satisfactoriamente, pero no se realiza ninguna modificación durante el proceso.

Los parámetros -c y -v se excluyen mutuamente. Además, si especifica uno de estos parámetros, no podrá especificar ningún otro parámetro cuando ejecute este mandato.

-v
(Opcional) Comprobar un componente especificado después de la migración para asegurarse de que se cumplen las condiciones siguientes:
  • El registro está en el formato correcto para la nueva versión.
  • Las colas correctas existen para la versión nueva.

Los parámetros -c y -v se excluyen mutuamente. Además, si especifica uno de estos parámetros, no podrá especificar ningún otro parámetro cuando ejecute este mandato.

-q

(Opcional) Imprimir menos mensajes de estado durante la operación.

-1
(Opcional) Realizar sólo tareas de registro y de sistema de archivos.
  • Al migrar a Versión 8.0, utilice el parámetro -1 antes de los parámetros -2 o -3.
  • Cuando realice una migración hacia atrás de la Versión 8.0 a una versión anterior, utilice el parámetro -2 antes del parámetro -1.
-2

(Opcional) Realizar sólo tareas de WebSphere MQ.

-3
(Opcional) Realizar sólo tareas de base de datos.

Esta opción sólo es válida para la migración hacia adelante a la Versión 8.0. Si especifica este parámetro para la migración hacia atrás, se pasa por alto; los cambios que se hayan realizado en el estado del intermediario no se pueden migrar hacia atrás y aplicarse a la base de datos que es propiedad del intermediario en la versión anterior.

-u
(Opcional) Deshacer un paso de migración fallido; también debe especificar al menos uno de los valores -1, -2 o -3. Utilice esta opción únicamente cuando la migración haya fallado y también cuando haya fallado la recuperación automática (por ejemplo, si se produce una anomalía durante la migración dividida).

-3 sólo es válido para la migración hacia adelante a la Versión 8.0.

-s VersiónOrigen
(Opcional) La versión anterior del componente.
  • Si no se especifica, este valor se detecta automáticamente.
  • Cuando realice la migración dividida a la Versión 8.0, el parámetro -s es obligatorio después de ejecutar el mandato mqsimigratecomponents con el parámetro -1, como se muestra en el ejemplo de migración dividida.
  • Consulte en el apartado Finalidad las restricciones para los números de versión del producto que están soportados.

-t VersiónDestino
(Opcional) La versión de destino del componente.
  • Si no se especifica, se supone que este valor es la versión actual.
  • Cuando realice la migración dividida de la Versión 8.0 a una versión anterior, el parámetro -t será obligatorio.
  • Consulte en el apartado Finalidad las restricciones para los números de versión del producto que están soportados.

NombreComponente

(Necesario) El nombre del componente que se ha de migrar.

Autorización

Para obtener información sobre las autorizaciones específicas de cada plataforma, consulte los temas siguientes: Si ha habilitado la seguridad de administración del intermediario, también debe establecer la autorización que se detalla en Tareas y autorizaciones para la seguridad de administración.

El mandato mqsimigratecomponents actualiza el registro, el sistema de archivos y las definiciones de WebSphere MQ.

Si el ID de usuario utilizado para ejecutar este mandato no tiene autorización para realizar todos estos pasos, puede ejecutar el mandato por partes. Para obtener el resultado final, cada parte la puede realizar un usuario diferente con la autorización necesaria. Este enfoque se denomina migración dividida y se realiza utilizando los parámetros -1, -2 y -3.

Si ejecuta la migración en un solo paso, el ID de usuario debe poder completar las acciones siguientes:
  • Escribir en el registro y el sistema de archivos del producto
  • Modificar definiciones de cola
  • Leer de la base de datos que está asociada al intermediario, si está migrando desde Versión 6.1

Si ejecuta la migración dividida, el ID de usuario debe poder siempre leer el registro del producto.

Si va a realizar una migración dividida del registro con versiones anteriores, la comprobación de integridad que verifica los niveles de WebSphere MQ y de la base de datos requiere que el ID de usuario tenga los siguientes derechos:
  • Autorización SELECT en las tablas de base de datos de intermediario, si está migrando desde la Versión 6.1
  • Autorización de WebSphere MQ para abrir las colas de SYSTEM.BROKER.*.
La siguiente autorización específica para cada paso es necesaria para que la migración se realice de forma satisfactoria:
  • -1 requiere que se pueda escribir en el registro y el sistema de archivos del producto, SELECT de las tablas de base de datos de intermediario si está migrando desde la Versión 6.1, y abrir las colas SYSTEM.BROKER.*
  • -2 requiere que se puedan modificar las definiciones de colas
  • -3 requiere la capacidad de leer de las bases de datos que están asociadas al intermediario, si está migrando desde la Versión 6.1

Respuestas

Este mandato puede generar muchas posibles respuestas, dependiendo de los resultados de las diversas operaciones. Este mandato se diferencia de otros mandatos en el modo en que produce los mensajes: éstos se visualizan cuando se generan, en lugar de producirse en un proceso por lotes al final del programa.

Al migrar tablas de base de datos desde la Versión 6.1, z/OS produce más salida que los sistemas distribuidos. Utilice el parámetro -q para reducir el número de mensajes visualizados.

Ejemplos

El ejemplo siguiente muestra una migración dividida de la versión 7.0 a la Versión 8.0:

mqsimigratecomponents BROKER1 -1
mqsimigratecomponents BROKER1 -2
mqsimigratecomponents BROKER1 -3

El ejemplo siguiente muestra una migración de retroceso de la Versión 8.0 a la versión 7.0:

mqsimigratecomponents MYBROKER -t 7.0.0.3
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:09


Tema de referenciaTema de referencia | Versión 8.0.0.5 | an26150_