ddia/pg/pg-admin-install.md
2018-02-08 14:07:06 +08:00

40 KiB
Raw Blame History

author description categories tags type
Vonng PostgreSQL安装方法
Dev
PostgreSQL
Admin
Install
post

PostgreSQL Installation

生产环境使用的方式

使用pg_init.sh脚本

通过-P 参数指定数据库角色名,-V指定数据库版本号,-R指定数据库的角色masterslave

#!/bin/env bash

# ########################################################################
# PostgreSQL environment initialize program
# License: DBA
# Version: 1.1
# Authors: panwenhang
# ########################################################################

declare -r PROGDIR="$(cd $(dirname $0) && pwd)"
declare -r PROGNAME="$(basename $0)"

declare -x -r DIR_BASE='/export'
declare -x -r HOME='/home'

export PATH=/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:$PATH

# ##########################################################
# usage of this script
# ##########################################################
usage() {
	cat <<- EOF

	Usage: $PROGNAME [options]

	You must execute this program with system superuser privilege (root)!
	The product and dbversion must use together.

	OPTIONS:
	    -U, --superuser=username    Database superuser
	    -P, --product=product       product name
	    -B, --dbbase=dbbase         base directory of postgresql
	    -R, --role=master           master or slave
	    -V, --dbversion             Database version
	    -h, --help                  usage of this program

	Example:
	    $PROGNAME -P test -V 9.6
	    $PROGNAME -B /var/lib/pgsql/9.6 -V 9.6
	    $PROGNAME -U dbsu -P test -R master -V 9.6

	EOF
}

# ##########################################################
# check execute user
# ##########################################################
check_exec_user() {
	if [[ "$(whoami)" != "root" ]]; then
		usage
		exit -1
	fi
}

# ##########################################################
# initialize superuser
# args:
#    arg 1: superuser name
# ##########################################################
user_init() {
	if (( "$#" == 1 )); then
		local dbsu="$1"; shift

		if ( ! grep -q "$dbsu" /etc/group ); then
		    groupadd "$dbsu"
		fi

		if ( ! grep -q "$dbsu" /etc/passwd ); then
		    useradd -d "$HOME"/"$dbsu" -g "$dbsu" "$dbsu"
		fi

		if ( ! grep -q "$dbsu" /etc/passwd ) && ( ! grep -q "$dbsu" /etc/sudoers ); then
		    chmod u+w /etc/sudoers
		    echo "$dbsu          ALL=(ALL)         NOPASSWD: ALL" >> /etc/sudoers
		fi

		return 0
	else
		return 1
	fi
}

# ##########################################################
# initialize directory
# args:
#    arg 1: superuser name
#    arg 2: databse base directory
# ##########################################################
dir_init() {
	if (( "$#" == 2 )); then
		local dbsu="$1"; shift
		local datadir="$1"; shift

		mkdir -p "$datadir"/{data,backup,rbackup,arcxlog,conf,scripts}
		chown -R "$dbsu":"$dbsu" "$datadir"
		chmod 0700 "$datadir"/data

		return 0
	else
		return 1
	fi
}

# ##########################################################
# install package of postgresql
# args:
#    arg 1: postgresql version
# ##########################################################
pg_install() {
	if (( "$#" == 1 )); then
		local dbversion="$1"; shift
		local major_version="${dbversion:0:3}"
		local short_version="$(echo $dbversion \
		     | awk -F'.' '{print $1$2}')"
		local rpm_base=''
		local os_release=''

		if ( grep -q 'CentOS release 6' /etc/redhat-release ); then
		    rpm_base="http://yum.postgresql.org/$major_version/redhat/rhel-6Server-$(uname -m)"
		    os_release="rhel6"
		elif ( grep -q 'CentOS Linux release 7' /etc/redhat-release ); then
		    rpm_base="http://yum.postgresql.org/$major_version/redhat/rhel-7Server-$(uname -m)"
		    os_release="rhel7"
		fi

		yum clean all && yum install -q -y epel-release
		yum install -q -y tcl perl-ExtUtils-Embed libxml2 libxslt uuid readline lz4 nc
		yum install -q -y "$rpm_base"/pgdg-centos"$short_version"-"$major_version"-1.noarch.rpm
		yum install -q -y "$rpm_base"/pgdg-centos"$short_version"-"$major_version"-2.noarch.rpm
		yum install -q -y "$rpm_base"/pgdg-centos"$short_version"-"$major_version"-3.noarch.rpm

		yum install -q -y postgresql"$short_version" postgresql"$short_version"-libs postgresql"$short_version"-server postgresql"$short_version"-contrib postgresql"$short_version"-devel postgresql"$short_version"-debuginfo

		yum install -q -y pgbouncer pgpool-II-"$short_version" pg_top"$short_version" postgis2_"$short_version" postgis2_"$short_version"-client pg_repack"$short_version"

		rm -f /usr/pgsql
		ln -sf /usr/pgsql-"$major_version" /usr/pgsql
		echo 'export PATH=/usr/pgsql/bin:$PATH' > /etc/profile.d/pgsql.sh
	fi
}

