Mandato migmbbrk de WebSphere MQ

Migrar la información de publicación/suscripción de WebSphere Message Broker Versión 6.1 a WebSphere MQ

Finalidad

Utilice el mandato WebSphere MQ migmbbrk para migrar la información de publicación/suscripción de un intermediario de WebSphere Message Broker Versión 6.1 a un gestor de colas de WebSphere MQ. El mandato ejecuta un proceso de migración que migra la siguiente información de publicación/suscripción en el gestor de colas que estás asociado al intermediario especificado:
  • Suscripciones
  • Puntos de suscripción (puntos de suscripción que sólo están soportados cuando se utilizan mensajes RFH2)
  • Corrientes de datos
  • Publicaciones retenidas

Cuando se ejecuta el mandato migmbbrk, debe utilizar el perfil para la versión de WebSphere Message Broker desde la que está realizando la migración.

El mandato migmbbrk no migra la lista de control de accesos (ACL). Pero si ejecuta la migración con los parámetros -t i o -r se genera un archivo que contiene los mandatos setmqaut recomendados en el entorno de seguridad que había en el intermediario. Debe revisar y modificar el archivo de mandatos de seguridad según sea necesario y ejecutar los mandatos para configurar un entorno de seguridad en el gestor de colas, equivalente al que había en el intermediario, antes de que ejecutara la migración con el parámetro -c para completar la migración.

Nota: En Sistemas UNIX, todas las autorizaciones las poseen internamente los grupos de usuarios y no los principales, con las implicaciones siguientes:
  • Si utiliza el mandato setmqaut para conceder una autorización a un principal, la autorización se concede al grupo de usuarios primario del principal. Por consiguiente, la autorización se concede de hecho a todos los miembros de ese grupo de usuarios.
  • Si utiliza el mandato setmqaut para revocar una autorización de un principal, la autorización se revoca desde el grupo de usuarios del principal. Por lo tanto, la autorización se revoca de hecho desde todos los miembros de ese grupo de usuarios.

Debe emitir el mandato migmbbrk desde un entorno de mandatos que pueda procesar satisfactoriamente los mandatos WebSphere MQ y WebSphere Message Broker. Normalmente, estos mandatos se pueden emitir desde una consola de mandatos WebSphere Message Broker.

Los datos de configuración de WebSphere Message Broker Versión 6.1 publicación/suscripción, que se almacenan en las tablas de bases de datos de suscripción no se suprimen con el proceso de migración. Por tanto, estos datos de configuración están disponibles para su utilización, hasta que los suprima explícitamente.

Sintaxis

Leer el esquema de sintaxisOmitir el esquema de sintaxis visual
                       .----------.   
                       V          |   
>>-migmbbrk--+- -c -+----+------+-+----------------------------->
             +- -r -+    +- -l -+     
             '- -t -'    +- -o -+     
                         +- -s -+     
                         '- -z -'     

>-- -b --NombreIntermediario-----------------------------------><

Parámetros

-b NombreIntermediario
(Necesario) El nombre del intermediario que es el origen de la información de publicación/suscripción que se va a migrar. El gestor de colas al que se migra la información de publicación/suscripción es el gestor de colas que está asociado al intermediario especificado.
-c
(Necesario) Completa la migración de los datos de configuración de publicación/suscripción. La fase de terminación utiliza los objetos de tema que se han creado en la fase -t inicial. Puede que el estado del intermediario haya cambiado desde que se ejecutó la fase inicial y ahora puede que sean necesarios objetos de tema adicionales. Si así es, la fase de terminación crea estos nuevos objetos de tema, según convenga. La fase de terminación no suprime ningún objeto de tema que se haya convertido en innecesario; es posible que deba suprimir manualmente aquellos objetos de tema que no necesite.

Antes de completar la migración, debe revisar y modificar el archivo de mandatos de seguridad generados en la fase -r o -t según convenga y ejecutar los mandatos para configurar un entorno de seguridad en el gestor de colas, equivalente al que existía en el intermediario.

Antes de ejecutar esta fase de terminación, debe ejecutar la fase -t inicial. No puede utilizar el parámetro -c con el parámetro -r o el parámetro -t. Esta fase también crea un registro de migración.

-r
(Necesario) Simula el proceso de migración, pero no se cambia nada. Puede utilizar esta opción antes de ejecutar la migración con el parámetro -t, para crear un registro de migración, que incluya todos los errores, de forma que pueda observar cuál seria el resultado del proceso de migración, pero sin cambiar las configuraciones actuales.

