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

Last Published:
Product(s): NetBackup & Alta Data Protection (8.1.2)
  1. 使用 NetBackup Parallel Streaming Framework保护工作负载
    1.  
      关于 NetBackup Parallel Streaming Framework
    2.  
      关于Parallel Streaming Framework SDK
    3.  
      使用Parallel Streaming Framework的备份进程
    4.  
      使用Parallel Streaming Framework的还原进程
    5.  
      NetBackup Parallel Streaming Framework术语
  2. NetBackup Parallel Streaming Framework插件体系结构
    1.  
      插件操作
    2.  
      NetBackup Parallel Streaming Framework API 体系结构
    3.  
      支持的 NetBackup 功能
  3. 部署 NetBackup Parallel Streaming Framework SDK
    1.  
      操作系统和平台兼容性
    2.  
      NetBackupParallel Streaming Framework SDK 的许可证
    3.  
      下载 NetBackup Parallel Streaming Framework SDK
    4.  
      安装 NetBackup Parallel Streaming Framework SDK
  4. 插件开发准备
    1.  
      准备 NetBackup 环境
    2. 管理备份主机
      1.  
        在 NetBackup 主服务器上将 NetBackup 客户端添加到白名单
    3.  
      创建 BigData 备份策略
    4.  
      处理身份验证机制
    5.  
      在 NetBackup 中添加 凭据
    6.  
      安全注意事项
    7.  
      需要认证才能使插件可供使用
  5. 使用示例插件
    1.  
      关于示例插件
    2.  
      开发示例插件
  6. 开发工作负载插件
    1.  
      关于插件开发阶段
    2.  
      关于插件初始化阶段
    3.  
      关于插件声明阶段
    4.  
      关于插件卸载阶段
    5. 关于工作负载发现阶段
      1.  
        关于工作负载文件
    6.  
      关于数据备份阶段
    7.  
      关于还原阶段
    8.  
      关于恢复阶段
    9.  
      管理 API 的执行时间
    10.  
      在开发期间验证和测试插件
    11.  
      打包工作负载插件
  7. 部署工作负载插件
    1.  
      使用 NetBackup File Checksum Validator 工具验证插件
    2.  
      在备份主机上安装工作负载插件
    3.  
      为工作负载配置 NetBackup
    4.  
      执行工作负载的备份和还原
  8. NetBackup Parallel Streaming Framework API 参考
    1.  
      aapi_close_object
    2.  
      aapi_close_server
    3.  
      aapi_create_object
    4.  
      aapi_delete_object
    5.  
      aapi_discovery
    6.  
      aapi_flush
    7.  
      aapi_get_object_prop
    8.  
      aapi_get_object_prop_byname
    9.  
      aapi_get_server_prop
    10.  
      aapi_get_snappath_from_realpath
    11.  
      aapi_open_object
    12.  
      aapi_open_server
    13.  
      aapi_pgn_claim
    14.  
      aapi_pgn_init
    15.  
      aapi_postprocess
    16.  
      aapi_read_object
    17.  
      aapi_set_object_utimes
    18.  
      aapi_terminate
    19.  
      aapi_write_object
    20.  
      aapi_restore_preprocess
    21.  
      aapi_restore_postprocess
    22.  
      NetBackup Parallel Streaming Framework API 返回值
  9. 日志记录和故障排除
    1.  
      启用插件的日志记录

关于工作负载文件

在发现过程之后，插件为每个备份主机创建工作负载文件。每个备份主机的工作负载文件必须包含关联备份作业的时间点信息。必须为每个备份创建新的工作负载文件。工作负载文件使用快照 ID（对于已启用快照的备份）和表示要备份的数据的应用程序-对象层次结构。

工作负载文件的结构

工作负载文件具有二进制文件格式，并且结构为预定义结构。但是，应用程序-对象层次结构特定于工作负载。以下是工作负载文件的结构：

snapshot_name_length (uint64) snapshot_name
			objects_path-1_length (uint 64) object_path-1
			objects_path-2_length (uint 64) object_path-2
			
			objects_path-n_length (uint 64) object_path-n

以下是工作负载文件中的内容示例：

50  snapshot_name=snapshot1_06-05-2015_18:08:25.048027
4 /vm1                     (object path is maintained in the catalog)
11 /vm1/vdisk1             (object path is maintained in the catalog)
11 /vm1/vdisk2             (object path is maintained in the catalog)
4 /vm2                     (object path is maintained in the catalog)
11 /vm2/vdisk1             (object path is maintained in the catalog)
注意事项

  • 对于已启用快照的备份：

    • 工作负载文件具有在应用程序对象的层次结构之前提到的快照 ID。

    • 备份过程使用快照 ID (snapname) 来将对象路径 (realpath) 解析为实际路径 (snappath)，以引用有效的对象路径。为此，备份过程将为每个对象调用 aapi_get_snappath_from_realpath API。

      例如，当 NetBackup 使用快照 ID snapshot1_06-05-2018_18:08:25.048027 备份 /vm1/vdisk1 对象时，备份过程将执行以下操作：

      • 使用快照名称 snapshot1_06-05-2018_18:08:25.048027 和真实路径 /vm1/vdisk1 调用 aapi_get_snappath_from_realpath API，以获取实际路径 (snappath)

      • 获取可用于打开和读取磁盘对象的实际路径 /snapshot1_06-05-2018_18:08:25.048027/vm2/vdisk1。

      • 调用 aapi_open_object 以使用实际路径 (snappath) /snapshot1_06-05-2018_18:08:25.048027/vm2/vdisk1 打开磁盘对象，然后引用有效对象路径 /vm1/vdisk1

    • 接下来，备份过程使用实际路径来通过利用 aapi_get_object_prop_byname API 查询对象属性信息。备份过程将对象属性信息存储在主服务器上的 NetBackup 目录库中。存储在目录库中的信息将在还原期间使用。

  • 如果插件不支持创建快照，则备份过程会将工作负载文件中提到的对象路径视为实际路径，并使用它们通过利用 aapi_get_object_prop_byname API 查询对象属性信息。

  • 在以下位置创建工作负载文件：

    /install_path/tmp/masterserver/mediaserver/backuphost/policyname/apptype

注意:

要保证工作负载文件的安全性，在创建工作负载文件时，必须仅使用 root 权限设置 ACL。

使用自定义快照 ID

如果需要，插件开发人员可以自定义快照 ID。使用自定义快照 ID 时，它将替换为工作负载文件中 NetBackup 生成的快照 ID。但是，在后处理期间，仅使用 NetBackup 提供的原始快照 ID。因此，作为开发人员，您必须管理原始快照 ID 和自定义快照 ID 的映射。

此外，当您使用自定义 ID 时，且无论何时 NetBackup Parallel Streaming Framework从真实路径请求快照路径，NetBackup 都使用原始快照 ID。因此，作为开发人员，您必须管理原始快照 ID 和自定义快照 ID 的映射。

此外，当 NetBackup Parallel Streaming Framework从真实路径请求快照路径时，NetBackup 始终使用原始快照 ID。因此，当您使用自定义 ID 时，作为开发人员，您必须管理原始快照 ID 和自定义快照 ID 的映射，并将有效的相应快照路径返回到Parallel Streaming Framework。