Cluster Server 8.0.2 付属エージェントリファレンスガイド - Solaris

Online

指定したユーザー環境において、StartProgram 属性で指定したパラメータで実行可能ファイルを実行します。

リソースをオンラインにするため、エージェント関数は次のコマンドを実行します。

su [-] user -c executable_to_online_resource

DelayAfterOnline 属性が設定されている場合、監視機能は、オンライン機能の完了後、DelayAfterOnline 属性で指定された秒数が経過してから呼び出されます。

Offline

指定したユーザー環境において、StopProgram 属性で指定したパラメータで実行可能ファイルを実行します。

リソースをオフラインにするため、エージェント関数は次のコマンドを実行します。

su [-] user -c executable_to_offline_resource

DelayAfterOffline 属性が設定されている場合、監視機能は、オフライン機能の完了後、DelayAfterOffline 属性で指定された秒数が経過してから呼び出されます。

Monitor

MonitorProgram、PidFiles、または MonitorProcesses 属性を組み合わせて使用し、アプリケーションを監視することができます。

この関数は、PidFiles または MonitorProcesses のいずれかで指定されている 1 つ以上のプロセスが実行されていないと判断すると、OFFLINE を返します。プロセスが正常でない状態で終了している場合は、monitor は OFFLINE を返し、フェールオーバーが発生します。

リソースを監視するため、エージェント関数は次のコマンドを実行します。

su [-] user -c executable_to_monitor_resource

imf_init

AMF（Asynchronous Monitoring Framework）カーネルドライバと連動するようにエージェントを初期化します。この機能は、エージェントが起動すると実行されます。

imf_getnotification

リソースの状態の変更についての通知を取得します。この機能は、AMF カーネルドライバと連動するようにエージェントが初期化された後に実行されます。エージェントは継続的に通知を待機し、通知後にリソースでアクションを実行します。

imf_register

エージェントで監視する必要があるリソースエンティティを AMF カーネルドライバに登録します。たとえば、この関数はプロセスのオンライン監視のための PID を登録します。この機能は、リソースが安定した状態（オンラインまたはオフライン）に入った後に、リソースごとに実行されます。Application エージェントは PidFiles 属性と MonitorProcesses 属性で設定されたプロセスに対して IMF を使います。

Clean

PidFiles または MonitorProcesses で指定した処理を終了します。 User 属性で指定されたユーザー ID で実行中のプロセス（MonitorProcesses 属性で指定）のみが強制終了（kill）されます。 CleanProgram が定義されている場合、エージェントは、プロセスを強制終了するために、CleanProgram を実行します。

リソースを強制的に停止するため、エージェント関数は次のコマンドを実行します。

su [-] user -c executable_to_clean_resource

エージェントが su - オプションを使うのは、UseSUDash 属性が有効 (1) になっている場合のみであることに注意してください。UseSUDash 属性はデフォルトでは無効（0）になっています。

Action

action エントリポイントの各種の機能には次のものがあります。