This section provides information about compiling MySQL Cluster on Linux and other Unix-like platforms.To build MySQL Cluster, you need the MySQL 5.0 source archive available from http://dev.mysql.com/downloads/. Building MySQL Cluster from source is similar to building the standard MySQL Server, although it differs in a few key respects discussed here. For general information about building MySQL from source, see Section 2.17, “Installing MySQL from Source”.
In addition to any other configure options
you wish to use, be sure to include
--with-ndbcluster. This option causes the
binaries for the management nodes, data nodes, and other MySQL
Cluster programs to be built; it also causes
mysqld to be compiled with
NDB storage engine support.
After you have run make && make install (or your system's equivalent), the result is similar to what is obtained by unpacking a precompiled binary to the same location. However, the layout can differ. These differences are covered in the next few paragraphs.
When building from source and running the default
make install, the management server binary
(ndb_mgmd) is placed in
/usr/local/mysql/libexec, while the
management client binary (ndb_mgm) can be
ndb_mgmd is required to be present on a
management node host; however, it is also a good idea to have
ndb_mgm present on the same host machine.
Neither of these executables requires a specific location on
the host machine's file system.
The only executable required on a data node host is
ndbd (mysqld, for
example, does not have to be present on the host machine). By
default when doing a source build, this file is placed in the
installing on multiple data node hosts, only
ndbd need be copied to the other host
machine or machines. (This assumes that all data node hosts
use the same architecture and operating system; otherwise you
may need to compile separately for each different platform.)
ndbd need not be in any particular location
on the host's file system, as long as the location is known.
If you compile MySQL with clustering support, and perform the
default installation (using make install as
mysqld is placed in
/usr/local/mysql/bin. Follow the steps
given in Section 2.17, “Installing MySQL from Source” to make
mysqld ready for use. If you want to run
multiple SQL nodes, you can use a copy of the same
mysqld executable and its associated
support files on several machines. The easiest way to do this
is to copy the entire
directory and all directories and files contained within it to
the other SQL node host or hosts, then repeat the steps from
Section 2.17, “Installing MySQL from Source” on each machine. If you
configure the build with a nondefault
--prefix, you need to adjust
the directory accordingly.
In Section 17.2.2, “Initial Configuration of MySQL Cluster”, we create configuration files for all of the nodes in our example MySQL Cluster.