更新日期：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：表示实例处于宕机状态。