出售域名!

mysql-logo.png (3082 bytes)MySQL中文参考手册

译者:晏子 (clyan@sohu.com)      主页:http://getos.org


第一章, 前一章, 下一章, 最后一章目录.


4 安装MySQL

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

4.1 怎样获得MySQL

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

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

请向webmaster@mysql.com报告不存在的或过时的镜像站点。

欧洲:

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

北美洲:

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

南美洲:

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

亚洲:

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

澳洲:

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

非洲:

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

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)显示发行的稳定性级别。可能的后缀有:
    • alpha 表明发行包含大量未被100%测试的新代码。已知的错误(通常没有)应该在新闻小节被记录。见D MySQL 变迁的历史记录。在大多数 alpha 版本也有新的命令和扩展。
    • beta 意味着所有的新代码被测试了,没有增加重要的新特征,应该没有已知的错误。
    • gamma 是一个发行了一段时间的beta版本,看起来应该运行正常。这就是很多其他公司称为一个发布的东西。
    • 如果没有后缀,这意味着该版本已经在很多地方运行一段时间了,而且没有非平台特定的错误报告。这就是我们称为一个稳定版本的东西。

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 &





如果你安装了DBIMsql-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)。如果你正在使用一个老的不支持--forceMySQL版本,你必须用编辑器删除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。

如果你安装了DBIMsql-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服务器,这里BINDIRsafe_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可以是big5cp1251cp1257czechdanishdec8doseuc_krgb2312 gbk、german1hebrewhp8hungariankoi8_rukoi8_ukrlatin1latin2sjisswe7tis620ujisusa7win1251win1251ukr之一。见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

    它能工作,因为gccg++一样编译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++编译器所使用的标志,把标志加到CFLAGSCXXFLAGS环境变量中即可。你也能使用CCCXX来指定编译器名字。例如:
    
    
    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
    
    
    

    更改XXXsize_tint,这取决于你的操作系统。(注意:你每次运行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)并使用它。

  • 如果你需要调试mysqldMySQL客户,运行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
  • 如果你还没有这样做,安装DBIinstall DBI
  • 如果成功,安装DBD::mysql:http://www.mysql.com/Contrib/ppd/DBD-mysql.ppd

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

use DBI;


$dbh= DBI->connect("DBI:ODBC:$dsn","$user","$password") || 


  die "Got error $DBI::errstr when connecting to $dsn\n";


4.10.3 在Win32上安装MySQL Perl分发

MySQL Perl分发包含DBIDBD:MySQLDBD: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模块,你可以产生包括DBIDBD-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/找到为Solaris的一个预编译的拷贝。

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


你也可以编辑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


增加-mtCFLAGSCXXFLAGS并且再试一试。

如果你在用gcc编译MySQL时得到下列错误,它意味着你的gcc没有对你的Solaris版本进行配置!

shell> gcc -O3 -g -O2 -DDBUG_OFF  -o thr_alarm ...


./thr_alarm.c: In function `signal_hand':


./thr_alarm.c:556: too many arguments to function `sigwait'


在这种情况下正确的做法是得到最新版本的egcs,并且用你当前的gcc编译器编译它!至少对于 Solaris 2.5,几乎所有的gcc二进制版本都有旧的、不可用的包含文件,将破怀使用线程的所有程序的文件(并且可能是其他的程序)!

Solaris不提供所有系统库的静态版本(libpthreadslibdl),所以你不能用--static编译MySQL。如果你尝试这样做,你将得到错误:

ld: fatal: library -ldl: not found


如果太多进程试图很快地连接mysqld,你将在MySQL日志文件中看见这个错误:

Error in accept: Protocol error


你可以试着用--set-variable back_log=50选项启动服务器作为它的一个解决办法。

如果你正在链接你自己的MySQL客户,当你试着执行它时,你可能得到下列错误:

ld.so.1: ./my: fatal: libmysqlclient.so.#: open failed: No such file or directory


这个问题能用下列方法之一避免:

  • 用下列标志链接客户(而不是-Lpath): -Wl,r/full-path-to-libmysqlclient.so
  • 拷贝libmysqclient.so“/usr/lib”
  • 在运行你的客户程序前,把libmysqlclient.so所在目录的路径名加到LD_RUN_PATH的环境变量中。

4.11.2 Solaris 2.7 注意事项

通常你能在 Solaris 2.7 上使用 Solaris 2.6 二进制代码。大多数Solaris 2.6 的问题也适用于Solaris 2.7。

注意:MySQL3.23.4 和更高版本应该能自动检测 Solaris 2.7 并且启用下列问题的解决办法!

Solaris 2.7 在包括文件中有一些bug,在使用gcc时,你可以看见下列错误:

/usr/include/widec.h:42: warning: `getwc' redefined


/usr/include/wchar.h:326: warning: this is the location of the previous


definition


如果出现这种情况,你可以做下列事情解决这个问题:

拷贝/usr/include/widec.h.../lib/gcc-lib/os/gcc-version/include并且改变第41行:

#if     !defined(lint) && !defined(__lint)





为





#if     !defined(lint) && !defined(__lint) && !defined(getwc)


另外,你可以直接编辑“/usr/include/widec.h”。这两种方法,在你进行修正以后,你应该删除“config.cache”并且再运行configure

如果当你运行make时,你得到象这样错误,那是因为configure没检测“curses.h”文件(可能因为/usr/include/widec.h的错误):

In file included from mysql.cc:50:


/usr/include/term.h:1060: syntax error before `,'


/usr/include/term.h:1081: syntax error before `;'


解决它的方案是做下列步骤之一:

  • 如上所述编辑“/usr/include/widec.h”并且再次运行configure。
  • “config.h”文件删除#define HAVE_TERM行并再次运行make
  • CFLAGS=-DHAVE_CURSES CXXFLAGS=-DHAVE_CURSES ./configure进行配置。

4.11.3 Solaris x86 注意事项

如果你正在在 Solaris x86上使用gccegcs,并且你碰到了在装载时的核心倾倒(core dump)问题,你应该使用下列configure命令:

shell> CC=gcc CFLAGS="-O6 -fomit-frame-pointer" \


       CXX=gcc \


       CXXFLAGS="-O6 -fomit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" \


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


libstdc++库和与C++异常处理来避免这个问题。

如果这没有帮助,你应该编译一个调试版本并且用一个踪迹文件运行它或在gdb下运行它。见G.1 调试一个 MySQL 服务器

4.11.4 SunOS 4 注意事项

在 SunOS 4 上, 需要MIT-pthreads 编译MySQL,反过来这意味着你将需要GNU make

一些SunOS 4系统的动态库和libtool有问题。你可以使用下列configure行来避免这个问题:

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


当编译readline时,你可能得到关于重复定义的警告,这些可以被忽略。

当编译mysqld时候, 将有一些implicit declaration of function警告,这些可以被忽略。

4.11.5 Linux 注意事项(所有Linux版本)

MySQL在Linux上使用 LinuxThreads 。如果你正在使用一个没有glibc2的老的Linux版本,你必须在尝试编译MySQL前安装LinuxThreads。http://www.mysql.com/Downloads/Linux

注意:但你做INSERT DELAYED时,所用的包括2.1.1及以前的glibc版本在pthread_mutex_timedwait处理上有一个致命错误,如果你正在使用INSERT DELAYED,你必须把下列补丁加到你的glibc库中:http://www.mysql.com/Downloads/Patches/glibc-pthread_cond_timedwait.patchMySQL 3.23.7包含了对这个错误的一个临时解决办法。

如果你不能启动mysqld或如果mysql_install_db不工作,请继续读下去!这仅发生在有LinuxThreads问题或libc/glibc库为题的Linux系统上。有很多简单的解决办法让MySQL工作!最简单是使用针对Linux x86的二进制版本的MySQL(不是RPM),这个版本的一个好的方面是它可能比你编译你自己的任何版本快10%!见10.2.1 编译和链接如何影响 MySQL 的速度

二进制分发的一个已知问题是与使用libc的更老的Linux系统(如RedHat 4.x 或 Slackware),你将得到有关主机名解决的一些非致命问题。见4.6.3.1 Linux注意事项

使用libc.so.5.3.12,myisamchk将挂起,升级到最新libc以解决这个问题。

当使用 LinuxThreads 时,你将看到最少 3 进程在运行。这些事实上的线程,对LinuxThreads管理器将有一个线程,一个线程处理连接,还有一个线程处理告警和信号。

如果你用ps看到了一个死掉的mysqld守护进程,这通常意味着你发现了MySQL里面的一个错误或你有一个被破坏的数据库表。见18.1 如果MySQL总是崩溃怎么办

如果你正在使用LinuxThreads并且mysqladmin shutdown不工作,你必须升级到 LinuxThreads 0.7.1 或更新。

如果你正在使用 RedHat ,你可能得到象这样的错误:

/usr/bin/perl is needed...


/usr/sh is needed...


/usr/sh is needed...


如果是这样,你应该升级rpm版本到“rpm-2.4.11-1.i386.rpm”“rpm-devel-2.4.11-1.i386.rpm”(或以后)。

你能从ftp://ftp.redhat.com/updates/4.2/i386得到RedHat 4.2的库文件升级,或对其他分发http://www.sunsite.unc.edu/pub/Linux/distributions/redhat/code/rpm/

如果你正在链接你自己的MySQL客户并且得到错误:

ld.so.1: ./my: fatal: libmysqlclient.so.4: open failed: No such file or directory


当执行它们时,这个问题可用下列方法之一避免:

  • 用下列标志链接客户(而不是-Lpath): -Wl,r/path-libmysqlclient.so
  • 拷贝libmysqclient.so“/usr/lib”
  • 在运行你的客户程序前,把libmysqlclient.so所在目录的路径名加到LD_RUN_PATH的环境变量中。

如果你正在使用 Fujitsu 编译器(fcc / FCC),编译MySQL你将有一些问题,因为 Linux 头文件面向gcc

下列configure行应该与fcc/FCC工作:

CC=fcc CFLAGS="-O -K fast -K lib -K omitfp -Kpreex -D_GNU_SOURCE -DCONST=const \


-DNO_STRTOLL_PROTO" CXX=FCC CXXFLAGS="-O -K fast -K lib  -K omitfp \


-K preex --no_exceptions --no_rtti -D_GNU_SOURCE -DCONST=const \


-Dalloca=__builtin_alloca -DNO_STRTOLL_PROTO '-D_EXTERN_INLINE=static __inline'" \


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


--with-mysqld-ldflags=-all-static --disable-shared --with-low-memory


4.11.5.1 Linux-x86 注意事项

MySQL要求libc版本 5.4.12 或更新,已知可工作在libc 5.4.46。glibc版本2.0.6和以后版本应该也工作。使用RedHat的glibc RPM有一些问题,所以如果你有问题,检查是否有任何更新!glibc2.0.7-19和2.0.7-29 RPM已知可以工作。

在一些更老的 Linux 分发上,configure可能产生象这样的一个错误:

Syntax error in sched.h. Change _P to __P in the /usr/include/sched.h file.


See the Installation chapter in the Reference Manual.


按照错误消息所说的去做,并且给只有一条下划线的_P宏增加一个额外下划线 ('__P'), 然后再试一试。

在编译时,你可能得到一些警告;显示在下面的那些可以被忽略:

mysqld.cc -o objs-thread/mysqld.o


mysqld.cc: In function `void init_signals()':


