| Oracle® Secure Backup Reference Release 10.1 Part Number B14236-03 |
|
|
View PDF |
| 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
