Mandato mqsimigratecomponents

Plataformas soportadas

  • Windows
  • Sistemas UNIX y Linux
  • z/OS

Finalidad

El mandato mqsimigratecomponents traslada un componente de una versión previamente instalada (sólo la Versión 2.1 o la Versión 5) del producto a otra. Este mandato debe ejecutarse desde la versión del producto instalado que sea la más reciente; ya sea el origen o el destino.
Nota:
  1. Para la versión 2.1 del producto, la Versión 2.1 CSD02 (2.1.0.3) es el primer release del producto soportado. (Consulte Migración y actualización para obtener más información.)
  2. Para la Versión 5 del producto, la Versión 5.0.0.4 es el primer release del producto soportado.

Debe tener una instalación de la Versión 6.0 del producto con el código de componentes necesario instalado, es decir, el componente de intermediario se instala si es necesario, y así sucesivamente.

Antes de iniciar la migración, detenga cualquier sesión de depuración en el Centro de control. No es posible migrar flujos de mensajes que se están depurando.

Inicio del cambioPuede invocar el mandato con diversas opciones para realizar una de las siguientes acciones:
  • Realizar una comprobación en un componente, sin realizar ningún cambio, 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 la migración que no se ha ejecutado correctamente (-u).
  • Verificar que un traslado se ha realizado correctamente (-v).
Fin del cambio

Inicio del cambioEl mandato mqsimigratecomponents actualiza el registro y sistema de archivos, las definiciones de WebSphere MQ y las definiciones de base de datos. Si el usuario que está emitiendo el mandato no tiene autoridad para efectuar todos estos pasos, el mandato puede ejecutarse parte a parte. Usuarios diferentes pueden ejecutar la parte para la que están autorizados con el objeto de conseguir el resultado final. Esto se denomina migración partida y se realiza utilizando los parámetros -1, -2 y -3. Fin del cambio

Si utiliza el mandato mqsimigratecomponents con una base de datos Sybase, debe modificar la base de datos realizando las siguientes acciones:
  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) Realizar una comprobación previa a la migración de un componente especificado para asegurarse de que:
  • La versión detectada automáticamente por el intermediario coincide con cualquier versión especificada en la línea de mandatos
  • No hay grupos de ejecución de 64 bits, si se está migrando desde la Versión 6.0 a un release anterior
  • Las tablas de base de datos que se van a copiar de un release anterior no contienen ninguna fila que incumplan los requisitos de índice de la Versión 6.0.
Inicio del cambioSi un intermediario que se está migrando comparte un esquema de base de datos con otro intermediario, se emite el mensaje de aviso BIP8678 y la comprobación no se ejecuta correctamente. En este caso, todos los intermediarios que comparten un esquema de base de datos deben migrarse juntos:
  1. Detenga todos los intermediarios que están compartiendo el esquema de base de datos.
  2. Migre el primer intermediario. Esto migrará 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 ese intermediario; por ejemplo:
    mqsimigratecomponents FIRSTBROKER -t 6.0.0.1
  3. Migre el sistema de archivos y registro y las partes WebSphere MQ de cada uno de los otros intermediarios; la parte de base de datos ya se ha migrado. Utilice los parámetros -1 y -2 para hacerlo, ya sea en uno o en dos pasos:
    • En un paso:
      mqsimigratecomponents BROKERB -1 -2
    • En dos pasos:
      mqsimigratecomponents BROKERB -1
      mqsimigratecomponents BROKERB -2
Fin del cambio

La comprobación de migración puede ejecutarse en un componente en ejecución. Esto no afecta al componente, salvo por un ligero descenso del rendimiento. Tenga en cuenta que en los sistemas UNIX, el archivo odbc.ini debe migrarse (es decir, debe crearse un archivo odbc.ini con un nuevo formato y con el mismo conjunto de orígenes de datos que el antiguo) antes de poder ejecutar la comprobación, ya que el mandato de comprobación necesita poder acceder a la base de datos del intermediario.

El mandato de comprobación se ejecuta correctamente o falla, e imprime un mensaje acerca de si la migración debería o no ejecutarse satisfactoriamente, pero no se realiza ninguna modificación durante el proceso.

