Mandato mqsimigratecomponents

Utilice el mandato mqsimigratecomponents para migrar un componente de una versión instalada anteriormente del producto a otra versión en el mismo sistema para prepararlo para su participación en el dominio de intermediarios de la versión de destino.

Plataformas soportadas

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

Finalidad

Migrar componentes a WebSphere Event Broker Versión 6.0 desde Versión 2.1 o desde Versión 5.0.
  • Para la Versión 2.1 del producto, la Versión 2.1 CSD02 (2.1.0.3) es el release más antiguo del producto que se soporta.
  • Para la Versión 5.0 del producto, la Versión 5.0.0.4 (FixPack 4) es el release más antiguo del producto que se soporta.

También puede utilizar este mandato para devolver un componente de una versión posterior a una versión anterior para invertir los efectos de la migración a versiones posteriores.

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.

Debe tener una instalación del producto que esté en la versión necesaria, con el código de componente necesario instalado, para emitir este mandato satisfactoriamente.

Antes de iniciar la migración, detenga las sesiones de depuración activas del Kit de herramientas de Message Brokerso Centro de control Versión 2.1. 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 un componente, sin realizar cambios, para asegurarse de que el componente es adecuado para la migración necesaria (-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 que el traslado se ha realizado correctamente (-v).
Si está utilizando el mandato mqsimigratecomponents para migrar un intermediario que utiliza Sybase para la base de datos de intermediario, debe modificar la base de datos realizando las acciones siguientes:
  1. Inicie la sesión en ISQL utilizando una cuenta de administrador del sistema.
  2. Emita la siguiente serie de mandatos:
    1> use master
    2> go
    1> sp_dboption "BROKER1","ddl in tran",TRUE
    2> go
    Database option 'ddl in tran' turned ON for database 'BROKER1'.
    Run the CHECKPOINT command in the database that was changed.
    (return status = 0)
    1> use BROKER1
    2> go
    1> checkpoint
    2> go
    donde BROKER1 es el nombre de la base de datos de intermediario de Sybase.

Sintaxis

Parámetros

-c
(Opcional) Comprobar un componente especificado antes de la migración, para asegurarse de que:
  • La versión detectada automáticamente del intermediario coincide con la versión especificada en la línea de mandatos.
  • Los grupos de ejecución de 64 bits no se soportan si está migrando de la Versión 6.0 a un release anterior. .
  • Las tablas de base de datos que se deben copiar de un release anterior no contienen filas que estén indexadas incorrectamente.

Puede comprobar un componente en ejecución. La comprobación no afecta al componente, a parte de un ligero impacto en el rendimiento. En sistemas Linux y UNIX, debe migrar el archivo de configuración (el archivo en el que se han definido los orígenes de datos, por ejemplo .odbc.ini) antes de ejecutar la comprobación, porque el mandato de comprobación debe poder acceder a la base de datos del intermediario.

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.

-v
(Opcional) Comprobar un componente especificado después de la migración, para asegurarse de que:
  • La tablas de base de datos y colas correctas existen para la versión especificada.
  • El registro está en el formato correcto para la versión especificada.
-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 6.0, utilice el parámetro -1 antes de los parámetros -2 o -3.
  • Cuando realice la migración a una versión anterior, utilice los parámetros -2 o -3 antes del parámetro -1.
-2
(Opcional) Realizar sólo tareas de WebSphere MQ.
-3
(Opcional) Realizar sólo tareas de base de datos.

Si un intermediario que está migrando comparte un esquema de base de datos con otro intermediario, se emite el mensaje de aviso BIP8678 y la comprobación falla. En este caso, todos los intermediarios que comparten un esquema de base de datos se deben migrar juntos.

  1. Detenga todos los intermediarios que comparten el esquema de base de datos.
  2. Migre el primer intermediario. Esta acción migra las tablas de base de datos para todos los intermediarios, así como el sistema de archivos y el registro y las definiciones de WebSphere MQ sólo para dicho intermediario; por ejemplo:
    mqsimigratecomponents FIRSTBROKER -t 6.0.0.1 
  3. Migre el sistema de archivos y el registro y las partes de WebSphere MQ de cada uno de los otros intermediarios. La parte de la base de datos ya se ha migrado. Utilice los parámetros -1 y -2 para hacerlo, ya sea en uno o dos pasos:
    • En un paso:
      mqsimigratecomponents BROKERB -1 -2
    • En dos pasos:
      mqsimigratecomponents BROKERB -1
      mqsimigratecomponents BROKERB -2
-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 ha fallado y también ha fallado la recuperación automática (una anomalía durante la migración dividida sería un ejemplo).
-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 6.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 6.0 a una versión anterior, el parámetro -t es obligatorio, tal 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.
NombreComponente
(Necesario) El nombre del componente que se ha de migrar.

Autorización

El mandato mqsimigratecomponents actualiza el registro y sistema de archivos, las definiciones de WebSphere MQ y las definiciones de base de datos. 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 tener la posibilidad de:
  • Escribir en el registro y el sistema de archivos del producto
  • Modificar las bases de datos asociadas al componente
  • Modificar definiciones de cola

Si ejecuta la migración dividida, el ID de usuario debe tener siempre la posibilidad de leer en el registro del producto y además tener autorización específica para que cada paso se realice satisfactoriamente:

  • -1 requiere que se pueda escribir en el registro y el sistema de archivos del producto
  • -2 requiere que se puedan modificar las definiciones de colas
  • -3 requiere que se puedan modificar las bases de datos asociadas al componente

Respuestas

Este mandato puede generar un gran número de 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 tal como se generan, en lugar de producirse en un proceso por lotes al final del programa. Al migrar las tablas de base de datos, 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 comprueba la migración de BROKER1 de la Versión 2.1 a la Versión 6.0:

mqsimigratecomponents –c BROKER1
BIP8849I: Se ha especificado el intermediario 'BROKER1' (Versión 2.1) con el gestor de colas 'brkqm1' y el origen de datos 'brkdb1' para la migración.
BIP8791I: Se ha iniciado la comprobación de filas duplicadas.
BIP8794I: La tabla BRMINFO no tiene filas duplicadas.
BIP8794I: La tabla BRMRTDDEPINFO no tiene filas duplicadas.
BIP8794I: La tabla BROKERRESOURCES no tiene filas duplicadas.
BIP8794I: La tabla BRMRTDINFO no tiene filas duplicadas.
BIP8794I: La tabla BRMWFDINFO no tiene filas duplicadas.
BIP8792I: Se ha pasado la comprobación de filas duplicadas
BIP8791I: Se ha iniciado la comprobación de filas duplicadas.
BIP8800W: No se ha detectado una sintaxis de temas no válida en la tabla BSUBSCRIPTIONS.
BIP8800W: No se ha detectado una sintaxis de temas no válida en la tabla BPUBLISHERS.
BIP8800W: No se ha detectado una sintaxis de temas no válida en la tabla BRETAINEDPUBS.
BIP8797I: La comprobación de la sintaxis de temas se ha realizado correctamente
BIP8680I: La comprobación previa a la migración se ha realizado correctamente
BIP8071I: El mandato ha finalizado correctamente

El ejemplo siguiente realiza la migración automática de BROKER1 de Versión 2.1 a Versión 6.0 en Windows:

mqsimigratecomponents BROKER1
BIP8849I: Se ha especificado el intermediario 'BROKER1' (Versión 2.1) con el gestor de colas 'BROKER1' y el origen de datos 'BROKERDB' para la migración.
BIP8755I: Se ha copiado el valor 'NombreGstColas' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'NombreOrigenDatos' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'IDUsuarioOrigenDatos' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'ContraseñaOrigenDatos' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'LilPath' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'TiempoEsperaConfiguración' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'TiempoEsperaRetardoConfiguración' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'MigraciónNecesaria' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'GstColasConfianzaMQ' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'NombreGstColasServidorNombresUsuario' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'UUIDIntermedario' en la nueva ubicación
BIP8755I: Se ha copiado el valor 'PIDAgenteAdministración' en la nueva ubicación
BIP8763I: Se ha suprimido el valor 'NombreGstColas' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'NombreOrigenDatos' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'IDUsuarioOrigenDatos' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'ContraseñaOrigenDatos' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'LilPath' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'TiempoEsperaConfiguración' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'TiempoEsperanConfiguración' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'MigraciónNecesaria' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'GstColasConfianzaMQ' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'NombreGstColasServidorNombresUsuario' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'UUIDIntermediario' de la ubicación antigua
BIP8763I: Se ha suprimido el valor 'PIDAgenteAdmin' de la ubicación antigua
BIP8768I: Ha finalizado la migración del registro para el componente 'BROKER1'.
BIP8654I: Se están moviendo los elementos del sistema de archivos '' a 'C:\Documents and Settings\AllUsers\Application Data\IBM\MQSI'
BIP8670I: Se ha iniciado la migración de la base de datos
BIP8663I: Se están creando las nuevas tablas temporales
BIP8664I: Se está migrando desde tablas existentes a las nuevas tablas temporales
BIP8665I: Se están desactivando las tablas existentes
BIP8666I: Se están creando tablas nuevas
BIP8667I: Se están copiando todas las filas desde las tablas nuevas temporales a las tablas nuevas
BIP8668I: Se están desactivando las tablas nuevas temporales
BIP8669I: La migración de la base de datos se ha realizado correctamente
BIP8785I: Iniciando la migración de la cola de WebSphere MQ para el componente 'BROKER1'.
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.REQUEST'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.CONTROL'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.REPLY'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.TIMEOUT'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.AGGR.UNKNOWN'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.TIMEOUT.QUEUE'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.MODEL.QUEUE'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.WS.INPUT'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.WS.REPLY'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.WS.ACK'
El mandato setmqaut se ha realizado correctamente.
BIP8786I: Se ha creado la cola de WebSphere MQ 'SYSTEM.BROKER.IPC.QUEUE'
BIP8787I: Se ha borrado la cola de WebSphere MQ 'SYSTEM.BROKER.ADMIN.QUEUE'
BIP8787I: Se ha borrado la cola de WebSphere MQ 'SYSTEM.BROKER.EXECUTIONGROUP.QUEUE'
BIP8787I: Se ha borrado la cola de WebSphere MQ 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY'
BIP8787I: Se ha borrado la cola de WebSphere MQ 'SYSTEM.BROKER.IPC.QUEUE'
BIP8789I: Ha finalizado la migración de las colas de WebSphere MQ para el componente 'BROKER1'.
BIP8071I: El mandato ha finalizado correctamente

El ejemplo siguiente muestra una migración dividida de la Versión 2.1 a la Versión 6.0:

mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 2.1.0.8 -2
mqsimigratecomponents BROKER -s 2.1.0.8 -3

El ejemplo siguiente muestra una migración dividida de la Versión 6.0 a la Versión 2.1:

mqsimigratecomponents BROKER -t 2.1.0.8 -2
mqsimigratecomponents BROKER -t 2.1.0.8 -3
mqsimigratecomponents BROKER -t 2.1.0.8 -1
Referencia relacionada
Migración y actualización
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Reservados todos los derechos.
Última actualización : 2009-02-16 14:31:12

an26150_