第 5 章 Migration（迁移）

1. 如果 rh-mariadb103 数据库服务器仍在运行，将它停止。
   在停止服务器前，将 innodb_fast_shutdown 选项设置为 0， 以便 InnoDB 执行缓慢关闭，包括完整清除和插入缓冲区合并。在 上游文档 中了解更多有关此选项的信息。这个操作的时间可能比正常关闭的时间要长。

   mysql -uroot -p -e "SET GLOBAL innodb_fast_shutdown = 0"

   停止 rh-mariadb103 服务器：

   systemctl stop rh-mariadb103-mariadb.service

2. 安装 rh-mariadb105 Software Collection，包括提供 mysql_upgrade 工具的子软件包：

   yum install rh-mariadb105-mariadb-server rh-mariadb105-mariadb-server-utils

   请注意，可以在仍然安装 rh-mariadb103 Software Collection 时安装 rh-mariadb105 Software Collection，因为这些集合不会冲突。
3. 检查 rh-mariadb105 的配置，它存储在 /etc/opt/rh/rh-mariadb105/my.cnf 文件中，以及 /etc/opt/rh/rh-mariadb105/my.cnf.d/ 目录中。将其与存储在 /etc/opt/rh/ rh-mariadb103 /my.cnf 和 / etc/opt/rh/rh-mariadb103/my.cnf.d/ 中的 rh-mariadb103 配置进行比较，并根据需要进行调整。
4. rh-mariadb103 Software Collection 的所有数据存储在 /var/opt/rh/rh-mariadb103/lib/mysql/ 目录中，除非进行了不同。将该目录的整个内容复制到 /var/opt/rh/rh-mariadb105/lib/mysql/。您可以移动内容，但要记住在继续升级前备份数据。确保数据归 mysql 用户和 SELinux 上下文所有。
5. 启动 rh-mariadb105 数据库服务器：

   systemctl start rh-mariadb105-mariadb.service

6. 执行数据迁移。请注意，由于在 MDEV-14637 中引入上游更改，需要运行 mysql_upgrade 命令。

   scl enable rh-mariadb105 mysql_upgrade

   如果 root 用户定义了非空密码（应该定义了密码），则需要使用 -p 选项调用 mysql_upgrade 工具并指定密码：

   scl enable rh-mariadb105 -- mysql_upgrade -p

   请注意，当安装 rh-mariadb105*-syspaths 软件包时，不需要 scl enable 命令。但是，*-syspaths 软件包与基础 Red Hat Enterprise Linux 系统以及 rh-mariadb103 和 rh-mysql80 Software Collections 的对应软件包冲突。

1. 安装 rh-mysql80 Software Collection。

   yum install rh-mysql80-mysql-server

2. 检查 rh-mysql80 的配置，它存储在 /etc/opt/rh/rh-mysql80/my.cnf 文件中，以及 /etc/opt/rh/rh-mysql80/my.cnf.d/ 目录中。将它与存储在 /etc/opt/rh/ rh-mysql57 /my.cnf 和 /etc/opt/rh/rh-mysql57 /my.cnf.d/ 中的 rh-mysql57/my.cnf.d/ 的配置进行比较，并在需要时进行调整。
3. 如果 rh-mysql57 数据库服务器仍在运行，请停止它。

   systemctl stop rh-mysql57-mysqld.service

4. rh-mysql57 Software Collection 的所有数据存储在 /var/opt/rh/rh-mysql57/lib/mysql/ 目录中。将该目录的整个内容复制到 /var/opt/rh/rh-mysql80/lib/mysql/。您还可以移动内容，但记得在继续升级前备份数据。
5. 启动 rh-mysql80 数据库服务器。

   systemctl start rh-mysql80-mysqld.service

6. 执行数据迁移。

   scl enable rh-mysql80 mysql_upgrade

   如果 root 用户定义了非空密码（应该定义了密码），则需要使用 -p 选项调用 mysql_upgrade 工具并指定密码。

   scl enable rh-mysql80 -- mysql_upgrade -p

   请注意，当安装 rh-mysql80*-syspaths 软件包时，不需要 scl enable 命令。但是，*-syspaths 软件包与基础 Red Hat Enterprise Linux 系统以及 rh-mariadb103 和 rh-mariadb105 Software Collections 的对应软件包冲突。