-v
(Opcional) Realizar una comprobación posterior a la migración de un componente especificado 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
Inicio del cambio(Opcional) Realizar sólo tareas de registro y de sistema de archivos.
  • Cuando esté migrando a la Versión 6.0, utilice el parámetro -1 antes de los parámetros -2 o -3.
  • Cuando esté migrando a una versión anterior, utilice los parámetros -2 o -3 antes del parámetro -1.
Fin del cambio
-2
(Opcional) Realizar sólo tareas de WebSphere MQ.
-3
(Opcional) Realizar sólo tareas de base de datos.
-u
(Opcional) Deshacer un paso de migración fallido; también debe especificar al menos uno de los valores -1, -2 o -3. Sólo debería utilizar esta opción 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).
-sVersión origen
(Opcional) La versión anterior del componente.
  • Este valor se detecta automáticamente si no se especifica.
  • Inicio del cambioCuando esté realizando una migración partida a la Versión 6.0, el parámetro -s es obligatorio después de ejecutar el mandato mqsimigratecomponents con el parámetro -1. Esto se muestra en el ejemplo de migración partida. Fin del cambio
  • Consulte en el apartado Finalidad las restricciones para los números de versión del producto que están soportados.
-tVersión destino
(Opcional) La versión de destino del componente.
  • Si no se especifica, este valor se presupone que es la versión actual.
  • Inicio del cambioCuando esté realizando una migración partida desde la Versión 6.0 a una versión anterior, el parámetro -t es obligatorio. Esto se muestra en el ejemplo de migración partida. Fin del cambio
  • Consulte en el apartado Finalidad las restricciones para los números de versión del producto que están soportados.
Nombre componente
(Necesario) El nombre del componente que se va a migrar.

Autorización

Al ejecutar la migración de un solo paso, el ID de usuario utilizado para invocar este mandato 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
Para la migración dividida, el ID de usuario utilizado para invocar este mandato debe tener siempre la posibilidad de leer en el registro del producto, y además tener autorización específica para cada paso, para realizarse satisfactoriamente:
  • -1 requiere la posibilidad de escribir en el registro y el sistema de archivos del producto
  • -2 requiere la posibilidad de modificar definiciones de cola
  • -3 requiere la posibilidad de modificar 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. Tenga en cuenta que este mandato se diferencia de otros mandatos en el modo en que genera los mensajes – éstos se visualizan según se necesiten, en lugar de generarse como un lote al final del programa.

Ejemplos

El ejemplo siguiente comprueba la migración de BROKER1 de la V2.1 a la Versión 6.0:

mqsimigratecomponents –c BROKER1
BIP 0001I: Iniciando la comprobación de migración para el componente ‘BROKER1’ en el nivel FAD ‘3’
BIP 0002I: ‘BROKER1’ es la versión 2.1 (detectada automáticamente)
BIP 0003I: La base de datos de intermediario ‘BKRDB’ y el esquema ‘WMQIUSER’ no se comparten con otros componentes.
BIP 0004I: No se han encontrado filas no válidas en la base de datos de intermediario.
BIP 0005I: La comprobación de migración ha sido satisfactoria.
BIP 8071I: El mandato ha finalizado correctamente.

El ejemplo siguiente realiza la migración automática de BROKER1 de la V2.1 a la Versión 6.0:

