返回首页

gbase数据、南大通用产品文档:GBase8sONBar 组件

更新日期:2024年09月11日

ON-Bar 组件包含命令行实用程序、目录表、活动日志和紧急引导文件。请将 ON-Bar 与存
储管理器及其 XBSA 共享库一起使用。
下图显示了 ON-Bar 和数据库服务器组件:

数据库服务器中的存储空间(数据库空间、Blob 空间和智能大对象空间)以及逻
辑日志

sysutils 数据库,其中包含 ON-Bar 目录表

onbar 和 onbar-d 命令行实用程序

系统上存储管理器的 XBSA 共享库

用于存储备份的存储介质

ON-Bar 活动日志

ON-Bar 紧急引导文件
图: GBase 8s 的 ON-Bar 组件

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 19 -



ON-Bar 与数据库服务器和存储管理器进行通信。请使用 onbar 命令启动备份或恢复操作。
缺省情况下,ON-Bar 以并行方式备份和恢复存储空间。ON-Bar 始终以串行方式处理日志
文件。
对于备份会话,ON-Bar 从数据库服务器请求存储空间和逻辑日志的内容,并将它们传递
到存储管理器。存储管理器将数据存储在存储介质上。对于恢复会话,ON-Bar 从存储管
理器请求已备份的数据,然后在数据库服务器上恢复该数据。
ON-Bar 首先备份关键数据库空间,接着是剩余存储空间,最后备份逻辑日志。关键数据
库空间是 rootdbs 以及包含逻辑日志和物理日志的数据库空间。
ON-Bar 还会在备份期间将以下关键文件放到归档中:

onconfig 文件

sqlhosts 文件

oncfg_servername.servernum 文件

ON-Bar 紧急引导文件:ixbar.servernum
您可以恢复存储在原始文件和格式化文件中的存储空间。如果系统包含主存储空间和镜像
存储空间,那么恢复(外部恢复除外)期间 ON-Bar 将同时写入主块和镜像块。

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 20 -

ON-Bar 状态和错误消息将写入活动日志文件 bar_act.log 中。

备份服务 API (XBSA)
ON-Bar 和存储管理器通过“备份服务应用程序编程接口 (XBSA)”通信,该接口支持存
储管理器为数据库服务器管理介质。通过使用存储管理器的开放式系统接口,ON-Bar 可
以与各种同样使用 XBSA 的存储管理器一起工作。
每个存储管理器建立并分配一个唯一版本的 XBSA 共享库。必须使用随存储管理器提供
的 XBSA 共享库版本。例如,如果使用 GBase 8s 主存储管理器,那么还必须使用 ON-
Bar 提供的 XBSA 共享库。ON-Bar 和 XBSA 共享库必须以相同方式(32 位或 64
位)进行编译。例如,如果使用 Storage Manager,那么还要使用 ON-Bar 提供的 XBSA
共享库。ON-Bar 和 XBSA 共享库必须以相同方式(32 位或 64 位)进行编译。
ON-Bar 使用 XBSA 与存储管理器交换以下类型的信息:
控制数据
ON-Bar 与存储管理器交换控制数据以验证 ON-Bar 和 XBSA 是否兼容,并确保以
正确顺序将对象恢复到数据库服务器的正确实例,以及跟踪备份对象的历史记录。
备份或恢复数据
在备份与恢复期间,ON-Bar 和存储管理器使用 XBSA 交换来自指定存储空间或逻
辑日志文件的数据。
ON-Bar 使用 XBSA 事务来确保数据的一致性。包含在一个事务中的所有操作被看作是
一个单元。一个事务中的所有操作必须成功,才能恢复传送给存储管理器的对象。

ON-Bar 目录表
ON-Bar 使用 sysutils 数据库中的目录表来跟踪备份与恢复操作。 onsmsync 实用程序使
用其他目录表来跟踪其操作。
ON-Bar 在 sysutils 数据库中使用以下目录表来跟踪备份与恢复操作:

