MySQL中文参考手册---4 安装MySQL

  来源：

---

本章描述怎样获得并安装MySQL：

• 对于你能从其获得MySQL的列表，见。
• 要了解支持哪些，见。
• 可获得MySQL的多个版本，以二进制代码和源代码形式分发。为了确定你应该使用的分发的版本和类型，见。
• 针对二进制代码和源代码分发的安装指令在和讲述。每套指令均包含一个关于你可能涉及的系统特定问题的部分。
• 为安装后期过程，见。不管你是用一个二进制代码还是源代码分发来安装MySQL，这些过程均适用。

检查获得当前版本的信息和下载指令。

然而，TcX的因特网链接不是很快的；我们更希望让你从下列镜象站点之一进行真正的下载。

请向报告不存在的或过时的镜像站点。

欧洲：

• 奥地利 [ 维也纳技术大学 ]
• 保加利亚 [ Naturella ]
• 克罗地亚 [ HULK ]
• 捷克共和国 [ 在Brno的Masaryk大学 ]
• 捷克共和国 [ ]
• 丹麦 [ Borsen ]
• 丹麦 [ SunSITE ]
• 爱沙尼亚 [ OKinteractive ]
• 法国 [ minet ]WWW
• 芬兰 [ EUnet ]
• 芬兰 [ clinet ]
• 德国 [ 波恩大学, 波恩 ]
• 德国 [ Wolfenbuettel ]
• 德国 [ Staufen ]
• 德国 [ Cable & Wireless ]
• 希腊 [ NTUA , 雅典]
• Island [ GM ]
• 意大利 [ Teta Srl ]
• 爱尔兰 [ Ireland On-Line/Dublin ]
• 波兰 [ Sunsite ]
• 葡萄牙 [ lerianet ]
• 俄国 [ DirectNet ]
• 俄国 [ IZHCOM ]
• 俄国 [ Scientific Center/Chernogolovka ]
• 罗马尼亚 [ Timisoara ]
• 罗马尼亚 [ Bucharest ]
• 西班牙 [ MasterD ]
• 瑞典 [ Sunet ]
• 瑞士 [ Sunsite ]
• 英国 [ Omnipotent/UK ]
• 英国 [ PLiG/UK ]
• 英国 [ SunSITE ]
• 乌克兰 [ PACO ]

北美洲：

• 加拿大 [ Tryc ]
• 加拿大 [ Cyberus ]
• 美国 [ Hurricane Electric/San Jose ]
• 美国 [ Circle Net/North Carolina ]
• 美国 [ Gina net/Florida ]
• 美国 [ pingzero/Los Angeles ]
• 美国 [ 威斯康星大学 / 威斯康星]
• 美国 [ DIGEX ]

南美洲：

• 巴西 [ Matrix ]
• 智利 [ Vision ]

亚洲：

• 中国 [ Freecode ]
• 中国 [ Netfirm ]
• 朝鲜 [ KREONet ]
• 日本 [ Soft Agency ]
• 日本 [ Nagoya Syouka University ]
• 新加坡 [ HJC ]
• 台湾 [ HT ]

澳洲：

• 澳洲 [ AARNet/Queensland ]
• 澳洲 [ Tas ]
• 澳洲 [ Blue Planet/Melbourne ]
• 澳洲 [ ITworks Consulting/Victoria ]

非洲：

• 南非 [ Mweb/ ]
• 南非 [ The Internet Solution/Johannesburg ]

我们使用 GNU Autoconf，因此将MySQL移植到所有使用 Posix 线程和一个 C++ 编译器的现代系统是可能的。(仅仅为了编译客户代码，只需要一个 C++ 编译器而不是线程)。我们主要在Sun Solaris(版本 2.5 & 2.6)上使用并开发软件本身，而RedHat Linux 5.0 居其次。

MySQL已经被报告在下列操作系统/线程包的组合上成功地编译。注意，对很多操作系统，原生的线程支持仅工作于最新的版本。

