cluster-config-suffix

my.cnf でクラスタ構成セクションを読み取るときに、デフォルトのグループサフィクスをオーバーライドします。テストで使用されます。

--configinfo

--configinfo オプションを指定すると、ndb_config は、ndb_config が属する NDB Cluster 配布でサポートされている各 NDB Cluster 構成パラメータのリストをダンプします。次の情報が含まれます:

デフォルトでは、この出力はテキスト形式です。 この出力の一部を次に示します。

shell> ndb_config --configinfo

****** SYSTEM ******

Name (String)
Name of system (NDB Cluster)
MANDATORY

PrimaryMGMNode (Non-negative Integer)
Node id of Primary ndb_mgmd(MGM) node
Default: 0 (Min: 0, Max: 4294967039)

ConfigGenerationNumber (Non-negative Integer)
Configuration generation number
Default: 0 (Min: 0, Max: 4294967039)

****** DB ******

MaxNoOfSubscriptions (Non-negative Integer)
Max no of subscriptions (default 0 == MaxNoOfTables)
Default: 0 (Min: 0, Max: 4294967039)

MaxNoOfSubscribers (Non-negative Integer)
Max no of subscribers (default 0 == 2 * MaxNoOfTables)
Default: 0 (Min: 0, Max: 4294967039)

…

このオプションを --xml オプションとともに使用して、XML 形式で出力を取得します。

--config-file=path-to-file

管理サーバーの構成ファイル (config.ini) へのパスを指定します。 これには相対パスまたは絶対パスを指定できます。 ndb_config が呼び出されるホストと別のホストに管理ノードがある場合は、絶対パスを使用する必要があります。

--config_from_node=#

この ID を持つデータノードからクラスタの構成データを取得します。

この ID を持つノードがデータノードではない場合、ndb_config はエラーで失敗します (代わりに、管理ノードから構成データを取得するには、単純にこのオプションを省略します)。

--connections

CONNECTIONS 情報のみ (クラスタ構成ファイルの[tcp], [tcp default], [shm]または[shm default]セクションにあるパラメータに関する情報) を出力するように ndb_config に指示します (詳細は、セクション23.3.3.10「NDB Cluster TCP/IP 接続」 および セクション23.3.3.12「NDB Cluster の共有メモリー接続」 を参照)。

このオプションは、--nodes および --system と相互に排他的です。これらの 3 つのオプションのいずれかのみを使用できます。

--diff-default

デフォルト以外の値を持つ構成パラメータのみを出力します。

--fields=delimiter, -f delimiter

結果のフィールドを区切るために使用される delimiter 文字列を指定します。 デフォルトは , (カンマ) です。

--host=hostname

構成情報を取得するノードのホスト名を指定します。

--mycnf

my.cnf ファイルから構成データを読み取ります。

--ndb-connectstring=connection_string, -c connection_string

管理サーバーに接続するために使用する接続文字列を指定します。 この接続文字列の形式は、セクション23.3.3.3「NDB Cluster 接続文字列」で説明したものと同じであり、デフォルトは localhost:1186 です。

--nodeid=node_id

構成情報を取得するノードのノード ID を指定します。

--nodes

クラスタ構成ファイルの[ndbd]または[ndbd default]セクションで定義されたパラメータにのみ関連する情報を出力するように ndb_config に指示します (セクション23.3.3.6「NDB Cluster データノードの定義」 を参照)。

このオプションは、--connections および --system と相互に排他的です。これらの 3 つのオプションのいずれかのみを使用できます。

--query=query-options, -q query-options

これは、クエリーオプションのカンマ区切りのリストです。つまり、1 つ以上の返されるノード属性のリストです。 これには、nodeid (ノード ID)、タイプ (ノードタイプ、ndbd、mysqld または ndb_mgmd) および値を取得する構成パラメータが含まれます。

たとえば、--query=nodeid,type,datamemory,datadir は各ノードのノード ID、ノードタイプ、DataMemory および DataDir を返します。

--query-all, -a

すべてのクエリーオプション (ノード属性) のカンマ区切りリストを返します。このリストは単一の文字列であることに注意してください。

--rows=separator, -r separator

結果の行を区切るために使用される separator 文字列を指定します。 デフォルトはスペース文字です。

--system

SYSTEM の情報のみを出力するように ndb_config に通知します。 これは、実行時に変更できないシステム変数で構成されているため、クラスタ構成ファイルに対応するセクションはありません。 これらは、ndb_config --configinfo の出力に表示されます (****** SYSTEM ****** という接頭辞が付いています)。

