|
MySQL中文参考手册
译者:晏子 (clyan@sohu.com) 主页:http://linuxdb.yeah.net
第一章, 前一章, 下一章, 最后一章,目录.
4 安装MySQL
本章描述怎样获得并安装MySQL:
* 对于你能从其获得MySQL的站点列表,见4.1 怎样获得MySQL。
* 要了解支持哪些平台,见4.2 MySQL支持的操作系统。
* 可获得MySQL的多个版本,以二进制代码和源代码形式分发。为了确定你应该使用的分发的版本和类型,见4.4 怎样和何时发布更新版本。
* 针对二进制代码和源代码分发的安装指令在4.6 安装 MySQL 二进制代码分发和4.7 安装 MySQL 源代码分发讲述。每套指令均包含一个关于你可能涉及的系统特定问题的部分。
* 为安装后期过程,见4.15 安装后期的设置与测试。不管你是用一个二进制代码还是源代码分发来安装MySQL,这些过程均适用。
4.2 MySQL 支持的操作系统
我们使用 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.21.29(一个较老的版本)。
4.3 使用MySQL哪个版本
首先要作出决策,你是否想要使用最新的开发版本或最终的稳定版本:
* 通常, 如果你是第一次开始使用MySQL或尝试移植它到一些还没有二进制分发系统上,我们推荐使用开发版本(当前 3.22.x)。这是因为通常在开发版本中没用真正严重的错误,并且你能容易用你的机器上的crash-me和基准测试套件来测试它。见10.8 使用你自己的基准测试。
* 否则,如果你正在运行一个老的系统并且想要升级,但是又不想要用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)显示发行的稳定性级别。可能的后缀有:
o alpha 表明发行包含大量未被100%测试的新代码。已知的错误(通常没有)应该在新闻小节被记录。见D MySQL 变迁的历史记录。在大多数 alpha 版本也有新的命令和扩展。
o beta 意味着所有的新代码被测试了,没有增加重要的新特征,应该没有已知的错误。
o gamma 是一个发行了一段时间的beta版本,看起来应该运行正常。这就是很多其他公司称为一个发布的东西。
o 如果没有后缀,这意味着该版本已经在很多地方运行一段时间了,而且没有非平台特定的错误报告。这就是我们称为一个稳定版本的东西。
MySQL所有版本都经过我们的标准测试和基准测试运行,以保证他们可相当安全地使用。因为标准测试不断扩充以检测以前发现的错误,测试套件一直在改进之中。
注意,所有版本都至少已经用下列套件进行了测试:
一个内部测试套件
这是一个客户生产系统的一部分。它可能有很多几百个兆字节数据的数据库表。
MySQL基准测试套件
它运行一定范围的常用查询。它也是一个测试,检测最新的优化处理是否真的使代码更快。见10.8 使用你自己的基准测试。
crash-me测试
这尝试决定数据库支持什么功能和它的能力与限制是什么。见10.8 使用你的自己基准测试。
其他测试是在内部的生产环境中使用最新MySQL版本,至少在一台机器上。我们有超过100GB的数据可用使用。
4.4 怎样和何时发布更新版本
在TcX,MySQL进展的相当快,并且我们想要与其它MySQL用户分享它。当我们有一个看来其它人似乎需要的非常有用的功能时,我们就试着制作一个发行版本。
我们也尝试帮助那些需要很容易实现的功能的用户,我们也关注我们授权的用户想要什么,我们更特别关注我们的扩展电子邮件支持的客户想要什么,并且尽力帮助他们。
没有人一定要下载一个新版本,新闻小节中将告诉你新版本是否有一些你确实想要的东西。见D MySQL 变迁的历史记录。
当更新MySQL时,我们使用下列方针:
* 对每个小的改进,在版本字符串的最后数字增加1。当有主要的新功能或与先前版本比有较小不兼容性时,在版本字符串的第2数字增加1。当文件格式变化时,第1数字加1。
* 稳定的测试过的版本每年准备出现1-2次,但是如果发现小错误,只有错误修复的一个版本将被发行。
* 工作版本准备每1-8周出现一次。
* 对一些平台的二进制分发,主要版本由我们制作。其他人可以为其他系统制作二进制分发,但是可能不多见。
* 一旦我们找到并修复了小错误,我们通常使用户可以得到补丁。
* 对非紧急但烦人的错误,如果他们被发给我们,我们将使用户可以得到补丁,否则我们将集中许多错误到一个更大的补丁中。
* 在任何情况下,如果在一个发行中有一个致命错误,我们将尽快制作一个新版本。我们想其他公司也这样做。
当前的稳定版本是3.22;我们已经转移到3.23的积极开发中。在稳定版本中,错误仍将被修复。我们不相信一个完全冻结,因为这也留下的错误修复和“必须做”的事情。“某种程度的冻结”意味着我们可以增加小东西,它“将几乎肯定不影响已经能工作的任何东西”。
4.5 安装布局
这节描述安装二进制代码和源代码分发时创建的缺省目录布局。
二进制分发通过在你选择的安装地点(典型的“/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”。
4.6 安装MySQL二进制代码分发
你需要下列工具安装一个MySQL二进制分发:
* GNU gunzip解压缩分发。
* 一个适当的tar解包分发。 GNU tar已知可以。
在Linux下的另一个安装方法是使用RPM(RedHat包管理器)分发。见4.6.1 Linux RPM 注意事项。
如果你碰到问题,在把问题邮寄到mysql@lists.mysql.com时,请总是使用mysqlbug,就算问题不是一个bug,mysqlbug收集系统信息,将有助于其它人解决你的问题。不使用mysqlbug,你将减少得到你问题的一个解决方案的可能性!在你解包分发后,你会在“bin”目录下找到mysqlbug。见2.3 怎样报告错误或问题。
你必须执行以便安装并使用一个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脚本增加新用户。
以下是更详细的描述:
对于安装二进制分发,遵循以下步骤,然后继续到4.15 安装后期的设置与测试,进行安装后期的设置和测试:
1. 挑选一个你想解开分发包的目录,进入给目录。在下面的例子中,我们将分发解包在“/usr/local”下并且创建一个安装MySQL的“/usr/local/mysql”目录。(因此,下列指令假设你有权限在“/usr/local”中创建文件,如果该目录被保护,你需要以root实施安装。)
2. 从4.1 怎样获得MySQL中列出的站点之一获得一个分发文件。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接口的支持,见4.10 Perl安装注意事项。
8. 如果你喜欢在引导机器时自动启动MySQL,你可以拷贝support-files/mysql.server文件到你系统有启动文件的地方。更多的信息可以在support-files/mysql.server脚本中和4.15.3 自动启动和停止MySQL找到。
在所有东西被解包并且安装以后,你应该初始化并且测试你的分发。
你可以用下列命令启动MySQL服务器:
shell> bin/safe_mysqld &
见4.15 安装后期的设置和测试。
4.6.1 Linux RPM 注意事项
在Linux上安装MySQL推荐的方法是使用一个RPM文件。MySQL RPM目前是在一个 RedHat 5.2 系统上建立的,但是应该能工作在支持rpm且使用glibc的其他 Linux 版本上。
如果一个RPM文件有问题,例如Sorry, the host 'xxxx' could not be looked up,见4.6.3.1 Linux 注意事项。
你可能要使用的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。见4.15 安装后期的设置和测试。
如果一些东西出错,可以在二进制的安装一节里找到更多的信息。见4.6 安装MySQL二进制代码分发。
4.6.2 构造客户程序
如果你编译你自己写的或你从第三方获得的MySQL客户程序,他们必须用link命令的-lmysqlclient选项进行链接。你可能也需要指定一个 -L 选项,告诉链接器在哪儿查找库文件。例如,如果库文件安装在“/usr/local/mysql/lib”里,在链接命令上使用 -L/usr/local/mysql/lib -lmysqlclient。
对使用MySQL头文件的客户程序,当你编译他们时,你可能需要指定一个 -I 选项(例如,-I/usr/local/mysql/include), 使得编译器能找到头文件。
4.6.3 系统特定的问题
下一节说明在从一个二进制分发安装MySQL时,已经在特定的系统上观察到已发生过一些问题。
4.6.3.1 Linux 注意事项
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或更新。
4.6.3.2 HP-UX 注意事项
针对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的一个拷贝。
4.7 安装MySQL源代码分发
你需要下列工具构造并安装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或更新。
如果你遇到问题,当向mysql@lists.mysql.com邮寄问题时,请一直使用mysqlbug。就算问题不是一个bug,mysqlbug收集系统信息,将有助于其它人解决你的问题。如果不使用mysqlbug,你减少得到关你问题的一个解决方案的可能性!在你解包分发后,你会在“scripts”目录下找到mysqlbug。见2.3 怎样报告错误或问题。
4.7.1 快速安装概述
你必须执行的安装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脚本增加新用户。
以下是更详细的描述:
为了安装源代码分发,按照下列步骤,然后继续到4.15 安装后期的设置与测试,进行安装后期的初始化与测试。
1. 挑选一个你要在其下面解包分发的目录,并且进入该目录。
2. 从节4.1 怎样获得MySQL中列出的站点之一获得一个分发文件。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得到一张选项表。4.7.3 典型的configure选项讨论一些很有用的选项。如果configure失败,你将发送包含你认为能帮你解决该问题的“config.log”的邮件,如果configure异常退出,也要包括configure的最后几行输出。用mysqlbug脚本邮寄错误报告。见2.3 怎样报告错误和问题。如果编译失败,见节4.8 编译问题?,帮助解决很多常见问题。
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接口的支持,见4.10 Perl安装注意说明。
9. 如果你想要MySQL在你引导机器时自动地启动,你可以拷贝support-files/mysql.server到你的系统中有启动文件的地方。更多的信息可以在support-files/mysql.server脚本里和4.15.3 自动启动和停止MySQL找到。
在所有东西安装完以后,你应该初始化并且测试你的分发。
你可以用下列命令启动MySQL服务器,这里BINDIR是safe_mysqld被安装的目录(缺省为“/usr/local/bin”):
shell> BINDIR/safe_mysqld &
如果这个命令提示mysqld daemon ended并马上失败,那么你能在文件“mysql-data-directory/'hostname'.err”找到一些信息。可能的原因是你已经有另外一个正在运行的mysqld服务器。见19.3 在同一台机器上运行多个MySQL服务器。
参见4.15 安装后期的设置与测试。
4.7.2 运用补丁
有时补丁出现在邮件列表上或放在MySQL FTP地点的补丁区。
为了使用来自邮件列表的一个补丁,保存补丁出现在文件的消息,进入你的MySQL源代码树的顶级目录并运行这些命令:
shell>patch - p1 <patch-file-name
shell>rm config.cache
shell>make clean
来自FTP地点的补丁是作为普通文本文件或作为被压缩了的gzip文件分发。运用一个文本的补丁如上述邮件列表补丁,为了使用一个压缩的补丁,进入你的MySQL源代码树顶级目录并运行这些命令:
shell>gunzip <patch-file-name.gz |patch - p1
shell>rm config.cache
shell>make clean
在使用一个补丁以后,按照正常的源代码安装的指令,开始./configure步骤。在运行make install后,重启你的MySQL服务器。
在运行make install前,你可能需要关闭所有正在运行的服务器(使用mysqladmin shutdown)。如果一个程序的新版本替代当前正在执行的版本,一些系统不允许你安装它。
4.7.3 典型的configure选项
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之一。见9.1.1 用于数据和排序的字符集。注意:如果你想要改变字符集,你必须在配置期间做make distclean!如果你想在服务器和客户之间变换字符,你应该看一下SET OPTION CHARACTER SET命令。见7.25 SET OPTION句法。警告:如果你在创建了任何数据库表之后改变字符集,你将必须对每个表运行myisamchk -r -q,否则你的索引可能不正确地排序。(如果你安装了MySQL,创建一些表,然后重新配置MySQL使用一个不同的字符集并且重新安装它,这时就可能发生这种情况。)
* 为了配置MySQL带有调试代码,使用--with-debug选项:
shell> ./configure --with-debug
这导致包含一个安全的内存分配器,能发现一些错误和并提供关于正在发生的事情的输出。见G.1调试一个MySQL服务器。
* 属于特定系统的选项可在本章特定系统的小节里找到。见4.11 系统特定的问题。
4.8 编译问题?
所有MySQL程序在Solaris上使用gcc编译并且没有任何警告。在其他系统上,由于系统包含文件的差别可能会发生警告。对于使用MIT-pthreads时发生的警告,见4.9 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
对于已经知道在不同系统上有用的标志定义列表,见4.14 TcX 二进制代码。
* 如果你得到象如下的一条错误消息,你需要升级你的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选项,然后重新编译并且链接你客户程序到新的客户库。见G.2 调试一个MySQL客户。
4.9 MIT-pthreads注意事项
这节描述在使用 MIT-pthreads 所涉及的一些问题。
注意:在Linux上,你应该不使用MIT-pthreads而是安装LinuxThreads!见4.11.5 Linux 注意事项(所有的Linux 版本)。
如果你的系统不提供原生的线程支持,你将需要使用MIT-pthreads包构造MySQL。这包括大多数FreeBSD系统、SunOS 4.x 、Solaris 2.4和更早版本及其他,见4.2 MySQL 支持的操作系统。
* 在大多数系统上,你能通过使用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上工作。(这不需要,但是可能某些人有兴趣。)
4.10 Perl 安装说明
4.10.1 在Unix上安装Perl
Perl对MySQL的支持借助DBI/DBD客户接口而提供。见20.5 MySQL Perl API。Perl DBD/DBI客户代码要求Perl 5.004或以后版本。如果你有Perl的一个更旧的版本,接口将不能工作。
MySQL Perl支持也要求你安装了MySQL客户编程支持。如果你从RPM文件安装MySQL,客户程序在客户RPM中,但是客户编程支持在开发者RPM。确定你安装了后一个RPM 。
对于版本3.22.8,Perl支持是与主要MySQL发行版本单独分发。如果你想要安装Perl支持,你需要的文件能从http://www.mysql.com/Contrib获得。
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模块,下列参考书可以帮助你:
http://www.iserver.com/support/contrib/perl5/modules.html
在标题Installing New Modules that Require Locally Installed Modules下面查找。
4.10.2 在Win32上安装ActiveState Perl
在 Win32 上安装 ActiveState Perl的MySQL DBD的模块, 你应该做下列步骤:
* 打开一个DOS shell。
* 如果需要,设置HTTP_proxy变量。例如, 你可以试一试:set HTTP_proxy=my.proxy.com:3128
* 启动PPM程序:C:\perl\bin\ppm.pl
* 如果你还没有这样做,安装DBI: install DBI
* 如果成功,安装DBD::mysql:http://www.mysql.com/Contrib/ppd/DBD-mysql.ppd
如果你不能使上述步骤工作,你应该安装MyODBC驱动程序并且通过ODBC连接MySQL服务器。
use DBI;
$dbh= DBI->connect("DBI:ODBCdsn","$user","$password") ||
die "Got error $DBI::errstr when connecting to $dsn\n";
4.10.3 在Win32上安装MySQL Perl分发
MySQL Perl分发包含DBI、DBD:MySQL和DBD:ODBC。
* 从http://www.mysql.com/download.html得到Win32的Perl分发。
* 在C:解压缩分发,这样你得到一个“C:\PERL”目录。
* 增加目录“C:\PERL\BIN”到你的路径。
* 增加目录“C:\PERL\BIN\MSWin32-x86-thread”或“C:\PERL\BIN\MSWin32-x86”到你的路径。
* 在 DOS shell执行perl -v测试perl的运行。
4.10.4 使用PerlDBI/DBD接口的问题
如果 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的输出指出使用的命令。
4.11 系统特定的问题
下面的章节说明在从源代码分发安装MySQL时,发生在特定的系统上并已观察到的一些问题。
4.11.1 Solaris注意事项
在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) 打开分发。你能在http://www.mysql.com/Downloads/ ... 编译的拷贝。
Sun的原生线程只工作在Solaris 2.5和更高版本上。对于2.4和更早的版本,MySQL将自动地使用 MIT-pthreads 。见4.9 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 或更新。你能在http://egcs.cygnus.com/找到它。注意: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 |
|