Configuração do Jitterbit Design Studio SAP Event Listener

Introdução

Durante o processo de instalação do SAP Event Listener, você é solicitado a configurar o SAP Event Listener.

Você também pode reconfigurar o SAP Event Listener após a conclusão do processo de instalação. Ao reconfigurar o SAP Event Listener, é recomendável reiniciar o serviço após a configuração (veja Reiniciando o serviço do listener de eventos SAP em Instalação do listener de eventos SAP).

Essas atividades relacionadas à configuração do SAP Event Listener estão detalhadas nesta página:

Acessando a configuração do listener de eventos SAP
Inserindo dados na configuração do listener de eventos SAP
Adicionando a porta do gateway ao arquivo de serviços
Testando a conexão e verificando se o serviço está em execução

Como descrito mais adiante nesta página, ao configurar o SAP Event Listener pela primeira vez, você ainda não poderá completar a parte de Detalhes do Evento da configuração. Em vez disso, você pode deixar essa parte da configuração em branco até obter as informações necessárias para este campo. As informações necessárias são geradas conforme descrito em Criando uma operação de evento IDoc SAP e obtendo detalhes do evento em Configuração e uso do Design Studio do listener de eventos SAP.

Para a ordem recomendada de todas as etapas necessárias para configurar e usar o SAP Event Listener, consulte o guia de início rápido do SAP Event Listener.

Acessando a configuração do SAP Event Listener

O método pelo qual você acessa a configuração do SAP Event Listener depende de estar instalado no Windows ou Linux. Como os campos de configuração são semelhantes para ambos, Windows e Linux, eles são descritos juntos na próxima seção, Inserindo dados na configuração do SAP Event Listener.

Windows

A configuração do SAP Event Listener é feita através da tela de configuração do SAP Event Listener.

Para retornar à tela de configuração após a configuração inicial, use o menu iniciar do Windows para localizar o Jitterbit SAP Event Listener e selecione Configurar Jitterbit SAP Listener:

attachment

A tela de Configurações do SAP Event é exibida:

attachment

Como alternativa à inserção da configuração graficamente, você pode editar manualmente o arquivo de configuração do SAP Event Listener neste local:

C:\ProgramData\JitterbitSAPEventListener\conf\sapeventconfig.xml

Linux

A configuração do SAP Event Listener usando uma conexão direta é feita executando um script de shell na linha de comando. Mude o diretório para o local apropriado e, em seguida, execute o script:

# cd /opt/jitterbitsap/bin

# ./runconfig.sh

O script percorre os campos de configuração inicial onde você fornece dados para configurar o SAP Event Listener:

*SAP Event Configurations*
Sap Connection Properties
    UserName [] : wxyz
    Password [] :
    Application Host [] : ecc99.sapaccess.com
    System Number [] : 00
    Client [] : 800
    Language [en] : en

SAP Event Connection Properties
    GateWay Host [] : ecc99.sapaccess.com
    GateWay Service [] : sapgw00
    Listener Count [1] : 1