bar_server 表跟踪数据库服务器的实例。

bar_object 表跟踪备份对象。 备份对象是数据库空间、Blob 空间、智能大对象
空间或逻辑日志文件的备份。

bar_action 表跟踪所有对每个备份对象进行的备份与恢复尝试,除了某些日志回
收和冷恢复事件以外。

bar_instance 表描述在成功的备份尝试中备份的每个对象。
onsmsync 实用程序使用并维护以下各表来跟踪其操作:

bar_ixbar 表包含所有时间线中所有未到期的成功备份的历史记录。

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 21 -


bar_syncdeltab 表通常为空,但 onsmsync 正在运行时除外。
有关这些表内容的描述,请参阅 ON-Bar 目录表。

ixbar 文件:ON-Bar 紧急引导文件
每次备份后会自动更新紧急引导文件。该文件包含 ON-Bar 执行冷恢复所需的信息。
重要: 请勿修改紧急引导文件。如果进行了修改,将可能导致 ON-Bar 选择错误的备份作为
恢复的一部分,这可能会引起数据损坏或系统故障。
引导文件的文件名是 ixbar.servernum,其中 servernum 是 SERVERNUM 配置参数的
值。
ON-Bar 紧急引导文件位于 UNIX™ 上的 $GBS_HOME/etc 目录中。您可以更改
BAR_IXBAR_PATH 配置参数中指定的信息,从而覆盖引导文件的缺省路径和名称。

bar_act.log 文件:ON-Bar 活动日志
ON-Bar 将参考、进度、警告、错误和调试消息写入 ON-Bar 活动日志 bar_act.log 中。
ON-Bar 备份和恢复错误不会出现在标准输出中。如果在您备份和恢复数据时发生错误,
请检查 ON-Bar 活动日志中的信息
还可以使用活动日志进行以下操作:

监视备份与恢复活动,例如,活动日志还将记录哪些存储空间和逻辑日志已备份
或已恢复、操作的进度以及大致花了多长时间。

验证备份或恢复是否成功。

跟踪 ondblog 实用程序中的错误。

跟踪 ON-Bar 性能统计信息
ON-Bar 活动日志位于 UNIX™ 上的 /tmp 目录中。使用 BAR_ACT_LOG 配置参数指定
ON-Bar 活动日志的位置。

ON-Bar 脚本
ON-Bar 实用程序在 UNIX™ 上包含一个 shell 脚本,用于定制备份与恢复操作。
当您随数据库服务器安装 ON-Bar 时,将包含一个缺省脚本。该脚本的名称和位置取决于
操作系统:
UNIX
onbar shell 脚本位于 $GBS_HOME/bin 目录中。
当从命令行发出 ON-Bar 命令时,自变量会传递给脚本,然后传递给 onbar_d 实用程序。

GBase 8s 备份与恢复指南
南大通用数据技术股份有限公司 - 22 -

表 1. ON-Bar 实用程序
实用程序
描述
onbar_d 实用程序
在数据库服务器和存储管理器之间传输数据。
onbar 命令会调用 onbar_d 实用程序,以启动 onbar-
driver。 onbar-driver 启动并控制备份与恢复活动。
onsmsync 实用程序
同步 sysutils 数据库、紧急引导文件和存储管理器目录的内
容。使用此实用程序以清除不再需要的备份。
ondblog 实用程序
更改数据库日志记录方式。ondblog 实用程序将其输出记录
到 ON-Bar 活动日志 bar_act.log 中。
archecker 实用程序
验证备份,并从归档恢复表级别数据。

如果您在连接时没有指定数据库名称,则连接必须使用正确的指定数据库
的 DB_LOCALE 值打开。
如果关闭数据库并发出了数据库 dbname 语句,则连接继续使用初始的 DB_LOCALE 值解
释数据库名称。如果新数据库的 DB_LOCALE 值不符合,则返回错误。在此情况下,客户
端程序必须关闭,并使用正确的新数据库的 DB_LOCALE 值重新打开连接。
如果您在连接时提供数据库名称,则 DB_LOCALE 值必须设置为正确的数据库语言环境。

