1.1 信息收集

在规划与准备使用CBR备份Kingbase数据库之前，请您先获取参考文档了解相关内容并收集Kingbase数据库所在生产机信息。

1.1.1 文档下载

为防止操作被中断，建议您提前下载好以下的文档：

《云备份 CBR 实施指导》

《云备份 CBR 公共管理用户指南》

《云备份 CBR 软件兼容性列表》

《云备份 CBR 限制性列表》

《云备份 CBR 定时数据保护重复数据删除用户指南》

《云备份 CBR 工具使用指导》

1.1.2 生产机信息收集

为防止操作被中断，建议您提前收集好后续操作要使用的Kingbase 数据库所在生产机信息。

表1-1 信息收集

编号	信息项	目的
1	Kingbase 数据库的操作系统版本与数据库版本。	确保要备份的Kingbase数据库已在兼容性列表支持。

 

1.2 基础配置

在使用 CBR 进行 Kingbase 数据库备份与恢复前，为确保可以正常备份，请您先配置基础项。

基础配置包括：检查管理控制台服务状态、外接客户端接入管理控制台、添加并激活授权码、配置备份存储数据 IP、配置各种卷以及配置用户权限等。

注意：

l  发起恢复时，可以不需要添加授权码。

l  基础信息配置的具体方法参阅《云备份 CBR 实施指导》和《云备份 CBR 公共管理用户指南》。

l  备份Kingbase 数据库时，需要生产机在线。

l  准备客户端前请您先仔细阅读《云备份 CBR 软件兼容性列表》，保证客户端在兼容列表中。

1.3 Kingbase定时备份恢复支持功能

表1-2 Kingbase定时数据保护支持功能

功能	子功能	支持	备注
备份	完全备份	√	-
	增量备份	√	-
	备份粒度	√	单个实例
数据保留策略	按时间保留	√	-
	按副本数保留	√	-
	按备份策略的备份周期设置副本保留策略	√	-
	多通道	√	-
删除归档日志	-	√	-
传输与存储加密	-	√	-
数据压缩	-	√	-
流量控制	-	√	-
重复数据删除	-	√
自定义脚本	-	√
多通道	-	√	通道数为1~8
备份自动重试	-	√
强制数据保留	-	√
只从备机备份	-	√	仅支持Kingbase集群
只从主机备份	-	√	仅支持Kingbase集群
优先从备机备份	-	√	仅支持Kingbase集群
优先从主机备份	-	√	仅支持Kingbase集群
恢复	原机原位置恢复	√	-
	原机异位置恢复	√	-
	异机原位置/异位置恢复	√	-
	开启覆盖现有数据库	√	-
	自定义脚本	√	-
	不完全恢复	√	支持指定时间点与指定Xid恢复
	开启自动联机	√	-
	多通道	√	通道数为1~8
日志	-	√	-
告警	-	√	-
远程复制	-	√	-
反向复制	-	√	-
内外网	-	√	-

 

1.4 限制性列表

1.4.1 备份

l   不支持删除非当前归档路径下的归档日志（若归档日志更改过路径，请手动删除旧归档路径下的归档日志）。

l   不支持归档路径与数据路径在同一个路径。

l   如果手动删除了归档路径下的日志，发起增量备份，可能会有日志缺失。若手动删除过日志，请手动发起完全备份。

l   不支持对备份任务的实例路径下重新初始化的实例继续发起增量备份，如果需要备份，请手动发起完全备份或者删除任务重建。

l   不支持多个实例归档日志在同一个路径下，可能会造成日志错乱，备份数据错误。

l   不支持普通用户对Kingbase数据库进行备份。

l   不支持对更改过端口号的实例继续备份。

l   Kingbase数据库不支持存在开启加密或压缩的表的实例的备份。

 

1.4.2 恢复

l   不支持备份数据恢复到只读目录下。

l   不支持恢复到异用户。

l   不支持多个任务同时恢复同一路径，可能会导致数据丢失。

l   不支持跨大数据库版本恢复。

l   不支持跨操作系统平台恢复（如：Linux平台与Windows平台间的恢复）。

l   仅支持企业版授权的不完全时间点恢复。

l   不支持上个增备到下个完备区间内的时间点恢复。

 

1.5 客户端安装及配置

1.5.1 客户端安装部署

首先需要安装客户端，请参照《云备份 CBR 客户端软件安装卸载用户指南》。

1.5.2 管理客户端

客户端安装成功后，您可以对客户端执行以下操作：查看外接客户端、编辑外接客户端、分配外接客户端、收回外接客户端。请参照《云备份 CBR 实施指导》。

1.6 备份前置准备

1.6.1 环境前置检查

为确保备份任务能够顺利进行，在新建备份任务前，需要按照以下步骤去检查环境是否达到备份的要求。

操作步骤

                                步骤 1     检查实例状态是否运行。

在进行Kingbase数据库备份时，要求实例必须处在开启状态。

检查方法为登录Linux系统后台，在Kingbase数据库用户（如kingbase）下执行以下命令查看实例状态，若显示running或者正在运行服务器进程，则代表实例正在运行。

sys_ctl -D /kingbase/data/data status

---查看实例状态，其中/kingbase/data/data为实例数据路径

sys_ctl -D /kingbase/data/data start  ---启动实例

sys_ctl -D /kingbase/data/data stop  ---关闭实例

ksql -p 54321 -Ukingbase -Weisoo.com123 TEST   ---连接系统自带数据库TEST

其中，端口号与数据路径请按实际情况填写。

注意：如果数据库实例服务处于停止状态，请协调用户系统管理员，将数据库实例服务开启至正在运行后再进行备份，对于正常提供生产业务的数据库来说，数据库实例服务肯定是运行状态，否则无法提供业务。

                                步骤 2     检查实例端口号是否配置，默认端口号为54321。设置实例端口号，进入实例数据目录，编辑kingbase.conf文件，设置实例端口号与监听。

listen_addresses = '*'     ---表示监听所有地址

port = 54321  ---表示监听54321端口，可设置成其他端口号

max_connections = 100  ---表示最大连接数为100。

                                步骤 3     设置开启归档日志与指定归档日志路径。

A、 自定义归档配置

wal_level = replica     #除minimal不支持，可根据实际等级设置

archive_mode = on    #可设置成on，always

archive_command = 'cp %p /kingbase/data/arch/%f'

注意：/kingbase/data/arch/表示要存放归档日志（WAL日志）的路径，该路径必须存在，且kingbase用户有读写权限（如：实例授权用户为数据库用户 kingbase ，则此路径的属主应该为 kingbase 用户）。

B、RMAN格式归档配置

此版本已支持开启以sys_rman内部备份进行归档的实例备份，sys_rman配置由sys_rman初始化生成。

注意：

l  修改完kingbase.conf配置文件，需要重新启动数据库服务。

l  支持sys_rman备份压缩归档日志。

l  支持清理sys_rman方式下归档的归档日志。

l  不支持sys_rman与cp方式自定义配置归档同时配置的备份恢复。

 

 

                                步骤 4     若需要开启实例登录密码免密验证，则编辑data目录下的sys_hba.conf文件，将METHOD的值改为trust。

注意：

l  修改完配置文件，需要重新启动数据库服务；

l  此选项建议不要修改成免密登录；

l  默认METHOD值为md5，若改为trust，数据库实例授权时，不会验证用户名、密码正确性，即使使用错误的用户名密码，授权状态为成功，不会有错误提示。

                                步骤 5     Kingbase集群状态检查：

执行repmgr cluster show，查看集群状态。

----结束

1.7 客户端实例授权

                                步骤 1     操作员登录，单击【资源】→ 【客户端】，进入客户端管理页面，选择需要备份的主机，单击【权限配置】，选择Kingbase数据库图标，选择用户。

                                步骤 2     选择用户后，单击展开数据源单击【添加实例】或者列表已经展示的实例右侧的【未授权按钮】，输入用户名（用户名必须是超级用户，如下图数据库用户kingbase）与密码，给实例授权。

若客户端实例已处于运行状态，但展开数据源之后无法发现实例，可手动添加实例。单击【添加实例】按钮，按要求填写实例名、用户名与密码。实例名格式为数据库用户: Kingbase_端口号（端口号根据实际端口号填写）， 如kingbase:KingBase_54321。用户名密码按照实际情况填写。

                                步骤 3     实例授权成功后展示如下。

注意：

l  若客户端未安装netstat或者数据库用户（如kingbase）下没有netstat执行权限时，在授权时，展开数据源不会自动发现实例，需要手动进行添加；可在客户端数据库用户下（kingbase）直接执行netstat命令查看是否拥有此命令以及执行权限。

l  若配置了密码验证，用户名密码必须填写正确，否则授权失败；

l  普通用户可以授权成功，但是执行备份任务会失败，授权时请用超级用户授权。