# ##########################################################
# install package of postgresql for custom
# args:
#    arg 1: postgresql version
# ##########################################################
pg_install_custom() {
	if (( "$#" == 1 )); then
		local dbversion="$1"; shift
		local major_version="${dbversion:0:3}"
		local short_version="$(echo $dbversion \
		     | awk -F'.' '{print $1$2}')"
		local rpm_base='http://download.postgresql.com/packages/RPMS/'
		local os_release=''

		if ( grep -q 'CentOS release 6' /etc/redhat-release ); then
		    os_release="el6"
		elif ( grep -q 'CentOS Linux release 7' /etc/redhat-release ); then
		    os_release="el7"
		fi

		if ( ! rpm --quiet -q postgresql-"$dbversion"-1."$os_release"."$(uname -m)" ); then
		    yum install -q -y tcl perl-ExtUtils-Embed libxml2 libxslt uuid readline
		    rpm -ivh --force "$rpm_base"/"$(uname -m)"/postgresql-"$dbversion"-1."$os_release"."$(uname -m)".rpm
		fi
	fi
}

# ##########################################################
# postgresql shared xlog archive directory
# args:
#    arg 1: postgresql base directory
# ##########################################################
shared_xlog() {
	if (( "$#" == 1 )); then
		local datadir="$1"; shift
		yum install -y -q nfs-utils
		echo "$datadir/arcxlog 10.191.0.0/16(rw)" > /etc/exports
		service nfs start
	fi
}

