[IBM MQ Advanced][Linux]

Migración de un gestor de colas para que se convierta en un gestor de colas HA RDQM

Puede migrar un gestor de colas existente para que se convierta en un gestor de colas de datos replicados (RDQM) de alta disponibilidad (HA) haciendo una copia de seguridad de sus datos persistentes y, después, restaurando los datos en un nuevo gestor de colas RDQM recién creado que tenga el mismo nombre.

Acerca de esta tarea

Los gestores de colas de datos replicados HA requieren un volumen lógico dedicado (sistema de archivos) y la configuración de la réplica de disco y el control de HA. Estos componentes solo se configuran cuando se crea un nuevo gestor de colas. Un gestor de colas existente se puede migrar para utilizar el RDQM haciendo una copia de seguridad de sus datos persistentes y, después, restaurando los datos en un gestor de colas RDQM recién creado que tenga el mismo nombre. Este procedimiento conserva la configuración del gestor de colas, el estado y los mensajes persistentes en el momento en que se creó la copia de seguridad.

Nota: Sólo puede migrar un gestor de colas desde una versión de IBM® MQ que sea igual o inferior a la versión donde está instalado RDQM. El sistema operativo y la arquitectura también debe ser los mismos. De lo contrario, deberá crear un nuevo gestor de colas en su plataforma de destino, véase Traslado de un gestor de colas a otro sistema operativo.
Antes de migrar un gestor de colas, debe cumplir las condiciones siguientes:
  • Evalúe sus requisitos de alta disponibilidad y consulte RDQM alta disponibilidad.
  • Revise las aplicaciones y los gestores de colas que se conectan al gestor de colas. Considere los cambios necesarios para direccionar las conexiones al nodo RDQM donde se está ejecutando el gestor de colas. Por ejemplo, si configura la alta disponibilidad de RDQM puede considerar el uso de una dirección IP flotante, véase Creación y eliminación de una dirección IP flotante.
  • Suministre, o identifique, los nodos RDQM existentes para la configuración que seleccione. Para obtener información sobre los requisitos del sistema para RDQM, consulte Requisitos de la solución RDQM HA.
  • Instale IBM MQ Advanced, que incluye la característica RDQM, en cada nodo.
  • Configure el grupo RDQM HA, consulte Definición del clúster Pacemaker (grupo HA).
  • Si lo desea, verifique la configuración de RDQM utilizando un gestor de colas de prueba, que después se puede suprimir. Se recomienda probar la configuración para identificar y resolver los problemas antes de migrar el gestor de colas.
  • Revise la configuración de seguridad para el gestor de colas y, a continuación, duplique los grupos y usuarios locales necesarios en cada nodo RDQM.
  • Revise el gestor de colas y la configuración de canal para determinar si se utilizan salidas de API, salidas de canal o salidas de conversión de datos. Instale las salidas necesarias en cada nodo RDQM.
  • Revise los servicios del gestor de colas que se han definido y, a continuación, instale y configure los procesos necesarios en cada nodo RDQM.

