2.3.1. Installing MySQL Cluster Manager on Unix Platforms

Installing the MySQL Cluster Manager agent on Linux and similar platforms can be accomplished using the following steps:

  1. Extract the MySQL Cluster Manager 1.1.6 program and other files from the distribution archive.  You must install a copy of MySQL Cluster Manager on each computer that you intend to use as a MySQL Cluster host. In other words, you need to install MySQL Cluster Manager on each host that is a member of a MySQL Cluster Manager management site. For each host, you should use the MySQL Cluster Manager build that matches that computer's operating system and processor architecture.

    On Linux systems, you can unpack the archive using the following command, using mcm-1.1.4_64-cluster-7.2.4_64-linux-sles11-x86.tar.gz as an example (the actual filename will vary according to the MySQL Cluster Manager build that you intend to deploy):

    shell> tar -zxvf mcm-1.1.4_64-cluster-7.2.4_64-linux-sles11-x86.tar.gz

    This command unpacks the archive into a directory having the same name as the archive, less the .tar.gz extension.


    Because the Solaris version of tar cannot handle long filenames correctly, the MySQL Cluster Manager program files may be corrupted if you try to use it to unpack the MySQL Cluster Manager archive. To get around this issue on Solaris operating systems, you should use GNU tar (gtar) rather than the default tar supplied with Solaris. On Solaris 10, gtar is often already installed in the /usr/sfw/bin directory, although the gtar executable may not be included in your path. If gtar is not present on your system, please consult the Solaris 10 system documentation for information on how to obtain and install it.

    In general, the location where you place the unpacked MySQL Cluster Manager directory and the name of this directory can be arbitrary. For purposes of this discussion, we assume that you rename the extracted directory to mcm and place it in the ~/ directory of the user account which will be used to operate MySQL Cluster Manager. On a typical Linux system you can accomplish this task like this:

    shell> mv mcm-1.1.4_64-cluster-7.2.4_64-linux-sles11-x86 ~/mcm

    For ease of use, we recommend that you put the MySQL Cluster Manager files in the same directory on each host where you intend to run it.

Contents of the MySQL Cluster Manager Unix Distribution Archive.  If you change to the directory where you placed the extracted MySQL Cluster Manager archive and list the contents; you should see something similar to what is shown here:

shell> cd ~/mcm
shell> ls
bin  cluster  etc  lib  libexec  licenses  share  var

These directories are described in the following table:

binMySQL Cluster Manager agent startup scripts
clusterContains the MySQL Cluster NDB 7.2.4 binary distribution (64-bit)
etcContains the agent configuration file (mcmd.ini)
etc/init.dInit scripts (not currently used)
lib and subdirectoriesLibraries needed to run the MySQL Cluster Manager agent
libexecMySQL Cluster Manager agent and client executables
licenses/lgplAn archive containing source code (including licensing and documentation), for glib 2.1
share/doc/mcmdREADME.txt file
varXML files containing information needed by MySQL Cluster Manager about processes, attributes, and command syntax

Normally, the only directories of those shown in the preceding table that you need be concerned with are the bin and etc directories.

For MySQL Cluster Manager 1.1.6 distributions that include MySQL Cluster, the complete MySQL Cluster NDB 7.2.4 binary distribution is included in the cluster directory. Within this directory, the layout of the MySQL Cluster distribution is the same as that of the standalone MySQL Cluster binary distribution. For example, MySQL Cluster binary programs such as ndb_mgmd, ndbd, ndbmtd, and ndb_mgm can be found in cluster/bin. For more information, see MySQL Installation Layout for Generic Unix/Linux Binary Package, and Installing a MySQL Cluster Binary Release on Linux, in the MySQL Manual.

The MySQL Cluster Manager agent by default writes its log file as mcmd.log in the installation directory. When the agent run for the first time, it also creates an mcm_data directory where the agent stores its own configuration data. Also by default, the configuration data, log files, and data node file systems for a given MySQL Cluster under MySQL Cluster Manager control, and named cluster_name, can be found in mcm_data/clusters/cluster_name.

The location of the MySQL Cluster Manager agent configuration file, log file, and data directory can be controlled with mcmd startup options or by making changes in the agent configuration file. For more information, see Section 2.4, “MySQL Cluster Manager Configuration File”, and Section 2.5, “Starting and Stopping the MySQL Cluster Manager Agent”.