MySQL :: MySQL 9.0 参考手册 :: 2.8.4 使用标准源代码发行版安装 MySQL

版本 9.0

8.4 当前
8.0
5.7

8.0 日语

MySQL 9.0 参考手册 / ... / 使用标准源代码发行版安装 MySQL

2.8.4 使用标准源代码发行版安装 MySQL

要从标准源代码发行版安装 MySQL，请执行以下操作

验证您的系统是否满足第 2.8.2 节 “源代码安装先决条件”中列出的工具要求。
按照第 2.1.3 节 “如何获取 MySQL”中的说明获取发行版文件。
使用本节中的说明配置、构建和安装发行版。
按照第 2.9 节 “安装后设置和测试”中的说明执行安装后步骤。

MySQL 在所有平台上都使用 CMake 作为构建框架。此处给出的说明应该能让您完成一个可用的安装。有关使用 CMake 构建 MySQL 的更多信息，请参阅如何使用 CMake 构建 MySQL 服务器。

如果您从源代码 RPM 开始，请使用以下命令生成可以安装的二进制 RPM。如果您没有 rpmbuild，请改用 rpm。

$> rpmbuild --rebuild --clean MySQL-VERSION.src.rpm

结果是一个或多个二进制 RPM 软件包，您可以按照第 2.5.4 节 “使用 Oracle 的 RPM 软件包在 Linux 上安装 MySQL”中的指示安装它们。

从压缩的 tar 文件或 Zip 存档源代码发行版安装的顺序与从通用二进制发行版安装的过程类似（请参阅第 2.2 节 “使用通用二进制文件在 Unix/Linux 上安装 MySQL”），不同之处在于它适用于所有平台，并且包括配置和编译发行版的步骤。例如，对于 Unix 上的压缩 tar 文件源代码发行版，基本安装命令顺序如下所示

# Preconfiguration setup
$> groupadd mysql
$> useradd -r -g mysql -s /bin/false mysql
# Beginning of source-build specific instructions
$> tar zxvf mysql-VERSION.tar.gz
$> cd mysql-VERSION
$> mkdir bld
$> cd bld
$> cmake ..
$> make
$> make install
# End of source-build specific instructions
# Postinstallation setup
$> cd /usr/local/mysql
$> mkdir mysql-files
$> chown mysql:mysql mysql-files
$> chmod 750 mysql-files
$> bin/mysqld --initialize --user=mysql
$> bin/mysqld_safe --user=mysql &
# Next command is optional
$> cp support-files/mysql.server /etc/init.d/mysql.server

下面显示了更详细的源代码构建特定说明。

注意

此处显示的过程不会为 MySQL 帐户设置任何密码。按照此过程操作后，请继续执行第 2.9 节 “安装后设置和测试”，进行安装后设置和测试。

执行预配置设置

在 Unix 上，设置拥有数据库目录并应用于运行和执行 MySQL 服务器的 mysql 用户，以及该用户所属的组。有关详细信息，请参阅创建 mysql 用户和组。然后，以 mysql 用户身份执行以下步骤，除非另有说明。

获取并解压发行版

选择要解压发行版的目录，并将位置更改到该目录。

按照第 2.1.3 节 “如何获取 MySQL”中的说明获取发行版文件。

将发行版解压到当前目录

要解压压缩的 tar 文件，如果 tar 支持 z 选项，则可以使用它解压发行版
```
$> tar zxvf mysql-VERSION.tar.gz
```
如果您的 tar 不支持 z 选项，请使用 gunzip 解压发行版，并使用 tar 解压它
```
$> gunzip < mysql-VERSION.tar.gz | tar xvf -
```
或者，CMake 可以解压发行版
```
$> cmake -E tar zxvf mysql-VERSION.tar.gz
```
要解压 Zip 存档，请使用 WinZip 或其他可以读取 .zip 文件的工具。

解压发行版文件会创建一个名为 mysql-VERSION 的目录。

配置发行版

将位置更改为解压后的发行版的顶级目录

$> cd mysql-VERSION

在源代码树之外构建，以保持树的清洁。如果顶级源代码目录在当前工作目录下名为 mysql-src，则可以在同一级别名为 build 的目录中构建。创建该目录并转到该目录

$> mkdir bld
$> cd bld

配置构建目录。最小配置命令不包含覆盖配置默认值的选项

$> cmake ../mysql-src

构建目录不需要位于源代码树之外。例如，您可以在顶级源代码树下名为 build 的目录中构建。为此，以 mysql-src 作为当前工作目录，创建目录 build，然后转到该目录

$> mkdir build
$> cd build

配置构建目录。最小配置命令不包含覆盖配置默认值的选项

$> cmake ..

