15.4. 安裝過程 · PostgreSQL 中文文檔 9.3

# 15.4\. 安裝過程 1. **配置** 安裝過程的第一步就是配置源代碼樹并選擇你喜歡的選項。這個工作是通過運行`configure`腳本實現的，對于缺省安裝，你只需要簡單地敲入: ``` <kbd class="literal">./configure</kbd> ``` 該腳本將運行一些測試來決定一些系統相關的變量，并檢測操作系統的設置，最后將在編譯樹中創建一些文件以記錄它找到了什么。如果你想保持編譯目錄的獨立，那么你也可以在源代碼樹之外的其它目錄里運行`configure`。這個過程也被稱為_VPATH_ 編譯。這里是方法： ``` <kbd class="literal">mkdir build_dir</kbd> <kbd class="literal">cd build_dir</kbd> <kbd class="literal">/path/to/source/tree/configure [options go here]</kbd> <kbd class="literal">gmake</kbd> ``` 缺省設置將編譯服務器和應用程序，還有所有只需要C編譯器的客戶端程序和接口。缺省時所有文件都將安裝到`/usr/local/pgsql`目錄。你可以通過給出下面的一個或多個`configure`命令行選項來自定義編譯和安裝過程： `--prefix=``_PREFIX_` 把所有文件裝在`_PREFIX_`目錄下而不是`/usr/local/pgsql`里。實際的文件會安裝到不同的子目錄里；甚至沒有一個文件會直接安裝到`_PREFIX_`目錄里。如果你有特殊需要，你還可以用下面的選項自定義不同子目錄的位置。不過，即使你保持缺省設置，安裝時浮動的，意味著可以在安裝之后移動目錄(`man`和`doc`位置不受影響)。為了浮動安裝，你可能需要使用`configure`的`--disable-rpath`選項。還有，你需要告訴操作系統如何找到共享庫。 `--exec-prefix=``_EXEC-PREFIX_` 把體系相關的文件安裝到`_EXEC-PREFIX_`，而不是`_PREFIX_`設置的地方。這樣做可以比較方便地在不同主機之間共享體系相關的文件。如果你省略它，那么`_EXEC-PREFIX_`就會被設置為等于`_PREFIX_`并且體系相關和體系無關的文件都會安裝到同一目錄樹下，這也可能是你想要的。 `--bindir=``_DIRECTORY_` 聲明可執行程序的目錄，缺省是`_EXEC-PREFIX_`/bin，通常也就是`/usr/local/pgsql/bin`。 `--sysconfdir=``_DIRECTORY_` 設置各種配置文件的目錄。缺省是`_PREFIX_`/etc。 `--libdir=``_DIRECTORY_` 設置庫文件和動態裝載模塊的目錄。缺省是`_EXEC-PREFIX_`/lib。 `--includedir=``_DIRECTORY_` 設置C和C++頭文件的目錄。缺省是`_PREFIX_`/include。 `--datarootdir=``_DIRECTORY_` 設置各種類型只讀數據文件的根目錄。這只設置了一些下面的缺省選項。缺省是 `_PREFIX_`/share。 `--datadir=``_DIRECTORY_` 設置使用安裝程序的只讀數據文件的目錄，缺省是`_DATAROOTDIR_`。請注意這與你的數據庫文件放在哪里無關。 `--localedir=``_DIRECTORY_` 設置安裝現場數據的目錄，特別是消息轉變目錄文件。缺省是 `_DATAROOTDIR_`/locale。 `--mandir=``_DIRECTORY_` 隨著PostgreSQL一起的手冊頁將安裝到這個目錄的`man``_x_`子目錄里。缺省是`_DATAROOTDIR_`/man。 `--docdir=``_DIRECTORY_` 設置除"man"以外的文檔文件的根目錄。這只設置下面選項的缺省，這個選項的缺省值是`_DATAROOTDIR_`/doc/postgresql。 `--htmldir=``_DIRECTORY_` PostgreSQL的HTML-格式文檔將安裝在這個目錄。缺省是`_DATAROOTDIR_`。 > **Note:** 為了讓PostgreSQL能夠安裝在一些共享的安裝位置(比如`/usr/local/include`)，同時又不至于和系統其它部分產生名字空間干擾，我們采取了一些步驟。首先，安裝腳本會自動給`datadir`, `sysconfdir`和`docdir`后面附加上"`/postgresql`"字符串，除非展開的完整路徑名已經包含字符串"`postgres`"或者 "`pgsql`"。比如，如果你選擇`/usr/local`作為前綴，那么文檔將安裝在`/usr/local/doc/postgresql`，但如果前綴是`/opt/postgres`，那么它將被放到`/opt/postgres/doc`。客戶接口的公共C頭文件安裝到了`includedir`，并且是名字空間無關的。內部的頭文件和服務器頭文件都安裝到`includedir`下的私有目錄中去了。參考每種接口的文檔獲取關于如何訪問頭文件的信息。最后，如果合適，那么也會在`libdir`下創建一個私有的子目錄，用于動態裝載模塊。 `--with-includes=``_DIRECTORIES_` `_DIRECTORIES_`是一系列冒號分隔的目錄，這些目錄將被加入編譯器的頭文件搜索列表中。如果你有一些可選的包(比如GNU Readline)安裝在非標準位置，你就必須使用這個選項，以及可能還有相應的`--with-libraries`選項。例子： `--with-includes=/opt/gnu/include:/usr/sup/include`。 `--with-libraries=``_DIRECTORIES_` `_DIRECTORIES_`是一系列冒號分隔的目錄，這些目錄是用于查找庫文件的。如果你有一些包安裝在非標準位置，你可能就需要使用這個選項(以及對應的`--with-includes`選項)。例子：`--with-libraries=/opt/gnu/lib:/usr/sup/lib`。 `--enable-nls[=``_LANGUAGES_`] 打開本地語言支持(NLS)，也就是以非英文顯示程序信息的能力。 `_LANGUAGES_`是一個可選的空格分隔的語言代碼列表，標識你想支持的語言。比如`--enable-nls='de fr'`。你提供的列表和實際支持的列表之間的交集會自動計算出來。如果你沒有聲明一個列表，那么就安裝所有可用的翻譯。要使用這個選項，你需要一個Gettext的實現。見上文。 `--with-pgport=``_NUMBER_` `_NUMBER_`為服務器和客戶端的缺省端口(缺省是 5432)。這個端口可以在以后設置，不過如果你在這里聲明，那么服務器和客戶端將有相同的編譯好了的缺省值。這樣會方便些。通常選取一個非缺省值的好理由是你企圖在同一臺機器上運行多個PostgreSQL服務器。 `--with-perl` 編譯PL/Perl服務器端編程語言。 `--with-python` 編譯PL/Python服務器端編程語言。 `--with-tcl` 編譯PL/Tcl服務器端編程語言。 `--with-tclconfig=``_DIRECTORY_` Tcl安裝的`tclConfig.sh`文件所在目錄，它里面包含編譯 Tcl 模塊的配置信息。這個文件通常會自動在約定俗成的位置找到這些文件，但是如果你需要一個不同版本的Tcl，你也可以聲明能找到它的目錄。 `--with-gssapi` 編譯支持GSSAPI認證的東西。在許多系統上，GSSAPI（通常Kerberos安裝部分）系統沒有安裝在缺省的搜索目錄下 (比如 `/usr/include`,`/usr/lib`)，所以你必須使用附加的`--with-includes`和`--with-libraries`選項。 `configure`在繼續配置之前將檢查所需要的頭文件和庫，以確保GSSAPI是充分可用的。 `--with-krb5` 編譯支持 Kerberos 5 認證的東西。在許多系統上， Kerberos 系統沒有安裝在缺省的搜索目錄下(比如 `/usr/include`,`/usr/lib`)，所以你必須使用附加的`--with-includes`和`--with-libraries`選項。 `configure`在繼續配置之前將檢查所需要的頭文件和庫，以確保 Kerberos 是充分可用的。 `--with-krb-srvnam=``_NAME_` 缺省的Kerberos服務主的名稱（通過GSSAPI使用）。缺省是`postgres`。通常沒有理由改變這個值。除非你在Windows環境下，在這種情況下必須設置大寫`POSTGRES`。 `--with-openssl` 編譯支持SSL(加密的)連接。這個選項需要安裝OpenSSL包。 `configure`將在安裝之前檢查所需要的頭文件和庫文件以確信OpenSSL安裝是充分可用的。 `--with-pam` 編譯PAM(可插拔認證模塊)支持。 `--with-ldap` 編譯LDAP支持。用于認證和查找連接參數(參見[Section 31.17](#calibre_link-1311)和[Section 19.3.8](#calibre_link-1052)以獲取更多信息)。在 Unix 上，這需要OpenLDAP包的支持。在Windows上，缺省使用WinLDAP庫。 `configure`將會檢查所需的頭文件和庫以確保OpenLDAP的安裝是充分可用的。 `--without-readline` 避免使用Readline與libedit庫。這樣就關閉了psql里的命令行編輯和歷史，因此我們不建議這么做。 `--with-libedit-preferred` 優先使用BSD-認證的libedit庫而不是GPL認證的Readline庫。該選項僅在同時安裝了這兩個庫的情況下才有意義。缺省使用Readline庫。 `--with-bonjour` 編譯Bonjour支持。這要求操作系統支持Bonjour。在Mac OS X上建議使用。 `--with-ossp-uuid` 使用[OSSP UUID library](http://www.ossp.org/pkg/lib/uuid/)編譯組件。特別是，編譯 [uuid-ossp](#calibre_link-406)模塊，它提供了函數產生UUIDs.。 `--with-libxml` 編譯libxml (開啟SQL/XML支持)。需要Libxml 2.6.23或者更高版本支持這一特性。 Libxml安裝程序`xml2-config`可用于檢測所需的編譯器和鏈接器選項。如果發現，PostgreSQL將自動使用它。在一個不尋常的位置來指定libxml安裝，您可以要么設置環境變量`XML2_CONFIG`以指向 `xml2-config`附屬于安裝的程序或者使用選項`--with-includes`和`--with-libraries`。 `--with-libxslt` 當編譯 [xml2](#calibre_link-407)模塊時，使用libxslt。 xml2依賴于這個庫執行XSL轉變成XML。 `--disable-integer-datetimes` 禁用64 位的時間戳整數存儲和時間間隔支持。并且作為浮點數存儲時間值。在PostgreSQL發布之前的8.4版本中缺省浮點日期時間存儲。但它現在已經過時，因為它沒有支持`timestamp`值的全范圍的微秒精度。然而，基于整數的日期時間存儲需要一個64位的整數類型。因此，當沒有這樣的類型可用時，可以使用此選項時，或與PostgreSQL先前版本編寫的應用程序兼容。參閱 [Section 8.5](#calibre_link-783)獲取更多的信息。 `--disable-float4-byval` 禁用"按值傳遞"float4值，使它們"通過引用"傳遞。此選項消耗性能，但可能需要與用C語言編寫的舊的用戶定義的函數兼容，并且使用 "版本 0"調用約定。一個更好的長期的解決辦法是使用"版本 1"調用約定更新任何此類函數。 `--disable-float8-byval` 禁用"按值傳遞"傳遞float8值，使它們"通過引用"傳遞。此選項消耗性能，但可能需要與用C語言編寫的舊的用戶定義的函數兼容，并且使用 "版本 0"調用約定。一個更好的長期的解決辦法是使用"版本 1"調用約定更新任何此類函數請注意，此選項不僅影響float8，而且也影響int8以及一些相關類型（如時間戳）。在32位平臺上，缺省是`--disable-float8-byval`。并且它不允許選擇`--enable-float8-byval`。 `--with-segsize=``_SEGSIZE_` 設置_段大小_ ，以GB為單位。大表被分成多個操作系統文件，每個文件的大小等同于段大小。這避免了存在許多平臺上的文件大小限制。默認段大小，1千兆字節，在所有支持的平臺上是安全的。如果你的操作系統支持"largefile"（現在大多數支持），你可以使用較大的段大小。這可以幫助減少當大表工作時消耗掉的文件描述符數量。但要小心，不要選擇一個大于通過您的平臺和您打算使用的文件系統支持的值，你可能希望使用其他工具，比如tar，也可以設置可用文件大小的限制。因此建議，雖然不是絕對必要的，但該值是2的冪。請注意，改變這個值需要初始化數據庫。 `--with-blocksize=``_BLOCKSIZE_` 設置_塊大小_，以KB為單位。這是表中存儲和I/O單元。默認情況下，8千字節，適用于大多數情況；但是其它的值可能在特殊情況下是有用的。該值必須是1和32之間（千字節）2的冪。請注意，改變這個值需要初始化數據庫。 `--with-wal-segsize=``_SEGSIZE_` 設置_WAL段大小_，以MB為單位。這是WAL日志中每個單獨的文件的大小。它可能有助于調整這個大小來控制WAL日志傳送的粒度。缺省大小為16兆字節。該值必須是1和64之間（兆字節）2的冪。請注意，改變這個值需要初始化數據庫。 `--with-wal-blocksize=``_BLOCKSIZE_` 設置_WAL塊大小_，以KB為單位。這是WAL日志中存儲和I/O單元。默認情況下，8千字節，適用于大多數情況；但是其它的值可能在特殊情況下是有用的。該值必須是1和64之間（千字節）2的冪。請注意，改變這個值需要初始化數據庫。 `--disable-spinlocks` 允許在PostgreSQL沒有該平臺的CPU自旋鎖支持的情況下編譯成功。缺乏自旋鎖的支持將導致性能惡化；因此，只有在編譯過程退出，并且告訴你說該平臺缺乏自旋鎖支持的時候才使用這個選項。如果在你的平臺上需要這個選項才能編譯PostgreSQL，請向PostgreSQL開發者報告這個問題。 `--disable-thread-safety` 禁用客戶端庫是線程安全的。這樣就允許在libpq和 ECPG程序里的并發線程安全地控制他們私有的連接句柄。 `--with-system-tzdata=``_DIRECTORY_` PostgreSQL包括它自己的時區數據庫，它要求對日期和時間操作。此時區數據庫實際上是與許多操作系統比如FreeBSD,Linux, and Solaris提供的"zoneinfo"時區數據庫兼容。所以重新安裝將是多余的。當這個選項被使用時，`_DIRECTORY_`中系統提供的時區數據庫是用來代替包含在PostgreSQL源代碼發布中的其中之一。 `_DIRECTORY_`必須作為絕對路徑被指定。 `/usr/share/zoneinfo`是某些操作系統上的可能目錄。請注意，這個安裝程序將不檢測不匹配的或者錯誤的時間區域數據。如果您使用此選項，建議您運行回歸測試，以驗證該時區的數據，你已經指出正確使用PostgreSQL。該選項主要是針對二進制軟件包分發者，他知道目標操作系統運行良好。使用此選項的主要優勢是，當許多當地白晝節約時間規則變化的任何時候，PostgreSQL包不需要升級。另一個優點是，如果時區數據庫文件在安裝期間不需要被編譯，PostgreSQL可以進行交叉編譯更直截了當。 `--without-zlib` 避免使用Zlib庫。這樣就關閉了pg_dump 和pg_restore里面的壓縮支持。這個選項只適用于那些沒有這個庫的罕見的系統。 `--enable-debug` 把所有程序和庫以帶有調試符號的方式編譯。這意味著你可以通過一個調試器運行程序來分析問題。這樣做顯著增大了最后安裝的可執行文件的大小，并且在非GCC的編譯器上，這么做通常還要關閉編譯器優化，導致速度的下降。但是，如果有這些符號表的話，就可以非常有效地幫助定位可能發生問題的位置。目前，我們只是在你使用GCC的情況下才建議在生產安裝中使用這個選項。但是如果你正在進行開發工作，或者正在使用beta版本，那么你就總應該打開它。 `--enable-coverage` 如果使用GCC，所有的程序和庫連同代碼覆蓋測試儀器一起被編譯。在運行時，它們與代碼覆蓋率度量在編譯目錄下生成文件。參閱[Section 30.4](#calibre_link-114) 獲取更多信息當做開發工作時，該選項僅用于GCC。 `--enable-profiling` 如果使用GCC，則編譯所有程序和庫，使他們可以描繪輪廓。在后端出口，創建子目錄，包含分析使用的`gmon.out`文件。當做開發工作時，該選項僅用于GCC。 `--enable-cassert` 打開服務器中的_assertion_檢查，它會檢查許多"不可能發生"的條件。它對于代碼開發的用途而言是無價之寶，不過這些測試可以顯著減緩服務器。并且，打開這個測試不會提高系統的穩定性！這些斷言檢查并不是按照錯誤的嚴重性分類的，因此一些相對無害的小蟲子也可能導致服務器重啟 (只要它觸發了一次斷言失敗)。目前，我們不推薦在生產環境中使用這個選項，但是如果你在做開發或者在使用beta版本的時候應該打開它。 `--enable-depend` 打開自動倚賴性跟蹤。如果打開這個選項，那么 makefile 文件將設置為在任何頭文件被修改的時候都將重新編譯所有受影響的目標文件。如果你在做開發的工作，那么這個選項很有用，但是如果你只是想編譯一次并且安裝，那么這就是浪費時間。目前，這個選項只有在你使用GCC的時候才管用。 `--enable-dtrace` 編譯PostgreSQL支持動態跟蹤工具DTrace。參閱[Section 27.4](#calibre_link-1290)獲取更多信息。指向`dtrace`程序，設置環境變量`DTRACE`。這往往是必須的，因為`dtrace` 通常安裝在`/usr/sbin`中且該目錄一般不在搜索路經中。在環境變量`DTRACEFLAGS`中為`dtrace`程序指定額外命令行選項。在Solaris上，要包含64位二進制的DTrace支持，需要指定`DTRACEFLAGS="-64"`，比如，在使用GCC編譯的時候: ``` ./configure CC='gcc -m64' --enable-dtrace DTRACEFLAGS='-64' ... ``` 在使用Sun編譯器的時候： ``` ./configure CC='/opt/SUNWspro/bin/cc -xtarget=native64' --enable-dtrace DTRACEFLAGS='-64' ... ``` 如果你喜歡使用不同于`configure`找出來的 C 編譯器，可以將環境變量`CC`設置為你選擇的程序。缺省時， `configure`將選擇`gcc`(只要可用)，或者是該平臺的缺省(通常是`cc`)類似地，你可以用`CFLAGS`覆蓋缺省編譯器標志。你可以在`configure`命令行上聲明環境變量，比如： ``` <kbd class="literal">./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe'</kbd> ``` 下面是可用的環境變量列表： `BISON` Bison程序 `CC` C編譯器 `CFLAGS` 傳遞給C編譯器的選項 `CPP` C預處理器 `CPPFLAGS` 傳遞給C預處理器的選項 `DTRACE` `dtrace`程序位置 `DTRACEFLAGS` 傳遞給`dtrace`程序的選項 `FLEX` Flex程序 `LDFLAGS` 當連接可執行或可共享庫時使用的選項 `LDFLAGS_EX` 只連接可執行時的額外選項 `LDFLAGS_SL` 只連接共享庫時的額外選項 `MSGFMT` 本地語言支持的`msgfmt`程序 `PERL` Perl解釋器的完整路徑。用于確定編譯PL/Perl的依賴關系 `PYTHON` Python解釋器的完整路徑。用于確定編譯PL/Python的依賴關系。另外，Python 2或3是否在這聲明（或另有隱式選擇）決定了PL/Python 的哪種語言是可用的。參閱[Section 43.1](#calibre_link-883) 獲取更多詳情。 `TCLSH` Tcl解釋器的完整路徑。用于確定編譯PL/Tcl的依賴關系。并且它將替代Tcl腳本。 `XML2_CONFIG` `xml2-config`程序用于定位libxml安裝。 > **Note:** 當開發服務器內部代碼時，建議使用配置選項`--enable-cassert`（其中打開許多運行時錯誤檢查）和`--enable-debug` （可以改進調試工具的有效性）。 > > 如果使用GCC，最好是進行至少`-O1`的優化級別的編譯。因為不使用優化(`-O0`)禁止一些重要的編譯器警告（例如，使用未初始化變量）。然而，非零優化級別可以進行復雜調試，因為通過編譯代碼步進調試往往不會匹配一對之一源代碼行。如果你感到困惑，而試圖調試優化的代碼，重新編譯`-O0`的指定文件。一個簡單方法來做到這一點是通過傳遞選項到make: `gmake PROFILE=-O0 file.o`。 2. **編譯** 開始編譯，鍵入： ``` <kbd class="literal">gmake</kbd> ``` （記住使用GNU make）。依硬件不同，編譯過程可能需要一些時間。顯示的最后一行應該是： ``` All of PostgreSQL is successfully made. Ready to install. ``` 如果你想要編譯一切可以編譯的東西，包含文檔（HTML和幫助手冊），以及額外模塊（`contrib`）鍵入： ``` <kbd class="literal">gmake world</kbd> ``` 顯示的最后一行應該是： ``` PostgreSQL, contrib and HTML documentation successfully made. Ready to install. ``` 3. **回歸測試** 如果你想在安裝文件前測試新編譯的服務器，那么你可以在這個時候運行回歸測試。回歸測試是一個用于驗證PostgreSQL在系統上是否按照開發人員設想的那樣運行的測試套件。敲入： ``` <kbd class="literal">gmake check</kbd> ``` 這條命令在root里無法使用；請在非特權用戶下運行該命令。 [Chapter 30](#calibre_link-116) 包含關于如何解釋測試結果的詳細信息。你可以在以后的任何時間通過執行這條命令來運行這個測試。 4. **安裝文件** > **Note:** 如果你正在升級一套現有的系統必定讀 [Section 17.6](#calibre_link-633)。它有關于升級集群的說明。安裝PostgreSQL，鍵入： ``` <kbd class="literal">gmake install</kbd> ``` 這條命令將把文件安裝到在[step 1](#calibre_link-1088)聲明的目錄里面去。確保你對那個目錄有足夠的權限。通常你需要用 root 權限做這一步。或者你也可以事先創建目標目錄并且分派合適的權限。安裝文檔（HTML和手冊頁），鍵入： ``` <kbd class="literal">gmake install-docs</kbd> ``` 如果上面編譯了world,而不是鍵入： ``` <kbd class="literal">gmake install-world</kbd> ``` 這也安裝文檔。你可以使用`gmake install-strip`代替`gmake install`在安裝可執行文件和庫文件時把它們的調試信息抽取掉。這樣將節約一些空間。如果你編譯時帶著調試支持，那么抽取將有效地刪除調試支持，因此我們應該只是在不再需要調試的時候做這些事情。 `install-strip`力圖做一些合理的事情來節約空間，但是它并不知道如何從可執行文件中抽取每個不需要的字節，因此，如果你希望節約所有可能節約的磁盤空間，那么你可能需要手工做些處理。標準的安裝只提供所有開發客戶端應用的頭文件和服務器端的程序開發，比如用 C 寫客戶函數或者數據類型的頭文件。（先于PostgreSQL 8.0，后者需要單獨的`gmake install-all-headers`命令，但是標準安裝中已經包含這一步）。 **只裝客戶端:** 如果你只想裝客戶應用和接口，那么你可以用下面的命令: ``` <kbd class="literal">gmake -C src/bin install</kbd> <kbd class="literal">gmake -C src/include install</kbd> <kbd class="literal">gmake -C src/interfaces install</kbd> <kbd class="literal">gmake -C doc install</kbd> ``` `src/bin`中有一些僅供服務器使用的二進制文件，但是它們都很小。 **卸載:** 可以使用`gmake uninstall`命令卸載。不過這樣不會刪除任何創建出來的目錄。 **清理:** 在安裝完成以后，你可以通過在源碼樹里面用命令`gmake clean`刪除編譯過程文件釋放磁盤空間。這樣會保留`configure`程序生成的文件，這樣以后你就可以用`gmake`命令重新編譯所有東西。要把源碼樹恢復為發布時的狀態，用`gmake distclean`命令。如果你想從同一棵源碼樹上為多個不同平臺編譯，你就一定要運行這條命令并且為每個平臺重新配置。另外，在每種系統上使用一套獨立的編譯樹，這樣源代碼樹就可以保留不被更改。如果你執行了一次編譯，然后發現你的`配置`選項是錯誤的，或者你修改了任何`配置`所探測的東西(比如升級了軟件)，那么在重新配置和編譯之前運行一下`gmake distclean`是個好習慣。如果不做這個事情，你修改的配置選項可能無法傳播到所有需要變化的地方。