5.9. フェイルオーバとフェイルバック

PostgreSQLバックエンドノードが切り離される時に実行するユーザコマンドを指定します。 Pgpool-IIはコマンド実行の前に、以下の特殊文字をバックエンドの具体的な情報に置き換えます。

failover_commandの完全な例が項8.2にあります。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

PostgreSQLバックエンドノードがPgpool-IIに復帰された時に実行するユーザコマンドを指定します。 Pgpool-IIはコマンド実行の前に、以下の特殊文字をバックエンドの具体的な情報に置き換えます。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

プライマリノードのフェイルオーバー後に実行するユーザコマンドを指定します。 スタンバイがフェイルオーバーした際にはこのコマンドは実行されません。 このコマンドは、pcp_promote_nodeコマンドによってノードを昇格する要求があった場合にも起動されます。 この機能は、ストリーミングレプリケーションモードでのみ有効です。

このコマンドは、フェイルオーバが完了した後に Pgpool-II によりフォークされた子プロセス内で実行されるので、 follow_primary_command の実行はPgpool-IIのサービスを妨げることはありません。 以下で、このコマンドがどのように実行されるのかを疑似コードで説明します。

for each backend node
{
    if (the node is not the new primary)
        set down node status to shared memory status
        memorize that follow primary command is needed to execute
}
if (we need to executed follow primary command)
{
    fork a child process
    (within the child process)

    for each backend node
    {
        if (the node status in shared memory is down)
            execute follow primary command
    }
}
      

Pgpool-IIはコマンド実行の前に、以下の特殊文字をバックエンドの具体的な情報に置き換えます。

通常は、follow_primary_commandコマンドはpcp_recovery_nodeコマンドを呼んで新しいプライマリからスタンバイをリカバリするために使用します。 follow_primary_command中では、pg_ctlを使ってターゲットのPostgreSQLノードが動いているかどうかを確認することをお勧めします。 たとえば、そのノードはハードウェア障害で停止しているかも知れませんし、管理者が保守のために停止しているのかも知れません。 ノードが停止している場合は、そのノードをスキップしてください。 ノードが動いている場合は、まずそのノードを停止してからリカバリしてください。 pcp_recovery_nodeコマンドを呼ばずに、直接pg_basebackupなどを呼び出してリカバリすることも可能ですが、その場合は、リカバリ後にpcp_attach_nodeを呼び出して、スタンバイサーバが利用可能になったことをPgpool-IIに通知してください。 そうでないとそのスタンバイサーバはダウン状態のままになってしまいます。 (pcp_recovery_nodeコマンドは内部でpcp_attach_nodeを呼び出しているので、リカバリ後にスクリプトの中でpcp_attach_nodeを呼び出す必要はありません。) follow_primary_commandの完全な例は、項8.2にあります。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

onに設定した場合、Pgpool-IIは確立したクライアントとバックエンドのセッション上で特定のエラーコード：57P01と57P02をチェックすることにより、バックエンドのシャットダウンイベントを検出します。 それらのエラーコードを検出すると、そのノードでフェイルオーバが起動されます。 offに設定した場合、そのようなエラーの場合でもPgpool-IIは単にエラーをレポートしセッションが切断するのみです。

なお、ストリーミングレプリケーションモードでは、シャットダウン処理が行われたPostgreSQLがスタンバイノードで、かつロードバランスノードでない場合は、このパラメータがonでもフェイルオーバしません。 現在のセッションでどのノードがロードバランスなのかは、SHOW POOL_NODESで確認できます。

デフォルトはoffです。

クライアントが接続されていなければ、このパラメータがonでもPgpool-IIはシャットダウンを検出しません。

57P01はシャットダウンだけでなく、現在接続中のバックエンドがpg_terminate_backendあるいはSIGTERMシグナルによって終了させられた場合にも送られてくることに注意してください。 これは望まないフェイルオーバを引き起こすので困りものです。 これを防ぐには、このパラメータをoffにしてください。

