Configuration du fichier tsap-rfc-server.properties

Avant les sections

• logging.config : spécifie le fichier de configuration de log paramétrant les niveaux de logs (obligatoire).
• loader.path : spécifie les répertoires ou archives à écrire à la suite du classpath pour inclure sapjco3.jar. Les répertoires ou archives doivent être séparé·es par une virgule (obligatoire).
• named.connections : spécifie le chemin d'accès au répertoire contenant les fichiers de configuration de connexions SAP (obligatoire).

Section Health

Cette section contrôle l'affichage des informations de santé.

• management.endpoint.health.show-details : configure le niveau d'affichage des informations d'intégrité, collectées par résumé des résultats de HealthIndicator (obligatoire).

Section JMS broker

La section JMS Broker configure l'interaction avec le broker JMS embarqué ou distant.

Pour activer l'authentification des utilisateurs et des utilisatrices, décommentez les quatre paramètres suivants et configurez leur valeur. Notez que si vous n'activez pas l'authentification utilisateur·trice, le tSAPIDocReceiver ou le tSAPDataSourceReceiver peut également se connecter à Talend SAP RFC Server sans paramétrer la valeur des champs d'identifiant et mot de passe.

• jms.login.config=conf/user-authentication/login.config : répertoire du système de fichiers contenant la configuration d'authentification JAAS.
• jms.login.configDomain=tsaps-domain : Domaine de configuration de l'authentification JAAS à utiliser.
• jms.login.username : nom d'utilisateur.rice JAAS utilisé pour l'authentification d'un.e éditeur.rice ou d'un.e expéditeur.rice.
• jms.login.password : mot de passe JAAS utilisé pour authentifier un.e éditeur.rice ou un.e expéditeur.rice.

Pour activer le mécanisme de transport SSL, copiez le fichier KeyStore pour SSL dans le dossier $TSAPS_HOME/conf. Décommentez les deux paramètres suivants : le chemin vers le fichier KeyStore et le mot de passe pour ce fichier, dans le fichier de configuration, puis configurez leur valeur.

• jms.ssl.keystore.path : chemin d'accès à un fichier KeyStore pour SSL.
• jms.ssl.keystore.password : mot de passe pour un fichier KeyStore pour SSL.
• jms.durable.queue.replicate : indique si les messages JMS doivent être répliqués dans des files d'attente durables.
• jms.durable.queue.retentionPeriod : période de rétention des messages JMS dans des files d'attente durables, en millisecondes (par défaut : 7 jours).
• jms.idoc.queue.prefix=TALEND.IDOCS. : préfixe des noms de file d'attente ou de topic JMS utilisés pour les messages IDoc. Remplacez cette valeur lors de la connexion de plusieurs systèmes SAP à une seule instance ActiveMQ pour éviter les conflits de noms de file d'attente.
• jms.datasource.queue.prefix=TALEND.DATASOURCES. : préfixe des noms de file d'attente ou de topic JMS utilisés pour les messages BW Datasource. Remplacez cette valeur lors de la connexion de plusieurs systèmes SAP à une seule instance ActiveMQ pour éviter les conflits de noms de file d'attente.

Section Embedded broker

La section Embedded Broker détaille les informations de connexion du broker JMS embarqué utilisé. Si vous utilisez un broker JMS externe, ces valeurs sont commentées. Les paramètres sont les suivants :

• jms.bindAddress : adresse et port de l'hôte (par ex : tcp://localhost:61616) que le broker JMS écoutera pour les connexions entrantes (obligatoire).
• jms.persistent : indique si les messages JMS sont persistants ou non. Ainsi, Talend SAP RFC Server conserve une copie des documents IDoc reçus dans des files nommées d'après le document IDoc. Cela est utile au composant tSAPIDocReceiver en mode batch (par lots). Lorsque le composant Receiver s'exécute, il collecte tous les documents IDoc stockés dans les files durables depuis sa dernière exécution.

Par défaut, les messages sont conservés dans les files durant sept jours. Vous pouvez modifier cette période de rétention en décommentant ce paramètre dans le fichier de configuration et en mettant à jour sa valeur pour qu'elle réponde à vos besoins.

• jms.dataDirectory : emplacement du système de fichiers utilisé par le broker JMS pour faire persister les données.
• jms.useJmx : définit si les services du broker doivent être exposés ou non en JMX.

Section Remote broker

La section Remote Broker détaille les informations de connexion à un broker distant ou externe. Si vous utilisez un broker embarqué, cette section est commentée. Les paramètres sont les suivants :

• jms.broker.url : une fois activé, se connecte à un broker distant et non à un broker embarqué.
• jms.reconnect.interval : intervalle entre les tentatives de reconnexion.
• rfc.server.remote.broker.url : URL des brokers pour le failover. Les URL des brokers doivent être fournies sous la forme suivante : rfc.server.remote.broker.url=failover:(tcp://ip_address1:port_number1,tcp://ip_address2:port_number2, ...).

Section Error Page's Content

La section Error Page's Content spécifie la manière dont les messages d'erreur sont affichés. Les valeurs peuvent être always (toujours), on-param, et never (jamais). La valeur par défaut est always.

• spring.web.error.include-message=always
• spring.web.error.include-binding-errors=always

Section Kafka

La section de Kafka détaille les informations de connexion à Kafka requises pour utiliser la fonctionnalité de mode Streaming. Il contient également les paramètres pour configurer un event hub Azure en tant que cluster Kafka.

• kafka.bootstrap.servers=<kafka_setting> : adresses du broker Kafka (au format hôte:numéro de port) séparées par une virgule (obligatoire).
• kafka.security.protocol=SASL_SSL
• kafka.sasl.mechanism=PLAIN
• kafka.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required username="$ConnectionString" password="{YOUR.EVENTHUBS.CONNECTION.STRING}";