15.5. 安装过程

配置

安装过程的第一步就是配置源代码树并选择你喜欢的选项。这个工作是通过运行configure脚本实现的，对于缺省安装，你只需要简单地敲入
```
./configure
```
该脚本将运行一些测试来决定一些系统相关的变量，并检测操作系统的设置，最后将在编译树中创建一些文件以记录它找到了什么。如果你想保持编译目录的独立，那么你也可以在源代码树之外的其它目录里运行configure脚本。这个过程也称作VPATH编译。如下：
```
mkdir build_dir
cd build_dir
/path/to/source/tree/configure [options go here]
gmake
```
缺省设置将编译服务器和应用程序，还有所有只需要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自带手册页是安装到各自的manx子目录里。缺省是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-includesoption选项)。

例子: --with-libraries=/opt/gnu/lib:/usr/sup/lib.

--enable-nls[=LANGUAGES]

打开本地语言支持(NLS)，也就是以非英文显示程序信息的能力。 LANGUAGES是一个可选空格分隔的语言代码列表，标识你想支持的语言。比如--enable-nls='de fr'。你提供的列表和实际支持的列表之间的交集会自动计算出来。如果你没有声明一个列表，那么就安装所有可用的翻译。

要使用这个选项，你需要一个GettextAPI的实现。见上文。

--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模块的配置信息。 configure通常会自动在约定俗成的位置找到这些文件，但是如果你需要一个不同版本的Tcl，你也可以声明不同的目录。

--with-gssapi

编译支持GSSAPI认证。在许多系统上，GSSAPI（通常是Kerberos安装的一部分）没有安装在缺省的搜索目录下（比如/usr/include, /usr/lib），所以你必须使用附加的--with-includes and --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.16 and Section 19.3.7以获取更多信息)。在Unix上，这需要OpenLDAP包的支持。在Windows上，将使用缺省的WinLDAP库。 configure将会检查所需的头文件和库以确保OpenLDAP的安装是充分可用的。

--without-readline

避免使用Readline与libedit库。这样会关闭psql命令行编辑和历史，因此建议不使用。

--with-libedit-preferred

BSD许可优先使用libedit库而不是Readline库。该选项仅在同时安装了这两个库的情况下才有意义，这时会缺省使用Readline库。

--with-bonjour

编译Bonjour支持。这要求操作系统支持Bonjour。在Mac OS X系统上建议使用。

--with-ossp-uuid

当编译contrib/uuid-ossp，使用OSSP UUID library。该库提供生成的UUID的函数。

--with-libxml

编译libxml（允许SQL/XML支持）。该功能需要Libxml 2.6.23或更新的版本。

Libxml通过安装xml2-config来检测所需的编译器和链接器选项。如果发现，PostgreSQL将自动使用它。为了在指定位置来进行libxml安装，可以设置环境变量XML2_CONFIG来指向从属安装的xml2-config程序，或使用的选项--with-includes和 --with-libraries。

--with-libxslt

当编译contrib/xml2时，使用libxslt。contrib/xml2依靠这个库来执行由XSL转换的XML。

--disable-integer-datetimes

禁用支持64位整数存储时间戳和间隔，以浮点值存储日期。浮点缺省日期存储是 PostgreSQL8.4之前发布的，但它现在已经过时，因为在timestamp值域的微秒精度方面，它不支持。然而，基于整数日期时间的存储需要64位的整数类型。因此，当没有这种类型可用或兼容为 PostgreSQL之前版本事先编写的应用程序时，这个选项可以使用。参阅 Section 8.5获得更多详细信息。

--disable-float4-byval

禁止按"by value"传递float4值，应该通过"by reference"来传递。此选项可估算性能，但可能需要与旧的用户自定义函数（用C语言编写并且是使用"version 0"来调用的约定）兼容。一个更好的长期解决方案是使用"version 1"调用约定来更新任何此类函数。

--disable-float8-byval

禁止按"by value"传递float8的值，应该通过"by reference"来传递。此选项可估算性能，但可能需要与旧的用户自定义函数（用C语言编写并且是使用"version 0"来调用的约定）兼容。一个更好的长期解决方案是使用"version 1"调用约定来更新任何此类函数。注意：这个选项影响不仅float8，int8和一些相关的类型如时间戳等也会受影响。在32位平台上，缺省的是--disable-float8-byval，不允许选择--enable-float8-byval。

