Veritas NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
名称
vlteject — 为以前运行的会话弹出介质并生成报告
大纲
-eject [-profile profile_name] [-robot robot_name] [-vault vault_name [-sessionid id]] [-auto y|n] [-eject_delay seconds]
-report [-profile profile_name] [-robot robot_name] [-vault vault_name [-sessionid id]] [-legacy]
-eject -report [-profile profile_name] [-robot robot_name] [-vault vault_name [-sessionid id]] [-auto y|n] [-eject_delay seconds] [-version] [-legacy]
-preview [-vault vault_name [-profile profile_name]] [-profile robot_no / vault_name / profile_name] [-robot robot_name][-sessionid id]
在 UNIX 系统上,此命令的目录路径为 /usr/openv/netbackup/bin/
在 Windows 系统上,此命令的目录路径为 install_path\NetBackup\bin\
描述
对于尚未为其弹出介质的保管库会话,vlteject 会弹出介质并按照配置文件中的配置生成相应的报告。vlteject 可以为所有会话,或者特定某个机械手、保管库或配置文件处理暂停的弹出和报告操作。在处理所有暂停的弹出和报告操作时,不要使用 -profile、-robot 或 -vault 选项。
vlteject 只对会话目录仍然存在的会话执行操作。清除该目录后(由 NetBackup 删除),vlteject 将无法再为该会话弹出介质或生成报告。
vlteject 是否可以交互方式运行取决于其调用的方式。当计划弹出的介质多于介质访问端口的适合数量时,请以交互方式运行。
不要在 vlteject 运行时修改保管库配置。
可以通过以下任何一种方式运行 vlteject:
直接从命令行运行
使用 NetBackup 策略日程表。该策略必须是 Vault 类型,并且该策略的文件列表必须包含 vlteject 命令。
使用 vltopmenu 运行弹出操作或合并的弹出或报告操作
如果以下具有公共写入权限的目录已存在,则 vlteject 将写入其每日调试日志文件中:
UNIX 系统:usr/openv/netbackup/logs/vault
Windows 系统:install_path\netbackup\logs\vault
每日调试日志文件为 log.DDMMYY;DDMMYY 为当前日期。
由于并非所有写入该文件的可执行文件都是以管理员或 root 用户身份运行的,因此需要公共写入权限。主机属性“保留保管库日志 n 天”决定了保管库会话目录的保留时间。
任何得到授权的用户均可运行此命令。
有关 NetBackup 授权的更多信息,请参考 NetBackup 安全和加密指南。
选项
- -auto y|n
指定自动 (y) 或交互模式 (n)。在自动模式 (y) 下,vlteject 在运行时不接受用户输入,也不显示输出。在交互模式(默认模式)下,vlteject 以交互方式运行。它接受输入并显示输出。
- -eject
为指定的会话弹出介质。如果弹出已完成而且只需生成报告,则 -eject 是可选项。
- -eject_delay seconds
弹出介质前延迟的秒数。如果最近在受影响的介质上执行了备份或复制等操作,则此选项很有用。默认值为 0。最大值为 3600(1 小时)。
- -legacy
使用旧样式的合并来生成报告。仅当与 -report 选项一起使用时才有效。
- -preview
列出会话以及为会话弹出的介质。但并不弹出介质。
- -profile robot _no / vault_name / profile_name
标识从中弹出介质并生成报告的机械手编号、保管库名称和配置文件名称。所有这三个选项都必须与 -profile 一同使用。要处理所有暂停的弹出和报告操作,请仅对 -profile 使用 profile_name 选项。
- -report
为指定的会话生成报告。如果相应的弹出过程已结束,则将从选定会话生成并分配所有暂停的报告。如果再次运行 vlteject,则不会再次生成这些报告。如果弹出过程未完成,则会生成与弹出过程完成与否无关的一部分报告。如果在弹出过程结束后再次运行 vlteject -report,则会再次生成这些报告。
- -robot robot_no
指定机械手编号,该编号用于标识要弹出介质和生成报告的机械手。机械手中的所有保管库都应使用相同的场外卷组。在处理所有暂停的弹出和报告操作时,不要使用 -profile、-robot 或 -vault 选项。
- -sessionid id
数字会话 ID。如果指定 -profile、-robot 或 -vault,但未指定 -sessionid,则 vlteject 将对指定的配置文件、机械手或保管库的所有会话进行操作。
- -vault vault_name
要为其弹出介质并生成报告的保管库。在处理所有暂停的弹出和报告操作时,不要使用 -profile、-robot 或 -vault 选项。
- -version
显示 vlteject 版本,然后退出。
示例
示例 1 - 为具有特定会话(尚未弹出介质)的所有机械手弹出介质并生成报告:
# vlteject -eject -report
示例 2 - 弹出尚未为 CustomerDB 保管库的所有会话弹出的所有介质并生成相应的报告:
# vlteject -vault CustomerDB -eject -report
返回值
保管库退出时的状态码可能会大于 255。此类状态码称为扩展退出状态码。对于此类情况,返回到系统的退出状态为 252。实际退出状态将按如下格式写入 stderr:EXIT status = exit status
《NetBackup 故障排除指南》和《NetBackup 故障排除向导》中介绍了扩展的退出状态值。
文件
UNIX 系统:
/usr/openv/netbackup/db/vault/vault.xml /usr/openv/netbackup/logs/vault/log.mmddyy /usr/openv/netbackup/vault/sessions/vlt_name/sidxxx/detail.log /usr/openv/netbackup/vault/sessions/vlt_name/sidxxx/summary.log /usr/openv/netbackup/vault/sessions/vlt_name/sidxxx/vlteject_status /usr/openv/netbackup/vault/sessions/vlteject.mstr /usr/openv/netbackup/bp.conf
Windows 系统:
install_path\NetBackup\db\vault\vault.xml install_path\NetBackup\logs\bpbrmvlt\mmddyy.log install_path\NetBackup\logs\vault\mmddyy.log install_path\NetBackup\vault\sessions\vlt_name\sidxxx\detail.log install_path\NetBackup\vault\sessions\vlt_name\sidxxx\summary.log install_path\NetBackup\vault\sessions\vlt_name\sidxxx\vlteject.status install_path\NetBackup\vault\sessions\vlteject.mstr install_path\NetBackup\bp.conf
另请参见
请参见vltopmenu(1m)。