l  授权用户必须是已存在的操作系统用户（如kingbase），且是数据库的超级用户（如kingbase），并且这两个用户是同一个用户，否则备份任务会执行失败。

----结束

1.8 Kingbase集群客户端管理

                                步骤 1     操作员登录，单击【资源】→ 【客户端】，进入客户端管理页面，单击【新建虚拟客户端】，选择【Kingbase主备集群虚拟客户端】：

                                步骤 2     在新建虚拟客户端页面，填写虚拟客户端名称，勾选集群下的物理客户端，单击【创建】；

                                步骤 3     查看新建好的虚拟客户端。

                                步骤 4     删除虚拟集群客户端。选择创建好的虚拟集群客户端，单击【删除】，在文本框输入“YES”，单击【确定】。

----结束

1.9 授权 FAQs

l   Q1：数据源授权时，展开实例时，界面报错：检测实例失败，可能原因：1、环境未安装netstat。2、所选用户下没有运行中的KingBase实例。

【问题原因】：

1.         生产机不存在netstat工具。

2.         所选用户下没有运行中的Kingbase实例。

【解决方案】：

1.         单击添加实例按钮，参照《云备份 CBR Kingbase备份恢复用户指南》，手动添加实例即可。或者手动安装netstat工具并赋予s权限。

2.         按照用户指南，检查实例状态是否为运行中。

l   Q2：数据源授权时，展开实例时，界面报错：授权实例失败，可能原因：netstat未设置强制位（S权限）。

【问题原因】：生产机存在netstat工具但普通用户没有S权限。

【解决方案】：root用户下执行chmod +s /usr/bin/netstat。然后在kingbase用户下执行netstat 命令，查看命令是否正常执行。

l   Q3：数据源授权时，展开实例时，界面报错：展开数据源失败。原因是：初始化服务组件失败，请检查ODBC驱动是否存在。

【问题原因】：生产环境未安装ODBC驱动。

【解决方案】：按照用户指南《云备份 CBR Kingbase 备份恢复用户指南》中规划与准备章节，安装并配置ODBC驱动。

l   Q4：数据源授权时，输入用户名密码后单击授权，报错授权实例失败，原因是：授权实例失败，请检查用户名或密码是否正确。

【问题原因】：

1.         实例未成功运行，或在授权时被关闭。

2.         用户名或者密码填写不正确，导致授权失败。

3.         ODBC环境配置不正确，导致无法正常连接实例。

【解决方案】：

1.         按照《云备份 CBR Kingbase 备份恢复用户指南》，检查实例状态是否为运行中。

2.         检查填写的用户名与密码是否正确。

3.         检查ODBC配置，确保ODBC能够正常连接数据库。

l   Q5：数据源授权时，报错license file will expire in X days。

【问题原因】：实例授权文件将要过期，连接数据库提示警告。

【解决方案】：

1.         查看版本号：

a.         在kingbase用户下执行：kingbase -V查看产品版本号 。

2.         下载license：

a.         登录kingbase官网找到微信公众号扫码，单击“试用下载”，找到相应的产品版本的license.dat。

3.         替换license步骤：

a.         登录服务器，执行：find / -name license.dat，看license.dat在哪些路径；

b.         把上一步找到的路径记录下来；

c.         根据上一步的路径把原有license.dat重命名为license.dat_old；

d.         把下载的license.dat传到服务器，重命名为license.dat，并且执行chown -R kingabse:kingbase license.dat；

e.         执行su kingbase切换到kingbase用户，把最新的license拷贝到第二步记录下来的路径；

f.          重启数据库：sys_ctl restart –D /home/kingbase/KingbaseES/V8/data (备注：每个地方data路径可能不一样，通过ps -ef查找出带-D的进程，确定准确的data路径)。

l   Q6：数据源授权时，抛错：Data source name not found。

【问题原因】：ODBC.ini默认路径与存放路径不一样.

【解决方案】：进入到kingbase安装用户下，获取环境变量配置信息。

然后进入客户端安装目录xxx/HBR_Client/ClientService/user下，在kingbaseenv文件里填写相关环境变量。

 

2.1 关于备份

在 CBR 中，备份是一种任务驱动型进程，执行备份之前，您需要先新建备份任务。备份任务是备份需求的一个配置集合单元，备份任务定义了备份内容、备份选项和备份数据存放的位置等。备份任务的新建操作，请您参考新建备份任务；备份任务新建成功后您可以对其进行管理，具体内容请参考2.3。

CBR 将连续归档备份的备份方式备份 Kingbase 数据库。关于备份原理的具体内容，请您参考2.1.1 备份原理。

首次备份时，任务将进行全量备份，后续可以根据您的需求设置备份类型为完全备份或增量备份。更多内容，请参考2.3.2。

CBR 对Kingbase 数据库进行的备份属于有代理备份，即备份时需要在生产机的操作系统内安装代理客户端。有关外接客户端的相关内容，请参考1.6。

2.1.1 备份原理

CBR 备份 Kingbase 数据库的客户端类型支持单机备份和主备集群备份。

2.1.1.1 单机备份原理

CBR备份 Kingbase 单机数据库，原理如下：

                                步骤 1     检查环境是否满足备份条件，如：数据库处于正常运行状态，ODBC可正常连接，归档日志路径已配置。

                                步骤 2     控制台新建Kingbase数据库类型备份任务。

                                步骤 3     客户端根据备份任务勾选的数据源连接数据库，创建一个ODBC长连接并执行以下操作：

                                步骤 4     select sys_start_backup(‘label’, false,true);

                                步骤 5     select sys_switch_xlog();

                                步骤 6     备份数据路径下的相关文件，并根据备份任务设置的并发数创建备份线程。

                                步骤 7     待数据文件备份结束，执行以下数据库备份停止操作：

                                步骤 8     select  sys_stop_backup(true);

                                步骤 9     备份归档路径下的日志文件。

                             步骤 10     按照备份任务设置的选项，按时间删除已备份的归档日志。

                             步骤 11     客户端完成备份任务，上报任务备份情况到管理控制台。

----结束

2.1.1.2 主备集群备份原理

CBR备份 Kingbase 主备集群数据库，原理如下：

                                步骤 1     CBR创建一个Kingbase主备集群虚拟客户端，将集群客户端绑定到虚拟客户端

                                步骤 2     创建一个Kingbase主备集群备份任务

                                步骤 3     发起备份，CBR将根据创建任务时选择的备份模式，查找到合适的节点进行备份

                                步骤 4     在选定的节点进行单机备份，将数据发送到存储

                                步骤 5     如果首个节点备份成功，则备份任务执行成功；如果首个备份节点执行任务失败，则根据用户选择的备份模式以及备份类型，判断在下一个节点继续发起备份，还是任务执行失败

                                步骤 6     所有客户端完成备份任务，上报任务备份情况到管理控制台。

----结束

2.1.2 备份类型

CBR 备份 Kingbase 数据库的备份类型支持完全备份和增量备份。

2.1.2.1 完全备份

将选定的数据源完全备份到指定目的地的备份集中。每次执行时，它不会根据最新的变动进行备份，而是直接将所有的数据备份到OFS介质中，并产生一个时间点，用于记录备份的内容。

l   说明

−           前提条件：数据库处于正常运行状态且可以通过ODBC成功连接。

−           首次保护Kingbase数据库时，建议执行一次完全备份。

−           完全备份即为一个副本。

l   如何启用完全备份，请参考2.3.2。

2.1.2.2 增量备份

基于上一次成功的备份，备份变化的数据与日志到OFS介质中，同时产生相应的时间点。在尚未进行完全备份的情况下，进行增量备份时，会自动转为完全备份。

l   说明

−           如何满足增量备份条件？

n   答：1）任务备份成功且备份时间点未被删除；2）Kingbase 数据库备份成功后，保留的副本未被全部删除；3）任务的数据路径与归档日志路径未发生变更；4）任务未执行恢复任务至此备份实例的数据路径下。

−           增量备份不是一个副本，增量备份和它依赖的所有备份数据共同组成一个副本。星期一和星期二的完全备份分别代表一个副本，星期四和星期五的增量备份和星期三的完全备份共同组成一个副本。

l   如何启用增量备份，请参考2.3.2。

2.1.3 备份策略管理

CBR 支持为备份任务关联备份策略，用于自动调度各种备份任务的运行。开启备份策略功能，您无需手动进行备份操作，系统将自动按照备份策略中设置的时间和备份模式开始作业。为了确保生产数据的安全性和恢复的需求，您需要谨慎配置备份策略。

当您的管理控制台上存在大批量的备份任务时，为减少您维护多个备份任务的工作量，CBR 支持为备份任务统一关联同一个备份策略。

l   组成要素

备份策略将由以下几个要素组成：

l   备份方式

l   备份周期

l   是否重复发起

l   需备份的数据量

l   需使用的备份空间

