Configuración del detector de eventos de SAP

Introducción

Durante el proceso de instalación de SAP Event Listener, se le solicitará que configure SAP Event Listener.

También puede reconfigurar el SAP Event Listener una vez finalizado el proceso de instalación. Al reconfigurar el SAP Event Listener, se recomienda reiniciar el servicio después de la configuración (consulte Reinicio del servicio SAP Event Listener en Instalación del detector de eventos de SAP).

Estas actividades relacionadas con la configuración del SAP Event Listener se detallan en esta página:

Acceso a la configuración del detector de eventos de SAP
Ingresar información en la configuración del detector de eventos de SAP
Agregar el puerto de enlace al archivo de servicios
Probar la conexión y verificar que el servicio esté en funcionamiento

Como se describe más adelante en esta página, al configurar el SAP Event Listener por primera vez, aún no podrá completar la parte Detalles del evento de la configuración. En su lugar, puede dejar esta parte de la configuración vacía hasta que haya obtenido la entrada necesaria para este campo. La entrada necesaria se genera como se describe en Creación de una operación de evento SAP IDoc y obtención de detalles del evento en Configuración y uso del escucha de eventos de SAP Design Studio.

Para conocer el orden recomendado de todos los pasos necesarios para configurar y utilizar SAP Event Listener, consulte la Guía de introducción al SAP Event Listener.

Acceder a la configuración del detector de eventos de SAP

El método por el cual se accede a la configuración de SAP Event Listener depende de si SAP Event Listener está instalado en Windows o Linux. Como los campos de configuración son similares tanto para Windows como Linux, se describen juntos en la siguiente sección, Ingresar datos en la configuración de SAP Event Listener.

Windows

La configuración de SAP Event Listener se realiza a través de la pantalla de configuración de SAP Event Listener.

Para volver a la pantalla de configuración después de la configuración inicial, utilice el menú de inicio de Windows para localizar el Jitterbit SAP Event Listener y seleccione Configurar Jitterbit SAP Listener:

adjunto

Se muestra la pantalla Configuraciones de eventos de SAP:

adjunto

Como alternativa a ingresar la configuración gráficamente, puede editar manualmente el archivo de configuración de SAP Event Listener en esta ubicación:

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

Linux

La configuración del SAP Event Listener mediante una conexión directa se realiza ejecutando un secuencia de comandos de shell en la línea de comandos. Cambie los directorios a la ubicación adecuada y luego ejecute el secuencia de comandos:

# cd /opt/jitterbitsap/bin

# ./runconfig.sh

El secuencia de comandos recorre los campos de configuración inicial donde se proporciona información para configurar el SAP Event Listener:

*SAP Event Configurations*
Sap Connection Properties
    UserName`[] `: wxyz
    Password`[] `:
    Application Host`[] `: ecc99.sapaccess.com
    System Number`[] `: 00
    Client`[] `: 800
    Language`[es] `: 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 SAP Event Listener para utilizar una conexión de balanceador de carga, debe editar manualmente el archivo de configuración de SAP Event Listener en esta ubicación:

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

En el <connection> Sección, agregue estas propiedades:

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

Ingresar información en la configuración del detector de eventos de SAP

Esta sección proporciona definiciones de los campos de configuración de SAP Event Listener para Windows o Linux.

Propiedades de conexión de SAP

Estos campos se utilizan para proporcionar propiedades básicas del extremo de SAP:

Versión de SAP: Seleccione ECC o S4 HANA como la versión del sistema SAP. Aunque esta configuración no está disponible en la versión de Linux, tanto ECC como S4 HANA son compatibles sin necesidad de especificar la versión.
Nombre de usuario: Ingrese el nombre de usuario para el sistema SAP.
Contraseña: Ingrese la contraseña para el sistema SAP.
Cliente: Ingrese el ID numérico del cliente asociado con el sistema SAP.
Idioma: Ingrese el código de idioma para el idioma en el que deben enviarse los mensajes de SAP, como en para inglés.
Enrutador: Si el sistema SAP está protegido por un firewall, ingrese la cadena de enrutador necesaria para conectarse a él. Esta configuración no es compatible con la versión Linux.

Conexión directa

