ルート・スキーマ: JTA Migratable Target
タイプ: object
ソースを表示
- additionalMigrationAttempts(optional): integer(int32)
デフォルト値: 2
移行可能サービスが、構成されている可能性のあるサーバーのすべてに移行できないことがあります。この属性は、サービスが各サーバーに対して少なくとも1回ずつ移行を試みて失敗した後、さらに何回移行を試行するかを制御します。ここで指定された各試行は、構成されているすべてのサーバーを改めて一巡して移行を試行することを示しています。つまり、3サーバーのクラスタで値2が指定されている場合は、さらに4回移行が試行されます(元のサーバーは有効な移行先としてはカウントされません)
- allCandidateServers(optional): array Server References
タイトル: Server References
サーバー参照の配列を含みます。
この移行可能なターゲットにデプロイされる移行可能サービスをホストする候補サーバーのリスト。constrainedCandidateServersリストが空の場合、クラスタ内のすべてのサーバーが戻されます。constrainedCandidateServersリストが空でない場合、指定されているサーバーのみが戻されます。ユーザーが優先するサーバーがリスト内の最初の要素となります。
- cluster(optional): array Cluster Reference
タイトル: Cluster Reference
クラスタ参照を含みます。
このシングルトン・サービスが関連付けられているクラスタを戻します。
制約
- constrainedCandidateServers(optional): array Server References
タイトル: Server References
サーバー参照の配列を含みます。
この移行可能なターゲットにデプロイされる移行可能サービスをホストできるサーバーの(ユーザーが制限した)リスト。返されたサーバーのリストに含まれていないサーバーに、移行可能なサービスを移行することはできません。
たとえば、この機能を使用して、デュアルポート・ディスクにアクセスできる2つのサーバーを構成できます。このリスト内のすべてのサーバーは、移行可能なターゲットに関連付けられているクラスタの一部である必要があります。
制約
- critical(optional): boolean
デフォルト値: false
MigratableTargetがWLSサーバー全体のヘルスに対してクリティカルである場合はtrueを返します
- dynamicallyCreated(optional): boolean
読取り専用: true
デフォルト値: false
MBeanが動的に作成されたか、config.xmlに対して永続化されているかが返されます
- hostingServer(optional): array Server Reference
タイトル: Server Reference
読取り専用: true
サーバー参照を含みます。
シングルトン・サービスを現在ホストしているサーバーの名前を戻します。
- id(optional): integer(int64)
- migrationPolicy(optional): string
デフォルト値: manual
指定可能な値: [ "manual", "failure-recovery", "shutdown-recovery" ]
この移行可能なターゲットでホストされるサービスに対して使用する移行ポリシーのタイプを定義します。有効なオプションは次のとおりです:
Manual Service Migration Only: この移行可能なターゲットでホストされるサービスの自動移行は行われないことを示します。
Auto-Migrate Failure-Recovery Services: この移行可能ターゲットのユーザー優先サーバー(UPS)が起動している場合にのみ、移行可能ターゲットでホストされているサービスが起動することを示します。管理者が手動でUPSを正常または強制的にシャットダウンした場合、障害回復サービスは移行しません。ただし、内部エラーによってUPSが失敗した場合、サービスは別の候補サーバーに移行されます。そのような候補サーバーが(手動シャットダウンまたは内部障害のために)使用できない状態の場合、移行フレームワークではまずサービスをそのUPSサーバー上で再アクティブ化しようとします。その時点でUPSサーバーが利用できない場合、そのサービスは別の候補サーバーに移行されます。
Auto-Migrate Shutdown-Recovery Services: サーバーが管理上(正常にまたは強制的に)停止された場合に、この移行可能ターゲットでホストされているサービスが候補サーバーのいずれかに移行されることを示します。リカバリが実行されると、サービスは障害が発生したサーバーに戻されます。
- millisToSleepBetweenAttempts(optional): integer(int32)
デフォルト値: 300000
getAdditionalMigrationAttempts()で示されている移行の試行間に、休止する時間の長さを制御します。この遅延は、サービスがすべてのサーバーには移行できなかった場合にのみ発生します。それ以外に、移行の試行間に遅延が発生することはありません。
- name(optional): string
読取り専用: true
このMBeanインスタンスのユーザー定義の名前。
この名前は、MBeanのjavax.management.ObjectNameに、主要なプロパティとして含まれています
Name=user-specified-name
制約
- nonLocalPostAllowed(optional): boolean
デフォルト値: false
別のマシン上で非アクティブ化後スクリプトの実行を許可するかどうかを指定します。
通常、移行が行われるとき、サービスの現在の場所で非アクティブ化後スクリプトが実行され、サービスの新しい場所でアクティブ化前スクリプトが実行されます。現在の場所がなんらかの理由でアクセスできない場合、サービスの新しいマシン上でスクリプトを実行しても安全かどうかを確認するために、この値がチェックされます。
非アクティブ化後スクリプトがネットワーク・リソースへのアクセスを制御しており、現在のマシンからのデータを必要としない場合に、この機能は便利です。
- notes(optional): string
この構成の説明として任意に入力できる情報。
WebLogic Serverは、ドメインの構成ファイル(config.xml)に、このメモをXML PCDATAとして保存します。すべての左山カッコ(<)はXMLエンティティ<に変換されます。キャリッジ・リターンとライン・フィードは維持されます。
注意: 管理コンソールからメモを作成または編集した場合、キャリッジ・リターンとライン・フィードは維持されません。
- numberOfRestartAttempts(optional): integer(int32)
デフォルト値: 6
障害が発生したサービスを移行する前に、再起動を試行する回数を指定します。
この試行は連続的に行われます。値を6に設定した場合、サービスの再起動が5回失敗してから成功し、その後で再び失敗しても、サービスはすぐに移行されません。成功の前後で、再起動の試行回数がそれぞれカウントされます。
値0はgetRestartOnFailureをfalseに設定する場合と同じになります。-1の値は、サービスが移行されず、かわりに、サービスが機能するか、サーバーが停止されるまで、サービスが再起動されることを示します。
- postScript(optional): string
移行可能なターゲットが完全に非アクティブ化された後で実行する移行後スクリプトのパスを指定します。スクリプトはMIDDLEWARE_HOME/user_projects/domains/mydomain/bin/service_migrationディレクトリに配置する必要があります。
移行可能なターゲットを非アクティブ化した後、スクリプトが指定されていて、かつノード・マネージャが使用可能な場合は、スクリプトが実行されます。使用できるノード・マネージャがない状態でスクリプトを指定すると、移行時にエラーが生じます。
- postScriptFailureFatal(optional): boolean
デフォルト値: true
非アクティブ化後スクリプトの実行中の障害が移行にとって致命的かどうかを指定します。
致命的な場合は、管理者がそのターゲットをサーバーに手動で移行して非アクティブ化するまで、移行可能なターゲットは自動的に移行されません。
注意:この値を有効にすると、「必ず1回」の保証が弱くなります。この機能は、非アクティブ化後スクリプトが失敗した場合に、より危険なデータの破損を防ぐために提供されています。また、この値が有効な場合、移行可能ターゲットが非アクティブ化された後や、移行可能ターゲットをホストするサーバーまたはマシンがクラッシュあるいはネットワークから分離した後に、移行フレームワークでスクリプトが1回以上呼び出されることがあります。このようなシナリオで複数回呼び出された場合、スクリプトから異なる終了値が戻されないことが予期されます。
- preScript(optional): string
移行可能なターゲットが実際にアクティブ化される前に実行する移行前スクリプトのパスを指定します。スクリプトはMIDDLEWARE_HOME/user_projects/domains/mydomain/bin/service_migrationディレクトリに配置する必要があります。
移行可能なターゲットをアクティブ化する前に、スクリプトが指定されていて、かつノード・マネージャが使用可能な場合は、スクリプトが実行されます。使用できるノード・マネージャがない状態でスクリプトを指定すると、移行時にエラーが生じます。
スクリプトが失敗するかみつからなかった場合は、現在のサーバーで移行は続行されなくなり、次の適当なサーバー上で移行が試行されます。候補サーバー・リスト内の次のサーバーか、候補サーバー・リストがない場合はクラスタ内の次のサーバーが使用されます。
- restartOnFailure(optional): boolean
デフォルト値: false
障害が発生したサービスが、移行されるかわりに、その場所で最初に非アクティブ化されて、再アクティブ化されるかどうかを指定します。
再起動の試行回数はgetNumberOfRestartAttemptsで制御されます。この回数のみ再起動の試行が行われると、サービスは移行されます。移行可能なターゲットを再起動すると、そのターゲットにあるすべてのサービスは順に非アクティブ化されてから、再アクティブ化されます。
- secondsBetweenRestarts(optional): integer(int32)
デフォルト値: 30
障害が発生したサービスの再起動を試行する間隔を秒数で指定します。
- strictOwnershipCheck(optional): boolean
デフォルト値: false
フェイルバックを行うTRSの現在のオーナーが見つからない場合、起動を続行するかどうか。この属性はクラスタ内のサーバーにとってのみ意味があります。
trueの場合、この状況においてサーバーの起動は失敗します。
falseの場合、サーバーはフェイルバックを試行しないで、起動を続行します。
- tags(optional): array Items
- type(optional): string
- userPreferredServer(optional): array Server Reference
タイトル: Server Reference
サーバー参照を含みます。
ユーザーがシングルトン・サービスをアクティブにするように優先的に定義したサーバーを戻します。
{
"type":"object",
"properties":{
"additionalMigrationAttempts":{
"default":2,
"type":"integer",
"format":"int32",
"description":"<p>A migratable service could fail to come up on every possible configured server. This attribute controls how many further attempts, after the service has failed on every server at least once, should be tried. Note that each attempt specified here indicates another full circuit of migrations amongst all the configured servers. So for a 3-server cluster, and a value of 2, a total of 4 additional migrations will be attempted. (the original server is never a valid destination)</p>"
},
"allCandidateServers":{
"title":"Server References",
"type":"array",
"items":{
"title":"Server Reference",
"type":"object",
"properties":{
"identity":{
"title":"Identity",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
}
},
"description":"Contains the server reference."
},
"description":"Contains the array of server references. <p>The list of servers that are candidates to host the migratable services deployed to this migratable target. If the constrainedCandidateServers list is empty, all servers in the cluster are returned. If the constrainedCandidateServers list is not empty, only those servers will be returned. The user-preferred server will be the first element in the list.</p>"
},
"cluster":{
"x-weblogic-restartRequired":true,
"title":"Cluster Reference",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"Contains the cluster reference. <p>Returns the cluster this singleton service is associated with.</p><p><h5>Constraints</h5></p><ul><li>restart required</li></ul>"
},
"constrainedCandidateServers":{
"x-weblogic-restartRequired":true,
"title":"Server References",
"type":"array",
"items":{
"title":"Server Reference",
"type":"object",
"properties":{
"identity":{
"title":"Identity",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
}
},
"description":"Contains the server reference."
},
"description":"Contains the array of server references. <p>The (user-restricted) list of servers that can host the migratable services deployed to this migratable target. The migratable service will not be allowed to migrate to a server that is not in the returned list of servers.</p><p>For example, this feature may be used to configure two servers that have access to a dual-ported ported disk. All servers in this list must be part of the cluster that is associated with the migratable target.</p><p><h5>Constraints</h5></p><ul><li>restart required</li></ul>"
},
"critical":{
"default":false,
"type":"boolean",
"description":"<p>Returns true if the MigratableTarget is critical to the overall health of the WLS Server</p>"
},
"dynamicallyCreated":{
"readOnly":true,
"default":false,
"type":"boolean",
"description":"<p>Return whether the MBean was created dynamically or is persisted to config.xml</p>"
},
"hostingServer":{
"readOnly":true,
"title":"Server Reference",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"Contains the server reference. <p>Returns the name of the server that currently hosts the singleton service.</p>"
},
"id":{
"readOnly":true,
"type":"integer",
"format":"int64",
"description":"<p>Return the unique id of this MBean instance</p>"
},
"migrationPolicy":{
"default":"manual",
"enum":[
"manual",
"failure-recovery",
"shutdown-recovery"
],
"type":"string",
"description":"<p>Defines the type of migration policy to use for the services hosted by this migratable target. Valid options are:</p><ul><li><p><code>Manual Service Migration Only</code> Indicates that no automatic migration of services hosted by this migratable target will occur.</p></li><li><p><code>Auto-Migrate Failure-Recovery Services</code> Indicates that the services hosted by this migratable target will only start if the migratable target's User Preferred Server (UPS) is started. If an administrator manually shuts down the UPS, either gracefully or forcibly, then a failure-recovery service will not migrate. However, if the UPS fails due to an internal error, then the service will be migrated to another candidate server. If such a candidate server is unavailable (due to either a manual shutdown or an internal failure), then the migration framework will first attempt to reactivate the service on its UPS server. If the UPS server is not available at that time, then the service will be migrated to another candidate server.</p></li><li><p><code>Auto-Migrate Shutdown-Recovery Services</code> Indicates that the services hosted by this migratable target will migrate to one of the candidate servers, if server is administratively shut down (either gracefully or forcibly). Once recovery is done, service is migrated back to failed server.</p></li></ul>"
},
"millisToSleepBetweenAttempts":{
"default":300000,
"type":"integer",
"format":"int32",
"description":"<p>Controls how long of a pause there should be between the migration attempts described in getAdditionalMigrationAttempts(). Note that this delay only happens when the service has failed to come up on every server. It does not cause any sort of delay between attempts to migrate otherwise.</p>"
},
"name":{
"readOnly":true,
"x-weblogic-legalNull":true,
"type":"string",
"description":"<p>The user-specified name of this MBean instance.</p><p>This name is included as one of the key properties in the MBean's <code>javax.management.ObjectName</code></p><p><code>Name=<i>user-specified-name</i></code></p><p><h5>Constraints</h5></p><ul><li>legal null</li></ul>"
},
"nonLocalPostAllowed":{
"default":false,
"type":"boolean",
"description":"<p>Specifies whether or not the post-deactivation script is allowed to run on a different machine.</p><p>Normally, when auto migration occurs, the post-deactivation script will be run on the service's current location, and the pre-activation script on the service's new location. If the current location is unreachable for some reason, this value will be checked to see if it is safe to run it on the service's new machine.</p><p>This is useful if the post-deactivation script controls access to a networked resource and does not need any data from the current machine.</p>"
},
"notes":{
"type":"string",
"description":"<p>Optional information that you can include to describe this configuration.</p><p>WebLogic Server saves this note in the domain's configuration file (<code>config.xml</code>) as XML PCDATA. All left angle brackets (<) are converted to the XML entity <code><</code>. Carriage returns/line feeds are preserved.</p><p>Note: If you create or edit a note from the Administration Console, the Administration Console does not preserve carriage returns/line feeds.</p>"
},
"numberOfRestartAttempts":{
"default":6,
"type":"integer",
"format":"int32",
"description":"<p>Specifies how many restart attempts to make before migrating the failed service.</p><p>Note that these are consecutive attempts. If the value is set to 6, and the service restart fails 5 times before succeeding, but then fails again later, it will not instantly migrate. Each failure gets its own count of restart attempts.</p><p>A value of 0 is identical to setting getRestartOnFailure to false. A value of -1 indicates the service should <i> never</i> be migrated; instead, it will be restarted until it either works or the server shuts down.</p>"
},
"postScript":{
"type":"string",
"description":"<p>Specifies the path to the post-migration script to run after a migratable target is fully deactivated. The script <i>must</i> be in the <code><i>MIDDLEWARE_HOME</i>/user_projects/domains/<i>mydomain</i>/bin/service_migration</code> directory.</p><p>After the migratable target is deactivated, if there is a script specified, <i>and</i> Node Manager is available, then the script will run. Specifying a script without an available Node Manager will result in an error upon migration.</p>"
},
"postScriptFailureFatal":{
"default":true,
"type":"boolean",
"description":"<p>Specifies whether or not a failure during execution of the post-deactivation script is fatal to the migration.</p><p>If it is fatal, the migratable target will <i>not</i> be automatically migrated until an administrator manually migrates it to a server, thus reactivating it.</p><p><b>Note:</b> Enabling this value will result in weakening the exactly-once guarantee. It is provided to prevent more dangerous data corruption if the post-deactivation script fails. Also if this value is enabled, then the script may be called more than once by the migration framework after the Migratable Target is deactivated or the server or machine hosting the Migratable Target crashed or is network partitioned. The script is expected not to return different exit values when invoked multiple times in such scenarios.</p>"
},
"preScript":{
"type":"string",
"description":"<p>Specifies the path to the pre-migration script to run before a migratable target is actually activated. The script <i>must</i> be in the <code><i>MIDDLEWARE_HOME</i>/user_projects/domains/<i>mydomain</i>/bin/service_migration</code> directory.</p><p>Before the migratable target is activated, if there is a script specified, <i>and</i> Node Manager is available, then the script will run. Specifying a script without an available Node Manager will result in an error upon migration.</p><p>If the script fails or cannot be found, migration will not proceed on the current server, and will be tried on the next suitable server. This could be the next server in the candidate server list, or in the cluster, if there is no candidate server list.</p>"
},
"restartOnFailure":{
"default":false,
"type":"boolean",
"description":"<p>Specifies whether or not a failed service will first be deactivated and reactivated in place, instead of being migrated.</p><p>The number of restart attempts is controlled by getNumberOfRestartAttempts. Once these restart attempts are exhausted, the service will migrate. A restarting migratable target will deactivate all services on it in order, then reactivate them all.</p>"
},
"secondsBetweenRestarts":{
"default":30,
"type":"integer",
"format":"int32",
"description":"<p>Specifies how many seconds to wait in between attempts to restart the failed service.</p>"
},
"strictOwnershipCheck":{
"default":false,
"type":"boolean",
"description":"<p>Whether continue to boot if cannot find the current owner of TRS to do failback. This attribute is only meaningful for servers in cluster. </p><p>If true: server will fail to boot under this situation.</p><p>If false: server will continue to boot without trying to do failback.</p>"
},
"tags":{
"title":"Items",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"<p>Return all tags on this Configuration MBean</p>"
},
"type":{
"readOnly":true,
"x-weblogic-unharvestable":true,
"type":"string",
"description":"<p>Returns the type of the MBean.</p><p><h5>Constraints</h5></p><ul><li>unharvestable</li></ul>"
},
"userPreferredServer":{
"title":"Server Reference",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"Contains the server reference. <p>Returns the server that the user prefers the singleton service to be active on.</p>"
}
},
"description":""
}
ネストされたスキーマ: Server References
タイプ: array
タイトル: Server References
サーバー参照の配列を含みます。
この移行可能なターゲットにデプロイされる移行可能サービスをホストする候補サーバーのリスト。constrainedCandidateServersリストが空の場合、クラスタ内のすべてのサーバーが戻されます。constrainedCandidateServersリストが空でない場合、指定されているサーバーのみが戻されます。ユーザーが優先するサーバーがリスト内の最初の要素となります。
{
"title":"Server References",
"type":"array",
"items":{
"title":"Server Reference",
"type":"object",
"properties":{
"identity":{
"title":"Identity",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
}
},
"description":"Contains the server reference."
},
"description":"Contains the array of server references. <p>The list of servers that are candidates to host the migratable services deployed to this migratable target. If the constrainedCandidateServers list is empty, all servers in the cluster are returned. If the constrainedCandidateServers list is not empty, only those servers will be returned. The user-preferred server will be the first element in the list.</p>"
}
ネストされたスキーマ: Cluster Reference
タイプ: array
タイトル: Cluster Reference
クラスタ参照を含みます。
このシングルトン・サービスが関連付けられているクラスタを戻します。
制約
{
"x-weblogic-restartRequired":true,
"title":"Cluster Reference",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"Contains the cluster reference. <p>Returns the cluster this singleton service is associated with.</p><p><h5>Constraints</h5></p><ul><li>restart required</li></ul>"
}
ネストされたスキーマ: Server References
タイプ: array
タイトル: Server References
サーバー参照の配列を含みます。
この移行可能なターゲットにデプロイされる移行可能サービスをホストできるサーバーの(ユーザーが制限した)リスト。返されたサーバーのリストに含まれていないサーバーに、移行可能なサービスを移行することはできません。
たとえば、この機能を使用して、デュアルポート・ディスクにアクセスできる2つのサーバーを構成できます。このリスト内のすべてのサーバーは、移行可能なターゲットに関連付けられているクラスタの一部である必要があります。
制約
{
"x-weblogic-restartRequired":true,
"title":"Server References",
"type":"array",
"items":{
"title":"Server Reference",
"type":"object",
"properties":{
"identity":{
"title":"Identity",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
}
},
"description":"Contains the server reference."
},
"description":"Contains the array of server references. <p>The (user-restricted) list of servers that can host the migratable services deployed to this migratable target. The migratable service will not be allowed to migrate to a server that is not in the returned list of servers.</p><p>For example, this feature may be used to configure two servers that have access to a dual-ported ported disk. All servers in this list must be part of the cluster that is associated with the migratable target.</p><p><h5>Constraints</h5></p><ul><li>restart required</li></ul>"
}
ネストされたスキーマ: Server Reference
タイプ: array
タイトル: Server Reference
読取り専用: true
サーバー参照を含みます。
シングルトン・サービスを現在ホストしているサーバーの名前を戻します。
{
"readOnly":true,
"title":"Server Reference",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"Contains the server reference. <p>Returns the name of the server that currently hosts the singleton service.</p>"
}
ネストされたスキーマ: Server Reference
タイプ: array
タイトル: Server Reference
サーバー参照を含みます。
ユーザーがシングルトン・サービスをアクティブにするように優先的に定義したサーバーを戻します。
{
"title":"Server Reference",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"Contains the server reference. <p>Returns the server that the user prefers the singleton service to be active on.</p>"
}
ネストされたスキーマ: Server Reference
タイプ: object
タイトル: Server Reference
サーバー参照を含みます。
ソースを表示
{
"title":"Server Reference",
"type":"object",
"properties":{
"identity":{
"title":"Identity",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
}
},
"description":"Contains the server reference."
}
ネストされたスキーマ: Identity
タイプ: array
タイトル: Identity
DOC TEAM TBD - アイデンティティの説明 - 別のWLS RESTリソースへの参照です。
ソースを表示
{
"title":"Identity",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
}
ネストされたスキーマ: Server Reference
タイプ: object
タイトル: Server Reference
サーバー参照を含みます。
ソースを表示
{
"title":"Server Reference",
"type":"object",
"properties":{
"identity":{
"title":"Identity",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
}
},
"description":"Contains the server reference."
}
ネストされたスキーマ: Identity
タイプ: array
タイトル: Identity
DOC TEAM TBD - アイデンティティの説明 - 別のWLS RESTリソースへの参照です。
ソースを表示
{
"title":"Identity",
"type":"array",
"items":{
"type":"string",
"description":""
},
"description":"DOC TEAM TBD - describe an identity - it's a reference to another WLS REST resource."
}