可以通过使用 NEWCODESET 和 NEWLOCALE 连接属性定义语言环境,来连接到 NLS
数据库。有关它们的格式,请参阅 Connecting with the NEWLOCALE and NEWCODESET
Environment Variables 。

操作步骤
请在执行下面的安装步骤前先获取license 文件。
步骤1 :获取安装包并解压:
1.
复制安装包到文件系统的某个目录下,拷贝命令参考如下:
# cp
/tmp/GBase8a_MPP_Cluster-NoLicense-9.5.3.17-redhat7.3-x86_64.tar.bz2
/opt
2.
进入该目录,在命令行模式下使用tar 命令进行解压。解压命令如下:
#cd /opt
# tar xjf
GBase8a_MPP_Cluster-NoLicense-9.5.3.17-redhat7.3-x86_64.tar.bz2
3.
解压后,将会在解压目录下生成gcinstall 目录:
# ls /opt
gcinstall
步骤2 :创建DBA 用户并配置权限
1.
使用操作系统root 用户在所有集群节点服务器上创建DBA 用户。
安装示例中DBA 用户以gbase 为例,
本手册中不做特殊说明均默认以gbase 为DBA
用户。
# useradd gbase
# passwd gbase

GBase 8a MPP Cluster 产品手册
3 集群安装升级与卸载
文档版本953(2022-04-10)
南大通用数据技术股份有限公司
62
2.
使用root 用户将gcinstall 目录属主更改为DBA 用户
# chown –R gbase:gbase gcinstall
3.
使用root 用户将安装目录的属主更改为DBA 用户
安装目录是由demo.options 文件中installPrefix 参数指定的软件安装目录,默认是
/opt
# chown –R gbase:gbase /opt
4.
使用root 用户在所有节点上给DBA 用户赋予安装GBase 相关的权限
使用root用户将gcinstall目录下的SetSysEnv.py文件拷贝到集群所有节点服务器上,
并执行该文件。
# scp SetSysEnv.py
root@192.168.146.21:/opt
# /opt/SetSysEnv.py
--dbaUser=gbase --installPrefix=/opt
SetSysEnv.py 语法说明:
# python SetSysEnv.py --dbaUser=* --installPrefix=* [--cgroup]
步骤3:切换到DBA 用户,并修改安装配置文件参数。
进入解压后的gcinstall 目录,
根据实际的集群环境修改安装参数文件demo.options,
具体操作如下:
#su - gbase
$ vi /opt/gcinstall/demo.options
installPrefix= /opt
coordinateHost = 192.168.146.20,192.168.146.21,192.168.146.22
参数名称


--installPrefix=INSTALLPREFIX
用户可配安装目录,必须为demo.options 中
installPrefix。集群日志按归档功能使用该参数。
--dbaUser=DBAUSER
必须为demo.options 中的dbaUser。
--cgroup
使用资源管理功能时,主要用于修改资源管理配
置文件。在使用资源管理前必须执行。
注意
安装之前,需要在gcluster 节点和gnode 节点上使用root 用户执行安装包中提供的一键
部署脚本SetSysEnv.py。如果GCware 节点独立部署在单独的服务器上,GCware 节
点不需要执行SetSysEnv.py 文件。
1.
将该脚本拷贝到要安装集群的各个节点,每个节点都需要使用root 执行;
2.
集群各个节点在安装之前,必须存在集群的安装用户,且拥有安装目录的
读写权限

GBase 8a MPP Cluster 产品手册
3 集群安装升级与卸载
文档版本953(2022-04-10)
南大通用数据技术股份有限公司
63
coordinateHostNodeID = 20,21,22
dataHost =