Using the efm utility

フェールオーバーマネージャーは、クラスター管理を支援するefm ユーティリティを提供します。 RPMインストーラーは、Failover Managerのインストール時に、ユーティリティを/usr/edb/efm-4.<x>/bin ディレクトリに追加します。

efm allow-node

efm allow-node <cluster_name>

efm allow-node コマンドを呼び出して、指定されたノードがクラスターに参加できるようにします。コマンドを呼び出すときに、クラスターの名前と参加ノードのIPアドレスを指定します。

このコマンドは、efm、efmグループのメンバー、またはルートによって呼び出される必要があります。

efm disallow-node

efm disallow-node <cluster_name> <address>

efm disallow-node コマンドを呼び出して、指定されたノードを許可ホストリストから削除し、ノードがクラスターに参加しないようにします。 efm disallow-node コマンドを呼び出すときに、クラスターの名前とノードのアドレスを指定します。このコマンドは、efm、efmグループのメンバー、またはルートによって呼び出される必要があります。

efm cluster-status

efm cluster-status <cluster_name>

efm cluster-status コマンドを呼び出して、フェールオーバーマネージャークラスターのステータスを表示します。ステータスレポートの詳細については、

Monitoring a Failover Manager cluster を参照してください。

efm cluster-status-json

efm cluster-status-json <cluster_name>

efm cluster-status-json コマンドを呼び出して、フェールオーバーマネージャークラスターのステータスをJSON形式で表示します。 efm cluster-status コマンドで生成される表示とは、表示される情報の形式は異なりますが、情報源は同じです。

次の例は、3つのノードを持つ正常なクラスターのステータスをクエリすることによって生成されます。

{
    "nodes": {
        "172.16.144.176": {
            "type": "Witness",
            "db": "N\/A",
            "vip": "",
            "vip_active": false
        },
        "172.16.144.177": {
            "type": "Primary",
            "db": "UP",
            "vip": "",
            "vip_active  :   false"
            "xlogReceive :   0/14001478"
            "xlog    :   0/14001478"
            "xloginfo    :"
        },
        "172.16.144.180": {
            "type": "Standby",
            "db": "UP",
            "vip": "",
            "vip_active  :   false"
            "xlogReceive :   0/14001478"
            "xlog    :   0/14001478"
            "xloginfo    :"
        }
    },
    "allowednodes": [
        "172.16.144.177",
        "172.16.144.160",
        "172.16.144.180",
        "172.16.144.176"
    ],
    "membershipcoordinator": "172.16.144.177",
    "failoverpriority": [
        "172.16.144.180"
    ],
    "minimumstandbys": 0,
    "missingnodes": [],
    "messages": []
}

efm encrypt

efm encrypt <cluster_name> [--from-env]

クラスタープロパティファイルにパスワードを含める前に、 efm encrypt コマンドを呼び出してデータベースパスワードを暗号化します。 --from-env オプションを含めて、 EFMPASS 環境変数で指定された値を使用し、ユーザー入力なしで実行するようにフェールオーバーマネージャーに指示します。詳細については、

Encrypting your database password を参照してください。

efmプロモート

efm promote cluster_name [-switchover [-sourcenode <address>][-quiet][-noscripts]

efm promote コマンドは、スタンバイからプライマリへの手動フェールオーバーを実行するようにフェールオーバーマネージャーに指示します。

データベースクラスターのメンテナンスウィンドウ中に、クラスター内のすべてのスタンバイがプライマリと最新の状態であることがstatusコマンドによって報告された場合にのみ、手動昇格を試みます。

–switchover 句を含めて、スタンバイノードを昇格させ、プライマリノードをスタンバイノードとして再構成します。 -sourcenode キーワードを含め、ノードアドレスを指定して、リカバリ設定を古いプライマリノードにコピーしてスタンバイにするノードを指定します。スイッチオーバープロセス中の通知を抑制するには、 -quiet キーワードを含めます。 -noscripts キーワードを含めて、フェンシングまたはポストプロモーションスクリプトを呼び出さないようにフェールオーバーマネージャーに指示します。

このコマンドは、efm、efmグループのメンバー、またはルートによって呼び出される必要があります。

注釈

このコマンドは、クラスタープロパティファイルの`auto.failover` パラメーターで指定された値を無視するようにサービスに指示します。

efm履歴書

efm resume <cluster_name>

efm resume コマンドを呼び出して、以前に停止したデータベースの監視を再開します。このコマンドは、efm、efmグループのメンバー、またはルートによって呼び出される必要があります。

efm set-priority

efm set-priority <cluster_name> <address> <priority>

efm set-priority コマンドを呼び出して、フェイルオーバー優先度をスタンバイノードに割り当てます。この値は、フェールオーバーが発生した場合にノードを使用する順序を指定します。このコマンドは、efm、efmグループのメンバー、またはルートによって呼び出される必要があります。

priorityオプションを使用して、優先順位リスト内のノードの場所を指定します。たとえば、 1 の値を指定して、ノードがプライマリスタンバイであり、フェールオーバーが発生した場合に昇格する最初のノードになることを示します。 0 の優先順位値は、フェールオーバーマネージャーにスタンバイを昇格させないように指示します。

efm stop-cluster

efm stop-cluster <cluster_name>

efm stop-cluster コマンドを呼び出して、すべてのノードでフェールオーバーマネージャーを停止します。このコマンドは、クラスター上の各ノードに接続し、既存のメンバーにシャットダウンするように指示するようにフェールオーバーマネージャーに指示します。このコマンドは実行中のデータベースには影響しませんが、コマンドが完了すると、フェールオーバー保護は行われません。

注釈

efm stop-cluster コマンドを呼び出すと、許可されたノード情報がすべて許可ノードホストリストから削除されます。

このコマンドは、efm、efmグループのメンバー、またはルートによって呼び出される必要があります。

efm upgrade-conf

efm upgrade-conf <cluster_name> [-source <directory>]

efm upgrade-conf コマンドを呼び出して、既存のFailover Managerインストールから構成ファイルをコピーし、Failover Managerインストールに必要なパラメーターを追加します。ユーティリティを呼び出すときに、以前のクラスターの名前を指定します。このコマンドは、 root権限で呼び出す必要があります。

sudoを使用しないフェールオーバーマネージャー構成からアップグレードする場合は、 -source フラグを含め、 upgrade-conf を呼び出すときに構成ファイルが存在するディレクトリの名前を指定します。

efm node-status-json

efm node-status-json <cluster_name>

efm node-status-json コマンドを呼び出して、ローカルノードのステータスをJSON形式で表示します。このコマンドの実行が成功すると、終了コードとして0 が返されます。データベースに障害が発生した場合、またはエージェントのステータスがIDLEになった場合、コマンドは終了コードとして1 を返します。

以下は、 efm node-status-json コマンドの出力例です。

{
  "type":"Standby",
  "address":"172.16.144.130",
  "db":"UP",
  "vip":"",
  "vip_active":"false"
 }

efm –help

efm --help

efm --help コマンドを呼び出して、フェールオーバーマネージャーユーティリティコマンドのオンラインヘルプを表示します。