Articles in this section

See more

How do I restore Mirapoint appliance files using Tivoli Storage Manager?

Avatar
Phillip Cardenas
Follow

Issue

How do I restore Mirapoint appliance files using Tivoli Storage Manager?

Solution

 

NOTE: Before reading this article, Mirapoint highly recommends reading the latest version of the Mirapoint Backup and Restore Guide.

 

NOTE: Mirapoint supports only Tivoli Storage Manager (TSM) versions 5.4 and 5.5 (see Approved NDMP DMAs for Mirapoint Appliances). Refer to your IBM documentation in order to obtain current information on the TSM command line interface or Web administrative interface for versions 5.4 and later.

For system recovery, you can restore a full backup image. Keep in mind that this overwrites all of the files in the Mirapoint /usr/store with the backup data. To restore individual mail folders and messages, perform a selective restore.You can restore files from a backup image using the Tivoli Storage Manager (TSM) command line interface or Web administrative interface.


Restoring a Full Backup Image

In the event of a catastrophic loss of data, you can restore a full backup image to recover the complete Mirapoint /usr/store. When you restore a full backup image, all of the data in the /usr/store is overwritten.

Full image restores are possible only to a Mirapoint appliance with an equal or larger size mail store that is running the same MOS release as at the time of the backup.

To restore a full backup image using the TSM command line interface:

  1. Run the dsmadmc command from the /tsm/client/ba/bin/dsmservdirectory on your TSM system to start the TSM admin client. (The TSM server must be running before you can access the admin client.)
  2. From the TSM command line, run the restore node command and specify the file system that you want to restore. For Mirapoint backups, the file system is always /usr/store.
For example, to recover all of the files in the Mirapoint /usr/store on the appliance defined to TSM as the NAS node Mirapoint1:

restore node Mirapoint1 /usr/store
You can watch both the recovery progress log written by TSM, and the messages from Mirapoint's NDMP service written to a file in the directory /usr/openv/tivoli/logs/ndmp on the NetWorker server.
 
When the full image recovery is complete, the log in /usr/openv/tivoli/logs/ndmp shows a message from Mirapoint's NDMP service indicating that you should reboot the Mirapoint appliance.
 
Do not reboot the appliance yet; you must first restore any incremental backups taken since the last full backup.

 

NOTE: TSM might report that the restore was complete in the progress log before the message indicating that you should reboot your appliance appears in TSM's NDMP log. Do not restore the incremental backups until the reboot message appears in the NDMP log. If you do, the recovery might not be successful.

Do not reboot the appliance until the final incremental backup is complete, and the reboot message appears in the NDMP log.3. Restore, in the order they were created, the incremental backups that were made since the last full backup.

4. Reboot the Mirapoint appliance.

After reboot, this message displays on the Mirapoint appliance's front panel:

Image Restore
in progress ...

This indicates that the final steps of the image restore are being performed.

When the front panel indicates that the appliance is ready, the image recovery is complete.

You can also restore a full backup image through the Operation view > Manage Server Storage > Work with Sequential Access Storage Pools section of the TSM Web administrative interface.


Restoring Selected Files

You can restore selected files to recover individual mail folders and messages. When you perform a selective restore, mail folder contents are not overwritten. The restore-data is copied to a staging area, and from there it is merged with the current contents of the mail folder. However, calendar preferences, filters, and address book data are overwritten during the restore.

Unlike a full restore or system recovery, all restored messages in a selective restore are marked as unread, regardless of their status when the backup was made.

You can perform a selective restore on different MOS systems with the same release (e.g., restoring from 3.10 to 3.10, or restoring from 3.8 to 3.10). However, you cannot do a selective restore between MOS 3.x and MOS 4.x releases, nor can you perform a selective restore on systems with the same release restoring to an earlier release (e.g., restoring from 3.10 to 3.8).

Selecting the appropriate data to be restored is critical to the success of the restore. Understanding Mirapoint's Message Store for Selective Restore from Image Backup provides information about the message store and the file structure used by Mirapoint and will help you better understand selective restore.

A backup table of contents must be created when the backup image is created to enable the restoration of selected files. For information about configuring TSM to create a backup table of contents, see Configuring Tivoli Storage Manager for Mirapoint NDMP Backup and Using Tivoli Storage Manager to Perform a Backup.

To restore selected files using the TSM command line interface:

  1. Run the dsmadmc command from the /tsm/client/ba/bin/dsmservdirectory on your TSM system to start the TSM admin client. (The TSM server must be running before you can access the admin client.)
  2. From the TSM command line, run the restore node command and specify a list of the files and directories you want to restore. The names you specify cannot contain wildcards. Multiple names must be separated with commas and no intervening blanks.
For example, to restore the Mirapoint preferences for two users, user1 and user2:

restore node Mirapoint1 /usr/store filelist=/spool/user/user1/pref.txt,
/spool/user/user2/pref.txt
To recover all of a user's data, you specify the name of the user's directory, rather than an individual file. For example, to restore the preferences and messages that belong to user1 from the backup image:

restore node Mirapoint1 /usr/store filelist=/spool/user/user1

You can also perform selective restores through the Operation view > Manage Server Storage > Work with Sequential Access Storage Pools section of the TSM Web administrative interface. 

Comments

0 comments

Please sign in to leave a comment.