2.4.2 Installing MySQL on OS X Using Native Packages

The package is located inside a disk image (.dmg) file that you first need to mount by double-clicking its icon in the Finder. It should then mount the image and display its contents.


Before proceeding with the installation, be sure to stop all running MySQL server instances by using either the MySQL Manager Application (on OS X Server) or mysqladmin shutdown on the command line.

When installing from the package version, you should also install the MySQL Preference Pane, which will enable you to control the startup and execution of your MySQL server from System Preferences. For more information, see Section 2.4.5, “Installing and Using the MySQL Preference Pane”.

When installing using the package installer, the files are installed into a directory within /usr/local matching the name of the installation version and platform. For example, the installer file mysql-5.1-osx10.6-x86_64.dmg installs MySQL into /usr/local/mysql-5.1-osx10.6-x86_64/ . The following table shows the layout of the installation directory.

Table 2.12 MySQL Installation Layout on OS X

DirectoryContents of Directory
bin, scriptsmysqld server, client and utility programs
dataLog files, databases
docsHelper documents, like the Release Notes and build information
includeInclude (header) files
manUnix manual pages
mysql-testMySQL test suite
shareMiscellaneous support files, including error messages, sample configuration files, SQL for database installation
support-filesScripts and sample configuration files
/tmp/mysql.sockLocation of the MySQL Unix socket

During the package installer process, a symbolic link from /usr/local/mysql to the version/platform specific directory created during installation will be created automatically.

  1. Download and open the MySQL package installer, which is provided on a disk image (.dmg) that includes the main MySQL installation package, the MySQLStartupItem.pkg installation package, and the MySQL.prefPane. Double-click the disk image to open it.

    Figure 2.19 MySQL Package Installer: DMG Contents

    MySQL Package Installer: DMG Contents

  2. Double-click the MySQL installer package. It will be named according to the version of MySQL you have downloaded. For example, if you have downloaded MySQL server 5.1.73, double-click mysql-5.1.73-osx-10.6-x86_64.pkg.

  3. You will be presented with the opening installer dialog. Click Continue to begin installation.

    Figure 2.20 MySQL Package Installer: Introduction

    MySQL Package Installer: Introduction

  4. A copy of the installation instructions and other important information relevant to this installation are displayed. Click Continue .

  5. If you have downloaded the community version of MySQL, you will be shown a copy of the relevant GNU General Public License. Click Continue .

  6. Select the drive you want to use to install the MySQL Startup Item. The drive must have a valid, bootable, OS X operating system installed. Click Continue.

    Figure 2.21 MySQL Package Installer: Choose your Hard drive

    MySQL Package Installer: Choose your Hard drive

  7. You will be asked to confirm the details of the installation, including the space required for the installation. To change the drive on which the MySQL server is installed, click either Go Back or Change Install Location.... To install the MySQL server, click Install.

  8. Once the installation has been completed successfully, you will be shown an Install Succeeded message.

For convenience, you may also want to install the startup item and preference pane. See Section 2.4.4, “Installing the MySQL Startup Item”, and Section 2.4.5, “Installing and Using the MySQL Preference Pane”.