Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
nbholdutil — run the utility that places and removes holds on backup images
SYNOPSIS
-create -holdname hold_name [-reason "string"] -filepath filepath | -backupid backup_ID -primarycopy | -allcopy
-add -holdid hold_id | -holdname hold_name [-reason "string"] -filepath filepath | -backupid backup_ID -primarycopy | -allcopy
-list [-holdid hold_id] | [-holdname hold_name] | [-backupid backup_ID -primarycopy | -allcopy] [-U [-include_extended_info]]
-list -holdname hold_name -U -include_extended_info > bid.txt
-delete -holdid hold_id] | -holdname hold_name [-force] [-reason "string"]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/goodies
On Windows systems, the directory path to this command is install_path\NetBackup\bin\goodies
DESCRIPTION
The nbholdutil utility places holds on backup images. The holds provide a mechanism to override existing retention levels. These holds ensure that backup images and associated media are retained until the holds are released.
nbholdutil performs the following operations:
-create creates a hold on one or more holds for backup images.
-add adds one or more images to an existing hold.
-list outputs a list of all holds. This operation also creates the backup ID (BID) file.
-delete deletes one or more holds.
Only authorized users can run this command.
nbholdutil cannot hold an incremental backup image with zero files. If either a differential or cumulative incremental backup has zero (0) files in the backup image, nbholdutil fails with EXIT STATUS = 1401.
OPTIONS
- -allcopy
Includes all copies of the specified backup image.
- -backupid backup_ID
Specifies the backup ID of the backup image.
- -filepath filepath | -primarycopy | -allcopy
Specifies the file path to the backup image.
- -force
Bypasses a prompt to confirm the release of the hold. This option is useful in a script because it allows the release operations to continue without waiting for a response to the prompt.
- -holdname hold_name
Specifies a unique name for the hold.
- include_extended_info > bid.txt
Provides more details regarding the images on hold and creates a backup (BID) in which to store the information.
- -primarycopy
Includes only the primary copy of the specified backup image.
- -reason "string"
Indicates the reason for performing this command action. The reason text string that you enter is captured and appears in the audit report. Enclose the string with double quotes ("...") and the string cannot exceed 512 characters. It cannot begin with a dash character (-) nor contain a single quotation mark (').
- -U
Reports in user format which includes additional user information.
EXAMPLES
Example 1 - Create a hold that is called legal_case1
. The backup image ID is win81.sky.com_1307425938
. The -allcopy option indicates that the hold includes all copies of the selected backup image. If this option is not included, this operation holds only the primary copy of the selected backup image.
# nbholdutil -create -holdname legal_case1 -backupid win81.sky.com_1307425938 -allcopy