MySQL 5.7 Reference Manual Including MySQL NDB Cluster 7.5 and NDB Cluster 7.6
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 macOS Server), the preference pane, or mysqladmin shutdown on the command line.
To install MySQL using the package installer:
Download the disk image (.dmg
) file (the
community version is available
here) that
contains the MySQL package installer. Double-click the file to
mount the disk image and see its contents.
Double-click the MySQL installer package from the disk. It is
named according to the version of MySQL you have downloaded.
For example, for MySQL server 5.7.34 it might be
named
mysql-5.7.34-osx-
.
10.13-x86_64
.pkg
The initial wizard introduction screen references the MySQL server version to install. Click
to begin the installation.The MySQL community edition shows a copy of the relevant GNU General Public License. Click
and then to continue.From the Installation Type page you can either click to execute the installation wizard using all defaults, click to alter which components to install (MySQL server, Preference Pane, Launchd Support -- all enabled by default).
Although the
option is visible, the installation location cannot be changed.Click
to begin the installation process.After a successful installation, the installer displays a window with your temporary root password. This cannot be recovered so you must save this password for the initial login to MySQL. For example:
MySQL expires this temporary root password after the initial login and requires you to create a new password.
Summary is the final step and references a successful and complete MySQL Server installation. the wizard.
MySQL server is now installed, but it is not loaded (or started) by default. Use either launchctl from the command line, or start MySQL by clicking "Start" using the MySQL preference pane. For additional information, see Section 2.4.3, “Installing a MySQL Launch Daemon”, and Section 2.4.4, “Installing and Using the MySQL Preference Pane”. Use the MySQL Preference Pane or launchd to configure MySQL to automatically start at bootup.
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.7.34-
installs MySQL into
osx10.13-x86_64.dmg
/usr/local/mysql-5.7.34-osx10.13-x86_64/
. The following table shows the layout of the
installation directory.
Table 2.7 MySQL Installation Layout on macOS
Directory | Contents of Directory |
---|---|
bin |
mysqld server, client and utility programs |
data |
Log files, databases |
docs |
Helper documents, like the Release Notes and build information |
include |
Include (header) files |
lib |
Libraries |
man |
Unix manual pages |
mysql-test |
MySQL test suite |
share |
Miscellaneous support files, including error messages, sample configuration files, SQL for database installation |
support-files |
Scripts and sample configuration files |
/tmp/mysql.sock |
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 is created
automatically.