本节列出了可以运行MySQL的操作系统。

我们使用GNU Autoconf，因此将MySQL移植到所有使用Posix线程和C++编译器的现代系统是可能的。(要求服务器支持线程。如果只是编译客户端代码，则只需要C++编译器)。我们主要在Linux(SuSE和Red Hat)、FreeBSD和Sun Solaris(版本8和9)上使用并开发本软件。

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

·         有原生线程的AIX 4.x和5.x。请参见2.12.5.3节，“IBM-AIX注意事项”。

·         Amiga。

·         包括MIT-pthreads包的BSDI 2.x。请参见2.12.4.4节，“BSD/OS 2.x版注意事项”。

·         有原生线程的BSDI3.0,3.1和4.x。请参见2.12.4.4节，“BSD/OS 2.x版注意事项”。

·         有原生线程的Digital Unix 4.x。请参见2.12.5.5节，“Alpha-DEC-UNIX(Tru64)版注意事项”.。

·         包括MIT-pthreads包的FreeBSD 2.x。请参见2.12.4.1节，“FreeBSD注意事项”。

·         有原生线程的FreeBSD 3.x和4.x。请参见2.12.4.1节，“FreeBSD注意事项”。

·         有LinuxThreads的FreeBSD 4.x。请参见2.12.4.1节，“FreeBSD注意事项”。

·         有DCE线程或MIT-pthreads包的HP-UX 10.20。请参见2.12.5.1节，“HP-UX 10.20版注意事项”。

·         有原生线程的HP-UX 11.x。请参见2.12.5.2节，“HP-UX 11.x版注意事项”。

·         有LinuxThreads 0.7.1+或glibc 2.0.7+，适合各种CPU的Linux 2.0+。请参见2.12.1节，“Linux注意事项”。

·         Mac OS X。请参见2.12.2节，“Mac OS X注意事项”。

·         NetBSD 1.3/1.4 Intel和NetBSD 1.3 Alpha(需要GNU make)。请参见2.12.4.2节，“NetBSD注意事项”。

·         Novell NetWare 6.0。请参见2.6节，“在NetWare中安装MySQL”。

·         有原生线程的OpenBSD > 2.5。包括MIT-pthreads包的OpenBSD < 2.5。请参见2.12.4.3节，“OpenBSD 2.5版注意事项”。

·         OS/2 Warp 3, FixPack 29和OS/2 Warp 4, FixPack 4. 参见2.12.6节，“OS/2注意事项”。

·         有最新FSU Pthreads移植包的SCO OpenServer 5.0.X。请参见2.12.5.8节，“SCO UNIX和OpenServer 5.0.x版注意事项”。

·         SCO UnixWare 7.1.x。请参见2.12.5.9节，“SCO UnixWare 7.1.x和OpenUNIX 8.0.0版注意事项”。

·         SCO Openserver 6.0.x。请参见2.12.5.10节，“SCO OpenServer 6.0.x版注意事项”。

·         有原生线程的SGI Irix 6.x。请参见2.12.5.7节，“SGI Irix注意事项”。

·         SPARC和x86上有原生线程的Solaris 2.5和以上版本。请参见2.12.3节，“Solaris注意事项”。

·         包括MIT-pthreads包的SunOS 4.x。请参见2.12.3节，“Solaris注意事项”。

·         Tru64 Unix。请参见2.12.5.5节，“Alpha-DEC-UNIX(Tru64)版注意事项”。

·         Windows 9x、Me、NT、2000、XP和2003。请参见2.3节，“在Windows上安装MySQL”。

并非所有支持的平台同等适合运行MySQL。根据以下因素确定某个平台适合高负荷关键任务MySQL服务器的程度：

·         线程库的稳定性。可能某个平台的反应不错，但MySQL的稳定性取决于它所调用的线程库，不管其它部分是否完善。

·         内核和线程库利用均衡多处理器(SMP)系统的能力。换句话说，当进程创建一个线程时，应允许线程运行原进程所运行CPU之外的其它处理器。

·         内核和线程库运行在短范围频繁获取和释放互斥体而不需要过多地交换内容的多个线程的能力。如果执行pthread_mutex_lock()时产生的CPU时间太短，则会严重影响MySQL。如果不关注该问题，增加过多的CPU实际会降低MySQL的速度。

·         常规文件系统的稳定性和性能。

·         如果数据库表很大，文件系统处理大文件的能力和处理效率。

·         我们在该平台上使用MySQL AB的经验水平。如果我们熟悉一个平台，我们可以对具体平台进行优化并固定编译时间。我们还可以提供建议如何更好地为MySQL配置系统。

·         我们在类似配置下所完成的内部测试的数量。

·         在同一平台类似配置下成功运行MySQL的用户数。如果该数字很高，则说明遇到具体平台问题的几率要小得多。

根据前面的标准，允许MySQL的最好的平台是x86,安装SuSE Linux，使用2.4或2.6内核，和ReiserFS(或类似Linux分发版)和安装了 Solaris(2.7-9)的SPARC。FreeBSD排第三位，但我们真正希望一旦线程库得到改进，它也可以提高排名。从某一观点我们还希望提高其它MySQL目前正在上面编译、允许的平台的排名，但稳定性和性能上可以要求不同等级。这需要我们与MySQL所依赖的操作系统和库组件开发人员共同努力。如果你对改进某个组件感兴趣，可能影响其开发，需要更多的关于MySQL如何能运行得更好的说明，请向我们的MySQL internals发送邮件。请参见1.7.1.1节，“The MySQL邮件列表”。

请注意前面的对比并不是说一个操作系统总体上比另一个操作系统要好。我们只是讨论选择一个OS来专门运行MySQL。记住了这一点，如果考虑更多的因素，对比结果可能会不同。在某些情况下，一个OS比另一个OS好的原因只是我们已经为具体平台做出了更多的努力来进行测试和优化。我们只是陈述我们的观点帮助你选择运行MySQL的平台。

要想在Windows中运行MySQL，你需要：

·         32位Windows操作系统，例如9x、Me、NT、2000、XP或Windows Server 2003。

基于Windows NT的操作系统(NT，2000,XP，2003)，将MySQL服务器做为服务来运行。强烈建议使用基于Windows NT的操作系统。请参见2.3.12节，“以Windows服务方式启动MySQL”。

·         TCP/IP协议支持。

·         Windows版本MySQL二进制分发版，可以从http：//dev.mysql.com/下载/下载。请参见2.1.3节，“怎样获得MySQL”。

注释：如果你从FTP下载分发版，我们建议使用充分的FTP客户端以保证续传，避免下载过程中文件被破坏。

·         可以读取 .zip文件的工具，以解压分发文件。

·         硬盘上有足够的空间保证根据你的需求来解包、安装和创建数据库(一般建议至少有200兆字节)。

你还可以有以下可选需求：

·         如果你计划通过ODBC连接MySQL服务器，你还需要一个连接器/ODBC驱动程序。请参见26.1节，“MySQL Connector/ODBC”。

·         如果表需要占用的空间大于4GB，则在NTFS或更新的文件系统上安装MySQL。当创建表时不要忘记使用MAX_ROWS和 AVG_ROW_LENGTH。请参见13.1.5节，“CREATE TABLE语法”。

在Windows中安装MySQL时，有3种MySQL 5.1安装软件包可供选择：