Complete estos campos si el extremo de SAP tiene una conexión directa al servidor. Como solo se pueden configurar configuraciones para una conexión directa o una conexión de balanceador de carga, estos campos no se utilizan si los campos que se enumeran en Conexión de balanceador de carga a continuación también se completan.

Host de la aplicación: Ingrese el nombre de alojar del servidor de aplicaciones SAP.
Número de sistema: Ingrese el número de sistema SAP.

Conexión del balanceador de carga

Proporcione valores para estos campos si el extremo de SAP procesa solicitudes a través de un balanceador de carga. Como solo se pueden configurar configuraciones para una conexión de dirección o una conexión de balanceador de carga, estos campos no se utilizan si los campos que se enumeran en Conexión directa anteriores también se han completado.

Nota

Para Linux, los valores para estos campos se deben definir manualmente en el archivo de configuración de SAP Event Listener de Linux en lugar de hacerlo a través del secuencia de comandos de configuración, como se describe en la sección anterior.

MSHost: Ingrese el nombre de alojar del servidor de mensajes SAP.
MSPort: Ingrese el puerto del servidor de mensajes SAP.
Nombre del grupo: Ingrese el nombre del grupo SAP de los servidores de aplicaciones.
ID del sistema: Ingrese el ID del sistema SAP.

Propiedades de conexión de eventos de SAP

Estos campos se utilizan para configurar la conexión de SAP Event Listener:

Puerta de enlace Host: Ingrese el alojar de la puerta de enlace.
Servicio de puerta de enlace: Ingrese el servicio de puerta de enlace.
Recuento de escuchas: Ingrese la cantidad de subprocesos de escucha que desea ejecutar como parte de este servicio de escucha, según sus requisitos de rendimiento. El valor predeterminado es 1.
Detalles del evento: Ingrese los detalles de cada evento IDoc (tRFC y qRFC). Tenga en cuenta que, según esté utilizando la versión de Windows o Linux del SAP Event Listener:
- Windows: Durante la configuración inicial de SAP Event Listener, puede dejar los Detalles del evento vacíos si aún no ha generado estos detalles.
- Linux: Durante la configuración inicial de SAP Event Listener, el secuencia de comandos de shell no le solicita que proporcione detalles del evento. En cambio, una vez que haya generado los detalles del evento, debe agregarlos manualmente al archivo XML de configuración, ubicado en:
```
/opt/jitterbitsap/data/JitterbitSAPEventListener/conf/sapeventconfig.xml
```
Estos detalles se deben generar para cada operación de evento SAP IDoc creada en Jitterbit Design Studio. Después de completar Creación de una operación de evento SAP IDoc y obtención de detalles del evento en Configuración y uso del escucha de eventos de SAP Design Studio, ingrese aquí los detalles de cada evento IDoc. Al ingresar los detalles, tenga en cuenta lo siguiente:
- La entrada completa de este campo debe estar dentro de un conjunto de caracteres externos <events> y </events> Etiquetas XML.
- Dentro de ese conjunto externo de etiquetas, cada evento debe estar incluido dentro de un conjunto de <event> y </event> Etiquetas XML.
- Puede introducir eventos tRFC y qRFC.
Por ejemplo:
```
<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>
```
Consejo

Si agrega detalles de eventos después de la configuración inicial, reinicie el SAP Event Listener para que los cambios de configuración surtan efecto (consulte Cómo reiniciar el servicio de escucha de eventos de SAP en Instalación del detector de eventos de SAP).
Precaución

El campo Detalles del evento actualmente tiene este problema conocido:
- SAP Event Listener: No se puede abrir la interfaz de configuración de Windows
  - Resumen: Al intentar abrir la configuración del detector de eventos SAP de Windows a través de la interfaz de usuario, se produce una excepción.
  - Información adicional: Este problema ocurre cuando una configuración guardada previamente que incluye el conjunto externo requerido <events> y </events> Las etiquetas en el campo Detalles del evento se han guardado sin querer sin esas etiquetas.
  - Recuperación: Edite manualmente el archivo de configuración en C:\ProgramData\JitterbitSAPEventListener\conf\sapeventconfig.xml para reemplazar las etiquetas externas requeridas, se puede abrir nuevamente la interfaz de configuración de Windows.
  - URL: La URL del SAP Event Listener precargada. Si sigue nuestra recomendación de instalar el SAP Event Listener en cada agente privado de un grupo de agentes privados, no es necesario modificar la entrada en este campo. Si instala el SAP Event Listener en una máquina diferente de aquella en la que está instalado el agente privado, comuníquese con soporte de Jitterbit.
