23.4.5 ndb_mgm — NDB Cluster 管理クライアント

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

形式説明追加、非推奨、または削除された

形式	説明	追加、非推奨、または削除された
`--connect-retries=#`	中止する前に接続を再試行する回数を設定します。0 は 1 回の試行のみを意味し、再試行は行われません	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
`--try-reconnect=#`, `-t`	切断する前に接続を再試行する回数を設定します。--connect-retries のシノニムです	(MySQLに基づくすべてのNDBリリースでサポート 8.0)
`--execute=name`, `-e`	コマンドを実行して終了します	(MySQLに基づくすべてのNDBリリースでサポート 8.0)

--connect-retries=#

中止する前に接続を再試行する回数を設定します。0 は 1 回の試行のみを意味し、再試行は行われません

(MySQLに基づくすべてのNDBリリースでサポート 8.0)

--try-reconnect=#,

-t

切断する前に接続を再試行する回数を設定します。--connect-retries のシノニムです

(MySQLに基づくすべてのNDBリリースでサポート 8.0)

--execute=name,

-e

コマンドを実行して終了します

(MySQLに基づくすべてのNDBリリースでサポート 8.0)

--connect-retries=#
コマンド行形式 --connect-retries=#
型数値
デフォルト値 3
最小値 0
最大値 4294967295
このオプションは、最初に接続を再試行してから中止するまでの回数を指定します (クライアントは常に接続を 1 回以上試行します)。試行ごとの待機時間は、--connect-retry-delay を使用して設定されます。
このオプションは、非推奨になった --try-reconnect オプションと同義です。
このオプションのデフォルトは、他の NDB プログラムで使用する場合のデフォルトとは異なります。詳しくはセクション23.4.32「NDB Cluster プログラムに共通のオプション — NDB Cluster プログラムに共通のオプション」,をご覧ください。
--execute=command, -e command
コマンド行形式 --execute=name
このオプションを使用すると、NDB Cluster 管理クライアントにシステムシェルからコマンドを送信できます。たとえば、次のコマンドはいずれも管理クライアントで SHOW を実行することと同等です。
```
shell> ndb_mgm -e "SHOW"

shell> ndb_mgm --execute="SHOW"
```
これは --execute または -e オプションが mysql コマンド行クライアントで動作する仕組みに似ています。セクション4.2.2.1「コマンド行でのオプションの使用」を参照してください。
注記
このオプションを使用して渡される管理クライアントコマンドにスペース文字が含まれている場合は、コマンドを引用符で囲む必要があります。一重引用符または二重引用符を使用できます。管理クライアントコマンドにスペース文字が含まれていない場合は、引用符を使用しなくてもかまいません。
--try-reconnect=number
コマンド行形式 --try-reconnect=#
非推奨はい
型数値
型 Integer
デフォルト値 12
デフォルト値 3
最小値 0
最大値 4294967295
管理サーバーへの接続が切断された場合、ノードは 5 秒ごとに再接続を試みます (成功するまで)。このオプションを使用することで、接続を中止して代わりにエラーを報告する前に接続を試行する回数を number 回に制限できます。
このオプションは非推奨であり、将来のリリースで削除される可能性があります。かわりに --connect-retries を使用してください。

コマンド行形式	`--connect-retries=#`
型	数値
デフォルト値	`3`
最小値	`0`
最大値	`4294967295`

コマンド行形式	`--execute=name`

コマンド行形式	`--try-reconnect=#`
非推奨	はい
型	数値
型	Integer
デフォルト値	`12`
デフォルト値	`3`
最小値	`0`
最大値	`4294967295`

ndb_mgm の使用方法に関する追加情報については、セクション23.5.1「NDB Cluster 管理クライアントのコマンド」を参照してください。