pg_upgrade

选择性的移动实例的安装目录

如果你用了指定版本的安装目录，例如 /opt/PostgreSQL/9.1, 你不需要再移动 旧的安装目录。图形化安装工具都是指定安装目录的。

如果你的安装目录不是版本指定的，例如 /usr/local/pgsql, 这就有必要 移动当前的安装目录，这样就避免影响了新的 PostgreSQL 的安装。 当 PostgreSQL 数据库服务停止后， 重命令PostgreSQL的安装 目录的操作是安全的;假如旧安装目录是 /usr/local/pgsql, 你可以用命令:

mv /usr/local/pgsql /usr/local/pgsql.old

来重命令当前目录名。

用源码安装，构建一个新的版本

用兼容旧的数据库实例configure 选项来构建新的PostgreSQL。在开始升级之前 pg_upgrade 将会检查pg_controldata 来确保所有的设置都兼容。

安装新的二进制文件

安装新服务器的二进制可执行文件和支持文件。

用源码安装时，如果你想要在自定义目录安装新服务器，可以使用 prefix 变量:

make prefix=/usr/local/pgsql.new install

Install pg_upgrade and pg_upgrade_support

在新PostgreSQL的安装中，安装 pg_upgrade 二进制文件 and pg_upgrade_support库文件 。

初始化新的数据库实例

使用initdb命令初始化新的数据库实例。 并且，要用兼容的旧数据库实例的initdb 选项 。 很多预构建安装会自动完成这一部。不需要去启动新的数据库实例。

安装自定义的共享对象文件

安装任意旧集群用到的自定义共享对象文件（或者是DLL文件）, 例如 pgcrypto.so, 无论他们来自 contrib 或者其它的源。不要安装模式的定义， 例如pgcrypto.sql, 因为这些也会从旧集群中升级。另外，任何自定义全文本搜索文件（字典，同义词，辞典，停用词） 必须也拷贝到新的集群中。

调整连接认证

pg_upgrade 会数次连到新旧数据库实例，所以你修改 pg_hba.conf,可以把认证设置成或者使用 ~/.pgpass文件 (参考 第 31.15 节).

停止新旧数据库

确保两个数据库都停止使用， 在类Unix操作系统中使用 例如:

pg_ctl -D /opt/PostgreSQL/8.4 stop
pg_ctl -D /opt/PostgreSQL/9.0 stop

在Windows中，使用windows可用的服务名：

NET STOP postgresql-8.4
NET STOP postgresql-9.0

或者

NET STOP pgsql-8.3  (8.3和更早版本的PostgreSQL  使用了不同的服务器）

运行 pg_upgrade

运行新数据库的可执行命令 pg_upgrade ， 而不是旧数据库的。 pg_upgrade 需要指定新旧数据库实例的数据目录和可执行的 (bin) 目录。 当然你还可以指定用户和端口，指定是否使用数据硬链接代替使用 数据复制（默认方式）。

如果你使用链接模式，升级将会非常快（没有文件拷贝）并且占用更少的硬盘，但是你不能 再访问你的旧数据库当你升级完成启动新的数据库实例。 链接模式还需要新旧数据库 数据目录使用相同的文件系统。（表空间和 pg_xlog 可以在不同的 文件系统。） 参考 pg_upgrade --help 查看完整的帮助选项列表。

--jobs 选项可以在拷贝/链接数据文件时使用多CPU核心并且可以并行 的还原数据库模式;一个好的值是CPU核数和表空间的最大值。在一个多核数据库 机器上升级一个多数据库服务器时这个选项能大量的节约时间。

For Windows users, you must be logged into an administrative account, and 对于Windows用户来说，你必要登录一个管理员的帐号，并且用 postgres 用户来启动一个终端设置可用的PATH

RUNAS /USER:postgres "CMD.EXE"
SET PATH=%PATH%;C:\Program Files\PostgreSQL\9.0\bin;

然后运行 pg_upgrade 带上引号， 例如:

pg_upgrade.exe
        --old-datadir "C:/Program Files/PostgreSQL/8.4/data"
        --new-datadir "C:/Program Files/PostgreSQL/9.0/data"
        --old-bindir "C:/Program Files/PostgreSQL/8.4/bin"
        --new-bindir "C:/Program Files/PostgreSQL/9.0/bin"

开始以后， pg_upgrade会验证两个数据库实例是兼容的 然后开始升级。 你可以使用 pg_upgrade --check 去执行检查工作，甚至是旧数据库实例仍在运行。pg_upgrade --check 会概述一些自定义的调整你需要在升级后去查看。如果你使用了链接模式，你必需要 要用--link参数和--check 来启用指定链接模式的 检查。 pg_upgrade 需要对当前目录有可写权限。

在数据库升级过程中不能访问数据库实例这是显而易见的。pg_upgrade 默认在端口50432运行来避免预期之外的数据库连接。当你在升级的时候你可以在 新旧数据库实例上使用同一个端口因为新旧数据库实例不会同时运行 然而， 当查检旧数据库实例时， 新旧数据库实例的端口必需不同。

如果在还原数据库模式时出现错误时， pg_upgrade 将会退出你必需参照 步骤 14的概要信息还原旧实例 再一次使用pg_upgrade ， 你可能需要修改旧实例以让旧数据库模式 升级成功。如果问题出现在某个外部模块上，你可能需要从旧实例上卸载这些外部模块 然后在升级成功后再在新实例上安装它们，假设模块没有被用于储存用户数据。

还原 pg_hba.conf

如果你修改了pg_hba.conf，还原它的原来的设置。 还有可能需要去调整其它的配置文件去和旧的集群相匹配，例如postgresql.conf.

升级后的处理

如果有升级后续操作需要执行，pg_upgrade会在完成后发布出警告消息。 同时它会生成由管理员运行脚本文件。 脚本会连到新旧数据库执行后续操作。 脚本可以用下面命令执行：

psql --username postgres --file script.sql postgres

脚本可以任意顺序执行，执行完后可以被删除。

统计

因为优化统计结果不会被pg_upgrade传递， 你需要指定去运行命令去在升级 完成后生成一些新的信息。你可能需要设置连接参数去匹配新的数据库实例。

删除旧的数据库实例

当pg_upgrade成功的升级完成后，你可能要运行脚本的 方法删除旧集群的数据目录。（如果在旧的数据目录中有用户定义的表空间， 那么自动删除是不可能的。）你也可以删除旧安装目录 (例如bin, share)。

还原到旧实例

如果，运行pg_upgrade后， 你希望回复到旧实例， 下面是一些选项：

• 如果你运行了加--check 参数的pg_upgrade ，不会对旧数据实例产生影响可以随时更新实用。

• 如果你运行了加--link参数的 pg_upgrade 数据文件会被新旧数据实例所共用，如果你启动了新数据实例，新的 数据库会写到那些共享文件上，这对旧实例是不安全的。

• 如果你运行了不加--link参数的 pg_upgrade 或者没有启动新的数据库，旧实例并没有被修改过，如果链接开始， .old后缀会出现在 $PGDATA/global/pg_control目录下。 为了重新旧数据实例，可以从$PGDATA/global/pg_control 目录下移除.old后缀的文件;然后你可以重启旧实例。