跳到主要内容 跳到补充内容

配置 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 密码,用于验证发布者或发送者。
信息注释注: 用户名和密码值将供 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, ...)

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.1-R2022-05 Studio Talend 月度更新或更高版本的情况下,此节的两个参数才可用。更多信息,请与您的管理员确认。

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 协议通过事件中心进行数据流式传输 (仅提供英文版本)

本页面有帮助吗?

如果您发现此页面或其内容有任何问题 – 打字错误、遗漏步骤或技术错误 – 请告诉我们如何改进!