mqsimigratecomponents BROKER1
BIP 0001I: Iniciando la comprobación de migración para el componente ‘BROKER1’ en el nivel FAD ‘3’
BIP 0002I: ‘BROKER1’ es la versión 2.1 (detectada automáticamente)
BIP 0003I: La base de datos de intermediario ‘BKRDB’ y el esquema ‘WMQIUSER’ no se comparten con otros componentes.
BIP 0004I: No se han encontrado filas no válidas en la base de datos de intermediario.
BIP 0005I: La comprobación de migración ha sido satisfactoria.
BIP 0020I: Iniciando la migración del registro para el componente ‘BROKER1’.
BIP 0021I: Se ha creado la clave de nivel superior ‘CurrentVersion’
BIP 0021I: Se ha creado la subclave ‘DSN’
BIP 0022I: Se ha creado la subclave ‘HTTPListener’
BIP 0023I: Se ha creado la subclave ‘HTTPListener.HTTPConnector’
BIP 0024I: Se ha creado el valor ‘FADLevel’; establecido en ‘3’
BIP 0025I: Se ha creado el valor ‘converters’; establecido en ‘’
BIP 0028I: Trasladando los datos de registro a ‘CurrentVersion’.
BIP 0029I: Se ha trasladado el valor ‘AdminAgentPID’.
[repetir para cada valor]
BIP 0030I: Se ha completado el traslado de los datos de registro a ‘CurrentVersion’.
BIP 0025I: Ha finalizado la migración del registro para el componente ‘BROKER1’.
BIP 0011I: Iniciando la migración de tablas de base de datos para ‘BKRDB’.’WMQIUSER’.
BIP 0012I: Trasladando la tabla ’BROKERRESOURCES’ a ’somethingBROKERRESOURCES’.
BIP 0013I: Creando nueva tabla ’BROKERRESOURCES’.
BIP 0014I: Copiando datos de ‘somethingBROKERRESOURCES’ a ’BROKERRESOURCES’.
BIP 0015I: Se han copiado correctamente todos los datos (322 filas).
[repetir para cada tabla]
BIP 0016I: Ha finalizado la migración de tablas de base de datos para ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Iniciando la migración de colas para ‘BKRQM’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.CONTROL’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.REPLY’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.REQUEST’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.TIMEOUT’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.AGGR.UNKNOWN’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.TIMEOUT.QUEUE’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.WS.ACK’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.WS.INPUT’.
BIP 0018I: Creando nueva cola ‘SYSTEM.BROKER.WS.REPLY’.
BIP 0026I: Borrando la cola ‘SYSTEM.BROKER.ADMIN.QUEUE’.
BIP 0026I: Borrando la cola ‘SYSTEM.BROKER.EXECUTIONGROUP.QUEUE’.
BIP 0026I: Borrando la cola ‘SYSTEM.BROKER.EXECUTIONGROUP.REPLY’.
BIP 0026I: Borrando la cola ‘SYSTEM.BROKER.IPC.QUEUE’.
BIP 0019I: Ha finalizado la migración de colas para ‘BKRQM’.
BIP 0005I: Se ha realizado satisfactoriamente la migración del componente ‘BROKER1’.
BIP 8071I: El mandato ha finalizado correctamente.

El siguiente ejemplo es una repetición del ejemplo anterior, pero con el parámetro -q especificado:

mqsimigratecomponents -q BROKER1
BIP 0001I: Iniciando la comprobación de migración para el componente ‘BROKER1’ en el nivel FAD ‘3’
BIP 0002I: ‘BROKER1’ es la versión 2.1 (detectada automáticamente)
BIP 0005I: La comprobación de migración ha sido satisfactoria.
BIP 0020I: Iniciando la migración del registro para el componente ‘BROKER1’.
BIP 0025I: Ha finalizado la migración del registro para el componente ‘BROKER1’.
BIP 0011I: Iniciando la migración de tablas de base de datos para ‘BKRDB’.’WMQIUSER’.
BIP 0016I: Ha finalizado la migración de tablas de base de datos para ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Iniciando la migración de colas para ‘BKRQM’.
BIP 0019I: Ha finalizado la migración de colas para ‘BKRQM’.
BIP 0005I: Se ha realizado satisfactoriamente la migración del componente ‘BROKER1’.
BIP 8071I: El mandato ha finalizado correctamente.
Inicio del cambio

El siguiente ejemplo muestra una migración partida desde la Versión 2.1 a la Versión 6.0:

Fin del cambio
Inicio del cambio
mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 2.1.0.8 -2
mqsimigratecomponents BROKER -s 2.1.0.8 -3
Fin del cambio
Inicio del cambio

El siguiente ejemplo muestra una migración partida desde la Versión 6.0 a la Versión 2.1:

Fin del cambio
Inicio del cambio
mqsimigratecomponents BROKER -t 2.1.0.8 -2
mqsimigratecomponents BROKER -t 2.1.0.8 -3
mqsimigratecomponents BROKER -t 2.1.0.8 -1
Fin del cambio
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 04/05/2006
an26150_