mysqld.cc:315: warning: assignment of negative value `-1' to `long unsigned int'


mysqld.cc: In function `void * signal_hand(void *)':


mysqld.cc:346: warning: assignment of negative value `-1' to `long unsigned int'


在Debian GNU/Linux上,如果你想要在系统启动时自动启动MySQL,做下列命令:

shell> cp support-files/mysql.server /etc/init.d/mysql.server


shell> /usr/sbin/update-rc.d mysql.server defaults 99


mysql.server可以在MySQL安装目录的“share/mysql”目录下面找到, 或在MySQL源代码树的“support-files”目录下找到。

如果mysqld在它启动时总是核心倾倒(core dump), 问题可能是你有一个老版本的“/lib/libc.a”,重命名它,然后删除“sql/mysqld”并且重新make install再试一试。这个问题在一些 Slackware 安装上被报告了。有最新版本的glibc的RedHat 5.0也有一些类似的问题。见4.11.5.2 RedHat 5.0 注意事项

如果再链接mysqld时,你得到下列错误, 它意味着你的“libg++.a”没有正确安装:

/usr/lib/libc.a(putc.o): In function `_IO_putc':


putc.o(.text+0x0): multiple definition of `_IO_putc'


像这样运行configure,你能避免使用“libg++.a”

shell> CXX=gcc ./configure


4.11.5.2 RedHat 5.0 注意事项

如果你在RedHat上有MySQL的任何问题,你应该开始升级glibc到最新可能的版本!

如果你安装所有的官方RedHat补丁(包括glibc-2.0.7-19glibc-devel-2.0.7-19),MySQL的二进制代码和源代码分发运行应该没有任何麻烦!

因为在glibc2.0.5里面有关如何释放pthread_key_create变量有一个错误,更新是需要的。用glibc2.0.5,你必须使用一个静态地链接的MySQL二进制分发。如果你想要从源代码编译,你必须安装来自于http://www.mysql.com/Downloads/Linux 的LinuxThreads修正版本或升级你的glibc

如果你有一个不正确的glibc或LinuxThreads版本,其结果是mysqld在每个连接以后崩溃。例如,mysqladmin version完成后,mysqld将崩溃!

另一个不正确的库的症状是当mysqld启动时,马上崩溃。在一些Linux系统上,这个问题可以通过这样的配置来修正:



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

在Redhat 5.0上,容易的方法是安装glibc2.0.7-19 RPM并运行configure --with-mysqld-ldflags=-all-static选项。

对于glibc2.0.7的源代码分发,容易运用并被MySQL测试的一个补丁可以在下面找到:



http://www.mysql.com/Download/Linux/glibc-2.0.7-total-patch.tar.gz


如果当你构造MySQL时,你有类似于这些崩溃的经历, 你总能下载到最新的MySQL二进制版本。这是静态链接的以避免库冲突而且应该在所有的Linux系统上工作!

MySQL自带一个内部的调试器可以有很多信息产生踪迹文件,能被用来发现并解决大量不同的问题。见G.1 调试一个MySQL服务器

4.11.5.3 RedHat 5.1 注意事项

RedHat 5.1的glibc(glibc2.0.7-13 )有一个内存缺陷,所以要得到一个稳定的MySQL版本,你必须升级glibc到2.0.7-19、降级glibc或使用一个mysqld的二进制版本。如果你不这样做,你将碰到内存问题(存储器溢出,等等, 等等)。在这种情况下,最常见的错误是:

Can't create a new thread (errno 11). If you are not out of available


memory, you can consult the manual for any possible OS dependent bug


在你升级到glibc2.0.7-19以后,你可以用动态链接(缺省)配置MySQL,但是在你从源代码安装了glibc 2.0.7-19之前,你不能运行configure --with-mysqld-ldflags=-all-static选项!

你可以用rpm -q glibc检查你有glibc哪个版本。

4.11.5.4 Linux-SPARC 注意事项

在一些实现中,readdir_r()被破坏了。其症状是SHOW DATABASES总是返回一个空集合。这可以通过在编译前从“config.h”中删除HAVE_READDIR_R进行更正。

有些问题将需要给你的Linux安装打补丁。补丁可在http://www.mysql.com/patches/Linux-sparc-2.0.30.diff找到,这个补丁是针对Linux分发“sparclinux-2.0.30.tar.gz”,它们可从vger.rutgers.edu(一个从来没有与官方的2.0.30版合并的版本)得到。你也必须安装LinuxThreads 0.6或更新。

感谢jacques@solucorp.qc.ca提供这个信息。

4.11.5.5 Linux-Alpha注意事项

在Linux-Alpha上的大问题仍然是在这个平台上的glibc的线程有一些问题。你应该从得到你能找到的最新glibc版本开始。

注意:在你运行任何使用线程的程序之前(象mysqldthr_alarmthr_lock),你应该增减共享存储器的限制(用ulimit)。如果你忘记这样做,MySQL基准测试已知是失败的!

用下列命令配置MySQL

shell> CC=gcc CCFLAGS="-Dalpha_linux_port" \


       CXX=gcc CXXFLAGS="-O3 -Dalpha_linux_port -felide-constructors -fno-exceptions -fno-rtti" \


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


试试编译mysys/thr_lockmysys/thr_alarm,测试这些程序的运行!(不用参数调用每一个,如果一切正常,每个应该以test_succeeded结束。)

在安装MySQL以后,在safe_mysqld里去掉ulimit命令的注释,并加入选项以增加共享存储器。

注意对MySQL来说,Linux-Alpha仍然是一个alpha质量的平台。用最新glibc,你有一个让它工作的很好机会。

如果你用信号方面的问题(MySQL出人意料地在高负载下死掉),你可能找到了一个线程和信号有关的OS错误。在这种情况下,你可以告诉MySQL如下配置以不使用信号:

shell> CFLAGS=-DDONT_USE_THR_ALARM \


       CXXFLAGS=-DDONT_USE_THR_ALARM \


       ./configure ...


这不影响MySQL性能,但是有副作用,就是你不能用mysqladmin killmysqladmin shutdown杀死在一个连接上“睡眠”的客户。相反,当客户发出下一个命令时,它将死掉。

4.11.5.6 MkLinux 注意

MySQL应该能工作在有最新glibc包的MkLinux上(用glibc2.0.7测试过)。

4.11.5.7 Qube2 Linux注意事项

为了让MySQL在Qube2上工作,(Linux Mips),你需要最新的glibc库(glibc-2.0.7-29C2已知可工作)。你也必须使用egcsC++编译器(egcs-1.0.2-9或更新)。

4.11.6 Alpha-DEC-Unix 注意事项

当在Digital UNIX下编译线程程序时,文档推荐对于cccxx使用-pthread选项而且库文件用-lmach -lexc(除了-lpthread外)。你应该象下面这样运行configure

shell> CC="cc -pthread" CXX="cxx -pthread -O" \


       ./configure --with-named-thread-libs="-lpthread -lmach -lexc -lc"


当编译mysqld时,你可能看见这样一些警告:

mysqld.cc: In function void handle_connections()':


mysqld.cc:626: passing long unsigned int *' as argument 3 of


accept(int,sockadddr *, int *)'


你可以安全地忽略这些警告,他们的发生是因为configure只能检测出错误,而不是警告。

如果你直接从命令行启动服务器,当你退出时,你可能有死掉的问题。(当你退出时,你的重要进程收到一个SIGHUP信号),如果如此,试着象这样启动服务器:



shell> nohup  mysqld [options] &


nohup使得跟随它的命令忽视从终端发来的任何SIGHUP信号了。另外,通过运行safe_mysqld启动服务器,它为你使用nohup调用mysqld

4.11.7 Alpha-DEC-OSF1注意事项

如果你有编译问题并安装了DECCCgcc,尝试这样运行configure

shell> CC=cc CFLAGS=-O CXX=gcc CXXFLAGS=-O3 \


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


如果你得到“c_asm.h”文件的问题,你可以创建并使用一个“哑(dummy)”“c_asm.h”文件:

shell> touch include/c_asm.h


shell> CC=gcc CFLAGS=-I./include \


       CXX=gcc CXXFLAGS=-O3 \


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


在OSF1 V4.0D和编译器"DEC C V5.6-071 on Digital UNIX V4.0 (Rev. 878)" 上,编译器有了一些奇怪的行为(未定义asm标志)。/bin/ld好象也被破坏(当链接mysqld时,发生_exit undefined问题)。在这个系统上,从OSF 4.0C的版本替换了/bin/ld后,我们设法用下列configure命令行编译MySQL,:

shell> CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql 


用Digital编译器“C++ V6.1-029”,下列命令应该工作:

CC=cc -pthread


CFLAGS=-O4 -ansi_alias -ansi_args -fast -inline speed -speculate all -arch host


CXX=cxx -pthread


CXXFLAGS=-O4 -ansi_alias -ansi_args -fast -inline speed -speculate all -arch host


export CC CFLAGS CXX CXXFLAGS


./configure --prefix=/usr/mysql/mysql --with-low-memory --enable-large-files \


--with-mysqld-ldflags=-all-static --disable-shared --with-named-thread-libs="-lmach -lexc -lc"


在OSF1的某些版本中,alloca()函数被破坏,通过删除定义'HAVE_ALLOCA'的“config.h”的行更正它。

alloca()函数也可能在/usr/include/alloca.h里面有一个不正确的原型,源于此的警告可以忽略。

configure将自动地使用下列线程库: --with-named-thread-libs="-lpthread -lmach -lexc -lc"

当使用gcc时,你也可以试试这样运行configure



shell> CFLAGS=-D_PTHREAD_USE_D4  CXX=gcc  CXXFLAGS=-O3  ./configure ……

如果你的信号有问题(MySQL出人意料地在高负载下死掉),你可能找到了一个线程和信号有关的OS错误。在这种情况下,你可以告诉MySQL如下配置以不使用信号:

shell> CFLAGS=-DDONT_USE_THR_ALARM \


       CXXFLAGS=-DDONT_USE_THR_ALARM \


       ./configure ...


