MM(8) Legato NetWorker 3.0 MM(8)
NAME
mm - NetWorker media management command
SYNOPSIS
mm -m [ -v ] [ -f device ] [ -r ] [ volume ]
mm -l [ -v ] [ -f device ] [ -m ] [ -e expiration ] [ -c capacity ] [
-R | volume ]
mm [ -u | -j ] [ -v ] [ -f device | volume.. ]
mm -p [ -v ] [ -fdevice ]
mm -C [ -v ] [ -fdevice ]
mm [ -d | -o | -O ] [ -v ] [ -P ] [ -Sssid | volume... ]
DESCRIPTION
The mm command provides a command-line interface to manage the media
and devices (tapes and disks) used by NetWorker servers.
A volume is a physical piece of media, for example, a tape or disk
cartridge. The NetWorker system keeps track of which user files have
been saved on each volume, so they can be more easily recovered.
Every volume managed by NetWorker has a volume name selected by an
operator. A volume's name is specified when the volume is first
introduced to the system. It may be changed only 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 recov
ery.
The NetWorker system automatically manages an index mapping saved
user files to volumes. NetWorker also keeps other attributes associ
ated with a volume, including the volume's expiration date and the
expected capacity of the volume.
The NetWorker server requests specific volumes be mounted by their
volume name for recoveries, or any writable volumes for saves. These
requests are submitted through the nsrnotification(5) mechanism.
The networker(8) console window or the nsrwatch(8) command may 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 could be used as input to software which controls a jukebox,
a device that automatically loads and unloads volumes.
Before the mm command can be used, or actually save and recover data,
at least one device must be configured for the NetWorker server.
This is usually done when NetWorker is installed with the nsrize(8)
command. The NetWorker configuration may be modified with the net
worker(8) administration menus or the nsradmin(8) command after Net
Worker has been installed.
OPTIONS
-C A list of NetWorker configured devices and the volumes mounted
on them is displayed. This just prints out what the server
thinks is mounted, without performing any volume operations,
while the -p option described below causes another verifica
tion of the label. This is the default option.
Licensed material--property of copyright holder(s) 1
MM(8) Legato NetWorker 3.0 MM(8)
-c Specify a volume's capacity. NetWorker will use built-in
default capacities based on the device's type. The default
may be overridden with the -c option. The format of the spec
ification is number multiplier. Multiplier may be one of `K'
(1024 bytes), `M' (1000K), or `G' (1000M). 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 Delete the indexes for a volume and all of the user files on
that volume from the NetWorker databases. This does not actu
ally destroy the volume, it just removes all references to it
and the user files contained on it. This option can be used
to control the size of the NetWorker databases.
-e Set the expiration date for labeling. The default expiration
of two years may be overridden with the -e sub-option. Expi
ration is entered in getdate(3) format, with the word forever
meaning an archive tape that never expires.
-f Specify a device. When more than one device has been config
ured, mm will select the first device by default. The device
may be explicitly specified by using the -f option.
-j Eject a volume. Similar to an unmount operation, but will
also physically eject the volume from the device if this is
supported. Many disk devices and some tapes do not support
this.
-l Label a volume. Label and initialize a volume for the Net
Worker system. Labeling must be done after the desired volume
is physically loaded into the device, by an operator or a
jukebox.
-m Mount a volume. Mounting is done after the desired volume is
placed in the device and labeled. Only labeled volumes may be
mounted. The labeling and mounting operations may be com
bined, see the EXAMPLES section.
-o Mark a volume or save set as being recyclable (overwritable).
The -R command must still be used to do the actual relabel;
this just marks the database so that automatic volume selec
tion will trigger the relabel automatically when a new volume
is needed.
-O Mark a volume or save set as not being recyclable (over
writable), if it already was marked. This will prevent it from
being selected automatically to be relabeled.
-P When deleting a volume or a save set, specify -P to purge just
the corresponding file index entries and not modify the
entries in the media database. The scanner(8) command may be
used to recover the file index.
Licensed material--property of copyright holder(s) 2
MM(8) Legato NetWorker 3.0 MM(8)
-p Verify and print a volume's label. To confirm that the exter
nal volume label matches the internal label, load a volume
into a drive and use this option to display the volume name in
the label.
-R Recycle (relabel) a volume. This option rewrites the volume's
label, and purges the NetWorker indexes of all user files pre
viously saved on the volume. Some of the volume usage infor
mation is maintained.
-r Mount a volume read-only. To prevent NetWorker from writing
to a volume, specify the read-only flag when mounting the vol
ume. Volumes marked as full are automatically mounted read-
only.
-sserver
Specify the NetWorker server to act upon. See nsr(8) for a
description of server selection.
-S This option to the delete operation will remove one save set
from the NetWorker databases. The save set is identified via
a save set id, or ssid. The mminfo(8) command may be used to
display which save sets are on a volume.
-u Unmount a volume. To properly unmount a volume, it must be
unmounted before it is unloaded from its device.
-v Verbose mode. This option polls the NetWorker server to print
out more information as the operation proceeds.
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:
mm -l mars.001
The tape will be labeled with mars.001 and an entry will be
made in the appropriate NetWorker indexes. The mminfo(8) com
mand may be used to inspect the volume database. Running:
mminfo -m
will display information about the volumes.
Mounting a tape:
To mount a NetWorker volume, use the -m option (of course, the
volume must already be loaded in the drive):
mm -m
When mounting, a volume name may also be specified.
mm -m mars.001
Mounting a volume just makes the volume available to Net
Worker. When nsrmmd(8) needs the volume, the label will be
Licensed material--property of copyright holder(s) 3
MM(8) Legato NetWorker 3.0 MM(8)
read again and confirmed. This prevents accidental data loss.
Volumes are also verified and mounted automatically if the
server recovers after a crash.
Labeling and Mounting a tape:
A volume may be labeled and mounted with a single mm command
by combining the -m and -l options. For example, to label a
volume mars.003 and mount it on device /dev/rmt/0, run:
mm -m -l -f /dev/rmt/0 mars.003
Unmounting or ejecting a volume:
When a volume needs to be unmounted, the -u or -j options are
used, depending on if the device can physically eject a vol
ume.
mm -u
When more than one volume is mounted, either the volume name
or device may be specified to select the desired volume. For
example
mm -j mars.003
will eject the volume named mars.003.
Displaying the current volumes:
The -C option will display the configured devices and the vol
umes mounted on them. This is the default option.
mm -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 may be done without
the volume in a drive. Deleting a volume will free up space
in the NetWorker file index and the NetWorker media index.
The amount of space released will depend on the number of user
files saved on the volume. To delete the volume mars.003, use
the command:
mm -d mars.003
The scanner(8) command may 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 a volume's media
database entries while purging the file index. This is done
Licensed material--property of copyright holder(s) 4
MM(8) Legato NetWorker 3.0 MM(8)
by specifying the -P option when deleting.
To purge all of the file index entries for volume mars.001, run:
mm -d -P mars.001
The scanner(8) command may be used to recover the file index.
SEE ALSO
nsr(8), getdate(3), nsrlayout(5), nsrdevice(5),
nsrnotification(5), mminfo(8), networker(8), nsrmmd(8), nsradmin(8),
nsrize(8), scanner(8).
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
ily, for example, 8mm tape.
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 with
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? ...
Upon positive confirmation, the file index entries will be
removed.
volume not in media index
The media index has no entry associated with volume, so the -m
option has no effect. This problem may be caused by mistyping
the tape's volume name either at mount time or when the tape
was originally labeled.
No valid family label
The tape or disk in the named device does not have a valid
NetWorker label.
Licensed material--property of copyright holder(s) 5