Utilice el mandato mqsimigratecomponents para migrar un componente de una versión instalada anteriormente del producto a otra versión en el mismo sistema.
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 retrotraer un intermediario de la versión 8.0 a una versión anterior para revertir los efectos de la migración a una versión superior. 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 a una versión superior, y las actualizaciones que haya realizado después de la migración no se ven reflejadas en la base de datos asociada al intermediario en la versión anterior. Para poder utilizar el intermediario en la versión anterior, debe conservar la base de datos del intermediario relevante.
Al restaurar un intermediario a la versión 7.0, se mantendrán los cambios que haya realizado en el estado del intermediario que sean compatibles con la versión 7.0. 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 del producto instalado que sea la más reciente, 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.
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 utilizado por el mandato mqsisetdbparms. Los valores los utiliza el intermediario para acceder a bases de datos de usuario para las que no se han 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.
.-| 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-'
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.
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.
(Opcional) Imprimir menos mensajes de estado durante la operación.
(Opcional) Realizar sólo tareas de WebSphere MQ.
Esta opción sólo es válida para la migración a la versión 8.0 desde una versión anterior. Si especifica este parámetro para la migración a una versión anterior, se pasa por alto; los cambios realizados al estado del intermediario no se pueden migrar y aplicarse a la base de datos que pertenece al intermediario que está en la versión anterior.
-3 sólo es válido para la migración a la versión 8.0 desde una versión anterior.
(Necesario) El nombre del componente que se ha de migrar.
En los sistemas Windows XP y Windows Server 2003, el ID de usuario que se utiliza para ejecutar este mandato debe ser miembro del grupo Administradores en el sistema local.
Esta consola comienza con el entorno correcto mqsiprofile desde el que se pueden ejecutar los mandatos que requieren elevación.
Si no ejecuta el mandato desde una consola de mandatos privilegiada, el mandato no se procesará satisfactoriamente.
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 dividida, el ID de usuario debe poder siempre leer el registro del producto.
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.
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