NSRIM(8) Legato NetWorker 3.0 NSRIM(8)
NAME
nsrim - NetWorker index manager program
SYNOPSIS
nsrim [ -b browse ] [ -c client ] [ -N name ] [ -o order ] [ -r
retention ] [ -x percent ] [ -lnqv ]
DESCRIPTION
Nsrim is used to manage NetWorker's on-line file and media indexes.
Normally, nrsim is invoked from the savegroup(8) command. Nsrim is
not normally run by hand.
Nsrim uses policies (see nsrpolicy(5) and nsrclient(5)) to deter
mine which on-line entries to manage and how to manage them. Entries
that have been in an on-line file index longer than the period speci
fied by the respective client's browse policy are removed. Save sets
that have existed longer than the period specified by a client's
retention policy are marked as recyclable in the media index. When
all of the save sets on a volume have been marked recyclable, then
the volume is considered recyclable. Recyclable volumes may be
selected by NetWorker when a writable volume is needed to hold new
backups. When a recyclable volume is re-used, the old data is erased
and is no longer recoverable.
Unless the -q option is given, nsrim prints out information about
each group of save sets. For each group of save sets, the client's
name, the controlling browse and retention policies, the total on-
line file index size, how much of this space is actually used, how
much space is actually used by this group, and the name of the group
is printed. Then for each volume in the media index, its name and
eligibility for over-writing are printed.
When the -v option is given, the following information is also
printed for each save set: creation date, size, level, name, and its
status. A save set's status will be either browsable, recoverable,
or recyclable. The entries for browsable save sets are still in the
on-line file index. Recoverable save sets are no longer in the on-
line file index, but are recoverable from the backup media. Recy
clable save sets are recoverable until their containing volume is
over-written,
Unless the -n option is given, nsrim performs the following steps:
First, the on-line file index is searched for save sets that have
been in it longer than their corresponding browse policy (see
nsrclient(5) and nsrpolicy(5)) period. Entries that have exceeded
their browse policy are removed from the on-line file index. Second,
the media index is searched for entries that have surpassed their
corresponding retention policy period. Those that have are marked as
recyclable. Finally, the volume entries are searched for those con
taining only recyclable save sets. These entries are marked recy
clable.
RETENSION POLICIES
Under normal circumstances the association between retension policies
Licensed material--property of copyright holder(s) 1
NSRIM(8) Legato NetWorker 3.0 NSRIM(8)
and clients' save sets is obvious. However, there are exceptions and
clarifications listed below:
Save set names that do not match ``All'' or names explicitly found in
NetWorker client resource records, bind to the most common prefix
save set name listed for the client. If there is no common prefix,
then policies are obtained the shortest save set name found in the
client's resource records.
Save sets which have no corresponding NetWorker client resource
records use those of the NetWorker server itself.
A save set cannot be purged from the index or marked for recycling
until all of its dependent save sets are also eligible for purging or
recycling.
The last (and only) Full save set will not be purged from the on-line
index until it is also marked for recycling.
Ad hoc save sets are treated as Full save sets that never have any
dependents. However unlike true Full save sets, the last Ad hoc save
set is not given any special consideration with regard to index purg
ing.
OPTIONS
-b browse
Use the specified policy rather than the browse policy found
on the client's resource.
-c client
Only process the on-line file index for the specified client.
Normally, all client indexes are processed.
-l Remove the oldest full save and all save sets that depend on
it from the on-line index. This does not affect the retention
period.
-n Do nothing. Instead, only generate a report showing the cur
rent status of the on-line file indexes and volumes.
-N name
Only valid when the -c option is also specified. Only save
sets named name are processed, all others are skipped.
-o order
Controls the order in which columns are printed in the report.
The default order is cbriuafn, representing client, browse,
recover, index size, index utilization, amount of space used
by like named save sets, number of fulls, and the save set
name, respectively.
-q Run quietly. This option will not generate progress and sta
tus messages.
Licensed material--property of copyright holder(s) 2
NSRIM(8) Legato NetWorker 3.0 NSRIM(8)
-r retention
Use the specified policy rather than the retention policy
found on the client's resource.
-x percent
Set the utilization threshold. If, after removing entries, it
is predicted that an on-line file index's utilization will be
less than the specified amount, the index is automatically
compressed with nsrck(8).
-v Produce a more detailed report.
FILES
/nsr/mm/mmvolume
/nsr/index/clientname/db
SEE ALSO
nsrlayout(5), nsrd(8), mm(8), mminfo(8), nsrck(8), nsrclient(5),
nsrpolicy(5), save(8), savegroup(8)
DIAGNOSTICS
You are not authorized to run this command
Nsrim must be run by root.
can't bind to NSR service on servername
Nsrim must be run on the same machine that provides the NSR
service. See nsrd(8).
No index database found for client clientname
An entry for clientname was found in the resource directory,
but no on-line file index was found. This may happen when a
client has been created, but has never saved any data.
No client resource found for index database clientname
An on-line file index exists for clientname, but a description
of the client could not be found in the resource directory.
This message may be printed when a client has been deleted,
but its on-line file index has not been removed.
No client resource found for save sets associated with clientname
Save sets exist for clientname, but a description of the
client could not be found in the resource directory. This may
happen after a client has been deleted. In this case the
server's policy descriptions will be applied to the client's
save sets.
unable to mark volume volumename as recyclable
The update to the media index failed, the volume will remain
as it was.
WARNING: the retention period (period) is less than the browse
period (period), skipping.
A client resource was found that specifies a retention policy
with a period that is shorter than the specified browse
Licensed material--property of copyright holder(s) 3
NSRIM(8) Legato NetWorker 3.0 NSRIM(8)
policy. This client's index entries will not be processed.
clientname's index contains nnn entries should be mmm
There is an inconsistency between the media and on-line file
indexes for clientname. This should be a transitory problem
as nsrck will eventually reconcile the differences.
Licensed material--property of copyright holder(s) 4