このオプションは、--nodes および --connections と相互に排他的です。これらの 3 つのオプションのいずれかのみを使用できます。

--type=node_type

指定した node_type のノード (ndbd、mysqld、または ndb_mgmd) に該当する構成値のみが返されるように、結果をフィルタリングします。

--usage、--help または -?

ndb_config が使用可能なオプションのリストを出力してから終了します。

--version, -V

ndb_config がバージョン情報文字列を出力してから終了します。

--configinfo --xml

このオプションを追加して、ndb_config --configinfo が XML として出力を提供するようにします。 このような出力の一部を次の例に示します:

shell> ndb_config --configinfo --xml

<configvariables protocolversion="1" ndbversionstring="5.7.33-ndb-7.5.21"
                    ndbversion="460032" ndbversionmajor="7" ndbversionminor="5"
                    ndbversionbuild="0">
  <section name="SYSTEM">
    <param name="Name" comment="Name of system (NDB Cluster)" type="string"
              mandatory="true"/>
    <param name="PrimaryMGMNode" comment="Node id of Primary ndb_mgmd(MGM) node"
              type="unsigned" default="0" min="0" max="4294967039"/>
    <param name="ConfigGenerationNumber" comment="Configuration generation number"
              type="unsigned" default="0" min="0" max="4294967039"/>
  </section>
  <section name="MYSQLD" primarykeys="NodeId">
    <param name="wan" comment="Use WAN TCP setting as default" type="bool"
              default="false"/>
    <param name="HostName" comment="Name of computer for this node"
              type="string" default=""/>
    <param name="Id" comment="NodeId" type="unsigned" mandatory="true"
              min="1" max="255" deprecated="true"/>
    <param name="NodeId" comment="Number identifying application node (mysqld(API))"
              type="unsigned" mandatory="true" min="1" max="255"/>
    <param name="ExecuteOnComputer" comment="HostName" type="string"
              deprecated="true"/>

    …

  </section>

  …

</configvariables>

この XML 出力は、特定のパラメータが変更されたときに、--initial オプションを使用してデータノードを再起動する必要があることも示しています。 これは、対応する <param> 要素に initial="true" 属性が表示されることによって示されます。 また、再起動タイプ (system または node) も示されます。これは、特定のパラメータでシステムの再起動が要求される場合に、対応する <param> 要素に restart="system" 属性が表示されることによって示されます。 たとえば、Diskless パラメータの値セットを変更すると、次に示されているようにシステムの初期再起動が必要となります (restart 属性および initial 属性が見やすいように強調表示されています)。

<param name="Diskless" comment="Run wo/ disk" type="bool" default="false"
          restart="system" initial="true"/>

現在、初期再起動が必要ないパラメータに対応する <param> 要素の XML 出力には、initial 属性は表示されません。言い換えると、initial="false" がデフォルトであり、属性が表示されていない場合は値 false を想定してください。 同様に、デフォルトの再起動タイプは node (つまり、クラスタのオンラインまたは「ローリング」再起動) ですが、restart 属性は再起動タイプが system (すべてのクラスタノードを同時にシャットダウンしてから再起動する必要があることを意味します) である場合にのみ表示されます。

非推奨のパラメータは、次に示すように、deprecated 属性によって XML 出力に示されます:

<param name="NoOfDiskPagesToDiskAfterRestartACC" comment="DiskCheckpointSpeed"
       type="unsigned" default="20" min="1" max="4294967039" deprecated="true"/>

このような場合、comment は、非推奨のパラメータよりも優先される 1 つ以上のパラメータを参照します。 initial と同様に、deprecated 属性は、パラメータが deprecated="true"で非推奨の場合にのみ示され、非推奨ではないパラメータにはまったく表示されません。 (Bug #21127135)

NDB 7.5.0 以降では、次に示すように、必要なパラメータは mandatory="true"で示されます:

<param name="NodeId"
          comment="Number identifying application node (mysqld(API))"
          type="unsigned" mandatory="true" min="1" max="255"/>

initial または deprecated 属性は、初期再起動が必要なパラメータまたは非推奨のパラメータに対してのみ表示されるのとほぼ同じ方法で、mandatory 属性は、指定されたパラメータが実際に必要な場合にのみ含まれます。

このプログラムで現在の構成データを取得するために使用されるオプションとは異なり、--configinfo および --xml は、ndb_config のコンパイル時に NDB Cluster ソースから取得された情報を使用します。 このため、これらのオプションでは、実行中の NDB Cluster への接続や、config.ini または my.cnf ファイルへのアクセスは必要ありません。