Despliegue de aplicaciones JMS en Liberty para utilizar el proveedor de mensajería IBM MQ

Mediante el proveedor de mensajería de IBM MQ en Liberty, las aplicaciones de mensajería Java™ Message Service (JMS) utilizan el sistema IBM MQ como un proveedor externo de los recursos de mensajería JMS.

Antes de empezar

Debe asegurarse de que se ha creado un servidor Liberty en el que desea desplegar la aplicación de mensajería que utiliza JMS. Para obtener más información, consulte Creación manual de un servidor de Liberty.

Acerca de esta tarea

La característica wmqJmsClient-2.0 proporciona soporte para aplicaciones que utilizan las especificaciones JMS 2.0.

Nota: La característica wmqJmsClient-2.0 admite las características de las especificaciones JMS 1.1 y JMS 2.0. Sin embargo, puede decidir utilizar la característica wmqJmsClient-1.1 si desea utilizar solamente las características que son compatibles con la especificación JMS 1.1.

Procedimiento

  1. Añada la característica wmqJmsClient-2.0 al archivo server.xml. Si desea realizar una búsqueda JNDI, debe añadir también la característica jndi-1.0.
    <featureManager>
         <feature>wmqJmsClient-2.0</feature>
         <feature>jndi-1.0</feature>
    </featureManager>

    La adición de la característica wmqJmsClient-2.0 permite que el servidor Liberty cargue los paquetes de IBM MQ necesarios que permiten definir los recursos JMS de IBM MQ. Por ejemplo, la fábrica de conexiones y las propiedades de especificación de activación proporcionan bibliotecas de clientes para conectarse a la red de IBM MQ.

  2. Especifique la ubicación de IBM MQ Resource Adapter añadiendo la entrada siguiente al archivo server.xml:
    <variable name="wmqJmsClient.rar.location" value="/path/to/wmq/rar/wmq.jmsra.rar"/>
    donde el atributo value especifica la vía de acceso absoluta del archivo de IBM MQ Resource Adapter, wmq.jmsra.rar.

    Para obtener detalles de las versiones admitidas y cómo obtener el archivo wmq.jmsra.rar, consulte la nota técnica 1633761 de IBM MQ. Consiga el archivo wmq.jmsra.rar e instálelo desde Fix Central.

  3. Añada las definiciones de fábrica de conexiones al archivo server.xml.
    <jmsConnectionFactory jndiName="jms/wmqCF" connectionManagerRef="ConMgr6">
         <properties.wmqJms 
            transportType="CLIENT"
            hostName="localhost" 
            port="1414"
            channel="SYSTEM.DEF.SVRCONN"
            queueManager="QM1"/>
    </jmsConnectionFactory>
    <connectionManager id="ConMgr6" maxPoolSize="2"/>
    
    <jmsQueue id="jms/queue1" jndiName="jms/wmqQ1">
         <properties.wmqJms 
            baseQueueName="MDBQ" 
            baseQueueManagerName="QM1"/>
        </jmsQueue>
  4. Configure aplicaciones JMS para conectarse en la modalidad BINDINGS.
    Para permitir que las aplicaciones JMS se conecten utilizando las memorias compartidas o en la modalidad BINDINGS a IBM MQ, debe tener tanto Liberty como IBM MQ desplegados en el mismo servidor. Para permitir que las aplicaciones JMS se conecten en la modalidad BINDINGS, utilice el elemento nativeLibraryPath en el archivo server.xml para especificar la ubicación de las bibliotecas nativas de IBM MQ.
     <wmqJmsClient nativeLibraryPath="/opt/mqm/java/lib64"/>
    Nota: Para utilizar la modalidad BINDINGS, el servidor se debe configurar con la característica zosTransaction-1.0.

Icono que indica el tipo de tema Tema de tarea

Nombre de archivo: twlp_dep_msg_wmq.html