更新日期:2024年09月11日
gs_om 参数可以分为如下几类:
通用参数
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
169
-t
gs_om 命令的类型。
取值范围:start、stop、status、generateconf、cert、view、query、refreshconf、kerberos。
-l
指定日志文件及存放路径。
默认值:$GAUSSLOG/om/gs_om-YYYY-MM-DD_hhmmss.log(virtualip 的默认值:
/tmp/gs_virtualip/gs_om-YYYY-MM-DD_hhmmss.log)
-?, --help
显示帮助信息。
-V, --version
显示版本号信息。
启动GBase 8c 参数:
-h
指定需要启动的服务器名称。一次只能启动一个服务器。
取值范围:服务器名称。
不指定服务器名称时,表示启动GBase 8c。
-D
指定数据库节点路径。
取值范围:数据库节点路径。
不指定数据库节点路径,表示使用静态文件中的数据库节点路径。
针对部署了CM 工具的集群,如果在对单个实例进行启停时候指定了-D 参数,只
会启动或者停止数据库进程,不会影响CM 相关进程。
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
170
假设当前实例的数据库和CM 进程都停止,
在启动该实例时候如果指定了-D 参数,
那么只会尝试拉起数据库进程,
此时由于CM 进程不存在会导致数据库进程也拉起
失败。可以去掉-D 参数,启动整个实例。
--time-out=SECS
指定超时时间,如果超时,om 脚本自动退出。单位:s。
取值范围:正整数,建议值300。
默认值:300。
--security-mode
指定是否以安全模式启动数据库。
取值范围:
on 以安全模式启动。
off 不以安全模式启动,默认不开启安全模式。
--cluster-number
指定启动时内核运行版本号。
取值范围:内核版本号。
停止GBase 8c 参数:
-h
指定需要停止实例所在的服务器名称。一次只能停止一个服务器。
取值范围:实例所在的服务器名称。
不指定服务器名称时,表示停止GBase 8c。
-m, --mode=MODE
停止模式设置。
取值范围:支持两种停止模式。
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
171
fast 方式:保证有主备关系的实例数据是一致的。
immediate 方式:不保证有主备关系的实例数据是一致的。
默认值:fast 方式。
--time-out=SECS
指定超时时间,如果超时,om 脚本自动退出。单位:s。
取值范围:正整数,建议值300。
默认值:300。
查询状态参数
GBase 8c 状态显示结果的参数说明请参见表3-10。
-h
指定需要待查询的服务器名称。
取值范围:服务器名称。
不指定服务器时,表示查询GBase 8c。
--az
指定需要查询的AZ 名称,比如--az=AZ1。
取值范围:AZ 名称,不指定AZ 名称时,表示查询所有AZ。
-o
输出到指定的output 文件中。
如果不指定,直接显示在屏幕上。
--detail
显示详细信息。如果不指定,只提示该服务器是否正常。
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
172
本参数通过在每个数据库节点执行gs_ctl query 命令进行查询并汇总结果,来获取
实例的详细信息。
--all
显示GBase 8c 所有节点信息。
本参数通过在每个数据库节点执行gsql 查询系统表并汇总结果,来获取集群所有
节点的信息。为保证显示信息的正确性,在使用本参数前请确认gsql 可以查询。
生成配置文件参数
-X
选择GBase 8c 配置文件路径。
取值范围:clusterconfig.xml 的路径。
--old-values=old
需要修改的静态文件中的旧值。
取值范围:port、ip、hostname,可以输入多个值,用逗号隔开。
--new-values=new
需要修改的静态文件中的新值。
取值范围:port、ip、hostname,可以输入多个值,用逗号隔开,与old-values 一一对应。
--distribute
将静态配置文件发布到GBase 8c 实例的安装目录。
开启、关闭数据库内kerberos 认证
-U
指定数据库部署用户。
取值范围:数据库部署用户。
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
173
-m
指定所要进行的操作。
取值范围:
install:开启数据库内kerberos 认证。
uninstall:关闭数据库内kerberos 认证。
--krb-server 安装kerberos 服务端认证。
--krb-client 安装kerberos 客户端认证。
注:需要先安装--krb-server,卸载时同步卸载不需要该参数。
SSL 证书替换
--cert-file
指定本地SSL 证书zip 压缩包所在路径。
--rollback
证书回退到上一次成功备份的状态。
-L
制定该参数时,仅对当前节点进行。
表3-10 状态说明
字段
字段含义
字段值
cluster_state
显示实例状态。
Normal:
表示GBase 8c 可用,
且数据有冗余备份。
所有进程都在运行,主备关系正常。
Unavailable:表示GBase 8c 不可用。
Degraded:表示GBase 8c 可用,但数据没有冗余
备份。
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
174
字段
字段含义
字段值
redistributing
数据重分布状
态。
Yes:表示GBase 8c 处于数据重分布状态。
No:表示GBase 8c 未处于数据重分步状态。
balanced
平衡状态。显示
是否有GBase 8c
实例发生过主备
切换而导致主机
负载不均衡。
Yes:表示GBase 8c 处于负载均衡状态。
No:表示GBase 8c 未处于负载均衡状态。
node
主机名称。
表示该实例所在的主机名称。
多AZ 时会显示AZ 编号。
node_ip
主机IP。
表示该实例所在的主机IP。
instance
实例ID。
表示该实例的ID。
state
实例状态。
P: 节点的初始角色是Primary,
数据库安装后就不
再变动,从系统静态文件读取。
S: 节点的初始角色是Standby,
数据库安装后就不
再变动,从系统静态文件读取。
C: 节点的初始角色是Cascade Standby,数据库安
装后就不再变动,从系统静态文件读取。
Primary:表示实例为主实例。
Standby:表示实例为备实例。
Cascade Standby:表示实例为级联备实例。
Pending:表示该实例在仲裁阶段。
Unknown:表示实例状态未知。
Down:表示实例处于宕机状态。