Instale las extensiones definidas por el usuario que ha desarrollado usted mismo o ha adquirido de un proveedor de software independiente, con un mínimo de intervención del usuario.
Realice las siguientes tareas:
Debe instalar extensiones definidas por el usuario en todos los sistemas WebSphere Message Broker adecuados y, si la extensión es un nodo definido por el usuario, en los sistemas WebSphere Message Broker Toolkit (los analizadores definidos por el usuario no tienen ningún componente WebSphere Message Broker Toolkit). Si la extensión es un nodo definido por el usuario que contiene un compilador personalizado, debe instalar el archivo compilado de extensión definido por el usuario y el plug-in de nodo definido por el usuario en los intermediarios en los que desee desplegar el nodo. 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.
Si 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.
Antes de instalar un nodo definido por el usuario, compruebe la versión de WebSphere Message Broker Toolkit en la que está realizando la instalación, porque puede que una versión específica de WebSphere Message Broker Toolkit sea uno de los requisitos previos 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.
Es posible que tenga que detectar las versiones de WebSphere Message Broker que están instaladas para asegurarse de que el archivo LIL correcto está cargado con el nivel correcto de intermediario. Consulte el apartado Detección de versiones instaladas de WebSphere Message Broker.
Para añadir los archivos .jar o .lil a las instalaciones de intermediario en WebSphere Message Broker Versión 8.0 o posterior, consulte Instalación de archivos de ejecución de extensión definida por el usuario en un intermediario.
Para obtener más información, consulte el Mandato mqsicreatebroker y el Mandato mqsichangebroker.
Realice este cambio creando un script de entorno personalizado en el directorio de trabajo:
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 debe limitar el ámbito únicamente a añadir las siguientes variables:
En Windows: Este ejemplo muestra el perfil de entorno de MyExtension, que está instalado en C:\Program Files\MyExtensions en Windows de 32 bits o en C:\Program
Files(x86)\MyExtensions en Windows de 64 bits.
El script se denomina MyExtension.cmd y se almacena en el directorio de trabajo. La ubicación predeterminada es %APPLICATIONDATA%\IBM\MQSI\common\profiles, donde el valor predeterminado para la variable de entorno %APPLICATIONDATA% depende del sistema operativo:
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"
En Linux y UNIX: En este ejemplo se muestra el perfil de entorno de MyExtension, 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: