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
matching the name of the installation version and platform. For
example, the installer file
installs MySQL into
. The following table shows the layout of the
Table 2.12 MySQL Installation Layout on OS X
|Directory||Contents of Directory|
|mysqld server, client and utility programs|
|Log files, databases|
|Helper documents, like the Release Notes and build information|
|Include (header) files|
|Unix manual pages|
|MySQL test suite|
|Miscellaneous support files, including error messages, sample configuration files, SQL for database installation|
|Scripts and sample configuration files|
|Location 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
Download and open the MySQL package installer, which is
provided on a disk image (
includes the main MySQL installation package, the
package, and the
Double-click the disk image to open it.
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
You will be presented with the opening installer dialog. Click Continue to begin installation.
A copy of the installation instructions and other important information relevant to this installation are displayed. Click Continue .
If you have downloaded the community version of MySQL, you will be shown a copy of the relevant GNU General Public License. Click Continue .
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.
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.
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”.