Tivoli Storage Manager AFS/DFS Backup Clients


Using the delbuta Utility Command

This chapter provides information about the delbuta utility command. This command lets an AFS administrator delete an AFS/DFS backup dump from both TSM storage and the AFS/DFS backup databases.


Deleting Backup Dumps with delbuta

The delbuta command deletes backup dumps from both TSM storage and the AFS or DFS backup database and synchronizes the TSM file space database with the backup database. You must hold administrative tokens/credentials to use this command unless you are performing a test. To perform a test, enter the delbuta command with the -n parameter.

Note:All required parameters can be set in the delbuta.opt file. You can then start delbuta without any command line parameters.

Setting Delbuta Options in the Delbuta Configuration File

You can set all delbuta options in the delbuta configuration file and then run delbuta without any command line parameters. Optionally, you can specify parameters on the command line in conjunction with the delbuta configuration file options. If you specify any command line parameters, then delbuta will override the corresponding option specified in the configuration file except for dump selection options.

You can use the age, id or date option to select which dumps to delete. Or, you can select the sync option to synchronize TSM buta filespaces with the backup database dumps. You can specify only one of the above dump selection options, either in the configuration file or on the command line.

TSM uses the nodename, adminname, and password options to find the dumps on the TSM server. You must specify these options in the configuration file. If you have only one TSM server, you must specify the servername option. If you have more than one TSM server, then specify the multiserver option and set it to yes. The nodename, adminname, password, servername, and multiserver options are not available as command line parameters.

Note:The servername option is not used when the multiserver option is set to yes.

You can copy the delbuta.opt.smp file to delbuta.opt in your installation directory. You can store your delbuta configuration file in any directory to which you have write access. Remember to set the delbuta_config environment variable to point to your delbuta options file. The default AFS delbuta configuration file is located at /usr/afs/buta/delbuta.opt. The default DFS delbuta configuration file is located at /var/dce/dfs/buta/delbuta.opt. For a list of delbuta options and their functions, see Table 13.

Delbuta Command

Syntax

>>-delbuta---+- -a age-----+---+-----------+-------------------->
             +- -d date----+   '- -t type--'
             +- -i dump id-+
             '- -s---------'
 
>-----+----------------+---+------+---+------+---+------+------><
      '- -f file name--'   '- -n--'   '- -p--'   '- -h--'
 

Parameters

-a age
Indicates the age of a backup dump in days. To be eligible for deletion, a backup dump must be the age you specify or older.

-d date
Specifies a date in the following format:
mm/dd/yy

To be eligible for deletion, a backup dump must have a creation date the same as, or earlier than, the date you specify.

-i dump id
Specifies the dump ID of the backup dump you want to delete.

-s
Synchronizes the TSM file space database with the AFS or DFS backup database. Each TSM backup that was created using the buta command is identified and checked for a corresponding backup dump entry in the backup database. If a match is not found, the backup dump is deleted from the TSM file space.
Note:Do not use any other parameters with this argument.

-t type
Indicates the type of backups you want to delete. The types are:

f
Full backups only. Delete only full backups that are eligible for deletion based on the age, date, or dump ID you specify.

i
Incremental backups only. Delete only incremental backups that are eligible for deletion based on the age, date, or dump ID you specify.

a
Additional incremental backups. Delete any full or incremental backups that are eligible for deletion based on the age, date, or dump ID you specify, and delete any additional incremental backups that are based on those backups. This is the default.

-f file name
Indicates the name of a file containing a list of backup dumps. The format of the file must be identical to the output format from an AFS backup dumpinfo command, or a DFS bak dumpinfo command. The delbuta command uses this file instead of retrieving similar information from AFS using the backup dumpinfo command, or from DFS using the bak dumpinfo command. It also deletes any listed backups based on the age, date, dump ID, and type you specify.

-n
Provides a preview of what the delbuta command would do given the specified arguments. When you use this parameter, the delbuta command does not delete any backup dumps.

-p
Causes the delbuta program to display a prompt prior to each deletion.

-h
Displays help information for the delbuta command.
Note:Do not use any other arguments or flags with this argument.

Examples

Table 12 shows some options you can use with the delbuta command.

Table 12. Examples of Tasks and Commands

Task Command
Delete all full and incremental backup dumps that are 30 days or older, and delete all incremental backups that are associated with those backup dumps. delbuta -a 30
Delete only incremental backups that were created on or before May 15, 1998 and display a prompt before each deletion. delbuta -d 05/15/98 -t i -p

Delbuta Options

Table 13 gives a summary of each delbuta option you can set in the delbuta configuration file and the page on which it can be found.

Table 13. delbuta Options

Options Function Page
adminname Specifies your administrator name registered with the TSM server on which are stored the backup dumps you want to delete. adminname
age Specifies the age of dumps that are to be deleted. age
butadumps Specifies that only dumps created by the buta command should be deleted. butadumps
date Specifies the date of dumps that are to be deleted. date
dumpfile Specifies the path and file name of a file containing a list of backup dumps. dumpfile
excludefile Specifies the path and file name of an exclude file. excludefile
id Specifies a particular dump to be deleted. id
multiservers Specifies whether the server name is to be retrieved from the backup dump or the option file. multiservers
nodename Specifies the name of the client node from which the backup dumps were sent. nodename
password Specifies an administrator password. password
prompt Specifies whether to prompt before deleting a backup dump. prompt
servername Specifies the name of the server where backup dumps are stored. servername
sync Specifies deletion of all dumps if there are no corresponding dumps. sync
type Specifies the types of dumps to delete. type

adminname