·         基本安装：该安装软件包的文件名类似于mysql-essential-5.1.2-alpha-win32.msi，包含在Windows中安装MySQL所需要的最少的文件，包括配置向导。该安装软件包不包括可选组件，例如嵌入式服务器和基准套件。

·         完全安装：该安装软件包的文件名类似于mysql-5.1.2-alpha-win32.zip，包含在Windows中安装MySQL所需要的全部文件，包括配置向导。该安装软件包包括可选组件，例如嵌入式服务器和基准套件。

·         非自动安装文件：该安装软件包的文件名类似于mysql-noinstall-5.1.2-alpha-win32.zip，包含完整安装包中的全部文件，只是不包括配置向导。该安装软件包不包括自动安装器，必须手动安装和配置。

对于大多数用户，建议选择基本安装。

你的选择会影响你后面必须遵从的安装过程。如果你选择基本安装或完全安装，参见2.3.3节，“用自动安装器安装MySQL”。如果你选择非自动安装MySQL，参见2.3.6节，“通过非安装Zip文件安装MySQL”。

想使用非自动安装包的用户可以使用本节的指令手动安装MySQL。从Zip文档安装MySQL的过程为：

1.    将文档提取到期望的安装目录中。

2.    创建一个选项文件。

3.    选择MySQL服务器类型。

4.    启动MySQL服务器。

5.    使默认用户账户安全。

下面一节描述了该过程。

要想手动安装MySQL，其步骤为：

1.    如果你从以前的版本升级，开始升级过程前请参阅2.3.15节，“在Windows下升级MySQL”。

2.    如果你使用基于Windows NT的操作系统，例如Windows NT、Windows 2000、Windows XP或Windows Server 2003,确保登录的用户名具有管理员权限。

3.    选择安装位置。传统安装中MySQL服务器安装到C：\mysql，MySQL Installation Wizard（安装帮助）将MySQL安装到C:\Program Files\MySQL。如果你不想将MySQL安装到C：\mysql，你必须在启动过程或在选项文件中指定安装目录的路径。请参见2.3.8节，“创建选项文件”。

4.    使用zip文件工具，将安装文件提取到选定的安装位置。使用某些工具，可以将文档提取到选择的安装位置的文件夹中。在这种情况下，你可以将子文件夹中的内容移动到选择的安装位置。

C：\> echo %WINDIR%

[mysqld]

# set basedir to your installation path

basedir=E:/mysql

# set datadir to the location of your data directory

datadir=E:/mydata/data

[mysqld]

# set basedir to your installation path

basedir=E:\\mysql

# set datadir to the location of your data directory

datadir=E:\\mydata\\data

下面的表显示了Windows下可用的MySQL 5.1服务器：

已经对所有前面的二进制进行了优化以适用现代Intel处理器，但是应当工作在Intel i386-类或更高的处理器上。

所有Windows MySQL 5.1服务器支持数据库目录符号链接。

