Cluster Server 7.3.1 エージェント開発者ガイド - AIX、Linux、Solaris、Windows
- 概要
- エージェントのエントリポイントの概要
- エージェントのエントリポイントについて
- エージェントエントリポイントの説明
- action エントリポイントについて
- info エントリポイントについて
- C++ またはスクリプトエントリポイントの使用上の注意事項
- エージェント情報ファイルについて
- ArgList 属性と ArgListValues 属性について
- C++ でのエントリポイントの作成
- C++ でのエントリポイントの作成について
- C++ のエントリポイントの構文
- エージェントフレームワークの基本関数
- コンテナサポートのためのエージェントフレームワーク基本関数
- スクリプトでのエントリポイントの作成
- スクリプトでのエントリポイントの作成について
- スクリプトエントリポイントの構文
- エージェントフレームワークの基本関数
- VCSAG_GET_ATTR_VALUE
- コンテナをサポートするエージェントフレームワーク基本関数
- スクリプトのエントリポイントの例
- エージェントメッセージのログ
- カスタムエージェントの作成
- スクリプトベースの IMF 対応カスタムエージェントの作成
- エージェントのテスト
- 静的タイプ属性
- 静的属性について
- 静的タイプ属性の定義
- AdvDbg
- ArgList
- 状態の遷移図
- 国際化されたメッセージ
- First Failure Data Capture(FFDC)を使用した VCS リソースの予期しない動作のトラブルシューティング
- 付録 A. 5.0 より前の VCS エージェントの使用
clean エントリポイントについて
clean エントリポイントは、リソースに関連するすべての実行中のタスクを終了させる必要があり、(場合によっては強制的に)リソースをオフライン化する必要があるときに、エージェントフレームワークによって呼び出されます。このエントリポイントは、リソース名、エントリポイントの実行理由を示すコード、および ArgList 属性値を入力値として受け取ります。操作が正常終了した場合は 0 を返し、失敗した場合は 1 を返します。
このエントリポイントが実行される理由は、次の enum 型に従ってエンコードされます。
enum VCSAgWhyClean { VCSAgCleanOfflineHung, VCSAgCleanOfflineIneffective, VCSAgCleanOnlineHung, VCSAgCleanOnlineIneffective, VCSAgCleanUnexpectedOffline, VCSAgCleanMonitorHung };
スクリプトベースの Clean エントリポイントの場合、Clean の理由は整数として渡されます。
0 => offline hung 1 => offline ineffective 2 => online hung 3 => online ineffective 4 => unexpected offline 5 => monitor hung
これらは enum 型であるため、エントリポイントが C++ で記述されているか、スクリプトベースであるかに関係なく、同じ整数値が渡されます。
VCSAgCleanOfflineHung
offline エントリポイントが、期待時間内に完了しませんでした。
OfflineTimeoutを参照してください。
VCSAgCleanOfflineIneffective
offline エントリポイントが無効でした。 offline エントリポイントの呼び出し後に呼び出すようにスケジュール設定された monitor エントリポイントが、OFFLINE 以外の戻り値を返しました。
VCSAgCleanOnlineHung
online エントリポイントが、期待時間内に完了しませんでした。
( OnlineTimeoutを参照してください。)
VCSAgCleanOnlineIneffective
online エントリポイントが無効でした。 online エントリポイントの呼び出し後に呼び出すようスケジュール設定された monitor エントリポイントが、ONLINE 以外の戻り値を返しました。
VCSAgCleanUnexpectedOffline
リソースが不意にオフライン化されたため、このリソースに障害が発生したと判断しました。
( ToleranceLimitを参照してください。)
VCSAgCleanMonitorHung
monitor エントリポイントの実行が、繰り返し期待時間内に完了することができなかったため、オンラインリソースに障害が発生したと判断しました。
(FaultOnMonitorTimeoutsを参照してください。)
エージェントは、clean エントリポイントが実装されている場合に、次のタスクをサポートします。
リソースに障害が発生したときに、ローカルシステム上でリソースを自動的に再起動します
RestartLimitを参照してください。
リソースをオンライン化する試みが失敗したときに、online エントリポイントを自動的に再試行します
OnlineRetryLimitを参照してください。
リソースがローカルシステム上で失敗したときに、エンジンが他のシステム上でそのリソースをオンライン化できるようにします。
これらのアクションの実行には、clean エントリポイントが正常に実行されること、つまり終了コード 0 を返すことが必要です。