日常管理

本文档将介绍 YMatrix 的日常运维管理工具，主要为以下两部分：

使用命令行工具启停集群、查看集群运行状态、修改集群配置等。
使用图形化界面查看集群信息。

注意！
命令行工具都是通过主节点（Master）控制的，所以必须在 Master 节点上执行。

YMatrix 5 启动崭新的数据库架构。在此架构下，我们提供了最新的集群运维工具：mxstart、mxstop、mxstate。 YMatrix 5 新架构更多介绍请见 YMatirx 架构。

注意！
YMatrix 5 默认使用新运维工具管理集群，YMatrix 4（MatrixDB 4）仍默认使用 Greenplum 系列运维工具，具体介绍请见 YMatrix 4 集群基本管理。

1 命令行工具

1.1 启动集群

mxstart -a 命令可以启动 YMatrix 集群。

[mxadmin@mdw ~]$ mxstart -a

1.2 停止集群

mxstop -a 命令用来停止一个正在运行的 YMatrix 集群。

mxstop 模式	参数	禁用新连接	等待进程运行完毕	是否是默认模式
smart	-M smart	是	是	是
fast	-M fast	是	否，中断连接，事务回滚	否
immediate	-M immediate	是	否，直接杀掉进程	否

[mxadmin@mdw ~]$ mxstop -a -M fast

请选择一种模式来停止集群。对于 YMatrix 集群的大部分情况来说，使用 fast 模式为最佳方式。如果不选择模式（mxstop -a），则默认为你启用 smart 模式，以保证你正在进行的操作能自然完成，但可能会等待较长时间。该命令的阻塞不会影响使用集群，但是集群无法再创建新的连接。

1.2.1 重启集群

mxstop -ar 可以重启集群。

1.2.2 重新加载授权配置

当修改 pg_hba.conf 授权配置之后，需要调用 mxstop -u 来重新加载授权配置。

1.3 查看集群状态

mxstate 可以查看集群的运行状态，包括：

Master 的配置信息。
Segment 的配置信息。
镜像节点（Mirror）信息等。

[mxadmin@mdw ~]$ mxstate

1.4 修改集群配置

gpconfig 用于查看或修改配置文件 postgresql.conf 中的配置参数。

1.4.1 查看配置

通过 gpconfig -s 加配置名可以查看配置：

[mxadmin@mdw ~]$ gpconfig -s shared_buffers
Values on all segments are consistent
GUC          : shared_buffers
Master  value: 1078464kB
Segment value: 1078464kB

1.4.2 修改配置

通过 gpconfig -c {配置名} -v {值} 来修改配置：

[mxadmin@mdw ~]$ gpconfig -c shared_buffers -v 128MB
20210723:17:13:35:004318 gpconfig:sdw2:mxadmin-[INFO]:-completed successfully with parameters '-c shared_buffers -v 128MB'

修改配置后要重启集群才能生效：

[mxadmin@mdw ~]$ mxstop -ar

重启后，查看配置：

[mxadmin@mdw ~]$ gpconfig -s shared_buffers
Values on all segments are consistent
GUC          : shared_buffers
Master  value: 128MB
Segment value: 128MB