Instalar el ejemplo de Nodos JMS

En este ejemplo, se utiliza WebSphere MQ como proveedor de JMS; debe crear los objetos administrados utilizando la herramienta JMSAdmin.

Antes de empezar:

Si va a ejecutar el ejemplo en Linux, debe realizar estos pasos:

  1. Añada la clase JMSAdmin a la variable classpath añadiendo el siguiente archivo a dicha variable:
    >directorio_instalación_mq</java/lib/com.ibm.mqjms.jar
  2. Añada la ubicación Java a la variable PATH incluyendo el siguiente código en la variable classpath:
    >JAVA_HOME</bin

Crear los objetos administrados usando JMSAdmin

En las siguientes instrucciones se presupone que WebSphere MQ está instalado en el directorio dir_instalación_mq. La herramienta JMSAdmin y el archivo de configuración de JMSAdmin se encuentran en las siguientes ubicaciones:

Antes de utilizar la herramienta JMSAdmin, es posible que tenga que modificar el archivo JMSAdmin.config.

Validar y modificar el archivo JMSAdmin.config

  1. En un editor de texto, abra el archivo JMSAdmin.config.
  2. Para comentar las opciones que no son necesarias, añada un signo de número (#). Para descomentar una opción, elimine el signo de número (#).
    # La línea siguiente especifica qué proveedor de servicios JNDI se está utilizando.
    # Actualmente indica un Contexto del sistema de archivos. Si se utiliza
    # un proveedor de servicios distinto, se debe comentar esta línea y
    # se debe descomentar la línea adecuada.
    #
    #  com.sun.jndi.fscontext.RefFSContextFactory es el Contexto JNDI del sistema de archivos
    #
    #INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory
    #INITIAL_CONTEXT_FACTORY=com.ibm.ejs.ns.jndi.CNInitialContextFactory
    #INITIAL_CONTEXT_FACTORY=com.ibm.websphere.naming.WsnInitialContextFactory
    #
    #  La línea siguiente especifica el URL del contexto inicial del proveedor de
    #  servicios. Actualmente hace referencia a un Contexto del sistema de archivos. También
    #  se muestran, comentados, ejemplos de un URL de contexto raíz LDAP y del espacio
    #  de nombres JNDI de WebSphere.
    #
    #  PROVIDER_URL debe cambiarse a, por ejemplo, file:///home/user/JNDI-Directory
    #  en plataformas Unix. La carpeta 'JNDI-Directory' debe crearse en la
    #  ubicación especificada.
    #
    #PROVIDER_URL=ldap://localhost/o=ibm,c=us
    PROVIDER_URL=file:/C:/JNDI-Directory
    #PROVIDER_URL=iiop://localhost/	
    
  3. Asegúrese de que PROVIDER_URL esté establecido en /C:/JNDI-Directory, o una ubicación equivalente en Linux, y que INITIAL_CONTEXT_FACTORY esté establecido en com.sun.jndi.fscontext.RefFSContextFactory.
  4. Si ha realizado algún cambio, guarde el archivo.
  5. Cree el directorio PROVIDER_URL si aún no existe.

Ahora puede crear los objetos.

Crear los objetos

Al ejecutar la herramienta JMSAdmin de WebSphere MQ, crea los objetos administrados JNDI para configurar los destinos y las fábricas de conexiones JMS que se utilizan en el ejemplo.

Cree los objetos ejecutando la herramienta JMSAdmin y utilizando el archivo JMSSampleObjects.defs como entrada.

Si su intermediario no está utilizando el puerto 2414, edite el valor del puerto en JMSSampleObjects.defs.

En la línea de mandatos, entre los siguientes mandatos:

Donde WebSphere MQ se instala en la siguiente ubicación: dir_instalación_mq y vía_acceso_espacio_trabajo es la vía de acceso completa al directorio del espacio de trabajo de WebSphere Message Broker Toolkit.

Se crean los objetos y el archivo .bindings.

A continuación, modifique un objeto JNDI y un atributo del nodo MQInput:

  1. Para iniciar la herramienta JMSAdmin, escriba el mandato siguiente:

    Donde WebSphere MQ está instalado en la siguiente ubicación: dir_instalación_mq.

  2. En la línea de mandatos, entre los mandatos siguientes para modificar este objeto JNDI:
    alter q(publishqueue) queue(PUBLISHQUEUE)
  3. Para finalizar la sesión JMSAdmin, entre el mandato siguiente:
    end

Configurar la vía de acceso a JNDI en los flujos de mensajes

Debe informar a los nodos JMS de los flujos de mensajes dónde han de encontrar el archivo .bindings que acaba de crear.

ara configurar los nodos JMS con la ubicación del archivo .bindings:

  1. En la vista Desarrollo de intermediario, efectúe una doble pulsación en el archivo JMSGateway.msgflow en el proyecto JMS Nodes Sample Flow. Esta acción abre un editor de flujos de mensajes donde puede editar el flujo de mensajes JMSGateway.
  2. Pulse el botón derecho del ratón en el nodo JMSOutput del flujo de mensajes y luego pulse Propiedades para mostrar la vista Propiedades.
  3. En el panel Propiedades, seleccione el separador Conexión JMS.
  4. Asegúrese de que el valor mostrado en el campo Enlaces JNDI de ubicación coincida con la vía de acceso especificada en la línea PROVIDER_URL del archivo JMSAdmin.config. Si estos dos valores no son iguales, el flujo de mensajes no funcionará.
  5. Guarde el flujo de mensajes.
  6. Abra el flujo de mensajes JMSInput_Publication en el Editor de flujos de mensajes y configure el nodo JMSInput con la ubicación del archivo .bindings utilizando los pasos anteriores.

Ahora los flujos de mensajes están configurados y preparados para ser desplegados para el intermediario.

Crear el archivo BAR y desplegar los flujos de mensajes

Para desplegar los flujos de mensajes JMSGateway y JMSInput_Publication, cree un archivo de archivador de intermediario (BAR) que contenga los dos flujos de mensajes.

Para crear el archivo BAR:

  1. En la vista Desarrollo de intermediario, pulse con el botón derecho y seleccione Nuevo > Archivo BAR.
  2. Seleccione el "Proyecto JMSNodesSampleFlow" y especifique un nombre para el archivo BAR.
  3. Pulse Finalizar. Se abre un panel titulado Preparar. Este panel muestra las opciones para crear un nuevo archivo de archivado de intermediario.
  4. Añada los dos flujos al archivo BAR y luego guarde las opciones (Control+S).
  5. Ahora compile el archivo BAR pulsando el botón Compilar archivador de intermediario. El archivo BAR que ha creado aparece en la carpeta BAR del proyecto JMSNodesSampleFlowProject en la vista Desarrollo de intermediario.
  6. Pulse el archivo BAR y arrástrelo al grupo de ejecución default en la vista Intermediarios. Esta acción despliega los flujos en el intermediario.

Ahora ya puede ejecutar el ejemplo.

Volver a la página inicial del ejemplo