更新日期：2024年09月11日
这些主题包含有关 ON-Bar 和 ontape 实用程序配置参数的参考信息
重要： ON-Bar 不使用 TAPEDEV、TAPEBLK、TAPESIZE、LTAPEBLK 和 LTAPESIZE 配
置参数。ON-Bar 检查 LTAPEDEV 是否设置为 /dev/null（UNIX™ 上）。
BACKUP_FILTER 配置参数
使用 BACKUP_FILTER 配置参数可指定用于 ON-Bar 或 ontape 实用程序的外部过滤器
程序的路径名和任何选项。
onconfig.std 值
未设置。备份数据未过滤。
值
命令的路径名和任何选项。缺省情况下，路径名相对于 $GBASEDBTDIR/bin 目录，否
则，路径名必须是程序的绝对路径。 如果您要包括命令行选项，那么必须使用单引号
括住过滤器名称和选项。
生效
编辑 onconfig 文件，并且 ON-Bar 或 ontape 启动后。
用途
该过滤器在备份数据之前对其进行变换（例如，将其压缩）。然后变换的数据将被备份，
并且会存储成单个文件。执行恢复时，必须将数据变换回其原始格式。在通过设置
RESTORE_FILTER 配置参数进行恢复之前，指定相应程序来变换数据。
为了安全，过滤器不能有非特权用户写许可权。对过滤器的许可权与对 GBase 8s 服务器或
实用程序所调用的其他可执行文件的许可权相同。
注： 如果在 onconfig 文件中设置 BACKUP_FILTER 参数，那么 LTAPESIZE 配置参数不
能设置为 0。否则，在将逻辑日志备份到磁盘上的目录时，ON-Bar 或ontape 实用程序会返
回错误。错误消息为：
当已设置 BACKUP_FILTER 配置参数时，LTAPESIZE 配置
参数无法设置为 0；请更改 LTAPESIZE 的值。
程序结束。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 209 -
变通方法是将 LTAPESIZE 配置参数设置为高值。日志文件不会大幅高于 LOGSIZE 配置
参数。使用 LOGSIZE 中的值作为此数据库的上限。
在 BACKUP_FILTER 配置参数中指定过滤器信息时，请指定过滤器程序的路径名和任何
选项，如以下示例中所示：
BACKUP_FILTER
/bin/compress
此过滤器所生成的输出将作为单个对象保存到存储管理器中。
BACKUP_FILTER 配置参数可包括命令行选项以及过滤器名称。例如，指定：
BACKUP_FILTER
'my_encrypt -file /var/adm/encryption.pass'
BAR_ACT_LOG 配置参数
使用 BAR_ACT_LOG 配置参数可指定 ON-Bar 活动日志的完整路径名。
onconfig.std 值
none
值的范围
完整路径名
生效
onbar-driver 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
用途
您应该指定具有适当可用空间量的现有目录的路径，或者使
用 $GBASEDBTDIR/bar_act.log。
无论何时有备份或恢复活动发生或者出错，ON-Bar 都会向活动日志写入一条简要说明。文
件格式与数据库服务器消息日志的格式相似。可以检查活动日志以确定 ON-Bar 操作的结
果。
如果 BAR_ACT_LOG 配置参数指定的文件不存在，那么会创建该文件。如果 ON-Bar 命
令（或与 ON-Bar 相关的任何实用程序，如 onsmsync 实用程序）从未在系统上运行，那么
该文件不存在。
sysbaract_log 表是从 BAR_ACT_LOG 指定的文件读取数据的系统监视接口伪表。如果尝
试在不存在 BAR_ACT_LOG 文件的系统上查询sysbaract_log，那么会返回以下错误：
244：无法执行物理顺序读来访存下一行。
101：ISAM 错误：文件未打开。
仅指定文件名时的用法
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 210 -
如果在 BAR_ACT_LOG 配置参数中仅指定文件名，ON-Bar 将在您启动 ON-Bar 的工作目
录中创建 ON-Bar 活动日志。例如：如果您从 UNIX™ 上的 /usr/mydata 启动 ON-Bar，那么
会将活动日志写入该目录中。
对于 UNIX™，如果数据库服务器启动连续逻辑日志备份，ON-Bar 会写入该数据库服务器
的工作目录中的 ON-Bar 活动日志。
BAR_BSALIB_PATH 配置参数
使用 BAR_BSALIB_PATH 配置参数可为所使用的存储管理器的 XBSA 共享库指定路径
名和文件名。
onconfig.std 值
UNIX™：none
生效
onbar-driver 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
用途
ON-Bar 和存储管理器依靠共享库来彼此结合。请为您的存储管理器库配置
BAR_BSALIB_PATH 配置参数。对 BAR_BSALIB_PATH 的支持特定于平台。请检查您
的机器说明，以确定是否可以对您的操作系统使用该配置参数。可以在备份与恢复之间更
改 BAR_BSALIB_PATH 的值。
要确保发生这种集成，请指定共享库的路径名。请指定以下选项之一：
UNIX：
将存储管理器库放到缺省目录中。
例如，Solaris 的后缀是 so，因此在 Solaris 系统上指定
$GBASEDBTDIR/lib/ibsad001.so。
例如，Solaris 的后缀是 so，因此在 Solaris 系统上指定
$GBASEDBTDIR/lib/libbsapsm.so。
将存储管理器库放在任意目录下，并创建一个从
$GBASEDBTDIR/lib/ibsad001.platform_extension 到它的符号链接。
如果您使用 Storage Manager ，那么创建
$GBASEDBTDIR/lib/libbsa.platform_extension 的符号链接或将
BAR_BSALIB_PATH 设置为此绝对路径值。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 211 -
如果使用 GBase Tivoli Storage Manager (TSM)，那么创建
$GBASEDBTDIR/lib/libtxbsa.platform_extension 的符号链接或将
BAR_BSALIB_PATH 设置为此绝对路径值。
设置 LD_LIBRARY_PATH 环境变量。 例如，将 LD_LIBRARY_PATH 设置为
$GBASEDBTDIR/lib。
如果参数 BAR_BSALIB_PATH 缺失或没有值，并且数据库服务器无法打开您的平台的
XBSA 共享库，那么 ON-BAR 会尝试使用 GBase 8s 主存储管理器 作为所有平台中的存
储管理器。
提示： 确保在恢复中共享库可以访问存储管理器中的备份数据。不能备份到一个存储管理器而
从其他存储管理器恢复。
BAR_CKPTSEC_TIMEOUT 配置参数
BAR_CKPTSEC_TIMEOUT 配置参数指定在执行外部备份时，RS 辅助服务器应等待检查
点从主服务器到达的时间量（以秒为单位）。
onconfig.std 值
15
如果值不存在
15
单位
秒
值的范围
5 到 CKPTINTVL 配置参数值的两倍
生效
编辑 onconfig 文件并重新启动数据库服务器后。
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
用途
当在 RS 辅助服务器上执行外部备份时，辅助服务器必须等待检查点从主服务器的逻辑日
志中到达。检查点会清空缓冲区，将其中的内容保存到磁盘中，并阻塞包含临时表的用户
事务。如果主服务器上的检查点在超时时段内未完成，那么 RS 辅助服务器上的备份将失
败。
您可以将 BAR_CKPTSEC_TIMEOUT 配置参数设置为执行外部备份时，
RS 辅助服务
器应等待检查点从主服务器到达的时间量（以秒计）。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 212 -
BAR_DEBUG 配置参数
使用 BAR_DEBUG 配置参数可指定数据库服务器在 ON-Bar 活动日志中捕获的调试信息
量。
onconfig.std 值
BAR_DEBUG 0
值
0 = 不显示调试信息。
1 = 打印少量信息
2 = 每次 ON-Bar 符合以下条件时打印消息：
进入函数。
退出函数。该消息包括函数的返回码。
3 = 打印退出和进入信息，以及其他详细信息。
4 = 还打印有关 ON-Bar 并行操作的信息。
5 = 还打印有关以下项的信息：
要备份或恢复的对象。
与 bar_action 表对应的 act_node 结构。
6 = 打印有关以下项的其他信息：
要备份或恢复的对象。
与 bar_action 表对应的 act_node 结构。
7 = 还打印：
与 bar_instance 表对应的 ins_node 结构的内容相关信息。
对 bar_action 表的修改的相关信息。
有关恢复的逻辑日志和对象的信息。
sysutils 数据库上完成的 SQL 语句以及返回的 SQLCODES。
8 = 还打印已归档且已恢复的所有页面的页面标题。 此设置需要大量空间。
9 = 打印以下项的内容：
初始化后的 bar_ins 结构。
冷恢复的对象描述符。
生效
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 213 -
针对任何当前正在执行的 ON-Bar 命令和任何后续命令编辑 onconfig 文件后立即生
效。 当您更新 BAR_DEBUG 时当前正在执行的任何 ON-Bar 命令都会读取
BAR_DEBUG 的新值并以新的级别打印调试消息。
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
用途
缺省值 0 不显示调试信息。
将 BAR_DEBUG 配置参数设置为较高值，
以在 ON-Bar 活动
日志中显示更详细的调试信息。
在会话期间，您可以在 onconfig 文件中动态更新 BAR_DEBUG 的值。
BAR_DEBUG_LOG 配置参数
使用 BAR_DEBUG_LOG 参数可指定 ON-Bar 调试日志的位置和名称。
onconfig.std 值
/usr/gbasedbt/bar_dbug.log
如果值不存在
UNIX™：/tmp/bar_dbug.log
生效
ON-Bar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
用途
出于安全性原因，请将 BAR_DEBUG_LOG 配置参数设置为带有受限许可权的目录，如
$GBASEDBTDIR 目录。
BAR_HISTORY 配置参数
使用 BAR_HISTORY 配置参数可指定当您使用 onsmsync 使旧备份到期时，sysutils 数据
库是否保留备份历史记录。
onconfig.std 值
none
如果值不存在
0
值的范围
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 214 -
0 = 从 sysutils 数据库中除去到期的备份对象的记录
1 = 在 sysutils 数据库中保留到期的备份对象的记录
生效
onsmsync 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
用途
如果将值设置为 0，那么 onsmsync 从 sysutils 数据库中将已到期的备份对象的
bar_object、bar_action 和 bar_instance 行除去。如果将值设置为 1，那么 onsmsync 将
bar_action 行中的 act_type 值设置为 7，并在 sysutils 数据库中为已到期的备份对象保留
bar_action 和 bar_instance 行。
如果未将 BAR_HISTORY 设置为 1，
那么恢复历史记录将
被除去。
不管 BAR_HISTORY 的值是什么，当存储管理器使该对象到期时，onsmsync 都将从紧急
引导文件中除去描述备份对象的行并从存储管理器中除去该对象。
有关 onsmsync 的更多信息，请参阅 onsmsync 实用程序。
BAR_IXBAR_PATH 配置参数
使用 BAR_IXBAR_PATH 配置参数来更改 ON-Bar 引导文件的路径和名称。
onconfig.std 值
UNIX™ 或 Linux™：$GBASEDBTDIR/etc/ixbar.servernum
值的范围
ON-Bar 引导文件的完整路径名
生效
当 ON-Bar 或 onsmsync 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
用途
缺省情况下，将在 UNIX 或 Linux 上的 $GBASEDBTDIR/etc 文件夹中创建 ON-Bar 引导
文件。此文件的缺省名称为 ixbar.servernum，其中servernum 是 SERVERNUM 配置参数的
值。
例如，对于 SERVERNUM 配置参数等于 41 的情况，在 UNIX 中，缺省情况下将使用此
路径和名称创建 ON-Bar 引导文件：
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 215 -
BAR_IXBAR_PATH $GBASEDBTDIR/etc/ixbarboot.41
您可以更改路径以在其他位置中创建该文件。例如，如果要在目录 /usr/gbasedbt 中使用名
称 ixbar.new 创建 ON-Bar 引导文件，请指定：
BAR_IXBAR_PATH=/usr/gbasedbt/ixbar.new
BAR_MAX_BACKUP 配置参数
使用 BAR_MAX_BACKUP 参数可指定每个 ON-Bar 命令允许的最大并行进程数。
onconfig.std 值
0
如果值不存在
4
单位
ON-Bar 进程
值
0 = 系统上允许的最大进程数
1 = 串行备份或恢复
n = 所创建进程的指定数量
生效
ON-Bar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
虽然数据库服务器的 BAR_MAX_BACKUP 缺省值是 4，但 onconfig.std 的值是 0。
UNIX™ 支持并行备份。
指定串行备份与恢复
要执行串行备份或恢复
（包括串行的整个系统备份或恢复）
，
请将 BAR_MAX_BACKUP 设
置为 1。
指定并行备份与恢复
要指定并行备份与恢复
（包括并行的整个系统备份与恢复）
，
请将 BAR_MAX_BACKUP 设
置为高于 1 的值。例如，如果将 BAR_MAX_BACKUP 设置为 5 并执行 ON-Bar 命令，
那么 ON-Bar 同时创建的最大进程数为 5。
BAR_MAX_BACKUP 最大可以配置为与存储设
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 216 -
备最大数或物理备份与恢复可用的最大流数相等。
ON-Bar 按并行资源有效使用的大小对数
据库空间进行分组。
如果将 BAR_MAX_BACKUP 设置为 0，系统将按照需要的数目创建 ON-Bar 进程。
ON-Bar 进程的数目只受存储空间的数目或数据库服务器可用内存大小的限制，
取两个值中
较小的一个。
可用内存大小基于 SHMTOTAL。
ON-Bar 执行以下计算，
其中 N 是允许执行的 ON-Bar 进
程的最大数目：
N = SHMTOTAL / (传送缓冲区数 * 传送缓冲区的大小 / 1024)
如果 SHMTOTAL 是 0，那么 BAR_MAX_BACKUP 将重置为 1。如果 N 大于
BAR_MAX_BACKUP，
那么 ON-Bar 将使用 BAR_MAX_BACKUP 的值。
否则，
ON-Bar 将
启动 N 个备份或恢复进程。
BAR_NB_XPORT_COUNT 配置参数
使用 BAR_NB_XPORT_COUNT 配置参数可指定每个 onbar_d 进程可以用来与数据库服
务器交换数据的数据缓冲区的数量。
onconfig.std 值
20
如果值不存在
20
单位
缓冲区
值的范围
3 到无穷大
生效
ON-Bar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
此参数的值将影响 ON-Bar 的性能。
例如，
如果将 BAR_NB_XPORT_COUNT 设置为 5 并
发出 5 个 ON-Bar 命令，那么生成的 25 个 ON-Bar 进程将总共使用 125 个缓冲区。
要计算每个 onbar_d 进程需要的内存大小，
请使用以下公式。
有关系统的页大小的信息，
请
参阅发行说明：
required_memory = (BAR_NB_XPORT_COUNT * BAR_XFER_BUF_SIZE
* page_size) + 5 MB
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 217 -
BAR_PERFORMANCE 配置参数
使用 BAR_PERFORMANCE 配置参数可指定性能统计信息的类型，以报告至备份与恢复
操作的 ON-Bar 活动日志。
onconfig.std 值
0
单位
统计信息的级别
值
0 = 不收集性能统计信息
1 = 报告在 GBase 8s 实例与存储管理器之间传输数据时所耗用的时间。
2 = 采用活动日志和错误日志中的时间戳记以微秒为单位报告 ON-Bar 处理性能
3 = 报告这两种微秒时间戳记并传输统计信息。
生效
ON-Bar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
用途
例如，如果将 BAR_PERFORMANCE 设置为 3，ON-Bar 将在活动日志中报告 GBase 8s
实例与存储管理器之间传输数据时所耗用的时间。如果将 BAR_PERFORMANCE 设置为
0 或不设置，ON-Bar 将不报告性能统计信息。
要关闭性能监视，请将该值设置为 0。这是缺省值。
要显示 GBase 8s 实例和存储管理器之间传输数据时所耗用的时间，请将该参数设
置为 1。
要显示时间戳记（以微秒计），请将该参数设置为 2。
要显示时间戳记和传输统计信息，请将该参数设置为 3。
BAR_PROGRESS_FREQ 配置参数
使用 BAR_PROGRESS_FREQ 配置参数可指定 ON-Bar 活动日志中出现备份与恢复操作
的进度消息的频率（以分钟为单位）。
onconfig.std 值
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 218 -
0
如果值不存在
0
单位
分钟
值的范围
0，然后是 5 到无穷大
生效
ON-Bar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
用途
示例：如果将 BAR_PROGRESS_FREQ 设置为 5，那么 ON-Bar 每 5 分钟报告一次该对
象的已备份或恢复的百分比。 如果将 BAR_PROGRESS_FREQ 设置为 0 或不设置该参
数，那么 ON-Bar 不将任何进度消息写入到活动日志中。
指定一个大于等于 5 分钟的值。
请不要将 BAR_PROGRESS_FREQ 设置为 1、
2、
3 或 4，
ON-Bar 会将其自动重置到 5 以防止 ON-Bar 活动日志溢出。
如果 ON-Bar 无法确定备份或恢复对象的大小，它将报告发送到数据库服务器的传送缓冲
区数，而不是报告对象已备份或恢复的百分比。
BAR_RETRY 配置参数
使用 BAR_RETRY 配置参数可指定如果第一次尝试失败，onbar 应该尝试数据备份、逻辑
日志备份或恢复操作的次数。
onconfig.std 值
1
如果值不存在
1
单位
整数
值的范围
0 = BAR_ABORT，停止备份/恢复的其余部分
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 219 -
1 = BAR_CONT，继续备份/恢复的其余部分
n = 2 到 32766
生效
ON-Bar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该
值时。
用途
BAR_RETRY 参数的设置按照以下方式确定 ON-Bar 的行为：
如果设置为 0 (BAR_ABORT)，
那么在存储空间或逻辑日志出错时，
ON-Bar 将停止
备份或恢复会话，返回错误并退出。如果 ON-Bar 以并行方式运行，那么已经运行
的进程将结束但是不启动新进程。
如果设置为 1 (BAR_CONT)，
那么 ON-Bar 将对该特定存储空间停止备份或恢复尝
试，返回错误，并尝试备份或恢复任何剩余的存储空间或逻辑日志。
如果设置为具体数字（重试备份与恢复操作 2 到 32766 次），那么 ON-Bar 将尝
试备份或恢复该存储空间或逻辑日志指定次数，
然后放弃尝试并继续到下一个存储
空间或逻辑日志。
BAR_SIZE_FACTOR 配置参数
在备份之前，使用 BAR_SIZE_FACTOR 配置参数来提高备份对象大小的估计值。
onconfig.std 值
0
值的范围
正整数
生效
数据库服务器启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
用途
此估计值在备份之前进行处理，并以特定方式进行计算，以便存储管理器可以相应分配存
储介质。由于备份是联机进行的，因此要备份的页数可能会在备份过程中发生变化。一些
存储管理器非常严格，如果备份估计值过低，备份会出现错误。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 220 -
在将 BAR_SIZE_FACTOR 值传达到存储管理器前，
BAR_SIZE_FACTOR 被视为是原有备
份对象大小的百分比加上估计值。
BAR_SIZE_FACTOR 只用于数据库空间备份对象，
不用
于逻辑日志备份对象。
计算新的估计备份对象大小的公式为：
new_estimate = original_estimate x (1 + (BAR_SIZE_FACTOR / 100))
在特定服务器环境中将此参数设为何值取决于在备份或归档期间系统上的活动。因此，要
确定值的大小需要根据个人对该系统的经验而论。
BAR_XFER_BUF_SIZE 配置参数
使用 BAR_XFER_BUF_SIZE 配置参数可指定每个传输缓冲区的大小。
onconfig.std 值
31（如果 PAGESIZE 是 2 千字节）
15（如果页面大小是 4 千字节）
单位
页数
ON-BAR 与 GBase 8s 主存储管理器 一起使用时的值的范围
1 - 32768
BAR_XFER_BUF_SIZE 的值以 GBase 8s 基页大小为单位。对于 Linux、Solaris 和
HP，GBase 8s 基页大小为 2K。
1 - 15 个页面（当 PAGESIZE 是 4 千字节时）
1 - 31 个页面（当 PAGESIZE 是 2 千字节时）
最大缓冲区大小是 64 千字节，因此 BAR_XFER_BUF_SIZE * 页面大小 <= 64 千字
节。
ON-BAR 与其他存储管理器一起使用时的值的范围
1 - 15（如果 GBase 8s 基页大小为 4 千字节）
1 - 31（如果 GBase 8s 基页大小为 2 千字节）
最大缓冲区大小是 64 千字节，因此 BAR_XFER_BUF_SIZE * 页面大小 <= 64 千字
节。
生效
ON-Bar 启动时
通过运行 onmode -wf 或等效 SQL 管理 API 命令在 onconfig 文件中动态重置该值
时。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 221 -
用途
数据库服务器将缓冲区传递到 ON-Bar 和存储管理器。
要计算存储空间或逻辑日志备份中传输缓冲区的大小，请使用以下公式：
一个传输缓冲区大小 = BAR_XFER_BUF_SIZE * 基页 pagesize
要计算数据库服务器对于每个传输缓冲区需要多少内存，请使用以下公式：
内存 = (BAR_XFER_BUF_SIZE * 基页 PAGESIZE) + 500
额外的 500 字节是系统开销。例如，如果 BAR_XFER_BUF_SIZE 为 15，那么传输缓冲
区应该为 61,940 字节。
传输缓冲区的数量（针对每个备份流）由 BAR_NB_XPORT_COUNT 指定，而并行备份流
的数量由 BAR_MAX_BACKUP 指定。
限制： 不能在备份与恢复之间更改缓冲区的大小。AC_TAPEBLOCK 和 AC_LTAPEBLOCK
的值需要与归档时的 BAR_XFER_BUF_SIZE 值相同。
例如，对于 Linux 上大小为 128*2048（值为 262144）的传输缓冲区，请指定：
BAR_XFER_BUF_SIZE 128
ISM_DATA_POOL 配置参数
ISM_DATA_POOL 配置参数（当在数据库服务器的 onconfig 文件中列出时）指定用于备
份存储空间的卷池。
onconfig.std 值
ISMData
生效
ON-Bar 启动时
用途
该参数的值可以是 Storage Manager 识别的任意卷池。如果此参数不存在，那么 Storage
Manager 使用 ISMData 卷池。有关详细信息，请参阅《GBase 8s Storage Manager 管理员
指南》。
ISM_LOG_POOL 配置参数
ISM_LOG_POOL 参数（当在数据库服务器的 onconfig 文件中列出时）指定用于备份逻辑
日志的卷池。
onconfig.std 值
ISMLogs
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 222 -
生效
ON-Bar 启动时
用途
该参数的值可以是 Storage Manager 识别的任意卷池。
如果此参数不存在，
那么 ISM 使用
ISMLogs 卷池。有关详细信息，请参阅《GBase 8s Storage Manager 管理员指南》。
LTAPEBLK 配置参数
使用 LTAPEBLK 配置参数可指定当使用 ontape 进行数据库空间备份时将逻辑日志备份到
的设备的块大小。
LTAPEBLK 还指定当使用 onload 或 onunload 的 -l 选项时将数据装入或卸载到的设备的
块大小。如果要使用 onload 或 onunload，那么可以在命令行中指定不同的块大小。
onconfig.std 值
在 UNIX™ 上：32
单位
千字节
值的范围
大于 (页面大小/1024) 的值
要获取页面大小，请运行 onstat -b 命令。
生效
对于 ontape：
当您执行 ontape 时。
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
将 LTAPEBLK 指定为磁带设备所允许的最大块大小。当您指定块大小时，数据库服务器
不检查磁带设备。验证 LTAPEDEV 磁带设备是否可以读取所指定的块大小。如果不能，
您可能无法读取磁带。
仅限 UNIX：UNIX dd 实用程序可以验证 LTAPEDEV 磁带设备是否可以读取块大小。大
多数 UNIX 系统都提供了该实用程序。
如果指定 LTAPEBLK 值，那么 ON-Bar 将忽略该值。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 223 -
LTAPEDEV 配置参数
使用 LTAPEDEV 配置参数可指定当使用 ontape 进行备份时将逻辑日志备份到的设备或
目录文件系统。
LTAPEDEV 配置参数还指定当使用 onload 或 onunload 的 -l 选项时将数据装入或卸载
到的设备。如果要使用 LTAPEDEV 指定用于 onunload 或 onload 的设备，那么
TAPEDEV 的相同信息对于 LTAPEDEV 也相关。
onconfig.std 值
在 UNIX™ 上：/dev/tapedev
如果不存在
在 UNIX 上：/dev/null
生效
对于 ontape：
当执行 ontape 时，设置为磁带设备的情况下。
当数据库服务器关闭并重新启动时，在 UNIX 上设置为 /dev/null 的情况下。
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
警告： 当您使用 ON-Bar 备份逻辑日志时，请勿将 LTAPEDEV 设置为 /dev/null 或 nul。
如果在 LTAPEDEV 配置参数中指定磁带设备，那么 ON-Bar 将忽略该值。
重要：
仅当不需要备份逻辑日志时，
才将 LTAPEDEV 设置为 /dev/null 或保留为空白
（UNIX
上）。将 LTAPEDEV 的值更改为 /dev/null 之前，必须使数据库服务器处于脱机状态。
当您将 LTAPEDEV 设置为 /dev/null 时：
数据库服务器将释放逻辑日志，而不要求您备份这些日志。虽然逻辑日志未被标记
为已释放，但数据库服务器可以重用它们。
ON-Bar 活动日志将显示警告和返回码 152。由于数据库服务器把不再是当前的逻
辑日志标记为已备份的日志，
所以 ON-Bar 找不到要备份的逻辑日志。
那些日志中
的所有事务都将丢失，并且无法恢复。
如果在 LTAPEDEV 设置为空 (null) 的情况下执行整个系统的备份，必须在恢复期间使用
onbar -r -w -p 命令通知 ON-Bar 不需要恢复日志。.
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 224 -
LTAPESIZE 配置参数
使用 LTAPESIZE 配置参数可指定当使用 ontape 进行备份时将逻辑日志备份到的设备的
最大磁带大小。
LTAPESIZE 配置参数还指定当使用 onload 或 onunload 的 -l 选项时将数据装入或卸载到的
设备的最大磁带大小。如果要使用 onload 或onunload，那么可以在命令行上指定不同的磁
带大小。如果要使用磁带的全部容量，请将 LTAPESIZE 设置为 0。
onconfig.std 值
0
单位
千字节
值的范围
0 或任何正数。真实值依赖于操作系统。
生效
对于 ontape：
当您执行 ontape 时。
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
LTAPESIZE 指定当使用 ontape 进行备份时将逻辑日志备份到的设备的最大磁带大小。
LTAPESIZE 还指定当使用 onload 或 onunload 的 -l 选项时将数据装入或卸载到的设备的最
大磁带大小。如果要使用 onload 或 onunload，那么可以在命令行上指定不同的磁带大小。
如果要使用磁带的全部容量，请将 LTAPESIZE 设置为 0。
注：
如果在 ONCONFIG 文件中设置 BACKUP_FILTER 参数，
那么 LTAPESIZE 无法设置为
0。否则，在将逻辑日志备份到磁盘上的目录时，ontape 实用程序会返回错误。错误消息为：
当已设置 BACKUP_FILTER 配置参数时，LTAPESIZE 配置
参数无法设置为 0；请更改 LTAPESIZE 的值。
程序结束。
变通方法是将 LTAPESIZE 配置参数设置为非常高的值。日志文件不会大幅高于
LOGSIZE 配置参数。使用 LOGSIZE 中的值作为此数据库的上限。
如果指定 LTAPESIZE 值，那么 ON-Bar 将忽略该值。
RESTARTABLE_RESTORE 配置参数
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 225 -
使用 RESTARTABLE_RESTORE 配置参数来启动或禁用可重新开始的恢复。
onconfig.std 值
RESTARTABLE_RESTORE ON
值
禁用
禁用可重新开始的恢复。如果恢复失败并且 RESTARTABLE_RESTORE 为 OFF，那么您
无法重新启动该恢复。
启用
启用可重新开始的恢复。开始恢复前将 RESTARTABLE_RESTORE 设置为 ON。否则，
您将无法在失败后重新启动恢复。
生效
编辑 onconfig 文件后。如果需要重新启动物理恢复，那么不需要在可以使用
RESTARTABLE_RESTORE 之前重新启动数据库服务器。 如果需要重新启动逻辑恢复，
那么必须在使用可重新开始的恢复前重新启动数据库服务器。
打开 RESTARTABLE_RESTORE 将降低逻辑恢复的性能。有关更多信息，请参阅 onbar
-RESTART 语法：重新启动失败的恢复。
RESTORE_FILTER 配置参数
使用 RESTORE_FILTER 配置参数可指定过滤器程序的路径名以及任何选项。
onconfig.std 值
未设置。恢复的数据未过滤。
值
命令的路径名和任何选项。缺省情况下，路径名相对于 $GBASEDBTDIR/bin 目录，
否则，路径名必须是程序的绝对路径。 如果您要包括命令行选项，那么必须使用单引
号括住过滤器名称和选项。
生效
编辑 onconfig 文件，并且 ON-Bar 或 ontape 启动后。
用途
此过滤器在恢复之前，将备份期间变换的数据变换至其原始格式。 RESTORE_FILTER 配
置参数指定的过滤器必须与 BACKUP_FILTER 配置参数指定的过滤器相匹配。例如，如
果在备份期间压缩了数据，那么必须在恢复期间解压缩该数据。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 226 -
为了安全，过滤器不能有非特权用户写许可权。该过滤器的许可权与 GBase 8s 服务器或
实用程序所调用的其他可执行文件的许可权相同。
例如，如果您要压缩备份的数据，可以将 BACKUP_FILTER 和 RESTORE_FILTER 配置
参数设置为以下值：
BACKUP_FILTER /bin/compress
RESTORE_FILTER /bin/uncompress
RESTORE_FILTER 配置参数可包括命令行选项以及过滤器名称。例如，指定：
RESTORE_FILTER
‘my_decrypt –file /var/adm/encryption.pass'
在此示例中，引号中的命令用作过滤器。
TAPEBLK 配置参数
使用 TAPEBLK 配置参数可指定 ontape 在存储空间备份期间所写入的设备的块大小。
onconfig.std 值
在 UNIX™ 上：32
单位
千字节
值的范围
大于 页面大小/1024 的值
要获取页面大小，请运行 onstat -b 命令。
生效
对于 ontape：
当您执行 ontape 时。
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
TAPEBLK 还指定了当使用 onload 或 onunload 实用程序时将数据装入或卸载到的设备
的缺省块大小。如果要使用 onload 或 onunload，那么可以在命令行上指定不同的块大小。
当您指定块大小时，数据库服务器不检查磁带设备。验证 TAPEBLK 磁带设备是否可以读
取您所指定的块大小。如果不能，您可能无法读取磁带。
如果指定 TAPEBLK 值，那么 ON-Bar 将忽略该值。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 227 -
TAPEDEV 配置参数
使用 TAPEDEV 配置参数可指定 ontape 实用程序将存储空间备份到的设备或目录文件系
统。
onconfig.std 值
在 UNIX™ 上：/dev/tapedev
如果不存在
在 UNIX 上：/dev/null
单位
路径名
生效
对于 ontape 实用程序：
如果在 UNIX 上设置为 /dev/null ，那么当数据库服务器关闭并重新启动时
如果设置为磁带设备，那么当您运行 ontape 实用程序时
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
对于 onload 和 onunload 实用程序：当数据库服务器关闭并重新启动时
用途
开始处理时，ontape 实用程序读取 TAPEDEV 参数的值。如果您将 TAPEDEV 设置
为 /dev/null，必须在启动 ontape 以请求备份之前进行此设置。当您将 TAPEDEV 设置
为 /dev/null 并请求备份时，数据库服务器将忽略该备份，但仍使用新的备份时间戳记更新
数据库空间。
您可以将 TAPEDEV 配置参数设置为 STDIO，以指示 ontape 实用程序对标准 I/O 而不是
设备执行备份与恢复操作。
TAPEDEV 配置参数还指定了当使用 onload 或 onunload 实用程序时将数据装入或卸载到
的缺省设备。 但是，如果 TAPEDEV 设置为 STDIO，那么 onunload 实用程序将无法卸载
数据。
如果更改磁带设备，请验证新设备的 TAPEBLK 和 TAPESIZE 配置参数值是否正确。
如果指定 TAPEDEV 值，那么 ON-Bar 将忽略该值。
远程设备 (UNIX)
在网络中执行存储空间备份时，可以备份到与 UNIX 和 Linux™ 平台上另一个主机相连的
远程设备。
远程设备和数据库服务器计算机必须具有信任关系，
以便 rsh 或 rlogin 实用程序
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 228 -
从数据库服务器计算机连接到远程设备计算机，而无需询问密码。您可以通过在远程设备
计算机上配置/etc/hosts.equiv 文件、用户的 ~/.rhosts 文件或您系统的任何等效机制，从而建
立信任关系。如果想要使用您的平台所使用的缺省实用程序之外的其他实用程序来处理
远程会话，那么可以将 DBREMOTECMD 环境变量设置为要使用的特定实用程序。
远程设备的符号链接 (UNIX)
TAPEDEV 配置参数可以是符号链接，从而允许您在磁带设备之间切换，而不必更改
TAPEDEV 配置参数指定的路径名。
请使用以下语法指定连接到另一台主机上的磁带设备：
host_machine_name:tape_device_pathname
以下示例指定主机 kyoto 上的磁带设备：
kyoto:/dev/rmt01
打开前和关闭时将磁带设备倒带
TAPEDEV 配置参数指定的磁带设备必须在其打开前和关闭时执行倒带。数据库服务器要
求执行该操作，因为它在写入磁带之前要执行一系列检查。
当数据库服务器尝试写入多卷数据库空间或逻辑日志备份中第一盒磁带之外的任何磁带
时，数据库服务器首先读取磁带头以确保该磁带可供使用。然后设备将关闭并重新打开。
数据库服务器假定磁带在关闭时已倒带，然后数据库服务器开始写入。
每当数据库服务器尝试读取磁带时，它首先读取头并查找正确的信息。在写入过程中，如
果磁带设备未在关闭时倒带，那么数据库服务器在磁带开头处将找不到正确的头信息。
TAPESIZE 配置参数
使用 TAPESIZE 参数指定 ontape 将存储空间备份到的设备的大小。
onconfig.std 值
0
单位
千字节
值的范围
0 或任何正数。真实值依赖于操作系统。
生效
对于 ontape：
当您执行 ontape 时。
GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 229 -
通过运行 onmode -wf 命令在 onconfig 文件中动态重置该值时。
通过运行 onmode -wm 命令重置会话的值时。
对于 onload 和 onunload：当数据库服务器关闭并重新启动时
用途
TAPESIZE 还指定使用 onload 或 onunload 时将数据装入或卸载到的缺省设备的大小。
如
果要使用 onload 或 onunload，那么可以在命令行上指定不同的磁带大小。如果要使用磁
带的全部物理容量，请将 TAPESIZE 设置为 0。
注： 如果 TAPEDEV 设置为 STDIO，那么将与磁带大小无关。
如果指定 TAPESIZE 值，那么 ON-Bar 将忽略该值。
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 134
-
对于在系统目录中定义的命名的行类型，
ClassGenerator 实用程序生成 Java™ 类。
该实用程
序是对 JDBC 规范的 GBase 8s 扩展。
创建了的 Java 类实现 java.sql.SQLData 接口。对于命名的行中每一字段，该类都有成员。
按照出现在数据库中命名的行类型定义中的顺序，readSQL()、
writeSQL() 和 SQLData.readSQL() 方法读取属性。类似地，writeSQL() 按该顺序将数据写至
流。
将 ClassGenerator 打包在 ifxtools.jar 文件中，因此，CLASSPATH 环境变量必须指
向 ifxtools.jar。
使用 ClassGenerator 的语法如下：
java ClassGenerator rowtypename [-u URL] [-c classname]
classname 的缺省值是 rowtypename 的值。
如果未指定 URL 参数，则从 home 目录中的 setup.std 文件检索所需的信息。
setup.std 的结构如下：
URL jdbc:host-name:port-number
gbasedbtserver gbasedbtservername
database database
user user
passwd password
简单命名的行示例
要使用 ClassGenerator，请首先在数据库服务器上创建命名的行，如此示例中所示：
create row type employee (name char (20), age int);
接下来，运行 ClassGenerator：
java ClassGenerator employee
该类生成器生成 employee.java，如后所示，并从 setup.std 检索数据库 URL 信息，其有下
列内容：
URL jdbc:davinci:1528
database test
user scott
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 135
-
passwd tiger
gbasedbtserver picasso_ius
下列为生成了的 .java 文件：
import java.sql.*;
import java.math.*;
public class employee implements SQLData
{
public String name;
public int age;
private String sql_type;
public String getSQLTypeName() { return "employee"; }
public void readSQL (SQLInput stream, String type) throws
SQLException
{
sql_type = type;
name = stream.readString();
age = stream.readInt();
}
public void writeSQL (SQLOutput stream) throws SQLException
{
stream.writeString(name);
stream.writeInt(age);
}
}
嵌套的命名的行示例
对于嵌套的行，要使用 ClassGenerator，请首先在数据库服务器上创建命名的行：
create row type manager (emp employee, salary int);
接下来，运行 ClassGenerator。在此情况下，不查询 setup.std 文件，因为您在命令行提供了
所有需要的信息：
java ClassGenerator manager -c Manager -u "jdbc:davinci:1528/test:user=scott;
password=tiger;gbasedbtserver=picasso_ius"
-c 选项定义您正在创建的 Java™ 类，其为 Manager（带有大写的 M）。
前面的命令生成下列 Java 类：
GBase 8s JDBC Driver 程序员指南
南大通用数据技术股份有限公司
- 136
-
import java.sql.*;
import java.math.*;
public class Manager implements SQLData
{
public employee emp;
public int salary;
private String sql_type;
public String getSQLTypeName() { return "manager"; }
public void readSQL (SQLInput stream, String type) throws
SQLException
{
sql_type = type;
emp = (employee)stream.readObject();
salary = stream.readInt();
}
public void writeSQL (SQLOutput stream) throws SQLException
{
stream.writeObject(emp);
stream.writeInt(salary);
}
}