Instalación de una ampliación definida por el usuario para la versión actual y versiones anteriores del intermediario

Antes de empezar

  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 es para usuarios de productos de otras empresas que quieran hacer una instalación de WebSphere Message Broker con la mínima intervención por parte del usuario.

Para instalar una ampliación definida por el usuario, la ampliación debe instalarse para la ejecución y para el kit de herramientas. Los componentes pueden instalarse por separado o como parte de un proceso. Los componentes pueden estar en sistemas diferentes, por lo que asegúrese de que el usuario final ejecuta las instalaciones en todos los sistemas involucrados.

Instalación para el kit de herramientas

Antes de instalar una ampliación, puede que tenga que saber sobre qué versión del kit de herramientas está instalando, ya que puede que la ampliación definida por el usuario tenga una determinada versión del kit de herramientas como requisito previo o necesite determinados archivos para ejecutarse.

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

Si el producto comparte shell con otro producto, la vía de acceso de instalación será la del programa RAD (rapid application development) que se instaló primero. Efectúe 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, debe mirar en el archivo cdi_ref.properties, configurado por RAD. Los productos de Rational Versión 6.x y el Kit de herramientas de Message Brokers instalan este archivo: la primera vez que uno de estos productos se instala, se crea el archivo. Todas las instalaciones subsiguientes lo comparten. Si todos los prosuctos de Rational Versión 6.x y el Kit de herramientas de Message Brokers se desinstalan, el archivo se elimina cuando el último producto se desinstala.

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

    En esta instancia, $D(os_main) es una variable de Installshield en la que se crea la infraestructura de instalación de la CDI utilizada.

  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 las dos ubicaciones, en este orden:
      1. %windir%/IBM/RAT60/.sdpinst/cdi_ref.properties
      2. %SystemRoot%/IBM/RAT60/.sdpinst/cdi_ref.properties
  3. Obtenga la siguiente información del archivo cdi_ref.properties:
    1. Para detectar la presencia de una instalación del Kit de herramientas de Message Brokers, busque c_wmbt_specific.products=wmbt

      Para la ubicación, mire la siguiente variable: 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 la ubicación del área de trabajo mire la variable c_wb.b_wb.location.

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

      Por ejemplo, /opt/ibm/MessageBrokerToolkit/6.0

Observe 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 ocurrir si se ha instalado otro producto RAD antes que WebSphere Message Broker.

Si no existe cdi_ref.properties, no hay productos RAD instalados y el Kit de herramientas de Message Brokers no está instalado.

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

El archivo llamado opt/ibm/MessageBrokerToolkit/6.0/Myextension puede contener la línea path=/opt/My/Extension/Nodes. El directorio al que apunta esa línea debe contener los fragmentos de plug-in que se han reunido siguiendo las instrucciones del apartado Distribución de un nodo definido por el usuario.

Instale una extensión definida por el usuario en un dominio de intermediarios. Para obtener instrucciones sobre cómo instalar una ampliación definida por el usuario, consulte el apartado Instalación de una extensión definida por el usuario en un dominio de intermediarios. Cuando haya instalado la ampliación, reinicie el área de trabajo de destino con la opción -clean. Puede hacerlo desde la línea de mandatos o modificando el método abreviado del menú. La opción -clean debe utilizarse siempre que se realicen cambios en las ampliaciones definidas por el usuario, para asegurarse de que entren en vigor en la paleta de nodos de flujo de mensajes. Cuando se haya reiniciado el área de trabajo, la nueva categoría de nodos aparecerá en la paleta del editor de flujos.

Instalación de la Ejecución

Puede que necesite detectar la versión de la ejecución que está instalada, 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 instalaciones de ejecución en WebSphere Business Integration Message Broker Versión 5.0 o posterior, modifique la vía de acceso lil (de biblioteca de implementación cargable) para que contenga el directorio que contiene el archivo añadido. Para intermediarios de la versión 2, añada el plug-in a <WebSphere Brokers Install Dir>/lil/.

Ampliación para un único intermediario

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

Ampliación para varios intermediarios

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

Script de ejemplo

Perfil de entorno para MyExtension, instalado en C:\Archivos de Programa\MyExtensions. El script se llama C:\Documents and Settings\All Users\Application Data\IBM\MQSI\common\profiles\MyExtension.cmd:
REM Added by MyExtension install, do not modify
set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Archivos de Programa\MyExtension\bin"
Perfil de entorno para MyExtension, instalado en /opt/MyExtension. El script se llama /var/mqsi/common/profiles/MyExtension.sh:
#!/bin/ksh
# Added by MyExtension install, do not modify
export MQSI_LILPATH=/opt/MyExtension/lil${MQSI_LILPATH:+":"${MQSI_LILPATH}}

Puede probar las siguientes variables en el script de perfil, por ejemplo, si desea asegurarse de que una ampliación definida por el usuario sólo se ejecuta en una versión determinada 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
Versión de WebSphere Message Broker, con el formato version.release.modification.fix
MQSI_VERSION_V
El valor de la versión mayor 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: 04/05/2006
as04540_