Instalação e Configuração do Conector JMS

Instalando o Conector JMS

Nota

Atualmente, o JMS Connector só pode ser usado com integrações que usam Jitterbit Agentes Privados.

O JMS Connector foi adicionado aos Jitterbit Agentes Privados a partir da versão 8.6.0.0. Para usar esse conector, você deve usar uma versão do agente maior ou igual à versão 8.6.0.0.

O JMS Connector está incluído no Jitterbit Design Studio a partir do Jitterbit Agente versão 8.12.

As instruções de configuração diferem dependendo da versão do Agente Privado que você está usando:

Agente Privado versões 8.6.0.0 a 8.11
Agente Privado versão 8.12 e superior

Se você precisar baixar e instalar um Jitterbit Agente Privado ou um Jitterbit Design Studio, consulte estas instruções:

Configurando o Conector JMS para Jitterbit Versão 8.6.0.0 a 8.11

Para que os provedores JMS estejam disponíveis nas versões 8.6.0.0 a 8.11 do Jitterbit Design Studio, um arquivo de configuração JMS_ProviderInfo.confprecisa ser criado com os provedores desejados.

Nota

Se você estiver usando um Jitterbit Agente Privado versão 8.12 ou superior, consulte estas instruções.

O arquivo JMS_ProviderInfo.conf deve estar localizado na raiz da instalação do Agente Privado. Se o arquivo não estiver lá, crie um arquivo com esse nome e este conteúdo:

<ProviderConfig>
  <Providers>
    <Provider>
      <Name>ActiveMQ</Name>
      <java.naming.factory.initial>org.apache.activemq.jndi.ActiveMQInitialContextFactory</java.naming.factory.initial>
      <java.naming.provider.url>tcp://localhost:61616</java.naming.provider.url>
      <factoryName>ConnectionFactory</factoryName>
      <pathOfProviderJars>C:\Program Files (x86)\Jitterbit Agent\Connectors\JMS\Providers\ActiveMQ</pathOfProviderJars>
    </Provider>
  </Providers>
</ProviderConfig>

Isso configurará o Conector JMS para usar Apache ActiveMQ como um provedor, rodando no computador local, com o JAR do provedor localizado no diretório fornecido pela propriedade pathOfProviderJars.

O arquivo JAR do provedor precisa estar disponível no local especificado pela propriedade pathOfProviderJars. Copie os arquivos JAR necessários para esse local e reinicie o Agente Privado.

Se forem necessários provedores adicionais, eles podem ser adicionados ao mesmo arquivo de configuração.

Configurando o Conector JMS para Jitterbit Versão 8.12 e Superior

A partir da versão 8.12 do Jitterbit Agente Privado, Apache ActiveMQ foi configurado automaticamente como um provedor JMS. Provedores adicionais podem ser adicionados adicionando suas informações de configuração ao arquivo JMS_ProviderInfo_User.conf, que é colocado no ${JITTERBIT_HOME}/Connectors/JMS diretório.

Nota

Não modifique o arquivo JMS_ProviderInfo.conf se estiver usando o Jitterbit versão 8.12 e superior. Modificando o arquivo JMS_ProviderInfo.conf aplica-se apenas a versões anteriores ao Jitterbit versão 8.12. Use o JMS_ProviderInfo_User.conf em vez de suas configurações.

Para registrar um novo provedor JMS com Jitterbit, siga estas etapas:

Coloque o(s) jar(s) do provedor em um local no sistema de arquivos do(s) Agente Privado(s).
Adicione um novo <Provider> elemento no JMS_ProviderInfo_User.confcom esta informação:

Name: O nome do provedor. Deve ser único. Esse nome aparecerá na IU de seleção do provedor. Alterar o nome interromperá as operações JMS existentes que usam esse provedor em sua página de endpoint; para corrigi-lo, todos os endpoints que usam esse provedor devem ser atualizados selecionando novamente o provedor, usando seu novo nome e, em seguida, reimplantando.

java.naming.factory.initial: O valor desta propriedade JNDI deve ser o nome completo da classe da fábrica que criará um contexto inicial.

java.naming.provider.url: O valor desta propriedade JNDI deve ser uma string de URL do provedor de serviços a ser usado.

factoryName: O nome do connection factory que foi configurado no provedor de serviços.

pathOfProviderJars: O caminho absoluto do diretório no qual os jars do provedor foram colocados na etapa 1. Certifique-se de não colocar o JMS API JAR neste local. O agente Jitterbit já carrega o javax.jms-api-2.0.jar no arranque.

destination: Uma lista de destinos separados por ponto e vírgula que mapeia um nome de fila ou tópico usado no projeto Jitterbit para nomes externos no serviço do provedor (opcional; ignorado se vazio ou ausente). Disponível a partir do Jitterbit Agente Privado versão 9.0, a atividade JMS Listen do JMS Connector suporta pesquisa de contexto JNDI para destinos JMS.
Reinicie o Servidor Jitterbit Tomcat do Agente Privado (ou reinicie o próprio Agente Privado).

