集群卸载与重装

本文档描述了集群卸载与重装 YMatrix 5 的步骤。以三个节点为例,主节点为 mdw,两个数据节点分别为 sdw1 和 sdw2。

进行操作前,请务必仔细阅读此条提示:

  • 当你认为你已经不需要 YMatrix 软件以及已有集群中的所有数据,想要 彻底删除原有集群及 YMatrix 软件,你需要启用 “1 YMatrix 卸载”;
  • 如果你只是想要 重装 YMatrix 软件,但不想失去任何原有数据,你需要启用 “2 YMatrix 重装”;

注意!
1、2 序号中的部分相互独立,根据上述提示选择其一即可,勿全部执行!

1 YMatrix 卸载

1.1 停止集群

首先,你需要做好卸载或重装前的准备,这一步是必要的,否则会阻碍卸载操作。通过元命令 \q 退出 psql 打开的终端。

postgres=# \q

示例中使用 fast 模式停止集群进程,如果你需要的话,也可以选择 smart 或 immediate 模式停止集群,下方表格说明了它们的区别。

[mxadmin@mdw ~]$ mxstop -a -M fast
mxstop 模式 参数 禁用新连接 等待进程运行完毕 是否是默认模式
smart -M smart
fast -M fast 否,中断连接,事务回滚
immediate -M immediate 否,直接杀掉进程

1.2 YMatrix 软件卸载

注意!
本文中出现的命令以 CentOS 7 操作系统为准举例。如果你使用的是 CentOS 8 操作系统,需要将此步骤中的 yum 命令替换为 dnf。
DNF(Dandified YUM)是 YUM(Yellow-dog Updater,Modified)工具的继承,是 CentOS 8 操作系统的默认软件包管理器。

这一步骤会彻底卸载 YMatrix 软件。在普通用户下,在所有节点上使用 root 权限运行。

[<用户名称>@mdw ~]$ sudo yum remove -y matrixdb-5.0.0.beta.2+community.x86_64

#or

[<用户名称>@mdw ~]$ sudo yum erase -y matrixdb-5.0.0.beta.2+community.x86_64

1.3 清理配置文件

这一步骤会手动清理掉集群环境变量配置文件及已部署集群的信息文件。删除操作只需在主节点上进行。

1.3.1 删除 .matrixdb.env 文件

.matrixdb.env 是 YMatrix 的环境变量配置文件。其中包含环境变量 PGPORT、MASTER_DATA_DIRECTORY、PGDATABASE。PGPORT 为客户端应用指定了数据库服务器的端口、MASTER_DATA_DIRECTORY 指集群初始化时创建的主节点的数据目录、PGDATABASE 指定了数据库名称,默认与用户名一致。

[mxadmin@mdw ~]$ rm ~/.matrixdb.env

1.3.2 删除 /etc/matrixdb/service 下的多个文件

在普通用户下使用 root 权限删除 YMatrix 新架构中的 deployer.conf、etcd.conf、cluster<>.conf、replication<>.conf、shard<>.conf 文件。
deployer.conf 主要包含集群部署、扩容等任务的配置,etcd.conf 是 etcd 服务的配置文件,cluster
<>.conf、replication<>.conf、shard<>.conf 分别包含集群服务、数据分片服务、数据副本服务的配置参数。代码示例如下。
进入 /etc/matrixdb/service 目录,并查看目录下文件。

[<用户名称>@mdw ~]$ cd /etc/matrixdb/service
                   ls

删除相关配置文件。

注意!
一下代码仅为示例,请替换为你自身 service 目录下的文件名。

[<用户名称>@mdw ~]$ sudo rm deployer.conf 
                   sudo rm etcd.conf
                   sudo rm cluster_aF4pYy86QW6YUZeJXxGgn6.conf 
                   sudo rm replication-1_aF4pYy86QW6YUZeJXxGgn6.conf replication-2_aF4pYy86QW6YUZeJXxGgn6.conf replication-3_aF4pYy86QW6YUZeJXxGgn6.conf 
                   sudo rm shard_aF4pYy86QW6YUZeJXxGgn6.conf 

关于 YMatrix 新架构的描述详见 YMatrix 架构

2 YMatrix 重装

使用此部分的你可以放心,在 YMatrix 5 大版本内卸载重装高版本或同版本,是不会丢失集群数据的。例如, YMatrix 5.5 升级到 YMatrix 5.6;卸载 YMatrix 5.5 又重装 YMatrix 5.5。

2.1 停止集群

你需要执行上文 “1.1 停止集群”,做好卸载或重装前的准备,这一步是必要的,否则会阻碍卸载操作。

2.2 YMatrix 卸载

你需要执行上文 “1.2 YMatrixB 卸载”。 这一步骤会彻底卸载掉原有版本的 YMatrix 软件。

2.3 YMatrix 重装

注意!
如果你使用的是 CentOS 8 操作系统,需要将此步骤中的 yum 替换为 dnf。

重新安装你所需版本的 rpm 包。此操作在普通用户下进行。

[<用户名称>@mdw ~]$ sudo yum install -y matrixdb-5.0.0.beta.2+community-1.el7.x86_64.rpm

2.4 重新启动服务

[<用户名称>@mdw ~]$ sudo systemctl restart matrixdb.supervisor.service

2.5 启动集群

首先,使用 root 权限连接到 mxadmin 用户。

[<用户名称>@mdw ~]$ sudo su - mxadmin

然后,使用 mxstart 工具启动集群。

[mxadmin@mdw ~]$ mxstart -a