mysql-logo.gif (3082 bytes)MySQL中文參考手冊

譯者:晏子 (clyan@sohu.com
GB 碼主頁:http://linuxdb.yeah.net

Big5 轉碼者:statue (statue@bbs.yzu.edu.tw
詞彙轉換:彭武興 (wilson@mailbox.com.tw)
Big5 碼主頁: http://cnpa.yzu.edu.tw/~cfc/docs/mysqldoc_big5/manual_toc.html
Big5 碼分站: http://php.wilson.gs/mysqldoc/big5/manual_toc.html


第一章, 前一章, 下一章, 最後一章目錄.


4 安裝MySQL

本章描述怎樣獲得並安裝MySQL

4.1 怎樣獲得MySQL

檢查MySQL主頁獲得當前版本的資訊和下載指令。

然而,TcX的網際網路鏈接不是很快的﹔我們更希望讓你從下列鏡像站點之一進行真正的下載。

請向webmaster@mysql.com報告不存在的或過時的鏡像站點。

歐洲:

北美洲:

南美洲:

亞洲:

澳洲:

非洲:

4.2 MySQL 支援的作業系統

我們使用 GNU Autoconf,因此將MySQL移植到所有使用 Posix 執行緒和一個 C++ 編譯器的現代系統是可能的。(僅僅為了編譯客戶代碼,只需要一個 C++ 編譯器而不是執行緒)。我們主要在Sun Solaris(版本 2.5 & 2.6)上使用並開發軟件本身,而RedHat Linux 5.0 居其次。

MySQL已經被報告在下列作業系統/執行緒包的組合上成功地編譯。注意,對很多作業系統,原生的執行緒支援僅工作於最新的版本。

4.3 使用MySQL哪個版本

首先要作出決策,你是否想要使用最新的開發版本或最終的穩定版本:

要做的第二項決策是你是否想要使用原始碼版本或可執行檔版本:

MySQL的命名機制使用由3個數字和一個後綴組成的版本號。例如,一個像mysql-3.21.17-beta的版本號這樣解釋:

MySQL所有版本都經過我們的標準測試和效能測試運行,以保証他們可相當安全地使用。因為標準測試不斷擴充以檢測以前發現的錯誤,測試套件一直在改進之中。

注意,所有版本都至少已經用下列套件進行了測試:

一個內部測試套件
這是一個客戶生產系統的一部分。它可能有很多幾百個兆字節數據的資料庫表。
MySQL效能測試套件
它運行一定範圍的常用查詢。它也是一個測試,檢測最新的最佳化處理是否真的使代碼更快。見10.8 使用你自己的效能測試
crash-me測試
這嘗試決定資料庫支援什麼功能和它的能力與限制是什麼。見10.8 使用你的自己效能測試

其他測試是在內部的生產環境中使用最新MySQL版本,至少在一台機器上。我們有超過100GB的數據可用使用。

4.4 怎樣和何時發布更新版本

在TcX,MySQL進展的相當快,並且我們想要與其它MySQL用戶分享它。當我們有一個看來其它人似乎需要的非常有用的功能時,我們就試著制作一個發行版本。

我們也嘗試幫助那些需要很容易實現的功能的用戶,我們也關注我們授權的用戶想要什麼,我們更特別關注我們的擴展電子郵件支援的客戶想要什麼,並且盡力幫助他們。

沒有人一定要下載一個新版本,新聞小節中將告訴你新版本是否有一些你確實想要的東西。見D MySQL 變遷的歷史記錄

當更新MySQL時,我們使用下列方針:

當前的穩定版本是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” 資料庫和日誌文件。

在一個安裝目錄內,原始程式安裝的布局在下列方面不同於二進制安裝:

4.6 安裝MySQL可執行檔版本

你需要下列工具安裝一個MySQL可執行檔版本:

在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文件有:

查看一個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的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原生執行緒包構造。

其他可以運行的配置:

下列配置幾乎肯定不能運行:

為了安裝分發,使用下面的命令之一, 這裡/path/to/depot是倉庫文件的完整路徑:

depot在“/opt/mysql”存放二進制代碼和庫文件並在“/var/opt/mysql”存放數據。depot也在“/sbin/init.d”“ /sbin/rc2.d”裡創建適當的入口以自動地在引導時啟動伺服器。顯然, 這有必要以root身份來安裝。

為了安裝HP-UX tar分發,你必須有GNU tar的一個拷貝。

4.7 安裝MySQL原始碼版本

你需要下列工具構造並安裝MySQL原始程式:

如果你遇到問題,當向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選項見下面的描述:

4.8 編譯問題?

所有MySQL程式在Solaris上使用gcc編譯並且沒有任何警告。在其他系統上,由於系統包含文件的差別可能會發生警告。對於使用MIT-pthreads時發生的警告,見4.9 MIT-pthreads 注意事項。其他問題,檢查下面的表。

許多問題的解決方案涉及重新配置。如果你確實需要重新配置,注意下列事項:

為了防止使用舊的配置資訊或目標文件,在重新運行configure前運行這些命令:

shell>rm  config.cache 
shell>make clean

另外,你可以運行make distclean

下表描述了一些最常發生的編譯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 支援的作業系統

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的模組, 你應該做下列步驟:

如果你不能使上述步驟工作,你應該安裝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

4.10.4 使用PerlDBI/DBD介面的問題

如果 Perl 報告它不能找到../mysql/mysql.so模組,那麼問題可能是該Perl不能找到共享庫文件“libmysqlclient.so”

你可用下列任何一個方法修正它這:

如果你從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

這個問題能用下列方法之一避免:

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 `;'

解決它的方案是做下列步驟之一:

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

當執行它們時,這個問題可用下列方法之一避免:

如果你正在使用 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 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開發注意事項:

如果你想要在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為每個連接使用一個阻塞式讀取,這意味著:

我們計劃在不久的將來修正它。

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版本的任何人,這裡有的一些開放的問題:

其他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發行中,還有一些其他方法運行它:

    關於這些選項的更多資訊,見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伺服器:

無論你使用哪個方法啟動伺服器,如果它沒有正確啟動,檢查日誌文件看你是否能發現為什麼。日誌文件位於數據目錄(對可執行檔版本一般是“/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將試圖在相對它自己的工作目錄下找到伺服器和資料庫,你可以在任何地方安裝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時,下面列出你必須注意的事情:

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選項,你將需要做下列改變:

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介面

下列變化可能影響到舊的應用程式的查詢:

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以便伺服器再次裝入授權表資訊。


第一章, 前一章, 下一章, 最後一章目錄.