l   备份周期设置建议

备份的周期决定了进行恢复任务时可恢复的状态点，备份周期越频繁，能恢复到越接近故障点的状态。值得注意的是，过于频繁的备份业务，会影响系统的性能，从而对正常业务产生不良影响；频繁的备份业务会产生大量的备份文件，不便于管理，在恢复时也较为复杂；也会产生过多的备份数据，占用大量的磁盘空间。因此备份周期需要全面考虑恢复的要求，备份存储空间的限制，对正常业务不会产生影响等因素。

因此，建议您：

1.         一般业务可以每周末数据应用比较平缓的时候，进行一次完全备份，每天进行一次增量备份。

2.         重要的生产数据且数据量不大的情况下，可以每天进行一次增量备份。

3.         有较小占用生产客户端资源的需求的情况下，可以初始进行一次完全备份，后续进行增量备份。

4.         建议备份周期应至少大于备份时长，否则会导致部分备份计划触发失败。

2.1.3.1 新建策略

                                步骤 1     操作员或租户登录管理控制台，单击【定时数据保护】→【策略】，进入“备份策略”界面。

                                步骤 2     在当前界面，单击【新建】按钮，系统弹出“新建备份策略”对话框。

                                步骤 3     在对话框中，根据要求配置如下参数：

l   策略名称：输入备份策略的名称。名称由中文、大小写字母、数字、”-“、”_”、”.”、”@”组成，长度为3-30个字符，不可重复。

l   备份周期：默认为每1天，即每天发起一次备份。

−           当备份周期为天，支持的配置参数范围为1~365。

−           当备份周期为周，默认为每周日发起备份，支持选择周一~周日且支持多选。

−           当备份周期为月，默认每月1日发起备份，支持的配置参数范围为1~31。您可以选择“若当月无选定日期则在最后一天触发”。

−           当备份周期为年，默认每年1月1日发起备份，支持选择具体日期发起备份。

l   重复发起：默认不开启，开启该项，则在任务第一次发起后，系统将按照所设定的持续时间和频率进行重复发起。

重复发起遵循以下原则：

l   持续时间和频率均支持以分钟或小时为单位。

l   如果以分钟为单位，持续时间的配置参数范围为2~59，频率的配置参数范围为1~58。

l   如果以小时为单位，持续时间的配置参数范围为2~24，频率的配置参数范围为1~23。

l   支持持续时间和频率单位不同，但频率必须小于持续时间。

注意：如果在持续时间内达到了任务策略触发时间，且上一个备份任务还没有结束的情况下，系统不会发起备份。

                                步骤 4     确认无误后，单击【确定】按钮完成操作。

----结束

2.1.3.2 备份任务启用/禁用策略

备份策略新建完成后，您必须将其应用到备份任务上才可以生效。如果应用了某备份策略的任务不再需要此策略，您也可以选择移除。

注意事项

l   每个备份任务支持添加并启用多个备份策略。

操作步骤

                                步骤 1     租户或者操作员登录控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【数据备份】→【备份】，进入“备份”界面。

                                步骤 3     在当前界面，选中一个或多个任务，单击【策略】。

                                步骤 4     在弹出的对话框中选择【添加】，选择【备份方式】和【发起时间】。

【备份方式】：分为完全备份、增量备份。

【发起时间】：必选项，发起计划的具体时间格式：YYYY-MM-DD HH:MM，精确到分钟，默认显示：当前时间，设置时间不可早于当前时间。

                                步骤 5     确认无误后，单击【确定】按钮回到“备份策略”对话框。

如果需要添加多个备份策略，请再次单击【添加】按钮。

                                步骤 6     在对话框中，选择一个或多个备份策略，单击【启用】按钮，原来“禁用”状态的策略变为“启用”。

                                步骤 7     如果您不希望备份策略再次应用于此备份任务，您可以单击【禁用】按钮。您另外可以删除列表中的备份策略。

备份策略禁用后，将即刻失效。

注意：

l  添加每月策略任务的时候，尽量避免选择31号、30号、29号进行定时备份，考虑到有的月份特殊，可选择28号及其之前的任何一个日期进行备份，这样可以保证每月都有任务执行；

l  在设置【开始时间】时，建议您尽量在服务器空闲时进行备份操作；另外，在设置【最大保存完全副本数】时，可在综合考虑您的存储空间和数据需求等因素后进行合理的设置（保留副本数策略：保留n个副本数，至少需要n+1个副本的空间）。

l  在设置策略时，请务必不要使用一个完全后续全是增量备份的方式；一个月必须要进行至少一次的完全备份，以保护数据安全。

----结束

2.1.3.3 编辑策略

如果您需要对当前已有的备份策略相关配置做修改，您可以执行以下操作编辑备份策略。

                                步骤 1     租户或操作员登录控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【策略】→【备份策略】，进入“备份策略”界面。

                                步骤 3     在当前界面，选中一条备份策略，单击【编辑】按钮，系统弹出“编辑备份策略”对话框。

                                步骤 4     在对话框中，您可以修改备份周期和重新设置重复发起。名称暂不支持修改。

                                步骤 5     确认无误后，单击【确定】按钮完成操作。

----结束

2.1.3.4 复制策略

如果您想复用某策略，并修改个别参数时，为了简便操作，您可以复制备份策略。

注意事项

l   复制的备份策略与原策略的配置相同，如果您需要修改，请使用编辑功能。

l   复制的备份策略必须进行重命名。

操作步骤

                                步骤 1     租户或操作员登录控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【策略】→【备份策略】，进入“备份策略”界面。

                                步骤 3     在当前界面，选中一条备份策略，单击【复制】按钮，系统弹出“复制备份策略”对话框。

                                步骤 1     在对话框中，根据要求输入备份策略的名称。

                                步骤 2     确认无误后，单击【确定】按钮完成操作。

----结束

2.1.3.5 导出/导入策略

导出备份策略至本地，可以再导入至其他CBR管理控制台，这样能简便您再次创建策略的操作。

                                步骤 1     租户或操作员登录控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【策略】→【备份策略】，进入“备份策略”界面。

                                步骤 3     在当前界面，选中一条或多条备份策略，单击【导出】按钮，备份策略将以“.xls”格式保存至本地。

                                步骤 4     导出后的表格内容如下。

l   name：备份策略的名称。

l   type：

l   needInterval：重复发起功能，开启显示为“1”，不开启显示为“0”。

l   duration：重复发起中的持续时间。

l   durationUnit：持续时间的单位，单位为分钟显示为“1”，单位为小时显示为“2”。

l   frequency：重复发起中的频率。

l   frequencyUnit：频率的单位，单位为分钟显示为“1”，单位为小时显示为“2”。

l   params：

l   auther：新建该备份策略的用户。

l   createdTime：

l   updateTime：

                                步骤 5     如果需要导入策略，请您在本地先根据下载的格式编辑好策略的参数。确认无误后，在管理控制台的“备份策略”界面，单击【导入策略】按钮。系统弹出“导入策略”对话框。

                                步骤 6     在对话框中，单击【浏览】按钮，选择需要导入的策略。确认无误后，单击【确定】按钮完成操作。

                                步骤 7     导入成功后，“备份策略”界面将显示导入的策略。

----结束

2.1.3.6 删除策略

如果您不再需要某备份策略，您可以执行以下操作删除备份策略。

注意事项

l   删除备份策略后，使用该策略的任务将不再按照该策略执行。请谨慎操作。

l   支持批量删除，您可以同时删除多个备份策略。

操作步骤

                                步骤 1     租户或操作员登录控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【策略】→【备份策略】，进入“备份策略”界面。

                                步骤 3     在当前界面，选中一条或多条备份策略，单击【删除】按钮，系统弹出“提示”对话框。

                                步骤 4     仔细阅读警告内容：“删除策略后，使用该策略的任务将不再按照该策略执行，仍要继续删除吗？”确认无误后，单击【删除】按钮完成操作。

----结束

2.1.4 数据保留策略管理

当您的管理控制台上存在大批量的备份任务时，您可能会遇到备份存储空间不够用的情况。数据保留策略将为您解决这类烦恼，一旦您按需配置数据保留策略后，系统将根据数据保留期限、保留副本个数或备份策略的备份周期来保留备份副本，达到备份存储空间循环利用的效果。同时，CBR 也支持同一个数据保留策略关联不同备份任务，为您减少维护多个备份任务的工作量。

CBR 为您提供以下三种数据保留策略：

l   数据保留期限：超过设置时间的副本将被自动清理。

l   保留副本个数：超过设置个数的副本将被自动清理。

l   按备份策略的备份周期设置副本保留策略：与备份策略结合使用，根据不同的备份策略设置不同的副本保留数。