Procedimiento

  1. Haga una copia de seguridad del gestor de colas existente:
    1. Detenga el gestor de colas existente emitiendo un mandato de conclusión de espera endmqm -wo un mandato de conclusión inmediata endmqm -i. Este paso es importante para garantizar que los datos de la copia de seguridad son coherentes.
    2. Determine la ubicación del directorio de datos del gestor de colas visualizando el archivo de configuración IBM MQ , mqs.ini. En Linux, este archivo se encuentra en el directorio /var/mqm. Para obtener más información sobre mqs.ini, consulte el archivo de configuración de IBM MQ , mqs.ini.

      Localice la stanza QueueManager para el gestor de colas en el archivo. Si la stanza contiene una clave llamada DataPath, su valor es el directorio de datos del gestor de colas. Si la clave no existe, el directorio de datos del gestor de colas se puede determinar utilizando los valores de las claves Prefix y Directory. El directorio de datos del gestor de colas es una concatenación de estos valores, con el formato prefijo/qmgrs/directorio. Para obtener más información sobre la stanza QueueManager , consulte la sección QueueManager del archivo mqs.ini.

    3. Cree una copia de seguridad del directorio de datos de gestor de colas. En Linux, puede hacerlo utilizando el mandato tar . Por ejemplo, para hacer una copia de seguridad del directorio de datos para un gestor de colas, puede utilizar el mandato siguiente. Observe el último parámetro del mandato, que es un único punto:
      tar -cvzf qm-data.tar.gz -C queue_manager_data_dir .
    4. Determine la ubicación del directorio de registro del gestor de colas visualizando el archivo de configuración del gestor de colas IBM MQ qm.ini. Este archivo se encuentra en el directorio de datos del gestor de colas. Para obtener más información sobre el archivo, consulte Archivos de configuración del gestor de colas, qm.ini.

      El directorio de registro del gestor de colas se define como el valor de la clave LogPath en la stanza Log. Para obtener información sobre la stanza, consulte Stanza de registro del archivo qm.ini.

    5. Cree una copia de seguridad del directorio de registro del gestor de colas. En Linux, puede hacerlo utilizando el mandato tar. Por ejemplo, para hacer una copia de seguridad del directorio de registro para un gestor de colas, puede utilizar el mandato siguiente. Observe el último parámetro del mandato, que es un único punto:
      tar -cvzf qm-log.tar.gz -C queue_manager_log_dir .
    6. Cree una copia de seguridad de los repositorios de certificados utilizados por el gestor de colas, si no se encuentran en el directorio de datos del gestor de colas. Asegúrese de que se ha hecho una copia de seguridad de ambos archivos, el archivo de base de datos de claves y el archivo de ocultación de contraseña. Para obtener información sobre el repositorio de claves del gestor de colas, consulte El repositorio de claves SSL/TLS y Localización del repositorio de claves para un gestor de colas. Para obtener información sobre cómo localizar el almacén de claves AMS si el gestor de colas está configurado para utilizar la intercepción del agente de canal de mensajes (MCA) de AMS, consulte Intercepción del agente de canal de mensajes (MCA).
    7. El gestor de colas existente ya no es necesario, así que se puede suprimir. Sin embargo, siempre que sea posible, solo debe suprimir el gestor de colas existente, después de que se haya restaurado correctamente en el sistema de destino. El aplazamiento de la supresión garantiza que el gestor de colas se puede reiniciar si el proceso de migración no se completa correctamente.
      Nota: Si difiere la supresión del gestor de colas existente, no lo reinicie. Es importante que el gestor de colas permanezca finalizado porque los cambios adicionales en si configuración o estado se pierden durante la migración.
  2. Prepare el nodo RDQM primario:
    1. Cree un nuevo gestor de colas RDQM con el mismo nombre que el gestor de colas del que ha hecho una copia de seguridad. Asegúrese de que el sistema de archivos asignado para el gestor de colas RDQM por crtmqm es lo suficientemente grande para que contenga los datos, los registros primarios y los registros secundarios para el gestor de colas existente, además de algún espacio adicional para una futura ampliación. Para obtener información sobre cómo crear un gestor de colas RDQM, consulte Creación de un RDQM HA.
    2. Determine el nodo RDQM primario para el gestor de colas. Para obtener información sobre cómo determinar el nodo primario, consulte rdqmstatus (visualizar estado RDQM).
    3. En el nodo RDQM primario, si se ha iniciado el gestor de colas RDQM, deténgalo utilizando el mandato endmqm -w o endmqm -i .
    4. En el nodo RDQM primario, determine la ubicación de los directorios de datos y registro para el gestor de colas RDQM (utilice los métodos descritos en los pasos 1b y 1d).
    5. En el nodo RDQM primario, suprima el contenido de los directorios de datos y registros del gestor de colas RDQM, pero no los propios directorios.
  3. Restaure el gestor de colas en el nodo RDQM primario:
    1. Copie las copias de seguridad de los directorios de datos y registro del gestor de colas en el nodo RDQM primario, además de las copias de seguridad independientes de los repositorios de certificados utilizados por el gestor de colas.
    2. Restaure la copia de seguridad del directorio de datos del gestor de colas en el directorio de datos vacío para el nuevo gestor de colas RDQM, asegurándose de que se conservan los permisos y la propiedad de archivos. Si la copia de seguridad se ha creado utilizando el mandato tar de ejemplo en el paso 1c, el usuario root puede utilizar el mandato siguiente para restaurarla:
      tar -xvzpf qm-data.tar.gz -C queue_manager_data_dir
    3. Restaure la copia de seguridad del directorio de registro del gestor de colas en el directorio de registro vacío para el nuevo gestor de colas RDQM, asegurándose de que se conserven los permisos y la propiedad de archivos. Si la copia de seguridad se ha creado utilizando el mandato tar de ejemplo en el paso 1e, el usuario root puede utilizar el mandato siguiente para restaurarla:
      tar -xvzpf qm-log.tar.gz -C queue_manager_log_dir
    4. Edite el archivo de configuración del gestor de colas restaurado, qm.ini, en el directorio de datos para el gestor de colas RDQM. Actualice el valor de la clave LogPath en la stanza Log para especificar el directorio de registro para el gestor de colas RDQM.
      Revise otras vías de acceso de archivo que están definidas en el archivo de configuración y actualícelas, si es necesario. Por ejemplo, es posible que tenga que actualizar las vías de acceso siguientes:
      • La vía de acceso de los archivos de registro de errores generados por los servicios de mensajes de diagnóstico.
      • La vía de acceso para las salidas necesarias para el gestor de colas.
      • La vía de acceso para los archivos de carga conmutada, si el gestor de colas es un coordinador de transacciones XA.
    5. Si el gestor de colas se ha configurado para utilizar la intercepción del agente de canal de mensajes (MCA) AMS, copie el almacén de claves AMS en la nueva instalación de RDQM y, después, revise y actualice la configuración. El almacén de claves debe estar disponible en cada nodo RDQM, de modo que si no se encuentra en el sistema de archivos duplicado para el gestor de colas, en su lugar, se debe copiar en cada nodo. Para obtener más información, consulte Intercepción del agente de canal de mensajes (MCA).
    6. Verifique que el mandato dspmq muestra el gestor de colas y que su estado se notifica como finalizado. El ejemplo siguiente muestra la salida de ejemplo para un gestor de colas RDQM HA.
      $ dspmq -o status -o ha 

