genoncfg 实用程序

使用 genoncfg 实用程序可加快根据您主机环境以及数据库服务器的预期用途对缺省的 GBase 8s 配置文件 (onconfig.std) 进行定制的过程。

语法

元素 用途 关键注意事项
input_file 包含参数设置的输入文件的名称  
gbasedbtdir 您希望配置的 GBase 8s 安装路径 如果 GBASEDBTDIR 环境变量已被设置,那么您可以省略安装路径。如果已设置 GBASEDBTDIR 变量并且在命令行进入了该安装路径,那么实用程序会在此命令行的路径下运行 。
-h 有关 genoncfg 实用程序的帮助信息  
-V 显示短的版本信息并退出命令行实用程序  
-version 显示扩展的版本信息并退出命令行实用程序  

用法

在运行此实用程序前,请以 root 或用户 gbasedbt 的身份登入主机。

在您成功运行 genoncfg 实用程序之前,必须在输入文件中设置参数对主机环境是可用的。对于所有的环境,disk 参数在输入文件中是必不可少的。也可以在输入文件中输入指令。这些指令对于运行实用程序时是非必要的,但是它们在一些场景下会有帮助。

该实用程序不会读取和修改任何已存在的配置文件。如有您在主机环境里有一个预先存在的 ONCONFIG 文件,当您运行该实用程序,此文件中的参数值不会发生改变。因此,在将参数应用在数据库服务器实例中之前,可以查看这些建议的参数设置。

使用 genoncfg 实用程序的步骤:
  1. 用文本编辑器创建包含 genoncfg 实用程序处理过程的参数值的输入文件。
  2. 用输入文件运行该实用程序。该配置文件(名为onconfig)将生成并保存在该工作目录下。
  3. 可选: 重命名生成的配置文件。
  4. 如果您想要使用已生成的配置文件运行数据库服务器实例,将该文件复制到 $GBASEDBTDIR/etc 并且相应地更新 ONCONFIG 环境变量。

genoncfg 实用程序的输入文件

使用输入文件来指定以下关于数据库服务器实例的信息:

输入文件是一个 ASCII 文本文件。对参数的排列顺序没有要求。 以下是一个输入文件的样本:
cpus 1
          memory 1024 m
          connection name demo_on onsoctcp 9088
          servernum 1
          oltp_connections 10
          dss_connections 2
          disk /opt/IBM/gbasedbt/demo/server/online_root 0 k 300 m
          directive one_crit
          directive debug
表 1. genoncfg 实用程序的输入文件的参数
元素 描述
connection 服务器连接参数:
  • 名称 或者 别名 , 取决于连接器的功能。是特定的服务器名(在配置文件中使用 DBSERVERNAME 参数)还是替代服务器名(在配置文件中使用 DBSERVERALIASES 参数)。
  • 连接器的名称
  • 连接服务器的类型(在配置文集中等同于 NETTYPE )
  • 服务的端口号

例如:connection name demo_on onsoctcp 9088

cpus 分配给实例的中央处理单元数(CPUs) 例如: cpus 1
directive genoncfg 实用程序可以使用的指令。
  • one_crit: 配置数据库服务器只在 root dbspace 上存储物理日志、逻辑日志和数据。
  • debug: 实时显示有关主机环境和配置文件上操作的信息。

例如: directive one_crit

此信息在解决数据库服务器配置问题时会有帮助。 一种场景是,调试指令可以导致节省时间。在该场景下,通过读取显示的信息注意到该实用程序在创建您不想要或不起作用的 onconfig 文件。您停止该实用程序(尽管它仍在运行),调整输入文件的设置,然后用修改完成后的输入文件返回实用程序。

disk 为实例设置的磁盘存储空间:
  • root dbspace 的位置
  • 偏移量的大小,以兆字节(m)或千字节(k)为单位
  • root dbspace 的大小,以兆字节(m)或千字节(k )为单位

例如:

UNIX™: /opt/IBM/dbspace/rootdbs

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