移动旧集簇（可选）

如果你使用的是带版本号的安装目录，例如 /opt/PostgreSQL/8.4，则无需移动旧集簇。 一键安装程序都使用带版本号的安装目录。

如果你的安装目录不是带版本号的，例如 /usr/local/pgsql， 就必须移动当前的 PostgreSQL 安装目录，以免它干扰新的 PostgreSQL 安装。当前的 PostgreSQL 服务器关闭后，就可以安全地重命名 PostgreSQL 安装目录。假设旧目录是 /usr/local/pgsql， 你可以这样做：

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

以上命令会重命名该目录。

对于源码安装，编译新版本

使用与旧集簇兼容的 configure 标志编译新的 PostgreSQL 源码。 pg_upgrade 会在开始升级前检查 pg_controldata， 以确保所有设置都兼容。

安装新的 PostgreSQL 二进制文件

安装新服务器的二进制文件和支持文件。两个集簇可以使用相同的 端口号（通常是 5432），因为新旧集簇不会同时运行。

对于源码安装，如果你希望把新服务器安装到自定义位置，可以使用 prefix 变量：

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

安装 pg_upgrade 和 pg_upgrade_support

Install pg_upgrade and pg_upgrade_support in the new PostgreSQL cluster

初始化新的 PostgreSQL 集簇

使用 initdb 初始化新集簇。这里同样要使用与旧集簇匹配的兼容 initdb 标志。许多预构建的安装程序会自动执行该步骤。 无需启动新集簇。

安装自定义共享对象文件

把旧集簇使用的任何自定义共享对象文件（或 DLL）安装到新集簇中， 例如 pgcrypto.so，无论它们来自 contrib 还是其他来源。不要安装模式定义， 例如 pgcrypto.sql，因为它们会从旧集簇迁移 过来。

调整认证

pg_upgrade 会连接新旧服务器若干次，因此 你可能希望在 pg_hba.conf 中把 local Unix 域套接字认证设置为 ident，或者使用 ~/.pgpass 文件（见 第 31.14 节）。

停止两个服务器

确保两个数据库服务器都已停止。例如，在 Unix 上使用：

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

或者在 Windows 上使用正确的服务名：

NET STOP postgresql-8.4
NET STOP postgresql-9.0

或

NET STOP pgsql-8.3  (PostgreSQL 8.3 及更早版本使用不同的服务名)

Run pg_upgrade

始终运行新服务器的 pg_upgrade 二进制，而不是旧服务器的。 pg_upgrade 需要指定新旧集簇的数据目录和可执行文件 （bin）目录。你还可以指定用户和端口值，以及是否希望链接数据而不是复制（默认）。

如果使用链接模式，升级将快得多（无需复制文件），但一旦在 升级后启动新集簇，就无法再访问旧集簇。链接模式还要求新旧 集簇的数据目录位于同一文件系统中。完整选项列表请参阅 pg_upgrade --help。

对于 Windows 用户，必须以管理员账户登录，然后以 postgres 用户启动一个 shell 并设置正确的 路径：

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 还会概述迁移后你需要 手动调整的任何内容。 pg_upgrade 需要对当前目录有写权限。

显然，迁移期间不应有人访问集簇。可以考虑为旧集簇和新集簇 使用非默认端口号，例如 50432，以避免升级期间出现意外的客户端 连接。

如果在恢复数据库模式期间发生错误， pg_upgrade 会退出，你将不得不按下文 步骤 14 所述回退到旧集簇。要再次尝试 pg_upgrade，需要修改旧集簇，使 pg_upgrade 的模式恢复能够成功。如果问题出在 contrib 模块上，可能需要 从旧集簇卸载该 contrib 模块，并在迁移后把它安装到新集簇中， 前提是该模块没有被用来存储用户数据。

恢复 pg_hba.conf

If you modified pg_hba.conf, restore its original settings.

迁移后处理

如果需要任何迁移后处理，pg_upgrade 在完成时会发出警告。它还 会生成必须由管理员运行的脚本文件。这些脚本会连接到每个需要 迁移后处理的数据库。每个脚本应通过以下方式运行：

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

这些脚本可以按任意顺序运行，运行完毕后即可删除。

统计信息

由于优化器统计信息不会被 pg_upgrade 传输，系统会指示你在迁移结束时 运行一条命令来重新生成这些信息。

删除旧集簇

对升级结果满意后，可以运行 pg_upgrade 完成时提到的脚本删除旧集簇的 数据目录。还可以删除旧的安装目录 （例如 bin、share）。

恢复到旧集簇

如果在运行 pg_upgrade 之后希望回退到旧集簇，有以下 几种选择：