1.5. 安装过程

  1. 配置

    安装过程的第一步就是配置源代码树并选择你喜欢的选项. 这个工作是通过运行 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

    注意: 为了减少对共享安装位置(比如 /usr/local/include) 的污染,configure 自动在 datadirsysconfdirincludedir, 和 docdir 上附加一个 “/postgresql” 字串, 除非完全展开以后的目录名字已经包含字串 “postgres” 或者 “pgsql”.比如,如果你选择 /usr/local 做前缀,那么 C 的头文件将安装到 /usr/local/include/postgresql, 但是如果前缀是 /opt/postgres,那么它们将 被放进 /opt/postgres/include

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

    允许使用多字节编码.这个选项主要是用于象日语,韩语和中文 这样的语言.阅读 Section 5.2 获取详细信息.

    --with-pgport=NUMBER

    NUMBER 设置为服务器和客户端的缺省端口.缺省是 5432. 这个端口可以在以后设置,不过如果你在这里声明,那么 服务器和客户端将有相同的编译好了的缺省值.这样会方便些.

    --with-CXX

    制作C++支持库.

    --with-perl

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

    --with-python

    制作 Python 接口模块.你需要 root 权限将 Python 模块安装到它的 缺省位置 (/usr/lib/pythonx.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.shtkConfig.sh, 她们里面包含制作 Tcl 或 Tk 模块接口的配置信息. Configure 通常会自动在她们的众所周知的位置找到这些文件,但是如果你 需要一个不同版本的 Tcl 或 Tk,你也可以声明可以找到她们的目录.

    --enable-odbc

    制作 ODBC 驱动包.

    --with-odbcinst=DIRECTORY

    声明 ODBC 期望的odbcinst.ini配置文件的路径. 缺省是 /usr/local/pgsql/etc 或者你声明的 --sysconfdir 选项的内容. 安装程序将会把一个缺省的文件安装到那里.

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

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

    --enable-syslog

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

    --enable-debug

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

    --enable-cassert

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

    如果你喜欢用那些和 configure 找出来的不同的 编译器,那么你可以分别设置你的环境变量 CCCXX,把它们设置为你选择的程序. 类似地,你可以用 CFLAGSCXXFLAGS 变量覆盖缺省编译器标志.比如:

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

  2. 制作

    开始制作,敲入

    gmake
    (一定要记得用 GNU make.) 制作过程可能需要 5 分钟到半小时.显示的最后一行应该是
    All of PostgreSQL is successfully made. Ready to install.

  3. 蜕变测试

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

    gmake check
    很有可能有些测试因为错误信息的用语或浮点结果的问题而失败. 文件 Chapter 12 包含关于如何解释测试结果的详细信息. 你可以在以后的任何时间通过执行这条命令来运行这个测试.

  4. 安装文件

    注意: 如果你正在升级一套现有的系统并且准备把新文件安装在旧文件上面 ,那么你现在就应该备份数据并关闭你的旧服务器,象上面 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 制作环境的特殊,第一条命令实际上会重新制作整个接口 然后再安装它. 这样没什么害处,只是不常见而已.如果你自己没有超级用户 权限:你还是可以安装必须的文件并且把她们放到其它的 Perl 或 Python 找得到的地方,怎么做就留给大家做练习吧. (译注:可以 man ld.so,注意里面的 LD_LIBRARYPATH,和 LD_PRELOAD 等变量.)

    标准的安装只安装那些开发客户端应用的头文件. 如果你准备做任何服务器端的程序开发(比如用 C 写客户函数或者数据类型), 那么你可能就要把整个 PostgreSQL 头文件树安装到 你的目标头文件目录中.如果需要这么做,键入

    gmake install-all-headers
    安装这些东西需要一两兆空间,只有在你不想保留整个源码树用做引用用途 的情况下才需要这么做.(如果你保留了源码树,那么你可以用源码里面的 头文件制作服务器端的软件.

    只装客户端. 如果你只想装客户应用和接口,那么你可以用下面的命令:

    gmake -C src/bin install
    gmake -C src/interfaces install
    gmake -C doc install

    要撤销安装可以使用命令 gmake uninstall.不过这样不会删除 Perl 和 Python 接口而且也不删除任何目录.

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