14.5. 安装过程

  1. 配置

    安装过程的第一步就是配置源代码树并选择你喜欢的选项。 这个工作是通过运行 configure 脚本实现的,对于缺省安装,你只需要简单地敲入

    ./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 一起带的手册页将安装到这个目录.在它们相应的 manx子目录里. 缺省是 PREFIX/man

    注意: 为了让PostgreSQL能够安装在一些共享的安装位置(比如 /usr/local/include), 同时又不至于和系统其它部分产生名字空间干扰,我们采取了一些步骤。 首先,安装脚本会自动给 datadirsysconfdir,和 docdir 后面附加上 "/postgresql" 字串, 除非展开的完整路径名已经包含字串 "postgres" 或者 "pgsql"。 比如,如果你选择 /usr/local 作为前缀, 那么文档将安装在 /usr/local/doc/postgresql, 但如果前缀是 /opt/postgres, 那么它将被放到 /opt/postgres/doc. 客户接口的公共 C 头文件安装到了 includedir,并且是名字空间无关的。 内部的头文件和服务器头文件都安装到 includedir/postgresql 下的私有目录中去了.参考每种接口的文档获取关于如何得到头文件的信息。 最后,如果合适,那么也会创建一个私有的子目录,在 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 API 的实现。见上文。

    --with-pgport=NUMBER

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

    --with-perl

    制作 PL/Perl 服务器端编程语言。

    --with-python

    制作 Python 接口模块和 PL/Python 服务器端编程语言.你需要 root 权限将 Python 模块安装到它的缺省位置 (/usr/lib/pythonx.y)。

    --with-tcl

    制作那些需要 Tcl/Tk 的部件, 就是libpgtclpgtclshpgtksh, 和PL/Tcl。 你也可以看看下面的 --without-tk

    --without-tk

    如果你同时声明了 --with-tcl 和这个选项,那么那些需要 Tk(也就是 pgtksh)的程序将被排除在外。

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

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

    --with-java

    制作 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 (加密的)联接。 这个选项需要安装 OpenSSL 包。 DIRECTORY 参数声明 OpenSSL 安装的根目录;缺省时 /usr/local/ssl

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

    --with-pam

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

    --without-readline

    避免使用Readline库.这样就关闭了 psql 里的命令行编辑和历史, 因此我们不建议这么做。

    --with-rendezvous

    制作 Rendezvous 支持。

    --disable-spinlocks

    允许在 PostgreSQL 没有该平台的 CPU 自旋锁支持的情况下制作成功。 缺乏自旋锁的支持将导致性能恶化;因此,只有在制作过程退出, 并且告诉你说该平台缺乏自旋锁支持的时候才使用这个选项。

    --enable-thread-safety

    令客户端库是线程安全的。这样就允许在 libpqECPG 程序里的并发线程安全地控制他们私有的连接句柄。

    --without-zlib

    避免使用Zlib库.这样就关闭了 pg_dump 里面的压缩支持.这个选项只适用于那些没有这个库的罕见的系统.

    --enable-debug

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

    --enable-cassert

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

    --enable-depend

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

    如果你喜欢用那些和 configure 找出来的不同的 C 编译器,那么你可以你的环境变量 CC 设置为你选择的程序。缺省时,configure 将选择 gcc,除非着在该平台上不合适。 类似地,你可以用 CFLAGS 变量覆盖缺省编译器标志。

    你可以在 configure 命令行上声明环境变量, 比如:

    ./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe'

  2. 制作

    开始制作,敲入

    gmake

    (一定要记得用 GNU make.) 依你的硬件而异,制作过程可能需要 5 分钟到半小时.显示的最后一行应该是

    All of PostgreSQL is successfully made. Ready to install.

  3. 回归测试

    如果你想在安装文件前测试新制作的服务器, 那么你可以在这个时候运行回归测试。 回归测试是一个用于验证PostgreSQL在你的系统上是否按照开发人员设想的那样运行的测试套件。 敲入

    gmake check

    (这条命令在 root 里无法使用;请在非特权用户下运行该命令。) 很有可能有些测试因为错误信息的用语或浮点结果的问题而失败。文件 Chapter 26 包含关于如何解释测试结果的详细信息。 你可以在以后的任何时间通过执行这条命令来运行这个测试。

  4. 安装文件

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

    要安装 PostgreSQL 键入

    gmake install

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

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

    标准的安装只提供那些开发客户端应用的头文件。 如果你准备做任何服务器端的程序开发(比如用 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所探测的东西(比如,升级了软件), 那么在重新配置和制作之前运行一下 gmake distclean 是个好习惯。 如果不做这个事情, 你修改的配置选项可能无法传播到所有需要变化的地方.