本章描述怎樣獲得並安裝MySQL:
檢查MySQL主頁獲得當前版本的信息和下載指令。
然而,TcX的因特網鏈接不是很快的;我們更希望讓你從下列鏡象站點之一進行真正的下載。
請向webmaster@mysql.com報告不存在的或過時的鏡像站點。
歐洲:
北美洲:
加拿大 [ 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
我們使用 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(一個較老的版本)。
首先要作出決策,你是否想要使用最新的開發版本或最終的穩定版本:
- 通常, 如果你是第一次開始使用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的數據可用使用。
在TcX,MySQL進展的相當快,並且我們想要與其它MySQL用戶分享它。當我們有一個看來其它人似乎需要的非常有用的功能時,我們就試著制作一個發行版本。
我們也嘗試幫助那些需要很容易實現的功能的用戶,我們也關注我們授權的用戶想要什,我們更特別關注我們的擴展電子郵件支持的客戶想要什,並且盡力幫助他們。
沒有人一定要下載一個新版本,新聞小節中將告訴你新版本是否有一些你確實想要的東西。見D MySQL 變遷的歷史記錄。
當更新MySQL時,我們使用下列方針:
- 對每個小的改進,在版本字符串的最數字增加1。當有主要的新功能或與先前版本比有較小不兼容性時,在版本字符串的第2數字增加1。當文件格式變化時,第1數字加1。
- 穩定的測試過的版本每年準備出現1-2次,但是如果發現小錯誤,只有錯誤修復的一個版本將被發行。
- 工作版本準備每1-8周出現一次。
- 對一些平台的二進制分發,主要版本由我們制作。其他人可以為其他系統制作二進制分發,但是可能不多見。
- 一旦我們找到並修復了小錯誤,我們通常使用戶可以得到補丁。
- 對非緊急但煩人的錯誤,如果他們被發給我們,我們將使用戶可以得到補丁,否則我們將集中許多錯誤到一個更大的補丁中。
- 在任何情況下,如果在一個發行中有一個致命錯誤,我們將盡快制作一個新版本。我們想其他公司也這樣做。:)
當前的穩定版本是3.22;我們已經轉移到3.23的積極開發中。在穩定版本中,錯誤仍將被修復。我們不相信一個完全凍結,因為這也留下的錯誤修復和“必須做”的事情。“某種程度的凍結”意味著我們可以增加小東西,它“將幾乎肯定不影響已經能工作的任何東西”。
這節描述安裝二進制代碼和源代碼分發時創建的缺省目錄布局。
二進制分發通過在你選擇的安裝地點(典型的“/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”。
你需要下列工具安裝一個MySQL二進制分發:
- GNU
gunzip解壓縮分發。
- 一個適當的
tar解包分發。 GNU tar已知可以。
在Linux下的另一個安裝方法是使用RPM(RedHat包管理器)分發。見4.6.1 Linux RPM 注意事項。
如果你碰到問題,在把問題郵寄到mysql@lists.mysql.com時,請總是使用mysqlbug,就算問題不是一個bug,mysqlbug收集系統信息,將有助其它人解決你的問題。不使用mysqlbug,你將減少得到你問題的一個解決方案的可能性!在你解包分發,你會在“bin”目錄下找到mysqlbug。見2.3 怎樣報告錯誤或問題。
你必須執行以便安裝並使用一個MySQL二進制分發的基本命令是:
shell> gunzip < mysql-VERSION-OS.tar.gz |tar xvf -
shell> ln - s mysql-VERSION-OS mysql
shell> cd mysql
shell> scripts/mysql_install_db
shell> bin/safe_mysqld &
如果你安裝了DBI和Msql-Mysql-modulesPerl模塊,你可以使用bin/mysql_setpermission腳本增加新用戶。
以下是更詳細的描述:
對安裝二進制分發,遵循以下步驟,然繼續到4.15 安裝期的設置與測試,進行安裝期的設置和測試:
- 挑選一個你想解開分發包的目錄,進入給目錄。在下面的例子中,我們將分發解包在“/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
安裝期的設置和測試。
在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二進制代碼分發。
如果你編譯你自己寫的或你從第三方獲得的MySQL客戶程序,他們必須用link命令的-lmysqlclient選項進行鏈接。你可能也需要指定一個
-L
選項,告訴鏈接器在哪兒查找庫文件。例如,如果庫文件安裝在“/usr/local/mysql/lib”裡,在鏈接命令上使用
-L/usr/local/mysql/lib -lmysqlclient。
對使用MySQL頭文件的客戶程序,當你編譯他們時,你可能需要指定一個
-I 選項(例如,-I/usr/local/mysql/include),
使得編譯器能找到頭文件。
下一節說明在從一個二進制分發安裝MySQL時,已經在特定的系統上觀察到已發生過一些問題。
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或更新。
針對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的一個拷貝。
你需要下列工具構造並安裝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 怎樣報告錯誤或問題。
你必須執行的安裝MySQL源代碼分發的基本命令是(從一個解包的tar文件):
shell>configure
shell>make
shell>make install
shell>scripts/mysql_install_db
shell>/usr/local/mysql/bin/safe_mysqld &
如果你從一個源代碼RPM開始,那執行如下命令。
shell> rpm -- rebuild MySQL-VERSION.src.rpm
這樣你制作一個可以安裝的二進制RPM。
如果你安裝了DBI和Msql-Mysql-modulesPerl模塊,你可以利用bin/mysql_setpermission腳本增加新用戶。
以下是更詳細的描述:
為了安裝源代碼分發,按照下列步驟,然繼續到4.15 安裝期的設置與測試,進行安裝期的初始化與測試。
- 挑選一個你要在其下面解包分發的目錄,並且進入該目錄。
- 從節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
安裝期的設置與測試。
有時補丁出現在郵件列表上或放在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)。如果一個程序的新版本替代當前正在執行的版本,一些系統不允許你安裝它。
configure腳本給你一個很大的控制權來如何配置你的MySQL分發。典型地,你使用configure命令行的選項進行。你也可以用正確的環境變量作用configure。對一個由configure支持的選擇列表,運行這個命令:
shell> ./configure -- help
一些更常用的configure選項見下面的描述:
- 只編譯MySQL客戶庫和客戶程序而不是服務器,使用
--without-server選項:
shell> ./configure --without-server
如果你沒有一個 C++ 編譯器,mysql將不編譯(有一個客戶程序需要C++)。在這種情況下,你可以去掉configure裡面測試C++編譯器的代碼,然運行帶有
--without-server選項的./configure。編譯步驟步將仍然嘗試構造mysql,但是你可以忽略任何關“
mysql.cc ”的警告。(如果make停止,試試make -k告訴它即使出錯繼續剩下的構造步驟)。
- 如果你不想要位“/usr/local/var”目錄下面的日志(log)文件和數據庫,使用類似下列
configure命令的一個:
shell>./configure--prefix=/usr/local/mysql
shell>./configure--prefix=/usr/local --localstatedir=/usr/local/mysql/data
第一個命令改變安裝前綴以便任何東西被安裝在“/usr/local/mysql”下面而非缺省的“/usr/local”。第二個命令保留缺省安裝前綴,但是覆蓋了數據庫目錄缺省目錄(通常是“/usr/local/var”)並且把它改/usr/local/mysql/data.
- 如果你正在使用Unix並且你想要MySQL的套接字位缺省地點以外的某個地方(通常在目錄“/tmp”或“/var/run”,使用象這樣的
configure的命令:
shell> ./configure -- with-unix-socket-path=/usr/local/mysql/tmp/mysql.sock
注意給出的文件必須是一個絕對路徑!
- 如果你想編譯靜態鏈接程序(例如,制作二進制分發、獲得更快的速度或與解決與RedHat分發的一些),像這樣運行
configure:
shell>./configure --with-client-ldflags=-all-static --with-mysqld-ldflags=-all-static
- 如果你正在使用
gcc並且沒有安裝libg++或libstdc++,你可以告訴configure使用gcc作為C++編譯器:
shell> CC=gcc CXX=gcc ./configure
當你使用時gcc作為C++編譯器是,它將不試圖鏈接libg++或libstdc++。如果構造失敗並且產生有關編譯器或鏈接器的錯誤,不能創建共享庫“libmysqlclient.so.#”(“#”是一個版本號),
你可以通過為configure指定--disable-shared選項來解決此問題。在這種情況下,configure將不構造一個共享libmysqlclient.so.#庫。
- 你可以設置MySQL對非
NULL的列不使用DEFAULT列值(即,不允許列是NULL)。這導致INSERT語句產生一個錯誤,除非你明確地為所有要求非NULL值的列指定值。為了禁止使用缺省值,這樣運行configure:
shell> CXXFLAGS=-DDONT_USE_DEFAULT_FIELDS ./configure
- 缺省地,MySQL使用ISO-8859-1(Latin1)字符集。為了改變缺省設置,使用
--with-charset選項目:
shell> ./configure -- with-charset=CHARSET
CHARSET可以是big5、cp1251、cp1257、czech、danish、dec8、dos、euc_kr、gb2312
gbk、german1、hebrew、 hp8、hungarian、koi8_ru、koi8_ukr、latin1、latin2、sjis、swe7、tis620、ujis、usa7、win1251或win1251ukr之一。見9.1.1 用數據和排序的字符集。注意:如果你想要改變字符集,你必須在配置期間做make
distclean!如果你想在服務器和客戶之間變換字符,你應該看一下SET
OPTION CHARACTER SET命令。見7.25
SET OPTION句法。警告:如果你在創建了任何數據庫表之改變字符集,你將必須對每個表運行myisamchk
-r -q,否則你的索引可能不正確地排序。(如果你安裝了MySQL,創建一些表,然重新配置MySQL使用一個不同的字符集並且重新安裝它,這時就可能發生這種情況。)
- 為了配置MySQL帶有調試代碼,使用
--with-debug選項:
shell> ./configure --with-debug
這導致包含一個安全的內存分配器,能發現一些錯誤和並提供關正在發生的事情的輸出。見G.1調試一個MySQL服務器。
- 屬特定系統的選項可在本章特定系統的小節裡找到。見4.11 系統特定的問題。
所有MySQL程序在Solaris上使用gcc編譯並且沒有任何警告。在其他系統上,由系統包含文件的差別可能會發生警告。對使用MIT-pthreads時發生的警告,見4.9 MIT-pthreads 注意事項。其他問題,檢查下面的表。
許多問題的解決方案涉及重新配置。如果你確實需要重新配置,注意下列事項:
- 如果
configure在它已經被運行了以運行,它可以使用先前收集的信息。這個信息被存儲在“config.cache”裡面。當configure啟動時,它尋找該文件而且如果它存在,假定信息仍然是正確的,讀入它的內容。當你重新配置時,該假設是無效的。
- 每次你運行
configure時候,你必須運行make再重新編譯。然而,
你可能想要把先前構造的老的目標文件刪除,因為他們使用不同的配置選項被編譯。
為了防止使用舊的配置信息或目標文件,在重新運行configure前運行這些命令:
shell>rm config.cache
shell>make clean
另外,你可以運行make distclean。
下表描述了一些最常發生的編譯MySQL的問題:
- 如果在編譯“sql_yacc.cc”時,你得到如下的一個錯誤,你可能是存儲器或交換空間溢出:
Internal compiler error: program cc1plus got fatal signal 11
或
Out of virtual memory
或
Virtual memory exhausted
該問題是gcc要求大量的內存編譯帶有嵌入函數(inline
function)的“sql_yacc.cc”。試試以--with-low-memory選項運行configure:
shell>./configure -- with-low-memory
如果你正在使用gcc,該選項使得將-fno-inline加到編譯行,如果你正在使用其他的編譯器,則加入-O0。你應該試一試--with-low-memory選項,即使你有特別多的存儲器和交換空間,而你認為不能可能運行得溢出。這個問題甚至在很慷慨的硬件配置的系統上出現,通常用--with-low-memory選項修正它。
- 缺省地,
configure挑選c++作為編譯器名字並用-lg++選項的GNU
c++鏈接。如果你正在使用gcc,這個特性在配置期間導致如下問題:
configure: error: installation or configuration problem:
C++ compiler cannot create executables.
你可能也在編譯期間看到g++、libg++或libstdc++相關的問題。這些問題的一個原因是你可能沒有g++,或你可能有g++但無libg++或libstdc++。看一下“config.log”文件。它應該包含你的c++編譯器不能工作的準確原因!為了解決這些問題,你可以使用gcc作為你的C++編譯器。試試設置環境變量CXX為"gcc
-O3"。例如:
shell>CXX="gcc -O3" ./configure
它能工作,因為gcc象g++一樣編譯C++源代碼,但缺省地它不鏈接libg++或libstdc++。解決這些問題的其他方法當然是安裝g++、libg++和libstdc++。
- 如果你的編譯以下面任何錯誤而失敗,你必須升級
make版本到GNUmake:
making all in mit-pthreads
make: Fatal error in reader: Makefile, line 18:
Badly formed macro assignment
or
make: file `Makefile' line 18: Must be a separator (:
or
pthread.h: No such file or directory
Solaris和FreeBSD已知make程序有問題。GNU
make版本3.75已知能工作。
- 如果你想要定義你的C或C++編譯器所使用的標志,把標志加到
CFLAGS和CXXFLAGS環境變量中即可。你也能使用CC和CXX來指定編譯器名字。例如:
shell>CC=gcc
shell>CFLAGS=-O6
shell>CXX=gcc
shell>CXXFLAGS=-O6
shell>export CC CFLAGS CXX CXXFLAGS
對已經知道在不同系統上有用的標志定義列表,見4.14 TcX 二進制代碼。
- 如果你得到象如下的一條錯誤消息,你需要升級你的
gcc編譯器:
client/libmysql.c:273: parse error brfore '__attribute__'
gcc2.8.1已知可以工作,但是我們推薦使用egcs1.0.3a或更新。
- 如果你在編譯
mysqld時顯示例如下面的那些錯誤, configure沒有正確地檢測傳到accept()、getsockname()或getpeername()最參數的類型:
cxx: Error: mysqld.cc, line 645: In this statement, the referenced
type of the pointer value "&length" is "unsigned long", which
is not compatible with "int".
new_sock = accept(sock, (struct sockaddr *)&cAddr, &length);
為了修正它,編輯“config.h”文件(它由configure生成)。尋找這些行:
/* Define as the base type of the last arg to accept */
#define SOCKET_SIZE_TYPE XXX
更改XXX為size_t或int,這取決你的操作系統。(注意:你每次運行configure都必須這樣做,因為configure重新生成“config.h”。)
- “sql_yacc.cc”文件由“sql_yacc.yy”生成。通常構造過程不需要創造“sql_yacc.cc”,因為MySQL有一個已經生成的拷貝,然而,如果你確實需要再創建它,你可能碰到這個錯誤:
"sql_yacc.yy", line xxx fatal: default action causes potential...
這是一個你的yacc版本不完善的跡象。你可能需要安裝bison(GNU
版本yacc)並使用它。
- 如果你需要調試
mysqld或MySQL客戶,運行configure,使用--with-debug選項,然重新編譯並且鏈接你客戶程序到新的客戶庫。見G.2 調試一個MySQL客戶。
這節描述在使用 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選項告訴服務器使用系統鎖定。
- 有時pthread
bind()命令不能綁定一個套接字但沒有任何錯誤消息(至少在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上工作。(這不需要,但是可能某些人有興趣。)
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個過程是相同的。
- 解包分發到當前目錄:
shell> gunzip < Data-Dumper-VERSION.tar.gz | tar xvf -
這個命令創建的一個名為“Data-Dumper-VERSION”的目錄。
- 進入解包分發的頂級目錄:
shell> cd Data-Dumper-VERSION
- 構造分發並且編譯所有東西:
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下面查找。
在 Win32 上安裝 ActiveState Perl的MySQL DBD的模塊,
你應該做下列步驟:
- 打開一個DOS shell。
- 如果需要,設置HTTP_proxy變量。例如, 你可以試一試:
set
HTTP_proxy=my.proxy.com:3128
- 啟動PPM程序:
C:\perl\bin\ppm.pl
- 如果你還沒有這樣做,安裝
DBI: install DBI
- 如果成功,安裝
DBD::mysql:http://www.mysql.com/Contrib/ppd/DBD-mysql.ppd
如果你不能使上述步驟工作,你應該安裝MyODBC驅動程序並且通過ODBC連接MySQL服務器。
use DBI;
$dbh= DBI->connect("DBI:ODBC:$dsn","$user","$password") ||
die "Got error $DBI::errstr when connecting to $dsn\n";
MySQL Perl分發包含DBI、DBD:MySQL和DBD:ODBC。
- 從http://www.mysql.com/download.html得到Win32的Perl分發。
- 在
C:解壓縮分發,這樣你得到一個“C:\PERL”目錄。
- 增加目錄“C:\PERL\BIN”到你的路徑。
- 增加目錄“C:\PERL\BIN\MSWin32-x86-thread”或“C:\PERL\BIN\MSWin32-x86”到你的路徑。
- 在 DOS shell執行
perl -v測試perl的運行。
如果 Perl 報告它不能找到../mysql/mysql.so模塊,那問題可能是該Perl不能找到共享庫文件“libmysqlclient.so”。
你可用下列任何一個方法修正它這:
- 用
perl Makefile.PL -static而非perl Makefile.PL編譯Msql-Mysql-modules分發。
- 拷貝
libmysqlclient.so到其他共享庫文件所在的目錄(可能是“/usr/lib”或“/lib”)。
- 在
Linux上,你可以把libmysqlclient.so所在目錄的路徑名加到“/etc/ld.so.conf”文件中。
- 把
libmysqlclient.so所在目錄的路徑名加到LD_RUN_PATH環境變量中。
如果你從DBD-mysql得到下列錯誤,你可能正在使用gcc(或使用一個舊的用gcc編譯的二進制代碼):
/usr/bin/perl: can't resolve symbol '__moddi3'
/usr/bin/perl: can't resolve symbol '__divdi3'
當“mysql.so”庫文件被構造時候,為鏈接命令加上-L/usr/lib/gcc-lib/...
-lgcc(當你編譯Perl客戶時檢查針對“mysql.so”的make輸出)。-L選項應該指定“libgcc.a”在你系統上所在目錄的路徑名。
這個問題的另一個原因可能是Perl和MySQL都不是用gcc編譯的。在這種情況下,你可以都用gcc編譯以解決不匹配。
如果你想要在一個不支持動態鏈接(象SCO那樣)的系統上使用Perl模塊,你可以產生包括DBI和DBD-mysql的Perl的一個靜態版本。這種運行方法是你生成一個鏈接了DBI代碼的Perl版本並在最新的Perl上安裝它,然你使用它來構造附加鏈接了DBD代碼的Perl版本,並且安裝它。
在 SCO 上,你必須有下列環境變量設置:
shell> LD_LIBRARY_PATH=/lib:/usr/lib:/usr/local/lib:/usr/progressive/lib
或
shell> LD_LIBRARY_PATH=/usr/lib:/lib:/usr/local/lib:/usr/ccs/lib:/usr/progressive/lib:/usr/skunk/lib
shell> LIBPATH=/usr/lib:/lib:/usr/local/lib:/usr/ccs/lib:/usr/progressive/lib:/usr/skunk/lib
shell> MANPATH=scohelp:/usr/man:/usr/local1/man:/usr/local/man:/usr/skunk/man:
首先, 在DBI分發所在目錄下運行下列命令,創造包括一個靜態鏈接的Perl
DBI:
shell> perl Makefile.PL LINKTYPE=static
shell> make
shell> make install
shell> make perl
然你必須安裝新的Perl。make perl的輸出將顯示正確的你需要執行施行安裝的make的命令。在SCO上,是make
-f Makefile.aperl inst_perl MAP_TARGET=perl.
接下來,在Msql-Mysql-modules分發所在目錄下,使用剛才創建的Perl來創建同樣包括一個靜態鏈接的PerlDBD::mysql的另一個Perl:
shell> perl Makefile.PL LINKTYPE=static
shell> make
shell> make install
shell> make perl
最, 你應該安裝這個新的Perl。而且,make perl的輸出指出使用的命令。
下面的章節說明在從源代碼分發安裝MySQL時,發生在特定的系統上並已觀察到的一些問題。
在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
增加-mt到CFLAGS和CXXFLAGS並且再試一試。
如果你在用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不提供所有系統庫的靜態版本(libpthreads和libdl),所以你不能用--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的環境變量中。
通常你能在 Solaris 2.7 上使用 Solaris 2.6 二進制代碼。大多數Solaris
2.6 的問題也適用Solaris 2.7。
注意:MySQL3.23.4 和更高版本應該能自動檢測 Solaris 2.7
並且啟用下列問題的解決辦法!
Solaris 2.7 在包括文件中有一些bu
(http://www.fanqiang.com)
進入【