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.  
      启用插件的日志记录

关于恢复阶段

必须从备份阶段开始为工作负载插件规划有效的恢复策略。恢复阶段取决于要保护的工作负载。例如,与虚拟机恢复相比,数据库需要不同的恢复说明。

以下步骤介绍了数据恢复的大致过程:

  1. 在工作负载文件中添加恢复元数据

    在此子阶段中,恢复元数据将添加到工作负载文件中,以捕获恢复信息。备份过程将捕获所需的信息并更新 NetBackup 目录库。

  2. 恢复工作负载数据

    在此子阶段中,还原进程将从 NetBackup 目录库中读取恢复元数据,并根据恢复信息来恢复工作负载数据。

恢复阶段的注意事项
  • 必须使用单个备份主机来备份一个父对象的所有元数据和恢复文件。

  • 在还原期间无法修改恢复元数据。

用于计划恢复阶段的 NetBackup PSF API

以下 API 用于恢复阶段:

表:用于工作负载恢复的 API

API

描述

aapi_restore_preprocess

框架将在恢复阶段调用此 API 来执行恢复前任务,如关闭服务、卸载数据库等。

aapi_restore_postprocess

框架调用此 API 来启动工作负载数据的恢复。

aapi_set_object_utimes

框架调用此 API 来收集完整的恢复信息,并使其可用于后处理。

在工作负载文件中添加恢复元数据

在备份对象发现期间,插件可以使用工作负载文件存储恢复元数据。该恢复元数据在数据恢复阶段检索并使用。

元数据包括备份对象的层次结构、备份选择的父对象、所有文件的位置和列表,以及工作负载数据恢复所需的信息。这些文件可以包括恢复过程中所需的任何物理文件、其他元数据文件或清单文件。

  1. 在工作负载文件中添加占位符以收集其他元数据。工作负载文件中的其他元数据可以是新节点,并可包含有关父对象和其他恢复项目的信息。备份对象可在父对象和元数据下列出。

    请参见关于工作负载文件

    例如,在以下工作负载文件段中,工作负载需要实际的备份选择 backup_selection、快照目录 snapshot_dir、元文件 manifest_file_name 和快照信息 snapshot_file_name 来恢复工作负载:

    /backup_selection/
    /backup_selection/recovery_metadata/
    /backup_selection/recovery_metadata/checkpoint
    /backup_selection/recovery_metadata/checkpoint/checkpoint_file_name
    /backup_selection/recovery_metadata/snapshot_dir
    /backup_selection/recovery_metadata/snapshot_dir/manifest_file_name
    /backup_selection/recovery_metadata/snapshot_dir/snapshot_file_name
    /backup_selection/backup_data/
    /backup_selection/backup_data/logs
    /backup_selection/backup_data/logs/log_file_name
    /backup_selection/backup_data/data
    /backup_selection/backup_data/data/database_file_name
    

    注意:

    在给定的示例中,工作负载文件包含用于备份的数据。此备份数据分为 recovery_metadatabackup_data 部分。recovery_metadata 部分包含成功恢复的信息,backup_data 部分包含实际工作负载数据。

  2. 添加恢复元数据部分之后,工作负载插件必须扫描工作负载文件,捕获与恢复相关的所需信息,准备备份映像并完成备份。

    请参见关于数据备份阶段

恢复工作负载数据

恢复工作负载数据包括还原阶段和数据恢复,数据恢复基于工作负载文件中所捕获的恢复元数据进行。

  1. 在还原阶段,如果框架调用 aapi_set_object_utimes API,还原进程会读取恢复元数据,然后收集数据恢复所需的所有信息。系统将捕获恢复信息和可恢复项目,并将其保存在文件或内存中。

    在还原阶段,如果框架调用 aapi_set_object_utimes API,系统将捕获可恢复项目,并将其保存在文件或内存中。然后,API 收集数据恢复所需的所有信息。

    请参见关于还原阶段

    例如,在添加恢复元数据的步骤 1 中给出的工作负载文件段中,aapi_set_object_utimes 调用将先读取 /backup_selection/backup_data/data/database_file_name 信息。然后,API 会查找 recovery_metadata 条目,随后查找可恢复选择 /backup_selection/recovery_metadata/、快照目录 snapshot_dir 以及任何其他信息。

  2. 框架调用 aapi_restore_postprocess API,并在 aapi_set_object_utimes 调用之后启动已还原对象的恢复。恢复说明基于要保护的工作负载。例如,可以恢复数据库以作为表装入,或者数据库服务可以变为活动状态。对于虚拟机,可指示已还原的计算机注册到 Hypervisor 或 VMware。