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

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 mysqlshell> cd mysqlshell> scripts/mysql_install_dbshell> bin/safe_mysqld &
如果你安装了DBI和Msql-Mysql-modulesPerl模块，你可以使用bin/mysql_setpermission脚本增加新用户。
以下是更详细的描述：
对于安装二进制分发，遵循以下步骤，然后继续到4.15 安装后期的设置与测试，进行安装后期的设置和测试： 挑选一个你想解开分发包的目录，进入给目录。在下面的例子中，我们将分发解包在“/usr/local”下并且创建一个安装MySQL的“/usr/local/mysql”目录。（因此，下列指令假设你有权限在“/usr/local”中创建文件，如果该目录被保护，你需要以root实施安装。) 从4.1 怎样获得MySQL中列出的站点之一获得一个分发文件。MySQL二进制分发以压缩的tar文档提供，并且有类似“mysql-VERSION-OS.tar.gz”的名字，这里VERSION是一个数字(例如，3.21.15)，且OS表明分发能运行的操作系统类型(例如，pc-linux-gnu-i586)。 解开分发并且创建立安装目录： shell> gunzip < mysql-VERSION-OS.tar.gz |tar xvf - shell> ln - s mysql-VERSION-OS mysql
第一个命令创建一个名为“mysql-VERSION-OS”的目录，第二个命令生成到该目录的一个符号链接。这让你更容易地把安装目录指定为“/usr/local/mysql”。
进入安装目录： shell> cd mysql
你会在mysql目录下发现几个文件和子目录，对安装目的最重要的是“bin”和“scripts”子目录。 “bin” 这个目录包含客户程序和服务器，你应该把这个目录的完整路径加到你的PATH环境变量，以便你的shell能正确的找到MySQL程序。 “scripts” 这个目录包含mysql_install_db脚本，用来初始化服务器存取权限。
如果你想使用mysqlaccess而在某个非标准的地点有MySQL分发，你必须改变地点，在哪儿mysqlaccess期望找到mysql客户。编辑“bin/mysqlaccess”脚本，大约在第18行，寻找类似下面的行： $MYSQL = “/usr/local/bin/mysql”;　# path to mysql executable
改变路径以反映出mysql实际存储在你系统上的地点。如果你不这样做，当你运行mysqlaccess时，你将得到一个broken pipe的错误。
创造MySQL授权表(只有在你以前没安装过MySQL是必要的)： shell> scripts/mysql_install_db
注意当你运行时mysql_install_db时，比版本3.22.10老的MySQL版本启动MySQL服务器。这不再是真的了！
如果你想要安装对Perl DBI/DBD接口的支持，见4.10 Perl安装注意事项。 如果你喜欢在引导机器时自动启动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>configureshell>makeshell>make installshell>scripts/mysql_install_dbshell>/usr/local/mysql/bin/safe_mysqld &
如果你从一个源代码RPM开始，那么执行如下命令。
shell> rpm -- rebuild MySQL-VERSION.src.rpm
这样你制作一个可以安装的二进制RPM。
如果你安装了DBI和Msql-Mysql-modulesPerl模块，你可以利用bin/mysql_setpermission脚本增加新用户。
以下是更详细的描述：
为了安装源代码分发，按照下列步骤，然后继续到4.15 安装后期的设置与测试，进行安装后期的初始化与测试。 挑选一个你要在其下面解包分发的目录，并且进入该目录。 从节4.1 怎样获得MySQL中列出的站点之一获得一个分发文件。MySQL源代码分发以压缩的tar档案提供，并且有类似于“mysql-VERSION.tar.gz”的名字，这里的VERSION是一个类似3.23.7-alpha的数字。 在当前目录下解包分发： shell> gunzip < mysql-VERSION.tar.gz | tar xvf -
这个命令创建名为“mysql-VERSION”的一个目录。
进入解包分发的顶级目录： shell> cd mysql-VERSION 设置发行版本并且编译： 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 编译问题？，帮助解决很多常见问题。
安装所有东西： shell>make install
你可能需要root用户来运行这个命令。
创造MySQL授权表(只有你以前没安装MySQL是必需的)： shell>scripts/mysql_install_db
注意，在运行mysql_install_db时，那些比3.22.10旧的MySQL版本启动MySQL服务器。现在不是这样了！
如果你想要安装对Perl DBI/DBD接口的支持，见4.10 Perl安装注意说明。 如果你想要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 安装后期的设置与测试。