mxmoveseg

本文档介绍了镜像节点实例（Mirror）迁移工具 mxmoveseg。

注意！
mxmoveseg 只用于迁移 gp_segment_configuration 表中 role（当前角色）为 m（mirror）的节点实例，与 preferred_role（原始角色）列无关。

1 描述

功能
- mxmoveseg 工具支持迁移任意一个当前为 Mirror 的数据库实例到其他服务器。
场景
- 当前服务器集群可以正常运行，但负载不均衡影响性能和稳定度，需要通过在不同机器间迁移 Mirror 来调整。
- 当前服务器已离线，需要将 Mirror 迁移到健康的新服务器上，以保障集群的运行。
限制
- mxmoveseg 工具不支持迁移 Standby。

注意！
在使用此工具前，你需要自行判断当前所有服务器是否健康，如存在异常服务器，还需了解异常的服务器具体为哪些，以确保健康的服务器全部可以被 mxmoveseg 收集到信息。

2 命令行参数信息

以下是详细的命令行参数信息介绍：

参数名	描述
--config	为将要迁移的 Mirror 创建一个配置文件
--plan	为将要迁移的 Mirror 创建迁移计划
--setup	执行计划步骤以实行迁移
-h / --help	打印帮助信息

3 示例

3.1 迁移已有 Segment 至新服务器

注意！
新服务器需按照 YMatrix 相关部署文档安装好同版本 YMatrix 的 RPM/DEB 包，但不可实施在图形化界面初始化新集群的步骤。

注意！
新服务器可以存在大版本和旧服务器不同的 YMatrix 集群（例如旧机器上存在 YMatrix 4.8 的集群，新机器上存在 YMatrix 5.1 的集群）。

收集当前已有数据库集群的信息。clusterid 可使用 more /etc/matrixdb5/cluster.conf 查看。

[<用户名称>@<Master 主机名> ~]$ sudo /opt/ymatrix/matrixdb5/bin/mxctl expand init --cluster-id <clusterid> --unrestrict > /tmp/init

添加新服务器。

[<用户名称>@<Master 主机名> ~]$ cat /tmp/init | sudo /opt/ymatrix/matrixdb5/bin/mxctl expand add --unrestrict --host <newhost> > /tmp/initadd

检查收集到信息的服务器之间网络是否连通。

[<用户名称>@<Master 主机名> ~]$ cat /tmp/initadd | sudo /opt/ymatrix/matrixdb5/bin/mxctl expand netcheck > /tmp/netcheck

切换到 mxadmin 用户。

[<用户名称>@<Master 主机名> ~]$ sudo su - mxadmin

创建迁移配置文件，并根据生成的文件内部提示的信息配置需要迁移的实例。

$ mxmoveseg config --db-cluster-id <clusterid> --filename /tmp/migrate.cfg

# 配置文件创建完成后，请根据文件内容里的提示信息，人工编辑需要迁移的节点实例的 dbid（连接数据库后，执行 SELECT * FROM gp_segment_configuration; 查看 dbid）、主机名称等。SPEC：如果新服务器与旧服务器存在端口冲突，则需在文件中指配新的端口
$ vim /tmp/migrate.cfg

生成迁移计划。

$ mxmoveseg plan --init-file /tmp/netcheck --config-file /tmp/migrate.cfg > /tmp/plan

执行迁移。

$ mxmoveseg setup --plan-file /tmp/plan --mode cli

迁移成功后，可以使用图形化界面：“集群管理” - “集群概况” - “实例视图” 或使用 SELECT * FROM gp_segment_configuration SQL 语句查看迁移 Mirror 的状态。

警告！
如果源迁移服务器为离线状态，那么离线的旧服务器即使在迁移完成后，也不可重新开启。如果开启，则旧的管理进程会被自动拉起，和新的管理进程存在服务发现的冲突，导致集群异常。

3.2 迁移已有 Segment 至旧服务器