管理コンソール・オンライン・ヘルプ

前 次 新規ウィンドウで目次を開く
ここから内容の開始

移行可能なターゲット

列の表示     関連タスク     関連トピック

このページでは、表の列の表示のカスタマイズ、新しい移行可能なターゲットの作成、および移行可能なターゲットの削除を行います。移行可能なターゲットとは、一度にクラスタ内の1つのサーバーでのみアクティブになり、移行可能な固定サービスをホストすることができるサーバーを制御するターゲットです。移行可能なサービスには、JMSサーバー、SAFエージェント、パス・サービス、カスタム永続ストアがあります。移行可能なターゲットは、手動で移行することも、自動移行されるように構成することもできます。

列の表示

この表のカスタマイズ」を展開して「列の表示」リストを変更すると、このページに表示されるデータ・ポイントを減らしたり増やしたりできます。それぞれのデータ・ポイントは各自の表列に表示されます。

次の表に、このページの列に表示できるすべてのデータ・ポイントを記載します。

名前 説明
名前

移行可能なターゲットを作成したときに指定した名前。

クラスタ

このシングルトン・サービスが関連付けられているクラスタを戻します。

MBean属性:
MigratableTargetMBean.Cluster

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

ユーザーの優先サーバー

ユーザーがシングルトン・サービスをアクティブにするように優先的に定義したサーバーを戻します。

MBean属性:
MigratableTargetMBean.UserPreferredServer

候補サーバー

この移行可能なターゲットにデプロイされる移行可能サービスをホストする候補サーバーのリスト。constrainedCandidateServersリストが空の場合、クラスタ内のすべてのサーバーが戻されます。constrainedCandidateServersリストが空でない場合、指定されているサーバーのみが戻されます。ユーザーが優先するサーバーがリスト内の最初の要素となります。

MBean属性:
MigratableTargetMBean.AllCandidateServers

移行ポリシー

この移行可能なターゲットでホストされるサービスに対して使用する移行ポリシーのタイプを定義します。有効なオプションは次のとおりです:

  • サービスの手動での移行のみ

    この移行可能なターゲットでホストされるサービスの自動移行は行われないことを示します。

  • Auto-Migrate Exactly-Once Services

    候補サーバーのリストにある管理ターゲット・サーバーが1つ以上動作しているかどうかを示します。この移行可能ターゲットでホストされるサービスは、サーバーが失敗するか管理者によって(正常または強制的に)シャットダウンされた場合に、クラスタ内のいずれかの場所でアクティブ化されます。たとえば、推奨のベストプラクティスは、移行可能ターゲットにパス・サービスがホストされている場合にこのポリシーを使用することです。そのようにすると、対応する優先サーバーが失敗したりシャットダウンされたりした場合に、パス・サービスが自動的に別の候補サーバーに移行し、クラスタ内で常にアクティブな状態となります。

    ノート:
    この値を指定すると、ターゲットが1つのサーバー・メンバーにグループ化される場合があります。たとえば、必ず1回の指定された移行可能ターゲットが5つあり、クラスタ内で管理ターゲット・サーバーが1つのみ起動されている場合、5つのターゲットすべてがそのサーバー上でアクティブ化されます。
    このポリシーはJTAサービスの移行には適用されません。

  • Auto-Migrate Failure-Recovery Services

    この移行可能ターゲットのユーザー優先サーバー(User Preferred Server: UPS)が起動している場合にのみ、移行可能ターゲットでホストされているサービスが起動することを示します。管理者が手動でUPSを正常または強制的にシャットダウンした場合、障害回復サービスは移行しません。ただし、内部エラーによってUPSが失敗した場合、サービスは別の候補サーバーに移行されます。そのような候補サーバーが(手動シャットダウンまたは内部障害のために)使用できない状態の場合、移行フレームワークではまずサービスをそのUPSサーバー上で再アクティブ化しようとします。その時点でUPSサーバーが利用できない場合、そのサービスは別の候補サーバーに移行されます。

  • Auto-Migrate Shutdown-Recovery Services

    サーバーが管理上(正常にまたは強制的に)停止された場合に、この移行可能ターゲットでホストされているサービスが候補サーバーのいずれかに移行されることを示します。リカバリが実行されると、サービスは障害が発生したサーバーに戻されます。

MBean属性:
MigratableTargetMBean.MigrationPolicy

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

移行前スクリプトのパス