• 有原生线程的AIX 4.x
• 包括 MIT-pthreads 包的BSDI 2.x
• 有原生线程的BSDI 3.0、3.1和4.x
• 有原生线程的DEC UNIX 4.x
• 包括MIT-pthreads包的FreeBSD 2.x
• 有原生程的FreeBSD 3.x
• 包括 MIT-pthreads 包的 HP-UX 10.20
• 有原生线程的 HP-UX 11.x 。
• 有 LinuxThreads 0.7.1 的 Linux 2.0 + 或glibc2.0.7
• MacOS X 服务器
• NetBSD 1.3/1.4 Intel 和 NetBSD 1.3 Alpha ( 需要 GNU make）
• 包括 MIT-pthreads 包的 OpenBSD 2.x
• OS/2 Wrap 3、FixPack 29和OS/2 Wrap 4、FixPack 4
• 有原生线程的SGI Irix 6.x
• SPARC和x86上有原生线程的Solaris 2.5、2.6和2.7
• 包括 MIT-pthreads 包的SunOS 4.x
• 有最新FSU Pthreads移植包的SCO OpenServer
• SCO UnixWare 7.0.1
• Tru64 Unix
• Win95、Win98和NT(只有拥有MySQL许可证或MySQL电子邮件支持的可得到最新版本)。对那些在购买之前想测试的人，我们以共享软件方式发布了（一个较老的版本）。

首先要作出决策，你是否想要使用最新的开发版本或最终的稳定版本：

• 通常, 如果你是第一次开始使用MySQL或尝试移植它到一些还没有二进制分发系统上，我们推荐使用开发版本(当前 3.22.x)。这是因为通常在开发版本中没用真正严重的错误，并且你能容易用你的机器上的crash-me和基准测试套件来测试它。见。
• 否则，如果你正在运行一个老的系统并且想要升级，但是又不想要用3.22冒险，你应该升级到3.21.33。我们已经试着仅修复致命错误，并且对那个版本进行更小的相对安全的改动。

要做的第二项决策是你是否想要使用源代码分发或二进制分发：

• 如果你想在一个已经存在一个最新二进制分发的平台上运行MySQL，就用它。通常，这比一个源代码分发更容易安装。
• 如果你想要阅读(或修改)构成MySQL的C和C++代码，你应该拿到源代码分发。源代码总是最终的手册。源代码分发也比二进制的分发包含更多的测试和实例。

MySQL的命名机制使用由3个数字和一个后缀组成的版本号。例如，一个像mysql-3.21.17-beta的版本号这样解释：

• 第1数字(3)描述文件格式。所有版本3的发行都有相同的文件格式。当一个版本4出现时，每个数据库表都将必须转换到新格式(当然，为此有一个很不错的工具)。
• 第2数字(21)是发行级别。通常有2种选择。一个是发部/稳定分支(当前为21)而其它是开发分支(当前22)。通常两者都是稳定的，但是开发版本可能有毛病，新功能缺乏文档或可能在某些系统上编译失败。
• 第3个数字(17)是在此发行级别的版本号，这随每个新分发递增。通常你需要你已经选择的发行(release)的最新版本(version)。
• 后缀(beta)显示发行的稳定性级别。可能的后缀有：
  • alpha 表明发行包含大量未被100%测试的新代码。已知的错误(通常没有)应该在新闻小节被记录。见。在大多数 alpha 版本也有新的命令和扩展。
  • beta 意味着所有的新代码被测试了，没有增加重要的新特征，应该没有已知的错误。
  • gamma 是一个发行了一段时间的beta版本，看起来应该运行正常。这就是很多其他公司称为一个发布的东西。
  • 如果没有后缀，这意味着该版本已经在很多地方运行一段时间了，而且没有非平台特定的错误报告。这就是我们称为一个稳定版本的东西。

MySQL所有版本都经过我们的标准测试和基准测试运行，以保证他们可相当安全地使用。因为标准测试不断扩充以检测以前发现的错误，测试套件一直在改进之中。

注意，所有版本都至少已经用下列套件进行了测试：

一个内部测试套件

这是一个客户生产系统的一部分。它可能有很多几百个兆字节数据的数据库表。

MySQL基准测试套件

它运行一定的常用查询。它也是一个测试，检测最新的优化处理是否真的使代码更快。见。

crash-me测试

这尝试决定数据库支持什么功能和它的能力与限制是什么。见。

其他测试是在内部的生产环境中使用最新MySQL版本，至少在一台机器上。我们有超过100GB的数据可用使用。

在TcX，MySQL进展的相当快，并且我们想要与其它MySQL用户分享它。当我们有一个看来其它人似乎需要的非常有用的功能时，我们就试着制作一个发行版本。

我们也尝试帮助那些需要很容易实现的功能的用户，我们也关注我们授权的用户想要什么，我们更特别关注我们的扩展电子邮件支持的客户想要什么，并且尽力帮助他们。

没有人一定要下载一个新版本，新闻小节中将告诉你新版本是否有一些你确实想要的东西。见。

当更新MySQL时，我们使用下列方针：

• 对每个小的改进，在版本字符串的最后数字增加1。当有主要的新功能或与先前版本比有较小不兼容性时，在版本字符串的第2数字增加1。当文件格式变化时，第1数字加1。
• 稳定的测试过的版本每年准备出现1-2次，但是如果发现小错误，只有错误修复的一个版本将被发行。
• 工作版本准备每1-8周出现一次。
• 对一些平台的二进制分发，主要版本由我们制作。其他人可以为其他系统制作二进制分发，但是可能不多见。
• 一旦我们并修复了小错误，我们通常使用户可以得到补丁。
• 对非紧急但烦人的错误，如果他们被发给我们，我们将使用户可以得到补丁，否则我们将集中许多错误到一个更大的补丁中。
• 在任何情况下，如果在一个发行中有一个致命错误，我们将尽快制作一个新版本。我们想其他公司也这样做。:)

当前的稳定版本是3.22；我们已经转移到3.23的积极开发中。在稳定版本中，错误仍将被修复。我们不相信一个完全冻结，因为这也留下的错误修复和“必须做”的事情。“某种程度的冻结”意味着我们可以增加小东西，它“将几乎肯定不影响已经能工作的任何东西”。

这节描述安装二进制代码和源代码分发时创建的缺省目录布局。

二进制分发通过在你选择的安装地点(典型的“/usr/local/mysql”)解压缩来安装，并且在该处创建下列目录：

目录	目录的内容
“bin”	客户程序和mysqld服务器
“data”	日志文件, 数据库
“include”	包含(头)文件
“lib”	库文件
“scripts”	mysql_install_db
“share/mysql ”	错误消息文件
“sql-bench”	基准程序

源代码分发在你并编译后进行安装。缺省地，安装步骤将文件安装在“/usr/local”下的下列子目录：

目录	目录的内容
“bin”	客户程序和脚本
“include/mysql”	包含(头)文件
“info”	Info格式的文档
“lib/mysql”	库文件
“libexec”	mysqld服务器
“share/mysql”	错误消息文件
“sql-bench”	基准程序和crash-me测试
“var”	数据库和日志文件。

在一个安装目录内，源代码安装的布局在下列方面不同于二进制安装：

• mysqld服务器被安装在“libexec”目录而不是“bin”目录内。
• 数据目录是“var”而非“data”。
• mysql_install_db被安装在“/usr/local/bin”目录而非“/usr/local/mysql/scripts”内。
• 头文件和库目录是“include/mysql”和“lib/mysql”而非“include”和“lib”。

你需要下列工具安装一个MySQL二进制分发：

• GNU gunzip解压缩分发。
• 一个适当的tar解包分发。 GNU tar已知可以。

在Linux下的另一个安装方法是使用RPM(RedHat包管理器)分发。见。

