# Remote Engine設定ファイル

このドキュメントでは、エンジンの日常的な使用に最も関連するRemote Engineファイルを紹介します。

| 設定ファイル | 説明 |
| --- | --- |
| /etc/keystores | Remote Engineはペアリング時に独自のキーペア(RSA/4096ビット)を生成します。Talend Remote Engine v2.12.5以降、このキーペアはetc/keystoresのJavaキーストアに格納され、専用の設定ファイルで定義されているパスワード、または環境変数として定義されているパスワードで保護されます。<br><br>パスワードが定義されていない場合は代わりにランダムな値が生成されます。これによって、暗号化された状態でプライベートキーを格納し続けられるようになります。<br><br>このキーペアはTalend Remote EngineとTalend Management Consoleの間で転送される情報の保護で使われます。 |
| /etc/org.apache.karaf.management.cfg | Remote EngineへのJMXアクセスを有効にします。[JMXを使ってリモートアクセスを有効化](https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/enabling-remote-access-using-jmx-optional)をご覧ください。 |
| /etc/org.apache.karaf.shell.cfg | Remote EngineへのSSHアクセスを有効にします。[SSHを使ってリモートアクセスを有効化](https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/enabling-remote-access-using-ssh-optional)をご覧ください。 |
| /etc/org.ops4j.pax.logging.cfg and /tec/org.talend.ipaas.rt.logs.cfg | <ul> <li>Remote Engineから<span>Talend Management Console</span>へのログ送信を有効または無効にします。詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/stop-sending-logs-to-cloud" target="_blank">エンジンからTalend Cloudへのログ送信を阻止</a>をご覧ください。</li> <li>サードパーティーシステム(JMSアペンダー、Syslogアペンダー、外部フォルダーなど)にログを送信します。詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/custom-logging-config-in-re" target="_blank">カスタムロギングを設定</a>をご覧ください。</li> <li>エンジンログフィルターを変更し、アーティファクト実行ログを含めたり除外したりします。<a href="https://help.qlik.com/talend/ja-JP/remote-engine-user-guide-linux/Cloud/automatic-task-log-cleanup#activate-execution-log-duplicating" target="_blank">タスクログのクリーンアップサイクルを変更</a>をご覧ください。</li> </ul> |
| /etc/org.ops4j.pax.web.cfg | <ul> <li>Remote Engineがポート8043 (HTTP)でリッスンしないようにし、代わりにセキュアRemote Engineポート(9004)を使用するよう、<span>org.osgi.service.http.enabled = false</span>を追加することをお勧めします。 <p>信頼できるクライアント証明書を使ってこのポートにアクセスする方法は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/creating-trusted-client-certificate" target="_blank">信頼済みクライアント証明書を作成</a>をご覧ください。</p></li> <li>他のマシンからのRemote Engineへのリモートアクセスを有効にします。<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/enabling-remote-access-using-http-optional" target="_blank">HTTPを使ってリモートアクセスを有効化</a>をご覧ください。</li> </ul> |
| /etc/org.talend.ipaas.rt.deployment.agent.cfg | このファイルには、アーティファクトのデプロイメントパラメーターが保管されます。<br><br><ul> <li><span>local.maven.clean.interval.days</span>パラメーターは、エンジンで使用されていないアーティファクトの自動クリーンアップを制御します。Remote Engineの回復力設定の詳細については、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/purge-artifacts-in-remote-engine" target="_blank">アーティファクトのクリーンアップを自動化</a>をご覧ください。</li> <li>単一エンジンまたはエンジンクラスターでの最大並列実行数を設定します。Remote Engineでの並列実行の詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/run-tasks-in-parallel-on-remote-engine" target="_blank">Remote Engineでタスクを並列実行</a>をご覧ください。</li> <li>定期的なクリーンアッププロセスを設定し、未使用のアーティファクトを自動的に削除します。参照 </li> </ul> |
| /etc/org.talend.ipaas.rt.dsrunner.cfg | <ul> <li>(Linuxのみ)データサービスやルートタスクを実行するため、実行ユーザーを設定して<span>sudo</span>機能を有効にします。<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/configuring-impersonate-users-for-microservice-esb-jobs" target="_blank">マイクロサービスのデータサービス/ルートで実行ユーザーを設定</a>と<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/starting-talend-remote-engine-sudo" target="_blank">Talend Remote Engineの起動 (sudo)</a>をご覧ください。</li> <li><span> Talend Runtime</span>用のカスタムバンドルデプロイメントディレクトリーを設定</li> </ul> |
| /etc/org.talend.ipaas.rt.dsrunner.talendruntime.client.cfg | Talend Runtimeへのアクセスを保護するための認証情報を定義します。 |
| /etc/org.talend.ipaas.rt.keypair.manager.cfg | ランダムなパスワードから置き換える独自のパスワードを定義し、キーストアへのアクセスを暗号化して保護します。そのためには、エンジンのペアリングを解除し、そのペアリングのために以前に生成されたキーペアとキーストアを削除する必要があります。<br><br>キーストアを暗号化するために独自のパスワードを定義する方法は、[エンジンのパブリックキーとプライベートキーを保護](https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-windows/securing-keystore-access-remote-engines)をご覧ください。 |
| /etc/org.talend.ipaas.rt.job.commandline.handler.cfg | ジョブ実行時のstdoutログとstderrのログをLog4jログに追加し、Talend Management Consoleに情報を表示させます。<br><br>詳細は、[Talend Management Consoleに標準システムログを表示](https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/displaying-standard-log-in-tmc)をご覧ください。 |
| /etc/org.talend.ipaas.rt.jobserver.client.cfg | <ul> <li>ロックされた接続パラメーターをタスク実行ログでマスクするため、次のパラメーターを追加します:<pre><code><pre><code><code>job.log.msg.sensitive.hidden=true</code></code></pre></code></pre><p>詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/securing-masking-hiding-encrypting-sensitive-secret-password-in-the-context-parameters-sent-by-remote-engines" target="_blank">ログ内の機密情報</a>をご覧ください。</p></li> <li>CPUとメモリ消費量の急増を緩和するため、次のパラメータを追加します:<ul> <li><span>job.log.msg.size.max</span></li> <li><span>job.log.msg.buffer.size.max</span></li> <li><span>thread.timeout</span></li> </ul><p>詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/securing-masking-hiding-encrypting-sensitive-secret-password-in-the-context-parameters-sent-by-remote-engines" target="_blank">ログ内の機密情報</a>でトラブルシューティングのセクションをご覧ください。</p></li> <li>Remote Engine v2.12.9以降では、次のパラメーターを追加することでジョブタスクのパスワード型パラメーターを暗号化できます:<pre><code><pre><code><code>job.ctx.params.file.sensitive.values.encrypted=true</code></code></pre></code></pre></li> <li><span>Talend Remote Engine</span>ジョブのログレベルを変更します。<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/changing-talend-remote-engine-job-log-level" target="_blank">Remote Engineジョブのログレベルを変更</a>をご覧ください。</li> <li>ログのクリーンアップのライフサイクルを調整します。<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/automatic-task-log-cleanup" target="_blank">タスクログのクリーンアップサイクルを変更</a>をご覧ください。</li> <li><span>Talend Studio</span>のロギング設定を使用します。<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/enabling-custom-logging" target="_blank">Talend Studioで定義されたカスタムロギング設定を使用</a>をご覧ください。</li> </ul> |
| /etc/org.talend.remote.jobserver.server.cfg | このファイルには、データ統合タスクを実行するエンジンに組み込まれているJobServerを設定するためのパラメーターが含まれています。定義またはアップデートできる設定は次のとおりです:<br><br><ul> <li><span>Talend Studio</span>と<span>Talend Remote Engine</span>の間の接続に使用する設定を追加します。<p>詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/configuring-connection-between-talend-studio-and-talend-remote-engine" target="_blank">Talend StudioとRemote Engineの間に接続を設定</a>をご覧ください。</p></li> <li>Remote Engine内のJobServerサーバーとJobServerクライアント間のSSL接続のためにJobServerサーバー設定を行います。JobServerクライアントの設定は<span>etc/system.properties</span>に追加されます。<p>Remote EngineでのSSL接続の詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/enabling-ssl-connection" target="_blank">SSL接続を有効化</a>をご覧ください。 </p></li> <li>(Linuxのみ)データ情報タスクを実行するため、実行ユーザーを設定して<span>sudo</span>機能を有効にします。<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/configuring-impersonate-users-for-di-jobs" target="_blank">データ統合ジョブで実行ユーザーを設定</a>と<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/starting-talend-remote-engine-sudo" target="_blank">Talend Remote Engineの起動 (sudo)</a>をご覧ください。</li> <li>Remote Engineに自分の署名キーを使用させ、アーティファクト署名を検証します。<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/verifying-artifact-signature" target="_blank">カスタム署名キーによってアーティファクト署名を検証</a>をご覧ください。</li> <li>フォルダーやファイル名に対してより厳しい制限を設定することで、DoS攻撃を軽減または防止します。<a href="https://help.qlik.com/talend/ja-JP/installation-guide-windows/Cloud/security-setup-for-remote-engine#remote-engine-jobserver-improving-security-malicious-archive-content" target="_blank">悪意のあるアーカイブコンテンツに対するセキュリティを改善</a>を参照してください。</li> </ul><br><br><br>パラメーターの詳細なリストと説明は、設定ファイルの中にあります。 |
| /etc/preauthorized.key.cfg | このファイルには、Remote Engineのペアリングキー(つまり事前承認キー)、およびペアリングされるエンジンの説明が保管されます。<br><br>このファイルを使用したエンジンのペアリング方法の詳細は、[設定ファイルを使ってRemote Engineをペアリング](https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-windows/pairing-remote-engines-with-configuration-file)をご覧ください。 |
| /etc/system.properties | <ul> <li>安全な再起動処理を有効にします。<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/gracefull-remote-engine-reboot-on-linux" target="_blank">Remote Engineの安全な再起動処理を有効化</a>をご覧ください。</li> <li>Remote Engine内のJobServerサーバーとJobServerクライアント間のSSL接続を確立するため、JobServerのクライアント設定とサーバー設定を別々のファイルに追加します。クライアント設定はこの<span>/etc/system.properties</span>ファイルに、サーバー設定は<span>/etc/org.talend.remote.jobserver.server.cfg</span>に追加されます。 <p>Remote EngineでのSSL接続の詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/enabling-ssl-connection" target="_blank">SSL接続を有効化</a>をご覧ください。</p></li> <li>Remote Engineのプロキシ設定を構成します。<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/configuring-proxy-settings-for-remote-engines" target="_blank">Remote Engineのプロキシ設定を構成</a>と<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/configuring-remote-engine-proxy-authentication" target="_blank">Remote Engineのプロキシ認証を構成</a>をご覧ください。</li> </ul> |
| /etc/talend-remote-engine-wrapper.conf | この設定ファイルは、[Karafラッパー設定ファイル](https://karaf.apache.org/manual/latest-3.0.x/wrapper#_configuration)に基づいて、ラッパーとして機能します。このファイルは、エンジンをサービスとしてオペレーティングシステムに統合します。そのため、このファイルを利用できるのはRemote EngineをWindowsサービスまたはLinuxサービスとしてインストールした場合のみです。まだインストールされておらず、インストールに関するガイダンスが必要な場合は、[Windows版](https://help.qlik.com/talend/r/ja-JP/Cloud/installation-guide-linux/installing-and-uninstalling-remote-engine-service-systemd)または[Linux版](https://help.qlik.com/talend/r/ja-JP/Cloud/installation-guide-linux/installing-and-uninstalling-remote-engine-service-system-v)をご覧ください。<br><br>このファイルでは、必要に応じて、エンジンによって使用される特定のシステム環境プロパティを定義します。例:<br><br><ul> <li>このラッパーファイルの<span>JVMパラメーター</span>セクションで、 エンジンによって使われるJVM設定を指定します。これらのJVM設定によってサービスとしてエンジンに割り当てられるリソースが決定しますが、<span>Talend Management Console</span>の実行プロファイルで定義されたJVM設定は特定の実行に割り当てられるリソースを参照します。</li> <li>Remote Engineで実行するジョブがサードパーティツール(SDKやMelissaDataなど)に依存している場合は、次の形式を使い、そのRemote Engineのラッパー設定ファイルでそのツールへのパスを指定します。<pre><code><pre><code><code>set.PATH=&lt;PATH_TO_SDK&gt;;%PATH%</code></code></pre></code></pre>この行は、PATH環境変数の既存の内容を保持しながらサードパーティツールの場所をエンジンに通知します。詳細は、<a href="https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-windows/enabling-execution-of-jobs-using-external-tools-sdk" target="_blank">外部ツール(SDK)を使用するジョブの実行を有効化</a>をご覧ください。</li> <li>v2.14.1以降のWindowsでは、JobServerのSSL通信に使用されるSSLキーストアのパスワードは、このファイルに次の形式で保存されます。<pre><code><pre><code><code>set.TMC_ENGINE_JOB_SERVER_SSL_KEY_STORE_PASSWORD=&lt;password&gt;</code></code></pre></code></pre>詳細については、<a href="https://help.qlik.com/talend/ja-JP/remote-engine-user-guide-linux/Cloud/enabling-ssl-connection" title="Remote Engine内のJobServerサーバーとJobServerクライアントの間に安全な接続を設定します。">Remote Engineとそのジョブサーバー間のSSL通信を有効化</a>を参照してください。</li> </ul> |
| /etc/users.properties | デフォルトのセキュリティ設定では、&lt;RemoteEngineInstallationDirectory&gt;/etc/users.propertiesにあるプロパティファイルを使って認証ユーザーとそのパスワードが保存されます。<br><br>詳細は、[Remote Engineユーザーとパスワード](https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/managing-users-and-passwords)をご覧ください。 |
| /TalendJobServersFiles | Remote Engineは、TalendJobServersFilesというフォルダーに保存されているジョブタスクの依存項目(ジョブアーティファクト、ログ、作業フォルダーなど)にアクセスする必要があります。複数のエンジンをデプロイする場合は、Remote Engineの各インスタンスにTalendJobServersFilesフォルダーが個別に存在することを確認します。<br><br>複数のエンジンをデプロイする方法は、[複数のRemote Engineをデプロイ](https://help.qlik.com/talend/r/ja-JP/Cloud/remote-engine-user-guide-linux/deploying-multiple-remote-engines)をご覧ください。 |
| /TalendJobServersFiles/jobexecutions/logs/ | タスク実行のログはこのディレクトリーに保存されます。 |