--with-segsize=SEGSIZE

设置段大小（segment size），以千兆字节为单位。大型表分为多个操作系统文件，每个大小等于段大小。这就避免了存在许多平台上文件大小限制问题。默认段大小为1千兆字节，在所有支持平台上都是安全的。如果您的操作系统支持"largefile"，那么您可以使用一个较大值的段大小。这可能有助于减少运行于大表中消耗的文件描述符数，但要小心，不要选择比您的平台支持的，并且你打算使用的文件系统大的值。你想使用其他工具，如tar，还设置了可用文件大小限制。建议，但不是绝对需要，该值是2的乘方。请注意，改变这个值需要一个initdb。

--with-blocksize=BLOCKSIZE

设置block size，以千字节为单位。这是表内存储和I/O的单位。缺省值是8千字节，适用于大多数情况，但其他值在特殊情况下也可能是有用的。值必须是是在1和32之间的2的乘方，以千字节为单位。请注意，改变这个值，需要一个initdb。

--with-wal-segsize=SEGSIZE

设置WAL segment size，以兆字节为单位。这是 WAL日志每一个独立文件的大小。可以通过调整该值的大小来控制WAL日志传送粒度。该值必须是在1和64之间的2的乘方（兆字节为单位），缺省大小为16兆字节。请注意，改变这个值，需要一个initdb。

--with-wal-blocksize=BLOCKSIZE

设置WAL block size，以千字节为单位。这是WAL日志内存储和I/O的单位。缺省情况值是8千字节，适用于大多数情况，但其他值在特殊情况下也可能是有用的。值必须是1和64之间的2的乘方（千字节为单位）。请注意，改变这个值，需要一个initdb。

--disable-spinlocks

允许PostgreSQL在没有该平台的CPU自旋锁支持的情况下编译成功。缺乏自旋锁的支持将导致性能恶化，因此，只有在编译过程中止，并且提示该平台缺乏自旋锁支持的时候才使用这个选项。如果在你的平台上需要这个选项才能编译PostgreSQL，请向PostgreSQL开发者报告这个问题。

--disable-thread-safety

禁用客户端库的线程安全。该选项通过安全地控制他们私有的连接句柄来阻止在libpq 和 ECPG程序里的并发线程。

--with-system-tzdata=DIRECTORY

PostgreSQL包括它自己的时区数据库（该库需要时间和日期操作操作）。这个时区数据库实际上兼容由许多操作系统（如FFreeBSD, Linux,和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

If using GCC, all programs and libraries are compiled with code coverage testing instrumentation. When run, they generate files in the build directory with code coverage metrics. See Section 30.4 for more information. This option is for use only with GCC and when doing development work.

如果使用GCC编译，所有的程序和库被编译成代码覆盖测试仪器。运行时，他们在代码覆盖度量的编译库中产生文件。See Section 30.4 for more information.此选项只与GCC一起使用并且是做开发工作中。

--enable-profiling

如果使用GCC，所有程序和库都被编译用以，这样才能对其进行分析。在后台出口，将创建一个子目录（包含gmon.out文件）用于分析使用。此选项只与GCC一起使用并且是做开发工作中。

--enable-cassert

打开在服务器中的assertion检查，它会检查许多"cannot happen"的条件。它对于代码开发的用途而言是无价之宝，不过这些测试会显著减缓服务器。并且，打开这个测试不会提高系统的稳定性！这些assertion检查并不是按照错误的严重性分类的，因此一些相对无害的小问题也可能导致服务器重启 (只要它触发了一次assertion失败)。目前，我们不推荐在生产中使用这个选项，但是如果你在做开发或者在使用beta版本的时候应该打开它。

--enable-depend

打开自动倚赖性跟踪。如果打开这个选项，那么makefile文件将设置为在任何头文件被修改的时候都将重新编译所有受影响的目标文件。如果你在做开发的工作，那么这个选项很有用，但是如果你只是想编译一次并且安装，那这么做就是浪费时间。目前，这个选项只有在你使用GCC的时候才管用。