如果你碰到问题，在把问题邮寄到时，请总是使用mysqlbug，就算问题不是一个bug，mysqlbug收集系统信息，将有助于其它人解决你的问题。不使用mysqlbug，你将减少得到你问题的一个解决方案的可能性！在你解包分发后，你会在“bin”目录下找到mysqlbug。见。

你必须执行以便安装并使用一个MySQL二进制分发的基本命令是：

shell> gunzip < mysql-VERSION-OS.tar.gz |tar  xvf - 
shell> ln - s  mysql-VERSION-OS  mysql 
shell> cd mysql 
shell> scripts/mysql_install_db 
shell> bin/safe_mysqld &

如果你安装了DBI和Msql-Mysql-modulesPerl模块，你可以使用bin/mysql_setpermission脚本增加新用户。

以下是更详细的描述：

对于安装二进制分发，遵循以下步骤，然后继续到，进行安装后期的设置和测试：

1. 挑选一个你想解开分发包的目录，进入给目录。在下面的例子中，我们将分发解包在“/usr/local”下并且创建一个安装MySQL的“/usr/local/mysql”目录。（因此，下列指令假设你有权限在“/usr/local”中创建文件，如果该目录被保护，你需要以root实施安装。)
2. 从中列出的站点之一获得一个分发文件。MySQL二进制分发以压缩的tar文档提供，并且有类似“mysql-VERSION-OS.tar.gz”的名字，这里VERSION是一个数字(例如，3.21.15)，且OS表明分发能运行的操作系统类型(例如，pc-linux-gnu-i586)。
3. 解开分发并且创建立安装目录：

   shell> gunzip < mysql-VERSION-OS.tar.gz |tar  xvf - 
   shell> ln - s  mysql-VERSION-OS  mysql
   

   第一个命令创建一个名为“mysql-VERSION-OS”的目录，第二个命令生成到该目录的一个符号链接。这让你更容易地把安装目录指定为“/usr/local/mysql”。

4. 进入安装目录：

   shell> cd  mysql

   你会在mysql目录下发现几个文件和子目录，对安装目的最重要的是“bin”和“scripts”子目录。

   “bin”

   这个目录包含客户程序和服务器，你应该把这个目录的完整路径加到你的PATH环境变量，以便你的shell能正确的找到MySQL程序。

   “scripts”

   这个目录包含mysql_install_db脚本，用来初始化服务器存取权限。

5. 如果你想使用mysqlaccess而在某个非标准的地点有MySQL分发，你必须改变地点，在哪儿mysqlaccess期望找到mysql客户。编辑“bin/mysqlaccess”脚本，大约在第18行，寻找类似下面的行：

   $MYSQL = “/usr/local/bin/mysql”;　# path to mysql executable

   改变路径以反映出mysql实际存储在你系统上的地点。如果你不这样做，当你运行mysqlaccess时，你将得到一个broken pipe的错误。

6. 创造MySQL授权表(只有在你以前没安装过MySQL是必要的)：

   shell> scripts/mysql_install_db

   注意当你运行时mysql_install_db时，比版本3.22.10老的MySQL版本启动MySQL服务器。这不再是真的了！

7. 如果你想要安装对Perl DBI/DBD接口的支持，见。
8. 如果你喜欢在引导机器时自动启动MySQL，你可以拷贝support-files/mysql.server文件到你系统有启动文件的地方。更多的信息可以在support-files/mysql.server脚本中和找到。

在所有东西被解包并且安装以后，你应该初始化并且测试你的分发。

你可以用下列命令启动MySQL服务器：

shell> bin/safe_mysqld &

见。

在Linux上安装MySQL推荐的方法是使用一个RPM文件。MySQL RPM目前是在一个 RedHat 5.2 系统上建立的，但是应该能工作在支持rpm且使用glibc的其他 Linux 版本上。

如果一个RPM文件有问题，例如Sorry, the host 'xxxx' could not be looked up，见。

你可能要使用的RPM文件有：

• MySQL-VERSION.i386.rpm MySQL服务器。除非你只是想要与运行在其他机器上MySQL服务器连接，否则你将需要它。
• MySQL-client-VERSION.i386.rpm 标准MySQL客户程序。你可能总是需要安装这个包。
• MySQL-bench-VERSION.i386.rpm 测试和基准程序。需要Perl和msql-mysql-modules RPM。
• MySQL-devel-VERSION.i386.rpm 所需的库和包含文件。如果你想要编译其他MySQL客户程序, 例如Perl模块。
• MySQL-VERSION.src.rpm 包含上述所有包的源代码。它也能被用来尝试为其他硬件平台构造RPM(例如，Alpha或SPARC)。

查看一个RPM包中的所有文件：

shell> rpm - qpl  MySQL-VERSION.i386.rpm

实施一个标准的最小安装，运行这个命令：

shell> rpm -i MySQL-VERSION.i386.rpm  MySQL-client-VERSION.i386.rpm

只安装客户包：

shell> rpm -i MySQL-client-VERSION.i386.rpm

RPM将数据放在“/var/lib/mysql”里，RPM也在“/etc/rc.d/”里创建适当的入口以便在引导时自动启动服务器。（这意味着如果你以前已经安装过，在对它改变之前，你可以把你以前安装的MySQL启动文件做个拷贝，因此你不会丢失改动）。

在安装了RPM文件后，“mysqld”守护程序应该正在运行，并且现在你应该可以开始使用MySQL。见。

如果一些东西出错，可以在二进制的安装一节里找到更多的信息。见。

如果你编译你自己写的或你从第三方获得的MySQL客户程序，他们必须用link命令的-lmysqlclient选项进行链接。你可能也需要指定一个 -L 选项，告诉链接器在哪儿查找库文件。例如，如果库文件安装在“/usr/local/mysql/lib”里，在链接命令上使用 -L/usr/local/mysql/lib -lmysqlclient。

对使用MySQL头文件的客户程序，当你编译他们时，你可能需要指定一个 -I 选项(例如，-I/usr/local/mysql/include)， 使得编译器能找到头文件。

下一节说明在从一个二进制分发安装MySQL时，已经在特定的系统上观察到已发生过一些问题。

