Veritas NetBackup™ Commands Reference Guide
- Introduction
- Appendix A. NetBackup Commands
Name
bpstudel — delete NetBackup storage unit or storage unit group
SYNOPSIS
-label storage_unit_label [-verbose] [-M master_server [,...]] [-reason "string"]
-group storage_unit_group [-M master_server [,...]]
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/
On Windows systems, the directory path to this command is <install_path>\NetBackup\bin\admincmd\
DESCRIPTION
The bpstudel command deletes a NetBackup storage unit or storage unit group. The command must include either a label name for the storage unit or a group name for the storage unit group, but not both.
If bpstudel cannot delete the storage unit (for example, the storage unit label is mistyped), it does not return an error message. You can run bpstulist to verify that the storage unit was deleted.
Errors are sent to stderr
. A log of the command's activity is sent to the NetBackup admin log file for the current day.
For more about storage units, see the NetBackup Administrator's Guide, Volume II.
Any authorized user can run this command.
For more about NetBackup authorization, see the NetBackup Security and Encryption Guide.
OPTIONS
- -label storage_unit_label
The name of the storage unit. This option is required. The maximum length for a storage-unit label is 128 characters.
- -group storage_unit_group
Deletes the specified storage unit group the name. If this option is present, the named storage unit group is deleted.
- -M master_server [,...]
Runs this command on each of the master servers in this list. This list is a comma-separated list of master servers. The master servers must allow access by the system that issued the command. If an error occurs for any master server, the process stops at that point. The default is the master server for the system where the command is entered.
- -reason "string"
Indicates the reason why you choose this command action. The reason text string that you enter is captured and appears in the audit report. Enclose this string with double quotes ("..."). The string must not exceed 512 characters. It cannot begin with a dash character (-) nor contain a single quotation mark (').
- -verbose
Selects the verbose mode for logging. This mode is meaningful only when you run with the debug log function on (that is, when the following directory is defined):
UNIX systems:
/usr/openv/netbackup/logs/admin
Windows systems:
install_path\NetBackup\logs\admin
EXAMPLE
Delete the storage unit named tst.dsk and list the existing storage units before and after the deletion:
# bpstulist
UNIX systems:
stuunit 0 mango 0 -1 -1 1 0 /tmp/stuunit 1 1 2000 *NULL* tst.dsk 0 mango 0 -1 -1 3 0 /hsm3/dsk 1 1 2000 *NULL*
Windows systems:
stuunit 0 mango 0 -1 -1 1 0 C:\tmp\stuunit 1 1 2000 *NULL* tst.dsk 0 mango 0 -1 -1 3 0 C:\hsm3\dsk/ 1 1 2000 *NULL*
# bpstudel -label tst.dsk # bpstulist
UNIX systems:
stuunit 0 mango 0 -1 -1 1 0 /tmp/stuunit 1 1 2000 *NULL*
Windows systems:
stuunit 0 mango 0 -1 -1 1 0 C:\tmp\stuunit 1 1 2000 *NULL*
FILES
UNIX systems:
/usr/openv/netbackup/logs/admin/*
Windows systems:
install_path\NetBackup\logs\admin\*