Configuração do ouvinte de eventos SAP

Introdução

Durante o processo de instalação do SAP Event Listener, você será 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 (consulte Reiniciando o serviço SAP Event Listener em instalação do ouvinte de eventos SAP).

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

Acessando a configuração do ouvinte de eventos SAP
Inserindo entrada na configuração do ouvinte 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

Conforme descrito mais adiante nesta página, ao configurar o SAP Event Listener pela primeira vez, você ainda não poderá concluir a parte Detalhes do Evento da configuração. Em vez disso, você pode deixar esta parte da configuração vazia até obter a entrada necessária para este campo. A entrada necessária é gerada conforme descrito em Criando uma operação de evento SAP IDoc e obtendo detalhes do evento em Configuração e uso do SAP event listener Design Studio.

Para obter a ordem recomendada de todas as etapas necessárias para configurar e usar o SAP Event Listener, consulte o Guia de introdução ao SAP Event Listener.

Acessando a configuração do ouvinte de eventos SAP

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

Windows

A configuração do SAP Event Listener é feita por meio 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:

anexo

A tela Configurações de eventos SAP é exibida:

anexo

Como alternativa à inserção gráfica da configuração, 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. Altere os diretórios para o local apropriado e então execute o script:

# cd /opt/jitterbitsap/bin

# ./runconfig.sh

O script percorre os campos de configuração inicial onde você fornece informações 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`[pt] `: 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

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

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

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

Esta seção fornece definições dos campos de configuração do SAP Event Listener 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: Digite a senha para o sistema SAP.
Cliente: Insira o ID numérico do cliente associado ao sistema SAP.
Idioma: Insira o código de idioma no qual as mensagens SAP devem ser enviadas, como en para inglês.
Roteador: Se o sistema SAP for protegido por um firewall, insira a string do roteador necessária para conectar-se a ele. Esta configuração não é suportada na versão Linux.

Conexão direta

Preencha esses campos se o endpoint SAP tiver uma conexão direta com o servidor. 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 serão usados se os campos listados em Conexão do balanceador de carga abaixo também estão concluídas.

Host do aplicativo: Insira o nome do hospedar do servidor do aplicativo SAP.
Número do sistema: Insira o número do sistema SAP.

Conexão do 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 de direção ou uma conexão de balanceador de carga podem ser configuradas, esses campos não serão usados se os campos listados em Conexão direta acima também estão concluídos.

Nota

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

MSHost: Insira o nome do hospedar do servidor de mensagens SAP.
MSPort: Insira a porta do servidor de mensagens SAP.
Nome do grupo: Insira o nome do grupo SAP dos servidores de aplicativos.
ID do sistema: Insira o ID do sistema SAP.

Propriedades de conexão de evento SAP

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

Gateway Host: Insira o hospedar do gateway.
Serviço de gateway: Insira o serviço de gateway.
Contagem de ouvintes: Insira o número de threads de ouvintes que você deseja executar como parte deste serviço de ouvinte, dependendo dos seus requisitos de taxa de transferência. O padrão é 1.
Detalhes do evento: Insira os detalhes de cada evento IDoc (tRFC e qRFC). Observe, dependendo se você está usando a versão Windows ou Linux do SAP Event Listener:
- Windows: Durante a configuração inicial do SAP Event Listener, você pode deixar os Detalhes do Evento vazios se ainda não tiver gerado esses detalhes.
- Linux: Durante a configuração inicial do SAP Event Listener, o script de shell não solicita que você forneça detalhes do evento. Em vez disso, depois de gerar os detalhes do evento, você 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 SAP IDoc criada no Jitterbit Design Studio. Após concluir Criando uma operação de evento SAP IDoc e obtendo detalhes do evento em Configuração e uso do SAP event listener Design Studio, insira os detalhes de cada evento IDoc aqui. Ao inserir os detalhes, observe:
- Toda a entrada deste campo deve ser incluída dentro de um conjunto de <events> e </events> Tags XML.
- Dentro desse conjunto externo de tags, cada evento deve ser incluído em um conjunto de <event> e </event> Tags XML.
- Você pode inserir eventos tRFC e 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 de configuração entrem em vigor (consulte Reiniciando o serviço SAP Event Listener em instalação do ouvinte de eventos SAP).
Cuidado

O campo Detalhes do evento atualmente apresenta 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 Windows SAP Event Listener por meio da interface do usuário, ocorre uma exceção.
  - Informações adicionais: Esse problema ocorre quando uma configuração salva anteriormente que inclui o conjunto externo necessário de <events> e </events> tags no campo Detalhes do Evento foram inadvertidamente salvas 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 UI 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 estiver instalando o SAP Event Listener em uma máquina diferente daquela onde o agente privado está instalado, entre em contato com suporte Jitterbit.
Dica

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

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 sistema operacional services arquivo. Se estiver usando a porta de gateway SAP padrão (3300), a porta pode ou não estar presente no services arquivo.

O services o arquivo está localizado nestes 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 do gateway SAP padrão começa com 33, seguido por 00 como o número do gateway. Ou seja, a porta do gateway SAP padrão é 3300. Se presente, a porta do gateway SAP padrão é representada no services arquivo por esta entrada:

sapgw00  3300/tcp

Se a entrada da porta do gateway padrão estiver faltando no services arquivo, ou se a porta do gateway for diferente do padrão, você deve adicioná-la ao services arquivo. 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 services arquivo, reinicie o serviço SAP Event Listener conforme descrito em Reiniciando o serviço SAP Event Listener em instalação do ouvinte 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 sistema operacional services arquivo, execute um teste da conexão para validar a comunicação de entrada com o SAP e verifique se o serviço SAP Event Listener está em execução. O serviço deve estar em execução mesmo que a parte Event Details 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 Testar conexão. Uma caixa de diálogo deve indicar que a conexão foi bem-sucedida:

anexo

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

anexo

Linux

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

Perform test connection [y/n]?y

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'

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 diagnosticar e resolver problemas seguindo o catalina.out arquivo de log:

# tail ../logs/catalina.out

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/exemplos] `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/gerenciador-de-host] `has finished in`[11] `ms
05-Feb-2021 22:18:13.766 INFO [principal] org.apache.coyote.AbstractProtocol.start Starting ProtocolHandler ["http-nio-8080"]
05-Feb-2021 22:18:13.787 INFO [principal] org.apache.catalina.startup.Catalina.start Server startup in 1647 ms