Red Hat Summit第34章 リソースエージェント OCF 戻りコードの解釈
Pacemaker リソースエージェントは Open Cluster Framework (OCF) Resource Agent API に準拠します。以下の表で、OCF 戻りコードと、Pacemaker がどのように解釈するかを説明します。
エージェントがコードを返したときに、クラスターがまず行うことは、期待されている結果通りにコードを返しているかどうかを確認します。そして、結果が期待されている値に一致しない場合、その操作が失敗したものとみなされ、復元操作が開始されます。
起動するには、起動した操作の結果の呼び出し元を通知する、定義した戻りコードでリソースエージェントを終了する必要があります。
以下の表で説明するように、障害回復には 3 つのタイプがあります。
| タイプ | 説明 | クラスターが行った操作 |
|---|---|---|
| 軽度 | 一時的なエラーが発生しました。 | リソースを再起動するか、新しい場所に移します。 |
| 重度 | 現在のノードに固有である可能性のある一時的ではないエラーが発生しました。 | リソースを別の場所に移動し、現在のノードで再試行されないようにします。 |
| 致命的 | すべてのクラスターノードに共有となる一時的でないエラーが発生しました (例: 指定された設定がよくありません)。 | リソースを停止し、いかなるクラスターノードでも起動されないようにします。 |
次の表は、OCF 戻りコードと、失敗コードを受信したときにクラスターが開始するリカバリーのタイプを示しています。0 を返すアクション (OCF エイリアス OCF_SUCCESS) であっても、0 が予期された戻り値ではなかった場合には、失敗したと見なされる可能性があることに注意してください。
| 戻りコード | OCF ラベル | 説明 |
|---|---|---|
| 0 |
| * 操作が無事に完了しました。これは、起動、停止、昇格、降格コマンドに対して想定される戻りコードです。 * 予期しない場合のタイプ: ソフト |
| 1 |
| * この操作は、一般的なエラーを返しました。 * タイプ: ソフト * リソースマネージャーは、リソースの復元と、新しい場所への移動を試行します。 |
| 2 |
| * このマシンのリソースの設定が正しくありません。たとえば、ノードで見つからない場所を参照しています。 * タイプ: 重度 * リソースマネージャーがリソースを別の場所に移動し、現在のノードで再試行されないようにします。 |
| 3 |
| * 要求された操作が実装されていません。 * タイプ: 重度 |
| 4 |
| * このリソースエージェントには、このタスクを完了するのに十分な特権がありません。これは、エージェントが特定のファイルを開けない場合や、特定のソケットでリッスンできない場合、ディレクトへの書き込みを行えない場合が考えられます。 * タイプ: 重度 * 特に設定されていない限り、リソースマネージャーは、別のノード (パーミッションが存在しない) でリソースを再起動することで、このエラーで失敗したリソースの復旧を試行します。 |
| 5 |
| * 操作が実行されたノードに、必要なコンポーネントが欠如しています。これは、必要なバイナリーが実行不可であるか、重要な設定ファイルが読み込み不可になっていることが原因の場合があります。 * タイプ: 重度 * 特に設定されていない限り、リソースマネージャーは、別のノード (必要なファイルまたはバイナリーが存在しない) でリソースを再起動することで、このエラーで失敗したリソースの復旧を試行します。 |
| 6 |
| * ローカルノード上のリソースの設定が正しくありません。 * タイプ: 致命的 * このコードがかえされると、Pacemaker は、サービス設定がその他のノードで正しくても、クラスター内のノードでリソースが実行されないようにします。 |
| 7 |
| * このリソースは安全に停止します。これは、リソースが正常にシャットダウンされたか、起動されていないことを意味します。 * 予期しない場合のタイプ: ソフト * クラスターは、いかなる操作に対しても、これを返すリソースの停止を試行しません。 |
| 8 |
| * リソースは昇格されたロールで実行されています。 * 予期しない場合のタイプ: ソフト |
| 9 |
| * リソースは昇格されたロールにある (またはその可能性がある) が、失敗しています。 * タイプ: ソフト * リソースは降格され、停止して再起動されます (昇格される可能性があります)。 |
| 190 | * サービスが適切にアクティブな状態であることが確認されましたが、今後障害が発生することが予想される状況です。 | |
| 191 | * リソースエージェントがロールをサポートし、サービスが昇格されたロールで適切にアクティブな状態であることが確認されましたが、今後障害が発生することが予想される状況です。 | |
| その他 | 該当なし | カスタムエラーコード |