# ##########################################################
# postgresql optimize
# args:
#    arg 1: postgresql base directory
# ##########################################################
optimize() {
	if (( "$#" == 1 )); then
		local datadir="$1"; shift
		local mem="$(free \
		     | awk '/Mem:/{print $2}')"
		local swap="$(free \
		     | awk '/Swap:/{print $2}')"

		cat > /etc/sysctl.conf <<- EOF
		# Database kernel optimisation
		fs.aio-max-nr = 1048576
		fs.file-max = 76724600
		kernel.sem = 4096 2147483647 2147483646 512000
		kernel.shmmax = $(( $mem * 1024 / 2 ))
		kernel.shmall = $(( $mem / 5 ))
		kernel.shmmni = 819200
		net.core.netdev_max_backlog = 10000
		net.core.rmem_default = 262144
		net.core.rmem_max = 4194304
		net.core.wmem_default = 262144
		net.core.wmem_max = 4194304
		net.core.somaxconn = 4096
		net.ipv4.tcp_max_syn_backlog = 4096
		net.ipv4.tcp_keepalive_intvl = 20
		net.ipv4.tcp_keepalive_probes = 3
		net.ipv4.tcp_keepalive_time = 60
		net.ipv4.tcp_mem = 8388608 12582912 16777216
		net.ipv4.tcp_fin_timeout = 5
		net.ipv4.tcp_synack_retries = 2
		net.ipv4.tcp_syncookies = 1
		net.ipv4.tcp_timestamps = 1
		net.ipv4.tcp_tw_recycle = 0
		net.ipv4.tcp_tw_reuse = 1
		net.ipv4.tcp_max_tw_buckets = 262144
		net.ipv4.tcp_rmem = 8192 87380 16777216
		net.ipv4.tcp_wmem = 8192 65536 16777216
		vm.dirty_background_bytes = 409600000
		net.ipv4.ip_local_port_range = 40000 65535
		vm.dirty_expire_centisecs = 6000
		vm.dirty_ratio = 80
		vm.dirty_writeback_centisecs = 50
		vm.extra_free_kbytes = 4096000
		vm.min_free_kbytes = 2097152
		vm.mmap_min_addr = 65536
		vm.swappiness = 0
		vm.overcommit_memory = 2
		vm.overcommit_ratio = $(( ( $mem - $swap ) * 100 / $mem ))
		vm.zone_reclaim_mode = 0
		EOF
		sysctl -p

		if ( ! type -f grubby &>/dev/null  ); then
			yum install -q -y grubby
		fi
		grubby --update-kernel=/boot/vmlinuz-$(uname -r) --args="numa=off transparent_hugepage=never"

		if [[ -x /opt/MegaRAID/MegaCli/MegaCli64 ]]; then
			/opt/MegaRAID/MegaCli/MegaCli64 -LDSetProp WB -LALL -aALL
			/opt/MegaRAID/MegaCli/MegaCli64 -LDSetProp ADRA -LALL -aALL
			/opt/MegaRAID/MegaCli/MegaCli64 -LDSetProp -DisDskCache -LALL -aALL
			/opt/MegaRAID/MegaCli/MegaCli64 -LDSetProp -Cached -LALL -aALL
		fi

		if ( ! grep -q 'Database optimisation' /etc/rc.local ); then
			cat >> /etc/rc.local <<- EOF
			# Database optimisation
			echo 'never' > /sys/kernel/mm/transparent_hugepage/enabled
			echo 'never' > /sys/kernel/mm/transparent_hugepage/defrag
			#blockdev --setra 16384 $(echo $(blkid | awk -F':' '$1!~"block"{print $1}'))
			EOF
			chmod +x /etc/rc.d/rc.local
		fi

		cat > /etc/security/limits.d/postgresql.conf <<- EOF
		postgres    soft    nproc       655360
		postgres    hard    nproc       655360
		postgres    hard    nofile      655360
		postgres    soft    nofile      655360
		postgres    soft    stack       unlimited
		postgres    hard    stack       unlimited
		postgres    soft    core        unlimited
		postgres    hard    core        unlimited
		postgres    soft    memlock     250000000
		postgres    hard    memlock     250000000
		EOF
		cat > /etc/security/limits.d/pgbouncer.conf <<- EOF
		pgbouncer    soft    nproc       655360
		pgbouncer    hard    nofile      655360
		pgbouncer    soft    nofile      655360
		pgbouncer    soft    stack       unlimited
		pgbouncer    hard    stack       unlimited
		pgbouncer    soft    core        unlimited
		pgbouncer    hard    core        unlimited
		pgbouncer    soft    memlock     250000000
		pgbouncer    hard    memlock     250000000
		EOF
		cat > /etc/security/limits.d/pgpool.conf <<- EOF
		pgpool    soft    nproc       655360
		pgpool    hard    nofile      655360
		pgpool    soft    nofile      655360
		pgpool    soft    stack       unlimited
		pgpool    hard    stack       unlimited
		pgpool    soft    core        unlimited
		pgpool    hard    core        unlimited
		pgpool    soft    memlock     250000000
		pgpool    hard    memlock     250000000
		EOF
	fi
}

# ##########################################################
# postgresql config file
# args:
#    arg 1: postgresql superuser
#    arg 2: postgresql base directory
#    arg 3: postgresql short version
# ##########################################################
pg_conf_init() {
	if (( "$#" == 3 )); then
		local dbsu="$1"; shift
		local datadir="$1"; shift
		local short_version="$1"; shift

		cat > "$datadir"/conf/pg_hba.conf <<- EOF
		host    all                 $dbsu        0.0.0.0/0          reject
		host    monitor             monitordb    0.0.0.0/0          reject
		local   all                 all                             md5
		host    replication         all          0.0.0.0/0          md5
		host    all                 all          0.0.0.0/0          md5
		EOF

		cat > "$datadir"/conf/recovery.conf <<- EOF
		standby_mode = 'on'
		primary_conninfo = 'host=localhost port=5432 user=postgres password=password application_name=$(hostname)'
		###restore_command = '/bin/cp -n $datadir/arcxlog/%f %p'
		###restore_command = 'arcxlog=$datadir/arcxlog; /usr/bin/test -f \$arcxlog/\$(date +%Y%m%d)/%f.zip && unzip -o \$arcxlog/\$(date +%Y%m%d)/%f.zip'
        ###restore_command = 'arcxlog=$datadir/arcxlog; /usr/bin/test -f \$arcxlog/\$(date +%Y%m%d)/%f.lz4 && lz4 -q -d \$arcxlog/\$(date +%Y%m%d)/%f.lz4 %p'
		recovery_target_timeline = 'latest'
		EOF

		chown -R "$dbsu":"$dbsu" "$datadir"
	fi
}

