集群卸载与重装

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

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

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

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

1 YMatrix 卸载

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

postgres=# \q

在 Master 上使用 mxdeletesystem 命令删除数据库实例和数据。

$ mxdeletesystem -a

注意！
本文中出现的命令以 CentOS 7 操作系统为准举例。如果你使用的是 CentOS 8 操作系统，需要将此步骤中的 yum 命令替换为 dnf；如果你使用的是 Ubuntu 系统，需要将此步骤的 yum 命令替换为 apt。

首先，你需要通过以下命令查询集群安装后的程序名：

[<用户名称>@mdw ~]$ yum list installed | grep matrixdb
matrixdb5.x86_64                   5.0.0+enterprise~beta.5-1.el7 installed

注意！
Ubuntu20.04 需执行 sudo apt list --installed | grep matrixdb 查询集群安装后的程序名。

然后卸载此程序。这一步骤会彻底卸载 YMatrix 软件，需要在普通用户下，在所有节点上，使用 sudo 权限或 root 用户运行。

[<用户名称>@mdw ~]$ sudo yum remove -y matrixdb5.x86_64

#or

[<用户名称>@mdw ~]$ sudo yum erase -y matrixdb5.x86_64

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

你需要首先停止集群，做好卸载或重装前的准备，这一步是必要的，否则会阻碍卸载操作。

通过元命令 \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 卸载”。这一步骤会彻底卸载掉原有版本的 YMatrix 软件。

注意！
如果你使用的是 CentOS 8 操作系统，需要将此步骤中的 yum 替换为 dnf；如果你使用的是 Ubuntu 系统，需要将此步骤的 yum 命令替换为 apt。

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

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

集群初始化完毕后，回到命令行使用 sudo 权限连接到 mxadmin 用户。

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

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

[mxadmin@mdw ~]$ mxstart -a

集群启动成功后，图形化界面也可正常使用。