ndb_mgm 管理クライアントプロセスは、クラスタを実行するために実際には必要ありません。 その価値は、クラスタのステータスをチェックしたり、バックアップを開始したり、その他の管理機能を実行したりするための一連のコマンドを提供することにあります。 管理クライアントは C API を使用して管理サーバーにアクセスします。 上級ユーザーは、この API を使用して専用の管理プロセスをプログラムし、ndb_mgm によって実行されるタスクと同様のことを実行することもできます。
管理クライアントを開始するには、管理サーバーのホスト名およびポート番号を指定する必要があります。
shell> ndb_mgm [host_name [port_num]]例:
shell> ndb_mgm ndb_mgmd.mysql.com 1186
デフォルトのホスト名およびポート番号は、それぞれ
localhost および 1186 です。
次のテーブルに、NDB Cluster 管理クライアントプログラム ndb_mgm に固有のオプションを示します。 追加説明が表のあとにあります。 ほとんどの NDB Cluster プログラム (ndb_mgm を含む) に共通のオプションについては、セクション23.4.32「NDB Cluster プログラムに共通のオプション — NDB Cluster プログラムに共通のオプション」 を参照してください。
表 23.27 プログラムで使用されるコマンドライン・オプション ndb_mgm
| 形式 | 説明 | 追加、非推奨、または削除された |
|---|---|---|
| 中止する前に接続を再試行する回数を設定します。0 は 1 回の試行のみを意味し、再試行は行われません | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| 切断する前に接続を再試行する回数を設定します。--connect-retries のシノニムです | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
|
| コマンドを実行して終了します | (MySQLに基づくすべてのNDBリリースでサポート 8.0) |
-
コマンド行形式 --connect-retries=#型 数値 デフォルト値 3最小値 0最大値 4294967295このオプションは、最初に接続を再試行してから中止するまでの回数を指定します (クライアントは常に接続を 1 回以上試行します)。 試行ごとの待機時間は、
--connect-retry-delayを使用して設定されます。このオプションは、非推奨になった
--try-reconnectオプションと同義です。このオプションのデフォルトは、他の
NDBプログラムで使用する場合のデフォルトとは異なります。 詳しくはセクション23.4.32「NDB Cluster プログラムに共通のオプション — NDB Cluster プログラムに共通のオプション」,をご覧ください。 -
コマンド行形式 --execute=nameこのオプションを使用すると、NDB Cluster 管理クライアントにシステムシェルからコマンドを送信できます。 たとえば、次のコマンドはいずれも管理クライアントで
SHOWを実行することと同等です。shell> ndb_mgm -e "SHOW" shell> ndb_mgm --execute="SHOW"これは
--executeまたは-eオプションが mysql コマンド行クライアントで動作する仕組みに似ています。 セクション4.2.2.1「コマンド行でのオプションの使用」を参照してください。注記このオプションを使用して渡される管理クライアントコマンドにスペース文字が含まれている場合は、コマンドを引用符で囲む必要があります。 一重引用符または二重引用符を使用できます。 管理クライアントコマンドにスペース文字が含まれていない場合は、引用符を使用しなくてもかまいません。
-
コマンド行形式 --try-reconnect=#非推奨 はい 型 数値 型 Integer デフォルト値 12デフォルト値 3最小値 0最大値 4294967295管理サーバーへの接続が切断された場合、ノードは 5 秒ごとに再接続を試みます (成功するまで)。 このオプションを使用することで、接続を中止して代わりにエラーを報告する前に接続を試行する回数を
number回に制限できます。このオプションは非推奨であり、将来のリリースで削除される可能性があります。 かわりに
--connect-retriesを使用してください。
ndb_mgm の使用方法に関する追加情報については、セクション23.5.1「NDB Cluster 管理クライアントのコマンド」を参照してください。