Instalación de una extensión definida por el usuario en versiones actuales y anteriores del intermediario

Instale las extensiones definidas por el usuario que ha desarrollado usted mismo o ha adquirido de otros proveedores de software, con el mínimo de intervención del usuario.

Antes de empezar

Realice las siguientes tareas:

  1. Compilación de un nodo Java definido por el usuario o Compilación de una extensión C definida por el usuario
  2. Creación de la representación de interfaz de usuario de un nodo definido por el usuario en el entorno de trabajo
  3. Comprobación de un nodo definido por el usuario
  4. Empaquetado de un proyecto de entorno de trabajo de nodo definido por el usuario

Debe instalar extensiones definidas por el usuario en todos los sistemas de intermediario adecuados y, si la extensión es un nodo definido por el usuario, en los sistemas de entorno de trabajo (los analizadores definidos por el usuario no tienen componente de entorno de trabajo). Los componentes se pueden instalar por separado o como parte de un proceso. Los componentes pueden estar en sistemas diferentes, por consiguiente compruebe que las instalaciones se hayan completado en todos los sistemas afectados.

Inicio del cambioSi una extensión graba mensajes en el rastreo del usuario, debe actualizar la variable de entorno MQSI_CONSOLE_NLSPATH (sistemas Windows) o NLSPATH (todos los otros sistemas) para que el mandato mqsiformatlog pueda encontrar el catálogo de mensajes. Fin del cambio

La instalación de Kit de herramientas de Message Brokers

Antes de instalar un nodo definido por el usuario, establezca la versión del Kit de herramientas de Message Brokers en el que va a realizar la instalación, porque puede que una versión específica del kit de herramientas sea un requisito previo de la extensión definida por el usuario o que requiera la ejecución de archivos específicos.

Para determinar la versión, consulte Detección de versiones instaladas de WebSphere Message Broker.

Si el producto está compartiendo shell con otro producto, la vía de instalación la determina el primer programa Rational que se ha instalado. Para determinar la ubicación de la instalación del Kit de herramientas de Message Brokers, examine el archivo cdi_ref.properties que está configurado por Rational. Este archivo se ha instalado con el Kit de herramientas de Message Brokers y con los productos de Rational Versión 6.x;, la primera vez que se instala uno de estos productos, se crea el archivo. Lo comparten todas las instalaciones siguientes. Si se desinstalan todos los productos del Kit de herramientas de Message Brokers y de Rational Versión 6.x, el archivo se elimina cuando se haya desinstalado el último producto.

  1. Si utiliza Installshield Multiplatform Edition para determinar la ubicación, ésta se resuelve en $D(os_main)/IBM/RAT60/.sdpinst/cdi_ref.properties.

    En este ejemplo, $D(os_main) es una variable de Installshield, que la infraestructura de instalación CDI utilizaba.

  2. Si no utiliza Installshield Multiplatform Edition:
    1. La ubicación se resuelve en /etc/IBM/RAT60/.sdpinst/cdi_ref.properties
    2. Busque el archivo en dos ubicaciones con el orden siguiente:
      1. %windir%/IBM/RAT60/.sdpinst/cdi_ref.properties
      2. %SystemRoot%/IBM/RAT60/.sdpinst/cdi_ref.properties
  3. Utilice el archivo cdi_ref.properties para detectar la presencia de una instalación del Kit de herramientas de Message Brokers; busque c_wmbt_specific.products=wmbt en este archivo.

    Para obtener la ubicación, examine el contenido de la variable: c_wmbt_specifc.b_wmbt_specific.location.

    Windows platform Por ejemplo C:\Archivos de programa\IBM\MessageBrokersToolkit\6.0.

    Linux platform Por ejemplo /opt/ibm/MessageBrokerToolkit/6.0.

    Para obtener la ubicación de entorno de trabajo, consulte la variable c_wb.b_wb.location.

    Windows platform Por ejemplo C:\Archivos de programa\IBM\MessageBrokersToolkit\6.0.

    Linux platform Por ejemplo /opt/ibm/MessageBrokerToolkit/6.0.

    El valor de c_wb.b_wb.location puede no ser el mismo que el valor de c_wmbt_specifc.b_wmbt_specific.location. Esta discrepancia se puede producir si se ha instalado otro producto Rational antes que WebSphere Message Broker.

    Si cdi_ref.properties no existe, no se instalará ningún producto de Rational y no se instalará el Kit de herramientas de Message Brokers en este sistema.

