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 链接配置文件所在的路径或目录 (必填)。
Health
部分
此节控制健康信息的显示。
-
management.endpoint.health.show-details
: 设置显示健康信息的级别,该健康信息通过概括所有的 HealthIndicator 结果进行搜集。 (必填)
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 密码,用于验证发布者或发送者。
要启用 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, ...)
。
rfc.server.remote.broker.url
参数才有效。更多信息,请与您的管理员确认。Error Page's Content
部分
Error Page's Content 部分定义如何显示出错消息。参数值可以是 always
、on-param
和 never
。默认值为 always
。
server.error.include-message=always
server.error.include-binding-errors=always
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_SSL
、kafka.sasl.mechanism=PLAIN
及kafka.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required username="$ConnectionString" password="{YOUR.EVENTHUBS.CONNECTION.STRING}";
为必填项。 - 有关将 Azure 事件中心配置为 Kafaka 集群的更多信息,参阅 快速入门: 使用 Kafka 协议通过事件中心进行数据流式传输。