|
IntegrationRuntime Thing Template から Thing を作成しないでください。
|
|
以下の例で、コンフィギュレーションファイル全体を暗号化している場合には -Dencrypted.config.file=true を必ず指定する必要があり、暗号化されている Integration Runtime コンフィギュレーションファイルへのパスを指していなければなりません。ファイル内のエントリだけを暗号化している場合、この設定を省略するか false に設定します。
|
設定
|
デフォルト
|
説明
|
---|---|---|
traceRoutes
|
false
|
ルートの実行で、ルートの各プロセッサが呼び出されるたびにメッセージをログ記録するかどうかを指定します。
|
Thingworx
|
JSON フォーマットで ThingWorx Platform への接続の設定を指定します。
|
|
SSL
|
JSON フォーマットで Secure Sockets Layer (SSL) 設定を指定します。
|
設定
|
デフォルト
|
説明
|
||
---|---|---|---|---|
appKey
|
この Integration Runtime を使用できるように設定されている、ThingWorx Platform からアプリケーションキーを指定します。この設定は、Java システムプロパティを使用してオーバーライドできます。
|
|||
basePath
|
/Thingworx
|
ThingWorx Platform の URI の基本パスを指定します。この設定は、Java システムプロパティを使用してオーバーライドできます。
|
||
host
|
localhost
|
ThingWorx Platform の URI のホストを指定します。この設定は、Java システムプロパティを使用してオーバーライドできます。
|
||
port
|
443
|
ThingWorx Platform の URI のポートを指定します。この設定は、Java システムプロパティを使用してオーバーライドできます。
|
||
sslEnable
|
true
|
WebSocket を介して ThingWorx Platform に接続するために SSL を使用するかどうかを指定します。true の場合、URI に "wss" プロトコルが使用されます。その他の場合、"ws" プロトコルが使用されます。
|
||
ignoreSSLErrors
|
false
|
SSL エラーを無視するかどうかを指定します。本番環境では、この値を true に設定しないでください。
|
設定
|
デフォルト
|
説明
|
---|---|---|
verbose
|
false
|
Java ハンドシェイクプロトコルで詳細メッセージを出力するかどうかを指定します。true の場合、Java システムプロパティ javax.net.debug が ssl:handshake: verbose に設定されます。
|
Keystore
|
JSON フォーマットで SSL キーストアの設定を指定します。
|
|
Truststore
|
JSON フォーマットで SSL トラストストアの設定を指定します。
|
設定
|
説明
|
---|---|
path
|
SSL キーストアファイルのパスを指定します。この設定を使用することは、Java システムプロパティ javax.net.ssl.keyStore を設定するのと同等です。
|
password
|
SSL キーストアファイルのパスワードを指定します。この設定を使用することは、Java システムプロパティ javax.net.ssl.keyStorePassword を設定するのと同等です。パスワードをプレーンテキストとして保存することを避けるため、値 encrypt.keystore.password を使用します。この後の「暗号化パスワードの設定」セクションを参照してください。
|
設定
|
説明
|
---|---|
path
|
SSL トラストストアファイルのパスを指定します。この設定を使用することは、Java システムプロパティ javax.net.ssl.trustStore を設定するのと同等です。
|
password
|
SSL トラストストアのファイルのパスワードを指定します。この設定を使用することは、Java システムプロパティ javax.net.ssl.trustStorePassword を設定するのと同等です。パスワードをプレーンテキストとして保存することを避けるため、値 encrypt.truststore.password を使用します。この後の「暗号化パスワードの設定」セクションを参照してください。
|
設定
|
デフォルト
|
説明
|
---|---|---|
MaximumRetries
|
2
|
システムの可用性が理由で失敗したリクエストを再試行する回数を指定します。
HTTP リクエストの場合、サーバーからの 503 レスポンスで再試行が発生します。
|
RetryDelay
|
1000
|
リクエストが失敗し、再試行が可能な場合、RetryDelay は再試行する前に待機する時間をミリ秒単位で表します。RetryDelay は、その後の再試行を決定するときに BackoffMultiplier とともに使用されます。
|
BackoffMultiplier
|
1
|
その後の再試行で RetryDelay を乗算する期間を指定します。たとえば、BackoffMultiplier が 2 に設定され、MaximumRetries が 3 に設定されている場合、最初の再試行は 1 秒で、2 回目の再試行はその 2 秒後、3 回目の再試行はその 4 秒後というように行われます。
|
UnauthorizedRetries
|
2
|
未承認のリクエストが理由で失敗したリクエストについて、再試行する回数を指定します。この設定は、サーバーからの 401 レスポンスで HTTP リクエストに適用されます。
|
設定
|
デフォルト
|
説明
|
---|---|---|
MaximumRedirects
|
3
|
リダイレクトを再試行する回数を指定します。
|
EnableRedirect
|
true
|
リダイレクトステータスコード 3xx のリクエストに対し、リダイレクトを有効にするかどうかを指定します。
|
|
暗号化されたコンフィギュレーションファイルは任意の場所に保管できます。暗号化コンフィギュレーションファイルおよび環境変数のパスが正しく設定されていることを設定します。
|
|
integrationRuntime-settings.json.decrypted のコンテンツが元の integrationRuntime-settings.json ファイルのコンテンツと一致していなければなりません。
|
|
暗号化されていないバージョンのファイルを除去します。
|
ThingWorx のコンフィギュレーション
|
Integration Runtime 設定
|
---|---|
ThingWorx が SSL 用に設定されていない
|
Java システムプロパティを使用して ThingworxUri を指定して ws プロトコルを使用するか、SSL 設定で sslEnable=false を指定します。
|
ThingWorx が自己署名証明書を使用した SSL 用に設定されている
|
SSL 設定で sslEnable=true および ignoreSSLErrors=true を指定します。
|
ThingWorx が自己署名証明書を使用した SSL 用に設定されており、その証明書が信頼できる。
ThingWorx は証明機関 (CA) によって署名された証明書を使用した SSL 用に設定されており、CA 証明書チェーン全体を提供するようには設定されていない。
|
キーストアファイルから証明書をエクスポートし、トラストストアファイルにインポートします。
SSL 設定で enable=true および Trustore を指定します。
トラストストアのパスワードを暗号化できます。
または、証明書を Integration Runtime JVM のデフォルトのトラストストア (通常は $JAVA_ホーム/lib/security/cacerts に配置されている) に追加します。この場合、SSL 設定でトラストストアを明示的に指定する必要はありません。
|
ThingWorx は証明機関 (CA) によって署名された証明書を使用した SSL 用に設定されており、CA 証明書チェーン全体を提供するように設定されている。
|
SSL 設定で enable=true を指定します。これはデフォルトの設定です。
|
設定
|
デフォルト
|
説明
|
---|---|---|
logs.dir
|
ログファイルが生成される場所を指定します。デフォルトは、現在のワーキングディレクトリです。
|
|
logs.maxFileSize
|
5MB
|
新しいログファイルへのロールオーバーをトリガする、ログファイルの最大サイズを指定します。
|
logs.maxIndex
|
9
|
固定サイズのロールオーバーウィンドウの最大インデックスを指定します。初期インデックスは 1 から始まります。
|
logs.timestampPattern
|
yyyy-dd-MM HH:mm:ss.SSS
|
各ログイベントに使用するタイムスタンプパターンを指定します。
|
logs.uniqueId
|
<processId>
|
ログファイルの名前に追加される値を指定します。これを使用して、一意のファイル名が生成されます。デフォルト値は、JVM のプロセス ID を返す Java コールバックを介して取得されます。
|