MMRECOV ( 8 ) Maintenance Procedures MMRECOV ( 8 )

NAME
mmrecov − recover a NetWorker media index
SYNOPSIS
mmrecov [ −q | −v ]
DESCRIPTION
The mmrecov command is used in recovering from the loss of a NetWorker server’s critical files. mmre-
cov restores the media index and the server’s resource files. Typical events causing such disasters are
accidental removal of these files by a user or a disk crash on the NetWorker server itself. See nsr_crash(8)
for a discussion of general issues and procedures for NetWorker client and server crash recovery.
Mmrecov is used to recover the NetWorker server’s media database and resource files from the media
(backup tapes or disks) when the media database or resource files have been lost or damaged. Note that this
command overwrites the server’s existing media index. The Mmrecov command is not used to recover
NetWorker clients’ online indexes; you must use the nsrck(8) command for this purpose.
The NetWorker system must be fully installed and correctly configured prior to using this command. If any
of the NetWorker software is lost, re-install NetWorker from the distribution files before you run mmrecov.
Use the same release of NetWorker, and install it in the same location as it was before the software was lost.
The Mmrecov program extracts the contents of a bootstrap save set, which contains the media index and
resource files. Once mmrecov is done running, you shut the NetWorker server down, move the recovered
resource files into place, and restart the server. At this point, the file indexes for the server and client may
be restored by using nsrck.
When mmrecov is started, it will ask for the device from which the bootstrap save set will be extracted.
Next, it will ask for the bootstrap save set identifier. This number is found in the fourth column (labeled
ssid) of the last line of the bootstrap information sheet printed by savegrp, and mminfo -B, an example of
which is shown below:

Jun 17 22:21 1992 mars’s NetWorker bootstrap information Page 1

date time level ssid file record volume

6/14/92 23:46:13 full 17826163 48 0 mars.1
6/15/92 22:45:15 9 17836325 87 0 mars.2
6/16/92 22:50:34 9 17846505 134 0 mars.2 mars.3
6/17/92 22:20:25 9 17851237 52 0 mars.3

In the example above, the ssid of the most recent bootstrap save set is ‘17851237’. If you are cloning save
sets, your bootstrap save set is also cloned, and you need to use the second to last save set. See the
RECOVERING FROM CLONE MEDIA section for an example of boostrap information with cloned
save sets. Next, mmrecov prompts for the file and record location of the bootstrap save set. Both values
may default to zero if they are not known. Note, however, that specifying the correct file and record num-
bers will allow NetWorker to more quickly locate the bootstrap save set. The file and record locations are
the fifth and sixth columns of the bootstrap information sheet. In the example above, the values for the file
and record locations are 52 and 0, respectively. Finally, mmrecov will ask that the volume (‘mars.3’ in the
example above) containing the selected bootstrap save set be inserted into the specified device. All of the
ssid, file location, record location, and the physical volume must be determined by the user from the printed
sheet, since mmrecov has no way of determining this information. On the other hand, if the volume con-
taining the bootstrap is not known, the -B option of scanner(8) can be used to determine the file and record
locations.
If the bootstrap save set spans more than one volume, multiple volume names are printed. The order
printed is the order required by mmrecov. In the example above, the third save set produced on 6/16/92
begins on volume ‘mars.2’ and spans to volume ‘mars.3’. If a bootstrap save set spans volumes, mmrecov
will ask for the name of the device where the next volume has been loaded when an end-of-volume occurs.

NetWorker 6.0.Build.67 Last change: May 06, 2000 1

MMRECOV ( 8 ) Maintenance Procedures MMRECOV ( 8 )

The volume is then scanned, and the bootstrap save set extracted.
After the volume scan completes, mmrecov will complete. At this point, if your original server resource
files were lost, you must shutdown the NetWorker server, move the new resource files into place, and restart
the NetWorker server. Now the indexes can be recovered.
In order to recover the indexes for the server and client, you must run nsrck -L7. This command will
reconstruct complete indexes from the save sets generated by the server’s save schedule. Since the save sets
may be spread across multiple volumes, nwadmin(8) or nsrwatch(8) should be run, and the volumes
mounted as they are requested.
When the nsrck completes, the message "completed recovery of index for client ’<client-name>’" is dis-
played. Once a NetWorker client’s index is recovered, that client can start recovering its files using
recover. Note that it is not necessary for the server’s index to be restored before the client indexes may be
restored.
As stated earlier, the NetWorker resource files are saved as part of the bootstrap save set. If your resource
files were also deleted, you may quickly replace them by copying or moving them from /nsr/res.R to
/nsr/res. Before restoring them to /nsr/res, the daemons must be shut down (see nsr_shutdown(8)).
Sometimes, it is neccessary to recover the NetWorker server onto a new machine, for example, after a
major hardware failure. When this occurs, the NetWorker Licensing software will detect the move. Once
the NetWorker server has been moved to a new machine, it must be re-registered with Customer Support
within 15 days of the move, or the server will disable itself. After disabling itself, you will only be able to
recover files; new backups cannot be performed until the server is re-registered. Notifications will be sent
by the NSR Registration notification, warning of the need to re-register the product.
RECOVERING FROM CLONE MEDIA
If you are running mmrecov with clone media only, for example, at a remote site, you will need to perform
the recovery using a slightly different method. When selecting the bootstrap identifier, make sure that you
are using the information associated with the cloned save set: the last save set listed in the bootstrap output.
Consider the following list of save sets:

Jun 17 22:21 1996 mars’s NetWorker bootstrap information Page 1

date time level ssid file record volume

6/14/96 23:46:13 full 17826163 48 0 mars.1
6/14/96 23:46:13 full 17826163 12 0 mars_c.1
6/15/96 22:45:15 9 17836325 87 0 mars.2
6/15/96 22:45:15 9 17836325 24 0 mars_c.2
6/17/96 22:20:25 9 17851237 52 0 mars.3
6/17/96 22:20:25 9 17851237 6 0 mars_c.3

In the example above, the ssid of the most recent bootstrap save set is ‘17851237’. The cloned save set
resides on mars_c.3 and the values for the file and record locations are 6 and 0, respectively.
If you lost your resource files and need to use the ones restored from mmrecov, the NetWorker server needs
to be shut down so that you can replace the installation resource files with your recovered ones.
Once the original resource files are in place, the NetWorker server should be restarted. After it is restarted,
you may recover the indexes for the server and clients by issuing the nsrck -L7 command. This command
queries the media database for the index backups and restores the indexes for the server and each client. If
all clone volumes needed are online when the index recovery proceeds, nsrck will complete on its own.

If some of the volumes are not online, then nsrck will attempt to recover the index from the original vol-
ume it was backed up to, and therefore request the original media. In the example bootstrap output above,
mars_c.1 and mars_c.3 would all need to be online. If volume mars_c.3 was the only volume online, then
nsrck would also request mars.1. To finish recovering the server’s index in this case, you need to perform

NetWorker 6.0.Build.67 Last change: May 06, 2000 2

MMRECOV ( 8 ) Maintenance Procedures MMRECOV ( 8 )

the following steps:

1. Note what volumes are needed for recovery and delete them from the media database.

nwadmin(8) or nsrwatch(8) lists out the volumes needed for recovery in the Pending messages
panel. Use nwadmin(8) or nsrmm(8) to delete the volumes from the media database.

Given the scenario in the example above where only mars_c.3 was mounted, we would have to
delete mars.1 from the media database, i.e. nsrmm -d mars.1.
2. Restart the server to kill off the index recovery in progress.

Use nsr_shutdown(8) to bring the server down. Run nsrd(8) to start the server again.
3. Recover the server’s index by using nsrck -L7 servername.

When the nsrck completes, the message "The index is now fully recovered" is displayed.
OPTIONS
−q Quiet. Display only error messages.
−v Verbose. Generates debugging information.
FILES
/nsr If this was a symbolic link when the bootstrap save set was created, it needs to be re-created manu-
ally prior to running mmrecov.
/nsr/res This directory and its contents are saved as part of the bootstrap save set. Mmrecov restores this
directory, and then renames it to /nsr/res.R. The original directory is temporarily renamed to
/nsr/res.org while the bootstrap save set is being recovered.
/nsr/mm/mmvolume
The NetWorker server’s media index saved as part of the bootstrap save set, and unconditionally
recovered by mmrecov.
BUGS
The name mmrecov is misleading, as a result mmrecov is often used when it is not needed. A name like
"recover_server_media_database_or_resource_files_when_either_are_missing" is more descriptive. Note
that any part of the bootstrap save set contents are recoverable using normal recover procedures provided
that the server’s on-line index, resource files, and media index are intact.
To recover files that are not in the on-line file index (for example, files saved after the last run of savegrp),
scanner must be used to rebuild the media and on-line file indexes from the contents of the volumes gener-
ated between the time of the last run of savegrp and the loss of the original index.
SEE ALSO
mminfo(8), nsr_crash(8), nsr(8), nsrck(8), nsrd(8), nsr_client(5), nsr_schedule(5), nsr_shutdown(8),
recover(8), save(8), savefs(8), savegrp(8), scanner(8), nsrindexasm(8), nsrmm(8), nsrmmdbdasm(8),
nwadmin(8), nsrwatch(8), nsr_getdate(3)

NetWorker 6.0.Build.67 Last change: May 06, 2000 3