MySQL支持所有Windows平台的TCP/IP。mysqld-nt和mysql-max-nt服务器支持Windows NT、2000、XP和2003的命名管道。然而，在所有平台下默认使用TCP/IP。(在许多Windows配置中，命名管道比TCP/IP慢）。

命名管道在以下条件下使用：

·         如果使用--enable-named-pipe选项启动服务器，则启用了命名管道。需要明确使用该选项，因为当使用命名管道关闭MySQL服务器时，某些用户会遇到问题。

·         只有mysqld-nt或mysqld-max-nt服务器，并且服务器运行在支持命名管道的Windows版本(NT、2000、XP、2003)，才能够使用命名管道连接。

·         这些服务器可以运行在Windows 98 或Me中，但是必须安装TCP/IP协议；此时不可以使用命名管道连接。

·         这些服务器不能在Windows 95中运行。

注释：参考手册中的大多数例子使用mysqld做为服务器名。如果你选择使用不同的服务器，例如mysqld-nt，则在相应例子中的命令中进行相应的替换。

本节中的信息主要适用选择NoinstallMySQL安装版本，或想要手动配置和测试MySQL而不用GUI工具的情况。

在Windows 95,98,或Me中，MySQL客户端总使用TCP/IP连接服务器。(这样允许网络中的所有机器连接MySQL服务器）。因此，在启动MySQL之前，你必须确保机器支持TCP/IP。可以从Windows CD-ROM中找到TCP/IP。

请注意如果使用旧版本的Windows 95(例如，OSR2)，很可能你使用了旧的Winsock包；MySQL需要Winsock 2。可以从http://www.microsoft.com/获得最新的Winsock。Windows 98包含新的Winsock 2库，因此不需要更新库。

在基于NT的系统中，例如 Windows NT、2000、XP或2003,客户端可以有两个选择。可以使用TCP/IP，如果服务器支持命名管道连接，也可以使用命名管道。要想使MySQL使用Windows NT 4中的TCP/IP,你必须安装服务pack 3(或更新的补丁)。

如果用--shared-memory选项启动，Windows版MySQL还支持共享内存连接。客户端可以通过--protocol=memory选项通过共享内存进行连接。

关于运行哪个服务器二进制的信息，参见2.3.9节，“选择MySQL服务器类型”。

本节对MySQL服务器启动进行了概述。下面章节详细说明了从命令行或Windows 服务启动MySQL服务器的具体信息。

这些章节的例子假定MySQL安装到默认位置C:\Program Files\MySQL\MySQL Server 5.1。如果你将MySQL安装到了其它位置，则要更改例子中的路径名。

在控制台窗口(或“DOS window”)中，最好根据命令提示进行测试。这样可以让服务器在window中容易看见的地方显示状态消息。如果配置出现错误，通过这些消息，可以更容易地识别并修复问题。

要想启动服务器，输入命令：

C：\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqld --console

支持InnoDB的服务器启动时，你应当能看见下面的消息：

InnoDB: The first specified datafile c:\ibdata\ibdata1 did not exist:

InnoDB: a new database to be created！

InnoDB: Setting file c:\ibdata\ibdata1 size to 209715200

InnoDB: Database physically writes the file full: wait...

InnoDB: Log file c:\iblogs\ib_logfile0 did not exist: new to be created

InnoDB: Setting log file c:\iblogs\ib_logfile0 size to 31457280

InnoDB: Log file c:\iblogs\ib_logfile1 did not exist: new to be created

InnoDB: Setting log file c:\iblogs\ib_logfile1 size to 31457280

InnoDB: Log file c:\iblogs\ib_logfile2 did not exist: new to be created

InnoDB: Setting log file c:\iblogs\ib_logfile2 size to 31457280

InnoDB: Doublewrite buffer not found: creating new

InnoDB: Doublewrite buffer created

InnoDB: creating foreign key constraint system tables

InnoDB: foreign key constraint system tables created

011024 10:58:25  InnoDB: Started

服务器完成启动序列后，你应当能看见下述内容，表示服务器准备好，可以进行客户端连接：

mysqld: ready for connections

Version: '5.1.2-alpha'  socket: ''  port: 3306

服务器继续向控制台写入诊断输出。你可以打开新的控制台窗口运行客户端程序。

如果省略--console选项，服务器向数据目录(默认为C:\Program Files\MySQL\MySQL Server 5.1\data)中的错误日志写入诊断输出。错误日志文件的扩展名为.err。

注释：MySQL授权表中的账户一开始没有密码。服务器启动后，你应当根据2.9节，“安装后的设置和测试”中的说明设置密码。

可以从命令行手动启动MySQL服务器。可以在任何版本的Windows中实现。

要想从命令行启动mysqld服务器，你应当启动控制台窗口(或“DOS window”)并输入命令：

C：\> C:\Program Files\MySQL\MySQL Server 5.0\bin\mysqld

根据系统中MySQL安装位置的不同，前面的例子中使用的路径也不同。

在非NT版本的Windows中，在后台启动mysqld。也就是，服务器启动后，你应当可以看见后面的命令提示。如果你用该方法在Windows NT、2000、XP或2003中启动服务器，服务器则在前台运行，在服务器退出前，不会出现命令提示。因此，当服务器运行时，应当打开另一个控制台窗口来运行客户端程序。

下述命令可以停止MySQL服务器：

C：\> C:\Program Files\MySQL\MySQL Server 5.0\bin\mysqladmin -u root shutdown

该命令调用MySQL管理工具mysqladmin连接服务器并告知它关闭服务。该命令使用MySQL root用户连接，这是MySQL权限系统中的默认管理账户。请注意MySQL权限系统中的用户完全独立于Windows下的登录用户。

如果mysqld不能启动，检查错误日志看看服务器是否写入了显示问题原因的任何消息。错误日志位于C:\Program Files\MySQL\MySQL Server 5.1\data目录中。是带后缀.err的文件。还可以尝试将服务器启动为mysqld --console；此时，可以从窗口中获得一些有用的信息，可以帮助解决问题。

最后选项是用--standalone --debug启动mysqld。此时，mysqld 写入日志文件C：\mysqld.trace，应当包含mysqld不启动的原因。请参见E.1.2节，“创建跟踪文件”。

使用mysqld --verbose --help显示mysqld的所有选项。

在NT家族 (Windows NT，2000,XP，2003)中，建议将MySQL安装为Windows服务，当Windows启动、停止时，MySQL也自动启动、停止。还可以从命令行使用NET命令，或使用图形Services工具来控制AMySQL服务器。

在Windows控制面板(Windows 2000,XP和Server 2003的管理工具下面)中可以看见Services工具(Windows Service Control Manager)。建议从命令行安装活卸载服务器时关闭Services工具。这样可以防止许多错误。

安装MySQL Windows服务之前，应当使用下面的命令先停止当前正运行的服务器：

C：\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqladmin -u root shutdown

注释：如果MySQL root用户账户有密码，你需要调用命令 C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqladmin -u root -p shutdown并根据提示输入密码。

该命令调用MySQL管理工具mysqladmin，连接服务器并告知它关闭服务。该命令使用MySQL root用户连接，这是MySQL权限系统中的默认管理账户。请注意MySQL权限系统中的用户完全独立于Windows下的登录用户。

使用该命令安装服务器

C：\> mysqld --install

如果只使用服务器名安装mysqld时有问题，尝试使用全路径名来安装。例如：

C：\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqld --install

你还可以将MySQL bin目录的路径加到Windows系统PATH环境变量中：

·         右击Windows桌面上的My Computer（我的计算机）图标，选择Properties（属性）。

·         然后从出现的System Properties菜单中选择Advanced（高级）标签，然后点击Environment Variables（环境变量）按钮。

·         选择System Variables（系统变量）下面的Path（路径），然后点击Edit（编辑）按钮。将弹出Edit System Variable（编辑系统变量）对话框。

·         将光标放到标记Variable Value（变量值）处的文本的后面。(使用End键确保光标位于文本的最后)。然后输入MySQL bin目录   的完整路径(例如，C:\Program Files\MySQL\MySQL Server 5.1\bin)，请注意应使用分号将该路径与该域内的其它值隔离开。一次关闭该对话框和各个对话框，点击OK直到打开的所有对话框被关闭。你现在可以在DOS提示符下从系统的任何目录输入MySQL可执行程序名来调用MySQL可执行程序，而不必提供路径名。包括服务器、MySQL客户端和所有MySQL命令行实用程序，例如mysqladmin和mysqldump。

·         请注意在同一个机器上运行多个MySQL服务器时，不需要在Windows PATH中加入MySQL bin目录。

警告：编辑系统PATH时必须特别注意；意外删除或修改已有路径值会造成系统故障甚至瘫痪。

服务安装命令不会启动服务器。在本节后面将给出相关指令。

安装服务时，可以使用MySQL 5.1中的下面的参数：

·         可以直接在--install选项后面指定服务名。默认服务名是MySQL。

·         如果给出了服务名，后面可以跟一个选项。一般情况，应当为defaults-file=file_name，指定选项文件的名称，服务器启动时应当从中读取选项。

可以使用单个选项代替--defaults-file，但是不提倡这样做。--defaults-file更加灵活一些，因为你可以将多个服务器启动选项放入命名的选项文件中。

·         可以在服务名后面指定一个--local-service选项。这样服务器运行时使用LocalService Windows账户，只具有有限的系统权限。该账户只适用于Windows XP或更新版本。如果服务名后面同时跟有--defaults-file和--local-service，二者可以按任何顺序排放。

对于Windows MySQL服务器，根据下面规则确定服务器使用的服务名和选项文件：

·         如果在服务安装命令中，没有在--install选项后面指定了服务名或使用默认服务名(MySQL)，服务器则使用MySQL服务名并从标准选项文件的[mysqld]组读取选项。

·         如果在服务安装命令中，在--install选项后面指定的服务名不是默认服务名(MySQL)。则从具有相同服务名的组中读取选项，并从标准选项文件读取选项。

服务器还从标准选项文件的[mysqld]组读取选项。你可以使用[mysqld]组中的选项用于所有MySQL 服务，还可以使用具有相同服务名的组，用于该服务名所对应的服务器。

·         如果在服务安装命令中，在服务名后面指定了--defaults-file选项，服务器只从命名文件的[mysqld]组中读取选项，忽略标准选项文件。

对于更复杂的例子可以考虑使用命令：

C：\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqld --install MySQL --defaults-file=C:\my-opts.cnf

该命令中，--install选项后面给出了默认服务名(MySQL)。如果未给出--defaults-file选项，该命令可以让服务器从标准选项文件的[mysqld]组中读数。由于提供了--defaults-file选项，服务器只从命名文件的[mysqld]组读取选项。

还可以在启动MySQL服务之前，在Windows Services工具中指定启动参数选项。

MySQL服务器安装为服务后，Windows启动时自动启动服务。还可以从Services工具直接启动服务，或使用命令NET START MySQL。NET命令忽略大小写。

做为服务运行时，mysqld不能访问控制台窗口，因此看不见任何消息。如果mysqld未启动，检查错误日志看看服务器是否写入了显示问题原因的任何消息。错误日志位于MySQL数据目录中(例如，C:\Program Files\MySQL\MySQL Server 5.1\data)，是带后缀.err的文件。

如果MySQL服务器安装为服务，并且服务正运行，Windows关闭时自动停止服务。还可以通过Services工具、NET STOP MySQL命令或 mysqladmin shutdown命令手动停止服务器。

如果不想在引导过程中自动启动服务，还可以将服务设置为手动启动模式。实现的方法是使用--install-manual选项而非--install选项：

C：\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqld --install-manual

要想卸载服务器，如果服务正运行则应首先使用命令NET STOP MYSQL停止服务。然后使用--remove选项卸载服务：

C：\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqld --remove

如果mysqld不是服务，可以从命令行启动它。详细说明参见2.3.11节，“从Windows命令行启动MySQL”。

如果在安装过程中遇到问题，请参阅2.3.14节，“在Windows环境下对MySQL安装的故障诊断与排除”。

C:\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqlshow

C:\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqlshow -u root mysql

C:\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqladmin version status proc

C:\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysql test

首次安装、运行MySQL时，你可能会遇到一些错误，使MySQL服务器不能启动。本节的目的是帮助你诊断并纠正这些错误。

解决服务器问题时你的第一资料是错误日志。MySQL服务器使用错误日志来记录服务器不能启动的信息。错误日志位于my.ini文件指定的数据目录中。默认数据目录位于C:\Program Files\MySQL\MySQL Server 5.1\dat。请参见5.11.1节，“错误日志”。

另一个错误相关信息源是MySQL服务启动时控制台上显示的消息。将mysqld安装为服务后，从命令行通过NET START mysql命令来查看MySQL服务启动相关的错误消息。请参见2.3.12节，“以Windows服务方式启动MySQL”。

下面距离说明了首次安装并启动MySQL服务时会遇到的最常见的错误消息：

·                System error 1067 has occurred.

·                Fatal error: Can't open privilege tables: Table 'mysql.host' doesn't exist

·         当MySQL服务器找不到MySQL权限数据库或关键文件时会出现这些消息。当MySQL基或数据目录没有安装在默认位置(C：\mysql和 C:\Program Files\MySQL\MySQL Server 5.1\data)，而是安装到其它位置时通常会遇到该问题。

发生该问题的一种情况是对MySQL进行升级或安装到了新位置，但是没有对配置文件进行更新以对应新的安装位置。此外还可能是新旧配置文件冲突，当升级MySQL时，一定要删除或重新命名旧的配置文件。

如果你没有将MySQL安装到C:\Program Files\MySQL\MySQL Server 5.1目录下，而是安装到了其它目录下，你需要通过使用配置(my.ini)文件让MySQL服务器知道安装目录。my.ini文件应位于Windows目录下，典型为C：\WINNT或C：\WINDOWS。可以在命令提示符下输入下面的命令从WINDIR环境变量值中确定确切位置：

C：\> echo %WINDIR%

可以通过文本编辑器（例如记事本）来创建并修改选项文件。例如，如果MySQL安装在E：\mysql下，数据目录在D:\MySQLdata，你可以创建选项文件并设置[mysqld]来指定basedir和datadir参数的值：

[mysqld]

# set basedir to your installation path

basedir=E:/mysql

# set datadir to the location of your data directory

datadir=D:/MySQLdata

请注意应使用(正)斜线而不是反斜线在选项文件中指定Windows路径名。如果使用反斜线，则必须使用双斜线：

[mysqld]

# set basedir to your installation path

basedir=C:\\Program Files\\MySQL\\MySQL Server 5.1

# set datadir to the location of your data directory

datadir=D:\\MySQLdata

如果在MySQL配置文件中更改datadir值，在重新启动MySQL服务器之前，必须移动已有MySQL数据目录中的内容。

参见2.3.8节，“创建选项文件”。

·                Error: Cannot create Windows service for MySql. Error: 0

·         当你没有事先停止并卸载已有MySQL服务，并且使用MySQL Configuration Wizard（配置向导）重新安装或升级MySQL时，会遇到该问题。发生的原因是，当配置向导试图安装服务时，它发现已经有一个同名的服务。

解决该问题的一个方案是使用配置向导时选择mysql之外的其它服务名。这样可以正确安装新服务，但保留了原来的服务。但是这样不好，最好是卸掉不再使用的旧服务。

要想永远卸掉旧的MySQL服务，通过管理权限用户在命令行执行下面的命令：

C:\>sc delete mysql

[SC] DeleteService SUCCESS

如果Windows版本中没有sc工具，可以从 http://www.microsoft.com/windows2000/techinfo/reskit/tools/existing/delsrv-o.asp 下载delsrv工具并使用delsrvMySQL语法。

本节列出了在Windows中升级MySQL应采取的步骤。

1.    进行升级前你应先备份当前的MySQL安装。请参见5.9.1节，“数据库备份”。

2.    从http://dev.mysql.com/downloads/下载最新Windows版MySQL。

3.    升级MySQL前，必须停止服务器。

如果服务器安装为服务，必须在命令提示符下在命令行中用下面的命令停止服务：

C：\> NET STOP MYSQL

如果MySQL服务器不是服务，使用下面的命令停止服务器：

C：\> C:\Program Files\MySQL\MySQL Server 5.1\bin\mysqladmin -u root shutdown

4.    当从以前至的4.1.5版本升级到MySQL 5.1时,或从Zip文件安装的MySQL升级到MySQL Installation Wizard（安装帮助）安装的MySQL时，你必须手动卸载前面安装的MySQL服务。

要想卸载MySQL服务，使用下面的命令：

C：\> C:\mysql\bin\mysqld --remove

如果你不想卸载已有的服务，MySQL Installation Wizard（安装帮助）则不会正确安装新的MySQL服务。

5.    如果你使用MySQL Installation Wizard（安装帮助），按照2.3.4节，“使用MySQL安装向导”的描述来启动帮助。

6.    如果用Zip文件安装MySQL，应提取文件。你可以覆盖已有的MySQL安装(通常位于C：\mysql)，或将它安装到其它目录，例如 C：\mysql4。建议覆盖原有的安装。

7.    重新启动服务器。如果你运行MySQL服务，则使用NET START MySQL，还可以直接调用mysqld。

8.    关于在Windows之外的操作系统升级MySQL的详细信息，请参阅2.10节，“升级MySQL”。

9.    如果遇到错误，参见 2.3.14节，“在Windows环境下对MySQL安装的故障诊断与排除”。

已经证明，Windows版MySQL很稳定。Windows版MySQL的功能与相应的Unix版相同，只有以下例外：

·         Windows 95和线程

Windows 95创建一个线程时大约需要200字节的主内存。MySQL的每个连接都会创建一个新线程，因此如果你的服务器正处理许多连接，你不应当在Windows 95中运行mysqld。

·         有限的端口数目

Windows系统有大约4,000个端口供客户端连接，某个端口的连接关闭后，在能够重新利用该端口前，需要2至4分钟。在客户端频繁连接并从服务器上断开时，在可以重新使用关闭的端口前，有可能用完了所有可用的端口。如果发生这种情况，MySQL服务器不会响应，即使它仍在运行。请注意机器上运行的其它应用程序也可以使用端口，此时可供MySQL使用的端口数要少。

详细信息参见http://support.microsoft.com/default.aspx?scid=kb;en-us;196271 。

·         并行读

MySQL依靠pread()和pwrite()系统调用来同时使用INSERT和SELECT。目前我们使用互斥来竞争pread()和pwrite()。我们将来想用虚拟接口替换文件级接口，因此要想更快，我们可以在NT、2000和XP上使用readfile()/writefile()接口。目前MySQL 5.1可以打开的文件的限制数目为2,048,意味着在Windows NT，2000,XP和2003上可以运行的并行线程不如Unix上多。

·         阻塞读

MySQL为每个连接使用阻塞读取，如果启用了命名管道连接，其含义如下：

o        连接不会在8小时后自动断开，而在Unix版MySQL中会发生。

o        如果连接被挂起，不杀掉MySQL则不会将其中断。

o        mysqladmin kill不会杀掉睡眠中的连接。

o        只要有睡眠连接，mysqladmin shutdown不会中断。

我们计划在将来修复该问题。

·         ALTER TABLE

执行ALTER TABLE语句时，将该表锁定不让其它线程使用。在Windows中，你不能删除正被另一个线程使用的文件。在将来，我们会找出办法解决该问题。

·         DROP TABLE

在Windows中对一个被MERGE表应用的表执行DROP TABLE不会实现，因为MERGE处理器将表从MySQL上层映射隐藏起来。由于Windows不允许删除打开的文件，必须在删除表之前首先清空所有MERGE表(使用FLUSH TABLES)或删掉MERGE表。

·         DATA DIRECTORY and INDEX DIRECTORY

在Windows中将忽略DATA DIRECTORY和INDEX DIRECTORY选项，因为Windows不支持符号连接。在具有非功能realpath()调用的系统中，这些选项也被忽略。

·         DROP DATABASE

你不能删掉正被线程使用的数据库。

·         从Task Manager（任务管理器）杀掉MySQL

你不能从Task Manager（任务管理求）或使用Windows 95的shutdown工具来杀掉MySQL。你必须通过mysqladmin shutdown停止它。

·         大小写名

由于Windows对文件名大小写不敏感。因此在Windows中MySQL数据库名和表名对大小写也不敏感。唯一的限制是在同一个语句中，必须同时使用大写或小写指定数据库名和表名。请参见9.2.2节，“识别符大小写敏感性”。

·         ‘\’路径名间隔符

Windows中的路径名用‘\’符间隔开，在MySQL中还是转义字符。如果你使用LOAD DATA INFILE或SELECT ... INTO OUTFILE，用‘/’符使用Unix-类文件名：

mysql> LOAD DATA INFILE 'C:/tmp/skr.txt' INTO TABLE skr;

mysql> SELECT * INTO OUTFILE 'C:/tmp/skr.txt' FROM skr;

你还可以使用双‘\’符：

mysql> LOAD DATA INFILE 'C:\\tmp\\skr.txt' INTO TABLE skr;

mysql> SELECT * INTO OUTFILE 'C:\\tmp\\skr.txt' FROM skr;

·         管道问题。

管道不能在Windows命令行提示符下可靠地工作。如果管道包括字符^Z/CHAR(24)，Windows认为遇到了文件末尾并中断程序。

这主要是按照如下所示使用二进制日志的主要问题：

C：\>mysqlbinlog binary-log-name | mysql --user=root

如果使用日志时出现问题，怀疑是由于^Z / CHAR(24)字符，你可以使用下面的程序：

C:\> mysqlbinlog binary-log-file --result-file=/tmp/bin.sql

C:\> mysql --user=root --execute "source /tmp/bin.sql"

后面的命令还可以用来可靠读取任何包含二进制数据的SQL文件。

·         Access denied for user错误

如果你试图运行MySQL客户端程序来连接同一机器上运行的服务器，但是遇到错误Access denied for user 'some-user'@'unknown' to database 'mysql'，这意味着MySQL不能正确识别你的主机名。

要解决该问题，你应当创建一个名为\windows\hosts包含下面信息的文件：

127.0.0.1       localhost

这儿有一些公开问题，提供给想要帮助我们改进Windows中的MySQL的人们：

·         增加宏来使用Windows提供的更快的线程安全增/减方法。

你必须执行的安装MySQL源码分发版的基本命令是：

shell> groupadd mysql

shell> useradd -g mysql mysql

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

shell> cd mysql-VERSION

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

shell> make

shell> make install

shell> cp support-files/my-medium.cnf /etc/my.cnf

shell> cd /usr/local/mysql

shell> bin/mysql_install_db --user=mysql

shell> chown -R root  .

shell> chown -R mysql var

shell> chgrp -R mysql .

shell> bin/mysqld_safe --user=mysql &

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

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

这样你制作一个可以安装的二进制RPM。对于旧版本的RPM，你可能需要替换用rpm替换命令rpmbuild。

注释：该过程不为任何MySQL账户设置密码。完成下面的过程后，根据2.9节，“安装后的设置和测试”进行安装后的设置和测试。

以下是安装MySQL源码分发版的更详细的描述：

1.    为mysqld增加一个登录用户和组：

2.            shell> groupadd mysql

3.            shell> useradd -g mysql mysql

这些命令将增加MySQL组和 MySQL用户。不同版本的Unix中，useradd 和groupadd的语法可能会稍有不同。还可以称为adduser和addgroup。

你可能会将这些用户和组命名为mysql之外的名称。如果是这样，在下面的步骤中替换为相应的名称。

4.    挑选一个你想解开分发包的目录，进入该目录。

5.    从2.1.3节，“怎样获得MySQL”中列出的站点之一获得一个分发文件。

6.    在当前目录下解包分发版：

7.            shell> gunzip < /path/to/mysql-VERSION.tar.gz | tar xvf -

该命令创建mysql-VERSION 目录。

使用GNU tar，则不再需要gunzip。你可以用下面的命令来解包和提取分发：

shell> tar zxvf /path/to/mysql-VERSION-OS.tar.gz

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

9.            shell> cd  mysql-VERSION

请注意目前必须从顶级目录配置和构建MySQL。你不能在其它目录中构建。

10.配置发布版并且编译：

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

12.        shell> make

当你运行configure时，你可能想要指定一些选项，运行./configure --help得到一个选项列表。2.8.2节，“典型配置选项”讨论一些很有用的选项。

如果configure失败，你将向MySQL邮件目录发送包含你认为能帮你解决该问题的包含“config.log”中所有行的邮件，也要包括configure的最后几行输出。用mysqlbug脚本邮寄错误报告。请参见1.7.1.3节，“如何通报缺陷和问题”。

如果编译失败，参见2.8.4节，“处理MySQL编译问题”寻求帮助。

13.安装分发版：

14.        shell> make install

如果你想要设置一个选项文件，使用support-files目录中的一个作为模板。例如：

shell> cp support-files/my-medium.cnf /etc/my.cnf

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

如果想要配置为支持InnoDB表，应当编辑/etc/my.cnf文件，去掉innodb_...开始选项行前面的#符，并将选项值改为你想要的。请参见4.3.2节，“使用选项文件”和15.2.3节，“InnoDB配置”。

15.进入安装目录：

16.        shell> cd /usr/local/mysql

17.如果还没有安装的MySQL，必须创建MySQL授权表：

18.        shell> bin/mysql_install_db --user=mysql

如果用root运行命令，应当使用--user选项。选项的值应与你在第一步为运行服务器所创建的登录账户相同。如果用该用户登录来运行命令，可以省略--user选项。

用mysql_install_db创建MySQL授权表后，需要手动重新启动服务器

19.将程序二进制的所有权改为root，数据目录的所有权改为你运行mysqld的用户。如果位于安装目录(/usr/local/mysql)下，命令应为：

20.        shell> chown -R root  .

21.        shell> chown -R mysql var

22.        shell> chgrp -R mysql .

第一个命令将文件的所有属性改为root用户。第二个命令将数据目录的所有属性改为mysql用户。第三个命令将组属性改为mysql组。

23.如果你喜欢在引导机器时自动启动MySQL，你可以拷贝support-files/mysql.server文件到你系统有启动文件的地方。更多的信息可以在support-files/mysql.server脚本中和2.9.2.2节，“自动启动和停止MySQL”中找到。

24.如果安装了DBI和DBD::mysql Perl模块，可以使用bin/mysql_setpermission脚本增加新账户。关于说明，参见2.13节，“Perl安装注意事项”。

在所有东西被安装以后，你应当使用该命令初始化并且测试你的分发版：

shell> /usr/local/mysql/bin/mysqld_safe --user=mysql &

如果这个命令提示mysqld daemon ended并马上失败，那么你能在数据目录中的文件“hostname'.err”找到一些信息。

关于mysqld_safe的详细信息参见5.1.3节，“mysqld_safe：MySQL服务器启动脚本”。

注释：MySQL授权表中的账户开始没有密码。启动服务器后，你应当使用2.9节，“安装后的设置和测试”中的说明来设置密码。

configure脚本给你一个很大的控制权来控制如何配置MySQL源码分发版。一般使用configure命令行的选项来进行。你也可以用某些环境变量作用于configure。请参见附录F：环境变量。要查看configure支持的选择列表，可以运行命令：

shell> ./configure --help

• 如果只编译MySQL客户端库和客户端程序而不是服务器，使用--without-server选项：
• shell> ./configure --without-server

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

·         如果你想要构建嵌入式MySQL库 (libmysqld.a),你应当使用--with-embedded-server选项。

• 如果你不想要位于“/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。编译完MySQL后，可以通过选项文件更改这些选项。请参见4.3.2节，“使用选项文件”。

• 如果你正在使用Unix并且你想要MySQL的套接字位于 默认位置以外的某个地方(通常在目录“/tmp”或“/var/run”，使用象这样的configure的命令：
• shell> ./configure\-- with-unix-socket-
• path=/usr/local/mysql/tmp/mysql.sock

注意给出的文件名必须是一个绝对路径。你还可以在以后使用MySQL选项文件更改mysql.sock的位置。请参见A.4.5节，“如何保护或更改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++。即使你安装了这些库，这样也很好，因为过去使用MySQL时，它们的部分版本会出现一些奇怪的问题。

下面列出了一些经常使用的编译器和环境变量设定值。

o        gcc 2.7.2：

o                     CC=gcc CXX=gcc CXXFLAGS="-O3 -felide-constructors"

o        egcs 1.0.3a：

o                     CC=gcc CXX=gcc CXXFLAGS="-O3 -felide-constructors \

o                     -fno-exceptions -fno-rtti"

o        gcc 2.95.2：

o                     CFLAGS="-O3 -mpentiumpro" CXX=gcc CXXFLAGS="-O3 -mpentiumpro \

o                     -felide-constructors -fno-exceptions -fno-rtti"

o        pgcc 2.90.29 或更新版：

o                     CFLAGS="-O3 -mpentiumpro -mstack-align-double" CXX=gcc \

o                     CXXFLAGS="-O3 -mpentiumpro -mstack-align-double \

o                     -felide-constructors -fno- exceptions -fno-rtti"

在大多数情况，在configure行使用前面列出的选项并加入下面的选项，可以得到合理的优化的MySQL二进制：

--prefix=/usr/local/mysql --enable-assembler \

--with-mysqld-ldflags=-all-static

换句话说，对于所有最近的gcc版，整个configure行应为：

CFLAGS="-O3 -mpentiumpro" CXX=gcc CXXFLAGS="-O3 -mpentiumpro \

-felide-constructors -fno- exceptions -fno-rtti" ./ configure \

--prefix=/usr/local/mysql --enable-assembler \

--with-mysqld-ldflags=-all-static

我们在MySQL网址http://www.mysql.com/提供的二进制均已经编译过并进行了优化，对于大多数用户应当比较完善。请参见2.1.2.5节，“MySQL AB编译的MySQL二进制版本”。其中有一些配置设定值，可以选用来构建更快的二进制，但是只适用高级用户。请参见7.5.4节，“编译和链接怎样影响MySQL的速度”。

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

• 默认地，MySQL使用latin1(cp1252)字符集。为了改变 默认设置，使用--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或win1251ukr。请参见5.10.1节，“数据和排序用字符集”。

可以指定默认校对规则。MySQL默认使用latin1_swedish_ci校对规则。要想更改，使用--with-collation选项：

shell> ./configure --with-collation=COLLATION

要想更改字符集和校对规则，要同时使用--with-charset和--with-collation选项。 校对规则必须是字符集的合法校对规则。(使用SHOW COLLATION语句来确定每个字符集使用哪个校对规则)。

如果想在服务器和客户端之间变换字符，你应该看一下SET OPTION CHARACTER SET命令。请参见13.5.3节，“SET语法”。

警告：如果你在创建了任何数据库表之后改变字符集，你将必须对每个表运行myisamchk -r -q --set-character-set=charset，否则索引可能不正确地排序。（如果安装了MySQL，创建一些表，然后重新配置MySQL使用一个不同的字符集并且重新安装它，这时就可能发生这种情况。）

通过configure选项--with-extra-charsets=LIST，你可以定义在服务器中再定义哪些字符集。LIST 指下面任何一项：

o        空格间隔的一系列字符集名

o        complex -，以包括不能动态装载的所有字符集

o        all –，以将所有字符集包括进二进制

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

这导致包含一个安全的内存分配器，能发现一些错误和并提供关于正在发生的事情的输出。请参见E.1节，“调试MySQL服务器”。

·         如果客户端程序使用线程，还必须使用--enable-thread-safe-client配置选项来编译线程安全版的MySQL客户端库。将创建一个libmysqlclient_r库，可以用来连接应用程序线程。请参见25.2.15节，“如何生成线程式客户端”。

·         可以使用--with-big-tables选项构建支持大数据库表的MySQL。

该选项使变量用来将表行数保存到unsigned long long中而不是unsigned long。结果是允许表有大约1.844E+19 ((2³²)²)行而不是2³² (~4.295E+09) 行。在以前，要完成该功能必须手动将-DBIG_TABLES传递给编译器。

注意：如果你想帮助我们测试新代码，应当阅读本节。如果你只想在系统上安装并运行MySQL，应当使用标准发布分发版(二进制或源码分发版)。

要想获得我们的最新开发源码树，应使用说明：

1.    从http://www.bitmover.com/bk-client.shar下载BitKeeper免费客户端。

2.    在Unix上安装免费客户端：

3.            shell> sh bk-client.shar

4.            shell> cd bk_client-1.1

5.            shell> make all

6.            shell> PATH=$PWD:$PATH

在Windows上的安装方法：

·         从http://cygwin.com下载并安装Cygwin。

·         确保gcc和make已经安装到Cygwin。可以用which gcc和 which make命令进行测试。如果任何一个没有安装，运行 Cygwin安装包管理器，选择gcc、make并安装。

·         在Cygwin中，运行：

·                      shell> sh bk-client.shar

·                      shell> cd bk_client-1.1

然后编辑Makefile并将行s $(CC) $(CFLAGS) -o sfio -lz sfio.c更改为：

$(CC) $(CFLAGS) -o sfio sfio.c -lz

现在运行make命令并设置路径：

shell> make all

shell> PATH=$PWD:$PATH

7.    安装BitKeeper免费客户端后，首先进入工作目录，然后使用以下命令在本地复制MySQL 5.1：

8.            shell> sfioball -r+ bk://mysql.bkbits.net/mysql-5.1 mysql-5.1

一般情况，你不需要自己构建文档，因为我们已经在http://dev.mysql.com/doc/提供了许多格式。我们每天更新你可以下载的格式(HTML、PDF等)，因此你没有必要从MySQLdoc树中的DocBook XML基本格式来创建。如果你想要复制文档库，使用下面的命令：

shell> sfioball -r+ bk://mysql.bkbits.net/mysqldoc mysqldoc

在前面的例子中，在当前目录的MySQL-5.1/子目录中设置源码树。

如果你位于防火墙后面，只能初始化HTTP连接，还可以通过HTTP使用BitKeeper。

如果需要使用代理服务器，设置环境变量http_proxy指向代理：

shell> export http_proxy="http://your.proxy.server:8080/"

当复制库时用http://替换bk：//。例如：

shell> sfioball -r+ http://mysql.bkbits.net/mysql-5.1 mysql-5.1

下载源码树可能需要一段时间，取决于连接速度。请耐心等待。

9.    要想更新本地MySQL 5.1库复制，使用命令：

10.        shell> update bk://mysql.bkbits.net/mysql-5.1

11.你需要GNU make、autoconf 2.58 (或更新版)、automake 1.8、libtool 1.5和m4来运行后面的命令。尽管许多操作系统安装了make，很可能编译失败，出现许多奇怪的缺陷消息。因此，强烈建议你使用GNU make(有时名为gmake)。

幸运的是，大量的操作系统预装了GNU工具链或提供了可安装软件包。你可以随时从下面的地址下载：

·         http://www.gnu.org/software/autoconf/

·         http://www.gnu.org/software/automake/

·         http://www.gnu.org/software/libtool/

·         http://www.gnu.org/software/m4/

·         http://www.gnu.org/software/make/

要想配置MySQL 5.1,你还需要GNU bison 1.75或更新版。旧版本的bison会报告错误：

sql_yacc.yy:#####: fatal error: maximum table size (32767) exceeded

注释：实际上并没有超出最大表空间；这是由旧版本的bison的缺陷造成的该问题。

下面的例子显示了配置源码树需要的典型命令。第一个cd命令将位置改为树的顶级目录；用相应目录名替换MySQL-5.1。

shell> cd mysql-5.1

shell> bk -r edit

shell> aclocal; autoheader

shell> libtoolize --automake --force

shell> automake --force --add-missing; autoconf

shell> (cd innobase; aclocal; autoheader; autoconf; automake)

shell> (cd bdb/dist; sh s_all)

shell> ./configure  # Add your favorite options here

shell> make

对于下面的命令，可以使用BUILD/autorun.sh作为快捷方式：

shell> aclocal; autoheader

shell> libtoolize --automake --force

shell> automake --force --add-missing; autoconf

shell> (cd innobase; aclocal; autoheader; autoconf; automake)

shell> (cd bdb/dist; sh s_all)

使用将目录改为innobase和bdb/dist目录的命令行来配置InnoDB和 Berkeley DB (BDB)储存引擎。如果你不需要InnoDB或BDB支持，你可以省略这些命令行。

如果在该阶段你遇到一些奇怪的错误，请确认你是否已经安装了 libtool。

标准配置脚本位于BUILD/子目录。你会发现使用BUILD/compile-pentium-debug脚本比使用前面的外壳命令要方便得多。要想在不同的架构上编译，可以修改脚本，即去掉Pentium相关标志。

12.构建完成后，运行make install。在产品机器上运行时应注意；该命令会覆盖你正使用的版本。如果你安装了另一个MySQL，我们建议你使用 与你的产品服务器上不同的--prefix、--with-tcp-port和--unix-socket-path选项值来运行./configure。

13.强制运行新安装和尝试会破坏新功能。应先运行make test。请参见27.1.2节，“MySQL测试套件”。

14.如果你已经进入make阶段而分发版不编译，请报告给我们的http://bugs.mysql.com/中的缺陷数据库。如果你已经安装了GNU工具的最新版本，如果视图处理配置文件时出错，请报告给我们。但是，如果你执行aclocal并且遇到command not found error或类似问题，不要报告给我们。而是应确保安装了所有必要的工具，并且PATH变量设置正确，保证外壳命令可以找到它们。

15.复制完库(sfioball)获得源码树后，你应当定期更新库(update)。

16.你可以检查树的更改史，浏览源码树中的BK/ ChangeLog文件并查看ChangeSet描述找到所有不同点。要想检查特殊的更改集，必须使用sfioball命令提取源码树的两次不同的修订，然后使用外部diff命令来比较。如果你看到有疑问的奇怪的不同之处或代码，一定要向MySQL internals邮件列表发送邮件。请参见1.7.1.1节，“The MySQL邮件列表”。并且，如果你有更好的思想，请向上述地址发送邮件。

17.BitKeeper免费客户端预装了源码。免费客户端可用的唯一文档是源码本身。

你还可以在线浏览更改集、注释和源码。要想浏览MySQL 5.1的相关信息，请到http://mysql.bkbits.net:8080/mysql-5.1。

所有MySQL程序在Solaris或Linux上使用gcc编译并且没有任何警告。在其它系统上，由于系统包含文件的差别可能会发生警告。对于使用MIT-pthreads时发生的警告。请参见2.8.5节，“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++。然而，我们建议不要在MySQL中使用libg++或libstdc++，因为只会增加mysqld二进制空间而不会带来任何好处。部分版本的库在过去曾经给用户带来一些奇怪的问题。

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

·                making all in mit-pthreads

·                make: Fatal error in reader: Makefile, line 18:

·                Badly formed macro assignment

或：

make: file `Makefile' line 18: Must be a separator (:

或：

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=-O3

·                shell> CXX=gcc

·                shell> CXXFLAGS=-O3

·                shell> export CC CFLAGS CXX CXXFLAGS

对于已经知道在不同系统上有用的标志定义列表，参见2.1.2.5节，“MySQL AB编译的MySQL二进制版本”。

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

·                client/libmysql.c:273: parse error before `__attribute__'

gcc2.8.1已知可以工作，但是我们推荐使用gcc 2.95.2或egcs 1.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)并使用它。

·         在Debian Linux 3.0上, 如果你编译的MySQL 5.1要支持Berkeley DB，需要安装gawk代替默认的mawk。

·         如果你需要调试mysqld或MySQL客户端，运行configure，使用--with-debug选项，然后重新编译并且将客户端程序链接到新的客户端库。请参见E.2节，“调试MySQL客户端”。

·         如果你在Linux(例如，SuSE Linux 8.1或Red Hat Linux 7.3)下遇到类似下面的编译错误：

·                libmysql.c:1329: warning: passing arg 5 of `gethostbyname_r' from

·                incompatible pointer type

·                libmysql.c:1329: too few arguments to function `gethostbyname_r'

·                libmysql.c:1329: warning: assignment makes pointer from integer

·                without a cast

·                make[2]: *** [libmysql.lo] Error 1

默认情况，configure脚本试图使用g++ GNU C++编译器来确定正确的参数。如果未安装g++，将会产生错误的结果。有两种方法可以解决该问题：

o        确保安装了GNU C++ g++。在某些Linux分发版上，需要安装的软件包叫做gpp；在其它分发版上名为gcc-c++。

o        使用gcc作为C++ 编译器，将CXX环境变量设置为gcc：

o                     export CXX="gcc"

请注意之后需要再次运行configure。

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

在Linux上，应该不使用MIT-pthreads而是安装LinuxThreads！参见2.12.1节，“Linux注意事项”。

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

MIT-pthreads不是MySQL 5.1源码分发版的一部分。如果你需要该安装包，需要单独从http://www.mysql.com/Downloads/Contrib/pthreads-1_60_beta6-mysql.tar.gz下载。

下载后，将源文件提取到MySQL源码目录的顶级目录。将创建新的mit-pthreads子目录。

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

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

·         决定是否使用MIT-pthreads的检查仅在处理服务器代码的配置过程期间发生。如果已经用--without-server配置了分发版并只构造客户端代码，客户端将不知道MIT-pthreads是否正在被使用并且是否使用 默认的Unix套接字连接。因为在某些平台上Unix套接字文件不能在MIT-pthreads下面工作，这意味着当你运行客户端程序时，你需要使用-h或--host。

·         当使用MIT-pthreads编译MySQL时，因为性能原因，系统锁定 默认为禁止使用。你可以用--external-locking选项告诉服务器使用系统锁定。只是在相同数据文件上运行两个MySQL服务器时采需要，因此不推荐。

• 有时pthreadbind()命令不能绑定一个套接字但没有任何错误消息(至少在Solaris上)，结果是所有到服务器的连接均失败。例如：
• shell> mysqladmin version
• mysqladmin: connect to server at '' failed;
• error: 'Can't connect to mysql server on localhost (146)'

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

• 使用MIT-pthreads，不能用SIGINT（break)中断sleep()系统调用。这只有在运行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上工作。（这不需要，但是可能某些人会感兴趣。）

下面的说明描述了如何在Windows下从5.1版源码构建MySQL二进制。说明用于从包含最新开发源码的标准源码分发版或从BitKeeper树来构建二进制。

注释：本文档中的说明严格限于在Windows下从最新源码分发版或从BitKeeper树来测试MySQL的用户。作为产品使用时，MySQL AB不建议使用你自己从源码构建的MySQL服务器。一般情况，最好使用MySQL AB预编译的对性能进行优化的适用Windows的MySQL二进制分发版。安装二进制分发版的说明参见2.3节，“在Windows上安装MySQL”。

要想在Windows中从源码构建MySQL，Windows系统中应有下面的编译器和资源：

·         Visual Studio 2003编译器系统(VC++ 7.0)。

·         3到5GB的硬盘空间。

·         Windows 2000或更高版本。

确切的系统需求见：http://msdn.microsoft.com/vstudio/productinfo/sysreqs/default.aspx

还需要适用Windows的MySQL源码分发版。有两种方法可以获得MySQL 5.1 源码分发版：

1.    获得MySQL AB打包的源码分发版软件包。预打包的源码分发版可从 http://dev.mysql.com/downloads/获得。

2.    你可以用最新BitKeeper开发源码树构建源码分发版。如果你计划构建，必须在Unix系统中创建安装软件包，并将它转移到Windows系统。(这样操作的理由是部分配置和构建步骤需要只能在Unix中工作的工具）。BitKeeper方法需要：

·         运行Unix或类似Unix的系统，例如Linux。

·         该系统上安装的BitKeeper 3.0。关于如何下载和安装BitKeeper的说明参见2.8.3节，“从开发源码树安装”。

如果你使用Windows源码分发版，你可以直接跳到2.8.6.1节，“使用VC++构建MySQL”。要想从BitKeeper树构建，继续2.8.6.2节，“从最新的开发源码创建Windows源码安装包”。

如果你发现某些组件不能按预料的工作，或者你有好的建议可以改进目前的在Windows中的构建过程，请向win32邮件列表发送消息。请参见1.7.1.1节，“The MySQL邮件列表”。

2.            C:\> mkdir C:\mysql

3.            C:\> mkdir C:\mysql\bin

4.            C:\> mkdir C:\mysql\data

5.            C:\> mkdir C:\mysql\share

6.            C:\> mkdir C:\mysql\scripts

C：\> mkdir C：\mysql\include

C：\> mkdir C：\mysql\lib

C：\> mkdir C：\mysql\lib\debug

C：\> mkdir C：\mysql\lib\opt

C：\> mkdir C：\mysql\sql-bench

8.            C:\> cd \workdir

9.            C:\workdir> copy client_release\*.exe C:\mysql\bin

10.        C:\workdir> copy client_debug\mysqld.exe C:\mysql\bin\mysqld-debug.exe

11.        C:\workdir> xcopy scripts\*.* C:\mysql\scripts /E

12.        C:\workdir> xcopy share\*.* C:\mysql\share /E

C:\workdir> copy lib_debug\mysqlclient.lib C:\mysql\lib\debug

C:\workdir> copy lib_debug\libmysql.* C:\mysql\lib\debug

C:\workdir> copy lib_debug\zlib.* C:\mysql\lib\debug

C:\workdir> copy lib_release\mysqlclient.lib C:\mysql\lib\opt

C:\workdir> copy lib_release\libmysql.* C:\mysql\lib\opt

C:\workdir> copy lib_release\zlib.* C:\mysql\lib\opt

C:\workdir> copy include\*.h C:\mysql\include

C:\workdir> copy libmysql\libmysql.def C:\mysql\include

C:\workdir> xcopy sql-bench\*.* C:\mysql\bench /E

3.            shell> ./BUILD/compile-pentium-max

5.            shell> ./scripts/make_win_src_distribution

在源码文件中，应当在MySQL.h之前包括my_global.h：

#include <my_global.h>

#include <mysql.h>

my_global.h包括你在Windows中编译程序所需要的Windows兼容文件(例如 windows.h)。

可以将代码连接到动态libmysql.lib库，它只是一个包装器以便根据需要装载libmysql.dll，或连接静态mysqlclient.lib库。

MySQL客户端库编译为线程库，因此你应当将代码编译为多线程。

在Windows中，不需要创建数据目录和授权表。MySQL Windows分发版包括在数据目录下的MySQL数据库中的一套预初始化的账户的 授权表。不要运行Unix中使用的mysql_install_db脚本。但是，如果你没有使用Windows Installation Wizard（安装帮助）来安装MySQL，应当为账户指定密码。请参见2.3.4.1节，“前言”。在2.9.3节，“使初始MySQL账户安全”。

设置密码前，你可能想要运行一些客户端程序来确保你能够连接服务器，并且操作正确。确保服务器在运行(参见2.3.10节，“首次启动服务器”)，然后发出下面的命令来验证你可以从服务器获取信息。输出应当类似于：

C:\> C:\mysql\bin\mysqlshow

+-----------+

| Databases |

+-----------+

| mysql     |

| test      |

+-----------+

C:\> C:\mysql\bin\mysqlshow mysql

Database: mysql

+--------------+

|    Tables    |

+--------------+

| columns_priv |

| db           |

| func         |

| host         |

| tables_priv  |

| user         |

+--------------+