WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Instalando uma Extensão Definida pelo Usuário para Versões Atuais ou Antigas do WebSphere Message Broker

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.

Antes de começar

Conclua as seguintes tarefas:

  1. Compilando um Nó Java Definido pelo Usuário, Compilando uma Extensão Definida pelo Usuário em C ou Criando Um Nó Definido Pelo Usuário a Partir de Um Subfluxo
  2. Criando a Representação da Interface com o Usuário de um Nó Definido pelo Usuário no WebSphere Message Broker Toolkit
  3. Testando um Nó Definido pelo Usuário
  4. Empacotando e Distribuindo Um Projeto de Nó Definido Pelo Usuário

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.

A Instalação do WebSphere Message Broker Toolkit

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.

  1. Copie seus arquivos em um diretório que o WebSphere Message Broker Toolkit possa acessar, para que você possa visualizar seu nó definido pelo usuário na sessão do WebSphere Message Broker Toolkit. Escolha uma das seguintes opções:
    • Inclua seu novo arquivo JAR de plug-in diretamente ao diretório dropins em que o WebSphere Message Broker Toolkit é instalado. Por exemplo, no Windows 32 bits, inclua o arquivo em C:\Program Files\IBM\WMBT800\dropins.

      Se você escolher esta opção, você pode achá-la difícil de gerenciar seus arquivos de plug-ins com segurança se você removê-los ou substitui-los posteriormente. Seu administrador do sistema também pode querer controlar a segurança e o acesso em computadores utilizados por mais de um usuário e pode não configurar permissões para usuários para gravar nos diretórios de instalação primários.

    • Crie arquivos de link do Eclipse para os diretórios no qual você mantém seus arquivos de plug-in.
      Para obter detalhes sobre como criar arquivos de link, consulte o artigo developerWorks sobre Utilizando os Recursos do Eclipse (a seção entitulada "Usando arquivos de link para gerenciar uma instalação do Eclipse").
      1. Linux platformNo Linux: Exclua qualquer diretório .eclipse existente em seu diretório inicial e reinicie o WebSphere Message Broker Toolkit. Por exemplo, remova o seguinte diretório, em que userid é a sua identificação de usuário: /home/userid/.eclipse
      2. Crie um diretório chamado eclipse e um local compatível no seu sistema de arquivo; a estrutura do diretório que contém o diretório eclipse não é significativa.
      3. Dentro do diretório eclipse, crie os diretórios chamados features e plugins.
      4. Windows platformNo Windows: No C:\Program Files\IBM\WMBT800, crie uma nova pasta de links e crie um arquivo chamado name.link, em que name é um nome que você escolheu. Digite o texto a seguir path=C:/path/to/your/dir/ no arquivo name.link, em que path/to/your/dir/ é o caminho para seu diretório.

        Exemplo: Se você colocou os seus plug-ins em C:\Temp\MyPlugins\eclipse\plugins\, o conteúdo do arquivo de link será path=C:/Temp/MyPlugins.

  2. Reinicie sua sessão WebSphere Message Broker Toolkit para que as alterações surtam efeito.

Instalações do 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.

Instalando uma extensão definida pelo usuário para um broker único

Versão 7.0 e Versão 8.0
  • Para tornar uma extensão acessível a partir apenas de um broker no sistema, modifique a configuração de UserLilPath para o broker especificando o parâmetro -l no comando mqsicreatebroker ou mqsichangebroker.
Versão 6.1 e anterior
  • Para tornar uma extensão de 32 bits acessível a partir de apenas um broker no sistema, modifique a configuração UserLilPath para o navegador especificando o parâmetro -l no comando mqsicreatebroker ou mqsichangebroker.
  • Para tornar uma extensão de 64 bits acessível a partir de apenas um broker no sistema, modifique a configuração de UserLilPath64 para o broker especificando o parâmetro -r no comando mqsicreatebroker ou mqsichangebroker.

Para obter informações adicionais, consulte o Comando mqsicreatebroker e o Comando mqsichangebroker.

Instalando uma extensão definida pelo usuário para vários brokers

Versão 7.0 e Versão 8.0
  • Para afetar todos os brokers em um sistema, modifique o sistema LILPATH. Anexe o diretório contendo o diretório que possui os arquivos de extensão para a variável de ambiente MQSI_LILPATH . MQSI_LILPATH64 não é válido nesta versão.
Versão 6.1 e anterior
  • Para afetar todos os brokers em um sistema, modifique o sistema LILPATH. Anexe o diretório que contém o diretório que possui os arquivos de extensão à variável de ambiente MQSI_LILPATH (para extensões de 32 bits) ou MQSI_LILPATH64 (para extensões de 64 bits).

Faça essa alteração criando um script de ambiente customizado no diretório ativo:

  • Linux platformUNIX platformEm sistemas Linux e UNIX: /var/mqsi/common/profiles
  • Windows platformNo Windows: %APPLICATIONDATA%\IBM\MQSI\common\profiles em que %APPLICATIONDATA% é a variável de ambiente que define o diretório ativo do sistema. O diretório padrão depende do sistema operacional:
    • No Windows XP e Windows Server 2003: C:\Documents and Settings\All Users\IBM\MQSI\common\profiles
    • No Windows 7 e Windows Server 2008: C:\ProgramData\IBM\MQSI\common\profiles
    O valor real deve ser diferente em seu computador.

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:

MQSI_LILPATH
Define os diretórios a serem procurados para plug-ins
CLASSPATH
Defina os locais nos quais o Java procura por classes adicionais
MQSI_CONSOLE_NLSPATH
No Windows: Defina o local dos catálogos de mensagens (arquivos DLL)
NLSPATH
No Linux e UNIX: Defina o local dos catálogos de mensagens (arquivos CAT)
PATH
Define o local dos arquivos executáveis. No Windows: Esta variável também define o local das bibliotecas dependentes.
LIBPATH / SHLIB_PATH / LD_LIBRARY_PATH
No UNIX e Linux: Define o local das bibliotecas dependentes.

Examplos de scripts

Windows platformNo 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:

  • No Windows XP e Windows Server 2003: C:\Documents and Settings\All Users\.
  • No Windows 7 e Windows Server 2008: C:\ProgramData\IBM\MQSI\common\profiles.
O valor real deve ser diferente em seu computador.

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"

Linux platformUNIX platformNo 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:

MQSI_FILEPATH
O caminho completo para o arquivo instalado do WebSphere Message Broker
MQSI_WORKPATH
O caminho completo para os dados de configuração do WebSphere Message Broker
MQSI_VERSION
Versão WebSphere Message Broker, no formato version.release.modification.fix
MQSI_VERSION_V
O valor da versão principal do WebSphere Message Broker
MQSI_VERSION_R
O valor do release do WebSphere Message Broker
MQSI_VERSION_M
O valor do número de modificação do WebSphere Message Broker
MQSI_VERSION_F
O valor do nível de correção WebSphere Message Broker
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:20


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | as04540_