过程 5.1. 使用 pg_upgrade 工具快速升级

1. 停止旧的 PostgreSQL 服务器，以确保数据不处于不一致的状态。要做到这一点，以 root 用户身份在 shell 提示符后输入以下内容：

   systemctl stop postgresql.service

   要验证服务器是否正在运行，请键入：

   systemctl status postgresql.service

2. 验证旧目录 /var/lib/pgsql/data/ 是否存在：

   file /var/lib/pgsql/data/

   并备份您的数据。
3. 验证新数据目录 /var/opt/rh/rh-postgresql13/lib/pgsql/data/ 不存在：

   file /var/opt/rh/rh-postgresql13/lib/pgsql/data/

   如果您正在运行一个全新的 PostgreSQL 13 安装，则系统中不存在此目录。如果是，请以 root 用户身份运行以下命令备份它：

   mv /var/opt/rh/rh-postgresql13/lib/pgsql/data{,-scl-backup}

4. 以 root 用户身份运行以下命令来升级新服务器的数据库数据：

   scl enable rh-postgresql13 -- postgresql-setup --upgrade

   或者，您可以使用 /opt/rh/rh-postgresql13/root/usr/bin/postgresql-setup --upgrade 命令。
   请注意，您可以使用 --upgrade-from 选项来从不同版本的 PostgreSQL 升级。可以使用 --upgrade-ids 选项获得可能的升级场景列表。
   建议您读取生成的 /var/lib/pgsql/upgrade_rh-postgresql13-postgresql.log 日志文件，以了解升级过程中是否存在任何问题。
5. 以 root 用户身份启动新服务器：

   systemctl start rh-postgresql13-postgresql.service

   另外，建议您运行 analyze_new_cluster.sh 脚本，如下所示：

   su - postgres -c 'scl enable rh-postgresql13 ~/analyze_new_cluster.sh'

6. 另外，您可以将 PostgreSQL 13 服务器配置为在引导时自动启动。要禁用旧的系统 PostgreSQL 服务器，以 root 用户身份运行以下命令：

   chkconfig postgresql off

   要启用 PostgreSQL 13 服务器，以 root 用户身份键入：

   chkconfig rh-postgresql13-postgresql on

7. 如果您的配置与默认文件不同，请确保更新配置文件，特别是 /var/opt/rh/rh-postgresql13/lib/pgsql/data/pg_hba.conf 配置文件。否则，只有 postgres 用户才能访问数据库。

过程 5.2. 执行转储和恢复升级

1. 以 root 用户身份在 shell 提示符后输入以下内容来确保旧的 PostgreSQL 服务器正在运行：

   systemctl start postgresql.service

2. 将 PostgreSQL 数据库中的所有数据转储到脚本文件中。以 root 用户身份，输入：

   su - postgres -c 'pg_dumpall > ~/pgdump_file.sql'

3. 以 root 用户身份运行以下命令来停止旧服务器：

   systemctl stop postgresql.service

4. 以 root 用户身份初始化新服务器的数据目录：

   scl enable rh-postgresql13 -- postgresql-setup initdb

5. 以 root 用户身份启动新服务器：

   systemctl start rh-postgresql13-postgresql.service

6. 从之前创建的 SQL 文件中导入数据：

   su - postgres -c 'scl enable rh-postgresql13 "psql -f ~/pgdump_file.sql postgres"'

7. 另外，您可以将 PostgreSQL 13 服务器配置为在引导时自动启动。要禁用旧的系统 PostgreSQL 服务器，以 root 用户身份运行以下命令：

   chkconfig postgresql off

   要启用 PostgreSQL 13 服务器，以 root 用户身份键入：

   chkconfig rh-postgresql13-postgresql on

8. 如果您的配置与默认文件不同，请确保更新配置文件，特别是 /var/opt/rh/rh-postgresql13/lib/pgsql/data/pg_hba.conf 配置文件。否则，只有 postgres 用户才能访问数据库。

过程 5.3. 使用 pg_upgrade 工具快速升级

