配置 tsap-rfc-server.properties 文件
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, ...)。
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 协议通过事件中心进行数据流式传输 (仅提供英文版本)。