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 IBM® Integration Bus Versión 9.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 IBM Integration Bus Versión 9.0.

También puede utilizar el mandato mqsimigratecomponents para devolver un intermediario de IBM Integration Bus Versión 9.0 a WebSphere Message Broker Versión 8.0 o WebSphere Message Broker Versión 7.0 para invertir los efectos de la migración hacia adelante. No puede utilizar el mandato mqsimigratecomponents para devolver un intermediario de IBM Integration Bus Versión 9.0 a WebSphere Message Broker Versión 6.1. Puede restaurar un entorno WebSphere Message Broker Versión 6.1 sólo a partir de una copia de seguridad.

Cuando se restaura un intermediario a la Versión 8.0 o a la Versión 7.0, los cambios que haya realizado en el estado del intermediario que sean compatibles con su versión de destino se mantienen. Sin embargo, los cambios que se hayan realizado que no sean compatibles con su versión de destino no se reflejan 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 en IBM Integration 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 a la Versión 9.0 desde una versión anterior.

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 9.0, utilice el parámetro -1 antes de los parámetros -2 o -3.
  • Cuando realice una migración de la Versión 9.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 a la Versión 9.0.

-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 a la Versión 9.0 desde una versión anterior.

-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 9.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 Finalidad para conocer 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 9.0 a una versión anterior, el parámetro -t será obligatorio.
  • Consulte Finalidad para conocer 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 siempre debe poder leer del 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 de WebSphere MQ para abrir las colas 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 8.0 a la Versión 9.0:

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

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

mqsimigratecomponents MYBROKER -t 8.0.0.2
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Última actualización:
        
        Última actualización: 2013-07-16 12:51:21


Tema de referenciaTema de referencia | IBM Integration Bus Versión 9.0.0.0 | an26150_