NAME

mmlocate − NetWorker media location reporting command

SYNOPSIS

mmlocate [ −s server ] −l [ −n volname | −i volid | location ]
mmlocate [ −s server ] −d location
mmlocate [ −s server ] −c { −n volname | −i volid } location
mmlocate [ −s server ] −L
mmlocate [ −s server ] −u { −n volname | −i volid } location

DESCRIPTION

The mmlocate command is used to access and manage the volume location information contained in the media database.  The information contained in a volume’s location field is meant to give the user an idea of where the volume can physically be found.  Other NetWorker commands will display the location along with the volume name (see the versions sub-command of recover(8)).  Any user is allowed to use this command with the -l (default) or -L options.  The -d, -c, and -u options are limited to NetWorker administrators (see nsr(5)). 

Running mmlocate without any arguments will list all volumes and their locations for the specified server (if no server is specified the current host is used). 

Note that each time nsrjb(8) moves a piece of media inside a jukebox, the location of a volume is set to the name of the jukebox.

OPTIONS

−c location
Clear location field for specified volume. If no volume is specified by volname or volid, then all volumes matching the given location will have their location field cleared.

−d location
Delete all volumes having the given location. The user will be prompted for deletion of each volume.

−i volid
Restrict the operation to volid. 

−l List entries (default).  A database query is performed using the supplied volname or volid or location. 

If a volume name or volume id is given, then only that volume’s location information is displayed.  If a location is provided, then only volumes in that location are displayed.  When the -l argument is supplied with no other options (volume name, volume id, or location), volumes with no location set are displayed. 

−L List all locations found in the database. 

−n volname
Restrict the operation to volname. 

−s server
Use server’s media database. 

−u Update the location for a volume.  Locations are limited to a maximum length of 64 characters.  A -n volname or -i volid and a location must be supplied. 

EXAMPLES

Update (or add) a record showing volume Offsite.011 now at location ’Media Vault’

mmlocate −u −n Offsite.011 ’Media Vault’

Delete volumes at location ’Media Shelf 6’

mmlocate −d ’Media Shelf 6’

Delete location information for volume NonFull.001

mmlocate −c −n NonFull.001

List the location of volume NonFull.001

mmlocate −n NonFull.001

List all volumes stored in the location ’Media Vault’

mmlocate ’Media Vault’

FILES

/nsr/mm/mmvolume The media database. 

SEE ALSO

nsrmm(8), mminfo(8), nsr(8), nsrjb(8), recover(8)

DIAGNOSTICS

Server does not support remote update operations.... 
If you are running mmlocate against an old server, you are not allowed to use the -u or -c options.  You must login to that server and run the mmlocate program there. 

NetWorker 4.1.2  —  Last change: May 1995