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

Antes de comenzar

  1. Debe haber compilado el nodo definido por el usuario, como se describe en Compilación de un nodo Java definido por el usuario o Compilación de una extensión C definida por el usuario.
  2. Debe haber comprobado el nodo definido por el usuario como se describe en Comprobación de un nodo definido por el usuario.

Este tema está dirigido a los usuarios de productos de terceros que desean instalar WebSphere Message Broker con la mínima intervención manual posible.

Para poder instalar una extensión definida por el usuario, se ha de instalar la extensión en la ejecución y en el kit de herramientas. Los componentes se pueden instalar por separado o como parte de un proceso. Los componentes pueden estar en sistemas diferentes, por lo tanto, debe asegurarse de que el usuario final ejecute las instalaciones en todos los sistemas afectados.

Instalación del kit de herramientas

Antes de instalar una extensión, es posible que tenga que establecer la versión del kit de herramientas en el que realiza la instalación, ya que es posible que un requisito previo de la extensión definida por el usuario sea una versión específica o que se requiera la ejecución de archivos específicos.

Para determinar la versión del kit de herramientas, consulte Detección de las versiones del WebSphere Message Broker.

Si el producto se comparte en el shell con otro producto, la vía de acceso de la instalación será la vía de acceso en la que se ha instalado en primer lugar el programa RAD. Utilice los pasos siguientes para determinar la ubicación del kit de herramientas.

Para determinar la ubicación de la instalación del kit de herramientas, tiene que consultar el archivo cdi_ref.properties, como lo ha configurado RAD. Este archivo lo instala Kit de herramientas de Message Brokers y los productos 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 Kit de herramientas de Message Brokers y todos los productos Rational Versión 6.x, se suprime el archivo cuando se desinstala el último producto.

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

    En este caso, $D(os_main) es una variable de Installshield, en la que se crea la infraestructura de instalación de CDI que utilizamos.

  2. Si no está utilizando 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 de propiedades cdi_ref.properties para detectar la presencia de una instalación de Kit de herramientas de Message Brokers. Busque c_wmbt_specific.products=wmbt

    Para obtener la ubicación, busque la variable siguiente: c_wmbt_specifc.b_wmbt_specific.location.

    Por ejemplo, C:\Archivos de programa\IBM\MessageBrokersToolkit\6.0

    Por ejemplo, /opt/ibm/MessageBrokerToolkit/6.0

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

    Por ejemplo, C:\Archivos de programa\IBM\MessageBrokersToolkit\6.0

    Por ejemplo, /opt/ibm/MessageBrokerToolkit/6.0

Tenga en cuenta que el valor de c_wb.b_wb.location puede no ser el mismo que el valor de c_wmbt_specifc.b_wmbt_specific.location. Esto puede suceder si se ha instalado antes otro producto RAD WebSphere Message Broker.

Si no existe cdi_ref.properties, no hay ningún producto Rational instalado y Kit de herramientas de Message Brokers no se instalará.

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

El archivo denominado opt/ibm/MessageBrokerToolkit/6.0/Myextension puede contener la línea path=/opt/My/Extension/Nodes. El directorio al que apunta dicha línea debe contener los fragmentos del plugin que ha ensamblado utilizando las instrucciones de Distribución de una extensión definida por el usuario.

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 cuando realice cambios en las 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.

Instalación de ejecución

Es posible que tenga que detectar la versión del tiempo de ejecución que está instalada para asegurarse de que el nivel del intermediario correcto carga el archivo .lil correcto. Consulte el apartado Detección de las versiones del WebSphere Message Broker.

Para añadir archivos .jar o .lil a las instalaciones de tiempo de ejecución en WebSphere Business Integration Message Broker Versión 5.0 o posterior, Inicio del cambio consulte la sección Instalación de una extensión definida por el usuario en un dominio de intermediariosFin del cambio. Para los intermediarios de la versión 2, añada el plugin a <directorio instalación intermediarios WebSphere>/lil/ y reinicie el intermediario.

Extensión de un intermediario individual

Si la extensión sólo será accesible desde un único intermediario del sistema, puede modificar la vía de acceso de .lil de usuario para dicho intermediario, utilizando el parámetro -l en el mandato mqsicreatebroker o mqsichangebroker. Para más obtener información, consulte Mandato mqsicreatebroker y Mandato mqsichangebroker.

Extensión de varios intermediarios

Para que afecte a todos los intermediarios de un sistema, la vía de acceso de lil del sistema se debe modificar. Esto puede llevarse a cabo añadiendo el directorio que contiene el directorio con la extensión a la variable de entorno MQSI_LILPATH. Puede hacerlo creando un script de entorno personalizado %ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\profiles en Windows, o /var/mqsi/common/profiles en UNIX. Puede asignar cualquier nombre al script de entorno, pero la extensión de archivo debe ser .cmd en Windows y .sh en todas las otras plataformas. El script puede realizar todas las operaciones de un script del shell pero debe limitar el ámbito únicamente a añadir las siguientes variables:
MQSI_LILPATH
Define los directorios para buscar los plugins
CLASSPATH
Define las ubicaciones Java para buscar las clases adicionales
NLSPATH
Define la ubicación de los catálogos de mensajes
PATH
Define la ubicación de los archivos ejecutables. En Windows también define la ubicación de las bibliotecas dependientes.
LIBPATH / SHLIB_PATH / LD_LIBRARY_PATH
Define la ubicación de las bibliotecas dependientes.

Script de ejemplo

El perfil de entorno para MyExtension, se instala en C:\Archivos de programa\MyExtensions. El script se denomina C:\Documents and Settings\All Users\Application Data\IBM\MQSI\common\profiles\MyExtension.cmd:
REM se añade mediante la instalación de MyExtension, no se ha de modificar
set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Archivos de programa\MyExtension\bin"
El perfil de entorno para MyExtension, instalado en /opt/MyExtension. El script se denomina /var/mqsi/common/profiles/MyExtension.sh:
#!/bin/ksh
# Se añade mediante la instalación de MyExtension, no se ha de modificar
export MQSI_LILPATH=/opt/MyExtension/lil${MQSI_LILPATH:+":"${MQSI_LILPATH}}

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

MQSI_FILEPATH
Contiene la vía de acceso completa al archivo instalado para WebSphere Message Broker
MQSI_WORKPATH
Contiene 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, 2006 Última actualización: 22/08/2006
as04540_