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.
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. |
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.
Syntax
>>-delbuta---+- -a age-----+---+-----------+--------------------> +- -d date----+ '- -t type--' +- -i dump id-+ '- -s---------' >-----+----------------+---+------+---+------+---+------+------>< '- -f file name--' '- -n--' '- -p--' '- -h--'
Parameters
To be eligible for deletion, a backup dump must have a creation date the same as, or earlier than, the date you specify.
Note: | Do not use any other parameters with this argument. |
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 |
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.
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 |
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
Examples
ADminname richard
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
Examples
AGe 10
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
Examples
butadumps
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
Examples
DAte 02/11/98
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
Examples
DUMPFile /usr/afs/buta/dumps.out
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
Examples
Excludefile /usr/afs/buta/delbuta.exc
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
Examples
Id 884203605
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 name(s) from the dump entries recorded by buta in the AFS/DFS backup database when dumps were performed.. |
Syntax
>>-Multiservers -value-----------------------------------------><
Parameters
Examples
Multiservers yes
The nodename option specifies the TSM client node name buta used when sending backup dumps to the TSM server(s). 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
Examples
Nodename puma
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
Examples
Password secret1
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
Examples
PRompt yes
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
Examples
SErvername server1
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
Examples
SYnc
The type option specifies the types of dumps to delete.
Syntax
>>-Type -value-------------------------------------------------><
Parameters
Examples
Type f
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 |
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
Examples
Dumpid 884203605
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
Examples
Groupid 1234