MatrixDB 4小版本升级

本文档介绍了 MatrixDB 4 数据库软件小版本升级方法，以及图形化客户端 MXUI 的热升级功能。

1 MatrixDB 4小版本升级

小版本升级是指在主版本号不变的前提下，升级到新的版本。如：从 4.0.0 升级到 4.0.2；从 4.0.0 升级到 4.1.0。

下面，以从 MatrixDB 4.6.0 升级到 4.8.0 为例，介绍详细步骤。示例中主节点名称为 mdw。

1.1 获取最新安装包

从官网获得 4.8.0 安装包，matrixdb-4.8.0.enterprise-1.el7.x86_64.rpm，并拷贝到所有节点。

1.2 停止集群

切换到 mxadmin 用户。

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

停止集群。

[mxadmin@mdw ~]$ gpstop -af

1.3 在所有节点上执行更新命令

使用 root 权限户升级 RPM 包：

[<用户名称>@mdw ~]$ sudo yum upgrade matrixdb-4.8.0.enterprise-1.el7.x86_64.rpm

注意！
不要用 yum erase ，否则会删除前一个版本的配置。

1.4 重启服务

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

1.5 修改配置并重启集群(4.3.10 及之后的版本可跳过)

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

先启动集群，将 mars 插件添加到 shared_preload_libraries 配置中并重启。

[mxadmin@mdw ~]$ gpstart -a
[mxadmin@mdw ~]$ gpconfig -c shared_preload_libraries -v "matrixts,matrixmgr,matrixgate,telemetry,mars"
[mxadmin@mdw ~]$ gpstop -arf

注意！
shared_preload_libraries 的值需要在原有配置的基础上增加 MARS。

1.6 升级插件

如果使用了 matrixts 插件和 mars 插件，请连接到数据库并使用下列 SQL 命令进行升级:

postgres=# ALTER EXTENSION matrixts UPDATE;
postgres=# ALTER EXTENSION mars UPDATE;

如果使用了 Grafana 监控，登录 matrixmgr 数据库，升级 matrixmgr 插件，并重置采集任务：

[mxadmin@mdw ~]$ psql -d matrixmgr

matrixmgr=# ALTER EXTENSION matrixmgr UPDATE;
matrixmgr=# SELECT mxmgr_remove_all('local');
matrixmgr=# SELECT mxmgr_deploy('local');

注意！
4.5.2 及之后无需再升级 matrixmgr 插件。
4.6.0 及之后无需再升级 mars 插件。

2 图形化客户端热升级

热升级指的是支持 MXUI 组件独立于数据库进行升级，使你能够更快地享受图形化产品的迭代，极简数据库操作。

点击图形化界面左下角 mxadmin 用户选项的“升级版本”，当获得新版本的 MXUI 可执行文件后即可进行热升级。