1.5. 安装过程

配置

安装过程的第一步就是配置源代码树并选择你喜欢的选项．这个工作是通过运行 configure 脚本实现的，对于缺省安装，你只需要简单地敲入
```
./configure
```
该脚本将运行一些测试来猜测一些系统相关的变量并检测你的操作系统的特殊设置，并且最后将在制做树中创建一些文件以记录它找到了什么．

缺省设置将制作服务器和应用程序，还有所有只需要 C 编译器的客户端程序和接口．缺省时所有文件都将安装到 /usr/local/pgsql ．

你可以通过给出下面 configure 命令行选项中的一个或更多的选项来客户化制作和安装过程：

--prefix= PREFIX

把所有文件装在目录 PREFIX 下面而不是 /usr/local/pgsql 里．实际的文件会安装到不同的子目录里；甚至没有一个文件会直接安装到 PREFIX 目录里．

如果你有特殊需要，你还可以用下面的选项客户化不同的子目录的位置．

--exec-prefix= EXEC-PREFIX

你可以把体系相关的文件安装到一个不同的位置， EXEC-PREFIX ，而不是 PREFIX 设置的地方．这样做可以比较方便地在不同主机之间共享体系相关的文件．如果你省略这些，那么 EXEC-PREFIX 就会被设置为等于 PREFIX 并且体系相关和体系无关的文件都会安装到同一棵目录树下，这也可能是你想要的．

--bindir= DIRECTORY

为可执行程序声明目录，缺省是 EXEC-PREFIX /bin ，通常也就是 /usr/local/pgsql/bin ．

--datadir= DIRECTORY

设置所安装的程序需要的只读文件的目录．缺省是 PREFIX /share ．请注意这个目录和你放数据库文件的地方没有任何关系．

--sysconfdir= DIRECTORY

用于各种各样配置文件的目录，缺省为 PREFIX /etc ．

--libdir= DIRECTORY

库文件和动态装载模块的目录．缺省是 EXEC-PREFIX /lib ．

--includedir= DIRECTORY

C 和 C++ 头文件的目录．缺省是 PREFIX /include ．

--docdir= DIRECTORY

文档文件，（除 "man（手册页）" 以外，将被安装到这个目录．缺省是 PREFIX /doc ．

--mandir= DIRECTORY

随着 PostgreSQL 一起带的手册页将安装到这个目录．在它们相应的 man x 子目录里．缺省是 PREFIX /man ．

注意: 为了让 PostgreSQL 能够安装在一些共享的安装位置 (比如 /usr/local/include )，同时又不至于和系统其它部分产生名字空间干扰，我们采取了一些步骤．首先，安装脚本会自动给 datadir ， sysconfdir ，和 docdir 后面附加上 "/postgresql " 字串，除非展开的完整路径名已经包含字串 "postgres " 或者 "pgsql " ．比如，如果你选择 /usr/local 作为前缀，那么文档将安装在 /usr/local/doc/postgresql , 但如果前缀是 /opt/postgres ，那么它将被放到 /opt/postgres/doc ．其次，C 和 C++ 头文件的安装布局自 7.2 版本开始已经经过重新安排了．客户接口的公共头文件安装到了 includedir ，并且是名字空间无关的．内部的头文件和服务器头文件都安装到 includedir /postgresql 下的私有目录中去了．参考 程序员手册 获取关于如何得到每个接口的头文件的信息．

--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-locale

打开区域支持．区域支持会带来性能损失，但是如果你不是在说英语的环境使用数据库，那么你很可能需要这个选项．

--enable-recode

打开单字节字符集记录的支持．参阅 Section 5.3 获取关于这个特性的详细信息．

--enable-multibyte

允许使用多字节编码(包括 Unicode)和编码转换．阅读 Section 5.2 获取详细信息．

请注意一些接口(比如 Tcl 或 Java)认为所有字符串都是 Unicode，因此要想正确支持这个接口就需要使用这个选项．

--enable-nls[ = LANGUAGES ]

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

要使用这个选项，你需要一个 gettext API 的实现．有些系统有内建的支持(比如， Linux ， NetBSD ， Solaris )，对于其它系统，你可以从这里下载一个附加的包∶ ．如果你使用的是 GNU C 库的 gettext 实现，那么你还需要 GNU gettext 包用于一些工具程序．对于任何其它实现，你应该不需要它．

--with-pgport= NUMBER

