MySQL Cluster をサポートするには my.cnf を以下の例に基づいて更新する必要があります。ここに示すオプションを config.ini ファイルに使用したオプションと混同しないように注意してくだささい。実行ファイルを実行する際にコマンドラインでこれらのパラメータを指定することもっできます。

# my.cnf
# example additions to my.cnf for MySQL Cluster
# (valid in MySQL 5.1)

# enable ndbcluster storage engine, and provide connectstring for
# management server host (default port is 1186)
[mysqld]
ndbcluster
ndb-connectstring=ndb_mgmd.mysql.com


# provide connectstring for management server host (default port: 1186)
[ndbd]
connect-string=ndb_mgmd.mysql.com

# provide connectstring for management server host (default port: 1186)
[ndb_mgm]
connect-string=ndb_mgmd.mysql.com

# provide location of cluster configuration file
[ndb_mgmd]
config-file=/etc/config.ini

(接続文字列に関する詳細は、項14.4.4.2. 「クラスタの　接続文字列」 を参照してください。)

# my.cnf
# example additions to my.cnf for MySQL Cluster
# (will work on all versions)

# enable ndbcluster storage engine, and provide connectstring for management
# server host to the default port 1186
[mysqld]
ndbcluster
ndb-connectstring=ndb_mgmd.mysql.com:1186

重要前述のように mysqld プロセスを my.cnf ファイルの ［MYSQLD] にある ndbcluster および ndb-connectstring パラメータで実行すると、CREATE TABLE あるいは ALTER TABLE ステートメントをクラスタを実際に始めるまでは実行できなくなります。または、これらのステートメントはエラーが表示されて失敗します。これは設計によります。

クラスタ のmy.cnf ファイルの個別の [mysql_cluster] セクションを使用して設定を読み込んですべての実行ファイルで使用することもできます。

# cluster-specific settings
[mysql_cluster]
ndb-connectstring=ndb_mgmd.mysql.com:1186

my.cnf ファイルで設定できる他の NDB 変数については 項4.2.3. 「システム変数」 を参照してください。

設定ファイルはデフォルトで config.ini の名前になっています。設定ファイルは起動時に ndb_mgmd で読み込まれどこにでも配置できます。そのロケーションと名前は ndb.mgmd のコマンドラインにある --config-file=path_name を使用して指定できます。設定ファイルが指定されていない場合、ndb_mgmd がデフォルトで現在の動作中のディレクトリにある config.ini ファイルを読み込もうとします。

現在設定ファイルは INI フォーマットで、最初にセクションの見出しのあるセクション（角括弧で括られている）で構成され、その後に適切なパラメータ名や値が続きます。標準の INI フォーマットと違うところはパラメータ名や値がコロン (‘:’) および等号記号 (‘=’) で分離できることです。もう一箇所違うところはセクションがセクション名で独自に認識されないことです。その代わり、独自のセクション （同じ種類の異なる 2 つのノードなど） はセクション内のパラメータとして指定された独自の ID で認識されます。

デフォルト値は殆どのパラメータに定義され、config.ini で指定することもできます。デフォルト値のセクションを作成するには、単に単語 DEFAULT をセクション名に追加するだけです。例えば、[NDBD] セクションは特定のデータノードに適用されるパラメータを含み、[NDBD DEFAULT] セクションはすべてのデータノードに適用されるパラメータを含みます。すべてのデータノードが同じデータのメモリ容量を使用するものと仮定します。それらをすべて設定するには、DataMemory ラインを含む [NDBD DEFAULT] セクションを作成してデータのメモリ容量を指定します。

最低の設定でも、設定ファイルはクラスタに使用されるコンピュータやノードを定義し、それらのコンピュータのこれらのノードが属します。1 台のマネジメント サーバー、2 台のデータノードおよび 2 台の MySQL サーバーで構成した簡素な設定ファイルの例をここに示します。

# file "config.ini" - 2 data nodes and 2 SQL nodes
# This file is placed in the startup directory of ndb_mgmd (the
# management server)
# The first MySQL Server can be started from any host. The second
# can be started only on the host mysqld_5.mysql.com

[NDBD DEFAULT]
NoOfReplicas= 2
DataDir= /var/lib/mysql-cluster

[NDB_MGMD]
Hostname= ndb_mgmd.mysql.com
DataDir= /var/lib/mysql-cluster

[NDBD]
HostName= ndbd_2.mysql.com

[NDBD]
HostName= ndbd_3.mysql.com

[MYSQLD]
[MYSQLD]
HostName= mysqld_5.mysql.com

各ノードはそれぞれ独自のセクションを config.ini に持つ必要があります。例えば、このクラスタには 2 台のデータノードがあるので、前述の設定ファイルにはこれらのノードを定義する 2 つの [NDBD] セクションがあります。

config.ini ファイルのセクション

以下のリストに示すように、config.ini 設定ファイルで使用できる異なる 6 つのセクションがあります。

各セクションに対して DEFAULT の値を定義できます。すべてのクラスタのパラメータは重要なパラメータで、my.cnf あるいは my.ini ファイルで指定されたパラメータとは異なります。