# 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接続設定ファイル(必須)を保持するディレクトリーへのパスを指定します。

## Healthセクション

このセクションでは、健康情報の表示を管理します。

* management.endpoint.health.show-details:HealthIndicator結果の集約によって収集される健康情報の表示レベルを設定します。

## JMS brokerセクション

JMSブローカーセクションでは、組み込みまたはリモートのJMSブローカーとの対話を設定するために使われます。

ユーザー認証を有効にするには、設定ファイル内の次の4つのパラメーターのコメントを解除し、その値を設定する必要があります。ユーザー認証を有効にしない場合、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メッセージを持続キューで複製するかどうか決定します。
* jms.durable.queue.retentionPeriod:持続キュー内のJMSメッセージの保存期間(ミリ秒) (デフォルトでは7日間)。
* jms.idoc.queue.prefix=TALEND.IDOCS.:IDocメッセージに使用されるJMSキューまたはトピック名のプレフィックス。単一のActiveMQインスタンスに複数のSAPシステムを接続する際は、キュー名の競合を避けるためにこの値を変更してください。
* jms.datasource.queue.prefix=TALEND.DATASOURCES.:BW Datasourceに使用されるJMSキューまたはトピック名のプレフィックス。単一のActiveMQインスタンスに複数のSAPシステムを接続する際は、キュー名の競合を避けるためにこの値を変更してください。

情報メモ注: 上記の2つのキュープレフィックスパラメーターは、Qlikから提供される8.0.1-R2026-08 Talend Studioマンスリーアップデート、またはそれ以降のアップデートをインストールしている場合にのみ利用可能です。詳細は管理者にお問い合わせください。

## Embedded brokerセクション

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

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

デフォルトでは、メッセージはキューに最大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, ...)という形式で入力する必要があります。

## 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 Event Hubを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) (英語のみ)をご覧ください。