这不影响MySQL性能,但是有负面效应,就是你不能用mysqladmin killmysqladmin shutdown杀死在一个连接上“睡眠”的客户。相反,当客户发出下一个命令时,它将死掉。

4.11.8 SGI-Irix 注意事项

你可能需要在运行configure后且在编译前去掉在“config.h”里面一些东西的定义(underfine)。

在一些Irix实现中,alloca()函数被破坏。如果mysqld服务器死于一些SELECT语句,把“config.h”定义HAVE_ALLOCHAVE_ALLOCA_H的行删除即可。如果mysqladmin create不工作,把“config.h”定义HAVE_READDIR_R的行删除,你也可能必须删除HAVE_TERM_H行。

SGI推荐你将本页上的所有补丁作为一个整体来安装:http://support.sgi.com/surfzone/patches/patchset/6.2_indigo.rps.html

最小地,你应该安装最新的核心卷(rollup)、最新的rld卷和最新的libc卷。

很明确,对于pthreads支持,你需要本页上所有的POSIX补丁:

http://support.sgi.com/surfzone/patches/patchset/6.2_posix.rps.html

如果在编译“mysql.cc”时,你得到类似于下面的错误:

"/usr/include/curses.h", line 82: error(1084): invalid combination of type


那么,在你的MySQL源代码树的顶级目录打下列命令:

shell> extra/replace bool curses_bool < /usr/include/curses.h > include/curses.h


shell> make


应该也有安排上的问题报告。如果只有一个线程正在运行,事情会变慢的。通过启动另外一个客户来避免它,这可以导致此后其他线程的执行速度增加2到10倍。这是Irix线程难以理解的问题;你可能必须临时准备找出解决方案直到它能被修正。

如果你正在用gcc编译,你可以使用下列configure命令:

shell> CC=gcc CXX=gcc CXXFLAGS=-O3 \


       ./configure --prefix=/usr/local/mysql --with-thread-safe-client --with-named-thread-libs=-lpthread


4.11.9 FreeBSD 注意事项

对于运行MySQL,FreeBSD 3.x是被推荐的,因为其线程包是更加完整。

最容易因此是比较受喜欢的安装方法是使用mysql服务者和 mysql客户的移植,可从http://www.freebsd.org得到。

使用这些给你的东西:

  • 一个全优化的工作在你的FreeBSD版本上的MySQL
  • 自动配置和构造。
  • 启动脚本安装在/usr/local/etc/rc.d。
  • 用pkg_info -L察看哪个文件被安装的能力,并且如果你在那台机器上不再想要MySQL,用pkg_delete完全删除它们。

建议在FreeBSD 2.x版上使用 MIT-pthreads,在版本3和以上版本用原生线程。在一些2.2.x的以后版本使用原生线程运行是可能的,但是你可能碰到mysqld关掉的问题。

确定让你的名字解析程序安装正确,否则当连接mysqld时,你可能会经历解析延时或失败。

保证在“/etc/hosts”文件中的localhost入口是正确的(否则你与数据库连接时将有问题)。“/etc/hosts”文件应该以一行开始:



127.0.0.1  localhost  localhost.your.domain

如果你注意到configure使用 MIT-pthreads,你应该阅读MIT-pthreads注意事项,见4.9 MIT-pthreads 注意事项

如果你从make install得到一个它不能找到“/usr/include/pthreads”的错误,configure没有检测出你需要 MIT-pthreads。通过执行这些命令修正它:

shell> rm config.cache


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


FreeBSD make的行为与make GNU略有不同。如果你有make相关问题,你应该安装GNU make

FreeBSD也已知有一个非常低的缺省文件句柄限制。见18.11 文件没找到。去掉在safe_mysqld中的ulimit -n 小节的注释或在/etc/login.conf为mysqld用户提高限制(并用cap_mkdb /etc/login.conf重建它),如果你不使用缺省,也要保证你为此用户在口令文件(用法:chpass mysqld-user-name )。

你用SELECT NOW()返回GMT形式的值而不是你的本地时间,如果有这样的问题,你必须设定TZ环境变量为你的当前时区的。这应该设置服务器运行的环境,例如在safe_mysqldmysql.server里。

为了得到一个安全并且稳定的系统,你应该只仅使用被标记为-STABLE的FreeBSD内核。

4.11.10 NetBSD 注意事项

为了NetBSD上编译,你需要GNU make,否则当make试图在C++文件上运行lint时,编译将崩溃。

4.11.11 OpenBSD 2.5 注意事项

在OpenBSD 2.5上,你可以用下列选项编译带原生线程的MySQL



CFLAGS=-pthread  CXXFLAGS=-pthread  ./configure -- with-mit-threads=no

4.11.12 BSD/OS 注意事项

4.11.12.1 BSD/OS 2.x 注意事项

如果在编译MySQL时,你得到下列错误, 你对虚存的ulimit值是太低了:

