配置
安装过程的第一步就是配置源代码树并选择你喜欢的选项。 这个工作是通过运行 configure 脚本实现的,对于缺省安装,你只需要简单地敲入
./configure
该脚本将运行一些测试来猜测一些系统相关的变量, 并检测你的操作系统的特殊设置,并且最后将在制做树中创建一些文件以记录它找到了什么。 (如果你想保持制作目录的独立,那么你也可以在源代码树外面的目录里运行 configure。)
缺省设置将制作服务器和应用程序,还有所有只需要 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。
--datadir=DIRECTORY
设置所安装的程序需要的只读文件的目录。缺省是 PREFIX/share。 请注意这个目录和你放数据库文件的地方没有任何关系。
--sysconfdir=DIRECTORY
用于各种各样配置文件的目录,缺省为 PREFIX/etc。
--libdir=DIRECTORY
库文件和动态装载模块的目录。缺省是 EXEC-PREFIX/lib。
--includedir=DIRECTORY
C 和 C++ 头文件的目录。缺省是 PREFIX/include。
--mandir=DIRECTORY
随着 PostgreSQL 一起带的手册页将安装到这个目录。在它们相应的 manx子目录里。 缺省是 PREFIX/man。
--with-docdir=DIRECTORY
--without-docdir
除"man(手册页)"以外的文档文件将被安装到这个目录。缺省是 PREFIX/doc。 如果声明了 --without-docdir,那么文档将不会被 make install 安装。这是给那些使用特殊方法安装文档的打包脚本使用的。
注意:为了让PostgreSQL能够安装在一些共享的安装位置(比如 /usr/local/include), 同时又不至于和系统其它部分产生名字空间干扰,我们采取了一些步骤。 首先,安装脚本会自动给 datadir, sysconfdir,和 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
制作 PL/Python 服务器端编程语言。
--with-tcl
制作服务器编程语言 PL/Tcl。
--with-tclconfig=DIRECTORY
Tcl 的安装文件 tclConfig.sh, 她们里面包含制作 Tcl 模块的配置信息。 Configure 通常会自动在她们的著名的位置找到这些文件, 但是如果你需要一个不同版本的 Tcl,你也可以声明可以找到她们的目录。
</pre>--with-krb5</pre>制作支持 Kerberos 5 认证的东西。 在许多系统上,Kerberos 系统没有安装在缺省搜索的目录下(比如,/usr/include, /usr/lib),所以你必须使用附加的 --with-includes 和 --with-libraries选项。 configure 在继续配置之前将检查所需要的头文件和库,以确保你的 Kerberos 是足够的
--with-krb-srvnam=NAME
缺省的 Kerberos 服务主的名称。 缺省是 postgres。通常没有理由改变这个值。
--with-openssl
制作支持 SSL (加密的)联接。 这个选项需要安装 OpenSSL 包。 configure 将在安装之前检查所需要的头文件和库文件以确信你的 OpenSSL 安装是充分的。
--with-pam
制作 PAM (可插拔认证模块)支持。
--without-readline
避免使用Readline库。这样就关闭了 psql 里的命令行编辑和历史, 因此我们不建议这么做。
--with-bonjour
制作 Bonjour 支持。这要求你的操作系统支持 Bonjour。 在 Mac OS X 上建议使用。
--enable-integer-datetimes
使用 64 位的整数存储时间和间隔,而不是用缺省的浮点数存储。 这样做限制了数值可以表达的范围,但是保证了整个范围里的毫秒数的精度(参阅 Section 8.5 获取更多信息)。请注意整数时间的代码比浮点数时间的代码要新, 我们也会偶尔发现里面有毛病。
--disable-spinlocks
允许在 PostgreSQL 没有该平台的 CPU 自旋锁支持的情况下制作成功。 缺乏自旋锁的支持将导致性能恶化;因此,只有在制作过程退出, 并且告诉你说该平台缺乏自旋锁支持的时候才使用这个选项。 如果在你的平台上需要这个选项才能制作 PostgreSQL, 请向 PostgreSQL 开发者报告这个问题。
--enable-thread-safety
令客户端库是线程安全的。这样就允许在 libpq 和 ECPG 程序里的并发线程安全地控制他们私有的连接句柄。 这个选项要求你的操作系统上有足够的线程支持。
--without-zlib
避免使用Zlib库。这样就关闭了 pg_dump 和 pg_restore 里面的压缩支持。这个选项只适用于那些没有这个库的罕见的系统。
--enable-debug
把所有程序和库以带有调试符号的方式编译。 这意味着你可以通过一个调试器运行程序来分析问题。 这样做显著增大了最后安装的可执行文件的大小, 并且在非 GCC 的编译器上,这么做通常还要关闭编译器优化, 导致速度的下降。但是,如果有这些符号表的话,就可以非常有效地帮助定位可能发生问题的位置。 目前,我们只是在你使用 GCC 的情况下才建议在生产安装中使用这个选项。 但是如果你正在进行开发工作,或者正在使用 beta 版本,那么你就总应该打开它。
--enable-cassert
打开在服务器中的 assertion 检查, 它会检查许多"不可能发生"的条件。它对于代码开发的用途而言是无价之宝, 不过这些测试稍微地减慢了一些速度。并且,打开这个测试不会提高你的系统的稳定性! 这些断言检查并不是按照错误的严重性分类的,因此一些相对无害的小虫子也可能导致服务器重启--只要它触发了一次断言失败。 目前,我们不推荐在生产环境中使用这个选项,但是如果你在做开发或者在使用 beta 版本的时候应该打开它。
--enable-depend
打开自动倚赖性跟踪。如果打开这个选项,那么制作文件(makefile)将设置为在任何头文件被修改的时候都将重新制作所有受影响的目标文件。 如果你在做开发的工作,那么这个选项很有用,但是如果你只是想编译一次并且安装,那么这就是浪费时间。 目前,这个选项只有在你使用 GCC 的时候才管用。
如果你喜欢用那些和 configure 找出来的不同的 C 编译器,那么你可以你的环境变量 CC 设置为你选择的程序。缺省时,configure 将选择 gcc,只要是可用的, 或者是该平台的缺省(通常是 cc)。 除非着在该平台上不合适。类似地,你可以用 CFLAGS 变量覆盖缺省编译器标志。
你可以在 configure 命令行上声明环境变量, 比如:
./configure CC=/opt/bin/gcc CFLAGS='-O2 -pipe'