更新日期：2024年09月11日
在 UNIX™，您可以使用 -FILE 选项运行 GBase 8s 中的某些实用程序 ，这些实用程序的
本地环境变量已设置在 onconfig 文件中。并且在运行命令去启动该实用程序时，不需设置
本地环境变量。
在启动以下实用程序时，您可以使用 -FILE 选项：oninit 、oncheck 、onclean 、onload 、
onunload 、onlog 、onmode 、onparams 、onspaces 、onstat 和 ontape 。
语法
-FILE 选项
元素
用途
关键注意事项
-FILE= file_name
指定包含环境信息的
-FILE=file_name 选项必须是该命令
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 340 -
元素
用途
关键注意事项
onconfig 文件的完整
路径或相对路径
的第一个参数
用法
在运行带有 -FILE 选项的命令之前，您必须在 onconfig 文件中按以下格式添加指令：
#$variable_name value
在 onconfig 文件中设置的环境变量优先于系统或 shell 中设置的相同的变量。
当启动带有 -FILE 选项的实用程序时，请指定 onconfig 文件的绝对路径或相对路径。例
如：以下示例都启动了环境信息在 serv1 的 onconfig 中的数据库服务器。
绝对路径
oninit -FILE=/opt/gbs_server/data/conf/onconfig
相对路径
oninit -FILE=conf/onconfig
如果 GBS_HOME 环境变量没有在用户的系统、shell 或 onconfig 文件中设置，GBS_HOME
的值将会设置到该执行程序的路径下（如果该执行程序在的 GBS_HOME 子目录下）。如果
您使用远程执行的形式（例如：ssh）， 请使用 -FILE 选项指定 onconfig 文件在远程电
脑上的路径。
示例
假设您在 onconfig 文件中为 js_3 实例指定了 DBDATE 和 SERVER_LOCALE 环境变量的
值：
#onconfig for js_3
#
# *** Start environment settings for js_3
#
#$DBDATE MDY4/
#$SERVER_LOCALE en_us.utf8
#
# *** End environment settings for js_3
其他有关运行该实用程序的重要的环境变量
（GBS_HOME）
在用户环境中被指定。
oninit 执
行程序的路径是用户环境的一部分并且 onconfig 文件也在当前目录下。
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 341 -
可以从当前目录下运行 oninit
-FILE=onconfig 命令去启动数据库服务器，它会自动设置
DBDATE 和 SERVER_LOCALE 环境变量的值。
当要新增或修改 onconfig 文件的内容时,必须遵循该文档的编译规则。
对参数的描述和其可以赋的值都阐述在 onconfig.std 文件的注释中。
以下显示了参数行的语法：
PARAMETER_NAME parameter_value comments
onconfig文件内容的格式规定如下：
一行只能命名一个参数。
注释行以 # 为标志并位于行的开头。
onconfig 文件的最大行限制为 512 字节，超出此限制的行将被截断，而且可能导
致配置问题。
参数名、参数值和可选注释之间必须放置空格（制表符和/或空格）。请不要再参
数值内部使用任何制表符或空格。
在参数值和空格之后的字符串都将被视为注释，
不论这些字符串的开头是否以 # 标记。
onconfig 文件中的参数及其值是区分大小写的，参数名总是大写的，如果值项使
用大写字母描述的，那么您必须使用大写（例如： NETTYPE 参数 的 CPU 值）。
大多数参数只能有一个有效的项。在 onconfig 文件中，如果一些参数有多项，系
统将默认第一项有效。
然而，
一些参数可以有多个项，
例如 DBSERVERALIASES 参
数。 另一些参数，例如 VPCLASS 可以出现多次。
未识别的参数可以被保存，但是会被忽略并且不会报错。
复制但忽略未识别的参数，且不会报错。
提示： 如果您在 onconfig.std 模板文件中运行一个像 grep 的程序，那么指定新行字符
（^）只返回配置参数的名称和值。若没有新行字符，参数的描述也将会被返回。
例如：下面的命令不仅返回配置参数的描述，也返回它的值：
grep "MSGPATH" onconfig.std
# MSGPATH - The path of the IDS message log file
MSGPATH $GBASEDBTDIR/tmp/online.log
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 3 -
然而，下面的命令只返回配置参数的值：
grep "^MSGPATH" onconfig.std
MSGPATH $GBASEDBTDIR/tmp/online.log
环境变量的约定
在环境变量适用的任何配置参数中，您可以输入一个环境变量作为值。例如：对于
DBSERVERNAME 配置参数您可以指定以下的环境变量来代替您数据库服务器的名称。
DBSERVERNAME $MY_DBSERVERNAME
重要： 如果您输入一个环境变量作为值，您必须在任何可执行程序或读取 onconfig 文件
的实用程序的环境中设置该环境变量。读取 onconfig 文件的实用程序包括 oninit、
oncheck、onbar、ontape、onlog 和 archecker。
更改配置文件
您可以更改数据库服务器的 onconfig 文件，来定制服务器功能或者调整数据库行为。
缺省情况下，onconfig 文件位于 GBASEDBTDIR/etc 目录中。ONCONFIG 环境变量指定
onconfig 文件的名称和位置。
onconfig.std 文件是一个模板配置文件，
您可以从中复制配置参数设置。
onconfig.std 文
件是一个模板而不是一个功能性配置。您可以复制和重命名 onconfig.std 文件，但是不
可以更改或者删除 onconfig.std 文件。如果您在配置文件的副本中省略一个参数值，那
么数据库服务器或者使用 onconfig.std 模板文件中的缺省值，或者根据其他参数值计算
出这些值。
您可以通过下列任何一种方法更改 onconfig 文件：
您可以使用 GBase OpenAdmin Tool (OAT) for GBase 8s 监视和更新您的配置。
OAT 提供配置参数值的建议来优化您的数据库服务器配置。
您可以使用文本编辑器更改配置参数值。在下一次数据库服务器关闭并重启之后，
这些变更生效。
通过运行 onmode -wf 来永久地更新配置参数，或者通过运行 onmode -wm 命令来
更新内存中的配置参数，您可以动态地更改许多配置参数的值，而无需重启数据
库服务器。
通过运行 genoncfg 实用程序，您可以生成一个 onconfig 文件，根据您的估算来
优化连接、磁盘空间，以及 CPU 使用情况设置。
您可以成组地导出、导入和修改配置参数：
使用 onmode –we 命令将当前配置的一个快照导出到一个文件。
这个结果快
照可以再归档，用作一个配置文件，或者导入到另一个正在运行的实例。
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 4 -
使用 onmode –wi 命令从一个先前导出的文件导入可调整的配置参数。
忽略
这个文件中那些不能动态地调整的配置参数。
您可以使用 SQL 管理 API 命令来修改、重置、导出和导入一个配置文件。
使用 admin() 或 task() 函数的 modify config 参数来改变一个配置参数
的值。
使用 admin() 或 task() 函数的 export
config 和 import
config 参数来
导出或导入一个文件，这个文件包含一个或多个可动态地调整的配置参数。
使用 admin() 或 task() 函数的 reset config 或 reset config all 参数
来将一个配置参数或全部配置参数恢复为 onconfig 文件中的值。
通过运行 onconfig_diff 实用程序，您可以比较两个 onconfig 文件。
显示 onconfig 文件中的设置
您可以使用若干个工具来显示 onconfig 文件中的设置。
请使用下列工具之一来显示 onconfig 文件中的设置：
使用一个文本编辑器打开 onconfig 文件。
使用 onstat -c 命令，或使用 GBase OpenAdmin Tool (OAT) for GBase 8s 查看
onconfig 文件的内容。
通过运行 onstat -g cfg 命令查看配置参数列表及其当前值。如果动态地更新配置参
数，则当前值与 onconfig 文件中的永久值不同。
您可以使用 onstat -g cfg 命令的附加选项，来只显示那些动态变更了的配置参数，或显
示关于全部配置参数的附加信息。