更新日期：2024年09月11日
检查办法
通过GBase 8c 提供的gs_check 工具，可以检查GBase 8c 健康状态。
注意事项
GBase 8c 管理员指南
南大通用数据技术股份有限公司
17
扩容新节点检查只能在root 用户下执行，其他场景都必须在gbase 用户下执行。
必须指定-i 或-e 参数，-i 会检查指定的单项，-e 会检查对应场景配置中的多项。
如果-i 参数中不包含root 类检查项或-e 场景配置列表中没有root 类检查项，则不需要
交互输入root 权限的用户及其密码。
可使用--skip-root-items 跳过检查项中包含的root 类检查，以免需要输入root 权限用户
及密码。
检查扩容新节点与现有节点之间的一致性，在现有节点执行gs_check 命令指定-- hosts
参数进行检查，其中hosts 文件中需要写入新节点IP。
操作步骤
方式1
步骤1 以管理员用户gbase 登录数据库主节点。
步骤2 检查GBase 8c 数据库状态，执行如下命令：
gs_check -i CheckClusterState
其中参数说明：
-i：该参数用于指定检查项。注意区分大小写。格式为
-i CheckClusterState/CheckCPU/CheckClusterState/CheckCPU
取值范围为所有支持的检查项名称，详见《GBase 8c V5_3.0.0 工具参考手册》中
“gs_checkos”章节。用户可根据实际需求，指定检查项。
方式2
步骤1 以管理员用户gbase 登录数据库主节点。
步骤2 对GBase 8c 数据库进行健康检查，执行如下命令：
gs_check -e inspect
其中参数说明：
-e：该参数用于指定场景名。注意区分大小写。格式为
GBase 8c 管理员指南
南大通用数据技术股份有限公司
18
-e inspect/upgrade
取值范围为所有支持的巡检场景名称。默认场景包括：inspect（例行巡检）、upgrade
（升级前巡检）
、
binary_upgrade
（就地升级前巡检）
、
health
（健康检查巡检）
、
slow_node
（节点）、longtime（耗时长巡检）、install（安装）。用户可根据实际需求，指定巡
检场景。
GBase 8c 巡检的主要作用：在数据库运行过程中，检查整个GBase 8c 数据库集群状态
是否正常，或者重大操作前（升级、扩容），确保GBase 8c 满足操作所需的环境条件和状
态条件。详细的巡检项目和场景，请参见《GBase 8c V5_3.0.0 工具参考手册》中“服务端
工具> gs_checkos > GBase 8c 状态检查表”。
示例
执行单项检查结果：
[gbase@gbase8c ~]$ gs_check -i CheckCPU
Parsing the check items config file successfully
Distribute the context file to remote hosts successfully
Start to health check for the cluster. Total Items:1 Nodes:1
Checking...
[=========================] 1/1
Start to analysis the check result
CheckCPU....................................OK
The item run on 1 nodes.
success: 1
Analysis the check result successfully
Success.
All check items run completed. Total:1
Success:1
For more information please refer to
/home/gbase/gbase_db/om_f5c5a0af/script/gspylib/inspection/output/CheckRepor
t_202212065188911009.tar.gz
本地执行结果：
[gbase@gbase8c ~]$ gs_check -i CheckCPU -L
2022-08-18 15:17:42 [NAM] CheckCPU
2022-08-18 15:17:42 [STD] 检查主机CPU 占用率，如果idle 大于30%,或者iowait 小
于30%.则检查项通过，否则检查项不通过
2022-08-18 15:17:42 [RST] OK
GBase 8c 管理员指南
南大通用数据技术股份有限公司
19
2022-08-18 15:17:42 [RAW]
Linux 3.10.0-1127.el7.x86_64 (gbase8c_hostname)
08/18/22
_x86_64_
(2 CPU)
15:17:37
CPU
%user
%nice
%system
%iowait
%steal
%idle
15:17:38
all
通过设置配置参数，可以为数据处理环境定制数据库服务器。数据库服务器的配置参数存
储在配置文件中。
创建 GBase 8s 数据库服务器实例时，将自动使用基于 config.std 文件的缺省值来创
建对应的配置文件。新的配置文件名为 onconfig.gbasedbtservername，缺省情况下会
在 %GBASEDBTDIR%\etc\ 目录中创建此文件。如果将配置文件移至其他目录，请将
ONCONFIG 环境变量设置为此文件所在位置。
可以编辑配置文件来修改配置参数值，以提高实例的性能和其他特性。如果在配置文件中
省略某个参数值，数据库服务器将使用 onconfig.std 文件中的缺省值，或基于其他参
数值来计算相应值。
onconfig.std 文件是用于创建 onconfig.gbasedbtservername 文件的模板。 不要修
改或删除 onconfig.std 文件。
通过编辑 onconfig 文件，可以修改配置参数值。 数据库服务器下次关闭并重新启动之
后，更改将生效。但是，不便重新启动数据库服务器时，也可以通过其他方式来更改某些
配置参数的值：
•
数据库服务器正在运行时，使用 onmode -wf 命令可永久性更新许多配置参数。
•
使用 onmode -wm 命令可更新当前会话的许多配置参数值。
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 13 -
可以成组导出、导入和修改配置参数：
•
使用 onmode –we 命令可将当前配置的快照导出到文件。然后，生成的快照可以
进行归档，用作配置文件，或导入到另一个正在运行的实例。
•
使用 onmode –wi 命令可从先前导出的文件导入可调整的配置参数。文件中不可
动态调整的配置参数将被忽略。
您还可以通过 SQL 管理 API 命令来修改、重置、导出和导入配置文件：
•
将 modify config 自变量用于 admin() 或 task() 函数可更改配置参数的值。
•
将 export config 和 import config 自变量用于 admin() 或 task() 函数可导出或导
入包含一个或多个可动态调整的配置参数的文件。
•
将 reset config 或 reset config all 自变量用于 admin() 或 task() 函数可将一个配
置参数或全部配置参数的值还原为 onconfig 文件中的相应值。
通过一个配置参数 AUTO_TUNE，可以启用或禁用 onconfig 文件中不包含其值的所有自动
调整配置参数。自动调整配置参数为 AUTO_AIOVPS、AUTO_CKPTS、AUTO_LRU_TUNING、
AUTO_READAHEAD、 AUTO_REPREPARE 和 AUTO_STAT_MODE。
此外，还可以从 onconfig 文件中除去任何自动调整配置参数，然后使用 AUTO_TUNE
配置参数来设置已除去的配置参数的缺省值。例如，如果 AUTO_AIOVPS 和 AUTO_CKPTS
配置参数在配置文件中不存在，那么数据库服务器会自动将 AUTO_AIOVPS 和 AUTO_CKPTS
的值设置为 AUTO_TUNE 的值。 可以动态修改 AUTO_TUNE 配置参数。
联机日志会标识动态调整的配置参数。
可以使用 OpenAdmin Tool (OAT) 来监视配置。
准备 onconfig 配置文件
GBASEDBTDIR 的 etc 子目录中的 onconfig.std 模板文件包含许多配置参数的初始值。
您可以复制模板并保存副本，这样就可以根据您的特定配置来定制副本。
这些模板文件包含许多配置参数的初始值。
重要：请勿修改或删除模板文件。数据库服务器将这些文件作为模板而不是作为功能性配
置文件提供。
可以更改的功能配置文件是 onconfig 文件（而不是 onconfig.std 模板文件）。可以使
用文本编辑器来更改 onconfig 文件中的配置参数。
如果在 onconfig 文件的副本中省略参数，那么数据库服务器将在服务器启动时使用
onconfig.std 文件中的值代替缺少的参数。
提示： 如果不希望直接处理所有 onconfig 文件参数，genoncfg 实用程序可加快根据
您的硬件以及根据数据库服务器的预期用途对配置文件进行定制的过程。
在 UNIX™ 上创建 onconfig 文件
当您首次安装 GBase 8s 软件时，将创建并初始化数据库服务器的新实例。安装脚本将自
动为您创建 onconfig.demo 文件。
GBase 8s 管理员指南
南大通用数据技术股份有限公司
- 14 -
要使用文本编辑器准备 onconfig 文件，请执行以下操作：
1. 复制和重命名 $GBASEDBTDIR/etc/onconfig.std 文件，并将其存储到etc 子
目录中。
2. 使用文本编辑器编辑 onconfig 配置文件。
3. 将 ONCONFIG 环境变量设置为新的 onconfig 文件的名称。
4. 如果它是新的实例，那么初始化数据库服务器。 否则，关闭并重新启动数据库服
务器。
查看有关配置参数的信息
可以查看配置文件的内容，配置参数及其当前值的列表，以及有关可使用onstat 命令调
整的配置参数的信息。您还可以使用 OpenAdmin Tool (OAT)查看配置文件的内容。您可
以使用 onstat 命令或 OpenAdmin Tool (OAT)查看配置文件的内容。
要查看配置文件的内容，请运行 onstat –c 命令。如果在服务器运行期间更改了配置参
数，而且未关闭并重新启动数据库服务器，那么生效的配置将不同于 onstat –c 选项所
显示的内容。
要查看配置参数及其当前值的列表，请运行 onstat -g cfg 命令。