1. 停止旧的 PostgreSQL 服务器，以确保数据不处于不一致的状态。要做到这一点，以 root 用户身份在 shell 提示符后输入以下内容：

   systemctl stop rh-postgresql12-postgresql.service

   要验证服务器是否正在运行，请键入：

   systemctl status rh-postgresql12-postgresql.service

2. 验证旧目录 /var/opt/rh/rh-postgresql12/lib/pgsql/data/ 是否存在：

   file /var/opt/rh/rh-postgresql12/lib/pgsql/data/

   并备份您的数据。
3. 验证新数据目录 /var/opt/rh/rh-postgresql13/lib/pgsql/data/ 不存在：

   file /var/opt/rh/rh-postgresql13/lib/pgsql/data/

   如果您正在运行一个全新的 PostgreSQL 13 安装，则系统中不存在此目录。如果是，请以 root 用户身份运行以下命令备份它：

   mv /var/opt/rh/rh-postgresql13/lib/pgsql/data{,-scl-backup}

4. 以 root 用户身份运行以下命令来升级新服务器的数据库数据：

   scl enable rh-postgresql13 -- postgresql-setup --upgrade --upgrade-from=rh-postgresql12-postgresql

   另外，您可以使用 /opt/rh/rh-postgresql13/root/usr/bin/postgresql-setup --upgrade --upgrade-from=rh-postgresql12-postgresql 命令。
   请注意，您可以使用 --upgrade-from 选项来从不同版本的 PostgreSQL 升级。可以使用 --upgrade-ids 选项获得可能的升级场景列表。
   建议您读取生成的 /var/lib/pgsql/upgrade_rh-postgresql13-postgresql.log 日志文件，以了解升级过程中是否存在任何问题。
5. 以 root 用户身份启动新服务器：

   systemctl start rh-postgresql13-postgresql.service

   另外，建议您运行 analyze_new_cluster.sh 脚本，如下所示：

   su - postgres -c 'scl enable rh-postgresql13 ~/analyze_new_cluster.sh'

6. 另外，您可以将 PostgreSQL 13 服务器配置为在引导时自动启动。要禁用旧的 PostgreSQL 12 服务器，请以 root 用户身份输入以下命令：

   chkconfig rh-postgresql12-postgreqsql off

   要启用 PostgreSQL 13 服务器，以 root 用户身份键入：

   chkconfig rh-postgresql13-postgresql on

7. 如果您的配置与默认文件不同，请确保更新配置文件，特别是 /var/opt/rh/rh-postgresql13/lib/pgsql/data/pg_hba.conf 配置文件。否则，只有 postgres 用户才能访问数据库。

过程 5.4. 执行转储和恢复升级

1. 以 root 用户身份在 shell 提示符后输入以下内容来确保旧的 PostgreSQL 服务器正在运行：

   systemctl start rh-postgresql12-postgresql.service

2. 将 PostgreSQL 数据库中的所有数据转储到脚本文件中。以 root 用户身份，输入：

   su - postgres -c 'scl enable rh-postgresql12 "pg_dumpall > ~/pgdump_file.sql"'

3. 以 root 用户身份运行以下命令来停止旧服务器：

   systemctl stop rh-postgresql12-postgresql.service

4. 以 root 用户身份初始化新服务器的数据目录：

   scl enable rh-postgresql13 -- postgresql-setup initdb

5. 以 root 用户身份启动新服务器：

   systemctl start rh-postgresql13-postgresql.service

6. 从之前创建的 SQL 文件中导入数据：

   su - postgres -c 'scl enable rh-postgresql13 "psql -f ~/pgdump_file.sql postgres"'

7. 另外，您可以将 PostgreSQL 13 服务器配置为在引导时自动启动。要禁用旧的 PostgreSQL 12 服务器，请以 root 用户身份输入以下命令：

   chkconfig rh-postgresql12-postgresql off

   要启用 PostgreSQL 13 服务器，以 root 用户身份键入：

   chkconfig rh-postgresql13-postgresql on

8. 如果您的配置与默认文件不同，请确保更新配置文件，特别是 /var/opt/rh/rh-postgresql13/lib/pgsql/data/pg_hba.conf 配置文件。否则，只有 postgres 用户才能访问数据库。