2.3.2 Installing MySQL Cluster Manager on Windows Platforms

2.3.2.1 Installing the MySQL Cluster Manager Agent as a Windows Service

To install MySQL Cluster Manager 1.3.1 on Windows platforms, you should first have downloaded the MSI installer file mcm-1.3.1-cluster-7.3.3-win32-x86.msi (see Section 2.1, “Obtaining MySQL Cluster Manager”). 1.3.1 for Windows is 32-bit, as is the bundled MySQL Cluster NDB 7.3.3; these run on both 32-bit and 64-bit versions of Windows.

As mentioned elsewhere (see, for example, Section 3.4.1, “Creating a MySQL Cluster with MySQL Cluster Manager”), you must install a copy of MySQL Cluster Manager on each computer where you intend to host a MySQL Cluster node. Therefore, the following procedure must be performed separately on each host computer. For ease of installations and upgrades on multiple machines, it is recommended that you install MySQL Cluster Manager to the same location on each host. This is C:\Program Files\MySQL\MySQL Cluster Manager 1.3.1\ or C:\Program Files (x86)\MySQL\MySQL Cluster Manager 1.3.1\ by default, but it is possible to install MySQL Cluster Manager to an alternate location such as C:\mcm\.

In the discussion that follows, we assume that you have downloaded the MySQL Cluster Manager 1.2.1 MSI installer as user jon to this user's Downloads directory (C:\Users\jon\Downloads\MCM) on a 64-bit Windows system. Navigate to this directory in Windows Explorer, as shown here:

MySQL Cluster Manager.MSI installer file after downloading (in Windows Explorer)

To run the installer, double-click on the file icon in Windows Explorer. Some versions of Windows also provide an Install item in the Windows Explorer menu that can be used to run the installer. When you start the installer, you may see a Windows Security Warning screen. If you obtained the installer from a trusted source and know that it has not been tampered with, choose Run from the dialog, which allows the installer to continue to the Welcome screen, as shown here:

MySQL Cluster Manager.MSI installer, Welcome screen

Click the Next button to continue to the License Agreement screen, as shown in the next figure:

MySQL Cluster Manager.MSI installer License Agreement screen, initial

You should read the license text in the text area, and when you have done so, check the box labelled I accept the terms in the License Agreement. Until you have checked the box, you cannot complete the MySQL Cluster Manager installation; it is possible only to go back to the previous screen, print the license, or cancel the installation (using the buttons labelled Back, Print, and Cancel, respectively). Checking the box enables the Next button, as shown here:

MySQL Cluster Manager.MSI installer License Agreement screen, acceptance checked

Click the Next button to continue to the Destination Folder screen, where you can choose the installation directory. The next figure shows the Destination Folder screen with the default location. On English-language 32-bit Windows systems, this is C:\Program Files\MySQL\MySQL Cluster Manager version\); on English 64-bit Windows systems, the default is C:\Program Files (x86)\MySQL\MySQL Cluster Manager version\. (In this example, we are installing MySQL Cluster Manager 1.2.1 on a 64-bit system, so the default is C:\Program Files (x86)\MySQL\MySQL Cluster Manager 1.2.1\.) You can click the Change button to change the directory where MySQL Cluster Manager should be installed; the default directory is adequate for most cases.

MySQL Cluster Manager MSI installer Destination screen, showing default location

Once you have selected the destination directory, the installer has gathered all the information that it requires to perform the installation. Click Next to continue to the Ready screen, shown here:

MySQL Cluster Manager.MSI installer, Ready screen

Click the Install button to install MySQL Cluster Manager. As the installer begins to copy files and perform other tasks affecting the system, you may see a warning dialog from Windows User Access Control, as shown here:

MySQL Cluster Manager.MSI installer with Windows UAC dialog

If this occurs, click the Yes button to allow the installation to continue. A Setup Wizard screen with a progress bar is displayed while the installer runs, as shown in the next figure:

MySQL Cluster Manager MSI installer, Setup Wizard screen

The Setup Wizard may require several minutes to copy all of the necessary files for MySQL Cluster Manager 1.3.1 and MySQL Cluster NDB 7.3.3 to the installation directory and to perform other required changes.

Note

The MySQL Cluster Manager 1.3.1 installer places MySQL Cluster NDB 7.3.3 in the cluster directory under the installation directory. (By default, this is C:\Program Files\MySQL\MySQL Cluster Manager 1.3.1\cluster or C:\Program Files (x86)\MySQL\MySQL Cluster Manager 1.3.1\cluster.) The location of the MySQL Cluster binaries is not separately configurable using the MySQL Cluster Manager installer.

When the Setup Wizard finishes, the installer displays the Installation Completed screen, as shown here:

MySQL Cluster Manager MSI installer, Installation Completed screen

MySQL Cluster Manager 1.3.1 has now been installed to the destination directory; click the Finish button to exit the installer.