# ##########################################################
# postgresql initdb
# args:
#    arg 1: postgresql base directory
#    arg 2: postgresql superuser
# ##########################################################
pg_initdb() {
	if (( "$#" == 2 )); then
	    local datadir="$1"; shift
	    local dbsu="$1"; shift

	    chown -R "$dbsu":"$dbsu" "$datadir"
	    chmod 0700 "$datadir"/data
	    if [[ "$( ls $datadir/data | wc -l )" == "0" ]]; then
	        su - "$dbsu" sh -c "source /etc/profile; initdb -D $datadir/data"
	        su - "$dbsu" sh -c "/bin/cp -a $datadir/data/postgresql.conf $datadir/data/postgresql.conf.bak"
	        su - "$dbsu" sh -c "/bin/cp -a $datadir/conf/postgresql.conf $datadir/data/postgresql.conf"
	        su - "$dbsu" sh -c "/bin/cp -a $datadir/data/pg_hba.conf $datadir/data/pg_hba.conf.bak"
	        su - "$dbsu" sh -c "/bin/cp -a $datadir/conf/pg_hba.conf $datadir/data/pg_hba.conf"
	    fi
	fi
}

main() {
	local product_name='test'
	local dbtype='postgresql'
	local db_version='9.6.0'
	local major_version='9.6'
	local short_version='96'
	local superuser='postgres'
	local dbbase=""
	local role="slave"

	check_exec_user

	while (( "$#" >= 0 )); do
	    case "$1" in
	        -U|--superuser=*)
	            if [[ "$1" == "-U" ]]; then
	                shift
	            fi
	            superuser="${1##*=}"
	            shift
	        ;;
	        -P|--product=*)
	            if [[ "$1" == "-P" ]]; then
	                shift
	            fi
	            product_name="${1##*=}"
	            shift
	        ;;
	        -B|--dbbase=*)
	            if [[ "$1" == "-B" ]]; then
	                shift
	            fi
	            dbbase="${1##*=}"
	            shift
	        ;;
	        -R|--role=*)
	            if [[ "$1" == "-R" ]]; then
	                shift
	            fi
	            role="${1##*=}"
	            shift
	        ;;
	        -V|--dbversion=*)
	            if [[ "$1" == "-V" ]]; then
	                shift
	            fi
	            db_version="${1##*=}"
	            major_version="${db_version:0:3}"
	            short_version="$(echo $db_version | awk -F'.' '{print $1$2}')"
	            shift
	        ;;
	        -h|--help)
	            usage
	            exit
	        ;;
	        *)
	            break
	        ;;
	    esac
	done

	dbtype="postgresql"

	if [[ -z "$dbbase" ]]; then
	    if [[ "$product_name" != "" ]] && [[ "$short_version" != "" ]]; then
	        dbbase="$DIR_BASE/$dbtype/${product_name}_${short_version}"
	    else
	        dbbase="$DIR_BASE/$dbtype"
	    fi
	fi

	user_init "$superuser"
	dir_init "$superuser" "$dbbase"

	pg_install "$db_version"
	pg_conf_init "$superuser" "$dbbase" "$short_version"

	if [[ "$role" == "master" ]]; then
	    shared_xlog "$dbbase"
	    pg_initdb "$dbbase" "$superuser"
	fi

	optimize "$dbbase"
}

main "$@"

从源码编译安装

