sam-nrecycler - Recycles Oracle HSM volumes
∕opt∕SUNWsamfs∕sbin∕sam-nrecycler
[-n]
SUNWsamfs
The sam-nrecycler command
invokes the nrecycler.
The nrecycler removes expired archive copies
and frees up archive volumes.
Often, the nrecycler is invoked
through root's crontab (1) file at an off-peak time.
However, the nrecycler can be invoked at any time.
The sam-nrecycler command provides
additional support to aid in the ability to use Oracle HSM
dump files for Oracle HSM archive retention capabilities. The nrecycler
will scan file system metadata
and Oracle HSM dump files to determine which removable media and disk
archive volumes contain archive images so space on unused volumes
can be reclaimed. The nrecycler will identify all the archive
images present on a removable media volume or disk archive tar
ball by scanning all file system .inodes files and specified
Oracle HSM dump files. By scanning the file systems and Oracle HSM dump
files, the nrecycler can determine if there are volumes which
do not contain any archive images and the space on these volumes
can be reclaimed. If a removable media volume does not contain
any archive images, it is safe to relabel the cartridge. If a
disk archive tar ball does not contain any archive images, it is
safe to remove the tar ball from the disk archive directory.
You must provide directives to the nrecycler through lines entered
in the ∕etc∕opt∕SUNWsamfs∕nrecycler.cmd file.
User must specify a path to directories containing all Oracle HSM
dump files to be searched.
If no directories are specified in the command file,
recycling does not occur.
The user is responsible for making
sure the list of directories is complete and all Oracle HSM dump
files are contained in the directory list.
The nrecycler
cannot validate the Oracle HSM dump file list. All removable media
and disk volumes are eligible to be selected as obsolete, and
thus eligible to be relabeled or unlinked.
After the nrecycler detects that a removable media volume contains only free and expired space, thus it is safe to relabel, the nrecycler invokes the sam-nrecycler.sh script. The script can relabel the cartridge using either the original VSN or a new VSN; or it can export the cartridge from the library; or it can perform another user-defined action.
After the nrecycler detects that a disk archive volume contains only free and expired space, the nrecycler will unlink the unused disk archive tar ball.
This command accepts the following options:
-nPrevents any actions from being taken.
The sam-recycler command should not be used. The nrecycler will scan all file system .inodes files and specified Oracle HSM dump files. Since sam-recycler only will scan file system .inodes files it will incorrectly reclaim space on archive volumes that has space occupied by archive copies in the Oracle HSM dump files.
You must have the nrecycler command enabled by setting the
nrecycler = yes
option in the ∕etc∕opt∕SUNWsamfs∕defaults.conf file.
The nrecycler is designed to run periodically. It performs as much work as it can each time it is invoked. Between executions, the nrecycler keeps Oracle HSM dump file information in a nrecycler dat file.
All files in Oracle HSM dump directories must be valid Oracle HSM dump files. Hidden files, files that begin with a dot, are skipped. During the first scan of a dump, the nrecycler will create a dat file. The nrecycler dat file will be created in the same directory as the dump file with the string 'SUNWsamfs' appended to the original dump file's name. A nrecycler dat file contains a summary of which removable media and and disk archive volumes contain archive images for the dump. This is a nrecycler performance optimization so the dump file does not need to be reread during every execution of the nrecycler. If an Oracle HSM dump should no longer be processed, the nrecycler's dat file for the file must be removed from the dump directory.
All removable media and disk archive volumes will be examined and must be owned by this instantiation of SAM. The nrecycler should not be used in a SAM-remote environment. However, if disk archive volumes are not shared between servers, the nrecycler will work correctly on disk volumes that are reside on other machines.
The nrecycler checks to see if there are removable media volumes that were selected for
recycling that have not yet been post-processed. If such volumes
exist, and they are now devoid of active archive copies, the sam-nrecycler
command invokes the ∕etc∕opt∕SUNWsamfs∕scripts∕nrecycler.sh (1m),
which post-processes these volumes with arguments including the generic media
type (tp or od),
the VSN, the element address in the library, and the equipment number
of the library in which the volume resides. The script can
relabel the cartridge using either the original VSN or a new VSN; or
it can export the cartridge from the library; or it
can perform another user-defined action.
The nrecycler.sh script will not be invoked
if the amount of space used on a removable media volume is less than 50% of total space
available on the volume.
Each time it is run, the nrecycler performs these steps:
1. Build a list of all removable media and disk archive volumes configured in Oracle HSM. For faster searching, a hash table will be used to hold volume information.
2. Collect a list of all file systems configured in Oracle HSM. All Oracle HSM file systems, or for which we are the metadata server, must be mounted to allow the .inodes file to be read.
3. Generate a list of specified Oracle HSM dump directories. Initialize samfsdump file processing by walking each of the specified directories and validating the contents of every file. Every file in the directory must be a valid samfsdump file or a nrecycler dat file must exist for a dump file.
4. Scan file systems' .inode file reading each inode in all file systems. For each archive copy, the VSN on which the copy resides is accumulated into the VSN table.
5. Scan all Oracle HSM dump files reading each inode in all dump files. For each archive copy, the VSN on which the copy resides is accumulated into the VSN table. During the first scan of a dump, the nrecycler will create a dat file. Subsequent execution of the nrecycler will use VSN summary information from the dat file.
6. Depending on the disk archives' maximum sequence number, multiple file system .inodes and Oracle HSM dump file scans may be necessary.
7. Select removable media and disk volumes that are obsolete and eligible to be relabeled or unlinked.
None.
