配置 tsap-rfc-server.properties 文件 - 8.0

Talend Real-Time Big Data Platform 安装指南 Linux 版

Version
8.0
Language
中文(简体)
EnrichDitaval
Real-Time Big Data Platform for Linux
Product
Talend Real-Time Big Data Platform
Module
Talend Activity Monitoring Console
Talend Administration Center
Talend Artifact Repository
Talend CommandLine
Talend Data Preparation
Talend Data Stewardship
Talend ESB
Talend Identity and Access Management
Talend Installer
Talend JobServer
Talend Log Server
Talend Runtime
Talend SAP RFC Server
Talend Studio
Content
数据治理

Talend SAP RFC Server 的配置文件 tsap-rfc-server.properties 位于 $TSAPS_HOME/conf 目录下 (其中 $TSAPS_HOME 对应于安装 Talend SAP RFC Server 的目录)。文件包括五个部分。启动 Talend SAP RFC Server 之前,可以配置该文件以按照您的需要启用服务器的某些附加功能。

注:
  • Talend SAP RFC Server 不支持 SAP 集群配置。
  • 该配置文件的任何更改都需要重新启动 Talend SAP RFC Server

在各部分之前

  • logging.config: 指定日志配置文件,该文件设置日志级别 (必填)。
  • loader.path: 指定 sapjco3.jar 的路径或包含该 jar 的压缩包的路径,该路径会被添加到类路径中。多个路径需要用逗号分隔。 (必填)
  • named.connections: 指定 SAP 链接配置文件所在的路径或目录 (必填)。
注: 只有在您应用 Patch_20210820_TDI-45536_v1-7.3.1 更新补丁后,named.connections 参数才有效。

Health 部分

此节控制健康信息的显示。

  • management.endpoint.health.show-details: 设置显示健康信息的级别,该健康信息通过概括所有的 HealthIndicator 结果进行搜集。 (必填)
注: 只有在您应用 Patch_20210820_TDI-45536_v1-7.3.1 更新补丁后,此节参数才有效。

JMS broker 部分

JMS 代理部分设置与嵌入式或远程 JMS 代理的交互。

要启用用户身份验证,您需要取消注释以下四个参数并设置它们的值。如果不启用用户身份验证,tSAPIDocReceiver 组件或 tSAPDataSourceReceiver 组件也可以在不设置其用户和密码字段值的情况下连接到 Talend SAP RFC Server

  • jms.login.config=conf/user-authentication/login.config:包含 JAAS 身份认证配置的文件系统目录。
  • jms.login.configDomain=tsaps-domain:要使用的 JAAS 认证配置的域。
  • jms.login.username:JAAS 用户名,用于验证发布者或发送者。
  • jms.login.password:JAAS 密码,用于验证发布者或发送者。
注: 用户名和密码值将供 tSAPIDocReceiver 或 tSAPDataSourceReceiver 组件用于连接到 Talend SAP RFC Server。它们必须也存在于 $TSAPS_HOME/conf/user-authentication/users.properties 文件中。在此文件中,每一行代表一个用户名和密码对,其中用户名值在等号的左侧,密码值在等号的右侧。

要启用 SSL 传输机制,请将 SSL 的密钥库文件复制到 $TSAPS_HOME/conf 文件夹。然后取消注释配置文件中的以下两个参数 (密钥库文件的路径和密钥库文件的密码) 并设置其值。

  • jms.ssl.keystore.path: SSL 密钥库的路径。
  • jms.ssl.keystore.password: SSL 密钥库的密码。
  • jms.durable.queue.replicate:是否应复制持久队列中的 JMS 消息。
  • jms.durable.queue.retentionPeriod: 持久队列中 JMS 消息的保留期,以毫秒为单位 (缺省情况下为 7 天)。

Embedded broker 部分

嵌入式代理部分详细介绍了所用的嵌入式 JMS 代理的连接信息。如果使用外部 JMS 代理,这些值将被注释掉。以下列出设置:

  • jms.bindAddress: JMS 代理侦听传入连接的主机地址及端口 (例:tcp://localhost:61616) (必填)。
  • jms.persistent:JMS 消息是否持久。这样,Talend SAP RFC Server 就会保留以 IDoc 命名的队列中接收的所有 IDoc 的副本。这是为了以批处理模式为 tSAPIDocsReceiver 组件服务。当该接收器运行时,它会收集自从它上次运行以来存储在长久队列中的所有 IDoc。

默认情况下,消息在队列中最多保留七天。您可以更改保留期,方法是取消注释该配置文件中的此参数,并更新其值以满足您自己的需求。

  • jms.dataDirectory:JMS 代理用来对数据进行持久化的文件系统位置。
  • jms.useJmx:设置是否将代理的服务公开到 JMX 中。

Remote broker 部分

远程代理部分详细介绍了到远程或外部代理的连接信息。如果使用嵌入式代理,此部分将被注释掉。以下列出设置:

  • jms.broker.url:处于活动状态时,连接到远程代理而非嵌入式代理。
  • jms.reconnect.interval:尝试重连之间的时间间隔。
  • rfc.server.remote.broker.url:用于故障转移代理的 URL。需按以下形式提供代理 URL:rfc.server.remote.broker.url=failover:(tcp://ip_address1:port_number1,tcp://ip_address2:port_number2, ...)
注: 仅当您安装了R2021-01 RFC 服务器更新或 Talend 提供的更高版本时,rfc.server.remote.broker.url 参数才有效。更多信息,请与您的管理员确认。

Error Page's Content 部分

Error Page's Content 部分定义如何显示出错消息。参数值可以是 alwayson-paramnever。默认值为 always

  • server.error.include-message=always
  • server.error.include-binding-errors=always
注: 仅在安装 Talend 提供的 8.0 R2022-05 Studio 月度更新或更高版本的情况下,此节的两个参数才可用。更多信息,请与您的管理员确认。

Kafka 部分

Kafka 部分详细介绍了使用流式处理功能所需的 Kafka 连接信息。它还包含用于将 Azure 事件中心配置为 Kafka 群集的设置。

  • kafka.bootstrap.servers=<kafka_setting>: Kafka 代理地址 (以 host:port number 的形式),以逗号分隔 (必填)。
  • 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}";
注:
  • 当 SAP 连接配置文件中 feature.streaming.enabled 设为 true 时,kafka.security.protocol=SASL_SSLkafka.sasl.mechanism=PLAINkafka.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required username="$ConnectionString" password="{YOUR.EVENTHUBS.CONNECTION.STRING}"; 为必填项。
  • 有关将 Azure 事件中心配置为 Kafaka 集群的更多信息,参阅 快速入门:使用 Kafka 协议通过事件中心进行数据流式传输