2.1.4.1 新建策略

                                步骤 1     操作员或租户登录管理控制台。

                                步骤 2     单击【定时数据保护】→【策略】→【数据保留策略】，单击【新建】按钮，新建数据保留策略。

                                步骤 3     在对话框中，根据要求配置如下参数：

1.         名称：输入数据保留策略的名称。数据保留策略名称由中文、大小写字母、数字、“-”、“_”、“.”、“@”组成，长度为3~30个字符。

2.         数据保留策略：默认关闭，须开启后才能继续配置。

数据保留期限：默认保留 1 年的备份副本，即从使用该策略开始到 1 年后，这期间产生的副本将被保留，超过 1 年的副本将被自动清理。可开启【严格保留】选项。

数据保留期限配置参数范围为 1~999；可以选择年、月、周、天为单位。

保留副本个数：默认保留 2 个副本，即同一备份任务的副本超过 2 个后，最旧的副本将被自动清理。保留副本个数配置参数范围为 1~1024。

按备份策略的备份周期设置副本保留策略：

−           如果备份策略是按天设置，则默认保留 30 个副本。

−           如果备份策略是按周设置，则默认保留 24 个副本。

−           如果备份策略是按月设置，则默认保留 12 个副本。

−           如果备份策略是按年设置，则默认保留 4 个副本。

−           按照备份策略的备份周期所有参数配置范围均为 1~99999。

−           支持复选，且当任务使用对应备份周期的备份策略后，才限制发起的副本总数。

−           未勾选复选框，则默认保留所有副本。

−           勾选复选框，但任务没有使用此备份周期的备份策略，则保留自动发起的所有副本。

−           例如：启用 “按年备份策略”，但任务使用的备份策略没有年度备份策略，则保留所有备份策略自动产生的全部副本。

−           如果某一个备份周期的备份策略存在多个，则保留副本数为此类备份周期的所有备份策略产生的副本累加。

−           例如：任务关联了 4 个年度备份策略，则最终将保留 1 年内的 4 个副本。

3.         完整副本保留：开启后不会触发备份数据自动清理。

                                步骤 4     确认无误后，单击【确定】按钮完成操作。

----结束

2.1.4.2 备份任务关联/移除策略

数据保留策略新建完成后，您必须将其应用到备份任务上才可以生效。如果应用了某数据保留策略的任务不再需要此模板，您也可以选择移除。

注意事项

l   每个备份任务仅支持添加一个数据保留策略，重复添加后系统将默认使用最近一次添加的模板。

l   正在运行中的备份任务不支持添加和移除数据保留策略，请您耐心等待任务运行结束后再添加或移除。

操作步骤

                                步骤 1     租户或操作员登录控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【数据备份】→【备份】，进入“备份”界面。

                                步骤 3     在数据备份页面中，选中任务，单击【策略】->【添加数据保留策略】。

                                步骤 4     在当前界面，系统弹出“添加数据保留策略”对话框。

                                步骤 5     在对话框中，选择一个适合该任务的数据保留策略。如果任务之前已经配置过其他策略，这次新的模板将替代旧的策略重新生效。

                                步骤 6     确认无误后，单击【确定】按钮完成操作。

备份任务添加策略后，数据保留策略即刻生效。

                                步骤 7     如果您想要移除策略，请在 “备份” 界面，选中一个或多个已配置策略且状态为 “未启动”的任务，单击【策略】→【移除数据保留策略】，系统弹出“提示”对话框。

                                步骤 8     请您仔细阅读提示内容：“移除策略后，关联备份计划的副本将不再按照该策略进行保留，仍要继续移除吗？（一个计划如果没有数据保留策略，则该计划的副本将会全部保留）”确认无误后，单击【确定】按钮完成操作。

备份任务移除策略后，数据保留策略即刻失效。

----结束

2.1.4.3 编辑策略

如果您需要对当前已有的数据保留策略相关配置做修改，您可以执行以下操作编辑数据保留策略。

注意事项

l   如果数据保留策略绑定的任务正在运行中，您将无法编辑该模板。请您耐心等待任务运行结束后再编辑。

操作步骤

                                步骤 1     租户或操作员登录控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【策略】→【数据保留策略】，进入“数据保留策略”界面。

                                步骤 3     在当前界面，选中一条数据保留策略，单击【编辑】按钮，系统弹出“编辑数据保留策略”对话框。

                                步骤 4     在对话框中，您可以关闭数据保留策略，也可以修改数据保留策略条件。名称暂不支持修改。

                                步骤 5     确认无误后，单击【确定】按钮完成操作。

----结束

2.1.4.4 删除策略

如果您不再需要某数据保留策略，您可以执行以下操作删除数据保留策略。

注意事项

l   如果数据保留策略绑定的任务正在运行中，您将无法删除该模板。请您耐心等待任务运行结束后再删除。

l   支持批量删除，您可以同时删除多个数据保留策略。

操作步骤

                                步骤 1     租户或操作员登录控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【策略】→【数据保留策略】，进入 “数据保留策略” 界面。

                                步骤 3     在当前界面，选中一条或多条数据保留策略，单击【删除】按钮，系统弹出“提示”对话框。

                                步骤 4     确认无误后，单击【确定】按钮完成操作。

----结束

2.1.4.5 复制策略

如果您想复用某策略，并修改个别参数时，为了简便操作，您可以复制数据保留策略。

注意事项

l   复制的数据保留策略与原模板保留策略配置相同，如果您需要修改，请使用编辑功能。

l   复制的数据保留策略必须进行重命名。

操作步骤

                                步骤 1     租户或操作员登录控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【策略】→【数据保留策略】，进入“数据保留策略”界面。

                                步骤 3     在当前界面，选中一条数据保留策略，单击【复制】按钮，系统弹出“复制数据保留策略”对话框。

                                步骤 4     在对话框中，根据要求输入数据保留策略的名称。

                                步骤 5     确认无误后，单击【确定】按钮完成操作。

----结束

2.1.5 归档日志删除策略

在 CBR 中，Kingbase 备份存储的数据为数据文件与日志文件。在执行多次完全备份后，可能会存在重复的日志备份。设置了归档日志删除策略后，任务会按照策略去删除已经做过备份的日志，节省了存储空间。

归档日志删除策略支持以下两种删除方式：

l   备份成功后，删除指定时间前的归档日志：在备份任务执行成功后，按照设置的时间往前删除已经做过备份的归档日志。比如设置的为删除1 天前的，任务会在执行成功后，删除1天前的已备份日志。

l   删除全部已备份日志：在备份任务执行成功后，删除所有已经做过备份的归档日志。

选择指定时间点删除归档日志还是删除全部已备份日志，需要根据您的具体需求判断。如果您的存储空间足够，想要删除一部分日志，可以选择指定时间点删除；如果您不希望保留已经备份过的日志，从而占用更少的存储空间，就可以选择删除全部已备份的归档日志。如果您不希望去删除归档日志，可以选择不开启此选项。

2.1.6 多通道

在 CBR 中，Kingbase数据库备份支持开启多通道，默认每个通道分配内存256MiB。通道数在关闭时默认为1 ，最少开启1个通道，最多开启8个通道。可以通过调节通道数来调节备份性能。当您的机器资源充足，您可以试着加大通道数来优化备份性能。

2.1.7 传输和存储加密

为保证数据传输过程和存储时的安全性，备份存储支持对数据加密。

数据的加密计算由客户端完成，计算完成后将数据传输至服务端。数据在传输和存储中始终保持加密状态。

数据恢复时，存储的数据将直接发送至目标客户端，再由客户端进行数据的解密操作。

备份存储支持AES256和SM4加密算法。

2.1.8 数据压缩

在 CBR 中，备份存储的数据压缩功能为源端压缩。备份数据进行压缩后，在不丢失的情况下数据量被缩减，这样可以缩短备份时间，从而提高备份效率；另外可以满足用户在存储空间不足的情况下顺利完成备份。

数据压缩支持以下两种压缩方式：

l   快速压缩：快速压缩的压缩速度快但压缩率低。

l   强力压缩：强力压缩采用 GZIP，压缩速率高但速度相对较慢。

选择快速压缩还是强力压缩，需要根据您的具体需求判断。如果您的存储空间足够，想要备份速度快一些，可以选择快速压缩；如果您希望压缩力度大一些，从而占用更少的存储空间，就可以选择强力压缩。

2.1.9 备份自动重试

在 CBR 中，无论是手动备份还是备份策略触发（即自动备份）的备份任务，都有可能发生备份失败的情况。为了避免备份失败导致数据无法及时备份，CBR 支持备份自动重试机制。备份自动重试机制的开启或关闭，需要您以租户或操作员角色在新建备份任务时配置。

备份自动重试机制遵循以下原则：

l   自动重试最大次数可配置的数值范围为 1 ~ 5。

l   重试等待时间可配置的数值范围为 1 ~ 30，单位为分钟。