No sistema operacional Windows, reinicie o serviço correspondente no painel de controle de serviços do sistema operacional Windows. Para reiniciar todos os serviços, você pode usar "Parar..." e "Iniciar serviços Jitterbit" no menu Iniciar do Windows.

No Linux, os comandos para reiniciar o servidor Tomcat são:

# /sbin/service jitterbit stop_tomcat

# /sbin/service jitterbit start_tomcat

Exemplos de Configuração

Dois exemplos de configuração são fornecidos:

Adicionando mensagens Tibco
Adicionando ActiveMQ com pesquisa de contexto para destinos

Exemplo: Adicionando Tibco Messaging

Para adicionar um provedor de enfileiramento Tibco em execução na máquina local, adicione essas entradas ao arquivo JMS_ProviderInfo_User.conf:

<ProviderConfig>
  <Providers>
    . . .
    <Provider>
      <Name>Tibco EMS</Name>
      <java.naming.factory.initial>com.tibco.tibjms.naming.TibjmsInitialContextFactory</java.naming.factory.initial>
      <java.naming.provider.url>tcp://localhost:7222</java.naming.provider.url>
      <factoryName>ConnectionFactory</factoryName>
      <pathOfProviderJars>C:\Program Files (x86)\Jitterbit Agent\Connectors\JMS\Providers\Tibco</pathOfProviderJars>
    </Provider>
    . . .
  </Providers>
</ProviderConfig>

O usuário agora terá a opção, no Jitterbit Design Studio, de selecionar entre dois provedores diferentes para um endpoint JMS, ActiveMQ ou Tibco EMS:

anexo

Exemplo: Adicionando ActiveMQ com Pesquisa de Contexto para Destinos

Para adicionar um provedor Apache ActiveMQ em execução na máquina local com pesquisa de contexto para destinos, adicione essas entradas ao arquivo JMS_ProviderInfo_User.conf:

<ProviderConfig>
  <Providers>
    . . .
    <Provider>
      <Name>Mapped ActiveMQ</Name>
      <java.naming.factory.initial>org.apache.activemq.jndi.ActiveMQInitialContextFactory</java.naming.factory.initial>
      <java.naming.provider.url>tcp://localhost:61616</java.naming.provider.url>
      <factoryName>ConnectionFactory</factoryName>
      <pathOfProviderJars>C:\Program Files (x86)\Jitterbit Agent\Connectors\JMS\Providers\ActiveMQ</pathOfProviderJars>
      <destinations>queue.NewQueue=MyExampleQueue;topic.NewTopic=MyExampleTopic</destinations>
    </Provider>
    . . .
  </Providers>
</ProviderConfig>

Neste exemplo, o<destinations> elemento causa a fila "NewQueue" usado no projeto Jitterbit será mapeado para "MyExampleQueue" na instância do ActiveMQ; da mesma forma, o tópico "NewTopic" usado no projeto Jitterbit será mapeado para "MyExampleTopic". Isso permite que o código do projeto seja desacoplado da configuração.

Você pode usar qualquer um "NewQueue" ou "NewTopic" como o nome de destino no Jitterbit Design Studio e será traduzido para "MyExampleQueue" ou "MyExampleTopic". Se tudo estiver configurado corretamente, "MyExampleQueue" ou "MyExampleTopic" deve aparecer no console de gerenciamento do ActiveMQ. Se você acabar com uma fila ou tópico chamado "NewQueue" ou "NewTopic", então algo está incorreto com a configuração. Quando uma pesquisa falha, ela usa esses nomes de destino como literais e tenta criá-los.

Notas do Conector JMS

Coloque todos os JARs relevantes do provedor no pathOfProviderJars localização.
Não coloque o JMS API JAR no pathOfProviderJars localização. O JMS API JAR já é fornecido e instalado pelo instalador.
Reinicie o Agente Privado após qualquer alteração no arquivo de configuração. Embora as mudanças na configuração do JMS sejam selecionadas dinamicamente para as atividades JMS Poll, Browse e Publish, uma reinicialização do Agente Privado é necessária para as atividades do JMS Listener para ver a configuração modificada.
Adicionando o provedor Tibco EMS (ou qualquer outro provedor) ao arquivo de configuração do usuário do Agente Privado JMS_ProviderInfo_User.conf não altera o provedor atribuído para nenhum nó de endpoints existente. Você precisará atualizar manualmente quaisquer endpoints existentes e atribuir o Tibco EMS como o provedor JMS.
O JMS Listener não se reconectará automaticamente a um destino JMS diferente se o contexto de pesquisa for alterado.