The adminname option specifies your administrator name registered with the TSM server that stores the backup dumps you want to delete. You must have the appropriate authority to delete file spaces. This option is not available as a command parameter.

Note:If you have multiple TSM servers, remember to use the same administrator name for all of them.

Syntax

>>-ADminname -administrator name-------------------------------><
 

Parameters

administrator name
Specifies an administrator name registered with the TSM server which stores the backup dumps you want to delete.

Examples
ADminname richard

age

The age option specifies the deletion of dumps that are the same age or older than this age. Do not use this option with the id, date or sync option.

Syntax

>>-AGe -number of days-----------------------------------------><
 

Parameters

number of days
The age of the backup dump.

Examples
AGe 10

butadumps

The butadumps option specifies that only dumps created by the buta command are to be deleted. Dumps created by the original butc command are not deleted.

Syntax

>>-butadumps---------------------------------------------------><
 

Parameters

none

Examples
butadumps

date

The date option specifies the deletion of dumps with a creation date the same as or earlier than this date. Do not use this option with the id, age or sync option.

Syntax

>>-DAte - mm/dd/yy---------------------------------------------><
 

Parameters

mm/dd/yy
The creation date of the backup dump.

Examples
DAte 02/11/98

dumpfile

The dumpfile option specifies the path and file name of a file containing a list of backup dumps. The file format must be identical to the output format from an AFS or DFS backup/bak dumpinfo command.

Syntax

>>-DUMPFile - filespec-----------------------------------------><
 

Parameters

filespec
The path and file name of your file containing the dumps list.

Examples
DUMPFile /usr/afs/buta/dumps.out

excludefile

The excludefile option specifies the path and file name of an exclude file. This option is not available as a command line parameter.

Syntax

>>-Excludefile -filespec---------------------------------------><
 

Parameters

filespec
The path and file name of your exclude options file.

Examples
Excludefile /usr/afs/buta/delbuta.exc

id

The id option specifies the backup dump you want delbuta to delete. Do not use this option with the age, date or sync option.

Syntax

>>-Id -dumpid--------------------------------------------------><
 

Parameters

dumpid
dumpid value

Examples
Id 884203605

multiservers

The multiservers option specifies whether multiple TSM servers were used for buta dumps. This option is not available as a command line parameter.

Note:When you specify this option, delbuta gets the TSM server names from the dump entries recorded by buta in the AFS/DFS backup database when dumps were performed..

Syntax

>>-Multiservers -value-----------------------------------------><
 

Parameters

value
The valid values for this option are:

yes
Get the server name from the backup dump.

no
Read the server name from delbuta options file. This is the default.

Examples
Multiservers yes

nodename

The nodename option specifies the TSM client node name buta used when sending backup dumps to the TSM servers. This option is not available as a command line parameter.

Note:If you have multiple TSM servers, remember to use the same node name on all servers.

Syntax

>>-Nodename -nodename------------------------------------------><
 

Parameters

nodename
The name of the client node that sent the backup dumps which are to be deleted.

Examples
Nodename puma

password

The password option specifies your TSM administrator password. This option is not available as a command line parameter.

Note:If you use multiple TSM servers for buta dumps, use the administrator password on all servers.

Syntax

>>-Password -password------------------------------------------><
 

Parameters

password
The password for the administrator name you specify with the adminname option.

Examples
Password secret1

prompt

The prompt option specifies whether you want to be prompted before delbuta deletes a dump from the backup database and the TSM server.

Syntax

>>-PRompt-value------------------------------------------------><
 

Parameters

value
The valid values for this option are:

yes
Prompt before deleting each dump.

no
Do not prompt, just delete each dump. This is the default.

Examples
PRompt yes

servername

The servername option specifies the name of the TSM server which stores the backup dumps to be deleted. This option is not available as a command line parameter.

Note:If you use multiple TSM servers for buta dumps, this option is not used.

Syntax

>>-SErvername- --servername------------------------------------><
 

Parameters

servername
The name of the server from which you want to delete backup dumps.

Examples
SErvername server1

sync

The sync option specifies deletion of all dumps from the TSM database if the corresponding dumps do not exist in the AFS/DFS backup database.

Syntax

>>-SYnc--------------------------------------------------------><
 

Parameters

none

Examples
SYnc

type

The type option specifies the types of dumps to delete.

Syntax

>>-Type -value-------------------------------------------------><
 

Parameters

value
The valid values for this option are:

f
Delete full backups only.

i
Delete incremental backups only.

a
Delete any full or incremental backups that are eligible for deletion based on the age, id, or date you specify, and delete any additional incremental backups that are based on those backups. This is the default.

Examples
Type f


Exclude File Options

Table 14 shows the two exclude options you can set in the file pointed to by the excludefile option. A description of each option is also provided.

Table 14. Exclude File Options

Option Function Page
dumpid Specifies the id of the dump you want to exclude from deletion. dumpid
groupid Specifies the group of dumps you want to exclude from deletion. groupid

dumpid

The dumpid option specifies a dump to exclude from deletion. Set this option in the file pointed to by the excludefile option.

Syntax

>>-Dumpid -dumpid----------------------------------------------><
 

Parameters

Dumpid
The dump you want to exclude from deletion.

Examples
Dumpid 884203605

groupid

The groupid option specifies a group of dumps to exclude from deletion. Set this option in the file pointed to by the excludefile option.

The buta program must create this group id before you specify it as an option.

Syntax

>>-Groupid -groupid--------------------------------------------><
 

Parameters

Groupid
The group of dumps you want to exclude from deletion.

Examples
Groupid 1234


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]