移行可能なターゲットが実際にアクティブ化される前に実行する移行前スクリプトのパスを指定します。スクリプトはMIDDLEWARE_HOME/user_projects/domains/mydomain/bin/service_migrationディレクトリに配置する必要があります

移行可能なターゲットをアクティブ化する前に、スクリプトが指定されていて、かつノード・マネージャが使用可能な場合は、スクリプトが実行されます。使用できるノード・マネージャがない状態でスクリプトを指定すると、移行時にエラーが生じます。

スクリプトが失敗するかみつからなかった場合は、現在のサーバーで移行は続行されなくなり、次の適当なサーバー上で移行が試行されます。候補サーバー・リスト内の次のサーバーか、候補サーバー・リストがない場合はクラスタ内の次のサーバーが使用されます。

MBean属性:
MigratableTargetMBean.PreScript

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

移行後スクリプトのパス

移行可能なターゲットが完全に非アクティブ化された後で実行する移行後スクリプトのパスを指定します。スクリプトはMIDDLEWARE_HOME/user_projects/domains/mydomain/bin/service_migrationディレクトリに配置する必要があります

移行可能なターゲットを非アクティブ化した後、スクリプトが指定されていて、かつノード・マネージャが使用可能な場合は、スクリプトが実行されます。使用できるノード・マネージャがない状態でスクリプトを指定すると、移行時にエラーが生じます。

MBean属性:
MigratableTargetMBean.PostScript

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

移行後スクリプトの致命的な失敗

非アクティブ化後スクリプトの実行中の障害が移行にとって致命的かどうかを指定します。

致命的な場合は、管理者がそのターゲットをサーバーに手動で移行して非アクティブ化するまで、移行可能なターゲットは自動的に移行されません。

ノート:この値を有効にすると、「必ず1回」の保証が弱くなります。この機能は、非アクティブ化後スクリプトが失敗した場合に、より危険なデータの破損を防ぐために提供されています。また、この値が有効な場合、移行可能ターゲットが非アクティブ化された後や、移行可能ターゲットをホストするサーバーまたはマシンがクラッシュあるいはネットワークから分離した後に、移行フレームワークでスクリプトが1回以上呼び出されることがあります。このようなシナリオで複数回呼び出された場合、スクリプトから異なる終了値が戻されないことが予期されます。

MBean属性:
MigratableTargetMBean.PostScriptFailureFatal

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

ローカル以外の移行後スクリプトを許可

別のマシン上で非アクティブ化後スクリプトの実行を許可するかどうかを指定します。

通常、移行が行われるとき、サービスの現在の場所で非アクティブ化後スクリプトが実行され、サービスの新しい場所でアクティブ化前スクリプトが実行されます。現在の場所がなんらかの理由でアクセスできない場合、サービスの新しいマシン上でスクリプトを実行しても安全かどうかを確認するために、この値がチェックされます。

非アクティブ化後スクリプトがネットワーク・リソースへのアクセスを制御しており、現在のマシンからのデータを必要としない場合に、この機能は便利です。

MBean属性:
MigratableTargetMBean.NonLocalPostAllowed

変更は、モジュールの再デプロイ後またはサーバーの再起動後に有効になります。

失敗した場合に再起動する

障害が発生したサービスが、移行されるかわりに、その場所で最初に非アクティブ化されて、再アクティブ化されるかどうかを指定します。

再起動の試行回数はNumberOfRestartAttemptsで制御されます。この回数のみ再起動の試行が行われると、サービスは移行されます。移行可能なターゲットを再起動すると、そのターゲットにあるすべてのサービスは順に非アクティブ化されてから、再アクティブ化されます。

MBean属性:
MigratableTargetMBean.RestartOnFailure

再起動間隔

障害が発生したサービスの再起動を試行する間隔を秒数で指定します。

MBean属性:
MigratableTargetMBean.SecondsBetweenRestarts

再起動回数

障害が発生したサービスを移行する前に、再起動を試行する回数を指定します。

この試行は連続的に行われます。値を6に設定した場合、サービスの再起動が5回失敗してから成功し、その後で再び失敗しても、サービスはすぐに移行されません。成功の前後で、再起動の試行回数がそれぞれカウントされます。

0の値はRestartOnFailureをfalseに設定する場合と同じになります。-1の値は、サービスが移行されず、かわりに、サービスが機能するか、サーバーが停止されるまで、サービスが再起動されることを示します。

MBean属性:
MigratableTargetMBean.NumberOfRestartAttempts

関連タスク

関連トピック


先頭に戻る