pg_upgrade

PostgreSQL 9.6.0 文档
Prev	Up		Next

使用

下面是用pg_upgrade执行一次升级的步骤：

移动旧集簇（可选）
如果你在使用一个与版本相关的安装目录（例如 /opt/PostgreSQL/9.1），你就不需要移动旧的集簇。图形化的安装程序会使用版本相关的安装目录。
如果你的安装目录不是版本相关的（例如/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标志。许多预编译的安装程序会自动做这个步骤。这里没有必要启动新集簇。
安装自定义的共享对象文件
把旧集簇使用的所有自定义共享对象文件（或者 DLL）安装到新集簇中，例如pgcrypto.so，不管它们是来自于 contrib还是某些其他源码。不要安装模式定义（例如pgcrypto.sql），因为这些将会从旧集簇升级得到。还有，任何自定义的全文搜索文件（词典、同义词、辞典、停用词）也必须被复制到新集簇中。
调整认证
pg_upgrade将会多次连接到旧服务器和新服务器，因此你可能想要在pg_hba.conf中把认证设置成 peer或者使用一个~/.pgpass文件（见 Section 32.15）。
停止两个服务器
确认两个数据库服务器都被停止使用，例如在 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
```
直到后面的步骤之前，流复制和日志传送后备服务器可以保持运行。
验证后备服务器
如果正在升级流复制以及日志传送后备服务器，通过对旧的主集簇和后备集簇运行pg_controldata来验证旧的后备服务器被赶上。验证 "Latest checkpoint location"值在所有的集簇中都匹配（如果旧的后备服务器在旧的主服务器之前被关闭就会出现失配）。
运行 pg_upgrade
总是应该运行新服务器而不是旧服务器的pg_upgrade二进制文件。 pg_upgrade要求制定新旧集簇的数据和可执行文件（ bin）目录。你也可以指定用户和端口值，以及你是否想要用链接来取代复制对数据进行处理（默认值是使用）。
如果你使用链接模式，升级将会快很多（不需要文件拷贝）并且将使用更少的磁盘空间，但是在升级后一旦启动新集簇，旧集簇就无法被访问。链接模式也要求新旧集簇数据目录位于同一个文件系统中（表空间和 pg_xlog可以在不同的文件系统中）。完整的选项列表可见pg_upgrade --help。
--jobs选项允许多个 CPU 核心被用来复制/链接文件以及并行地转储和重载数据库模式。这个选项一个比较好的值是 CPU 核心数和表空间数的最大值。这个选项可以显著地减少升级运行在一台多处理器机器上的多数据库服务器的时间。
对于 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也将列出任何在更新后需要做的手工调整。如果你将要使用链接模式，你应该使用--link选项和 --check一起来启用链接模式相关的检查。 pg_upgrade要求在当前目录中的写权限。
显然，没有人可以在升级期间访问这些集簇。pg_upgrade 默认会在端口 50432 上运行服务器来避免意外的客户端连接。在做升级时，可以对两个集簇使用相同的端口号，因为新旧集簇不会在同时被运行。不过，在检查一个旧的运行中服务器时，新旧端口号必须不同。
如果在恢复数据库模式时发生错误，pg_upgrade将会退出并且你必须按照下文step 16中所说的恢复旧集簇。要再次尝试pg_upgrade，你将需要修改旧集簇，这样 pg_upgrade 模式会成功恢复。如果问题是一个 contrib模块，你可能需要从旧集簇中卸载该模块并且在升级后重新把它安装在新集簇中，不过这样做的前提是该模块没有被用来存储用户数据。
升级流复制和日志传送后备服务器
如果有流复制（见Section 26.2.5）或者日志传送（见Section 26.2）后备服务器，遵照下面的步骤对它们进行升级。你将不用在这些后备服务器上运行 pg_upgrade，而是运行rsync。到这里还不要启动任何服务器。
1. 在后备服务器上安装新的 PostgreSQL 二进制文件
  确保新的二进制和支持文件被安装在所有后备服务器上。
2. 确保不存在新的后备机数据目录
  确保新的后备机数据目录不存在或者为空。如果运行过initdb，请删除后备服务器的数据目录。
3. 安装自定义共享对象文件
  在新的后备机上安装和新的主集簇中相同的自定义共享对象文件。
4. 停止后备服务器
  如果后备服务器仍在运行，现在使用上述的指令停止它们。
5. 保存配置文件
  从后备机保存任何需要保留的配置文件，例如 postgresql.conf、recovery.conf，因为这些文件在下一步中会被重写或者移除。
6. 启动并且停止新的主集簇
  在新的主集簇中，把postgresql.conf文件中的 wal_level改为replica，然后启动并且停止该集簇。
7. 运行rsync
  从一个高于新旧数据库集簇目录的目录，为每一个从设备运行下面的命令：
```
rsync --archive --delete --hard-links --size-only old_pgdata new_pgdata remote_dir
```
  其中old_pgdata和new_pgdata都相对于当前目录，并且remote_dir是后备服务器上一个高于新旧集簇目录的目录。在主服务器和后备服务器上，新旧集簇的相对路径必须匹配。关于指定远程目录的细节请参考 rsync的手册页，例如 standbyhost:/opt/PostgreSQL/。当使用了pg_upgrade的--link模式时 rsync会很快，因为它将在远程服务器上创建硬链接而不是传输用户数据。不幸的是，rsync会毫无必要地复制与临时表以及不做日志表相关的文件。
  如果有表空间，你将需要为每一个表空间目录运行一个类似的 rsync命令。如果已经把pg_xlog 放在了数据目录之外，也必须在这些目录上运行rsync。
8. 配置流复制和日志传送后备服务器
  为日志传送配置服务器（不需要运行pg_start_backup() 以及pg_stop_backup()或者做文件系统备份，因为从属机仍在与主机同步）。
恢复 pg_hba.conf
如果你修改了pg_hba.conf，则要将其恢复到原始的设置。也可能需要调整新集簇中的其他配置文件（例如 postgresql.conf）来匹配旧集簇。
启动新服务器
现在可以安全地启动新的服务器，并且可以接着启动任何 rsync过的后备服务器。

升级后处理

如果需要做任何升级后处理，pg_upgrade 将在完成后发出警告。它也将生成必须由管理员运行的脚本文件。这些脚本文件将连接到每一个需要做升级后处理的数据库。每一个脚本应该这样运行：

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

这些脚本可以以任何顺序运行并且在运行之后立即删除。

Caution

通常在重建脚本运行完成之前访问重建脚本中引用的表是不安全的，这样做可能会得到不正确的结果或者很差的性能。没有在重建脚本中引用的表可以随时被访问。

统计信息
由于pg_upgrade并未传输优化器统计信息，在升级的尾声你将被指示运行一个命令来生成这些信息。你可能需要设置连接参数来匹配你的新集簇。
删除旧集簇
一旦你对升级表示满意，你就可以通过运行 pg_upgrade完成时提到的脚本来删除旧集簇的数据目录（如果在旧数据目录中有用户定义的表空间就不可能实现自动删除）。你也可以删除旧安装目录（例如bin、share）。
恢复到旧集簇
在运行pg_upgrade之后，如果你希望恢复到旧集簇，有几个选项：
- 如果你运行了带有--check的 pg_upgrade，则没有对旧集簇做修改并且可以在任何时候重新使用它。
- 如果你运行了带有--link的 pg_upgrade，数据文件在新旧集簇之间共享。如果你开启了新集簇，并且新服务器已经对这些共享文件做了写入，那么使用旧集簇就不安全。
- 如果你运行了不带 --link的 pg_upgrade或者没有启动新服务器，旧集簇还没有被修改，如果已经执行了链接，会在 $PGDATA/global/pg_control后追加一个 .old后缀。要重用旧集簇，可以从 $PGDATA/global/pg_control移除 .old后缀，然后你就能重启旧集簇了。

pg_upgrade

Name

Synopsis

描述

选项

使用

注解

另见

Prev	Home	Next
pg_test_timing	Up	pg_xlogdump