语法格式
停止GBase 8c 数据库集群的语法格式为：
gha_ctl stop all -l dcslist [-c cluster]
gha_ctl stop coordinator | datanode | gtm | server -l dcslist [-c cluster] [-t
timeout]
参数说明
all |coordinator | datanode | gtm | server：必选字段。指定停止全部节点或某类型节点。
-l：必选字段。指定DCS 地址，格式为http://
出一个节点地址，其他节点会自动同步消息。为了保证高可用，也可以列出所有节点
地址。
-c 参数：可选字段。指定数据库集群名称。缺省默认值gbase。
-t 参数：可选字段。指定等待数据库停止的超时时间。缺省默认值为30min。
示例
名为gbase 的集群中一个DCS 节点IP 为10.0.7.16，可使用以下命令停止数据库集群：
[gbase@gbase8c ~]$ gha_ctl stop all -l http://10.0.7.16:2379 -c gbase
返回如下信息，则说明停止操作成功。
{
"ret":0,
"msg":"Success"
}
GBase 8c 管理员指南
南大通用数据技术股份有限公司
3
2
状态查询
GBase 8c 数据库管理员可使用gha_ctl monitor 命令，来查询数据库集群的运行状态。
语法格式
gha_ctl monitor
all |coordinator | datanode | gtm | server| dcs [-H] -l dcslist
[-c cluster]
其中参数说明：
dcslist、[-c cluster]参数与上述相同；
all |coordinator | datanode | gtm | server|dcs：必选字段。指定查看哪类集群节点或全部。
-H：可选字段。指定返回信息是否以表格形式显示。缺省默认为文件命令行形式。
示例
名为gbase 的集群中一个DCS 节点的IP 为10.0.7.16，则具体操作命令如下：
[gbase@gbase8c ~]$ gha_ctl monitor all -l http://10.0.7.16:2379
返回运行中为成功：
{
"cluster": "gbase8c",
"version": "3.0.0B06",
"server": [
{
"name": "gha_server1",
"host": "10.0.7.16",
"port": "20001",
"state": "running",
"isLeader": true
}
],
"gtm": [],
"coordinator": [],
"datanode": {
"dn1": [
{
"name": "dn1_1",
GBase 8c 管理员指南
南大通用数据技术股份有限公司
4
"host": "10.0.7.16",
"port": "20008",
"work_dir": "/home/gbase/data/dn1/dn1_1",
"agentPort": "8005",
"state": "running",
"role": "primary"
"agentHost": "10.0.7.16"
}
]
},
"dcs": {
"clusterState": "healthy",
"members": [
{
"url": "http://10.0.7.16:2379",
"id": "84e2852165d202b0",
"name": "node_0",
"isLeader": true,
"state": "healthy"
}
]
}
}
GBase 8c 管理员指南
南大通用数据技术股份有限公司
5
3
实例主备切换
操作场景
GBase 8c 在运行过程中，数据库管理员可能需要手工对数据库节点做主备切换。例如
发现数据库节点主备宕机后，
需要恢复原有的主备角色，
或怀疑硬件故障需要手动进行主备
切换。级联备机不能直接转换为主机，只能先通过switchover 成为备机，然后再成为主机。
说明
主备切换为维护操作。需确保GBase 8c 状态正常，且在所有业务结束后，进
行切换操作。
在开启极致RTO 时，不支持级联备机。由于在此情况下，备机不支持连接而
无法同步数据。
对于同一数据库，如果前一次主备切换操作尚未完成，则不能再次执行切换。
假如在业务期间发起switchover，
可能由于主机线程无法停止，
而导致显示切
换超时，
但实际后台仍然在运行。
只需等主机线程停止后，
再执行switchover
即可完成。
例如当主机删除一个大的分区表时，
可能无法即时响应switchover
发起的信号。
语法格式
gha_ctl switchover datanode|gtm group_name leader_node_name
[standby_node_name] -l dcslist [-c cluster]
示例
将数据库DN 备节点切换为主节点。需执行以下步骤：
步骤1 查询数据库状态，执行命令：
[gbase@gbase8c ~]$ gs_om -t status --detail
返回如下信息，此时10.0.7.7 为主数据节点，10.0.7.8 为备数据节点。
……
[
Datanode State(group id: 2)
]
GBase 8c 管理员指南
南大通用数据技术股份有限公司
6
node
node_ip
port
instance
state
----------------------------------------------------------------------------
---------------------
1
gbase8c_7_7 10.0.7.7
15432
6001 /home/gbase/data/dn1/dn1_1
P
Primary Normal
2
gbase8c_7_8 10.0.7.8
15432
6002 /home/gbase/data/dn1/dn1_2
S
Standby Normal
步骤2 登录备节点，执行主备切换命令。另外，在switchover 级联备机后，级联备机
成为备机，而备机降为级联备。
[gbase@gbase8c_7_8 ~]$ gha_ctl switchover datanode dn1 dn1_1 -c gbase8c -l
http://10.0.7.7:2379
返回如下信息后，主备切换成功。
{
"ret":0,
"msg":"Success"
}
再次执行步骤1，查询主备状态：10.0.7.7 为备节点，10.0.7.8 为主节点。
错误排查
如果switchover 过程中出错，请根据日志文件中的信息排查错误，详见9 日志参考。
异常处理
异常判断标准如下：
业务压力下，主备实例切换时间长，这种情况不需要处理。
其他备机正在build 的情况下，主机需要发送日志到备机后，才能降备，导致主备切换
时间长。这种情况不需要处理，但应尽量避免build 过程中进行主备切换。
切换过程中，因网络故障、磁盘满等原因造成主备实例连接断开，出现双主现象时，此
时请参考如下步骤修复。
GBase 8c 管理员指南
南大通用数据技术股份有限公司
7
出现双主状态后，请按如下步骤操作，恢复为正常的主备状态。否则可能会造成
数据丢失。
(1) 执行以下命令，查询数据库当前的实例状态。
gs_om -t status --detail
若查询结果显示两个实例的状态都为Primary，这种状态为异常状态。
(2) 在降为备机的节点上，执行如下命令关闭服务。
gha_ctl stop datanode group_name node_name -l dcslist [-c cluster]
(3) 执行以下命令，启动备节点。
gha_ctl start datanode group_name node_name -c cluster_name -l dcslist [-c
cluster]
(4) 查看数据库状态，确认实例状态恢复。
4
例行维护
GBase 8c 数据库允许管理员用户进行例行维护的操作，以保证数据库中的数据安全，
避免发生丢失数据、非法访问数据等事故。