MySQL需要至少Linux 2.0。

二进制发行版用-static链接的，这意味着你一般不必担心你拥有的系统库是哪个版本。你也不必安装LinuxThreads。一个用-static链接的程序比一个动态链接程序稍大些但更快(3-5%)。然而，一个问题是你不能使用静态链接的用户定义函数(UDF)。如果你准备编写或使用UDF函数(这只对C或C++程序员)，你必须编译MySQL本身，使用动态链接。

如果你正在使用一个基于libc-的系统(而不是一个glibc2系统)，你将可能碰到二进制发行的主机名解析和getpwnam()的一些问题（这是因为glibc不幸地依赖于一些包括解析主机名和getwpent()的外部库，甚至在用-static编译时)。在这种情况下，当你运行mysql_install_db时，你可能得到下列错误信息：

sorry, the host 'xxxx' could not be looked up

或当你尝试以 --user 选项运行 mysqld 时的下列错误：

getpwnam : No such fileor directory

你能用下列方法之一解决这个问题：

• 获得一个MySQL源代码分发(一个RPM或tar分发)并且安装它。
• 执行mysql_install_db --force；这将不执行mysql_install_db里面的resolveip测试。缺点是你不能在授权表中使用主机名字；相反你必须使用IP数字(除了localhost)。如果你正在使用一个老的不支持--force的MySQL版本，你必须用编辑器删除mysql_install中的resolveip测试。
• 用su启动mysqld而不使用--user。

MySQL的Linux-Intel二进制代码和RPM发行版是为最高可能的速度而配置的。我们总是努力使用可用的最快的稳定的编译器。

MySQL的Perl支持要求Perl 5.004_03或更新。

针对HP-UX的MySQL二进制分发作为一个HP depot（仓库）或tar 文件格式分发的。为了使用depot文件，你必须运行至少HP-UX 10.x 以便访问HP的软件仓库工具。

MySQL的HP版本在运行HP-UX 10.20下的HP 9000/8xx 服务器上编译，并且使用MIT-pthreads。它已知可在这种配置下很好地工作。MySQL 3.22.26和更新版也用HP原生线程包构造。

其他可以运行的配置：

• 运行 HP-UX 10.20 + 的 HP 9000/7xx
• 运行 HP-UX 10.30 的 HP 9000/8xx

下列配置几乎肯定不能运行：

• 运行 HP-UX 10.x 的 HP 9000/7xx 或 8xx ，x < 2
• 运行 HP-UX 9.x 的 HP 9000/7xx 或 8xx

为了安装分发，使用下面的命令之一, 这里/path/to/depot是仓库文件的完整路径：

• 要安装所有东西，包括服务器、客户和开发工具：

   shell> /usr/sbin/swinstall - s  /path/to/depot  mysql.full

• 仅仅安装服务器：

  shell> /usr/sbin/swinstall - s  /path/to/depot  mysql.server

• 仅仅安装客户软件包：

  shell> /usr/sbin/swinstall - s  /path/to/depot  mysql.client

• 仅仅安装开发工具：

  shell> /usr/sbin/swinstall - s  /path/to/depot  mysql.developer

depot在“/opt/mysql”存放二进制代码和库文件并在“/var/opt/mysql”存放数据。depot也在“/sbin/init.d”和“ /sbin/rc2.d”里创建适当的入口以自动地在引导时启动服务器。显然, 这有必要以root身份来安装。

为了安装HP-UX tar分发，你必须有GNU tar的一个拷贝。

你需要下列工具构造并安装MySQL源代码：

• GNU gunzip解压缩该分发。
• 一个合适的tar解包分发。GNU tar已知可以工作。
• 一个能运行的ANSI C++编译器。gcc> = 2.8.1 、egcs> = 1.0.2 、SGI C++和SunPro C++是一些已知能工作编译器。 当使gcc用时，不需要libg++。gcc2.7.x 有一个bug，使得它可能不能编译一些完全合法的C++文件，例如“sql/sql_base.cc”。如果你仅有gcc2.7.x，你必须升级gcc才能编译MySQL。
• 一个优秀的make程序。GNU make总是被推荐且有时必须。如果你有问题，我们推荐试一试GNU make3.75或更新。

如果你遇到问题，当向邮寄问题时，请一直使用mysqlbug。就算问题不是一个bug，mysqlbug收集系统信息，将有助于其它人解决你的问题。如果不使用mysqlbug，你减少得到关你问题的一个解决方案的可能性！在你解包分发后，你会在“scripts”目录下找到mysqlbug。见。

你必须执行的安装MySQL源代码分发的基本命令是(从一个解包的tar文件)：

shell>configure
shell>make
shell>make install
shell>scripts/mysql_install_db 
shell>/usr/local/mysql/bin/safe_mysqld &

如果你从一个源代码RPM开始，那么执行如下命令。

shell> rpm -- rebuild MySQL-VERSION.src.rpm

这样你制作一个可以安装的二进制RPM。

如果你安装了DBI和Msql-Mysql-modulesPerl模块，你可以利用bin/mysql_setpermission脚本增加新用户。

以下是更详细的描述：

为了安装源代码分发，按照下列步骤，然后继续到，进行安装后期的初始化与测试。

1. 挑选一个你要在其下面解包分发的目录，并且进入该目录。
2. 从节中列出的站点之一获得一个分发文件。MySQL源代码分发以压缩的tar档案提供，并且有类似于“mysql-VERSION.tar.gz”的名字，这里的VERSION是一个类似3.23.7-alpha的数字。
3. 在当前目录下解包分发：

   shell> gunzip < mysql-VERSION.tar.gz | tar  xvf -

   这个命令创建名为“mysql-VERSION”的一个目录。

4. 进入解包分发的顶级目录：

    shell> cd  mysql-VERSION