如果您在同一级别有多个源代码树（例如，要构建多个版本的 MySQL），则第二种策略可能更有利。第一种策略将所有构建目录放在同一级别，这要求您为每个目录选择一个唯一名称。使用第二种策略，您可以在每个源代码树中使用相同的名称作为构建目录。以下说明假设使用第二种策略。

在 Windows 上，指定开发环境。例如，以下命令分别配置 32 位或 64 位构建的 MySQL

$> cmake .. -G "Visual Studio 12 2013"

$> cmake .. -G "Visual Studio 12 2013 Win64"

在 macOS 上，要使用 Xcode IDE，请执行以下操作

$> cmake .. -G Xcode

当您运行 Cmake 时，您可能希望在命令行中添加选项。以下是一些示例

-DBUILD_CONFIG=mysql_release：使用 Oracle 用于生成官方 MySQL 版本的二进制发行版的相同构建选项配置源代码。
-DCMAKE_INSTALL_PREFIX=dir_name：配置发行版以安装在特定位置。
-DCPACK_MONOLITHIC_INSTALL=1：使 make package 生成单个安装文件，而不是多个文件。
-DWITH_DEBUG=1：构建包含调试支持的发行版。

有关选项的更完整列表，请参阅第 2.8.7 节 “MySQL 源配置选项”。

要列出配置选项，请使用以下命令之一

$> cmake .. -L   # overview

$> cmake .. -LH  # overview with help text

$> cmake .. -LAH # all params with help text

$> ccmake ..     # interactive display

如果 CMake 失败，您可能需要使用不同的选项再次运行它以重新配置。如果您确实重新配置，请注意以下事项

如果在之前运行过 CMake 之后再次运行它，它可能会使用在其先前调用期间收集的信息。此信息存储在 CMakeCache.txt 中。当 CMake 启动时，它会查找该文件并在该文件存在时读取其内容，前提是假设该信息仍然正确。当您重新配置时，该假设无效。
每次运行 CMake 时，都必须再次运行 make 才能重新编译。但是，您可能希望先从以前的版本中删除旧的目标文件，因为它们是使用不同的配置选项编译的。

为防止使用旧的目标文件或配置信息，请在 Unix 上的构建目录中运行以下命令，然后再运行 CMake

$> make clean
$> rm CMakeCache.txt

或者，在 Windows 上

$> devenv MySQL.sln /clean
$> del CMakeCache.txt

在MySQL 社区 Slack 上提问之前，请查看 CMakeFiles 目录中的文件以获取有关故障的有用信息。要提交错误报告，请使用第 1.6 节 “如何报告错误或问题” 中的说明。

构建发行版

在 Unix 上

$> make
$> make VERBOSE=1

第二个命令设置 VERBOSE 以显示每个已编译源的命令。

在使用 GNU make 并且已将其安装为 gmake 的系统上，请改用 gmake。

在 Windows 上

$> devenv MySQL.sln /build RelWithDebInfo

如果您已进入编译阶段，但发行版未构建，请参阅第 2.8.8 节 “处理编译 MySQL 问题”，以获取帮助。如果这不能解决问题，请使用第 1.6 节 “如何报告错误或问题”中给出的说明将其输入到我们的错误数据库中。如果您安装了所需工具的最新版本，并且它们在尝试处理我们的配置文件时崩溃，也请报告。但是，如果您收到 command not found 错误或类似的所需工具问题，请勿报告。相反，请确保已安装所有必需的工具，并且您的 PATH 变量设置正确，以便您的 shell 可以找到它们。

安装发行版

在 Unix 上

$> make install

这会将文件安装在配置的安装目录下（默认情况下为 /usr/local/mysql）。您可能需要以 root 身份运行该命令。

要在特定目录中安装，请向命令行添加 DESTDIR 参数

$> make install DESTDIR="/opt/mysql"

或者，生成您可以在任意位置安装的安装包文件

$> make package

此操作会生成一个或多个 .tar.gz 文件，可以像通用的二进制发行包一样安装这些文件。请参阅第 2.2 节 “使用通用二进制文件在 Unix/Linux 上安装 MySQL”。如果您使用 -DCPACK_MONOLITHIC_INSTALL=1 运行 CMake，则该操作会生成一个文件。否则，它会生成多个文件。

在 Windows 上，生成数据目录，然后创建 .zip 存档安装包

$> devenv MySQL.sln /build RelWithDebInfo /project initial_database
$> devenv MySQL.sln /build RelWithDebInfo /project package

您可以在任意位置安装生成的 .zip 存档。请参阅第 2.3.3 节 “配置：手动”。

执行安装后设置

安装过程的其余部分包括设置配置文件、创建核心数据库以及启动 MySQL 服务器。有关说明，请参阅第 2.9 节 “安装后设置和测试”。

注意

最初，MySQL 授权表中列出的帐户没有密码。启动服务器后，您应该使用第 2.9 节 “安装后设置和测试”中的说明为它们设置密码。