移动旧集簇（可选）

如果你使用的是带版本号的安装目录，例如 /opt/PostgreSQL/10，则不必移动旧集簇。 图形化安装程序都使用带版本号的安装目录。

如果你的安装目录不是带版本号的，例如 /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 二进制文件

安装新服务器的二进制文件和支持文件。默认安装中包含 pg_upgrade。

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

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

初始化新的 PostgreSQL 集簇

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

安装扩展共享对象文件

许多来自 contrib 或其他来源的扩展和自定义模块都会使用 共享对象文件（或 DLL），例如 pgcrypto.so。如果旧集簇使用了这些模块， 则必须在新集簇中安装与新服务器二进制相匹配的共享对象文件，这通常通过操作系统命令完成。 不要装载模式定义，例如 CREATE EXTENSION pgcrypto， 因为这些会从旧集簇复制过来。如果有可用的扩展更新， pg_upgrade 会报告这一点，并创建一个稍后可运行的脚本来更新它们。

复制自定义全文检索文件

将所有自定义全文检索文件（词典、同义词、词库、停用词）从旧集簇复制到新集簇。

调整认证

pg_upgrade 会多次连接旧服务器和新服务器，因此你可能希望将认证设置为 peer（在 pg_hba.conf 中），或者使用 ~/.pgpass 文件（见 Section 33.15）。

停止两个服务器

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

pg_ctl -D /opt/PostgreSQL/9.6 stop
pg_ctl -D /opt/PostgreSQL/10 stop

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

NET STOP postgresql-9.6
NET STOP postgresql-10

流复制和日志传送备库可以继续运行，直到后面的步骤。

为备库升级做准备

如果你要使用Step 11节概述的方法升级备库， 请通过对旧主库集簇和备库集簇运行 pg_controldata 来确认旧备库已追上主库。 确认所有集簇中的 “Latest checkpoint location” 值一致。（如果旧备库在旧主库之前关闭，或者旧备库仍在运行，这些值就会不匹配。）另外， 请确保 wal_level 没有被设置为 minimal， 这一点可在新主库集簇的 postgresql.conf 文件中检查。

运行 pg_upgrade

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

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

--jobs选项允许使用多个 CPU 核心复制/链接文件，并行转储和重新装载数据库模式；一个不错的起始值是 CPU 核心数与表空间数量中的较大值。对于运行在多处理器机器上的多数据库服务器，此选项可以显著减少升级时间。

Windows 用户必须先登录管理员帐号，然后以 postgres 用户身份启动 shell，并设置正确的路径：

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

然后运行 pg_upgrade，并用引号括起目录，例如：

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

启动后，pg_upgrade会验证两个集簇是否兼容，然后执行升级。你可以使用 pg_upgrade --check 仅执行检查，即使旧服务器仍在运行。pg_upgrade --check还会概述升级后需要手工进行的调整。如果打算使用链接模式，应将 --link 选项与 --check 一起使用，以启用链接模式的专用检查。pg_upgrade需要对当前目录具有写权限。

显然，在升级期间不应有人访问这些集簇。pg_upgrade 默认会在 50432 端口上运行服务器，以避免意外的客户端连接。升级时可以让两个集簇使用相同 的端口号，因为新旧集簇不会同时运行。不过，在检查仍在运行的旧服务器时，新旧端口号必须不同。

如果在恢复数据库模式时发生错误，pg_upgrade 将退出，你必须按照下文 Step 17 所述回退到旧集簇。若要再次尝试 pg_upgrade，你需要修改旧集簇，使 pg_upgrade 的模式恢复步骤能够成功完成。 如果问题出在某个 contrib 模块，而该模块并未用于存储用户数据， 则你可能需要先从旧集簇卸载这个 contrib 模块，并在升级后将其安装到新集簇。

升级流复制和日志传送备库

如果你使用了链接模式，并且有流复制（见 Section 26.2.5） 或日志传送（见 Section 26.2）备库，可以按照下列步骤快速升级它们。 你无需在备库上运行 pg_upgrade，而是要在主库上运行 rsync。现在先不要启动任何服务器。