5. 设置发行版本并且编译：

   shell>./configure--prefix=/usr/local/mysql 
   shell>make 
   

   当你运行configure时，你可能想要指定一些选项，运行./configure --help得到一张选项表。讨论一些很有用的选项。如果configure失败，你将发送包含你认为能帮你解决该问题的“config.log”的邮件，如果configure异常退出，也要包括configure的最后几行输出。用mysqlbug脚本邮寄错误报告。见。如果编译失败，见节，帮助解决很多常见问题。

6. 安装所有东西：

   shell>make install

   你可能需要root用户来运行这个命令。

7. 创造MySQL授权表(只有你以前没安装MySQL是必需的)：

   shell>scripts/mysql_install_db

   注意，在运行mysql_install_db时，那些比3.22.10旧的MySQL版本启动MySQL服务器。现在不是这样了！

8. 如果你想要安装对Perl DBI/DBD接口的支持，见。
9. 如果你想要MySQL在你引导机器时自动地启动，你可以拷贝support-files/mysql.server到你的系统中有启动文件的地方。更多的信息可以在support-files/mysql.server脚本里和找到。

在所有东西安装完以后，你应该初始化并且测试你的分发。

你可以用下列命令启动MySQL服务器，这里BINDIR是safe_mysqld被安装的目录(缺省为“/usr/local/bin”)：

shell> BINDIR/safe_mysqld &

如果这个命令提示mysqld daemon ended并马上失败，那么你能在文件“mysql-data-directory/'hostname'.err”找到一些信息。可能的原因是你已经有另外一个正在运行的mysqld服务器。见。

参见。

有时补丁出现在邮件列表上或放在MySQL FTP地点的。

为了使用来自邮件列表的一个补丁，保存补丁出现在文件的消息，进入你的MySQL源代码树的顶级目录并运行这些命令：

shell>patch - p1 rm config.cache
shell>make clean

来自FTP地点的补丁是作为普通文本文件或作为被压缩了的gzip文件分发。运用一个文本的补丁如上述邮件列表补丁，为了使用一个压缩的补丁，进入你的MySQL源代码树顶级目录并运行这些命令：

shell>gunzip rm  config.cache 
shell>make clean

在使用一个补丁以后，按照正常的源代码安装的指令，开始./configure步骤。在运行make install后，重启你的MySQL服务器。

在运行make install前，你可能需要关闭所有正在运行的服务器（使用mysqladmin shutdown)。如果一个程序的新版本替代当前正在执行的版本，一些系统不允许你安装它。

configure脚本给你一个很大的控制权来如何配置你的MySQL分发。典型地，你使用configure命令行的选项进行。你也可以用正确的环境变量作用于configure。对于一个由configure支持的选择列表，运行这个命令：

shell> ./configure -- help

一些更常用的configure选项见下面的描述：

• 只编译MySQL客户库和客户程序而不是服务器，使用--without-server选项：

  shell> ./configure --without-server

  如果你没有一个 C++ 编译器，mysql将不编译(有一个客户程序需要C++)。在这种情况下，你可以去掉configure里面测试C++编译器的代码，然后运行带有 --without-server选项的./configure。编译步骤步将仍然尝试构造mysql，但是你可以忽略任何关于“ mysql.cc ”的警告。（如果make停止，试试make -k告诉它即使出错继续剩下的构造步骤）。

• 如果你不想要位于“/usr/local/var”目录下面的日志(log)文件和数据库，使用类似于下列configure命令的一个：

  shell>./configure--prefix=/usr/local/mysql 
  shell>./configure--prefix=/usr/local --localstatedir=/usr/local/mysql/data
  

  第一个命令改变安装前缀以便任何东西被安装在“/usr/local/mysql”下面而非缺省的“/usr/local”。第二个命令保留缺省安装前缀，但是覆盖了数据库目录缺省目录(通常是“/usr/local/var”)并且把它改/usr/local/mysql/data.