このパラメータはPgpool-II 4.3以降で利用可能です。 4.2以前では、このパラメータが常にonであるのと同じ動作をします。 このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

onに設定した場合、Pgpool-IIはPostgreSQLバックエンド接続からの読み出し、書き込みのエラーをバックエンドノードの故障と見なし、現在のセッションを切断した後にそのノードをフェイルオーバします。 offに設定した場合、そのようなエラーの場合でもPgpool-IIは単にエラーをレポートしセッションが切断するのみです。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

フェイルオーバが起きた時にプライマリノードを検索するための最大時間を秒単位で指定します。 Pgpool-IIは、ここで設定した時間の間にプライマリノードを見つけられなかった場合、探すのを諦めます。 デフォルト値は300です。 0を指定すると、永久に検索し続けます。

このパラメータはストリーミングレプリケーションモードの場合のみ有効です。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

onにすると、不正なプライマリを切り離します。 デフォルトはoffです。 このパラメータは、ストリーミングレプリケーションモードでかつ、PostgreSQL 9.6以降を使っている場合にのみ有効です。 というのも、pg_stat_wal_receiverを使っているからです。 PostgreSQL 9.5以前を使っている場合は、エラーは報告されず、単にこの設定は無視されます。

プライマリノードが存在しない場合は、検査を実施しません。

スタンバイノードが存在せず、プライマリノードがひとつだけ存在する場合は検査を実施しません。

スタンバイノードが存在せず、プライマリノードが複数存在する場合は、もっとも若いノード番号を持つプライマリノードだけを残し、それ以外は切り離します。

もし複数のプライマリと一つ以上のスタンバイがある場合は、PostgreSQL 9.6以降であれば、プライマリとスタンバイノードの間の接続性をpg_stat_wal_receiverで検証します。 もしあるプライマリがすべてのスタンバイに接続している場合は、そのプライマリは「正しい」と見なされ、それ以外のプライマリは「不正」と見なされ、detach_false_primaryがonなら不正なプライマリは切り離されます。 もし、正しいプライマリが見つからない場合は、何も起きません。

Pgpool-IIが起動した時、不正なプライマリのチェックはPgpool-IIのメインプロセスの中で一度だけ行われます。 もしsr_check_periodが0より大きければ、不正なプライマリのチェックは、ストリーミングレプリケーションの遅延チェックと同じタイミングで行われます。

このパラメータは、ストリーミングレプリケーションモードの時だけに適用されます。

このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

onに設定した場合、ストリーミングレプリケーションが正常に動作しており、かつバックエンドノードのステータスがダウンのとき、スタンバイノードを自動で復帰させることができます。 これは、一時的なネットワーク障害などによりスタンバイノードが認識できず縮退が行われた場合などに役立ちます。

この機能を使用するためには、streaming replication check (項5.11参照)が有効であり、バックエンドノードとしてPostgreSQLが9.1以降である必要があります。 この機能は、プライマリノードでpg_stat_replicationを実行します。自動フェイルバックはスタンバイノードに対してのみ実行されます。 failback_commandが空でなければ、failback_commandも実行されることに注意してください。 メンテナンスなどで、一時的にスタンバイノードを切り離す場合は、このパラメータをOFFにしてから実施してください。 意図せずスタンバイノードが復帰してしまう可能性があります。

デフォルトはoffです。 このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。

自動フェイルバックの実行間隔の最小時間を秒単位で指定します。 次の自動フェイルバックは前回の自動フェイルバックから指定した時間経過するまで実行されません。 ネットワークのエラーなどによりPgpool-IIが頻繁にバックエンドのDOWNを検出するような場合、大きい値を設定することでフェイルバックとフェイルオーバが繰り返される事を防ぐことができます。 デフォルトは60です。 0を指定すると自動フェイルバックは待ちません。 このパラメータはPgpool-IIの設定を再読み込みすることで変更可能です。