假设，您为备份任务开启了“备份自动重试”选项，且设置的自动重试最大次数为 3 次、重试等待时间为 10 分钟，则：

l   当手动备份执行失败，10 分钟后系统将自动重试备份并最多执行 3 次。一旦重试发起并备份成功，无论重试了几次，此次重试策略将终止。

l   当自动备份执行失败，10 分钟后系统将自动重试备份并最多执行 3 次。一旦重试发起并备份成功，无论重试了几次，此次重试策略将终止。

l   当手动备份执行失败，自动重试发起前，手动发起备份且执行成功，重试策略将不执行。

l   当手动备份执行失败，自动重试发起前，自动发起备份且执行成功，重试策略将不执行。

l   当自动备份执行失败，自动重试发起前，手动发起备份且执行成功，重试策略将不执行。

l   当自动备份执行失败，自动重试发起前，自动发起备份且执行成功，重试策略将不执行。

2.1.10 流量控制

在 CBR 中，备份存储已经支持并行备份。当外部QPS或并发量超过了访问上限会导致应用瘫痪，所以会对接口调用加上限流保护，防止超出预期的请求导致系统故障。

流量限速实现流程如下：

1.         由应用创建限速组件 (蓝色线条表示创建)；

2.         应用通过不同essClient创建多个writeClient的时候，将flowCtrl用作参数传入 (橙色虚线条表示传参)；

3.         每个writeClient的datachannel传输数据时，由同一个flowCtrl进行限流 (红色线条代表使用)。

−           说明

界面上显示速度的大小是应用处理数据的速度，并非真实发送数据的速度。

举个例子：

如果一个任务的真实数据是1GiB，但是开启了重删，重删之后只有20MiB真实数据了。此时限速设置10MiB每秒。那么，后端datachannel发送的速度就是10MiB每秒，一共需要2秒时间。而由于前端页面显示的是数据处理速度，所以显示的速度大概应该是1GiB/2s，约为500MiB/s。

流量控制遵循以下原则：

−           开始日、结束日：周一~周日。

−           限速时间段：00:00~23:59，秒不设置；开始时间需早于结束时间。

−           限速时间段不允许有交叠。

−           若不在时间段之内，则速度上限没有限制。

−           速度范围0~1024MiB/s（再大会溢出），整数，默认1024MiB/s。

−           单击新建会增加一条限制，最多增加47条，一共可设置48条限制。

−           单击删除可删除手动添加的时间段限速条件；选中多条限速项可批量删除。

2.1.11 自定义脚本

在 CBR 中，Kingbase数据库备份支持自定义脚本功能。

自定义脚本支持以下三种执行方式：

l   备份前执行：在备份任务发起后，数据库备份开始前执行用户选择的脚本文件。

l   备份成功后执行：在备份任务执行成功后，执行用户选择的脚本文件。若备份任务执行失败，则此选项下的脚本不会被执行。

l   备份失败后执行：在备份任务执行失败后，执行用户选择的脚本文件。若备份任务执行成功，则此选项下的脚本不会被执行。

2.1.12 备份模式

在 CBR 中，Kingbase主备集群数据库支持选择不同的备份模式进行备份。

备份模式支持以下四种：

l   只从备机备份：在备份任务发起后，只备份备机实例。若发起增量备份，需切换到主机备份日志，因为日志只在主机产生，如果备机实例异常，当前任务不会切换到主机备份。

l   只从主机备份：在备份任务发起后，只备份主机实例，从机实例不备份，如果主机实例异常当前任务不会切换到备机备份。

l   优先从备机备份：在备份任务发起后，优先选择备份备机实例，若备机实例异常，会切换到主机并备份主机实例。

l   优先从主机备份：在备份任务发起后，优先选择备份主机实例，若主机实例异常，会切换到备机并备份备机实例。

2.2 Kingbase 备份任务创建

2.2.1 注意事项

l   备份过程中如果遇到难以解决的问题，请您先阅读FAQs，查看是否存在相同问题的解决方案。如果不存在，请您开启模块trace，开发方法请参考5.2然后重复执行存在问题的操作，最后查看trace日志进行解决，如果还是无法解决，请您联系华为实施工程师进行解决。

l   若您未开启归档日志选项，备份任务会执行失败；

l   若您设置的归档路径不存在或者设置的归档日志格式不正确，备份任务会失败；

l   若您设置的归档日志路径属主权限不正确时，备份任务会执行失败；

l   利用普通用户授权的实例，备份任务会执行失败，请使用超级用户进行实例授权。

l   手动删除过归档日志路径下的日志或者手动备份设置删除过归档日志，请发起一次完全备份，否则之后增量备份时间点日志不全，不能正常使用；

l   当归档日志路径与实例数据路径在同一个路径，或者归档日志路径是数据路径的子路径，备份任务会执行失败，请重新设置归档路径；

l   若更改过归档日志路径，备份任务不会删除之前旧的归档日志路径下的归档日志。若确认此部分日志不需要保存，请手动进行删除；

l   更改过归档日志路径或者更改过数据路径，下次发起增量备份时，会自动转为完全备份，以保证数据一致性；

l   归档日志路径空间不足时，备份任务会执行失败；

l   实例的端口号更改后，备份任务会找不到实例，备份失败；

l   若有其他任务发起恢复至某备份任务的实例的数据路径，请对此备份任务发起一次完备，否则会导致之后的增量备份数据不可用；

l   恢复之后的数据库首次完全备份在备份完归档日志之后如果失败，需要手动发起一次完备，否则之后的增备时间点不可用；

l   恢复过后的实例，默认关闭归档日志。若需要发起此实例的备份，请手动开启归档日志。

l   备份任务执行过程中，对数据库进行删除操作，备份任务执行过程中可能会出现警告，那是因为数据的删除操作删除了备份任务开始时记录的需要备份的文件，此时任务会出现警告，可忽略。备份时间点可正常恢复。

l   删除任务并不会删除数据，若需要清理数据，请至数据清理清理数据。

l   Kingbase备份实例如果存在大量事务提交，发起备份任务时，在通知数据库开始备份时可能会有卡顿，属正常现象。

l   若新增了表空间或数据库，建议发起一次完备，以确保数据完整性。

l   支持Oracle模式、PG模式、MySQL模式下的数据库备份恢复。

l   暂时仅支持数据路径下sys_xlog路径为软链接的实例备份恢复。

 

2.2.2 Kingbase 单机备份任务创建

在 CBR 中，备份是一种任务驱动型进程，执行备份之前，您需要先新建备份任务，请您根据以下操作新建备份任务：

                                步骤 1     租户或操作员登录管理控制台，单击标签栏【定时数据保护】→【数据备份】选项卡，在操作界面，单击【新建】，选择相应的客户端，其应用类型自动显示在右侧，选择【Kingbase数据库】。

                                步骤 2     单击【下一步】，展开数据源层级，勾选需要保护的数据源，此处只可勾选单个实例。

                                步骤 3     备份介质与备份选项，备份介质默认选中OFS，备份选项按需要配置，各选项功能再下方有说明，按需要配置之后，单击【下一步】。

【归档日志删除策略】默认不开启，开启之后按照设置的时间删除已备份过的归档日志。可选择按时间删除归档日志或删除全部已备份归档日志。 数值范围：0~999小时，0~999天，0~999周，0~999月，0~99年；

【通道数】默认不开启。可开启1~8个通道。不开启时，通道数为1。默认每个通道分配内存256MiB，请结合生产机实际内存合理配置通道数。

【传输和存储加密】默认不开启，开启该选项后默认启用启ES256加密算法，可选择启用SM4加密算法，该功能可以和【重复数据删除选项】同时开启；

【重复数据删除选项】默认为不开启，开启该选项可以启用源端重复数据删除的功能，具体配置可参考《云备份 CBR 定时数据保护重复数据删除用户指南》；

【重删高级配置】默认不开启；开启重复数据删除选项后方可开启该选项，可参阅《云备份 CBR 定时数据保护重复数据删除用户指南》；

【备份数据一致性校验】默认不开启，开启后可选择MD5或CRC32加密算法；

【数据压缩】默认不开启，开启之后支持快速压缩与强力压缩。

【备份自动重试】默认不开启。开启之后任务失败之后，按照设定的时间间隔与次数重新触发任务执行。

【流量控制】默认不开启，开启之后支持分时段限速，限速范围0~1024MiB/s。可添加多条限速计划，计划时段不允许冲突。

【自定义脚本】默认不开启。开启之后可设置备份前，备份成功，备份失败后执行脚本。

【强制数据保留】默认不开启；开启后，则保留时常内的数据无法被清理，同时该策略在编辑时，保留时长只能增加不能减少，也无法关闭该选项。

                                步骤 4     单击【下一步】，填写备份任务名称和备注，单击【完成】，任务创建成功。

                                步骤 5     单击【完成】，弹出信息确认框，确认录入信息。