Consejo

Para solucionar problemas temporales en ambientes que no sean de producción, puede ingresar intencionalmente una URL no válida en la configuración. Esto provocará que SAP Event Listener no pueda enviar la carga útil al agente y, en su lugar, escriba la carga útil en el registro de operación.

Agregar el puerto de enlace al archivo de servicios

En cada máquina donde esté instalado SAP Event Listener, el puerto de puerta de enlace de SAP debe estar presente en el sistema operativo. services archivo. Si se utiliza el puerto de puerta de enlace SAP predeterminado (3300), es posible que el puerto ya esté presente o no en el services archivo.

El services el archivo se encuentra en estas rutas de directorio:

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

Los puertos SAP comienzan con 31, 32 o 33, seguido de un número de sistema de dos dígitos.

El puerto de puerta de enlace SAP predeterminado comienza con 33, seguido de 00 como número de puerta de enlace. Es decir, el puerto de puerta de enlace SAP predeterminado es 3300. Si está presente, el puerto de puerta de enlace SAP predeterminado se representa en el services archivo por esta entrada:

sapgw00  3300/tcp

Si falta la entrada del puerto de enlace predeterminado en el services archivo, o si el puerto de enlace es diferente del predeterminado, debe agregarlo al services archivo. Por ejemplo, si el número de puerta de enlace es 17, agregue un puerto de puerta de enlace de 3317 al archivo de servicios:

sapgw17  3317/tcp

Después de agregar una entrada a la services archivo, reinicie el servicio SAP Event Listener como se describe en Reinicio del servicio SAP Event Listener en Instalación del detector de eventos de SAP.

Probar la conexión y verificar que el servicio esté en ejecución

Después de confirmar que el puerto de enlace se ha agregado al sistema operativo services archivo, realice una prueba de la conexión para validar la comunicación entrante con SAP y verificar que el servicio SAP Event Listener esté en ejecución. El servicio debería estar en ejecución incluso si la parte Detalles del evento de la configuración de SAP Event Listener aún no se ha completado.

Windows

En Windows, en la pantalla de configuración de SAP Event Listener, haga clic en el botón Probar conexión. Un cuadro de diálogo debería indicar que la conexión se realizó correctamente:

adjunto

Compruebe que el servicio Jitterbit SAP Event Listener se esté ejecutando en Servicios de Windows:

adjunto

Linux

En Linux, probar la conexión es el último paso del secuencia de comandos de configuración. Cuando se le solicite que pruebe la conexión, ingrese y:

Perform test connection [y/n]?y

Se muestra un resultado similar a este para una prueba de conexión exitosa:

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

. . .

Test connection to SAP is success.

Compruebe que el servicio SAP Event Listener se esté ejecutando utilizando ps -ef:

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

Se muestra un resultado similar a este:

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

También puedes identificar y solucionar problemas siguiendo el catalina.out archivo de registro:

# tail ../logs/catalina.out

Se muestra un resultado similar a este:

05-Feb-2021 22:18:13.534 INFO`[localhost-inicio-parada-1] `org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/manager]
05-Feb-2021 22:18:13.561 INFO`[localhost-inicio-parada-1] `org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/opt/jitterbitsap/webapps/gerente] has finished in`[27] `ms
05-Feb-2021 22:18:13.562 INFO`[localhost-inicio-parada-1] `org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/ROOT]
05-Feb-2021 22:18:13.572 INFO`[localhost-inicio-parada-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-inicio-parada-1] `org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/opt/jitterbitsap/webapps/examples]
05-Feb-2021 22:18:13.750 INFO`[localhost-inicio-parada-1] `org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory`[/opt/jitterbitsap/webapps/ejemplos] `has finished in`[178] `ms
05-Feb-2021 22:18:13.751 INFO`[localhost-inicio-parada-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-inicio-parada-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 [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