把 NUMBER 设置为服务器和客户端的缺省端口．缺省是 5432．这个端口可以在以后设置，不过如果你在这里声明，那么服务器和客户端将有相同的编译好了的缺省值．这样会方便些．通常选取一个非缺省值的好理由是你企图在同一台机器上运行多个 PostgreSQL 服务器．

--with-CXX

制作C++支持库．

--with-perl

制作 Perl 接口模块．Perl 接口将被安装到 Perl 模块通常的安装位置（典型的位置是 /usr/lib/perl ），所以你必须要有 root 权限来执行安装步骤（参阅 step 4 ）．使用这个选项你需要安装 Perl 5．

--with-python

制作 Python 接口模块．你需要 root 权限将 Python 模块安装到它的缺省位置（/usr/lib/python x . y ）．要使用这个选项，你必须已经安装了 Python 并且你的系统必须支持共享库．如果你想制作一个新的完整的二进制解释器，你只能自己手工制作．

--with-tcl

制作那些需要 Tcl/Tk 的部件，就是 libpgtcl ， pgtclsh ， pgtksh ， pgaccess 和 PL/Tcl ．你也可以看看下面的 --without-tk ．

--without-tk

如果你同时声明了 --with-tcl 和这个选项，那么那些需要 Tk （也就是 pgtksh 和 pgaccess ）的程序将被排除在外．

--with-tclconfig= DIRECTORY
--with-tkconfig= DIRECTORY

Tcl/Tk 的安装文件 tclConfig.sh 和 tkConfig.sh ，她们里面包含制作 Tcl 或 Tk 模块接口的配置信息． Configure 通常会自动在她们的众所周知的位置找到这些文件，但是如果你需要一个不同版本的 Tcl 或 Tk，你也可以声明可以找到她们的目录．

--enable-odbc

制作 ODBC 驱动．缺省时，驱动将独立于驱动管理器．为了和已经在你的系统里安装好的驱动管理器配合更好，请与本选项一起使用下面的几个选项之一．更多的信息可以在 程序员手册 中找到．

--with-iodbc

为配合 iODBC 使用制作 ODBC 驱动．

--with-unixodbc

为配合 unixODBC 使用制作 ODBC 驱动．

--with-odbcinst= DIRECTORY

声明 ODBC 期望的odbcinst.ini 配置文件的路径．缺省是 /usr/local/pgsql/etc 或者你声明的 --sysconfdir 选项的内容．你应该把它安排成驱动和驱动管理器读取同样的文件．

如果使用了 --with-iodbc 和 --with-unixodbc 任何之一，那么这个选项将被忽略，因为在这种情况下驱动管理器控制配置文件的位置．

--with-java

制作 JDBC 驱动和相关包．这个选项要求先安装 Ant (当然还有 JDK )．请参考 程序员手册 里的 JDBC 驱动文档获取更多信息．

--with-krb4[ = DIRECTORY ]
--with-krb5[ = DIRECTORY ]

制作支持Kerberos认证的东西．你可以选择 Kerberos 版本 4 或 5，但不能同时选两个． DIRECTORY 参数声明 Kerberos 安装的根目录；缺省假设是 /usr/athena 如果相关的头文件和库文件不在常用的父目录，那么你必须使用附加的 --with-includes 和 --with-libraries 选项．另一方面，如果所需要的文件位于一个缺省的搜索目录，（比如说，/usr/lib ），那你就不用输入这些参数了．

configure 将在安装之前检查所需要的头文件和库文件以确信你的 Kerberos安装是完整的．

--with-krb-srvnam= NAME

Kerberos服务主的名称．缺省是 postgres ．通常没有理由改变这个值．

--with-openssl[ = DIRECTORY ]

制作支持 SSL （加密的）联接的postgres．这个选项需要安装 OpenSSL 包． DIRECTORY 参数声明 OpenSSL 安装的根目录；缺省时 /usr/local/ssl ．

configure 将在安装之前检查所需要的头文件和库文件以确信你的 OpenSSL 安装是充分的．

--with-pam

制作 PAM (可插拔认证模块)支持．

--enable-syslog

打开 PostgreSQL 服务器使用 syslog 日志系统的功能．（使用这个功能并不意味着你必须用 syslog 做日志，也不是说服务器缺省会做这些，而是给你一个在运行时使用这个选项目的可能．）

--enable-debug

把所有程序和库以带有调试符号的方式编译．这意味着你可以通过一个调试器运行程序来分析问题．这样做显著增大了最后安装的可执行文件的大小，并且在非 GCC 的编译器上，这么做通常还要关闭编译器优化，导致速度的下降．但是，如果有这些符号表的话，就可以极大帮助定位可能发生问题的位置．目前，我们只是在你使用 GCC 的情况下才建议在生产安装中使用这个选项．但是如果你正在进行开发工作，或者正在使用 beta 版本，那么你就总应该打开它．