URL [https://127.0.0.1:46908/jitterbit_sap_destination] : http://127.0.0.1:46908/jitterbit_sap_destination

Para configurar o SAP Event Listener para usar uma conexão de balanceador de carga, você deve editar manualmente o arquivo de configuração do SAP Event Listener neste local:

/opt/jitterbitsap/data/JitterbitSAPEventListener/conf/sapeventconfig.xml

Na seção <connection>, adicione estas propriedades:

<eventconfiguration>
    <connection>
        . . .
        <mshost></mshost>
        <mspost></mspost>
        <groupname></groupname>
        <systemid></systemid>
    </connection>
   . . .
</eventconfiguration>

Inserindo dados na configuração do ouvinte de eventos SAP

Esta seção fornece definições dos campos de configuração do Ouvinte de Eventos SAP para Windows ou Linux.

Propriedades de conexão SAP

Esses campos são usados para fornecer propriedades básicas do endpoint SAP:

Versão SAP: Selecione ECC ou S4 HANA como a versão do sistema SAP. Embora essa configuração não esteja disponível na versão Linux, tanto ECC quanto S4 HANA são suportados sem a necessidade de especificar a versão.
Nome de usuário: Insira o nome de usuário para o sistema SAP.
Senha: Insira a senha para o sistema SAP.
Cliente: Insira o ID do cliente numérico associado ao sistema SAP.
Idioma: Insira o código do idioma para o qual as mensagens SAP devem ser enviadas, como en para inglês.
Roteador: Se o sistema SAP estiver protegido por um firewall, insira a string do roteador necessária para se conectar a ele. Essa configuração não é suportada na versão Linux.

Conexão direta

Preencha esses campos se o endpoint SAP tiver uma conexão de servidor direta. Como as configurações para apenas uma conexão direta ou uma conexão de balanceador de carga podem ser configuradas, esses campos não são usados se os campos listados em Conexão de balanceador de carga abaixo também forem preenchidos.

Host do Aplicativo: Insira o nome do host do servidor de aplicativos SAP.
Número do Sistema: Insira o número do sistema SAP.

Conexão de balanceador de carga

Forneça valores para esses campos se o endpoint SAP processar solicitações por meio de um balanceador de carga. Como as configurações para apenas uma conexão direta ou uma conexão de balanceador de carga podem ser configuradas, esses campos não são usados se os campos listados em Conexão direta acima também forem preenchidos.

Nota

Para Linux, os valores para esses campos devem ser definidos manualmente no arquivo de configuração do Listener de Eventos SAP no Linux, em vez de através do script de configuração, conforme descrito na seção anterior.

MSHost: Insira o nome do host do servidor de mensagens SAP.
MSPort: Insira a porta do servidor de mensagens SAP.
Group Name: Insira o nome do grupo SAP dos servidores de aplicação.
System ID: Insira o ID do sistema SAP.

Propriedades de conexão do evento SAP

Esses campos são usados para configurar a conexão do Listener de Eventos SAP:

Gateway Host: Insira o host do gateway.
Gateway Service: Insira o serviço do gateway.
Listener Count: Insira o número de threads do listener que você deseja executar como parte deste serviço de listener, dependendo dos seus requisitos de throughput. O padrão é 1.
Event Details: Insira os detalhes de cada evento IDoc (tRFC e qRFC). Observe que, dependendo de você estar usando a versão do Windows ou do Linux do Listener de Eventos SAP:
- Windows: Durante a configuração inicial do Listener de Eventos SAP, você pode deixar os Event Details vazios se ainda não tiver gerado esses detalhes.
- Linux: Durante a configuração inicial do Listener de Eventos SAP, o script shell não solicita que você forneça detalhes do evento. Em vez disso, uma vez que você tenha gerado os detalhes do evento, deve adicioná-los manualmente ao arquivo XML de configuração, localizado em:
```
/opt/jitterbitsap/data/JitterbitSAPEventListener/conf/sapeventconfig.xml
```
Esses detalhes devem ser gerados para cada operação de Evento IDoc SAP criada no Jitterbit Design Studio. Após concluir Criando uma operação de evento IDoc SAP e obtendo detalhes do evento em Configuração e uso do Design Studio do listener de eventos SAP, insira os detalhes de cada evento IDoc aqui. Ao inserir os detalhes, observe:
A entrada inteira deste campo deve estar encerrada dentro de um conjunto externo de tags XML <events> e </events>.
Dentro desse conjunto externo de tags, cada evento deve estar encerrado dentro de um conjunto de tags XML <event> e </event>.
Você pode inserir eventos tanto tRFC quanto qRFC.

Por exemplo:

(<events>
    <event>
        <program_id>JITTERBIT</program_id>
        <idoctype>DEBMAS06</idoctype>
        <rfctype>tRFC</rfctype>
        <environment_id>447551</environment_id>
        <operation_guid>ec557feb-b220-400e-9987-fe5d063b7057</operation_guid>
    </event>
    <event>
        <program_id>JITTERBIT</program_id>
        <idoctype>MATMAS05</idoctype>
        <rfctype>qRFC</rfctype>
        <environment_id>447551</environment_id>
        <operation_guid>bd557feb-b220-400e-9987-fe5d063b7066</operation_guid>
    </event>
    </events>

Dica

Se adicionar detalhes do evento após a configuração inicial, reinicie o SAP Event Listener para que as alterações na configuração tenham efeito (veja Reiniciando o serviço do listener de eventos SAP em Instalação do listener de eventos SAP).

Cuidado

O campo Detalhes do Evento atualmente possui este problema conhecido:

SAP Event Listener: A interface de configuração do Windows não pode ser aberta
- Resumo: Ao tentar abrir a configuração do SAP Event Listener do Windows pela interface, ocorre uma exceção.
- Informações Adicionais: Este problema ocorre quando uma configuração previamente salva que inclui o conjunto externo necessário de tags <events> e </events> no campo Detalhes do Evento foi inadvertidamente salva sem essas tags.
- Recuperação: Edite manualmente o arquivo de configuração em C:\ProgramData\JitterbitSAPEventListener\conf\sapeventconfig.xml para substituir as tags externas necessárias. A interface de configuração do Windows pode ser aberta novamente.
- URL: A URL do SAP Event Listener pré-preenchida. Se seguir nossa recomendação de instalar o SAP Event Listener em cada agente privado em um grupo de agentes privados, a entrada neste campo não precisa ser modificada. Se instalar o SAP Event Listener em uma máquina diferente daquela onde o agente privado está instalado, entre em contato com o suporte da Jitterbit.

Dica

Para fins de solução de problemas temporários em ambientes não produtivos, você pode inserir intencionalmente uma URL inválida na configuração. Isso fará com que o SAP Event Listener falhe ao enviar a carga útil para o agente e, em vez disso, escreva a carga útil no log de operações.

Adicionando a porta do gateway ao arquivo de serviços

Em cada máquina onde o SAP Event Listener está instalado, a porta do gateway SAP deve estar presente no arquivo services do sistema operacional. Se estiver usando a porta padrão do gateway SAP (3300), a porta pode ou não já estar presente no arquivo services.

O arquivo services está localizado nos seguintes caminhos de diretório:

Windows: C:\Windows\System32\drivers\etc\services
Linux: /etc/services

As portas SAP começam com 31, 32 ou 33, seguidas por um número de sistema de dois dígitos.

A porta padrão do gateway SAP começa com 33, seguida por 00 como o número do gateway. Ou seja, a porta padrão do gateway SAP é 3300. Se presente, a porta padrão do gateway SAP é representada no arquivo services por esta entrada:

sapgw00  3300/tcp

Se a entrada da porta do gateway padrão estiver faltando no arquivo services, ou se a porta do gateway for diferente da padrão, você deve adicioná-la ao arquivo services. Por exemplo, se o número do gateway for 17, adicione uma porta de gateway de 3317 ao arquivo de serviços:

sapgw17  3317/tcp

Após adicionar uma entrada ao arquivo services, reinicie o serviço do SAP Event Listener conforme descrito em Reiniciando o serviço do listener de eventos SAP em Instalação do listener de eventos SAP.

Testando a conexão e verificando se o serviço está em execução

Após confirmar que a porta do gateway foi adicionada ao arquivo services do sistema operacional, realize um teste da conexão para validar a comunicação de entrada com o SAP e verificar se o serviço do SAP Event Listener está em execução. O serviço deve estar em execução mesmo que a parte Detalhes do Evento da configuração do SAP Event Listener ainda não tenha sido concluída.

Windows

No Windows, na tela de configuração do SAP Event Listener, clique no botão Test Connection. Uma caixa de diálogo deve indicar que a conexão foi bem-sucedida:

attachment

Verifique se o serviço Jitterbit SAP Event Listener está em execução nos Serviços do Windows:

attachment

Linux

No Linux, testar a conexão é o último passo do script de configuração. Quando solicitado a testar a conexão, digite y:

Perform test connection [y/n]?y

Uma saída semelhante a esta para um teste de conexão bem-sucedido é exibida:

KFile is ../data/JitterbitSAPEventListener/conf/.pk is exist false

. . .

Test connection to SAP is success.

Verifique se o serviço SAP Event Listener está em execução usando ps -ef:

# ps -ef | grep -v grep | grep 'jitterbitsap'

Uma saída semelhante a esta é exibida:

Djava.util.logging.config.file=/opt/jitterbitsap/conf/logging.properties -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager -Xms512m -Xmx1024m -Djava.endorsed.dirs= -classpath /opt/jitterbitsap/bin/bootstrap.jar:/opt/jitterbitsap/bin/tomcat-juli.jar -Dcatalina.base=/opt/jitterbitsap -Dcatalina.home=/opt/jitterbitsap -Djava.io.tmpdir=/opt/jitterbitsap/temp org.apache.catalina.startup.Bootstrap start

Você também pode solucionar problemas monitorando o arquivo de log catalina.out:

# tail ../logs/catalina.out

Uma saída semelhante a esta é exibida:

05-Feb-2021 22:18:13.534 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/manager]
05-Feb-2021 22:18:13.561 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/opt/jitterbitsap/webapps/manager] has finished in [27] ms
05-Feb-2021 22:18:13.562 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/ROOT]
05-Feb-2021 22:18:13.572 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/opt/jitterbitsap/webapps/ROOT] has finished in [10] ms
05-Feb-2021 22:18:13.572 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/examples]
05-Feb-2021 22:18:13.750 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/opt/jitterbitsap/webapps/examples] has finished in [178] ms
05-Feb-2021 22:18:13.751 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/host-manager]
05-Feb-2021 22:18:13.762 INFO [localhost-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/opt/jitterbitsap/webapps/host-manager] has finished in [11] ms
05-Feb-2021 22:18:13.766 INFO [main] org.apache.coyote.AbstractProtocol.start Starting ProtocolHandler ["http-nio-8080"]
05-Feb-2021 22:18:13.787 INFO [main] org.apache.catalina.startup.Catalina.start Server startup in 1647 ms