1.         勾选【任务生成后立即执行】，单击【确定】，任务立即发起。

2.         不勾选【任务生成后立即执行】，单击【确定】，任务新建成功后不会自动发起。

                                步骤 6     单击【确定】，新建任务成功。

----结束

2.2.3 Kingbase 主备集群备份任务创建

                                步骤 1     租户或操作员登录管理控制台，单击【定时数据保护】→【数据备份】选项卡，在操作界面，单击【新建】；

                                步骤 2     选择相应的Kingbase虚拟客户端，其应用类型自动显示在右侧，选择【Kingbase数据库】，单击【下一步】。

                                步骤 3     选择用户名称，勾选集群节点的数据源，单击【下一步】。

                                步骤 4     根据需要选择备份介质与备份选项，备份介质默认选中OFS，备份选项按需要配置，单击【下一步】。

【只从备机备份】默认选择只从备机备份，在备份任务发起后，只备份备机实例。若发起增量备份，需切换到主机备份日志，因为日志只在主机产生，如果备机实例异常，当前任务不会切换到主机备份；

【只从主机备份】可以选择只从主机备份，在备份任务发起后，只备份主机实例，从机实例不备份，如果主机实例异常当前任务不会切换到备机备份；

【优先从备机备份】可以选择优先从备机备份，在备份任务发起后，优先选择备份备机实例，若备机实例异常，会切换到主机并备份主机实例；

【优先从主机备份】可以选择从主机备份，在备份任务发起后，优先选择备份主机实例，若主机实例异常，会切换到备机并备份备机实例；

【归档日志删除策略】默认不开启，开启之后按照设置的时间删除已备份过的归档日志。可选择按时间删除归档日志或删除全部已备份归档日志。 数值范围：0~999小时，0~999天，0~999周，0~999月，0~99年；

【通道数】默认不开启。可开启1~8个通道。不开启时，通道数为1。默认每个通道分配内存256MiB，请结合生产机实际内存合理配置通道数；

【传输和存储加密】默认不开启，开启该选项后默认启用启ES256加密算法，可选择启用SM4加密算法，该功能可以和【重复数据删除选项】同时开启；

【重复数据删除选项】默认为不开启，开启该选项可以启用源端重复数据删除的功能，具体配置可参考《云备份 CBR 定时数据保护重复数据删除用户指南》；

【重删高级配置】默认打开重复数据删除选项会显示该选项，具体配置可参考《云备份 CBR 定时数据保护重复数据删除用户指南》；

【备份数据一致性校验】默认不开启，开启后可选择MD5或CRC32加密算法；

【数据压缩】默认不开启；开启后默认启用快速压缩，可选择启用强力压缩；

【备份自动重试】默认不开启。开启之后任务失败之后，按照设定的时间间隔与次数重新触发任务执行。

【流量控制】默认不开启，开启之后支持分时段限速，限速范围0~1024MiB/s。可添加多条限速计划，计划时段不允许冲突；

【强制数据保留】默认不开启；开启后，则保留时常内的数据无法被清理，同时该策略在编辑时，保留时长只能增加不能减少，也无法关闭该选项。

                                步骤 5     填写备份任务名称和备注，单击【完成】，任务创建成功。

                                步骤 6     查看任务信息，确认信息正确，根据需要勾选任务生成后立即执行，单击【确认】，新建任务完成。

----结束

2.3 管理备份任务

2.3.1 查看备份任务

                                步骤 1     租户或操作员登录管理控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【数据备份】→【备份】，进入“备份”界面。

                                步骤 3     单击【详情】，“详情”界面分为四个部分“基本信息”、“数据源”、“选项”以及“策略”，如所示，请您可以根据自己的需求进行查看。

----结束

2.3.2 启动备份任务

备份任务新建完成后，您可以对其进行启动操作。CBR 支持的启动方式有以下两种：

l   通过备份策略自动启动

l   手动启动

以下将为您介绍手动启动备份任务的操作步骤：

                                步骤 1     租户或者操作员登录管理控制台，单击标签栏【定时数据保护】→【数据备份】选项卡，选择已创建的备份任务，选择【启动】，弹出启动确认弹窗，选择备份方式后，单击【启动】，发起任务。

                                步骤 2     启动任务后，在【监控】页面选中任务，单击【详情】，可在执行中查看执行概要及执行输出信息。

                                步骤 3     任务执行结束，可在历史记录中查看执行结果。单击【详情】，可查看执行概要及执行输出信息。

----结束

2.3.3 停止备份任务

备份任务在运行过程中，您可能会因为某些原因需要停止备份任务。CBR 支持您在管理控制台上停止备份任务。

注意事项

l   停止备份任务后，再次发起该任务将不进行断点续传，系统将重新备份数据。因此，请您谨慎操作。

操作步骤

                                步骤 1     租户或操作员登录管理控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【数据备份】→【监控】，进入“监控”界面。 

                                步骤 3     在当前界面，选择一个状态为“正在运行”的任务，单击【停止】按钮，系统弹出“警告”对话框。

                                步骤 4     请您仔细阅读警告内容：“确认继续停止运行这些计划？”

                                步骤 5     确认无误后，单击【停止】按钮完成操作。

请您耐心等待系统停止备份任务。当“监控”界面不再显示该任务，说明该任务已成功停止。

注意：根据2.3.3操作步骤无法停止备份任务时，您可以使用停止工具停止备份任务，具体参阅《云备份 CBR 工具使用指导》。

----结束

2.3.4 编辑备份任务

备份任务新建完成后，如果您需要编辑修改任务向导中的配置，您可以编辑备份任务。备份任务编辑成功后，下次备份将根据编辑后的信息执行。

                                步骤 1     租户或操作员登录管理控制台。

                                步骤 2     单击标签栏【定时数据保护】→【数据备份】选项卡，选中需要编辑的备份任务，单击【编辑】。

                                步骤 3     进入主机选择界面，需要保护的主机不能编辑修改，单击【下一步】。

                                步骤 4     进入数据源选择界面，数据源不支持编辑，单击“下一步”。

                                步骤 5     进入备份介质与备份选项页面，备份介质不支持修改，备份选项中【传输与存储加密】和【重复数据删除】和【数据压缩】不支持修改，其余选项可修改。按照需要修改备份选项后，单击【下一步】。

                                步骤 6     进入任务名称及备注界面，任务名称不支持编辑修改，备注可修改，单击【完成】。

----结束

2.3.5 删除备份任务

如果您的备份任务列表存在任务不需要继续进行备份保护时，您可以删除备份任务。

                                步骤 1     租户或操作员登录管理控制台。

                                步骤 2     单击标签栏【定时数据保护】→【数据备份】选项卡，选择已创建的备份任务，选择【删除】，弹出删除确认弹窗，输入“YES”，单击删除，删除任务。

----结束

2.3.6 清理备份数据

如果您的备份存储空间不足且希望释放更多的空间，您可以清理已备份的数据。清理备份数据需要您在管理控制台上新建任务来操作。

注意：已备份的数据被清理后，您将无法继续使用这部分数据进行数据恢复和远程复制，请您谨慎操作。

                                步骤 1     租户或操作员登录管理控制台，单击标签栏【定时数据保护】→【数据清理】，在数据清理界面单击【新建】按钮，新建数据清理任务。

 

                                步骤 2     选择需要进行数据清理的任务，单击【下一步】。

注意：

l  如果需要清理云备份存储库中的数据，必须选择一个云备份存储库。

l  您只能选择状态为“空闲”的备份任务进行数据清理。

                                步骤 3     请选择要清理的副本，默认清理全部副本。可以选择清理指定副本。

注意：当您选择“清理指定副本”时，您必须选择一个或多个时间点副本，但最近的时间点副本不可选，即系统将保留最近的时间点副本，您可以继续使用该副本。

                                步骤 4     单击【下一步】，弹出任务确认界面，单击完成。

                                步骤 5     弹出数据清理信息确认界面，输入YES。此处区分大小写，必须填大写半角英文字母。

                                步骤 6     数据清理完成之后，可用管理员用户登录查看OFS卷空间是否相应的发生变化。

注意：

l  数据清理需要一定的执行时间，请延迟一段时间查看准确数据；

l  在清理全部时间点的选项下，最新时间点可以被清理。选择清理部分时间点时，最新时间点置灰，不能清理；

l  正在执行备份或恢复的任务无法清理数据，此类任务在新建清理任务时，数据状态显示占用。

----结束

2.4 备份 FAQs

l   Q1：备份任务执行失败，报错：没有权限。

【问题原因】：备份任务实例授权后密码被更改，导致备份时登录数据库失败。

【解决方案】：重新授权实例，再次发起备份。

l   Q2：备份任务失败，报错：归档命令未配置。

【问题原因】：未配置归档相关信息或者未填写归档路径。