--enable-dtrace
编译PostgreSQL，支持动态跟踪工具DTrace。参阅See Section 27.4. 经常需要通过设置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命令行上声明环境变量，比如：
```
    ./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe'
    
```
下面是一些重要的环境变量列表：

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 42.1获得更多详细信息。

TCLSH

Tcl解释器的完整路径。用于确定编译PL/Tcl的依赖关系, 并且，它将代替Tcl脚本。

XML2_CONFIG

xml2-config用于定位libxml的安装。
编译

要开始编译，输入：
```
gmake
```
(一定要记得用GNU make.) 依硬件不同，编译过程需要的时间也不同。显示的最后一行应该是：
```
All of PostgreSQL is successfully made. Ready to install.
```
如果你想编译所有可以编译的，包括文档（HTML和手册页），附加模块 (contrib)，输入：
```
gmake world
```
显示最后一行应该是:
```
PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
```
回归测试

如果你想在安装文件前测试新编译的服务器，那么你可以在这个时候运行回归测试。回归测试是一个用于验证PostgreSQL在系统上是否按照开发人员设想的那样运行的测试套件输入:
```
gmake check
```
这条命令不能用root用户执行，需要以非特权用户运行该命令。 Chapter 30 contains 包含关于如何解释测试结果的详细信息。你可以在以后的任何时间通过执行这条命令来运行这个测试。
安装文件

Note: 如果你正在升级一套现有的系统并且准备把新文件覆盖在旧文件上面，那么要记得在覆盖之前备份数据并关闭旧服务器，像之前在Section 15.4里面解释的那样。

要安装PostgreSQL ，输入：
```
gmake install
```
这条命令将把文件安装到在step 1声明的目录里面去。确保你对那个目录有足够的权限以写入。通常需要用root用户（或有root权限的用户）来执行该命令，当然，也可以先创建目标目录，然后给该用户分配足够的，在该目录上的权限。

文档（HTML和手册页）的安装，输入：
```
    gmake install-docs
    
```
如果要安装所有的可以安装的，输入：
```
gmake install-world
```
该命令也会安装文档文件。

用gmake install-strip命令代替gmake install命令，可以在安装可执行文件和库文件时把它们的调试信息抽取掉，这样可以节约一些磁盘空间。如果你编译时带着调试支持，那么该命令将删除调试支持，因此我们应该只是在不再需要调试的时候使用。 install-strip力图做一些合理的事情来节约空间，但是它并不知道如何从可执行文件中抽取每个不需要的字节，因此，如果你希望节约所有可能节约的磁盘空间，那么你可以手工做些处理。

标准的安装提供所有客户端应用开发和服务器端的程序开发的头文件，比如用C写的通用函数或者数据类型的头文件。（PostgreSQL8.0之前，后者需要一个单独的gmake install-all-headers命令，现在标准安装中一包含了这一步。）
只安装客户端. 如果你只想装客户应用和接口库，那么你可以用下面的命令：
```
gmake -C src/bin install
gmake -C src/include install
gmake -C src/interfaces install
gmake -C doc install
```
src/bin中有一些仅供服务器使用的二进制文件，但是它们都很小。

在Windows上注册eventlog. 要在该操作系统上注册一个Windows eventlog库，在安装完毕之后执行下面的命令:

    regsvr32 pgsql_library_directory/pgevent.dll

这样就创建了一个用于事件查看器的注册表项目。

卸载. 可以使用gmake uninstall命令进行卸载，不过这样不会删除创建出来的目录。

清理. 在安装完成以后，可以通过在源码树里面用命令gmake clean删除编译过程文件来释放磁盘空间。这样会保留configure程序生成的文件，这样以后你就可以用gmake命令重新编译所有东西。要把源码树恢复为发布时的状态，用gmake distclean命令。如果你想从同一棵源码树上为多个不同平台编译，你就一定要运行这条命令并且为每个平台重新配置。另外，在每种系统上使用一套独立的编译树，这样源代码树就可以保留不被更改。

如果你执行了一次编译，然后发现你的configure选项是错误的，或者你修改了configure所探测到的东西(比如升级了软件)，那么在重新配置和编译之前运行一下gmake distclean是个好习惯。如果不做这个事情，你修改的配置选项可能无法生效。