obcleanup

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

-a

Shows individual archive records in addition to volume records.

-d

Shows previously deleted records.

-s

Sorts the list by date (d), volume id (v), or volume tag (t).

-v

Operates in verbose mode. The more -v options you specify, the more verbose the output.

-V

Displays the obcleanup version and exits.

Example

Example 5-5 shows the editable file generated by the obcleanup utility for host brhost2.

% 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