IBM Tivoli Storage Manager, Version 7.1

Delete Backup

The delete backup command deletes files, images, and virtual machines that were backed up to Tivoli® Storage Manager server storage. Your administrator must give you authority to delete objects.

When you delete files, Tivoli Storage Manager takes all of the backed up files that meet the 'filespec' and 'deltype' options that are specified and deactivates them. The server also assigns a deactivation date of 'infinite-minus' so that the files are no longer available for restore and are purged, immediately on the subsequent run of file expiration. The file is not physically removed until the expiration process runs.

Important: After you delete backup files, you cannot restore them. Verify that the backup files are no longer needed before you delete them. Tivoli Storage Manager prompts whether you want to continue with the delete. If you specify yes, the specified backup files are scheduled for deletion and removed from Tivoli Storage Manager server storage.

Supported Clients

This command is valid for all clients.

Syntax


>>-Delete BAckup-- --+---------+-------------------------------->
                     '-options-'   

>--+-----------------------------------------------------+--+--------------------+-->
   |                                   .-objtype=FILE--. |  '-vmname--objtype=VM-'   
   '-+-filespec----------------------+-+---------------+-'                           
     '-{--filespacename--}--filespec-' +-objtype=FILE--+                             
                                       '-objtype=IMAGE-'                             

   .-deltype=ACTIVE-------.   
>--+----------------------+------------------------------------><
   +-+----------------+---+   
   | '-deltype=ACTIVE-'   |   
   +-+------------------+-+   
   | '-deltype=INACTIVE-' |   
   '-+-------------+------'   
     '-deltype=ALL-'

Parameters

filespace/filespec

Specifies the path and file name that you want to delete from storage. To specify a file in another file space, precede the file name with the file space name. Use wildcard characters to specify a group of files or all files in a directory. Separate file specifications with a space. You can also use the filelist option to process a list of files. The Tivoli Storage Manager client opens the file that is specified with this option and processes the list of files within according to the specific command.

Note: If you indicate filespacename, do not include a drive letter in the file specification.

When using -deltype=inactive or -deltype=active, use wildcard characters to specify a group of files or all files in a directory.

When using -deltype=all, specify a fully wildcarded directory.

VMNAME: Specifies the name of a virtual machine. Backups for the specified virtual machine are deleted. The virtual machine name cannot contain wildcard characters.

objtype

Specifies the type of backup delete you want to create. You can specify either of the following values:

FILE

Specifies that you want to delete directories and files. This is the default.

IMAGE

Specifies that you want to delete an image backup. Specifies that you want to delete an image backup. Objtype=image is not supported on Mac OS X.

VM

Specifies that you want to delete one or more versions of a virtual machine backup; the virtual machine is identified by the vmname parameter.

When objtype=VM is specified, the deltype and filelist options cannot be used.

When objtype=VM, this command deletes only virtual machine backups that were created with any of the following modes: FULL, IFINCR, and IFFULL. This command does not delete backups that are created with MODE=INCR.

If the backup that is being deleted is a full VM backup (MODE=FULL or MODE=IFFULL), and if the server also has incremental backups that were created after the full backup, then the full backup, and all subsequent incremental backups, are deleted.

If you delete an active backup for a virtual machine, the most recent inactive copy becomes the active backup. If you specify the -pick or -inactive option, only the backup that you specify is deleted. If you select a backup that is created by MODE=IFINCR, only the selected incremental backup is deleted; other incremental backups for the virtual machine are not deleted.

deltype

Specifies the deletion type. Specify one of the following values:

ACTIVE: Delete only active file objects. Directory objects are not deleted. This is the default.
Note: If there are any inactive objects, then after the active object is deleted, the most current inactive object is changed from inactive to active.

To delete all versions of a file, first issue the delete backup command with -deltype=inactive, then issue the command again with -deltype=active.
INACTIVE: Delete only inactive file objects. Directory objects are not deleted.
ALL: Delete all active and inactive objects below a particular directory, including all subdirectories and their files.
Note: The parent directory of the deleted files and subdirectories is not deleted. If you specify deltype=ALL, you cannot use the pick option because deltype=ALL and the pick option are mutually exclusive.

Table 1. Delete Backup command: Related options
Option	Where to use
description	Command line only.
filelist	Command line only.
fromdate	Command line, and in the GUI find function.
fromtime	Command line, and in the GUI find function.
noprompt	Command line only.
pick	Command line only.
pitdate	Command line, and in the GUI find function.
pittime	Command line, and in the GUI find function.
subdir	Client options file (dsm.opt) or command line.
tapeprompt	Client options file (dsm.opt) or command line.
timeformat	Client options file (dsm.opt) or command line.
todate	Command line, and in the GUI find function.
totime	Command line, and in the GUI find function.

Examples

Task: Delete all active and inactive file objects named budget in directory /data/plan/proj1.
Commands:
delete backup /data/plan/proj1/budget.jan -deltype=inactive
delete backup /data/plan/proj1/budget.jan -deltype=active
Task: Delete all inactive files with a name ending in .txt backed up from the /data/plan/proj1 directory and its subdirectories.
Command: delete backup "/data/plan/proj1/*.txt" -deltype=inactive -subdir=yes
Task: Delete selected active files that are backed up from the /home/marymb/project directory. Use the -pick option to display a list of backup copies that match the file specification. From the list, you can select which versions to delete.
Command: delete backup "/home/marymb/project/*" -pick
Task: Delete all active and inactive versions of files and subdirectories in the /home/storman/myproject directory. Then, delete all active and inactive versions of the /user/myproject directory.
Command:
delete backup "/home/storman/myproject*"
-deltype=all
Task: Delete all active file objects from file space abc in the proj directory.
Command: delete backup {abc}\proj\*
Task: Delete all inactive files with a name ending in .txt backed up from the c:\plan\proj1 directory and its subdirectories.
Command: delete backup c:\plan\proj1\*.txt -deltype=inactive -subdir=yes
Task: Delete selected active files that are backed up from the c:\project directory. Use the -pick option to display a list of backup copies that match the file specification. From the list, you can select which versions to delete.
Command: delete backup c:\project\* -pick
Task: Delete all active and inactive versions of files and subdirectories in c:\user\myproject.
Command: delete backup c:\user\myproject\* -deltype=all

Note: The backup versions of directory object c:\user\myproject are not deleted.
Task: Delete the active backup of a virtual machine namedvm.
Command: delete backup -objtype=vm orion.example.com

Note: If one or more inactive versions of this backup exist, the most recent becomes the active version.
Task: Delete one or more backup versions of a virtual machine named vm_test.
Command: delete backup -objtype=vm -inactive vm_test

Note: All versions of backups for this VM node are displayed in a list; you select the versions to delete.

Feedback