5.2.4 Installing the Service Manager on Mac OS X

On Mac OS X, there are three installation modes: osx, text, and unattended. For more information on this topic see Section 5.4, “Unattended Installation”. The text mode installation for Mac OS X is identical to text installation under Unix. For text mode installation instructions see Section 5.2.2, “Installing the Service Manager on Unix and Linux”.

Installing the MySQL Enterprise Service Manager on Mac OS X requires at least Mac OS X 10.6, and an existing installation of Java. The minimum required version is 1.5.0_7. If this version is not installed on your machine, you can download it from Apple.

For reasons of backwards compatibility, Mac OS X is usually installed with multiple versions of Java. When installing in osx mode, version 1.5.0_7 must be the default version. Upon installation, Java 1.5.0_7 sets itself as the default, so this is usually not a problem.

If you have changed the default Java version, you can reset it in your environment, or you can install the MySQL Enterprise Service Manager in text mode, setting the environment variables to point to the correct version of Java. To install in text mode, find the installbuilder file in the Contents/MacOS directory immediately below the mysqlmonitor-version-osx-installer.app directory. Installing the MySQL Enterprise Service Manager in text mode is identical to the procedure described in Section 5.2.2, “Installing the Service Manager on Unix and Linux” with the minor differences noted above.

To install using the GUI (osx) installation, follow these instructions:

  1. Double-click the MySQL Monitor installer. In the Language Selection dialog, select the language to use for the installer and then click OK.

  2. If you have multiple Java installations on your machine, choose which Java to use with your MySQL Enterprise Service Manager installation (1.5.0 or later is required), and click OK.

    Figure 5.3 MySQL Enterprise Monitor: Installing Monitor on OS X: Java Selection

    MySQL Enterprise Monitor: Installing Monitor on OS X: Java Selection

  3. With the installation language and Java version selected, the remainder of the installation sets up the installation location and the main configuration parameters required by MySQL Enterprise Service Manager. Click Next to continue.

  4. Select the installation directory where you want the MySQL Enterprise Service Manager components installed. By default on Mac OS X the directory is /Applications/mysql/enterprise/monitor. Click the button next to the installation directory field to select a directory using the File chooser, or type the directory manually. Click Next to continue.

  5. Configure the options that set the network ports used by the Tomcat server. For more information, see Section 5.2.1, “Service Manager Installation Common Parameters”. Click Next to continue.

    Figure 5.4 MySQL Enterprise Monitor: Installing Monitor on OS X: Tomcat Server Options

    MySQL Enterprise Monitor: Installing Monitor on OS X: Tomcat Server Options

  6. Configure the repository settings, setting the user name, password and port for the bundled MySQL server that stores the information and statistics for your installation. For more information, see Section 5.2.1, “Service Manager Installation Common Parameters”. Click Next to continue.

    Figure 5.5 MySQL Enterprise Monitor: Installing Monitor on OS X: Repository Configuration

    MySQL Enterprise Monitor: Installing Monitor on OS X: Repository Configuration

  7. You receive information and a warning about the configuration options and how they are stored in the configuration_report.txt file, and its location. Record the full path to this file for future reference. Click Next to continue.

  8. Next, start the installation process. Click Next to continue.

  9. Once the installation is completed, you receive information on how to uninstall MySQL Enterprise Service Manager. Click Next to continue.

  10. To complete the installation and set up your MySQL Enterprise Service Manager, login to the Dashboard. You can do this automatically by leaving the box checked on the final window before clicking Finish. To skip the Dashboard at this time, uncheck the box and click Finish.

Your installation is now complete. To continue with the configuration of MySQL Enterprise Service Manager, see Section 5.2.7, “MySQL Enterprise Service Manager Configuration Settings and Advisor Installation”.