Instalando uma Extensão Definida pelo Usuário para as Versões Atual e Antiga do Intermediário

Instale extensões definidas pelo usuário que você mesmo tenha desenvolvido ou tenha adquirido de outros fornecedores de software 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árioouCompilando uma Extensão Definida pelo Usuário em C
  2. Criando a Representação da Interface com o Usuário de um Nó Definido pelo Usuário no ambiente de trabalho
  3. Testando um Nó Definido pelo Usuário
  4. Empacotando um Projeto do ambiente de trabalho de Nó Definido pelo Usuário

Você deve instalar extensões definidas pelo usuário em todos os computadores apropriados do intermediário e, se a extensão for um nó definido pelo usuário, nos computadores do ambiente de trabalho (analisadores definidos pelo usuário não possuem um componente de ambiente de trabalho). 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.

Início da mudançaSe 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. Fim da mudança

A Instalação do Message Brokers Toolkit

Antes de instalar um nó definido pelo usuário, verifique a versão do Message Brokers Toolkit para o qual estiver instalando, pois uma versão específica do kit de ferramentas pode ser um pré-requisito da extensão definida pelo usuário, ou pode requerer arquivos específicos para executar.

Para determinar a versão, consulte Detectando Versões Instaladas do WebSphere Message Broker.

Se o produto for de compartilhamento de shell com outro produto, o caminho de instalação será determinado pelo primeiro programa Rational que foi instalado. Para determinar o local da instalação do Message Brokers Toolkit, consulte o arquivo cdi_ref.properties configurado pela Rational. Este arquivo é instalado pelo Message Brokers Toolkit e por produtos Rational Versão 6.x; na primeira vez em que estes produtos for instalado o arquivo será criado. Ele será compartilhado por todas as instalações subseqüentes. Se todos os produtos Message Brokers Toolkit e Rational Versão 6.x forem desinstalados o arquivo será removido quando o último produto for desinstalado.

  1. Se você estiver utilizando o Installshield Multiplatform Edition para determinar o local, o local será resolvido para $D(os_main)/IBM/RAT60/.sdpinst/cdi_ref.properties.

    Nessa instância, $D(os_main) é uma variável Installshield, que a estrutura de instalação de CDI utiliza.

  2. Se você não estiver utilizando o Installshield Multiplatform Edition:
    1. O local será resolvido como /etc/IBM/RAT60/.sdpinst/cdi_ref.properties
    2. Procure pelo arquivo em dois locais, na seguinte ordem:
      1. %windir%/IBM/RAT60/.sdpinst/cdi_ref.properties
      2. %SystemRoot%/IBM/RAT60/.sdpinst/cdi_ref.properties
  3. Utilize o arquivo cdi_ref.properties para detectar a presença de uma instalação do Message Brokers Toolkit; procure por c_wmbt_specific.products=wmbt dentro deste arquivo.

    Para o local, examine o conteúdo da variável: c_wmbt_specifc.b_wmbt_specific.location.

    Windows platform Por exemplo, C:\Program Files\IBM\MessageBrokersToolkit\6.0.

    Linux platform Por exemplo, /opt/ibm/MessageBrokerToolkit/6.0.

    Para o local do ambiente de trabalho, consulte a variável c_wb.b_wb.location.

    Windows platform Por exemplo, C:\Program Files\IBM\MessageBrokersToolkit\6.0.

    Linux platform Por exemplo, /opt/ibm/MessageBrokerToolkit/6.0.

    O valor de c_wb.b_wb.location talvez não seja o mesmo valor de c_wmbt_specifc.b_wmbt_specific.location. Essa discrepância poderá ocorrer se um outro produto Rational tiver sido instalado antes do WebSphere Message Broker.

    Se o cdi_ref.properties não existir, nenhum produto Rational é instalado e o Message Brokers Toolkit não é instalado neste computador.

Para configurar o Message Brokers Toolkit com ícones e opções para um novo nó definido pelo usuário, configure um um novo arquivo de link do Eclipse que aponte para o diretório que contém os arquivos de plug-in do Eclipse. O arquivo de link deve conter uma linha que especifique o caminho completo do diretório de destino. Ao criar o arquivo de link Eclipse, coloque-o em <c.wb.b_wb.location>/eclipse/links/.

Copie o arquivo compactado que você criou em Empacotando um Projeto do ambiente de trabalho de Nó Definido pelo Usuário para o diretório identificado por seu arquivo de link. Extraia o conteúdo nesse diretório. Exemplo:

Linux platform O arquivo nomeado opt/ibm/MessageBrokerToolkit/6.0/eclipse/links/Myextension.link pode conter a linha path=/opt/My/Extension/Nodes/eclipse/plugins/seu_nome_de_nó. O diretório apontado pela variável de caminho deve ter o conteúdo do arquivo compactado que você criou anteriormente quando empacotou o projeto.

