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

SAP

Version
7.3
Language
日本語 (日本)
Product
Talend Big Data
Talend Big Data Platform
Talend Data Fabric
Talend Data Integration
Talend Data Management Platform
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for Big Data
Talend Open Studio for Data Integration
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend Studio
Content
ジョブデザインと開発 > サードパーティーシステム > ビジネスアプリケーション > SAP
データガバナンス > サードパーティーシステム > ビジネスアプリケーション > SAP
データクオリティとプレパレーション > サードパーティーシステム > ビジネスアプリケーション > SAP

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を適用した場合のみ有効です。

健康セクション

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

  • management.endpoint.health.show-details: HealthIndicator結果の集約によって収集される健康情報の表示レベルを設定します。
注: このセクションは、Patch_20210820_TDI-45536_v1-7.3.1を適用した場合のみ有効です。

JMSブローカーセクション

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用のキーストアファイルを$TSAPS_HOME/confフォルダーにコピーします。次に、設定ファイルの以下の2つのパラメーター(キーストアファイルへのパスとキーストアファイルのパスワード)をコメント解除し、それらの値を設定します。

  • jms.ssl.keystore.path: SSL用のキーストアへのパス。
  • jms.ssl.keystore.password: SSL用のキーストアのパスワード。
  • jms.durable.queue.replicate: JMSメッセージを持続キューで複製するかどうか決定します。
  • jms.durable.queue.retentionPeriod: 持続キュー内のJMSメッセージの保存期間(ミリ秒) (デフォルトでは7日間)。

組み込みブローカーセクション

組み込みブローカーセクションには、使用された組み込み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に公開するかどうか設定します。

リモートブローカーセクション

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

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

Kafkaセクション

Kafkaセクションには、ストリーミングモード機能の使用に必要となるKafka接続情報があります。また、Azure Eventhubを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_SSLkafka.sasl.mechanism=PLAINkafka.sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required username="$ConnectionString" password="{YOUR.EVENTHUBS.CONNECTION.STRING}";は、SAP接続設定ファイルでfeature.streaming.enabledtrueに設定されている時のみ必要です
  • Azure EventhubをKafkaクラスターとしての設定に関する詳細は、クイック スタート: Kafkaプロトコルを使用したEvent Hubsによるデータストリーミングにご移動ください。