【解决方案】：按照规划与准备章节步骤配置环境，开启实例归档以及设置归档路径。

l    Q3：备份失败，报错：归档路径不存在。

【问题原因】：设置的归档路径实际不存在或者设置的归档路径格式不正确。

【解决方案】：检查归档日志配置是否按照用户指南中的步骤设置准确，且设置的归档日志路径是否真实存在。

l   Q4：备份失败，报错实例未配置。

【问题原因】：备份实例未授权。

【解决方案】：给需要备份的实例授权。

l   Q5：备份失败，报错：归档路径与数据路径相同。

【问题原因】：备份实例设置的归档路径为数据路径或者是数据路径的子路径。

【解决方案】：修改归档路径为非数据路径且不属于数据路径下的子路径的其它已存在路径。

l   Q6：备份失败，报错：数据库未启动。

【问题原因】：备份实例被关闭了或者配置文件中的端口号被修改为其它端口。

【解决方案】：检查备份实例状态是否为运行中，且实例端口号为备份任务新建时的实例端口号。

l   Q7：备份失败，报错：连接存储服务失败。

【问题原因】：备份节点未创建元数据卷。

【解决方案】：登录admin账户，进入节点管理，创建元数据卷。

l   Q8：备份失败，报错：尚未配置传输IP。

【问题原因】：未配置数据传输IP。

【解决方案】：登录admin账户，进入节点管理，配置数据传输IP。

l   Q9：备份失败，报错：分配存储空间失败。

【问题原因】：未配置OFS卷或者OFS卷空间不足。

【解决方案】：检查是否创建了OFS卷以及OFS卷空间是否足够用来存储备份数据，若没有创建OFS卷，创建OFS卷；若OFS卷空间不足，增大OFS卷空间或者清理不需要保留的数据。

l   Q10：备份过程中实例停止，报错：server closed the connection。

【问题原因】：备份过程中实例被异常关闭。

【解决方案】：检查实例状态是否正常运行，若实例未开启，开启实例，待实例正常运行后再次发起备份任务。

l   Q11：备份失败，报错：系统抛错：错误：检查“DATA_DIRECTORY”必须为超级用户。

【问题原因】：普通用户授权下的实例进行备份。

【解决方案】：用超级用户对实例授权，再次发起备份。请参考用户指南检查用户是否是Superuser。

l   Q12：备份失败，报错：路径属主错误，请检查数据路径异机归档路径属主是否与发起任务用户一致。

【问题原因】：数据路径或归档路径属主不正确。

【解决方案】：检查备份实例的授权用户是否与实例数据路径以及归档日志路径属主用户一致，若不一致，修改权限保持一致。检查方法如下：

1.         检查授权用户是否Superuser。

2.         查看授权实例的用户名，比如授权时授权用户为 kingbase；

3.         检查备份实例的数据路径与归档路径属主权限，执行ls -l /data（其中/data表述数据路径与归档路径），应该与步骤2 中实例授权的用户名称保持一致，即 kingbase。

l   Q13：备份失败，报错：数据库处于备份状态中。

【问题原因】：上一次备份任务异常停止，导致数据库sys_stop_backup未成功执行。

【解决方案】：登录数据库，手动执行select sys_stop_backup();

l   Q14：备份失败，报错： 系统抛错：排除备份不在运行中。

【问题原因】：备份过程中手动执行了select sys_stop_backup(); 命令，导致程序执行此命令抛错。

【解决方案】：重新发起备份即可，备份过程中不要手动执行select sys_stop_backup(); 等命令。

l   Q15：备份任务执行失败，报错：归档路径空间不足。

【问题原因】：备份任务的实例配置归档路径空间不足。

【解决方案】：增加备份任务的实例归档路径的空间，或者清理归档日志，重新发起完全备份。

l   Q16：备份任务失败，报错：WAL日志的级别不能满足在线备份的要求。

【问题原因】：归档日志未配置正确，或者配置之后未重启实例。

【解决方案】：根据规划与准备章节步骤，配置归档日志。

l   Q17：备份任务失败，系统报错：[ODBC]致命错误：用户“kingbase” Password认证失败。

【问题原因】：ODBC连接配置错误。

【解决方案】：按照中规划与准备章节步骤配置ODBC。

l   Q18：备份任务失败，节点连接异常。

【问题原因】：备份任务执行时，备份存储节点服务异常，导致任务失败，且由于节点异常，时间点无法自动清理。

【解决方案】：修复节点服务后，新建清理任务清理掉任务失败残留的时间点，否则可能导致后续的增备时间点异常无法恢复。

3.1 关于恢复

在 CBR 中，恢复是一种任务驱动型进程。执行恢复之前，您需要先新建恢复任务。恢复任务是恢复需求的一个配置集合单元。恢复任务指定了从哪个存储恢复数据、恢复目的客户端以及恢复路径与恢复所设置的配置等，请参阅3.2.2进行恢复任务的新建，恢复任务新建成功后您可以对其进行管理，具体参阅3.3。

CBR 恢复 Kingbase数据库，原理如下所示：

                                步骤 1     检查恢复目的客户端恢复路径是否有实例正在运行。若存在正在运行的实例，请关闭实例后发起恢复任务；若不存在正在运行的实例，则可直接发起恢复任务。

                                步骤 2     管理控制台启动恢复任务。

                                步骤 3     客户端根据恢复任务选择的路径，清空该路径下的文件，并根据恢复任务设置的并发数创建恢复线程。

                                步骤 4     将数据恢复至指定的恢复路径下sys_xlog目录下的所有文件及子目录。

                                步骤 5     清空恢复路径下sys_xlog目录下的所有文件及子目录。

                                步骤 6     在sys_xlog目录下创建archive_status目录。

                                步骤 7     在恢复路径下创建recovery.conf文件，根据任务选择的时间点配置recovery.conf文件。

                                步骤 8     检查恢复路径下是否存在kingbase.pid和recovery.done文件。若存在这两个文件，则将这两个文件删除。

                                步骤 9     根据任务设置的选项判断是否需要启动实例。若设置的选项开启了使数据库联机，则恢复任务会将恢复的实例服务启动；若设置的选项未开启使数据库联机，则恢复任务不会启动恢复的实例服务。

                             步骤 10     客户端完成恢复任务，上报任务恢复情况到管理控制台。

说明：

l  kingbase.pid是kingbase服务自动产生的，记录服务进程号的，不要人为去改动它。

l  步骤7中，若要恢复到指定时间点，则文件中添加如下一行设置：

recovery_target_time = ‘xxxx-xx-xx xx:xx:xx’

若要恢复到指定xid，则添加如下一行设置：

recovery_target_xid = ‘xxx’

----结束

3.2 新建恢复任务

当您使用 CBR 成功备份 Kingbase 数据库时，您可以在需要的时候恢复备份数据。

3.2.1 注意事项

l   请您先仔细阅读《云备份 CBR 软件兼容性列表》。

l   恢复的目的地若已有实例再运行，需要先关闭实例，否则恢复失败。见1.7.1环境前置检查。

l   恢复路径为700权限，路径需要有备份实例相同用户的属主权限。

l   异机恢复时，必须保证异机已安装相同版本的 Kingbase 数据库。

l   恢复时，若恢复路径非空，需要开启覆盖现有数据库，否则恢复失败。

l   恢复之后的实例，默认归档日志关闭，若需要开启归档，请手动设置开启归档日志与归档路径，建议设置一个新的空归档路径，否则可能会有环境上现有实例冲突，导致日志错乱。

l   若恢复目的地存在同端口实例运行，且恢复任务开启联机启动实例，这时恢复任务启动实例会失败，可通过手动更改恢复实例端口号或者关闭已有相同端口的实例后，再去启动恢复的实例。

l   恢复目的地空间不足，恢复失败。

l   恢复路径下不应存在其他实例数据路径，否则开启覆盖会删除其他实例的数据。

l   不要同时向同一个路径发起恢复任务，这样可能会造成数据丢失。

l   恢复之后的数据库首次完全备份在备份完归档日志之后如果失败，需要手动发起一次完备，否则下次增备时间点不可用。

l   若备份实例存在软链接文件，恢复目的端需要存在相同的软链接指向路径且路径拥有备份实例的数据库用户权限。

l   恢复到原机或者异机后的实例A启动后，实例A设置的归档路径与存在备份任务的实例B归档路径为同一个，可能会导致备份任务实例B的日志错乱，增量备份数据无效，无法恢复。

l   恢复过程中停止任务，会导致数据库损坏或者数据丢失。

l   使用非企业版授权文件的实例，无法支持不完全时间点的恢复。

3.2.2 新建恢复任务步骤

