efmユーティリティの使用

Failover Managerクラスタ管理を支援するefmユーティリティを提供します。RPMインストーラーは、Failover Managerをインストールするときに、ユーティリティーを /usr/edb/efm-4.0/bin ディレクトリーに追加します。

efm allow-node <cluster_name>

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

This command must be invoked by efm, a member of the efm group, or root.

efm disallow-node <cluster_name> <ip_address>

Invoke the efm disallow-node command to remove the specified node from the allowed hosts list, and prevent the node from joining a cluster. Provide the name of the cluster and the IP address of the node when calling the efm disallow-node command. This command must be invoked by efm, a member of the efm group, or root.

efm cluster-status <cluster_name>

efm cluster-status コマンドを呼び出して、Failover Managerのステータスを表示しますクラスター。ステータスレポートの詳細については、 :doc:`フェールオーバーマネージャークラスターの監視<monitoring_efm_cluster>`を参照してください。

efm cluster-status-json <cluster_name>

efm cluster-status-json コマンドを呼び出して、Failover Managerのステータスを表示しますJSON形式のクラスター。表示される情報の形式はefmcluster-statusコマンドによって生成される表示とは異なりますが、情報ソースは同じです。

次の例は、2つのノードを持つ正常なクラスターのステータスを照会することにより生成されます。

{
    "nodes": {
        "172.16.144.176": {
            "type": "Witness",
            "agent": "UP",
            "db": "N\/A",
            "vip": "",
            "vip_active": false
        },
        "172.16.144.177": {
            "type": "Primary",
            "agent": "UP",
            "db": "UP",
            "vip": "",
            "vip_active      :       false"
            "xlogReceive     :       0/14001478"
            "xlog    :       0/14001478"
            "xloginfo        :"
        },
        "172.16.144.180": {
            "type": "Standby",
            "agent": "UP",
            "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 <cluster_name> [--from-env]

クラスタープロパティファイルにパスワードを含める前に、 efm encrypt コマンドを呼び出してデータベースパスワードを暗号化します。Failover Managerに指示する --from-env オプションを含めます EFMPASS 環境変数で指定された値を使用し、ユーザー入力なしで実行します。詳細については、 :doc:`データベースパスワードの暗号化<encrypting_database_password>`を参照してください。

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

efm promote コマンドはFailover Managerを指示しますスタンバイからプライマリへの手動フェールオーバーを実行します。

手動昇格は、ステータスコマンドで、クラスターにプライマリの最新のスタンバイノードが含まれていることが報告された場合にのみ試行してください。最新のスタンバイがない場合、Failover Manager続行する前にプロンプトが表示されます。

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

This command must be invoked by efm, a member of the efm group, or root.

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

efm resume <cluster_name>

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

efm set-priority <cluster_name> <ip_address> <priority>

Invoke the efm set-priority command to assign a failover priority to a standby node. The value specifies the order in which the new node will be used in the event of a failover. This command must be invoked by efm, a member of the efm group, or root.

*priority*は1〜*n*の整数値です。*n*はリスト内のスタンバイノードの数です。値1を指定して、新しいノードがプライマリスタンバイであり、フェールオーバーのイベントで昇格される最初のノードであることを示します。優先順位値0は、Failover Managerを指示しますスタンバイを昇格させません。

efm stop-cluster <cluster_name>

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

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

This command must be invoked by efm, a member of the efm group, or root.

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

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

Failover Managerからアップグレードする場合sudoを使用しない設定、 -source フラグを含め、upgrade-confを呼び出すときに設定ファイルが存在する*ディレクトリ*の名前を指定します。

efm node-status-json <cluster_name>

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

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

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

efm --help

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