• 如果你正在使用Unix并且你想要MySQL的套接字位于缺省地点以外的某个地方(通常在目录“/tmp”或“/var/run”，使用象这样的configure的命令：

  shell> ./configure -- with-unix-socket-path=/usr/local/mysql/tmp/mysql.sock

  注意给出的文件必须是一个绝对路径！

• 如果你想编译静态链接程序(例如，制作二进制分发、获得更快的速度或与解决与RedHat分发的一些)，像这样运行configure：

  shell>./configure --with-client-ldflags=-all-static --with-mysqld-ldflags=-all-static
  

• 如果你正在使用gcc并且没有安装libg++或libstdc++，你可以告诉configure使用gcc作为C++编译器：

  shell> CC=gcc  CXX=gcc  ./configure

  当你使用时gcc作为C++编译器是，它将不试图链接libg++或libstdc++。如果构造失败并且产生有关编译器或链接器的错误，不能创建共享库“libmysqlclient.so.#”(“#”是一个版本号), 你可以通过为configure指定--disable-shared选项来解决此问题。在这种情况下，configure将不构造一个共享libmysqlclient.so.#库。

• 你可以设置MySQL对于非NULL的列不使用DEFAULT列值(即，不允许列是NULL)。这导致INSERT语句产生一个错误，除非你明确地为所有要求非NULL值的列指定值。为了禁止使用缺省值，这样运行configure：

  shell> CXXFLAGS=-DDONT_USE_DEFAULT_FIELDS  ./configure

• 缺省地，MySQL使用ISO-8859-1(Latin1)字符集。为了改变缺省设置，使用--with-charset选项目：

  shell> ./configure -- with-charset=CHARSET

  CHARSET可以是big5、cp1251、cp1257、czech、danish、dec8、dos、euc_kr、gb2312 gbk、german1、hebrew、 hp8、hungarian、koi8_ru、koi8_ukr、latin1、latin2、sjis、swe7、tis620、ujis、usa7、win1251或win1251ukr之一。见。注意：如果你想要改变字符集，你必须在配置期间做make distclean！如果你想在服务器和客户之间变换字符，你应该看一下SET OPTION CHARACTER SET命令。见。警告：如果你在创建了任何数据库表之后改变字符集，你将必须对每个表运行myisamchk -r -q，否则你的索引可能不正确地排序。（如果你安装了MySQL，创建一些表，然后重新配置MySQL使用一个不同的字符集并且重新安装它，这时就可能发生这种情况。）

• 为了配置MySQL带有调试代码，使用--with-debug选项：

  shell> ./configure --with-debug

  这导致包含一个安全的内存分配器，能发现一些错误和并提供关于正在发生的事情的输出。见。

• 属于特定系统的选项可在本章特定系统的小节里找到。见。

所有MySQL程序在Solaris上使用gcc编译并且没有任何警告。在其他系统上，由于系统包含文件的差别可能会发生警告。对于使用MIT-pthreads时发生的警告，见。其他问题，检查下面的表。

许多问题的解决方案涉及重新配置。如果你确实需要重新配置，注意下列事项：

• 如果configure在它已经被运行了以后运行，它可以使用先前收集的信息。这个信息被存储在“config.cache”里面。当configure启动时，它寻找该文件而且如果它存在，假定信息仍然是正确的，读入它的内容。当你重新配置时，该假设是无效的。
• 每次你运行configure时候，你必须运行make再重新编译。然而, 你可能想要把先前构造的老的目标文件删除，因为他们使用不同的配置选项被编译。

为了防止使用旧的配置信息或目标文件，在重新运行configure前运行这些命令：

shell>rm  config.cache 
shell>make clean

另外，你可以运行make distclean。

下表描述了一些最常发生的编译MySQL的问题：

• 如果在编译“sql_yacc.cc”时，你得到如下的一个错误，你可能是存储器或交换空间溢出：

  Internal compiler error: program cc1plus got fatal signal 11
    或
  Out of virtual memory
    或
  Virtual memory exhausted
  

  该问题是gcc要求大量的内存编译带有嵌入函数(inline function)的“sql_yacc.cc”。试试以--with-low-memory选项运行configure：

  shell>./configure -- with-low-memory

  如果你正在使用gcc，该选项使得将-fno-inline加到编译行，如果你正在使用其他的编译器，则加入-O0。你应该试一试--with-low-memory选项，即使你有特别多的存储器和交换空间，而你认为不能可能运行得溢出。这个问题甚至在很慷慨的硬件配置的系统上出现，通常用--with-low-memory选项修正它。

• 缺省地，configure挑选c++作为编译器名字并用-lg++选项的GNU c++链接。如果你正在使用gcc，这个特性在配置期间导致如下问题：

  configure: error: installation or configuration problem:
  C++ compiler cannot create executables.
  

  你可能也在编译期间看到g++、libg++或libstdc++相关的问题。这些问题的一个原因是你可能没有g++，或你可能有g++但无libg++或libstdc++。看一下“config.log”文件。它应该包含你的c++编译器不能工作的原因！为了解决这些问题，你可以使用gcc作为你的C++编译器。试试设置环境变量CXX为"gcc -O3"。例如：

  shell>CXX="gcc -O3" ./configure

  它能工作，因为gcc象g++一样编译C++源代码，但缺省地它不链接libg++或libstdc++。解决这些问题的其他方法当然是安装g++、libg++和libstdc++。

• 如果你的编译以下面任何错误而失败，你必须升级make版本到GNUmake：

  making all in mit-pthreads 
  make: Fatal error in reader: Makefile, line 18: 
  Badly formed macro assignment 
  　or 
  make: file `Makefile' line 18: Must be a separator (: 
  　or 
  pthread.h: No such file or directory
  

  Solaris和FreeBSD已知make程序有问题。GNU make版本3.75已知能工作。

• 如果你想要定义你的C或C++编译器所使用的，把标志加到CFLAGS和CXXFLAGS环境变量中即可。你也能使用CC和CXX来指定编译器名字。例如：

  shell>CC=gcc 
  shell>CFLAGS=-O6 
  shell>CXX=gcc 
  shell>CXXFLAGS=-O6 
  shell>export CC  CFLAGS  CXX  CXXFLAGS
  

  对于已经知道在不同系统上有用的标志定义列表，见。

• 如果你得到象如下的一条错误消息，你需要升级你的gcc编译器：

  client/libmysql.c:273: parse error brfore '__attribute__'

  gcc2.8.1已知可以工作，但是我们推荐使用egcs1.0.3a或更新。

• 如果你在编译mysqld时显示例如下面的那些错误, configure没有正确地检测传到accept()、getsockname()或getpeername()最后参数的类型：

  cxx: Error: mysqld.cc, line 645: In this statement, the referenced
       type of the pointer value "&length" is "unsigned long", which
       is not compatible with "int".
  new_sock = accept(sock, (struct sockaddr *)&cAddr, &length);
  

  为了修正它，编辑“config.h”文件(它由configure生成)。寻找这些行：

  /* Define as the base type of the last arg to accept */
  #define SOCKET_SIZE_TYPE XXX
  

  更改XXX为size_t或int，这取决于你的操作系统。（注意：你每次运行configure都必须这样做，因为configure重新生成“config.h”。)

• “sql_yacc.cc”文件由“sql_yacc.yy”生成。通常构造过程不需要创造“sql_yacc.cc”，因为MySQL有一个已经生成的拷贝，然而，如果你确实需要再创建它，你可能碰到这个错误：

  "sql_yacc.yy", line xxx fatal: default action causes potential...
  

  这是一个你的yacc版本不完善的迹象。你可能需要安装bison（GNU 版本yacc)并使用它。

• 如果你需要调试mysqld或MySQL客户，运行configure，使用--with-debug选项，然后重新编译并且链接你客户程序到新的客户库。见。

这节描述在使用 MIT-pthreads 所涉及的一些问题。

注意：在Linux上，你应该不使用MIT-pthreads而是安装LinuxThreads！见。

如果你的系统不提供原生的线程支持，你将需要使用MIT-pthreads包构造MySQL。这包括大多数FreeBSD系统、SunOS 4.x 、Solaris 2.4和更早版本及其他，见。

• 在大多数系统上，你能通过使用configure，用--with-mit-threads选项来强迫运行MIT-pthreads：

  shell> ./configure -- with-mit-threads

  当使用MIT-pthreads时，不支持在一个非源代码目录构造，因为我们想要使我们对代码的改变减到最小。

• MIT-pthreads不支持用于实现Unix套接字的AF_UNIX协议。这意味着如果你使用MIT-pthreads进行编译，所有的链接必须使用TCP/IP进行(它有点慢)。如果在构造MySQL后，你发现你不能与本地的服务器连接，很可能是客户程序正在试图用缺省的Unix套接字与localhost连接。使用主机选择(-h或--host)明确地指定本地的主机名字，尝试做一个TCP/IP连接到mysql。
• 决定是否使用MIT-pthreads的检查仅在处理服务器代码的配置过程期间发生。如果已经用--without-server配置了分发并只构造客户代码，客户将不知道MIT-pthreads是否正在被使用并且是否使用缺省的Unix套接字连接。因为Unix套接字不能在MIT-pthreads下面工作，这意味着当你运行客户程序时，你将需要使用-h或--host。
• 当使用MIT-pthreads编译MySQL时，因为原因，系统锁定缺省为禁止使用。你可以用--use-locking选项告诉服务器使用系统锁定。
• 有时pthreadbind()命令不能绑定一个套接字但没有任何错误消息(至少在Solaris上)，结果是所有到服务器的连接均失败。例如：

  shell> mysqladmin version
  mysqladmin: connect to server at '' failed;
  error: 'Can't connect to mysql server on localhost (146)'
  

  解决它的方法是杀死mysqld服务器并且重启它。这只有当我们强迫服务器停止并马上进行重启时在发生。

• 使用MIT-pthreads，sleep()系统调用不是可中断的SIGINT（break)。这只有在你运行mysqladmin --sleep时才能注意到。你在中断起作用并且进程停止之前必须等待sleep()终止。
• 当链接时，你可能会收到这样的警告消息(至少在Solaris上)；他们可以被忽视：

  ld: warning: symbol `_iob' has differing sizes:
      (file /my/local/pthreads/lib/libpthread.a(findfp.o) value=0x4;
  file /usr/lib/libc.so value=0x140);
      /my/local/pthreads/lib/libpthread.a(findfp.o) definition taken
  ld: warning: symbol `__iob' has differing sizes:
      (file /my/local/pthreads/lib/libpthread.a(findfp.o) value=0x4;
  file /usr/lib/libc.so value=0x140);
      /my/local/pthreads/lib/libpthread.a(findfp.o) definition taken
  

• 一些其他的警告也可被忽略：

  implicit declaration of function `int strtoll(...)'
  implicit declaration of function `int strtoul(...)'
  

• 我们还没有让readline可在MIT-pthreads上工作。（这不需要，但是可能某些人有兴趣。）

Perl对MySQL的支持借助DBI/DBD客户接口而提供。见。Perl DBD/DBI客户代码要求Perl 5.004或以后版本。如果你有Perl的一个更旧的版本，接口将不能工作。

MySQL Perl支持也要求你安装了MySQL客户编程支持。如果你从RPM文件安装MySQL，客户程序在客户RPM中，但是客户编程支持在开发者RPM。确定你安装了后一个RPM 。

对于版本3.22.8，Perl支持是与主要MySQL发行版本单独分发。如果你想要安装Perl支持，你需要的文件能从获得。

Perl 分发以压缩的tar档案提供，并且有一个类似“MODULE-VERSION.tar.gz”的名字，这里MODULE是模块名字并且VERSION是版本号。你应该得到Data-Dumper、DBI和Msql-Mysql-modules分发并按此次序安装他们。安装过程显示出在下面，显示的例子针对Data-Dumper模块, 但是所有3个过程是相同的。

1. 解包分发到当前目录：

   shell> gunzip < Data-Dumper-VERSION.tar.gz | tar  xvf -

   这个命令创建的一个名为“Data-Dumper-VERSION”的目录。

2. 进入解包分发的顶级目录：

   shell> cd  Data-Dumper-VERSION

3. 构造分发并且编译所有东西：

   shell> perl Makefile.PL
   shell> make
   shell> make test
   shell> make install
   

make test命令很重要，因为它验证模块正在工作。注意：在你Msql-Mysql-modules安装期间运行该命令试验接口代码时，MySQL服务器必须正在运行，否则测试将失败。

无论何时你安装一个新版本的MySQL，重建并且重新安装Msql-Mysql-modules分发是一个好主意, 特别是如果你在升级MySQL后，观察所有异常，如你的DBI脚本核心倾倒(core dump)。

如果你没有权限在系统目录下安装Perl模块，或如果你安装本地Perl模块，下列书可以帮助你：

在标题Installing New Modules that Require Locally Installed Modules下面查找。

在 Win32 上安装 ActiveState Perl的MySQL DBD的模块, 你应该做下列步骤：

• 打开一个DOS shell。
• 如果需要，设置HTTP_proxy变量。例如, 你可以试一试：set HTTP_proxy=my.proxy.com:3128
• 启动PPM程序：C:perlbinppm.pl
• 如果你还没有这样做，安装DBI： install DBI
• 如果成功，安装DBD::mysql：

如果你不能使上述步骤工作，你应该安装MyODBC驱动程序并且通过ODBC连接MySQL服务器。

use DBI;
$dbh= DBI->connect("DBI:ODBC:$dsn","$user","$password") || 
  die "Got error $DBI::errstr when connecting to $dsnn";

MySQL Perl分发包含DBI、DBD:MySQL和DBD:ODBC。

• 从得到Win32的Perl分发。
• 在C:解压缩分发，这样你得到一个“C:PERL”目录。
• 增加目录“C:PERLBIN”到你的路径。
• 增加目录“C:PERLBINMSWin32-x86-thread”或“C:PERLBINMSWin32-x86”到你的路径。
• 在 DOS shell执行perl -v测试perl的运行。

如果 Perl 报告它不能找到../mysql/mysql.so模块，那么问题可能是该Perl不能找到共享库文件“libmysqlclient.so”。

你可用下列任何一个方法修正它这：

• 用perl Makefile.PL -static而非perl Makefile.PL编译Msql-Mysql-modules分发。
• 拷贝libmysqlclient.so到其他共享库文件所在的目录(可能是“/usr/lib”或“/lib”)。
• 在Linux上，你可以把libmysqlclient.so所在目录的路径名加到“/etc/ld.so.conf”文件中。
• 把libmysqlclient.so所在目录的路径名加到LD_RUN_PATH环境变量中。

如果你从DBD-mysql得到下列错误，你可能正在使用gcc（或使用一个旧的用gcc编译的二进制代码)：

/usr/bin/perl: can't resolve symbol '__moddi3'
/usr/bin/perl: can't resolve symbol '__divdi3'

当“mysql.so”库文件被构造时候，为链接命令加上-L/usr/lib/gcc-lib/... -lgcc(当你编译Perl客户时检查针对“mysql.so”的make输出)。-L选项应该指定“libgcc.a”在你系统上所在目录的路径名。

这个问题的另一个原因可能是Perl和MySQL都不是用gcc编译的。在这种情况下，你可以都用gcc编译以解决不匹配。

如果你想要在一个不支持动态链接(象SCO那样)的系统上使用Perl模块，你可以产生包括DBI和DBD-mysql的Perl的一个静态版本。这种运行方法是你生成一个链接了DBI代码的Perl版本并在最新的Perl上安装它，然后你使用它来构造附加链接了DBD代码的Perl版本，并且安装它。

在 SCO 上，你必须有下列环境变量设置：

shell> LD_LIBRARY_PATH=/lib:/usr/lib:/usr/local/lib:/usr/progressive/lib
或
shell> LD_LIBRARY_PATH=/usr/lib:/lib:/usr/local/lib:/usr/ccs/lib:/usr/progressive/lib:/usr/skunk/lib
shell> LIBPATH=/usr/lib:/lib:/usr/local/lib:/usr/ccs/lib:/usr/progressive/lib:/usr/skunk/lib
shell> MANPATH=scohelp:/usr/man:/usr/local1/man:/usr/local/man:/usr/skunk/man:

首先, 在DBI分发所在目录下运行下列命令，创造包括一个静态链接的Perl DBI：

shell> perl Makefile.PL LINKTYPE=static
shell> make
shell> make install
shell> make perl

然后你必须安装新的Perl。make perl的输出将显示正确的你需要执行施行安装的make的命令。在SCO上，是make -f Makefile.aperl inst_perl MAP_TARGET=perl.

接下来，在Msql-Mysql-modules分发所在目录下，使用刚才创建的Perl来创建同样包括一个静态链接的PerlDBD::mysql的另一个Perl：

shell> perl Makefile.PL LINKTYPE=static 
shell> make 
shell> make install 
shell> make perl

最后, 你应该安装这个新的Perl。而且，make perl的输出指出使用的命令。

下面的章节说明在从源代码分发安装MySQL时，发生在特定的系统上并已观察到的一些问题。

在Solaris上，甚至在你解开MySQL分发以前，你可能陷入困境！Solaris tar不能处理长文件名字，因此你在打开MySQL时，可能看到这样的一个错误：

x mysql-3.22.12-beta/bench/Results/ATIS-mysql_odbc-NT_4.0-cmp-db2,informix,ms-sql,mysql,oracle,solid,sybase, 0 bytes, 0 tape blocks
tar: directory checksum error

在这种情况下，你必须使用 GNU tar(gtar) 打开分发。你能在找到为Solaris的一个预编译的拷贝。

Sun的原生线程只工作在Solaris 2.5和更高版本上。对于2.4和更早的版本，MySQL将自动地使用 MIT-pthreads 。见。

如果你从配置得到下列错误：

checking for restartable system calls... configure: error can not run test 
programs while cross compiling

这意味着你的编译器安装有些问题！在这种情况下，你应该升级编译器到一个更新的版本。你也可以把下列行插入到config.cache文件来解决这个问题：

ac_cv_sys_restartable_syscalls=${ac_cv_sys_restartable_syscalls='no'}

如果你在一个SPARC上使用Solaris，推荐的编译器是egcs1.1.2 或更新。你能在找到它。注意：egs1.1.1 和gcc2.8.1 不能在 SPARC 上可靠地工作！

当使用时egcs1.1.2时，推荐的configure命令行是：

shell> CC=gcc CFLAGS="-O6" 
       CXX=gcc CXXFLAGS="-O6 -felide-constructors -fno-exceptions -fno-rtti" 
       ./configure --prefix=/usr/local/mysql --with-low-memory

如果你有Sun Workshop 4.2 编译器，你能这样运行configure：

CC=cc CFLAGS="-xstrconst -Xa -xO4 -native -mt" CXX=CC CXXFLAGS="-xO4 -native -noex -mt" ./configure --prefix=/usr/local/mysql

shell> CC=cc CFLAGS="-Xa -fast -xO4 -native -xstrconst -mt" 
       CXX=CC CXXFLAGS="-noex -XO4 -mt" 
       ./configure

你也可以编辑configure脚本改变该行： 

#if !defined(__STDC__) || __STDC__ != 1

为： 

#if !defined(__STDC__)

如果你使用-Xc选项打开__STDC__，Sun编译器不能用 Solaris 的“pthread.h”头文件编译。这是Sun的一个bug。

如果mysqld在运行时发出显示在下面的错误消息，你已经尝试用Sun编译器编译MySQL，没有启用多线程选择(-mt)：

libc internal error: _rmutex_unlock: rmutex not held

增加-mt到CFLAGS和CXXFLAGS并且再试一试。