Para configurar el Kit de herramientas de Message Brokers con iconos y opciones para un nuevo nodo definido por el usuario, configure un nuevo archivo de enlace de Eclipse que apunte al directorio que contiene los archivos de plug-in de Eclipse. El archivo de enlace debe contener una línea que especifique la vía de acceso completa del directorio de destino. Cuando cree el archivo de enlace de Eclipse, colóquelo en <c.wb.b_wb.location>/eclipse/links/.

Copie el archivo comprimido que ha creado en Empaquetado de un proyecto de entorno de trabajo de nodo definido por el usuario en el directorio identificado por el archivo de enlace. Extraiga el contenido en ese directorio. Por ejemplo:

Linux platform El archivo denominado opt/ibm/MessageBrokerToolkit/6.0/eclipse/links/Myextension.link puede contener la línea path=/opt/My/Extension/Nodes/eclipse/plugins/nombre_de_su_nodo. El directorio al que apunta la variable de vía de acceso debe incluir el contenido del archivo comprimido que creó anteriormente cuando empaquetó el proyecto.

Cuando haya instalado la extensión, reinicie el entorno de trabajo de destino con la opción -clean. Puede hacerlo desde la línea de mandatos o modificando el acceso directo al menú. Debe utilizar la opción -clean cada vez que se realicen cambios en extensiones definidas por el usuario para asegurarse de que la paleta de nodos del flujo de mensajes captura los cambios. Cuando se haya reiniciado el entorno de trabajo, la nueva categoría de nodos aparecerá en la paleta del editor de flujos.

Si es un usuario de Eclipse experimentado o un desarrollador de plug-ins, tal vez desee utilizar funciones de Eclipse más avanzadas para manejar productos adicionales como las extensiones definidas por el usuario. Por ejemplo, puede empaquetar extensiones definidas por el usuario como características de Eclipse, en lugar de plug-ins.

Las características tienen varias ventajas:

  • Puede incluir muchos plug-ins relacionados en una sola característica.
  • Puede definir una característica de tal manera que su uso esté restringido a versiones determinadas de su entorno de trabajo.
  • Puede proporcionar actualizaciones automatizadas de características utilizando el Gestor de actualizaciones de Eclipse.

Para obtener una descripción completa de éstas y otras opciones avanzadas de Eclipse, consulte la documentación PDE Guide, que incluye una sección sobre la creación de características. También puede encontrar útil la descripción del manifiesto de característica en "Navigating and customizing the workbench".

Instalación de ejecución

Es posible que tenga que detectar la versión de los componentes de ejecución que se instalan para asegurarse de que el nivel correcto del intermediario carga el archivo LIL correcto. Consulte el apartado Detección de versiones instaladas de WebSphere Message Broker.

Para añadir archivos .jar o .lil a las instalaciones de ejecución en WebSphere Business Integration Message Broker Versión 5.0 o posterior y WebSphere Message Broker Versión 6.0 y posterior, consulte Instalación de archivos de ejecución de extensión definida por el usuario en un intermediario. Para intermediarios de la Versión 2, añada los archivos de extensión definidos por el usuario a dir_instalación/lil/, y reinicie el intermediario.

Instalación de una extensión definida por el usuario para un único intermediario

Para hacer que una extensión de 32 bits sea accesible desde un solo intermediario del sistema, modifique el valor UserLilPath para el intermediario especificando el parámetro -l en el mandato mqsicreatebroker o mqsichangebroker.

No puede utilizar el parámetro -l para modificar la LILPATH de usuario para extensiones de 64 bits. En su lugar, añada el directorio que contiene el directorio que incluye los archivos de extensión a la variable de entorno MQSI_LILPATH64, tal como se describe en la sección siguiente.