Simular la migración también genera un archivo que contiene los mandatos setmqaut sugeridos para configurar un entorno de seguridad en el gestor de colas que sea equivalente al entorno de seguridad que existía en el intermediario. Antes de completar la migración con el parámetro -c, debe revisar y modificar, según convenga, el archivo de mandatos de seguridad, y ejecutar los mandatos para configurar un entorno de seguridad en el gestor de colas, equivalente al que existía en el intermediario.

No puede utilizar el parámetro -r con el parámetro -c o el parámetro -t.

-t
(Necesario) Crea objetos de tema que puedan ser necesarios en el gestor de colas, basándose en las ACL definidas en el intermediario.

La utilización del parámetro -t también genera un archivo que contiene los mandatos setmqaut sugeridos para configurar un entorno de seguridad en el gestor de colas que sea equivalente al entorno de seguridad que existe en el intermediario. Los objetos de tema se crean en previsión de que ejecute posteriormente los mandatos de seguridad para crear ACL en los objetos de temas. Antes de completar la migración con el parámetro -c, debe revisar y modificar, según convenga, el archivo de mandatos de seguridad, y ejecutar los mandatos para configurar un entorno de seguridad en el gestor de colas, equivalente al que existía en el intermediario.

Debe ejecutar esta fase antes de ejecutar la fase de terminación con el parámetro -c. No puede utilizar el parámetro -t con el parámetro -c o el parámetro -r. Esta fase también crea un registro de migración.

-l
(Opcional) Deja el intermediario ejecutándose. Si no especifica este parámetro, el intermediario se cierra, de forma predeterminada, al final del proceso de migración.
-o
(Opcional) Sobrescribe cualquier suscripción o publicación retenida existente en el gestor de colas y que tenga el mismo nombre que una suscripción o publicación retenida que se está migrando del intermediario, con la información de publicación/suscripción recuperada del intermediario. El parámetro -o no tiene ningún efecto si lo utiliza con el parámetro -r.
-s
(Opcional) Descarta la información intermedia que se haya retenido de una instancia anterior del proceso de migración que ha fallado o se ha interrumpido. El proceso de migración rellena las colas privadas con datos temporales. Si el proceso de migración se completa satisfactoriamente, se suprimirán los datos temporales. Si no especifica este parámetro, y el proceso de migración falla o se interrumpe, se retienen los datos temporales, y el proceso de migración los utiliza si lo reinicia, de forma que el proceso se reanuda en el punto en el que falló, o se interrumpió, anteriormente.
-z
(Opcional) Ejecuta el proceso de migración, independientemente de si se ha ejecutado anteriormente y haya finalizado de forma satisfactoria. Si no especifica este parámetro y el proceso de migración se ha ejecutado anteriormente, y ha finalizado de forma satisfactoria, el proceso reconoce este hecho y se detiene. Puede utilizar el parámetro -o con el parámetro -z, per no es obligatorio. Una simulación anterior de la migración utilizando el parámetro -r no cuenta como una terminación satisfactoria.

Códigos de retorno

Archivos de salida

El proceso de migración graba dos archivos de salida en el directorio actual:
amqmigrateacl.txt
Un archivo que contiene una lista de mandatos setmqaut para que los revise, cambie y ejecute si es pertinente, a fin de ayudarle a reproducir las ACL.
amqmigmbbrk.log
Un archivo de registro que contiene un registro de los detalles de la migración.

Ejemplos

Este mandato migra la información de publicación/suscripción del intermediario BRK1 a su gestor de colas asociado, y especifica que el proceso de migración se ejecute independientemente de si la migración que se haya ejecutado anteriormente haya finalizado de forma satisfactoria. También especifica que debe sobrescribirse toda suscripción o publicación retenida que ya exista en el gestor de colas, que tenga el mismo nombre que una suscripción o publicación retenida que se esté migrando del intermediario.
migmbbrk -r -z -o -b BRK1

Sistemas operativos soportados

Sólo se da soporte al mandato migmbbrk en las plataformas siguientes que dan soporte a WebSphere Message Broker Versión 6.1:

En z/OS la función equivalente al mandato migmbbrk se proporciona mediante el programa de utilidad CSQUMGMB.

Inicio del cambioPara obtener los detalles más recientes sobre todos los niveles soportados de hardware y software, visite el sitio web de Requisitos de WebSphere Message Broker.Fin del cambio

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última actualización
        
        Última actualización : 2012-07-13 19:58:09


Tema de referenciaTema de referencia | Versión 8.0.0.1 | bq13060_