# tsap-rfc-server.propertiesファイルを設定

Talend SAP RFC Serverの設定ファイルであるtsap-rfc-server.propertiesは、$TSAPS\_HOME/confディレクトリーの下にあります。$TSAPS\_HOMEは、Talend SAP RFC Serverがインストールされたディレクトリーに相当します。このファイルは5つのセクションで構成されています。Talend SAP RFC Serverを開始する前に、必要に応じてサーバーのいくつかの追加の機能を有効にするようにファイルを設定できます。

情報メモ注:

* Talend SAP RFC ServerはSAPクラスター設定をサポートしていません。
* 設定ファイルを変更するには、Talend SAP RFC Serverの再起動が必要になります。

## セクションの前

* logging.config: ログレベルを設定する(必須)ログ設定ファイルを指定します。
* loader.path: sapjco3.jarが含まれるよう、クラスパスに追加するディレクトリーまたはアーカイブを指定します。ディレクトリーとアーカイブはコンマで区切られる(必須)必要があります。
* named.connections: SAP接続設定ファイル(必須)を保持するディレクトリーへのパスを指定します。

情報メモ注: logging.configパラメーター、loader.pathパラメーター、named.connectionsパラメーターは、[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/)を適用した場合のみ有効です。

## 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ブローカーとの対話を設定するために使われます。

ユーザー認証を有効にするには、設定ファイル内の次の3つのパラメーターのコメントを解除し、その値を設定する必要があります。ユーザー認証を有効にしない場合、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用のKeystoreファイルを$TSAPS\_HOME/confフォルダーにコピーします。次に、設定ファイルの以下の2つのパラメーター(キーストアファイルへのパスとキーストアファイルのパスワード)をコメント解除し、それらの値を設定します。

* jms.ssl.keystore.path: SSL用のKeystoreへのパス。
* jms.ssl.keystore.password: SSL用のKeystoreのパスワード。
* jms.durable.queue.replicate: JMSメッセージを持続キューで複製するかどうか決定します。バッチモードを使用する時は、このプロパティを有効にする必要があります。また、SAP RFC サーバーに障害が発生した場合にメッセージを保持したい場合も、このプロパティを有効にする必要があります。
* jms.durable.queue.retentionPeriod: 持続キュー内のJMSメッセージの保存期間(ミリ秒) (デフォルトでは7日間)。バッチモードを使用する時は、このプロパティを有効にする必要があります。また、SAP RFC サーバーに障害が発生した場合にメッセージを保持したい場合も、このプロパティを有効にする必要があります。

## Embedded brokerセクション

組み込みブローカーセクションには、使用された組み込みJMSブローカーの接続情報があります。外部JMSブローカーを使用する場合、これらの値はコメントアウトされています。設定は次のとおりです。

* jms.bindAddress: 着信接続をリッスンするJMSブローカー(必須)のホストアドレスとポート(たとえば: tcp://localhost:61616)。
* jms.persistent: JMSメッセージを存続させるかどうかを決定します。こうすることで、Talend SAP RFC ServerではIDocsから名付けられたキューで受信するIDocのコピーがすべて保持されます。これは、バッチモードでtSAPIDocsReceiverコンポーネントを動作させるためのものです。レシーバーが実行されると、最後の実行以降に持続性キューに格納されているすべてのIDocが収集されます。バッチモードを使用する時は、このプロパティを有効にする必要があります。また、SAP RFC サーバーに障害が発生した場合にメッセージを保持したい場合も、このプロパティを有効にする必要があります。

デフォルトでは、メッセージはキューに最大7日間保持されます。この保持期間を変更するには、設定ファイルでこのパラメーターをコメント解除し、要件が満たされるようにその値を更新します。

* 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パラメーターは、Qlikが提供するR2021-01 RFC以降のサーバーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。

## Error Page's Contentセクション

エラーページの[Content] (コンテンツ)セクションでは、エラーメッセージの表示方法が指定されます。値はalways、on-param、neverのいずれかとなります。デフォルトはalwaysです。

* spring.web.error.include-message=always
* spring.web.error.include-binding-errors=always

情報メモ注: このセクションにある2つのパラメーターは、Qlikが提供する8.0.1-R2026-06以降のTalend Studioマンスリーアップデートをインストール済みである場合のみ利用できます。詳細は管理者にお問い合わせください。

## Kafkaセクション

Kafkaセクションには、ストリーミングモード機能の使用に必要となるKafka接続情報があります。また、Azure Event Hubを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}";

情報メモ注:

* 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に設定されている時のみ必要です
* Azure EventhubをKafkaクラスターとしての設定に関する詳細は、[Quickstart: Data streaming with Event Hubs using the Kafka protocol](https://docs.microsoft.com/en-us/azure/event-hubs/event-hubs-quickstart-kafka-enabled-event-hubs)をご覧ください。