QMNAME(QM1) STATUS(Ended normally) HA(Replicated)
    7. Verifique que los datos del gestor de colas restaurados se hayan replicado en los nodos RDQM secundarios utilizando el mandato rdqmstatus para visualizar el estado del gestor de colas. El estado de HA se debe notificar como Normal en cada nodo. El ejemplo siguiente muestra la salida de ejemplo para un gestor de colas RDQM HA.
      $ rdqmstatus -m QM1 
Node:                           mqhavm10-adm 
Queue manager status:           Ended normally 
Queue manager file system:      50MB used, 0.2GB allocated [42%] 
HA role:                        Primary 
HA status:                      Normal 
HA control:                     Disabled 
HA current location:            This node 
HA preferred location:          This node 
HA floating IP interface:       None 
HA floating IP address:         None 

Node:                           mqhavm11-adm 
HA status:                      Normal 

Node:                           mqhavm12-adm 
HA status:                      Normal
    8. Inicie el gestor de colas en el nodo RDQM primario.
    9. Conéctese al gestor de colas y actualice el valor del atributo del gestor de colas SSLKEYR para especificar la nueva ubicación del repositorio de certificados del gestor de colas. De forma predeterminada, el valor de este atributo se establece en queue_manager_data_directory/ssl/key. El repositorio de certificados debe estar ubicado en la misma ubicación en cada nodo RDQM. Si el repositorio no se encuentra en el sistema de archivos duplicado para el gestor de colas, en su lugar, se debe copiar en cada nodo.
    10. Revise las definiciones de objeto de IBM MQ para el gestor de colas y actualice el valor de los atributos de objeto que hacen referencia a los valores de red cambiados, el directorio de instalación de IBM MQ o el directorio de datos del gestor de colas, incluidos los objetos siguientes:
      • Direcciones IP locales utilizadas por escuchas (atributo IPADDR)
      • Direcciones IP locales utilizadas por canales (atributo LOCLADDR)
      • Direcciones IP locales definidas para los canales de clúster receptor (atributo CONNAME)
      • Direcciones IP locales definidas para los objetos de información de comunicación (atributo GRPADDR)
      • Vías de acceso de sistema definidas para las definiciones de objeto de proceso y servicio.
    11. Detenga y reinicie el gestor de colas para asegurarse de que los cambios acaben siendo efectivos.
    12. Repita el paso 3j para los gestor de colas remotos. además de los valores equivalentes para las aplicaciones, que se conectan al gestor de colas migrados, incluyendo:
      • Nombre de conexión de canal (atributo CONNAME)
      • Reglas de autenticación de canal que restringen las conexiones de entrada del gestor de colas basándose en su dirección IP o nombre de host.
      • Tablas de definición de canal de cliente (CCDT), valores de nombre de dominio (DNS), direccionamiento de red o información de conexión equivalente.
    13. Realice una migración tras error gestionada del gestor de colas en cada nodo RDQM para asegurarse de que la configuración necesaria se ha establecido correctamente; consulte Establecimiento de la ubicación preferida para un RDQM.