MySQL Installation Guide

Abstract

This is the MySQL Installation Guide from the MySQL 5.6 Reference Manual.

For legal information, see the Legal Notices.

For help with using MySQL, please visit either the MySQL Forums or MySQL Mailing Lists, where you can discuss your issues with other MySQL users.

For additional documentation on MySQL products, including translations of the documentation into other languages, and downloadable versions in variety of formats, including HTML and PDF formats, see the MySQL Documentation Library.

Licensing information—MySQL 5.6.  This product may include third-party software, used under license. If you are using a Commercial release of MySQL 5.6, see this document for licensing information, including licensing information relating to third-party software that may be included in this Commercial release. If you are using a Community release of MySQL 5.6, see this document for licensing information, including licensing information relating to third-party software that may be included in this Community release.

Licensing information—MySQL Cluster.  This product may include third-party software, used under license. If you are using a Commercial release of MySQL Cluster NDB 7.3 or NDB 7.4, see this document for licensing information, including licensing information relating to third-party software that may be included in this Commercial release. If you are using a Community release of MySQL Cluster NDB 7.3 or NDB 7.4, see this document for licensing information, including licensing information relating to third-party software that may be included in this Community release.

Document generated on: 2016-10-04 (revision: 49305)


Table of Contents

Preface and Legal Notices
1 Installing and Upgrading MySQL
2 General Installation Guidance
2.1 Which MySQL Version and Distribution to Install
2.2 How to Get MySQL
2.3 Verifying Package Integrity Using MD5 Checksums or GnuPG
2.3.1 Verifying the MD5 Checksum
2.3.2 Signature Checking Using GnuPG
2.3.3 Signature Checking Using Gpg4win for Windows
2.3.4 Signature Checking Using RPM
2.4 Installation Layouts
2.5 Compiler-Specific Build Characteristics
3 Installing MySQL on Unix/Linux Using Generic Binaries
4 Installing MySQL from Source
4.1 MySQL Layout for Source Installation
4.2 Installing MySQL Using a Standard Source Distribution
4.3 Installing MySQL Using a Development Source Tree
4.4 MySQL Source-Configuration Options
4.5 Dealing with Problems Compiling MySQL
4.6 MySQL Configuration and Third-Party Tools
5 Installing MySQL on Microsoft Windows
5.1 MySQL Installation Layout on Microsoft Windows
5.2 Choosing An Installation Package
5.3 Installing MySQL on Microsoft Windows Using MySQL Installer
5.3.1 MySQL Installer GUI
5.3.2 MySQL Installer Console
5.4 MySQL Notifier
5.4.1 MySQL Notifier Usage
5.4.2 Setting Up Remote Monitoring in MySQL Notifier
5.5 Installing MySQL on Microsoft Windows Using a noinstall Zip Archive
5.5.1 Extracting the Install Archive
5.5.2 Creating an Option File
5.5.3 Selecting a MySQL Server Type
5.5.4 Starting the Server for the First Time
5.5.5 Starting MySQL from the Windows Command Line
5.5.6 Customizing the PATH for MySQL Tools
5.5.7 Starting MySQL as a Windows Service
5.5.8 Testing The MySQL Installation
5.6 Troubleshooting a Microsoft Windows MySQL Server Installation
5.7 Windows Postinstallation Procedures
5.8 Upgrading MySQL on Windows
6 Installing MySQL on OS X
6.1 General Notes on Installing MySQL on OS X
6.2 Installing MySQL on OS X Using Native Packages
6.3 Installing a MySQL Launch Daemon
6.4 Installing and Using the MySQL Preference Pane
7 Installing MySQL on Linux
7.1 Installing MySQL on Linux Using the MySQL Yum Repository
7.2 Replacing a Third-Party Distribution of MySQL Using the MySQL Yum Repository
7.3 Installing MySQL on Linux Using the MySQL APT Repository
7.4 Installing MySQL on Linux Using the MySQL SLES Repository
7.5 Installing MySQL on Linux Using RPM Packages from Oracle
7.6 Installing MySQL on Linux Using Debian Packages from Oracle
7.7 Installing MySQL on Linux from the Native Software Repositories
7.8 Installing MySQL on Linux with docker
7.9 Installing MySQL on Linux with juju
8 Installing MySQL on Solaris and OpenSolaris
8.1 Installing MySQL on Solaris Using a Solaris PKG
8.2 Installing MySQL on OpenSolaris Using IPS
9 Postinstallation Setup and Testing
9.1 Initializing the Data Directory
9.1.1 Problems Running mysql_install_db
9.2 Starting the Server
9.2.1 Troubleshooting Problems Starting the MySQL Server
9.3 Testing the Server
9.4 Securing the Initial MySQL Accounts
9.5 Starting and Stopping MySQL Automatically
10 Upgrading or Downgrading MySQL
10.1 Upgrading MySQL
10.1.1 Changes Affecting Upgrades to MySQL 5.6
10.1.2 Upgrading MySQL with the MySQL Yum Repository
10.1.3 Upgrading MySQL with the MySQL APT Repository
10.2 Downgrading MySQL
10.2.1 Changes Affecting Downgrades from MySQL 5.6
10.3 Checking Whether Tables or Indexes Must Be Rebuilt
10.4 Rebuilding or Repairing Tables or Indexes
10.5 Copying MySQL Databases to Another Machine
11 Environment Variables
12 Perl Installation Notes
12.1 Installing Perl on Unix
12.2 Installing ActiveState Perl on Windows
12.3 Problems Using the Perl DBI/DBD Interface