搜索 <book_title>...

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

Last Published: 2018-10-19

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

关于工作负载发现阶段

下图说明了在发现阶段发生的不同任务：

图：工作负载发现阶段

发现阶段由以下任务组成：

工作负载发现阶段过程

下图说明了发现阶段过程：

图：工作负载发现阶段过程

nbaapidiscv 在代理备份主机上调用插件定义的发现 API，并执行工作负载应用程序的发现。
发现 API 以预定义的格式将发现信息放置在每个备份主机的工作负载文件中。
插件决定如何划分备份数据，以便可以使用多个备份主机进行备份。
在策略中配置多个备份主机时，发现 API 会为每个备份主机创建多个工作负载文件，并提供快照和备份相关信息。在这种情况下，多个作业在每个备份主机上独立运行，每个作业仅备份其工作负载文件中指定的数据。

发送到插件的信息

NetBackup Parallel Streaming Framework会将以下信息发送到插件：

备份选择	已配置策略中的备份选择。
备份主机	已配置策略中用于运行并行备份操作的可用备份主机。
工作负载输出目录	插件在其中创建工作负载文件的工作负载输出目录。输出目录包含 `backuphost.workloadfilesuffix` 格式的每个备份主机的工作负载文件。
工作负载文件名称后缀	追加到工作负载文件名的后缀。为备份主机创建的每个工作负载文件名必须追加此后缀，以便可以唯一标识文件。
备份计划类型	备份计划的类型 — 完全、差异增量式或累积增量式。
快照 ID	用于标识为工作负载数据创建的快照的唯一快照 ID。 NetBackup Parallel Streaming Framework使用触发备份作业时的时间戳作为快照 ID。工作负载文件和后处理中引用相同的快照 ID。如果需要，插件开发人员可以自定义快照 ID。请参见关于工作负载文件。

相关进程和 API

在工作负载发现阶段中，将按顺序触发以下 NetBackup 进程：

在发现阶段中，将按顺序调用以下 API：

表：发现阶段和 API 调用的序列

阶段	API 调用	插件引用示例
插件初始化	aapi_pgn_init	`aapi_pgn_init`
PSF 声明插件	aapi_pgn_claim	`samplepgn_claim_v1`
设置连接	aapi_open_server	`samplepgn_open_server_v1`
发现阶段	aapi_discovery	`samplepgn_discovery_v1`
插件卸载	aapi_close_server aapi_terminate	`samplepgn_close_server_v1` `samplepgn_terminate_v1`

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

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

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

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

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