Inicio del cambioPara más información, consulte los mandatos mqsicreatebroker y mqsichangebroker.Fin del cambio

Instalación de una extensión definida por el usuario para varios intermediarios

Para afectar a todos los intermediarios de un sistema, debe modificar la LILPATH del sistema. Añada el directorio que contiene el directorio que incluye los archivos de extensión a la variable de entorno MQSI_LILPATH (para extensiones de 32 bits) o MQSI_LILPATH64 (para extensiones de 64 bits).

Puede realizar este cambio creando un script de entorno personalizado en el directorio de trabajo:

  • Linux platformUNIX platform En los sistemas Linux y UNIX, /var/mqsi/common/profiles
  • Windows platform En Windows, %ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\profiles donde el valor predeterminado para la variable de entorno %ALLUSERSPROFILE% es C:\Documents and Settings\All Users. El valor real podría ser diferente en el sistema.

Puede asignar cualquier nombre al script de entorno, pero la extensión de archivo debe ser .cmd en Windows y .sh en todas las demás plataformas. El script puede realizar todas las operaciones de un script de shell, pero se debería limitar el ámbito únicamente a añadir las siguientes variables:

MQSI_LILPATH
Define los directorios en los que buscar plug-ins de 32 bits
MQSI_LILPATH64
Define los directorios en los que buscar plug-ins de 64 bits
CLASSPATH
Define las ubicaciones en las que Java debe buscar clases adicionales
Inicio del cambioMQSI_CONSOLE_NLSPATHFin del cambio
Inicio del cambioEn los sistemas Windows, define la ubicación de los catálogos de mensajes (archivos DLL)Fin del cambio
NLSPATH
Inicio del cambioEn los sistemas Linux y UNIX, define la ubicación de los catálogos de mensajes (archivos CAT)Fin del cambio
PATH
Define la ubicación de los archivos ejecutables. En Windows, esta variable también define la ubicación de las bibliotecas dependientes.
LIBPATH / SHLIB_PATH / LD_LIBRARY_PATH
Define la ubicación de las bibliotecas dependientes en sistemas UNIX y Linux.

Scripts de ejemplo

Windows platform En este ejemplo se muestra el perfil de entorno de MyExtension en Windows, que se instala en C:\Program Files\MyExtensions.

El script se denomina MyExtension.cmd y se almacena en el directorio de trabajo. La ubicación predeterminada es %ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\profiles. donde el valor predeterminado de la variable de entorno %ALLUSERSPROFILE% es C:\Documents and Settings\All Users\.

El script de Windows tiene el contenido siguiente:

REM Se añade mediante la instalación de MyExtension, no modificar
set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Archivos de programa\MyExtension\bin"

UNIX platform Este ejemplo muestra el perfil de entorno para MyExtension en Linux, que se instala en /opt/MyExtension. El script también se denomina MyExtension.sh y se almacena en el directorio de trabajo /var/mqsi/common/profiles/.

El script de Linux tiene el contenido siguiente:

#!/bin/ksh
# Se añade mediante la instalación de MyExtension, no modificar
export MQSI_LILPATH=/opt/MyExtension/lil${MQSI_LILPATH:+":"${MQSI_LILPATH}}

Puede probar las variables siguientes en el script del perfil, si desea, por ejemplo, asegurarse de que una extensión definida por el usuario sólo se ejecuta en una versión específica del intermediario:

MQSI_FILEPATH
La vía de acceso completa al archivo instalado para WebSphere Message Broker
MQSI_WORKPATH
La vía de acceso completa a los datos de configuración para WebSphere Message Broker
MQSI_VERSION
La versión de WebSphere Message Broker con el formato versión.release.modificación.arreglo
MQSI_VERSION_V
El valor de la versión principal de WebSphere Message Broker
MQSI_VERSION_R
El valor del release de WebSphere Message Broker
MQSI_VERSION_M
El valor del número de modificación de WebSphere Message Broker
MQSI_VERSION_F
El valor del nivel de arreglo de WebSphere Message Broker
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última actualización : 2009-02-16 13:56:09

as04540_