--enable-cassert

打开在服务器中的 assertion 检查，它会检查许多 "不可能发生" 的条件．它对于代码开发的用途而言是无价之宝，不过这些测试稍微地减慢了一些速度．这些断言检查并不一定都是针对严重错误的，因此一些相对无害的小虫子也可能导致服务器重启--只要它触发了一次断言失败．目前，我们不推荐在生产环境中使用这个选项，但是如果你在做开发或者在使用 beta 版本的时候应该打开它．

--enable-depend

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

如果你喜欢用那些和 configure 找出来的不同的编译器，那么你可以分别设置你的环境变量 CC 或 CXX ，把它们设置为你选择的程序．类似地，你可以用 CFLAGS 和 CXXFLAGS 变量覆盖缺省编译器标志．比如：
```
env CC=/opt/bin/gcc CFLAGS='-O2 -pipe' ./configure
```
制作

开始制作，敲入
```
gmake
```
（一定要记得用 GNU make ．）依你的硬件而异，制作过程可能需要 5 分钟到半小时．显示的最后一行应该是
```
All of PostgreSQL is successfully made. Ready to install.
```
蜕变测试

如果你想在安装文件前测试新制作的服务器，那么你可以在这个时候运行蜕变测试．蜕变测试是一个用于验证 PostgreSQL 在你的系统上是否按照开发人员设想的那样运行的测试套件．敲入
```
gmake check
```
(这条命令在 root 里无法使用；请在非特权用户下运行该命令．) 很有可能有些测试因为错误信息的用语或浮点结果的问题而失败．文件 Chapter 14 包含关于如何解释测试结果的详细信息．你可以在以后的任何时间通过执行这条命令来运行这个测试．
安装文件

注意: 如果你正在升级一套现有的系统并且准备把新文件安装在旧文件上面，那么你现在就应该备份数据并关闭你的旧服务器，象上面 Section 1.4 里面解释的那样．

要安装 PostgreSQL 键入
```
gmake install
```
这条命令将把文件安装到在 step 1 里声明的目录里面去．确保你对那个目录有足够的权限．通常你需要用 root 权限做这一步．或者你也可以事先创建目标目录并且分派合适的权限．

如果你制作了 Perl 或 Python 接口而且你执行上面的命令时不是 root 用户，那么这些部分的安装可能失败．这时候你应该成为 root 用户然后
```
gmake -C src/interfaces/perl5 install




gmake -C src/interfaces/python install
```
如果你自己没有超级用户权限：你还是可以安装必须的文件并且把她们放到其它的 Perl 或 Python 找得到的地方，怎么做就留给大家做练习吧．（译注：可以 man ld.so，注意里面的 LD_LIBRARYPATH，和 LD_PRELOAD 等变量．）

标准的安装只提供那些开发客户端应用的头文件．如果你准备做任何服务器端的程序开发（比如用 C 写客户函数或者数据类型），那么你可能就要把整个 PostgreSQL 头文件树安装到你的目标头文件目录中．如果需要这么做，键入
```
gmake install-all-headers
```
安装这些东西需要一两兆空间，只有在你不想保留整个源码树用做引用用途的情况下才需要这么做．（如果你保留了源码树，那么你可以用源码里面的头文件制作服务器端的软件．
只装客户端∶. 如果你只想装客户应用和接口，那么你可以用下面的命令：
```
gmake -C src/bin install




gmake -C src/include install




gmake -C src/interfaces install




gmake -C doc install
```
要撤销安装可以使用命令 gmake uninstall ．不过这样不会删除任何创建出来的目录．

在安装完成以后，你可以通过在源码树里面用命令 gmake clean 删除制作文件．这样会保留 configure 程序生成的文件，这样以后你就可以用 gmake 命令重新制作所有东西．要把源码树恢复为发布时的状态，用 gmake distclean 命令．如果你想从同一棵源码树上为多个不同平台制作，你就一定要运行这条命令并且为每个制作重新配置．

如果你执行了一次制作，然后发现你的配置选项是错误的，或者你修改了任何 configure 所探测的东西(比如，你安装了 GNU Readline )，那么在重新配置和制作之前运行一下 gmake distclean 是个好习惯．如果不做这个事情，你修改的配置选项可能无法传播到所有需要变化的地方．