PTC RV&S Agent 構成プロパティ
ここでは、PTC RV&S Agent の動作に影響を与える構成プロパティについて説明します。これらのプロパティは次のファイルに含まれます。
installdir/config/agent.properties
 |
ディレクトリまたはファイル パスの値を指定する場合は、スラッシュ (/) を 1 つ使用する必要があります。
|
この構成プロパティ ファイルの変更を有効にするには、PTC RV&S Agent を再起動する必要があります。
|
PTC RV&S Agent プロパティ
|
説明
|
|---|---|
|
mksagent.clear.port
|
クリア テキストのポート番号。クリア ポートを無効にするには、ポリシーを 0 に設定します(古いポート番号はコメントで維持できます)。
ポート番号は 65535 を超えないようにしてください。Linux マシンで 1024 より小さい番号を使用するには、さらに権限が必要になる場合があります。
サーバー マシンで既に使用されているポート番号を指定した場合は、PTC RV&S Agent を実行しようとするとシャットダウンします。デフォルトは 9101 です。
|
|
mksagent.secure.port
|
セキュア (TLS または SSL) ポート番号。セキュア ポートを無効にするには、ポリシーを 0 に設定します(古いポート番号はコメントで維持できます)。
ポート番号は 65535 を超えないようにしてください。Linux マシンで 1024 より小さい番号を使用するには、さらに権限が必要になる場合があります。
リモート マシンで既に使用されているポート番号を指定した場合は、PTC RV&S Agent を実行しようとするとシャットダウンします。
0 以外の値を指定した場合は、セキュア ポートが使用されます。これがサーバーで開くことのできる唯一のポートです。デフォルトは 0 です。
|
|
mksagent.privatekey.password
|
サーバーの証明書の秘密キーを証明書ストアから復元するためのパスワード。パスワードは証明書ストアに保存されているものと一致する必要があります。ポリシーはセキュア ポートが有効になっている場合にだけ使用されます。
|
|
mksagent.smtpserver.hostname
|
イベント トリガー環境ビーンのメソッド sendMail() で使用されるメール サーバーの名前。デフォルトでは、このプロパティは無効になっています。
|
|
mksagent.smtpserver.port
|
イベント トリガー環境ビーンのメソッド sendMail() で使用されるメール サーバーのポート。デフォルト ポートは 25 です。
|
|
mksagent.triggers.environmentVariables
|
イベント トリガー環境ビーンの実行時プロパティが含まれているファイル。デフォルトは data/triggers/env.properties です。
|
|
java.system.property.smtpencoding
|
電子メールの送信時に使用される文字セット。デフォルトは UTF-8 です。
|
|
java.security.property.networkaddress.cache.ttl
|
フェールオーバー時のディレクトリ サーバーへの正常な接続をキャッシュする秒数。デフォルトは 60 です。
|
|
java.security.property.networkaddress.cache.negative
|
フェールオーバー時のディレクトリ サーバーへの接続失敗をキャッシュする秒数。デフォルトは 60 です。
|
|
mksagent.apiSession.defaultHostname
mksagent.apiSession.defaultPort
mksagent.apiSession.defaultUser
mksagent.apiSession.defaultPassword
|
トリガー環境ビーンから使用できるデフォルトの統合 API セッションを定義するプロパティ。
|
|
mksagent.rmi.connectiontimeout
|
エージェントアプリケーションからメインの PTC RV&S Server に対する RMI スレッドのタイムアウト時間を秒単位で指定します。
帯域幅が低いネットワーク環境や、遅延が多く発生するネットワーク環境の場合、PTC RV&S Agent アプリケーションからの RMI スレッドが、メインサーバーへの接続中に長時間ブロックされることがあります。ネットワークの帯域幅や遅延に応じて、このプロパティの値を調整することができます。
値を「0」に設定するとタイムアウトが無効になり、アプリケーションスレッドはサーバーとの接続が成功するまで無期限に待機します。
|
|
mksagent.patch.download.attempts
|
クライアント側の CPS または修正プログラムの zip ファイルを PTC RV&S メインサーバーからダウンロードするエージェントの最大試行回数を指定します。
ファイルがサーバーから完全にダウンロードされる前にサーバーとエージェント間の接続が切断された場合、CPS または修正プログラムの zip ファイルのダウンロード操作が完全には実行されない可能性があります。その場合、エージェントによってダウンロードされた CPS または修正プログラムの zip ファイルが不完全な状態になったり破損したりする可能性があります。
この設定では、不完全なコピーがエージェントで検出された場合に、エージェントが CPS または修正プログラムの zip ファイルのダウンロードを試行する最大回数を指定します。エージェントがダウンロードを複数回試行しても CPS または修正プログラムが正常に配布されない場合は、ネットワークの安定性を確認してください。
このプロパティのデフォルト値は「10」です。このプロパティの値を「0」に設定すると、再試行が実行されなくなります。
|