./configure
make
su
make install
adduser postgres
mkdir /usr/local/pgsql/data
chown postgres /usr/local/pgsql/data
su - postgres
/usr/local/pgsql/bin/initdb -D /usr/local/pgsql/data
/usr/local/pgsql/bin/postgres -D /usr/local/pgsql/data >logfile 2>&1 &
/usr/local/pgsql/bin/createdb test
/usr/local/pgsql/bin/psql test

编译参数

16.4. 安装过程

  1. 配置

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

    ./configure
    

    该脚本将运行一些测试来决定一些系统相关的变量, 并检测你的操作系统的特殊设置,并且最后将在编译树中创建一些文件以记录它找到了什么。如果你想保持编译目录的独立,你也可以在一个源码树之外的目录中运行configure 。这个过程也被称为一个VPATH编译。做法如下:

    mkdir build_dir
    cd build_dir
    /path/to/source/tree/configure [options go here]
    make
    

    默认设置将编译服务器和辅助程序,还有只需要 C 编译器的所有客户端程序和接口。默认时所有文件都将安装到/usr/local/pgsql

    你可以通过给出下面的configure命令行选项中的一个或更多的选项来自定义编译和安装过程:

    • --prefix=*PREFIX*

      把所有文件装在目录*PREFIX*中而不是/usr/local/pgsql中。 实际的文件会安装到数个子目录中;没有一个文件会直接安装到*PREFIX*目录里。如果你有特殊需要,你还可以用下面的选项自定义不同的子目录的位置。 不过,如果你把这些设置保留默认,那么安装将是可重定位的,意思是你可以在安装过后移动目录(mandoc位置不受此影响)。对于可重定位的安装,你可能需要使用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自带的手册页将安装到这个目录它们被安装在相应的man*x*子目录里。 默认是*DATAROOTDIR*/man

    • --docdir=*DIRECTORY*

      设置安装文档文件的根目录,"man"页不包含在内。这只为后续选项设置默认值。这个选项的默认值为*DATAROOTDIR*/doc/postgresql

    • --htmldir=*DIRECTORY*

      PostgreSQL的HTML格式的文档将被安装在这个目录中。默认值为*DATAROOTDIR*

    **注意: **为了让PostgreSQL能够安装在一些共享的安装位置例如/usr/local/include 同时又不至于和系统其它部分产生名字空间干扰,我们特别做了一些处理。 首先,安装脚本会自动给datadirsysconfdirdocdir后面附加上"/postgresql"字符串, 除非展开的完整路径名已经包含字符串"postgres"或者"pgsql"。 例如,如果你选择/usr/local作为前缀, 那么文档将安装在/usr/local/doc/postgresql,但如果前缀是/opt/postgres 那么它将被放到/opt/postgres/doc。客户接口的公共 C 头文件安装到了includedir,并且是名字空间无关的。内部的头文件和服务器头文件都安装在includedir下的私有目录中。参考每种接口的文档获取关于如何访问头文件的信息。最后,如果合适,那么也会在libdir下创建一个私有的子目录用于动态可装载的模块。

    • --with-extra-version=*STRING*

      *STRING*追加到 PostgreSQL 版本号。例如,你可以使用它来标记从未发布的 Git 快照或者包含定制补丁(带有一个如git describe标识符之类的额外版本号或者一个分发包发行号)创建的二进制文件。

    • --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 接口的模块的配置信息。该文件通常可以自动地在一个众所周知的位置找到,但是如果你需要一个不同版本的 Tcl你也可以指定可以找到它的目录。

    • --with-gssapi

      编译 GSSAPI 认证支持。在很多系统上GSSAPI通常是 Kerberos 安装的一部分)系统不会被安装在默认搜索位置(例如/usr/include/usr/lib),因此你必须使用选项--with-includes--with-libraries来配合该选项。configure将会检查所需的头文件和库以确保你的 GSSAPI 安装足以让配置继续下去。

    • --with-krb-srvnam=*NAME*

      默认的 Kerberos 服务主的名称(也被 GSSAPI 使用)。默认是postgres。通常没有理由改变这个值,除非你是一个 Windows 环境,这种情况下该名称必须被设置为大写形式POSTGRES

    • --with-openssl

      编译SSL加密连接支持。这个选项需要安装OpenSSL包。configure将会检查所需的头文件和库以确保你的 OpenSSL安装足以让配置继续下去。

    • --with-pam

      编译PAM可插拔认证模块支持。

    • --with-bsd-auth

      编译 BSD 认证支持BSD 认证框架目前只在 OpenBSD 上可用)。

    • --with-ldap

      为认证和连接参数查找编译LDAP支持详见第 32.17 节第 20.3.7 节)。在 Unix 上这需要安装OpenLDAP包。在 Windows 上将使用默认的WinLDAP库。configure将会检查所需的头文件和库以确保你的 OpenLDAP安装足以让配置继续下去。

    • --with-systemd

      编译对systemd 服务通知的支持。如果服务器是在systemd 机制下被启动,这可以提高集成度,否则不会有影响 ; see 第 18.3 节 for more information。要使用这个选项必须安装libsystemd 以及相关的头文件。

    • --without-readline

      避免使用Readline库以及libedit。这个选项禁用了psql中的命令行编辑和历史 因此我们不建议这么做。

    • --with-libedit-preferred

      更倾向于使用BSD许可证的libedit库而不是GPL许可证的Readline。这个选项只有在你同时安装了两个库时才有意义在那种情况下默认会使用Readline。

    • --with-bonjour

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

    • --with-uuid=*LIBRARY*

      使用指定的 UUID 库编译 uuid-ossp模块(提供生成 UUID 的函数)。 *LIBRARY*必须是下列之一:bsd,用来使用 FreeBSD、NetBSD 和一些其他 BSD 衍生系统 中的 UUID 函数e2fs,用来使用e2fsprogs项目创建的 UUID 库, 这个库出现在大部分的 Linux 系统和 OS X 中,并且也能找到用于其他平台的 版本ossp,用来使用OSSP UUID library

    • --with-ossp-uuid

      --with-uuid=ossp的已废弃的等效选项。

    • --with-libxml

      编译 libxml (启用 SQL/XML 支持)。这个特性需要 Libxml 版本 2.6.23 及以上。Libxml 会安装一个程序xml2-config它可以被用来检测所需的编译器和链接器选项。如果能找到PostgreSQL 将自动使用它。要制定一个非常用的 libxml 安装位置,你可以设置环境变量XML2_CONFIG指向xml2-config程序所属的安装,或者使用选项--with-includes--with-libraries

    • --with-libxslt

      编译 xml2模块时使用 libxslt。xml2依赖这个库来执行XML的XSL转换。

    • --disable-integer-datetimes

      禁用对时间戳和间隔的64位存储支持并且将 datetime 值存储为浮点数。浮点 datetime 存储在PostgreSQL 8.4之前是默认方式,但是现在已经被废弃,因为它对于timestamp值的全范围不支持毫秒精度。但是,基于整数的 datetime 存储要求64位整数类型。因此当没有64位整数类型时可以使用这个选项或者在兼容为PostgreSQL之前版本开发的应用时使用。详见 第 8.5 节

    • --disable-float4-byval

      禁用 float4 值的"传值",导致它们只能被"传引用"。这个选项会损失性能,但是在需要兼容使用 C 编写并使用"version 0"调用规范的老用户定义函数时可能需要这个选项。更好的长久解决方案是将任何这样的函数更新成使用"version 1"调用规范。

    • --disable-float8-byval

      禁用 float8 值的"传值",导致它们只能被"传引用"。这个选项会损失性能,但是在需要兼容使用 C 编写并使用"version 0"调用规范的老用户定义函数时可能需要这个选项。更好的长久解决方案是将任何这样的函数更新成使用"version 1"调用规范。注意这个选项并非只影响 float8它还影响 int8 和某些相关类型如时间戳。在32位平台上--disable-float8-byval是默认选项并且不允许选择--enable-float8-byval

    • --with-segsize=*SEGSIZE*

      设置段尺寸,以 G 字节计。大型的表会被分解成多个操作系统文件每一个的尺寸等于段尺寸。这避免了与操作系统对文件大小限制相关的问题。默认的段尺寸1G字节在所有支持的平台上都是安全的。如果你的操作系统有"largefile"支持如今大部分都支持你可以使用一个更大的段尺寸。这可以有助于在使用非常大的表时消耗的文件描述符数目。但是要当心不能选择一个超过你将使用的平台和文件系统所支持尺寸的值。你可能希望使用的其他工具如tar也可以对可用文件尺寸设限。如非绝对必要我们推荐这个值应为2的幂。注意改变这个值需要一次 initdb。

    • --with-blocksize=*BLOCKSIZE*

      设置块尺寸,以 K 字节计。这是表内存储和I/O的单位。默认值8K字节适合于大多数情况但是在特殊情况下可能其他值更有用。这个值必须是2的幂并且在 1 和 32 K字节之间。注意修改这个值需要一次 initdb。

    • --with-wal-segsize=*SEGSIZE*

      设置WAL 段尺寸,以 M 字节计。这是 WAL 日志中每一个独立文件的尺寸。调整这个值来控制传送 WAL 日志的粒度非常有用。默认尺寸为 16 M字节。这个值必须是2的幂并且在 1 到 64 M字节之间。注意修改这个值需要一次 initdb。

    • --with-wal-blocksize=*BLOCKSIZE*

      设置WAL 块尺寸,以 K 字节计。这是 WAL 日志存储和I/O的单位。默认值8K 字节适合于大多数情况但是在特殊情况下其他值更好有用。这个值必须是2的幂并且在 1 到 64K字节之间。注意修改这个值需要一次 initdb。

    • --disable-spinlocks

      即便PostgreSQL对于该平台没有 CPU 自旋锁支持也允许编译成功。自旋锁支持的缺乏会导致较差的性能因此这个选项只有当编译终端或者通知你该平台缺乏自旋锁支持时才应被使用。如果在你的平台上要求使用该选项来编译PostgreSQL请将此问题报告给PostgreSQL的开发者。

    • --disable-thread-safety

      禁用客户端库的线程安全性。这会阻止libpq和ECPG程序中的并发线程安全地控制它们私有的连接句柄。

    • --with-system-tzdata=*DIRECTORY*

      PostgreSQL包含它自己的时区数据库它被用于日期和时间操作。这个时区数据库实际上是和 IANA 时区数据库相兼容的,后者在很多操作系统如 FreeBSD、Linux和Solaris上都有提供因此再次安装它可能是冗余的。当这个选项被使用时将不会使用*DIRECTORY*中系统提供的时区数据库,而是使用包括在 PostgreSQL 源码发布中的时区数据库。*DIRECTORY*必须被指定为一个绝对路径。/usr/share/zoneinfo在某些操作系统上是一个很有可能的路径。注意安装例程将不会检测不匹配或错误的时区数据。如果你使用这个选项建议你运行回归测试来验证你指定的时区数据能正常地工作在PostgreSQL中。这个选项主要针对那些很了解他们的目标操作系统的二进制包发布者。使用这个选项主要优点是不管何时当众多本地夏令时规则之一改变时 PostgreSQL 包不需要被升级。另一个优点是如果时区数据库文件在安装时不需要被编译, PostgreSQL 可以被更直接地交叉编译。

    • --without-zlib

      避免使用Zlib库。这样就禁用了pg_dump和 pg_restore中对压缩归档的支持。这个选项只适用于那些没有这个库的少见的系统。

    • --enable-debug

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

    • --enable-coverage

      如果在使用 GCC所有程序和库都会用代码覆盖率测试工具编译。在运行时它们会在编译目录中生成代码覆盖率度量的文件。详见第 31.5 节。这个选项只用于 GCC 以及做开发工作时。

    • --enable-profiling

      如果在使用 GCC所有程序和库都被编译成可以进行性能分析。在后端退出时将会创建一个子目录其中包含用于性能分析的gmon.out文件。这个选项只用于 GCC 和做开发工作时。

    • --enable-cassert

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

    • --enable-depend

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

    • --enable-dtrace

      为PostgreSQL编译对动态跟踪工具 DTrace 的支持。 详见第 28.5 节。要指向dtrace程序,必须设置环境变量DTRACE。这通常是必需的,因为dtrace通常被安装在/usr/sbin中,该路径可能不在搜索路径中。dtrace程序的附加命令行选项可以在环境变量DTRACEFLAGS中指定。在 Solaris 上要在一个64位二进制中包括 DTrace你必须为 configure 指定DTRACEFLAGS="-64"。例如,使用 GCC 编译器:./configure CC='gcc -m64' --enable-dtrace DTRACEFLAGS='-64' ...使用 Sun 的编译器:./configure CC='/opt/SUNWspro/bin/cc -xtarget=native64' --enable-dtrace DTRACEFLAGS='-64' ...

    • --enable-tap-tests

      启用 Perl TAP 工具进行测试。这要求安装了 Perl 以及 Perl 模块IPC::Run。 详见第 31.4 节

    如果你喜欢用那些和configure选取的不同的 C 编译器,那么你可以你的环境变量CC设置为你选择的程序。默认时,只要gcc可以使用,configure将选择它, 或者是该平台的默认(通常是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 还是 Python 3 (或者是隐式选择)决定了 PL/Python 语言的哪一种变种将成为可用的。详见 第 44.1 节

    • TCLSH

      Tcl 解释器的全路径。这将被用来决定编译 PL/Tcl 时的依赖性,并且它将被替换到 Tcl 脚本中。

    • XML2_CONFIG

      用于定位 libxml 安装的xml2-config程序。

    **注意: **在开发服务器内部代码时,我们推荐使用配置选项--enable-cassert(它会打开很多运行时错误检查)和--enable-debug(它会提高调试工具的有用性)。

    如果在使用 GCC最好使用至少-O1的优化级别来编译,因为不使用优化(-O0)会禁用某些重要的编译器警告(例如使用未经初始化的变量)。但是,非零的优化级别会使调试更复杂,因为在编译好的代码中步进通常将不能和源代码行一一对应。如果你在尝试调试优化过的代码时觉得困惑,将感兴趣的特定文件使用-O0编译。一种简单的方式是传递一个选项给makemake PROFILE=-O0 file.o

  2. 编译

    要开始编译,键入:

    make
    

    一定要记得用GNU make。依你的硬件而异编译过程可能需要 5 分钟到半小时。显示的最后一行应该是:

    All of PostgreSQL successfully made. Ready to install.
    

    如果你希望编译所有能编译的东西包括文档HTML和手册页以及附加模块contrib),这样键入:

    make world
    

    显示的最后一行应该是:

    PostgreSQL, contrib, and documentation successfully made. Ready to install.
    

  3. 回归测试

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

    make check
    

    (这条命令不能以 root 运行;请在非特权用户下运行该命令)。 (This won't work as root; do it as an unprivileged user.) 第 31 章包含关于如何解释测试结果的详细信息。你可以在以后的任何时间通过执行这条命令来运行这个测试。

  4. 安装文件

    **注意: **如果你正在升级一套现有的系统,请阅读 第 18.6 节 其中有关于升级一个集簇的指导。

    要安装PostgreSQL输入

    make install
    

    这条命令将把文件安装到在步骤 1中指定的目录。确保你有足够的权限向该区域写入。通常你需要用 root 权限做这一步。或者你也可以事先创建目标目录并且分派合适的权限。

    要安装文档HTML和手册页输入

    make install-docs
    

    如果你按照上面的方法编译了所有东西,输入:

    make install-world
    

    这也会安装文档。

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

    标准的安装只提供客户端应用开发和服务器端程序开发所需的所有头文件,例如用 C 写的定制函数或者数据类型在PostgreSQL 8.0 之前,后者需要独立地执行一次make install-all-headers命令,不过现在这个步骤已经融合到标准的安装步骤中)。

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

    make -C src/bin install
    make -C src/include install
    make -C src/interfaces install
    make -C doc install
    

    src/bin中有一些服务器专用的二进制文件,但是它们很小。

**卸载:. **要撤销安装可以使用命令make uninstall。不过这样不会删除任何创建出来的目录。

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

如果你执行了一次制作,然后发现你的configure选项是错误的, 或者你修改了任何configure所探测的东西(例如,升级了软件), 那么在重新配置和编译之前运行一下make distclean是个好习惯。如果不这样做, 你修改的配置选项可能无法传播到所有需要变化的地方。