搜索 <book_title>...

Veritas NetBackup 并行流框架 SDK 开发人员指南

Last Published: 2018-10-19

Product(s): NetBackup & Alta Data Protection (8.1.2)

关于数据备份阶段

当发现作业成功完成之后，介质服务器上的 bpbrm 进程会将工作负载文件分发到相应的备份主机，并在备份主机上启动备份任务。与发现作业不同，备份作业在 BigData 策略中配置的所有备份主机上运行。请参见使用Parallel Streaming Framework的备份进程。

启动备份进程之后，bpbrm 进程在介质服务器上运行并在所有备份主机上激活备份阶段 (bpbkar)。

备份阶段过程

下图说明了备份阶段过程：

图：备份阶段过程

bpbkar 进程读取在工作负载发现阶段创建的工作负载文件。工作负载文件包含含有快照标识符（对于已启用快照的备份）的文件和应用程序对象层次结构。请参见关于工作负载文件。
根据工作负载，执行以下任一步骤：
- 对于已启用快照的备份：
  - 工作负载文件具有在应用程序对象的层次结构之前提到的快照 ID。
  - 备份过程使用快照 ID (snapname) 来将对象路径 (realpath) 解析为实际路径 (snappath)，以引用有效的对象路径。为此，备份过程将为每个对象调用 aapi_get_snappath_from_realpath API。
  - 接下来，备份过程使用实际路径来通过利用 aapi_get_object_prop_byname API 查询对象属性信息。备份过程将对象属性信息存储在主服务器上的 NetBackup 目录库中。存储在目录库中的信息将在还原期间使用。
- 对于已启用快照的备份，工作负载文件具有在应用程序对象层次结构之前提到的快照标识符。
  备份过程使用快照标识符 (snapname) 来将对象路径 (realpath) 解析为实际路径 (snappath)，以引用有效的对象路径。为此，备份过程将为每个对象调用 aapi_get_snappath_from_realpath API。接下来，备份过程使用实际路径来通过利用插件实施的 aapi_get_object_prop_byname API 查询对象属性信息。备份过程将对象属性信息存储到主服务器上的 NetBackup 目录库中以用于各种目的。
备份过程调用 aapi_open_object API，以使用实际路径打开对象。
成功之后，通过迭代调用 aapi_read_object API 来读取由对象表示的数据。
读取的数据将发送到介质服务器以进行数据移动。
读取完成之后，将通过调用 aapi_close_object API 关闭对象。

相关进程和 API

在备份阶段中，将按顺序触发以下 NetBackup 进程：

bpbrm 进程在介质服务器上运行。
bpbkar 在所有备份主机上运行备份。

在备份阶段中，将按顺序调用以下 API：

表：备份阶段 API 调用的序列

阶段	API 调用	API 参考示例
插件初始化	aapi_pgn_init	`aapi_pgn_init`
PSF 声明插件	aapi_pgn_claim	`samplepgn_claim_v1`
设置连接	aapi_open_server	`samplepgn_open_server_v1`
备份阶段	aapi_get_snappath_from_realpath aapi_get_object_prop_byname aapi_open_object aapi_read_object aapi_close_object	`samplepgn_get_snappath_from_realpath_v1` `samplepgn_get_object_prop_byname_v1` `samplepgn_open_object_v1` `samplepgn_read_object_v1` `samplepgn_close_object_v1`
插件卸载	aapi_close_server aapi_terminate	`samplepgn_close_server_v1` `samplepgn_terminate_v1`

在 NetBackup 中添加插件初始化阶段的日志记录信息

除了现有错误之外，还可以在关联的调试日志文件中填充自定义日志。

请参见启用插件的日志记录。

在开发期间验证和测试插件

在开发期间测试插件时，请查看相应开发阶段的日志。在构建整个插件之前，作业可能会失败。您需要验证特定阶段的成功日志。

例如，如果完成发现阶段的开发，则备份可能会失败，但发现必须成功。

请参见在开发期间验证和测试插件。