Kingbase单机与集群恢复步骤一致，具体参考如下：

                                步骤 1     检查要恢复的位置实例是否关闭，若正在运行，请先关闭实例。

                                步骤 2     若需要指定恢复路径，请检查恢复路径权限是否正确，路径需要拥有700权限以及备份实例数据库用户的属组权限（即备份前授权实例的用户）。

                                步骤 3     租户或操作员登录管理控制台，单击【定时数据保护】→【数据恢复】，单击【新建】，进入新建恢复任务页面第一页。

                                步骤 4     选择要恢复的备份任务。

注意：OFS 可分为本地 OFS 或 目的端 OFS，即您可以恢复本地 OFS 卷中的数据，也可以恢复目的端 OFS 卷中的数据。其中，本地 OFS 中的数据包含本地备份任务产生的数据和反向复制产生的数据；目的端 OFS 中的数据包含数据同步（即从本地同步到目的端）产生的数据。

                                步骤 5     单击【下一步】，选择备份时间点，展开数据源列表，勾选实例。

                                步骤 6     选择客户端和数据库用户以及恢复路径，设置恢复选项。恢复选项说明如下。

【覆盖现有数据库】默认不开启，开启之后恢复任务会覆盖目的地现有数据。原机原位置恢复需要开启此选项。

【不完全恢复】默认不开启。只有增量备份时间点才支持不完全恢复。开启之后可设置指定时间点恢复或指定Xid恢复。

【通道数】默认不开启。可开启1~8个通道。不开启时，通道数为1。默认每个通道分配内存256MiB，请结合生产机实际内存合理配置通道数。

【恢复后使数据库联机】默认开启。开启之后任务执行后会自动启动实例，否则实例不启动。

【自定义脚本】默认不开启。开启之后可设置恢复前，恢复成功，恢复失败后执行选定的脚本。

                                步骤 7     单击【下一步】，填写任务名称和备注。

                                步骤 8     单击【完成】，弹出信息确认框。

                                步骤 9     单击【确定】，新建恢复任务完成。

----结束

3.3 管理恢复任务

3.3.1 查看恢复任务

注意事项

l   Kingbase 恢复任务运行结果可以是“已停止”、“成功”、“失败”或“成功(有警告)”。建议您及时查看警告内容和原因，确认恢复数据是否存在问题。

l   恢复任务在运行过程中触发【停止】按钮，任务运行的结果为“已停止”。如何停止恢复任务，请您参考3.3.2 停止恢复任务。

操作步骤

恢复任务默认新建成功立即执行，请您根据以下操作查看恢复任务：

                                步骤 1     恢复任务开始执行，可查看任务执行记录。

                                步骤 2     选中任务，单击【详情】，您可以进一步查看该任务的任务详情、执行概要、执行输出。

----结束

3.3.2 停止恢复任务

恢复任务在运行过程中，您可能会因为某些原因需要停止恢复任务。CBR 支持您在管理控制台上停止恢复任务。

注意事项

l   停止恢复任务，可能会导致已恢复的数据不可用，请您谨慎操作。

l   停止恢复任务后，再次发起该任务将不进行断点续传，系统将重新恢复数据。因此，请您谨慎操作。

l   停止恢复任务后，如果存在部分数据已经恢复到目的平台，这部分数据将不会被清理。

操作步骤

您需要停止恢复任务时，请您执行以下操作：

                                步骤 1     租户或操作员登录管理控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【数据恢复】→【恢复备份数据】，进入“恢复备份数据”界面。

                                步骤 3     在当前界面，选择一个状态为“运行中”的任务，单击【停止】按钮，系统弹出“停止任务”对话框。

                                步骤 4     请您仔细阅读警告内容：“任务停止后将无法断点续传，需要重新启动。恢复任务停止将有可能导致恢复数据不可用！仍要继续停止这些任务运行吗？”

                                步骤 5     确认无误后，单击【停止】按钮完成操作。

请您耐心等待系统停止恢复任务。当“恢复备份数据”界面显示任务运行结果为“已停止”，说明该任务已成功停止。

----结束

3.3.3 删除恢复任务

如果您的恢复任务列表过多，您可以删除恢复任务。

注意事项

l   只有运行结束的恢复任务才支持删除操作。

操作步骤

当您不想保留恢复任务历史记录时，您可以执行以下操作删除恢复任务：

                                步骤 1     租户或操作员登录管理控制台。

                                步骤 2     单击左侧导航栏【定时数据保护】→【数据恢复】→【恢复备份数据】，进入“恢复备份数据”界面。

                                步骤 3     在当前界面，选中一个或多个恢复任务，单击【删除】按钮，系统弹出 “删除” 对话框。

                                步骤 4     如果您确认要删除选中的恢复任务，请在文本框中输入“YES”并单击【删除】按钮完成操作。

l  支持批量删除恢复任务。

l  任务运行结束后才能执行删除操作。

----结束

3.4 恢复 FAQs

l   Q1：恢复失败，报错：实例正在运行。

 

【问题原因】：恢复的路径下实例处于运行状态。

【解决方案】：关闭要恢复至的路径下的实例或者恢复至新的路径下。

l   Q2：恢复失败，报错：恢复用户与备份用户不符。

 

【问题原因】：恢复所选的用户与备份实例所属的用户不是同一个。

【解决方案】：恢复到备份任务实例所属的用户下。

l   Q3：恢复失败，报错：恢复路径非空。

【问题原因】：恢复任务未开启覆盖选项恢复至一个非空目录。

【解决方案】：恢复任务开启覆盖现有数据库，或者恢复至一个空的目录。

l   Q4：恢复失败，报错：访问文件被拒。

 

【问题原因】：路径读写权限不足或属主不正确。

【解决方案】：检查路径是否具有700权限，没有的话修改权限为700。检查恢复路径的属主是否是恢复任务所选的数据库用户，若不是，授予数据库用户权限。

l   Q5：异位置恢复实例后启动失败抛出警告如下，不影响实例正常运行。

【问题原因】：数据库启动实例时会产生一部分日志，而这部分日志没有归档，导致启动实例时存在警告。

【解决方案】：不需要做处理，异位置恢复实例启动日志正常告警，数据是成功恢复的。

l   Q6：恢复失败，原因：恢复路径不存在。

【问题原因】：恢复路径不存在，可能路径已被删除。

【解决方案】：选择一个权限正确且存在的路径进行恢复。

l   Q7：恢复任务失败，报错删除恢复路径下的目录或文件失败。

【问题原因】：恢复时，后台操作用户为数据库用户（如kingbase用户，不具备root权限），当恢复路径存在一些无效链接或者文件时，无法成功删除恢复路径下的文件或者目录。

【解决方案】：手动清空要恢复至的目录下的文件或者子目录，再次发起恢复。

l   Q7：恢复任务失败，报错恢复路径空间不足或者非默认表空间或者自建软链接目标路径不存在。

【问题原因】：

1.         恢复路径空间不足以恢复备份数据。

2.         非默认表空间或者自建的软链接目标路径不存在。

【解决方案】：

3.         加大恢复目标端恢复路径的空间，再次发起恢复。

4.         检查备份实例是否存在软链接文件，如果有，在恢复的目标端创建相同用户权限的路径（如/kingbase/TB）用以恢复。

l   Q8：恢复任务执行成功有警告，警告：恢复路径权限不正确。

【问题原因】：恢复任务启动实例失败，原因是实例路径属主不正确。

【解决方案】：修改实例路径属主后重启实例，或选择一个路径属主与备份用户相同的路径进行恢复。

l   Q9：恢复任务执行失败，报错：心跳消息超时。

【问题原因】：恢复任务执行过程中客户端存在断网。

【解决方案】：重新发起一次恢复任务。

l   Q10：恢复任务执行失败，报错：执行进程与服务器连接断开

【问题原因】：恢复任务执行过程中客户端存在断电或重启等现象。

【解决方案】：重新发起一次恢复任务。

l   Q11：恢复任务执行失败，报错：连接服务器失败；或者网络故障重连失败。

【问题原因】：恢复任务执行过程中服务端端存在断电断网或重启等现象。

【解决方案】：重新发起一次恢复任务。

l   Q12：恢复任务成功有警告，警告启动服务失败。

【问题原因】：实例启动失败，可能是存在同端口实例正在运行。

【解决方案】：

1.检查是否已有同端口实例再运行，执行netstat -a|grep KINGBASE 命令查询已有哪些端口在运行。

2. 关闭相同端口的实例，启动实例；或者修改恢复的实例数据路径下的配置文件中的端口号为其他端口号，再启动实例。

客户端安装目录下HBR_Client/etc/ClientService的kingbaseEnv.Config文件，为Kingbase可配置项，现加以说明，可按照需要进行配置。

archiveSize：判断归档日志剩余空间是否不足的最小值。当归档路径空间低于此值时，备份任务失败报错。修改此参数可修改备份任务判断归档日志路径空间是否不足的边界值，最小为2097152KiB（2GiB），最大值为9223372036854775807KiB，配置单位为KiB。

5 典型场景和问题