Legato NetWorker Commands Reference
http://www.ipnom.com/Legato-NetWorker-Commands/nsrmm.html
nsrmm
nsrmm - NetWorker media management commandSYNOPSIS
nsrmm [ -C ] [ -v | -q ] [ -s server ] [ -f device ]
nsrmm -m [ -v | -q ] [ -s server ] [ -f device ] [ -r ] [ volume ]
nsrmm -l [ -v | -q ] [ -s server ] [ -f device ] [ -myB ] [ -e forever
] [ -c capacity ] [ -o mode ] [ -b pool ] [ -R | volume ]
nsrmm { -u | -j } [ -v | -q ] [ -s server ] [ -y ] [ -f device |
volume.. ]
nsrmm -p [ -v | -q ] [ -s server ] [ -f device ]
nsrmm { -d | -o mode } [ -v | -q ] [ -s server ] [ -Py ] [ -S
ssid[/cloneid] | -V volid | volume ... ]
nsrmm -S ssid [ -w browse-time ] [ -e retention-time ]
DESCRIPTION
nsrmm a command line interface to manage the media and devices (tapes,
disks, and files) used by NetWorker servers and storage nodes.
A volume is a physical piece of media, for example, a tape or disk car-
tridge. When dealing with file type devices, volume refers to a direc-
tory on a file system. NetWorker must have exclusive use of this
directory, as files will be created and removed. The NetWorker system
keeps track of which user files have been saved on which volumes, so
they can be more easily recovered. Every volume managed by NetWorker
has a volume name (also known as a volume label) selected by an opera-
tor. A volume name is specified when the volume is first introduced to
the system. It can only be changed when a volume is relabeled. The
volume should have an external label displaying its volume name for
future reference. NetWorker refers to volumes by their volume names,
for example, when requesting a volume for recovery.
The NetWorker system automatically manages an index that maps saved
user files to volumes. NetWorker also keeps other attributes associ-
ated with a volume, including the expected capacity of the volume.
The NetWorker server requests that specific volumes be mounted by their
name for recoveries, or any writable volumes for saves. These requests
are submitted through the nsr_notification(5) mechanism. The
nwadmin(1) console window or the nsrwatch(1) command can be used to monitor
pending mount requests. Typically, the requests will also be written
to the system console, or logged in a file. The same requests can be
used as input for software that controls a jukebox (a device that auto-
matically loads and unloads volumes).
Before the nsrmm command can be used (that is, before any data can be
saved or recovered), at least one device must be configured for the
NetWorker server. The NetWorker configuration may be modified with the
nwadmin(1) Administration menus or the nsradmin(1) command after Net-
label operation is canceled and an error message is displayed.
If the volume does not contain a label that is readable by the
current device, the volume may be labeled. This option is used
by nsrd(1) when automatically labeling volumes on behalf of
nsrmmd(1) requests.
-b pool
Specifies the pool to which the volume belongs. -b pool can
name any pool currently registered with nsrd. The possible val-
ues can be viewed by selecting the Pools menu item from the
Administration menu of nwadmin(1) or using the nsradmin(1) com-
mand. The pool name is referenced by nsrd when determining
which save sets can reside on the volume. If you omit this
option, the volume is automatically assigned to the Default
pool. If you specify a pool name without specifying a volume
name, the next volume name associated with the pool's label tem-
plate resource is used.
-C Displays a list of NetWorker configured devices and the volumes
currently mounted in them. This list displays only the devices
and volumes assigned to the server, not the actual devices and
volumes. The -p option verifies the volume label. -C is the
default option.
-c capacity
Overrides the default capacity of a volume. NetWorker normally
uses built-in default capacities based on the device type. This
option overrides these defaults. The format of the specifica-
tion is number multiplier. Multiplier can be one of 'K' (1024
bytes), 'M' (1000 KB), or 'G' (1000 MB). Lower case letters are
also accepted, as are extra characters like spaces, or an extra
'B' after 'K', 'M', or 'G'. Number may be any value, including
an integer or real number, with up to three decimal places.
-d Deletes the client file indexes and media database entries from
the NetWorker databases. The action does not destroy the vol-
ume: instead, it removes all references used by NetWorker to the
volume and the user files contained on it. This option can be
used to control the size of the NetWorker databases.
-e time
When used in conjunction with the -S option, it sets the reten-
tion time of the specified save set. The retention time should
be specified in the format that is acceptable to the function
nsr_getdate(1). Note that once the save set becomes recyclable,
the retention time may not be changed. The save set retention
time may not be set such that the save set would become recy-
clable while it is still browsable. Refer to the -w option for
more details on browse time. When used in conjunction with vol-
umes, the volume labeled will be an Archive volume if the value
of time is forever (Archive volumes mean that the volume label
never expires). Any other value of time are not applicable to a
volume.
-f device
Specifies a device explicitly. When more than one device has
been configured, nsrmm will select the first device by default.
This option overrides the selection made by nsrmm.
-l Labels (initializes) a volume for NetWorker to use and recog-
nize. Labeling must be performed after the desired volume is
physically loaded into the device, either by an operator or a
jukebox.
-m Mounts a volume into a device. Mounting is performed after a
volume is placed into a device and labeled. You can mount only
labeled volumes. The labeling and mounting operations can be
combined into a single command line. See the EXAMPLES section.
-o mode
Sets the mode of a volume, save set, or save set instance
(clone). The mode can be one of the following: [not]recyclable,
[not]readonly, [not]full, [not]manual or [not]suspect. The
[not]recyclable mode applies to both volumes or save sets, but
not clones. The [not]readonly, [not]full and [not]manual modes
apply only to volumes. The [not]manual mode is the only valid
mode when used with the -l option. The [not]suspect mode
applies only to save set instances, meaning it must be specified
along with -S ssid/cloneid, not just -S ssid by itself. (Remem-
ber that every instance of a save set has a clone id, even the
original.) See nsrim(1) for a discussion of the per-volume
flags. The suspect flag is set automatically when a recover(1)
encounters a media error recovering data from a particular save
set clone.
-P When used in conjunction with the -d option the corresponding
file index entries are purged, without deleting the entries in
the media database. The scanner(1) command can then be used to
recover the file index entries.
-p Verifies and prints a volume's label. To confirm that the
external volume label matches the internal label, load a volume
into a drive and use this option to display the volume name in
the label. Verifying a label unmounts mounted volumes.
-q Quiet mode. This option tells nsrmm to print out as little
information as possible while performing the requested opera-
tion. Generally, only error messages are printed.
-R Relabels a volume. This option rewrites the volume label and
purges the NetWorker indexes of all user files previously saved
on the volume. Some of the volume usage information is main-
tained.
-r Mounts a volume as read-only. To prevent NetWorker from writing
to a volume, specify the read-only flag when mounting the vol-
ume. Volumes marked as full and those in the read-only mode (-o
readonly) are automatically mounted read-only.
-s server
Specifies the NetWorker server to perform. the nsrmm operation
on. See nsr(1) for a description of server selection.
-S ssid
Changes ( -o) or removes ( -d) a save set from the NetWorker
databases, or used in changing the browse time (specified with
you unload it from a device.
-V volid
Removes a volume from the NetWorker databases when used in con-
junction with the -d option. The volume is identified by a vol-
ume identifier, or volid. The mminfo(1) command can be used to
determine volume identifiers.
-v Verbose mode. This option polls the NetWorker server to print
out more information as the operation proceeds.
-w browse time
Specifies the browse time for the specified save set (supplied
with the -S option). Note that once the save set becomes recov-
erable, the browse time may not be changed. The browse time
should be specified in the format that is acceptable to the
function nsr_getdate(1). The browse time has to be after the
insert time in the save set record, but it cannot be after the
retention time. If the option -e was not used, the existing
retention time in the save set record is used for comparing with
the specified browse time. See under the option -e for more
details on retention time.
-y Do not confirm (potentially destructive) operations before per-
forming them. This option must be used with extreme care.
EXAMPLES
Labeling new tapes:
To introduce a new tape, named mars.001, to the NetWorker sys-
tem, load the tape in an empty drive, then use the command:
nsrmm -l mars.001
The tape is labeled with mars.001 and an entry is made in the
appropriate NetWorker indexes. The mminfo(1) command may be
used to inspect the volume database and display information
about the volumes:
mminfo -m
Mounting a tape:
To mount a NetWorker volume, use the -m option. Note that the
volume must have been labeled previously and loaded in the
drive:
nsrmm -m
When mounting, a volume name can also be specified:
nsrmm -m mars.001
The mount will fail unless the given volume name matches the one
read from the media.
By mounting a volume, you make the volume available to Net-
Worker. When nsrmmd(1) needs the volume, the label will be read
again and confirmed, preventing accidental data loss. Volumes
are also verified and mounted automatically if the server recov-
ers after a crash.
Unmounting or ejecting a volume:
When a volume needs to be unmounted, use either the -u or -j
option, depending on whether or not the device can physically
eject a volume.
nsrmm -u
When more than one volume is mounted, you can specify either the
volume name or device to select the desired volume. The follow-
ing example ejects the volume named mars.003.
nsrmm -j mars.003
Displaying the current volumes:
The -C option displays the configured devices and the mounted
volumes. This is the default option.
nsrmm -C
Deleting a volume:
To remove references to a volume and the user files saved on it
from the NetWorker indexes, use the -d option. This option does
not modify the physical volume, and should only be used when the
physical volume is destroyed. By deleting a volume, you free up
space in the NetWorker file index and the NetWorker media index,
but not much more than if you had purged it. The amount of
space released depends on the number of user files saved on the
volume. The following example deletes the volume mars.003:
nsrmm -d mars.003
The scanner(1) command can be used to rebuild the database
entries.
Purging file index entries:
The file index contains information about each file saved by
NetWorker. Due to size constraints, it may be necessary to
purge information from the file index. When a volume or save
set is deleted, the corresponding file index entries are also
removed. It is also possible to preserve the media database
entries of a volume while purging the file index by specifying
the -P option when deleting.
The following example purges all of the file index entries for
volume mars.001:
nsrmm -d -P mars.001
The scanner(1) command can be used to recover the file index.
SEE ALSO
nsr(1), nsr_getdate(3), nsr_layout(5), nsr_device(5), nsr_notification(5), mminfo(1), mmlocate(1), nwadmin(1), nsrmmd(1), nsradmin(1), nsrim(1), recover(1), scanner(1).
DIAGNOSTICS
type family volume mounted on device, write enabled
Message indicating that the -m (mount) option was successfully
performed on a device with the given media type and media fam-
duplicate name; pick new name or delete old one
It is illegal to label two tapes with the same name. If you
wish to reuse a name, remove that volume from the index using
the -d option.
Are you sure you want to over-write volume with
a new label?
An attempt is being made to relabel a volume. A positive con-
firmation will overwrite the existing data on that tape.
Purge file index entries for type family volume? ...
After confirmation, the file index entries are removed.
volume not in media index
The media index has no entry associated with volume, so the -m
command cannot be used. This problem may be caused by mistyping
the volume name when the tape was originally labeled, or delet-
ing it.
No valid family label
The tape or disk in the named device does not have a valid Net-
Worker label.
来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/611609/viewspace-686415/，如需转载，请注明出处，否则将追究法律责任。
转载于:http://blog.itpub.net/611609/viewspace-686415/
174
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