Quando você tiver instalado a extensão, reinicie o ambiente de trabalho de destino com a opção -clean. Você pode fazer isso a partir da linha de comandos ou modificando o atalho do menu. Você deve utilizar a opção -clean sempre que alguma alteração for feita nas extensões definidas pelo usuário, para assegurar-se de que as alterações sejam captadas pela paleta do nó do fluxo de mensagens. Quando o ambiente de trabalho tiver iniciado novamente, a nova categoria de nós aparecerá na paleta do editor de fluxo.

Se você for um usuário experiente do Eclipse ou um desenvolvedor de plug-in, talvez queira utilizar funções mais avançadas do Eclipse para manipular produtos adicionais, como extensões definidas pelo usuário. Por exemplo, você pode empacotar extensões definidas pelo usuário como recursos do Eclipse, em vez de plug-ins.

Os recursos possuem várias vantagens:

  • É possível incluir vários plug-ins relacionados em um único recurso.
  • É possível definir um recurso de modo que seja restringido ao uso com versões específicas de seu ambiente de trabalho.
  • É possível fornecer atualizações automatizadas para recursos utilizando o Gerenciador de Atualização Eclipse.

Para obter uma descrição completa destas e de outras opções avançadas do Eclipse, consulte o Guia PDE, que inclui uma seção sobre como criar recursos. Você também pode achar útil a descrição do manifesto de recurso em "Navegando e Customizando o Ambiente de Trabalho".

Instalação de Tempo de Execução

Pode ser necessário detectar a versão dos componentes de tempo de execução instalados para garantir que o arquivo LIL correto seja carregado pelo nível correto do intermediário. Consulte o Detectando Versões Instaladas do WebSphere Message Broker.

Para incluir arquivos .jar ou .lil em instalações de tempo de execução no WebSphere Business Integration Message Broker Versão 5.0 ou posterior, eWebSphere Message Broker Versão 6.0 e posterior, consulte Instalando Arquivos de Tempo de Execução da Extensão Definida pelo Usuário em um Intermediário. Para intermediários da Versão 2, inclua os arquivos de extensão definidos pelo usuário no install_dir/lil/, e reinicie o intermediário.

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

Para tornar uma extensão de 32 bits acessível a partir de apenas um intermediário no sistema, modifique a configuração UserLilPath para o navegador especificando o parâmetro -l no comando mqsicreatebroker ou mqsichangebroker.

Não é possível utilizar o parâmetro -l para modificar o LILPATH do usuário para extensões de 64 bits. Em vez disso, anexe o diretório que contém o diretório que possui os arquivos de extensão à variável de ambiente MQSI_LILPATH64, conforme descrito na seção a seguir.

Início da mudançaConsulte os comandos mqsicreatebroker e mqsichangebroker para informações adicionais.Fim da mudança

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

Para afetar todos os intermediários em um sistema, você deve modificar o LILPATH do sistema. 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).

É possível fazer esta alteração criando um script de ambiente customizado no diretório de trabalho:

  • Linux platformUNIX platform Nos sistemas Linux e UNIX, /var/mqsi/common/profiles
  • Windows platform Em Windows, %ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\profiles em que a configuração padrão para a variável de ambiente %ALLUSERSPROFILE% seja C:\Documents and Settings\All Users. 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 para anexar apenas as seguintes variáveis:

MQSI_LILPATH
Define os diretórios a serem procurados para plug-ins de 32 bits
MQSI_LILPATH64
Define os diretórios a serem procurados para plug-ins de 64 bits
CLASSPATH
Define os locais Java nos quais classes adicionais devem ser procuradas
Início da mudançaMQSI_CONSOLE_NLSPATHFim da mudança
Início da mudançaNos sistemas Windows, define o local dos catálogos de mensagem (arquivos DLL)Fim da mudança
NLSPATH
Início da mudançaNos sistemas Linux e UNIX, define o local dos catálogos de mensagem (arquivos CAT)Fim da mudança
PATH
Define o local dos arquivos executáveis. No Windows, essa variável também define o local das bibliotecas dependentes.
LIBPATH / SHLIB_PATH / LD_LIBRARY_PATH
Define o local das bibliotecas dependentes nos sistemas UNIX e Linux.

Examplos de scripts

Windows platform Este exemplo mostra o perfil de ambiente MyExtension no Windows, instalado em C:\Program Files\MyExtensions.

O script é chamado MyExtension.cmd e armazenado no diretório de trabalho. O local padrão é %ALLUSERSPROFILE%\Application Data\IBM\MQSI\common\profiles. em que a configuração padrão para a variável de ambiente %ALLUSERSPROFILE% é C:\Documents and Settings\All Users\.

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"

UNIX platform Este exdmplo mostra o perfil do ambiente para MyExtension no Linux, 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
# Incluído pela instalação MyExtension, não modifique
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 intermediário:

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, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:06

as04540_