Oracle® Secure Backup Reference Release 10.1 Part Number B14236-03 |
|
|
View PDF |
Purpose
Use the obcleanup
tool to generate an editable file listing the volumes in the Oracle Secure Backup catalogs and to remove unneeded records.
If previously used volumes are unlabeled or overwritten, then the index daemon automatically removes expired backups from the catalog at the interval set by the indexcleanupfrequency index policy (the default is 21 days). In this case, no manual intervention is necessary.
If volumes expire but are not unlabeled or overwritten, then their catalog entries persist unless you remove them with obcleanup
. You can also use obcleanup
to remove references to volumes that are no longer needed but are not set to expire. Because the catalogs can consume considerable disk space, you may want to run obcleanup
periodically to keep the admin
subdirectory of the Oracle Secure Backup home to a manageable size.
Prerequisites
The obcleanup
utility operates only on the administrative server.
Usage Notes
When you run the obcleanup
program on the command line, it lists the contents of the catalogs in a file, which is opened in an editor. The default text editor is set by the EDITOR
environment variable. On Linux and UNIX, the default is /bin/vi
if the EDITOR
environment variable is not set. On Windows the default is Notepad.
Each line in the file contains a reference to a volume that you could purge from the catalogs. For example:
#Item Identification Created Where Notes #---- ---------------------------- -------------- ----- --------------------- 1 VOL000001 2004/06/07.15:51 IS IX volume is full
Volumes that have expiration policies associated with them are noted in this file. If you have discarded or overwritten tapes, then use a text editor to delete the lines corresponding to these tapes from the file, save the modified file, and exit the editor.
After you delete records from the generated file and save it, obixd
runs in the background and automatically removes the deleted records from the catalogs. You can configure the obixd
cycle time in the indexcleanupfrequency index policy. The default cycle time is 21 days.
Syntax
etc/obcleanup [ -a ] [ -d ] [ -s { d | v | t } ] [ -v ]... etc/obcleanup [ -V ]
Semantics
Shows individual archive records in addition to volume records.
Shows previously deleted records.
Sorts the list by date (d
), volume id (v
), or volume tag (t
).
Operates in verbose mode. The more -v
options you specify, the more verbose the output.
Displays the obcleanup
version and exits.
Example
Example 5-5 shows the editable file generated by the obcleanup
utility for host brhost2
.
Example 5-5 Sample Output from obcleanup
% etc/obcleanup # This file lists all volumes described in Oracle Secure Backup's # "volumes" and "index" databases on brhost2. # # Edit this file to delete entries from Oracle Secure Backup's databases. # Delete each line whose corresponding database entry you want # to remove. Do not change the contents of the undeleted lines! # # Once you've finished, save your changes and exit the editor. # obcleanup will ask you to confirm these changes before applying # them to the databases. # #Item Identification Created Where Notes #---- ---------------------------- -------------- ----- --------------------- 1 tag 00000105 IS 2 tag 00000110 IS 3 tag 00000111 IS 4 tag 00000121 IS 5 tag 00000155 IS 6 tag 00000156 IS 7 tag 00000157 IS 8 tag 00000158 IS 9 tag AEA649S IS 10 tag AEA650S IS 11 tag AEA655S IS 12 tag AFX935 IS 13 tag AFX936 IS 14 tag AFX936 IS 15 full-000001 2005/01/17.18:12 IX 16 full-000002 2005/01/17.18:12 IX 17 full-000003 2005/01/17.18:12 IX 18 full-000004 2005/06/05.01:02 IX 19 full-000005 2005/07/04.01:02 IX 20 full-000006 2005/08/06.01:04 IX 21 full-000007 2005/09/06.01:00 IX 22 full-000008 2005/09/06.01:00 IX 23 full-000009 2005/11/04.15:05 IX 24 full-000010 2005/11/04.15:05 IX