如果你没有使用链接模式、没有或不想使用 rsync， 或者想要更简单的方案，请跳过本节说明；待 pg_upgrade 完成且 新主库启动后，直接重建备库即可。

1. 在备库上安装新的 PostgreSQL 二进制文件

   确保所有备库都已安装新的二进制文件和支持文件。

2. 确保新的备库数据目录不存在

   确保新的备库数据目录不存在，或者为空。如果运行过 initdb，请删除备库的新数据目录。

3. 安装扩展共享对象文件

   在新备库上安装与新主库集簇中相同的扩展共享对象文件。

4. 停止备库

   如果备库仍在运行，请按上述说明立即停止它们。

5. 保存配置文件

   保存旧备库配置目录中需要保留的配置文件，例如 postgresql.conf （以及其包含的所有文件）、postgresql.auto.conf、 recovery.conf、pg_hba.conf，因为在下一步中它们会被覆盖或删除。

6. 运行 rsync

   在使用链接模式时，可以通过 rsync 快速升级备库。为此，在主库上选择一个位于新旧数据库集簇目录之上的目录，并在主库上针对每个备库运行：

   rsync --archive --delete --hard-links --size-only --no-inc-recursive old_cluster new_cluster remote_dir
   

   其中，old_cluster 和 new_cluster 是相对于主库当前目录的路径，remote_dir则是备库上位于新旧集簇目录上层的目录。主库和备库在指定目录下的目录结构必须一致。请参阅 rsync 手册页，了解如何指定远程目录，例如：

   rsync --archive --delete --hard-links --size-only --no-inc-recursive /opt/PostgreSQL/9.5 \
         /opt/PostgreSQL/9.6 standby.example.com:/opt/PostgreSQL
   

   你可以使用 rsync 的 --dry-run 选项来验证命令将执行什么操作。尽管至少要在主库上为一个备库运行 rsync，但也可以运行 rsync 来升级其他备库，运行位置是某个已升级且尚未启动的备库。

   其原理是记录主库上新旧集簇文件之间由 pg_upgrade 链接模式创建的硬链接，然后在备库的旧集簇中找到匹配文件，并在其新集簇中为这些文件 创建链接。主库上未被链接的文件会从主库复制到备库（通常都很小）。这使得 备库能够快速升级。不幸的是，rsync 会无谓地复制与 临时表和不记录 WAL 的表相关的文件，因为这些文件通常不存在于备库上。

   如果你有表空间，则需要对每个表空间目录运行类似的 rsync 命令，例如：

   rsync --archive --delete --hard-links --size-only --no-inc-recursive /vol1/pg_tblsp/PG_9.5_201510051 \
         /vol1/pg_tblsp/PG_9.6_201608131 standby.example.com:/vol1/pg_tblsp
   

   如果你把 pg_wal 迁移到了数据目录之外，也必须对这些目录运行 rsync。

7. 配置流复制和日志传送备库

   为服务器配置日志传送。（由于备库仍与主库保持同步，因此无需运行pg_start_backup()和pg_stop_backup()，也无需进行文件系统备份。）复制槽不会被复制，必须重建。

恢复 pg_hba.conf

如果你修改了 pg_hba.conf，请恢复其原始设置。 也可能需要调整新集簇中的其他配置文件以匹配旧集簇，例如 postgresql.conf（以及其包含的所有文件）和 postgresql.auto.conf。

启动新服务器

现在可以安全地启动新服务器，然后启动所有经 rsync 同步的备库。

升级后处理

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

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

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

统计信息

由于优化器统计信息不会由pg_upgrade传输，升级结束时你会被要求运行命令来重新生成这些信息。你可能需要设置连接参数以匹配新集簇。

删除旧集簇

一旦你确认升级结果令人满意，就可以运行 pg_upgrade 完成时提到的脚本， 删除旧集簇的数据目录。（如果旧数据目录中包含用户定义的表空间，则无法自动删除。） 你也可以删除旧的安装目录（例如 bin、share）。

恢复到旧集簇

如果在运行 pg_upgrade 之后，你想恢复到旧集簇，可以选择以下几种方法：