# 配置 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 链接配置文件所在的路径或目录 (必填)。

信息注释注： 只有在您应用 [Patch_20210820_TDI-45536_v1-7.3.1](https://artifacts-zl.talend.com/nexus/content/repositories/releases/org/talend/tsap-rfc-server/7.3.1-R2021-08/) （仅提供英文版本） 更新补丁后，named.connections 参数才有效。

## Health 部分

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

* management.endpoint.health.show-details: 设置显示健康信息的级别，该健康信息通过概括所有的 HealthIndicator 结果进行搜集。 (必填)

信息注释注： 只有在您应用 [Patch_20210820_TDI-45536_v1-7.3.1](https://artifacts-zl.talend.com/nexus/content/repositories/releases/org/talend/tsap-rfc-server/7.3.1-R2021-08/) （仅提供英文版本） 更新补丁后，此节参数才有效。

## 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 参数才有效。更多信息，请与您的管理员确认。

## 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 协议通过事件中心进行数据流式传输](https://docs.microsoft.com/en-US/azure/event-hubs/event-hubs-quickstart-kafka-enabled-event-hubs) （仅提供英文版本）。