使用 genoncfg 实用程序可加快根据您主机环境以及数据库服务器的预期用途对缺省的
GBase 8s 配置文件 (onconfig.std) 进行定制的过程。
语法
元素
用途
关键注意事项
input_file 包含参数设置的输入文件
的名称
gbs_home
您希望配置的 GBase 8s
安装路径
如果 GBS_HOME 环境变量已被设置，
那么您可以
省略安装路径。
如果已设置 GBS_HOME 变量并且
在命令行进入了该安装路径，
那么实用程序会在
此命令行的路径下运行 。
-h
有关 genoncfg 实用程序
的帮助信息
-V
显示短的版本信息并退出
命令行实用程序
-version
显示扩展的版本信息并退
出命令行实用程序
用法
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 300 -
在运行此实用程序前，请以 root 或用户 gbasedbt 的身份登入主机。
在您成功运行 genoncfg 实用程序之前，必须在输入文件中设置参数对主机环境是可用的。
对于所有的环境，disk 参数在输入文件中是必不可少的。也可以在输入文件中输入指令。
这些指令对于运行实用程序时是非必要的，但是它们在一些场景下会有帮助。
该实用程序不会读取和修改任何已存在的配置文件。如有您在主机环境里有一个预先存在
的 ONCONFIG 文件，当您运行该实用程序，此文件中的参数值不会发生改变。因此，在
将参数应用在数据库服务器实例中之前，可以查看这些建议的参数设置。
使用 genoncfg 实用程序的步骤：
1. 用文本编辑器创建包含 genoncfg 实用程序处理过程的参数值的输入文件。
2. 用输入文件运行该实用程序。该配置文件（名为onconfig）将生成并保存在该工作
目录下。
3. 可选: 重命名生成的配置文件。
4. 如果您想要使用已生成的配置文件运行数据库服务器实例，将该文件复制到
$GBS_HOME/etc。
genoncfg 实用程序的输入文件
使用输入文件来指定以下关于数据库服务器实例的信息：
l 预计联机事务处理系统（OLTP）的连接数
l 预计决策支持系统（DSS）的连接数
l 磁盘空间
l CPU 初始化
l 网络服务连接设置
l 恢复时间
输入文件是一个 ASCII 文本文件。对参数的排列顺序没有要求。 以下是一个输入文件的
样本：
cpus 1
memory 1024 m
connection name demo_on onsoctcp 9088
servernum 1
oltp_connections 10
dss_connections 2
disk /opt/gbs_server/data/storage/online_root 0 k 300 m
directive one_crit
directive debug
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 301 -
表 1. genoncfg 实用程序的输入文件的参数
元素
描述
connection
服务器连接参数：
l 名称 或者 别名 ，取决于连接器的功能。是特定的服务器
名（还是替代服务器名（。
l 连接器的名称
l 连接服务器的类型（在配置文集中等同于 NETTYPE ）
l 服务的端口号
例如：connection name demo_on onsoctcp 9088
cpus
分配给实例的中央处理单元数（CPUs） 例如： cpus 1
directive
genoncfg 实用程序可以使用的指令。
l one_crit: 配置数据库服务器只在 root dbspace 上存储物理
日志、逻辑日志和数据。
l debug: 实时显示有关主机环境和配置文件上操作的信息。
例如： directive one_crit
此信息在解决数据库服务器配置问题时会有帮助。 一种场景是，
调试指令可以导致节省时间。在该场景下，通过读取显示的信息
注意到该实用程序在创建您不想要或不起作用的 onconfig 文
件。您停止该实用程序（尽管它仍在运行），调整输入文件的设
置，然后用修改完成后的输入文件返回实用程序。
disk
为实例设置的磁盘存储空间：
l root dbspace 的位置
l 偏移量的大小,以兆字节（m）或千字节（k）为单位
l root dbspace 的大小，以兆字节（m）或千字节（k ）为单位
例如：
UNIX™: /opt/gbs_server/data/storage/rootdbs
GBase 8s 管理员参考
南大通用数据技术股份有限公司 - 302 -
元素
描述
Windows™: d:\INFXDATA\rootdbs
重要： 如果进入 root dbspace 工作实例的路径下，该实例将被覆盖，
并不能使用。
dss_connections
预估该实例的决策处理系统（DSS）的连接数。例如：一个查询客户
端或其它可以获得商业智能设置结果的应用程序可以是一个 DSS
连接。例如： dss_connections 2
memory
实例的内存量（兆字节）。例如 ： memory 1024 m
oltp_connections
估计该实例的联机处理系统（OLTP）的连接数。典型的是，在实例
中修改数据库状态的应用程序时一个 OLTP 连接。例如：
oltp_connections 10
rto_server_restart 指定在重启 GBase 8s 后，进入联机或静默方式，数据库服务器不
得不从一个问题中恢复的时间量
（以秒为单位）
。
该值可设置为 0 以
禁用配置参数，或设置为在 60 和 1800 中的任意一值以启用参数
并指示秒数。 例如： rto_server_restart 100 指定恢复时间对象
为 100 秒
servernum
数据库服务器实例的唯一 ID 例如： servernum 1