Instale as extensões definidas pelo usuário que você mesmo desenvolveu ou adquiriu de um fornecedor de software independente, com o mínimo de intervenção do usuário.
Conclua as seguintes tarefas:
Você deve instalar extensões definidas pelo usuário em todos os computadores WebSphere Message Broker apropriados e, se a extensão for um nó definido pelo usuário, nos computadores WebSphere Message Broker Toolkit (analisadores definidos pelo usuário não possuem um componente WebSphere Message Broker Toolkit). Se sua extensão for um nó definido pelo usuário que contém um compilador customizado, você deverá instalar o arquivo de extensão definido pelo usuário compilado e o plug-in do nó definido pelo usuário nos brokers para os quais deseja implementar o nó. Os componentes podem ser instalados separadamente ou como parte de um processo. Os componentes podem estar em sistemas diferentes, portanto, verifique se as instalações foram concluídas em todos os sistemas afetados.
Se uma extensão grava mensagens para o rastreio do usuário, é necessário atualizar a variável de ambiente MQSI_CONSOLE_NLSPATH (sistemas Windows), ou NLSPATH (todos os outros sistemas) para que o comando mqsiformatlog possa localizar o catálogo de mensagens.
Antes de instalar um nó definido pelo usuário, verifique a versão do WebSphere Message Broker Toolkit no qual está instalando, pois uma versão específica do WebSphere Message Broker Toolkit pode ser um pré-requisito da extensão definida pelo usuário ou pode exigir arquivos específicos para executar.
Para determinar a versão, consulte Detectando Versões Instaladas do WebSphere Message Broker.
Pode ser necessário detectar as versões do WebSphere Message Broker que estão instaladas, para garantir que o arquivo LIL correto seja carregado pelo nível correto do broker. Consulte o Detectando Versões Instaladas do WebSphere Message Broker.
Para incluir arquivos .jar ou .lil nas instalações do broker no WebSphere Message Broker Versão 8.0 e posterior, consulte Instalando Arquivos de Tempo de Execução da Extensão Definida pelo Usuário em um Intermediário.
Para obter informações adicionais, consulte o Comando mqsicreatebroker e o Comando mqsichangebroker.
Faça essa alteração criando um script de ambiente customizado no diretório ativo:
Você pode fornecer qualquer nome ao script de ambiente, mas a extensão do arquivo deve ser .cmd no Windows e .sh em todas as outras plataformas. O script pode executar todas as operações de um shell script, mas você deve limitar o escopo a apenas incluir as seguintes variáveis:
No Windows: Este exemplo mostra o perfil do ambiente para
MyExtension, que está instalado em C:\Program Files\MyExtensions no Windows 32 bits ou em C:\Program
Files(x86)\MyExtensions no Windows 64 bits.
O script é chamado MyExtension.cmd e armazenado no diretório de trabalho. O local padrão é %APPLICATIONDATA%\IBM\MQSI\common\profiles em que a configuração padrão para a variável de ambiente %APPLICATIONDATA% depende do sistema operacional:
O script Windows tem o seguinte conteúdo:
REM incluído pela instalação MyExtension, não modifique
set MQSI_LILPATH=%MQSI_LILPATH%;"C:\Arquivos de Programas\MyExtension\bin"
No Linux e UNIX: Este exemplo mostra o perfil de ambiente
para MyExtension, que é instalado em /opt/MyExtension.
O script é chamado deMyExtension.sh e é armazenado no diretório de trabalho /var/mqsi/common/profiles/.
O script Linux tem o seguinte conteúdo:
#!/bin/ksh
# Added by MyExtension install, do not modify
export MQSI_LILPATH=/opt/MyExtension/lil${MQSI_LILPATH:+":"${MQSI_LILPATH}}
Você pode testar as seguintes variáveis no script do perfil, por exemplo, se você deseja assegurar-se de que uma extensão definida pelo usuário seja executada apenas em uma versão específica do broker: