Using the efm utility

</ div>

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

efm allow-node

</ div>

efm allow-node <cluster_name>

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

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

efm disallow-node

</ div>

efm disallow-node <cluster_name> <address>

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

efm cluster-status

</ div>

efm cluster-status <cluster_name>

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

efm cluster-status-json

</ div>

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暗号化

</ div>

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

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

efmプロモート

</ div>

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

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

プライマリコマンドで最新のスタンバイノードがクラスターに含まれていることがstatusコマンドから報告された場合にのみ、マニュアル昇格を試みます。最新のスタンバイがない場合、フェールオーバーマネージャーは続行する前にプロンプトを表示します。

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

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

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

efm履歴書

</ div>

efm resume <cluster_name>

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

efm set-priority

</ div>

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

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

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

efm stop-cluster

</ div>

efm stop-cluster <cluster_name>

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

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

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

efm upgrade-conf

</ div>

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

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

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

efm node-status-json

</ div>

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-ヘルプ

</ div>

efm --help

efm --helpコマンドを呼び出して、Failover Managerユーティリティコマンドのオンラインヘルプを表示します。