第 5 章 Migration（迁移）

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

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

   停止 rh-mariadb101 服务器。

   service rh-mariadb101-mariadb stop

2. 安装 rh-mariadb102 Software Collection。

   yum install rh-mariadb102-mariadb-server

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

   service rh-mariadb102-mariadb start

6. 执行数据迁移。

   scl enable rh-mariadb102 mysql_upgrade

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

   scl enable rh-mariadb102 -- mysql_upgrade -p

1. 要进行升级，rh-mongodb34 实例必须将 featureCompatibilityVersion 设置为 3.4。检查 featureCompatibilityVersion:

   ~]$ scl enable rh-mongodb34 'mongo --host localhost --port 27017 admin' --eval 'db.adminCommand({getParameter: 1, featureCompatibilityVersion: 1})'

   如果 mongod 服务器配置有启用的访问控制，请在 mongo 命令中添加 --username 和 --password 选项。
2. 从 rh-mongodb36 Software Collections 安装 MongoDB 服务器和 shell：

   ~]# yum install rh-mongodb36

3. 停止 MongoDB 3.4 服务器：

   ~]# systemctl stop rh-mongodb34-mongod.service

4. 将数据复制到新位置：

   ~]# cp -a /var/opt/rh/rh-mongodb34/lib/mongodb/* /var/opt/rh/rh-mongodb36/lib/mongodb/

5. 在 /etc/opt/rh/rh-mongodb36/mongod.conf 文件中配置 rh-mongodb36-mongod 守护进程。
6. 启动 MongoDB 3.6 服务器：

   ~]# systemctl start rh-mongodb36-mongod.service

7. 启用向后不兼容的功能：

   ~]$ scl enable rh-mongodb36 'mongo --host localhost --port 27017 admin' --eval 'db.adminCommand( { setFeatureCompatibilityVersion: "3.6" } )'

   如果 mongod 服务器配置有启用的访问控制，请在 mongo 命令中添加 --username 和 --password 选项。
   注意
   升级后，建议先运行部署，而不为刻录期间启用向后兼容的功能，从而最大程度降低降级的可能性。

1. 从 rh-mongodb34 Software Collections 安装 MongoDB 服务器和 shell：

   ~]# yum install rh-mongodb34

2. 停止 MongoDB 3.2 服务器：

   ~]# systemctl stop rh-mongodb32-mongod.service

   在 Red Hat Enterprise Linux 6 系统上使用 服务 rh-mongodb32-mongodb stop 命令。
3. 将数据复制到新位置：

   ~]# cp -a /var/opt/rh/rh-mongodb32/lib/mongodb/* /var/opt/rh/rh-mongodb34/lib/mongodb/

4. 在 /etc/opt/rh/rh-mongodb34/mongod.conf 文件中配置 rh-mongodb34-mongod 守护进程。
5. 启动 MongoDB 3.4 服务器：

   ~]# systemctl start rh-mongodb34-mongod.service

   在 Red Hat Enterprise Linux 6 上，改为使用服务 rh-mongodb34-mongodb start 命令。
6. 启用向后兼容的功能：

   ~]$ scl enable rh-mongodb34 'mongo --host localhost --port 27017 admin' --eval 'db.adminCommand( { setFeatureCompatibilityVersion: "3.4" } )'

   如果 mongod 服务器配置有启用的访问控制，请将 --username 和 --password 选项添加到 mongo 命令。
   请注意，建议您在升级后运行部署，而无需首先启用这些功能。

1. 安装 rh-mysql57 Software Collection。

   yum install rh-mysql57-mysql-server

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

   service rh-mysql56-mysqld stop

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

   service rh-mysql57-mysqld start

6. 执行数据迁移。

   scl enable rh-mysql57 mysql_upgrade

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

   scl enable rh-mysql57 -- mysql_upgrade -p

过程 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-postgresql10/lib/pgsql/data/ 不存在：

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

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

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

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

   scl enable rh-postgresql10 -- postgresql-setup --upgrade

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

   systemctl start rh-postgresql10-postgresql.service

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

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

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

   chkconfig postgresql off

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

   chkconfig rh-postgresql10-postgresql on

7. 如果您的配置与默认文件不同，请确保更新配置文件，特别是 /var/opt/rh/rh-postgresql10/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-postgresql10-postgresql -- postgresql-setup --initdb

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

   systemctl start rh-postgresql10-postgresql.service

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

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

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

   chkconfig postgresql off

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

   chkconfig rh-postgresql10-postgresql on

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

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

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

   systemctl stop rh-postgresql96-postgresql.service

   要验证服务器是否没有运行，请输入：

   systemctl status rh-postgresql96-postgresql.service

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

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

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

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

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

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

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

   scl enable rh-postgresql10 -- postgresql-setup --upgrade --upgrade-from=rh-postgresql96-postgresql

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

   systemctl start rh-postgresql10-postgresql.service

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

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

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

   chkconfig rh-postgresql96-postgreqsql off

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

   chkconfig rh-postgresql10-postgresql on

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

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

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

   systemctl start rh-postgresql96-postgresql.service

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

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

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

   systemctl stop rh-postgresql96-postgresql.service

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

   scl enable rh-postgresql10-postgresql -- postgresql-setup --initdb

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

   systemctl start rh-postgresql10-postgresql.service

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

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

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

   chkconfig rh-postgresql96-postgresql off

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

   chkconfig rh-postgresql10-postgresql on

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

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

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

   service postgresql stop

   要验证服务器是否没有运行，请输入：

   service postgresql status

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

   file /var/lib/pgsql/data/

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

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

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

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

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

   scl enable rh-postgresql96 -- postgresql-setup --upgrade

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

   service rh-postgresql96-postgresql start

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

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

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

   chkconfig postgresql off

   要启用 PostgreSQL 9.6 服务器，以 root 用户身份输入：

   chkconfig rh-postgresql96-postgresql on

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

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

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

   service postgresql start

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

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

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

   service postgresql stop

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

   scl enable rh-postgresql96-postgresql -- postgresql-setup --initdb

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

   service rh-postgresql96-postgresql start

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

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

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

   chkconfig postgresql off

   要启用 PostgreSQL 9.6 服务器，以 root 用户身份输入：

   chkconfig rh-postgresql96-postgresql on

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

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

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

   service rh-postgresql95-postgresql stop

   要验证服务器是否没有运行，请输入：

   service rh-postgresql95-postgresql status

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

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

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

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

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

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

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

   scl enable rh-postgresql96 -- postgresql-setup --upgrade --upgrade-from=rh-postgresql95-postgresql

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

   service rh-postgresql96-postgresql start

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

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

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

   chkconfig rh-postgresql95-postgreqsql off

   要启用 PostgreSQL 9.6 服务器，以 root 用户身份输入：

   chkconfig rh-postgresql96-postgresql on

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

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

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

   service rh-postgresql95-postgresql start

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

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

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

   service rh-postgresql95-postgresql stop

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

   scl enable rh-postgresql96-postgresql -- postgresql-setup --initdb

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

   service rh-postgresql96-postgresql start

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

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

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

   chkconfig rh-postgresql95-postgresql off

   要启用 PostgreSQL 9.6 服务器，以 root 用户身份输入：

   chkconfig rh-postgresql96-postgresql on

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