- 2.3 MySQL Cluster Manager Agent Installation
- 2.3.1 Installing MySQL Cluster Manager on Unix Platforms
- 2.3.2 Installing MySQL Cluster Manager on Windows Platforms
Installing the MySQL Cluster Manager agent on Linux and similar platforms can be accomplished using the following steps:
-
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.gzas 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.gzThis command unpacks the archive into a directory having the same name as the archive, less the
.tar.gzextension.ImportantBecause 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
mcmand 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 ~/mcmFor 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 ~/mcmshell>lsbin cluster etc lib libexec licenses share var
These directories are described in the following table:
| Directory | Contents |
|---|---|
bin |
MySQL Cluster Manager agent startup scripts |
cluster |
Contains the MySQL Cluster NDB 7.2.4 binary distribution (64-bit) |
etc |
Contains the agent configuration file (mcmd.ini) |
etc/init.d |
Init scripts (not currently used) |
lib and subdirectories |
Libraries needed to run the MySQL Cluster Manager agent |
libexec |
MySQL Cluster Manager agent and client executables |
licenses/lgpl |
An archive containing source code (including licensing and
documentation), for glib 2.1 |
share/doc/mcmd |
README.txt file |
var |
XML 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”.