item_func.h: In method `Item_func_ge::Item_func_ge(const Item_func_ge &)':


item_func.h:28: virtual memory exhausted


make[2]: *** [item_func.o] Error 1


试试使用ulimit -v 80000并再运行make。如果这还不行并且你正在使用bash,试试换到cshsh;一些BSDI用户报告了与bashulimit有关问题。

如果你正在使用gcc,你也可能必须为configure使用--with-low-memory标志才能编译“sql_yacc.cc”

你用SELECT NOW()返回GMT形式的值而不是你的本地时间,如果有这样的问题,你必须设定TZ环境变量为你的当前时区的。这应该为服务器运行的环境设置,例如在safe_mysqldmysql.server里。

4.11.12.2 BSD/OS 3.x 注意事项

升级到BSD/OS 3.1。如果那不可能,安装BSDI patch M300-038。

在配置MySQL时,使用下列命令:

shell> env CXX=shlicc++ CC=shlicc2 \


       ./configure \


           --prefix=/usr/local/mysql \


           --localstatedir=/var/mysql \


           --without-perl \


           --with-unix-socket-path=/var/mysql/mysql.sock


下列也已知可用:

shell> env CC=gcc CXX=gcc CXXFLAGS=-O3 \


       ./configure \


           --prefix=/usr/local/mysql \


           --with-unix-socket-path=/var/mysql/mysql.sock


如果你愿意,你可以改变目录地点,或不指定任何地点而使用缺省。

如果你在重负再下的性能有问题,试试使用对safe_mysqld使用--skip-thread-priority选项!这将以相同优先级运行所有线程;在BSDI 3.1上,这得到较好的性能(至少直到BSDI修正其线程调度程序)。

如果你在编译时得到virtual memory exhausted错误,试试使用ulimit -v 80000并再运行make。如果这还不行并且你正在使用bash,试试换到cshsh;一些BSDI用户报告了与bashulimit有关问题。

4.11.12.3 BSD/OS 4.x 注意事项

BSDI 4.x有一些线程有关的错误。如果你想要在这上面使用MySQL,你应该安装所有与线程相关的补丁,至少应该安装M400-023。

4.11.13 SCO 注意事项

当前的移植仅在“sco3.2v5.0.4”和“sco3.2v5.0.5”系统上被测试,在“sco 3.2v4.2”一个移植也有很大进展。

此时在OpenServer上推荐的编译器是gcc 2.95.2,用它你应该能编译MySQL

CC=gcc CXX=gcc ./configure ... (options)


  1. 对于OpenServer 5.0.X,你需要在Skunkware 95上使用GDS(95q4c),这是必要的,因为在Skunkware 97上的GNU gcc 2.7.2 没有GNU as。你也可以使用egcs1.1.2或更新:http://www.egcs.com/。如果你正在使用egcs1.1.2,你必须执行下列命令:
    shell> cp -p /usr/include/pthread/stdtypes.h \
    
    
    /usr/local/lib/gcc-lib/i386-pc-sco3.2v5.0.5/egcs-2.91.66/include/pthread/
    
    
    
  2. 对该产品和开发系统,你需要GCC 2.5.?的移植。他们在这个SCO UNIX版本上是必需的,你不能只使用GCC Dev系统。
  3. 你应该得到 FSU Pthreads 包并且首先安装它,它可在http://www.cs.wustl.edu/~ schmidt/ACE_wrappers/FSU-threads.tar.gz找到。你也可以从ftp://www.mysql.com/pub/mysql/Downloads/SCO/FSU-threads-3.5c.tar.gz得到一个预编译的包。
  4. FSU Pthreads能用带tcpip的SCO UNIX 4.2编译,或OpenServer 3.0或Open Desktop 3.0(OS 3.0 ODT 3.0),安装带有使用一个GCC 2.5.X ODT的SCO开发系统,或对OS 3.0你将需要一个GCC 2.5.?的良好移植。 没有一个良好的移植会有很多问题。对这个产品的移植需要SCO UNIX开发系统,没有它,你正缺少所需的库和链接器。
  5. 为了在你的系统上构造FSU Pthreads,做下列工作:
    1. “thread/src”目录下运行./configure并且选择SCO OpenServer选项。这个命令拷贝“Makefile.SCO5”“Makefile”
    2. 运行make
    3. 为了在缺省的“/usr/include”目录安装,作为root登录,然后cd 到“thread/src”目录,并运行make install
  6. 记得在制作MySQL时要使用GNU make
  7. 在OSR 5.0.5上,你应该使用下列配置命令行:
    shell> CC="gcc -DSCO" CXX="gcc -DSCO" ./configure
    
    
    
    需要-DSCO帮助配置正确检测一些线程函数。如果你忘记-DSCO,在编译时,你将得到下列错误消息: 
    my_pthread.c: In function `my_pthread_mutex_init':
    
    
    my_pthread.c:374: `pthread_mutexattr_default' undeclared (first use this function)
    
    
    
    
    
    
  8. 如果你不是作为root启动safe_mysqld,你将可能每进程只有缺省的110个打开文件。mysqld将在日志文件写下关于此的注解。
  9. 用SCO 3.2 V5.0.5,你应该使用一个FSU Pthreads版本3.5c或更新。下列configure命令应该工作:
    shell> CC="gcc -belf" ./configure --prefix=/usr/local/mysql --disable-shared
    
    
    
  10. 用SCO 3.2V4.2,你应该使用一个FSU Pthreads版本3.5c或更新。下列configure命令应该工作:
    shell> CFLAGS="-D_XOPEN_XPG4" CXX=gcc CXXFLAGS="-D_XOPEN_XPG4" \
    
    
           ./configure \
    
    
               --with-debug --prefix=/usr/local/mysql \
    
    
               --with-named-thread-libs="-lgthreads -lsocket -lgen -lgthreads" \
    
    
               --with-named-curses-libs="-lcurses"
    
    
    

    你可能得到一些包括文件的某些问题。在这种情况下,你能在ftp://www.mysql.com/pub/mysql/Downloads/SCO/SCO-3.2v4.2-includes.tar.gz找到新的SCO特定的包括文件。你应该在你的MySQL源代码树的“include”目录下打开这个文件。

SCO开发注意事项:

  • MySQL应该自动地检测FSU Pthreads并且用-lgthreads -lsocket -lgthreads选项链接mysqld
  • SCO开发库在FSU Pthreads是重入(reentrant)的。SCO宣称它的库函数是重入的,因此他们一定在FSU Pthreads中是重入的。在 OpenServer上的 FSU Pthreads 试图使用SCO方案制作重入的库。
  • FSU Pthreads(至少在www.mysql.com的版本)链接了GNU malloc,如果你甭到内存使用的问题,确定“gmalloc.o”被包含在“libgthreads.a”“libgthreads.so”中。
  • 在FSU Pthreads中,下列系统调用是pthreads感知的:read()write()getmsg()connect()accept()select()wait()

如果你想要在SCO上安装DBI,你必须编辑在DBI-xxx和每个子目录下的“Makefiles”

OLD:                                  NEW:


CC = cc                               CC = gcc -belf


CCCDLFLAGS = -KPIC -W1,-Bexport       CCCDLFLAGS = -fpic


CCDLFLAGS = -wl,-Bexport              CCDLFLAGS =





LD = ld                               LD = gcc -belf -G -fpic


LDDLFLAGS = -G -L/usr/local/lib       LDDLFLAGS = -L/usr/local/lib


LDFLAGS = -belf -L/usr/local/lib      LDFLAGS = -L/usr/local/lib





LD = ld                               LD = gcc -belf -G -fpic


OPTIMISE = -Od         		      OPTIMISE = -O1





OLD:


CCCFLAGS = -belf -dy -w0 -U M_XENIX -DPERL_SCO5 -I/usr/local/include





NEW:


CCFLAGS = -U M_XENIX -DPERL_SCO5 -I/usr/local/include


这时如果他们用icccc编译,Perl动态装载器(dynaloader)将不装载DBI模块。

当用cc编译时,Perl工作得最好。

4.11.14 SCO Unixware 7.0 注意事项

你必须使用一个最新的MySQL版本,至少是3.22.13,因为该版本在Unixware下面解决一些移植性问题。

在UnixWare 7.0.1上,我们可用下列configure的命令编译MySQL

shell> CC=cc CXX=CC ./configure --prefix=/usr/local/mysql


4.11.15 IBM-AIX 注意事项

xlC自动检测从Autoconf丢失,当使用 IBM 编译器时,需要如下这样一个configure命令:

shell> CC="xlc_r -ma -O3 -qstrict -DHAVE_INT_8_16_32" \


CXX="xlC_r -ma -O3 -qstrict -DHAVE_INT_8_16_32" \


./configure


如果你正在使用egcs编译MySQL,你必须使用-fno-exceptions标志,因为egcs得异常处理不是对线程安全的!(这用egcs1.1被测试过)。在 AIX 上使用egcsgcc,我们推荐下列configure行:

shell> CXX=gcc \


       CXXFLAGS="-felide-constructors -fno-exceptions -fno-rtti" \


       ./configure --prefix=/home/monty --with-debug --with-low-memory


如果你用信号问题(MySQL出人意料地在高负载下死掉),你可能发现了与线程和信号有关的一个OS错误。在这种情况下,你可以用如下配置告诉MySQL不使用信号:

shell> CFLAGS=-DDONT_USE_THR_ALARM CXX=gcc \


       CXXFLAGS="-felide-constructors -fno-exceptions -fno-rtti -DDONT_USE_THR_ALARM" \


       ./configure --prefix=/home/monty --with-debug --with-low-memory


这不影响MySQL性能,但是有副作用,就是你不能用mysqladmin killmysqladmin shutdown杀死在一个连接上“睡眠”的客户。相反,当客户发出下一个命令时,它将死掉。

在 AIX 的一些版本上用libbind.a链接使得getservbyname核心倾倒(core dump),这是AIX的一个bug并且应该被报告到IBM了。

4.11.16 HP-UX 注意事项

在 HP-UX 上编译MySQL时,有一些“小”问题。我们推荐您使用gcc而不是HP-UX自己的编译器,因为gcc生成更好一些的代码!

我们推荐在HP-UX上使用gcc 2.95,不使用高度优化标志(类似-O6),因为这在 HP-UX 上可能不安全。

注意MIT-pthreads不能用 HP-UX 编译器编译,因为它不能编译.S(汇编器)文件。

下列配置行应该工作:

CFLAGS="-DHPUX -I/opt/dce/include" CXXFLAGS="-DHPUX \


-I/opt/dce/include -felide-constructors -fno-exceptions \


-fno-rtti" CXX=gcc ./configure --with-pthread \


--with-named-thread-libs='-ldce' --prefix=/usr/local/mysql --disable-shared


如果你正在编译gcc2.95本身,如果你想要用MIT-pthreads编译MySQL,你不应该用DCE库(libdce.alibcma.a)链接它。如果你混合DCE和MIT-pthreads包,你将得到一个使得你不能连接的mysqld。当你编译gcc2.95时,删除DCE库!

4.11.17 MacOS X 注意事项

顺着MacOS X移植的链接可以得到能让MySQL载MacOS上工作的信息,见1.8 有用的MySQL相关链接

MySQL3.23.7 应该包括所有必要的MacOSX上配置它的补丁。然而在配置MySQL前,你必须首先安装来自MacOSX 的MySql服务器的pthread 包。

你可能也想要把一个别名加到你的shell资源文件中以便从命令行访问mysqlmysqladmin

alias mysql '/usr/local/mysql/bin/mysql'


alias mysqladmin '/usr/local/mysql/libexec/mysqladmin'


4.12 Win32 注意事项

这节描述在Win32上安装和使用MySQL,这也在MySQL Win32分发所带的“readme”文件中描述。

4.12.1 在Win32上安装MySQL

如果你没有一个注册的MySQL版本,你应该首先下载共享软件版本,从:

MySQL 3.21.29

如果你准备从一些其他程序连接MySQL,你也可能需要MyODBC驱动程序。你可在MySQL下载页找到。

安装任何一个分发,在某个空目录解压缩它并且运行Setup.exe程序。

缺省地,MySQL-Win32被配置安装在“C:\mysql”。如果你想要在其它地方安装MySQL,在“C:\mysql”安装它,然后将安装移到你想要的地方。如果你真的移走MySQL,你必须通过提供选项给mysqld告诉mysqld那里的所有一切,使用C:\mysql\bin\mysqld --help显示所有的选项目!例如,如果你移动MySQL分发到“D:\programs\mysql”,你必须用D:\programs\mysql\bin\mysqld --basedir D:\programs\mysql来启动mysqld。

用登记的MySQL版本,你也可以创建一个“C:\my.cnf”文件来保存用于MySQL服务器的任何缺省选项。拷贝文件“\mysql\my-example.cnf”“C:\my.cnf”并且编辑它来适用于你的安装。注意你应该用"/"而不是"\"指定所有的路径。如果你使用“\”,你需要指定两次(“\\”),因为在MySQL中“\”是转义字符,见4.15.4 选项文件

4.12.2 在Win95/Win98上启动MySQL

MySQL使用 TCP/IP 把一个客户连接到一个服务器。(这将允许在你的网络上任何机器连接你的MySQL服务器)。因此,你必须在启动MySQL前在你的机器上安装TCP/IP,你可以在你的Windows CDROM上找到TCP/IP 。

注意:如果你正在使用一个旧的Win95版本(例如OSR2),很有可能你有一个老的Winsock包!MySQL需要Winsock 2!你可从微软得到最新的Winsock。Win98有新的Winsock 2库作为缺省,这样上述不适用于Win98。

你能使用2个不同的MySQL服务器:

mysqld 用完整调试和自动存储器分配检查编译
mysqld-opt 对Pentium 处理器优化。

上面两个应该在任何 > = i386的Intel处理器上工作  。

为了启动mysqld服务器,你应该启动一个MSDOS窗口并键入:

C:\mysql\bin\mysqld

这将在一个没有窗口的背景启动mysqld

你可以这样杀死MySQL服务器,执行:

C:\mysql\bin\mysqladmin -u root shutdown

注意Win95/Win98不支持命名管道的创建。在Win95/Win98上,你只能使用命名管道连接运行在一个NT服务器上的远程MySQL

4.12.3 在NT上启动MySQL

Win95/Win98小节也适用于在NT上的MySQL,有下列差别:

为了是MySQL用TCP/IP工作,你必须安装服务包3(service pack 3)(或更新)!

对于NT,服务器名字是mysqld-nt。通常你应该在 NT 上安装MySQL作为一种服务:



C:\mysql\bin\mysqld-nt --install

(你可以在 NT 上使用mysqldmysqld-opt服务器,但是那些不能作为一种服务启动或使用命名管道。)

你可以用下列命令启动和停止MySQL服务:

NET START mysql


NET STOP mysql


注意在这种情况下,你不能对mysqld-nt使用任何其他选项!

如果你需要用任何选项启动mysqld-nt,你也可以作为在NT上的一个独立程序运行mysqld-nt!如果你在NT上没有选项启动mysqld-ntmysqld-nt尝试启动自己作为一种有默认选项的服务。如果你停止了mysqld-nt,你必须用NET START mysql启动它。

服务用MySql名字被安装,一旦安装,它必须使用服务控制管理器(SCM)实用程序启动服务(在控制面板中找到)或使用NET START MySQL命令。如果需要任何选项,在你启动MySQL服务前必须作为SCM实用程序的“启动参数”指定它们。一旦运行,可使用mysqladmin或从SCM实用程序或使用命令NET STOP MySQL停止mysqld-nt。如果你使用SCM停止mysqld-nt,SCM有一条关于mysqld shutdown normally奇怪的消息,当作为一种服务运行时,mysqld-nt没有控制台的存取权限,所以没有消息可以看见。

在NT上你可以得到下列服务错误消息:

Permission Denied (权限拒绝) 意味着它不能找到mysqld-nt.exe
Cannot Register (不能登记) 意味着路径是不正确的

如果你作为一种服务安装mysqld-nt有问题,尝试用完整的路径启动它:



C:\mysql\bin\mysqld --install

如果这还不工作,你能通过在注册表修正路径使得mysqld-nt正确启动!

如果你不想作为一种服务启动mysqld-nt,你可以如下启动它:



C:\mysql\bin\mysqld-nt --standalone



C:\mysql\bin\mysqld-nt --standalone --debug

最新的版本在“C:\mysqld.trace”给你一个调试踪迹。

4.12.4 在 Win32 上运行 MySQL

MySQL在所有Win32平台上支持TCP/IP和NT上命名管道。如果客户安装了TCP/IP,缺省是对NT上的本地连接使用命名管道而对所有其他情形使用TCP/IP,主机名指定使用哪个协议:

主机名 协议
空 (没有) 在NT上,首先尝试命名管道;如果它不工作,使用TCP/IP。在Win95/Win98上,使用TCP/IP。
. 命名管道
localhost TCP/IP到当前主机
主机名 TCP/IP

通过指定命名管道--pipe选项,你可以强制一个MySQL客户使用命名管道。使用--socket选项指定管道的名字。

通过执行下列命令,你能测试MySQL是否正在工作:

C:\mysql\bin\mysqlshow


C:\mysql\bin\mysqlshow -u root mysql


C:\mysql\bin\mysqladmin version status proc


C:\mysql\bin\mysql test


如果在Win95/Win98上mysqld很慢地回答连接,可能你的DNS有问题。在这种情况中下,用--skip-name-resolve启动mysqld并且在MySQL授权表中仅使用localhost和IP数字。在你连接运行在NT上一个mysqld-ntMySQL服务器时,使用--pipe指定命名管道使用的参数,你也能避开DNS,对大多数MySQL客户是可行的。

有2个版本的MySQL命令行工具:

mysql 用原生Win32编译,它提供很有有限的文本编辑能力。
mysqlc 用Cygnus GNU 编译器和库编译,它提供readline编辑。

如果你想使用mysqlc.exe,你必须拷贝“C:\mysql\lib\cygwinb19.dll”“\windows\system”(或类似的地方)。

在Win32上缺省的权限给所有本地用户以所有数据库的完全权限。为了使MySQL更安全,你应该为每个用户设置口令并删除mysql.user中有Host='localhost'User=''的行。

你也应该为root用户增加一个口令:(下列例子通过删除匿名用户,允许任何人存取“测试”数据库)

C:\mysql\bin\mysql mysql


mysql> DELETE FROM user WHERE Host='localhost' AND User='';


mysql> QUIT


C:\mysql\bin\mysqladmin reload


C:\mysql\bin\mysqladmin -u root password your_password


在你设置了口令以后,如果你想要关掉mysqld服务器, 你能使用这个命令做到:



mysqladmin -- user=root -- password=your_password  shutdown

如果你正在使用在windows下的MySQL共享软件版本,上面的命令将以 parse error near 'SET OPTION password'的错误而失败,这是因为,这是共享软件版本,它基于MySQL 3.21,没有SET PASSWORD命令。

对共享软件版本,你能如下设置root用户口令:

C:\mysql\bin\mysql mysql


mysql> UPDATE user SET password=PASSWORD('your password') WHERE user='root';


mysql> QUIT


C:\mysql\bin\mysqladmin reload


有注册的MySQL版本,你能很容易地用GRANTREVOKE命令增加新用户和更改权限,见7.26 GRANTREVOKE句法。对Windows 的共享软件版本,必须使用INSERTUPDATEDELETEmysql数据库中的一个表来管理用户和他们的权限,见6.13 存取拒绝(Access denied)的错误原因

4.12.5 用SSH从Win32连接一个远程MySQL

这是一个关于怎样用SSH 得到一个安全的连接远程MySQL服务器的注意事项(David Carlson)。

搞定。它对一个直接的因特网连接工作得很好。我有些问题,SSH与我的Win95网络和Wingate有冲突 - 但是那将是张贴在其他软件公司的用户组的话题!

4.12.6 MySQL-Win32与Unix MySQL比较

MySQL- Win32现在已经证明了自己很稳定。这个版本得MySQL有与对应的Unix版本同样的特征,除了下面:

Win95和线程
Win95 为每个线程的创建损失大约200个字节的内存。因此,如果你进行许多连接,你不应该在Win95运行mysqld很长时间,因为MySQL的每个连接都创建一个新线程!WinNT和Win98不能容忍这个bug。
阻塞式读(blocking read)
MySQL为每个连接使用一个阻塞式读取,这意味着:
  • 一个连接将不在8个小时后自动被断开,就像MySQL的Unix版本所发生的。
  • 如果一个连接“挂起”,不杀死MySQL就不可能打破它。
  • mysqladmin kill在一个睡眠的连接上将不工作。
  • 只要有睡眠的连接,mysqladmin shutdown不能中途中断。

我们计划在不久的将来修正它。

UDF函数
暂时MySQL-Win32不支持用户可定义函数。
DROP DATABASE
你不能抛弃一个正在被某些线程使用的数据库。
从任务管理器杀死MySQL
在Windows95上,你不能从任务管理器或用shutdown实用程序杀死MySQL。你必须用mysqladmin shutdown关闭它。
大小写区分的名字
文件名在Win32上是忽略大小写的,因此Win32上的MySQL数据库和表的名字也是忽略大小写的。唯一的限制是数据库和表的名字必须在整个一个给定的语句中大小写是一样的,因为它用my_tableMY_TABLE都指向同一个表子,下列查询将不工作:
SELECT * FROM my_table WHERE MY_TABLE.col=1; 


“ \ ”目录字符
在Win95上的路径名组成由“\”字符分隔,它在MySQL中也是转义字符。如果你正在使用LOAD DATA INFILESELECT ... INTO OUTFILE,你必须用两个“\”字符或使用Unix风格的文件名“/”字符:
LOAD DATA INFILE "C:\\tmp\\skr.txt" INTO TABLE skr;


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


Can't open named pipe错误
如果你使用NT上的MySQL-Win32共享软件版本,用最新的mysql客户,你将得到下列错误:
error 2017: can't open named pipe to host: . pipe...


这是因为NT上MySQL正式版本缺省地使用命名管道。你能通过为新MySQL客户使用--host=localhost选项或创建一个包含下列信息的文件“C:\my.cnf”来避免这个错误:

[client]


host = localhost


Access denied for user错误
在访问在同一机器上的一个MySQL服务器时,如果你得到Access denied for user: 'some-user@unknown' to database 'mysql'的错误,这意味着MySQL不能正确解释你的主机名。为了修正它,你应该创建一个文件“\windows\hosts”,有下列信息:


127.0.0.1  localhost

对于可能想要帮助我们做好Win32版本的任何人,这里有的一些开放的问题:

  • 制作一个单用户MYSQL.DLL服务器。这应该包括一个标准MySQL服务器的一切,除了线程创建外。这将使MySQL在不需要一个真正的客户机/服务器和不需要从其他主机存取服务器的应用程序时更容易使用。
  • MySQL安装增加一些漂亮的“start”和“shutdown”图标。
  • MySQL启动选项创建造一个工具管理注册表条目。注册表条目的度缺已经被编码进mysqld.cc,但是它应该重新编码而更加面向“参数”,该工具应该也能更新“ \my.cnf”文件,如果用户比较喜欢使用它而不是注册表。
  • 当用--install登记mysqld作为一种服务(在 NT 上 )时,如果你也可以在命令行上增加缺省选项,它将更好,目前解决办法是更新“C:\my.cnf”文件。
  • 当你挂起一个运行Win95的膝上计算机时,当膝上计算机被恢复时,mysqld守护程序不接受新连接。我们不知道这是否 Win95、TCP/IP或MySQL的问题。
  • 能从任务管理器杀死mysqld将绝对是好事,目前,你必须使用mysqladmin shutdown
  • 移植用在 mysql命令行工具的readline到Win32。
  • 标准的GUI版本MySQL客户(mysqlmysqlshowmysqladminmysqldump) 将更好。
  • 如果在“net.c”中的套接字“读”和“写”函数是可中断的,那将更好。这将有可能在Win32上用mysqladmin kill杀死打开的线程。
  • 制作有关哪些Windows程序能工作在MySQL-Win32/MyODBC和必须做什么在能让他们工作的文档。
  • mysqld总是在“C”处启动而不在缺省地点,我们想让mysqld使用当前地点用于排序顺序。
  • 移植sqlclient到Win32(几乎完成)并加入更多的特征!
  • 把更多的选项加到Mysql Manager。
  • 在服务器和客户之间改变通讯协议,使用Windows内部通讯而不是套接字和TCP/IP。
  • .DLL实现UDF函数。
  • 增加宏以使用由Win32提供的更快的对线程安全的增加/减少方法。

其他Win32特定问题在MySQL-Win32分发的“README”文件中描述。

4.13 OS/2 注意事项

MySQL使用太多的打开文件。因此,你应该增加类似下面的东西到你的“CONFIG.SYS”文件:

SET EMXOPT=-c -n -h1024 

如果你不这样做,你将可能碰到下列错误:

File 'xxxx' not found (Errcode: 24) 

当OS/2 Warp 3上使用MySQL时,要求FixPack 29或以上。用OS/2 Wrap 4,要求FixPack 4或以上。这是Pthreads库的一个要求。MySQL必须安装在支持长文件名的一个分区上,如HPFS、FAT32等等。

“INSTALL.CMD”脚本必须从OS/2'自己的“CMD.EXE”运行并且不能工作在替代品如“4OS2.EXE”。

“scripts/mysql-install-db”脚本已经被重新命名了:它现在调用“install.cmd”并且是一个 REXX 手迹,将安装缺省的MySQL安全配置并为MySQL创建WorkPlace Shell 图标。

动态模块支持通过编译但没有充分测试,动态模块应该使用Pthreads运行时刻库编译。

gcc -Zdll -Zmt -Zcrtdll=pthrdrtl -I../include -I../regex -I.. \


    -o example udf_example.cc -L../lib -lmysqlclient udf_example.def


mv example.dll example.udf


注意:由于OS/2的限制,UDF模块名字的词干不能超过8个字符。模块被存储在“/mysql2/udf”目录;safe-mysqld.cmd脚本将把这个目录放在BEGINLIBPATH环境变量中。当使用UDF模块时,指定的扩展名被忽略--它被假定为“.udf”。例如,在 Unix上,共享模块可能被命名为“example.so”并且你可以象这样从它装载函数:

CREATE FUNCTION metaphon RETURNS STRING SONAME "example.so";


正是OS/2,模块将被命名为“example.udf”,但是你不指定模块扩展名: 
CREATE FUNCTION metaphon RETURNS STRING SONAME "example"; 

4.14 TcX二进制代码

作为一种服务,TcX提供一套MySQL的二进制分发,它在TcX或在客户友好地给与我们访问他们机器的权限的站点上被编译。

这些分发用scripts/make_binary_distribution生成并且用下列编译器和选项配置:

SunOS 4.1.4 2 sun4c with gcc 2.7.2.1
CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql --disable-shared
SunOS 5.5.1 sun4u with egcs 1.0.3a
CC=gcc CFLAGS="-O6 -fomit-frame-pointer" CXX=gcc CXXFLAGS="-O6 -fomit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-low-memory
SunOS 5.6 sun4u with egcs 2.90.27
CC=gcc CFLAGS="-O6 -fomit-frame-pointer" CXX=gcc CXXFLAGS="-O6 -fomit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --with-low-memory
SunOS 5.6 i86pc with gcc 2.8.1
CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql --with-low-memory
Linux 2.0.33 i386 with pgcc 2.90.29 (egcs 1.0.3a)
CFLAGS="-O6 -mpentium -mstack-align-double -fomit-frame-pointer" CXX=gcc CXXFLAGS="-O6 -mpentium -mstack-align-double -fomit-frame-pointer -felide-constructors -fno-exceptions -fno-rtti" ./configure --prefix=/usr/local/mysql --enable-assembler --with-mysqld-ldflags=-all-static
SCO 3.2v5.0.4 i386 with gcc 2.7-95q4
CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql
AIX 2 4 with gcc 2.7.2.2
CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql
OSF1 V4.0 564 alpha with gcc 2.8.1
CC=gcc CFLAGS=-O CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql --with-low-memory
Irix 6.3 IP32 with gcc 2.8.0
CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql
BSDI BSD/OS 3.1 i386 with gcc 2.7.2.1
CC=gcc CXX=gcc CXXFLAGS=-O ./configure --prefix=/usr/local/mysql
BSDI BSD/OS 2.1 i386 with gcc 2.7.2
CC=gcc CXX=gcc CXXFLAGS=-O3 ./configure --prefix=/usr/local/mysql

任何有比上述配置更优的选项的人总是能把他们寄给开发者邮件列表中。

MySQL3.22以前的RPM分发是用户贡献的,自3.22开始,一些RPM是TcX 生成的。

4.15 安装后期的设置和测试

一旦你已经安装了MySQL(从一个二进制代码或源代码分发),你需要初始化授权表,启动服务器并且保证服务器正确运行。你也可以希望安排服务器在你的系统开机和关机时自动地被启动和停止。

通常,对从源代码分发的安装,你象这样安装授权表并启动服务器:

shell> ./scripts/mysql_install_db


shell> cd mysql_installation_directory


shell> ./bin/safe_mysqld &


对二进制分发,这样做:

shell> cd mysql_installation_directory


shell> ./bin/mysql_install_db


shell> ./bin/safe_mysqld &


测试在MySQL发行的顶级目录是最容易进行的。对二进制分发,这是你的安装目录(典型地类似“/usr/local/mysql”)。对源代码分发,这是你的MySQL源代码树的主目录。

在本小节和以后的小节中,下列命令中,BINDIR是到程序如mysqladminsafe_mysqld被安装地点的路径。对二进制分发,是在分发内的“bin”目录。对源代码分发,BINDIR可能是“/usr/local/bin”,除非在你运行configure时指定了一个“ /usr/local”以外的安装目录。EXECDIRmysqld服务器安装的地点,对二进制分发,这与BINDIR一样。对源代码分发,EXECDIR可能是“/usr/local/libexec”

测试详细在下面描述:

  1. 如果必要,启动mysqld服务器并且建立初始MySQL授权表,包含决定用户如何被允许连接服务器的权限。这通常用mysql_install_db脚本做:
    shell> scripts/mysql_install_db
    
    
    

    典型地,mysql_install_db仅在你第一次安装MySQL时需要运行,因此,如果你正在升级现有的安装,你可以跳过这一步。(然而,mysql_install_db的使用相当安全,并且将不更新已经存在的任何表,因此如果你是不能肯定做什么,你总是可以运行mysql_install_db。) mysql_install_dbmysql数据库里创建6个表(userdbhosttables_privcolumns_privfunc),初始权限的描述在6.10 设置初始MySQL权限给出。简单地说,这些权限允许MySQL root用户做任何事情,并且允许任何人创建立或使用一个名字以'test''test_'开始的数据库。如果你不设置权限表,当你启动服务器时,下列错误将在日志文件出现:

    mysqld: Can't find file: 'host.frm' 
    
    
    

    如果你不是通过明显地执行./bin/safe_mysqld来启动MySQL,上述错误可能也发生在MySQL二进制代码分发!你可能需要作为root运行mysql_install_db,然而,如果你喜欢, 如果用户能在数据库目录读并且写文件,你可以作为一个非特权(非--root)用户运行MySQL服务器。作为一个非特权用户运行MySQL的指令在18.8 怎样作为一个一般用户运行 MySQL中给出。如果你有mysql_install_db的问题,见4.15.1 运行mysql_install_db的问题。因为mysql_install_dbMySQL发行中,还有一些其他方法运行它:

    • 你可能想在运行mysql_install_db前编辑它,改变被安装到授权表中的初始权限。如果你想要在有相同权限的很多机器安装MySQL,这很有用。在这种情况下,你可能应该只需要增加几个额外的INSERT语句到mysql.usermysql.db表中!
    • 如果你想要在安装授权表后改变什么,你可以运行mysql_install_db,然后使用mysql -u root mysql作为MySQL root用户连接授权表,发出SQL语句直接修改授权表。
    • 在已经创建了授权表后,有可能全部再次创建。如果你已经安装了表但是随后又想要在编辑mysql_install_db以后再创建,你可能想要这样做。

    关于这些选项的更多信息,见6.10 建立初始MySQL权限

  2. 象这样启动MySQL服务器:
    shell> cd mysql_installation_directory
    
    
    shell> bin/safe_mysqld &
    
    
    

    如果你启动服务器的问题,见4.15.2 启动MySQL服务器的问题.

  3. 使用mysqladmin证实服务器正在运行。下列命令提供简单的测试来检查服务器启动和连接的应答:
    shell> BINDIR/mysqladmin version 
    
    
    shell> BINDIR/mysqladmin variables
    
    
    
    mysqladmin version的输出根据你的平台和MySQL版本略有不同,但是应该类似如下显示: 
    shell> BINDIR/mysqladmin version
    
    
    mysqladmin  Ver 6.3 Distrib 3.22.9-beta, for pc-linux-gnu on i686
    
    
    TCX Datakonsult AB, by Monty
    
    
    
    
    
    Server version          3.22.9-beta
    
    
    Protocol version        10
    
    
    Connection              Localhost via UNIX socket
    
    
    TCP port                3306
    
    
    UNIX socket             /tmp/mysql.sock
    
    
    Uptime:                 16 sec
    
    
    
    
    
    Running threads: 1  Questions: 20  Reloads: 2  Open tables: 3
    
    
    

    为了感觉你能用BINDIR/mysqladmin做其他事情,用--help选项调用它。

  4. 证实你能关掉服务器:
    shell> BINDIR/mysqladmin -u root shutdown
    
    
    
  5. 证实你能重启服务器。使用safe_mysqld或直接调用mysqld进行,例如:
    shell> BINDIR/safe_mysqld --log &
    
    
    

    如果safe_mysqld失败,从MySQL安装目录尝试运行它(如果你已经不在那里)。如果还不工作,见4.15.2 启动MySQL服务器的问题

  6. 运行一些简单的测试证实服务器正在工作。输出应该类似于下面所显示的:
    shell> BINDIR/mysqlshow
    
    
    +-----------+
    
    
    | Databases |
    
    
    +-----------+
    
    
    | mysql     |
    
    
    +-----------+
    
    
    
    
    
    shell> BINDIR/mysqlshow mysql
    
    
    Database: mysql
    
    
    +--------------+
    
    
    |    Tables    |
    
    
    +--------------+
    
    
    | columns_priv |
    
    
    | db           |
    
    
    | func         |
    
    
    | host         |
    
    
    | tables_priv  |
    
    
    | user         |
    
    
    +--------------+
    
    
    
    
    
    shell> BINDIR/mysql -e "select host,db,user from db" mysql
    
    
    +------+--------+------+
    
    
    | host | db     | user |
    
    
    +------+--------+------+
    
    
    | %    | test   |      |
    
    
    | %    | test_% |      |
    
    
    +------+--------+------+
    
    
    

    在“sql-bench”目录(在MySQL安装目录下)下还有基准测试套件,你能用来比较在不同的平台上MySQL表现如何。“ sql-bench/Results”目录包含对不同的数据库和平台许多运行结果。为了运行所有的测试,执行这些命令:

    shell> cd sql-bench
    
    
    shell> run-all-tests
    
    
    

    如果你没有“sql-bench”目录,你可能在对二进制分发使用一个RPM(源代码分发的RPM包括基准目录)。在这种情况下,在你能使用它以前,你必须首先安装基准套件。从MySQL 3.22开始,有名为“mysql-bench-VERSION-i386.rpm”的基准RPM包,它们包含基准代码和数据。如果你有源代码分发,你也可以在“tests”子目录下运行测试。例如,运行“auto_increment.tst”,这样做:

    shell> BINDIR/mysql -vvf test < ./tests/auto_increment.tst
    
    
    

    期望的结果被显示在“ ./tests/auto_increment.res”文件中。

4.15.1 运行mysql_install_db的问题

这节列出在你运行mysql_install_db时,你可能遇见的问题:

mysql_install_db不安装授权表
在显示下列消息以后,你可以发现mysql_install_db不能安装授权表并终止:
starting mysqld daemon with databases from XXXXXX


mysql daemon ended


在这种情况下,你应该很小心地检验日志文件!日志文件应该位于目录“XXXXXX”,用错误消息命名,并且应该指出为什么mysqld没启动。如果你不理解发生的事情,当你使用mysqlbug邮寄一份错误报告时,包含日志文件!见2.3 怎样报告错误或问题

已经有一个mysqld守护程序在运行
在这种情况下,你可能根本不必运行mysql_install_db。当你第一次安装MySQL时,你必须只运行mysql_install_db一次。
当一个守护进程正在运行时,安装第二个mysqld守护进程不工作
这只有在当你已经有已存在的MySQL安装但是想要把新安装放在一个不同的地方时才会发生(例如,为了测试或者也许你简单地想要同时运行2个安装)。通常当你试着运行第二个服务器时,发生的问题是它试图和旧一个使用同样的套接字和端口。在这种情况下,你将得到错误消息:Can't start server: Bind on TCP/IP port: Address already in useCan't start server : Bind on unix socket...你能用一个不同的套接字和端口启动新的服务器,如下:
shell> MYSQL_UNIX_PORT=/tmp/mysqld-new.sock


shell> MYSQL_TCP_PORT=3307


shell> export MYSQL_UNIX_PORT MYSQL_TCP_PORT


shell> scripts/mysql_install_db


shell> bin/safe_mysqld &


在这以后,你应该编辑你的服务器引导脚本手迹用不同的套接字和端口启动两个守护进程。例如,它能调用safe_mysqld两次,但是对每次调用使用不同的--socket--port--basedir选项。

你没有“ /tmp ”的写权限
如果你没有写权限在缺省地方(在“/tmp”里)创建一个套接字文件,或没有在“/tmp”创建临时文件的许可,在运行mysql_install_db或当启动或使用mysqld时,你将得到一个错误。你可以如下地指定一个不同的套接字和临时目录:
shell> TMPDIR=/some_tmp_dir/ 


shell> MYSQL_UNIX_PORT=/some_tmp_dir/mysqld.sock 


shell> export TMPDIR MYSQL_UNIX_PORT


“some_tmp_dir”应该是你有写许可的某个目录的路径。在这以后,你应该能运行mysql_install_db并且这些命令启动服务器:

shell> scripts/mysql_install_db


shell> BINDIR/safe_mysqld &


mysqld立刻崩溃
如果你正在运行RedHat 5.0,有一个比2.0.7-5旧的glibc版本,你应该保证你安装了glibc所有补丁!在MySQL邮件档案中有很多关于它的信息。邮件档案的链接可在联机MySQL文档页得到。也可见4.11.5 Linux 注意事项(所有Linux版本)。你也可以手工启动mysqld,使用--skip-grant选项并且增加使用mysql本身的权限信息:
shell> BINDIR/safe_mysqld --skip-grant &


shell> BINDIR/mysql -u root mysql


mysql,手工执行在mysql_install_db里面的SQL命令。保证你随后运行mysqladmin reload告诉服务器再装入授权表。

4.15.2 启动MySQL服务器的问题

通常,你用3个方法之一启动mysqld服务器:

  • 通过调用mysql.server。这个脚本主要用于系统启动和关闭,更全面的描述在4.15.3 自动启动和停止MySQL
  • 通过调用safe_mysqld,它试图为mysqld决定正确的选项并然后用那些选择运行它。
  • 通过直接调用mysqld

无论你使用哪个方法启动服务器,如果它没有正确启动,检查日志文件看你是否能发现为什么。日志文件位于数据目录(对二进制分发一般是“/usr/local/mysql/data”,对源代码分发是“/usr/local/var”)。用“host_name.err”“host_name.log”形式的名字在数据目录下查找文件,这里host_name是你服务器主机的名字,然后检查这些文件的最后几行:

shell> tail host_name.err


shell> tail host_name.log


mysqld守护进程启动时,它把目录改变到数据目录。这是它期望写日志文件和pid(进程ID)文件的地方,和它期望在那儿找到数据库。

数据目录地点是在分发编译时定死的。然而,如果mysqld期望它在你的系统上其他某个地方找到数据目录,它将工作不正常。如果你有不正确路径的问题,你可使用--help选项调用mysqld,找到mysqld允许什么选项和缺省路径设置是什么。你能通过指定正确的路径作为mysqld命令行参数来覆盖缺省值。(这些选择也能用于safe_mysqld。)

通常你应该只需要告诉mysqld基本目录,在它下面安装MySQL。你可以用--basedir选项做到,你也能使用--help检查改变路径选项的效果(注意,--help必须mysqld命令的最后选项)。例如:

shell> EXECDIR/mysqld --basedir=/usr/local --help


一旦你确定你想要的路径设置,不用--help选项启动服务器。

如果你得到下列错误,它意味着mysqld正在试图使用某些其他程序(或其他mysqld服务器)已经正在使用TCP/IP端口或套接字:

Can't start server: Bind on TCP/IP port: Address already in use


  或


Can't start server : Bind on unix socket...


使用ps保证你没有另外一个mysqld服务器正在运行。如果你不能发现其他运行的服务器,你可以尝试执行命令telnet your-host-name tcp-ip-port-number并且按几次RETURN键,如果你没有得到一个错误消息,像telnet: Unable to connect to remote host: Connection refused,某个东西正在使用mysqld正在试图使用的TCP/IP端口,见4.15.1 运行mysql_install_db的问题19.3 在同一台机器上运行多个MySQL服务器

safe_mysqld脚本被编写以便能正常地启动一个从MySQL源代码或二进制代码版本安装的服务器,就算这些在稍微不同的地点安装服务器。safe_mysqld希望这些条件之一是真的:

  • 服务器和数据库能在相对safe_mysqld被调用的目录下找到。safe_mysqld在它的工作目录下面找“bin”“data”目录(对二进制分发)或“libexec”“var”目录(对源代码分发)。如果你从你的MySQL安装目录(例如,对二进制分发为“/usr/local/mysql”)执行safe_mysqld,这个条件应该满足。
  • 如果服务器和数据库不能在相对其工作目录找到,safe_mysqld试图通过绝对路径找到他们。典型的地点是“ /usr/local/libexec”“/usr/local/var”。实际的地点在构造来自分发的safe_mysqld时确定,如果MySQL安装在一个标准的地点,他们应该是正确的。

因为safe_mysqld将试图在相对它自己的工作目录下找到服务器和数据库,你可以在任何地方安装MySQL的二进制分发,只要你从MySQL安装目录启动safe_mysqld即可:

shell> cd mysql_installation_directory


shell> bin/safe_mysqld &


如果safe_mysqld失败,甚至在从MySQL安装目录调用时,你可以修改它以便使用到mysqld路径并且对你的系统的路径选项是正确的。注意,如果在将来你升级MySQL,你的safe_mysqld修改版本将被覆盖,因此你应该做一个你能重新安装的编辑过的版本的拷贝。

如果mysqld当前正在运行,通过执行这个命令,你能发现它正在使用什么路径设置:

shell> mysqladmin variables





或





shell> mysqladmin -h 'your-host-name' variables


如果safe_mysqld启动服务器但是你不能与它连接,你应该保证你在“/etc/hosts”里面有一个条目,看起来像这样:



127.0.0.1  localhost

这个问题仅发生在没有一个能工作的线程库的系统上并且对该系统MySQL必须配置为使用MIT-pthreads。

4.15.3 自动启动和停止MySQL

mysql.server脚本可以被用来启动或停止服务器,通过用startstop参数调用它:

shell> mysql.server start


shell> mysql.server stop


mysql.server可在MySQL安装目录下的“share/mysql”目录里找到,或在MySQL源代码树的“support-files”目录下找到。

mysql.server启动服务器之前,它把目录改变到MySQL安装目录,然后调用safe_mysqld。如果你有在一个非标准的地点安装的二进制分发,你可能需要编辑mysql.server。修改它,运行safe_mysqld前,cd到正确的目录。如果你想要作为一些特定的用户运行服务器,你可以改变mysql_daemon_user=root行使用其他用户,你也能修改mysql.server把其他选项传给safe_mysqld

mysql.server stop通过向服务器发出一个信号停止它。你可手工执行mysqladmin shutdown关闭服务器。

当你开始使用MySQL作为生产应用时,你可能想要增加这些启动并且停止命令到在你的“/etc/rc * 文件中适当的地方。注意如果你修改mysql.server,那么如果某个时候你升级MySQL时,你的修改版本将被覆盖,因此你应该做一个你可重新安装的编辑过的版本的拷贝。

如果你的系统使用“/etc/rc.local”启动外部脚本,你应该添加下列到其中:

/bin/sh -c 'cd /usr/local/mysql ; ./bin/safe_mysqld &' 

你也可以在一个全局“/etc/my.cnf”文件中增加mysql.server的选项。一个典型的“/etc/my.cnf”文件可能看起来像这样:

mysqld]


datadir=/usr/local/mysql/var


socket=/tmp/mysqld.sock


port=3306





[mysql.server]


user=mysql


basedir=/usr/local/mysql


mysql.server脚本使用下列变量:userdatadirbasedirbindirpid-file

4.15.4 选项文件

4.15.4 选项文件

MySQL3.22 可以从选项文件中为服务器和客户读取缺省启动选项。

在Unix上,MySQL从下列文件读取缺省选择:

文件名 用途
/etc/my.cnf 全局选项
DATADIR/my.cnf 服务器特定的选项目
~/.my.cnf 用户特定的选项

DATADIRMySQL的数据目录(典型地对二进制安装是“/usr/local/mysql/data”或对源代码安装是“/usr/local/var”)。注意:这是在配置时间指定的目录,不是mysqld启动时用--datadir指定的目录!(--datadir在服务器寻找选项文件的地方无效,因为它以前寻找他们,它处理任何命令行参数。)

MySQL在Win32上从下列文件读取缺省选项:

文件名 用途
windows-system-directory\my.ini
C:\my.cnf 全局选项
C:\mysql\data\my.cnf 服务器特定的选项

注意,在Win32上你应该用/而不是\指定所有的路径,如果你使用\,你需要指定两个,因为在MySQL里面\是转义字符。

MySQL试图以上述所列的顺序读取选项文件。如果存在多个选项文件,在一个后面文件读取的选项优先于在先前读取的一个文件中指定的同一个选项,在命令行上指定的选项优先于在任何选项文件指定了的选项。有些选择能使用环境变量指定,在命令行或在选项文件指定的选项优先于环境变量。

下列程序支持选项文件:mysqlmysqladminmysqldmysqldumpmysqlimportmysql.servermyisamchkmyisampack

你能使用选项文件指定一个程序支持的任意长的选项!用--help选项运行程序可得到的可用选项的表。

一个选项文件可以包含下列形式的行:

#comment
注释行以“#”“;”开始,空行被忽略。
[group]
group是你想为其设置选项的程序或组的名字。在一个组行后,任何optionset-variable行应用于命名的组,直到选择文件结束或其他组的给出。
option
这等价于在命令行上的--option
option=value
这等价于在命令行上的--option=value
set-variable = variable=value
这等价于在命令行上的--set-variable variable=value。该语法必须被用来设置一个mysqld变量。

client组允许你指定适用于所有MySQL客户的选项(不是mysqld)。这是理想的组来指定你用来与服务器连接的口令。(但是保证只是选项文件本身是可读的和可写的。)

注意,对域选项和值,所有头部和尾部空白自动被删除。你可以在的值串中使用转义顺序“\b”“\t”“\n”“\r”“\\”“\s”(“\s”==空白)。

这是一个典型的全局选项文件:

[client] 


port=3306 


socket=/tmp/mysql.sock 


[mysqld] 


port=3306 


socket=/tmp/mysql.sock 


set-variable = key_buffer=16M 


set-variable = max_allowed_packet=1M 


[mysqldump] 


quick 


这是典型的用户选项文件:

[client]


# The following password will be sent to all standard MySQL clients


password=my_password





[mysql]


no-auto-rehash


如果你有一个源代码分发,你将在“support-files”目录下找到一个名为“my-example.cnf”样品配置文件。如果你有二进制分发,在“DIR/share/mysql”目录下查找,在此DIRMySQL安装目录的路径(一般是“/usr/local/mysql”)。你可以拷贝“my-example.cnf”到你的主目录(重新命名拷贝为“.my.cnf”)来试验。

为了告诉一个MySQL程序不读任何选项文件,在命令行上指定--no-defaults作为第一个选项。这必须是第一个选项,否则它将无效!如果你想检查使用哪个选项,你可以给出--print-defaults选项作为第一个选项。

如果你想要强制使用一个特定配置文件,你可以使用选项--defaults-file=full-path-to-default-file。如果你这样做,只有指定的文件将被读取。

开发者注意:选项文件的处理简单地通过处理所有在任何命令行前参数的匹配选项来实现(即,在适当的组里的选项),这对使用多次指定的一个选项的最后实例的程序工作的很好。如果你有这样一个处理多重指定选项但不读选项文件的旧程序, 你只需要增加2行给与它那种能力。检查任何标准的MySQL客户的源代码看怎样做。

4.16 升级/降级MySQL时有什么特别的事情要做?

只要你有MySQL同一个的基础版本,你总可以在同样的体系结构上的不同版本之间的移动MySQL表格(form)和数据文件。当前的基础版本是3。如果你通过重新编译MySQL改变字符集(也可以改变排序顺序),你必须在所有的表上运行myisamchk -r -q,否则你的索引不能正确被排序。

如果你偏执于或担心新版本,你总能重新命名的旧mysqld为类似于mysqld-'old-version-number'。那么如果你的新mysqld做一些意外的事情,你可以简单地关掉它并重启你的旧mysqld

当你做一个升级时,当然你也应该备份你的旧数据库。有时有点偏执狂是好的!

在升级后,如果你重新编译客户程遇到问题,像Commands out of sync或意外的核心倾倒,在编译你的程序时,你可能使用了一个旧的头文件或库文件。在这种情况下,你应该检查你的“mysql.h”文件和“libmysqlclient.a”库文件的日期以证实他们来自新的MySQL发行。如果不是,请重新编译你的程序!

如果你有些问题,新的mysqld服务器不想启动或你不能没有口令连接,检查你确实没有来自你的旧安装的一些旧的“my.cnf”文件!你可以用program-name --print-defaults检查。如果这输出任何非程序名字的任何东西,你有一个活跃my.cnf文件将可以影响一些事情!

无论何时你安装一个新版本的MySQL,重新构造并重新安装Msql-Mysql-modules分发是一个好主意,特别是在升级MySQL后,如果你注意到诸如你的所有DBI脚本倾倒核心症状。

4.16.1 从一个3.22版本升级到3.23

MySQL 3.23支持新MyISAM类型和旧ISAM类型的表。你不必须变换你的旧式表给3.23使用。缺省地,所有的新表将用类型MyISAM创建(除非你使用--default-table-type=isam选项启动mysqld)。你可以用ALTER TABLE或Perl脚本mysql_convert_table_format将一个ISAM表转换成一个MyISA表

3.22和3.21客户将毫无问题地与一个3.23服务器一起工作。

当升级到3.23时,下面列出你必须注意的事情:

  • INNERDELAYED现在是保留字。
  • FLOAT(X)现在是一个真正的浮点类型。
  • 当声明DECIMAL(length,dec)时,长度参数不再包括一个符号或小数点位置。
  • 一个TIME字符串必须是下列现有格式之一:[[[DAYS] [H]H:]MM:]SS[.fraction][[[[[H]H]H]H]MM]SS[.fraction]
  • 现在,LIKE使用'='同样的字符比较规则比较字符串。如果你要求旧的行为,你可以用CXXFLAGS=-DLIKE_CMP_TOUPPER标志编以MySQL
  • REGEXP现在对正常(不是二进制的)字符串是忽略大小写的。
  • 在你检查/修复表时,对MyISAM表(.MYI),你应该使用myisamchk,而对ISAM(.ISM)表使用isamchk
  • 如果你想要你的mysqldumps在MySQL3.22和3.23之间兼容,你应该不使用mysqldump--opt--full选项。
  • 检查所有对DATE_FORMAT()的调用,保证在在每个格式字符前有一个“%”
  • mysql_fetch_fields_direct现在是函数(它以前是一个宏)并且它返回一个指向MYSQL_FIELD的指针而不是一个MYSQL_FIELD
  • mysql_num_fields()可以不再被用在一个MYSQL*对象上(它现在是一个函数,拿MYSQL_RES*作为一个参数)。相反你现在应该使用mysql_field_count()
  • MySQL3.22,SELECT DISTINCT ...的输出几乎总是被排序的。在3.23上,你必须使用GROUP BYORDER BY获得排序的输出。
  • 如果没有匹配的行,SUM()现在返回NULL,而不是 0。这是遵照ANSI SQL。
  • 新的限制词:CASE、THEN、WHEN、ELSE和END

4.16.2 从一个3.21版本升级到3.22

没有影响相容性的东西在3.21和3.22之间已改变。唯一的缺陷是用DATE类类型创建的新表将使用新方法存储日期。你不能从一个mysqld旧版本存取这些新字段。

在安装MySQL3.22 以后,你应该启动新的服务器并且然后运行mysql_fix_privilege_tables脚本。这将增加你使用GRANT命令所需的新权限。如果你忘记了这个,当你试着使用ALTER TABLE, CREATE INDEXDROP INDEX时,你将得到Access denied。如果你的MySQL根用户要求一个口令,你应该把它作为一个参数给mysql_fix_privilege_tables

mysql_real_connect()的C API接口改变了。如果你有一个旧的客户程序调用该函数,你必须放一个0作为新db参数(或为了快速连接重新编码发送的db单元的客户)。你在mysql_real_connect()前也必须调用mysql_init()!做这个改变允许新的mysql_options()函数在MYSQL处理程序结构中保存选项。

4.16.3 从一个3.20版本升级到3.21

如果你正在运行一个比3.20.28旧的版本并且想要换到3.21.x,你需要做下列事情:

你能用safe_mysqld --old-protocol启动mysqld3.21服务器从3.20分发的客户使用它。在这种情况下,新客户函数mysql_errno()将不返回任何服务器错误,而仅仅是CR_UNKNOWN_ERROR(但是它为客户错误服务)并且服务器使用旧的passwd() 检查而非新的一个。

如果你在而不是mysqld使用--old-protocol选项,你将需要做下列改变:

  • 所有的客户代码必须重新编译。如果你正在使用ODBC,你必须得到新的MyODBC 2.x驱动程序。
  • 脚本scripts/add_long_password必须运行以便变换在mysql.user表中的Password字段为CHAR(16)
  • 所有在mysql.user中的口令必须被重新赋值(为了得到62位而非31位口令)。
  • 表格式没变化,因此你不必须变换任何表。

MySQL3.20.28和以上版本可以处理新的user表格式而不影响客户。如果你有一个比3.20.28早的MySQL版本,如果你变换user表,口令将不再与之工作。因此为了安全,你首先应该升级到至少3.20.28并且然后升级到3.21.x。

新的客户代码可与一个3.20.x 版的mysqld服务器一起工作,因此如果你遇到3.21.x的问题,你可以使用旧的3.20.x服务器而无须重新编译客户。

如果你对mysqld不使用--old-protocol选项,旧的客户将发出错误消息:

ERROR: Protocol mismatch. Server Version = 10 Client Version = 9


新的Perl DBI/DBD接口也支持旧的mysqlperl接口。如果你使用mysqlperl,你必须做的唯一改变是改变到connect()函数的参数。新参数是:hostdatabaseuserpassworduserpassword参数改变了位置)。见20.5.2 DBI接口

下列变化可能影响到旧的应用程序的查询:

  • 现在HAVING必须在任何ORDER BY子句前被指定。
  • LOCATE()参数被交换了。
  • 有一些新的保留字。最著名是DATETIMETIMESTAMP

4.16.4 升级到其他体系结构

如果你正在使用MySQL3.23,你能在不同的支持同样浮点格式的体系结构之间拷贝.frm.MYI.MYD。(MySQL考虑了任何字节交换的问题)。

MySQL ISAM数据“ *.ISD”和索引文件“ *.ISM”文件是依赖于系统结构并在某些情况下依赖于OS。如果你想要移动你的应用程序到有与你当前系统不同的体系结构或OS的其他机器上,你不应该试图通过简单地拷贝文件到另外的机器上来移动一个数据库,相反使用mysqldump

缺省地,mysqldump将创建一个满是SQL语句的文件,然后你可以把文件转移到其他机器上并且把它作为mysql客户的输入。

试一试mysqldump --help看可得到什么选项。如果你正在移动数据到一个更新的MySQL版本,你应该用得到的更新的版本使用mysqldump --opt得到一个快速、紧凑的倒出(dump)。

最容易(尽管不是最快)的在2台机器之间移动一个数据库的方法是在数据库所在的机器上运行下列命令:

shell> mysqladmin -h 'other hostname' create db_name


shell> mysqldump --opt db_name \


        | mysql -h 'other hostname' db_name


如果你想要在一个慢的网络上从一台远程机器上拷贝一个数据库,你可以使用:

shell> mysqladmin create db_name 


shell> mysqldump -h 'other hostname' --opt --compress db_name \ 


	| mysql db_name


你也可以在一个文件中存储结果, 然后把文件转移到目标机器并且在那里装载文件到数据库。例如,你能象这样在源机器上倾倒一个数据库到一个文件:

shell> mysqldump --quick db_name | gzip > db_name.contents.gz 


(本例创建的文件被压缩) 转移包含数据库内容的文件到目标机器,并且在那里运行这些命令:

shell> mysqladmin create db_name


shell> gunzip < db_name.contents.gz | mysql db_name


你也可以使用mysqldumpmysqlimport完成数据库转移。对大数据库表,这比简单地使用mysqldump更快。在下列命令中,DUMPDIR代表你用来存储来自mysqldump的输出的目录的完整的路径。

首先,为输出文件和倾倒数据库创建目录:

shell> mkdir DUMPDIR


shell> mysqldump --tab=DUMPDIR db_name


然后转移在DUMPDIR目录下的文件到目标机器的一些相应目录并且在那里装载文件到MySQL

shell> mysqladmin create db_name           # create database


shell> cat DUMPDIR/*.sql | mysql db_name   # create tables in database


shell> mysqlimport db_name DUMPDIR/*.txt   # load data into tables


另外,别忘记拷贝mysql数据库,因为那是授权表(userdb、host)被存储的地方。你可能必须作为MySQL root用户在新机器上运行命令,直到你让mysql数据库到位。

当你在新机器上导入mysql数据库后,执行mysqladmin flush-privileges以便服务器再次装入授权表信息。


第一章, 前一章, 下一章, 最后一章目录.