nbu bpbackup 是 NetBackup (NBU) 的核心命令行工具之一，主要用于手动触发备份作业，它通常由管理员在需要绕过标准调度、进行一次性备份或进行故障排查时使用。
（图片来源网络，侵删）
命令基本语法
nbu bpbackup [-options] -p <policy_name> -k <clients_file>
-p <policy_name>: 必需参数，指定要使用的备份策略的名称，策略定义了备份的内容、时间、存储位置等核心规则。-k <clients_file>: 必需参数，指定一个包含要备份的客户端主机名的文件，这个文件通常每行一个主机名。
常用参数详解
下面我们将参数按功能进行分类,并解释其用途和示例。
基本与核心参数
| 参数 | 全称 | 描述 | 示例 |
|---|---|---|---|
-p |
policy |
必需，指定要执行的备份策略。 | -p MyProductionDB_Policy |
-k |
clients |
必需，指定包含客户端列表的文件路径。 | -k /tmp/client_list.txt |
-s |
sched |
指定策略中要使用的调度名称，一个策略可以包含多个调度（每日、每周），如果不指定，通常使用策略的默认调度。 | -s "Weekly Full" |
-f |
files |
直接在命令行中指定要备份的文件或目录列表，而不是使用 -k 文件，这会覆盖策略中定义的客户端列表。 |
-f "/data /app/logs" |
-w |
window |
指定备份作业必须在其时间窗口内启动，如果当前时间不在窗口内，作业将排队等待。 | -w "22:00-04:00" |
备份类型与调度参数
| 参数 | 全称 | 描述 | 示例 |
|---|---|---|---|
-t |
backup_type |
强制指定备份类型，会覆盖策略中的默认设置，常用值： - FULL: 完全备份- INC: 增量备份- DIF: 差异备份- COLD: 冻结备份 (针对数据库) |
-t FULL |
-d |
date |
指定一个特定的日期来模拟调度，这对于测试或重放特定日期的备份非常有用，日期格式通常为 MM/DD/YYYY。 |
-d "10/26/2025" |
输出与日志参数
| 参数 | 全称 | 描述 | 示例 |
|---|---|---|---|
-L |
log |
指定一个本地日志文件路径来记录 bpbackup 命令本身的执行情况（参数解析、连接状态等）。这不是备份作业的日志。 |
-L /var/log/netbackup/bpbackup_manual.log |
-debug |
debug |
启用调试模式，输出非常详细的调试信息，对于排查连接问题、权限问题等非常有用。 | -debug |
-quiet |
quiet |
减少输出信息，只显示错误或关键信息。 | -quiet |
行为与控制参数
| 参数 | 全称 | 描述 | 示例 |
|---|---|---|---|
-force |
force |
强制执行备份作业，即使客户端的状态不正常（down 或 busy），或者备份窗口已过，也会尝试启动作业。请谨慎使用。 |
-force |
-client |
client |
指定主客户端，当策略涉及多个客户端（如客户端-主客户端模型）时，使用此参数指定哪个是主客户端。 | -client master_server_hostname |
-retry |
retry |
如果备份作业失败，指定重试的次数。 | -retry 3 |
高级与特定功能参数
| 参数 | 全称 | 描述 | 示例 |
|---|---|---|---|
-use_policy_storage |
use_policy_storage |
强制使用策略中定义的默认存储单元。 | -use_policy_storage |
-stunit |
storage_unit |
覆盖策略，指定本次备份要使用的存储单元，这对于将备份重定向到不同的磁盘或磁带库非常有用。 | -stunit "DeduplicationStorageUnit" |
-images |
images |
指定一个映像列表文件，这个文件包含要备份的特定数据映像的列表，通常用于特殊场景，如数据库备份。 | -images /tmp/db_images.list |
-progress |
progress |
显示备份作业的进度信息。 | -progress |
综合示例
假设我们有以下场景：
- 策略名称:
WebServer_Policy - 客户端列表文件:
/tmp/web_servers.txt(内容:web01,web02) - 目标: 手动对这个策略下的所有客户端执行一次完全备份，并强制在非调度时间执行。
示例 1：基本手动备份
nbu bpbackup -p WebServer_Policy -k /tmp/web_servers.txt
这条命令会使用 WebServer_Policy 策略的默认调度，备份 web_servers.txt 文件中列出的所有客户端。
示例 2：强制执行完全备份（无视时间和客户端状态）
nbu bpbackup -p WebServer_Policy -k /tmp/web_servers.txt -t FULL -force
-t FULL: 强制执行完全备份。-force: 即使现在不是策略的调度时间，或者某个客户端响应缓慢，也会立即尝试启动备份作业。
示例 3：指定备份窗口并记录详细日志
nbu bpbackup -p WebServer_Policy -k /tmp/web_servers.txt -w "23:00-05:00" -L /var/log/nbu_manual_backup.log
-w "23:00-05:00"：作业只会在晚上11点到早上5点之间启动。-L: 将bpbackup命令的执行日志记录到指定文件。
示例 4：为单个客户端备份特定文件（覆盖策略设置）
假设我们只想备份 web01 上的 /var/www/html 目录，而不是整个策略定义的内容。
（图片来源网络，侵删）
nbu bpbackup -p WebServer_Policy -f "web01:/var/www/html" -t FULL
-f "web01:/var/www/html": 直接指定了客户端和要备份的路径，这会忽略策略中为web01定义的标准文件列表。- 注意: 这种方式要求策略本身允许这种动态指定，或者管理员有足够的权限。
重要注意事项
- 权限: 执行
bpbackup的用户账户必须在 NetBackup 管理员服务器上拥有相应的权限，通常是OPERATOR或更高。 - 客户端列表文件:
-k指定的文件必须是纯文本文件，并且每行一个有效的 NetBackup 客户端主机名。 - 策略优先级:
bpbackup命令的参数（如-t,-stunit）会覆盖策略中定义的默认设置，但不会改变策略本身的定义。 - 查看作业状态: 手动启动的备份作业，其状态和日志可以通过 NetBackup Administration Console (图形界面) 或
bpjlist(命令行) 命令来查看。# 查看最近的备份作业列表 bpjlist -d -all_columns
- 与
bpbkar的区别:bpbackup是启动备份作业的命令，它运行在管理服务器上，而bpbkar(Backup, Archive, Restore) 是实际执行文件数据备份的进程，它运行在客户端上。bpbackup会调用客户端上的bpbkar。
希望这份详细的参数解析能帮助你更好地理解和使用 nbu bpbackup 命令！
