Restorefiles command

Edit online

Use the restorefiles command to restore flat files from a backup into a specified directory.

The following information provides details about this using the restorefiles command:
  • The restorefiles command is only available on the command-line interface.
  • This command does not require an Exchange Server to be installed on, or accessible from the system where restorefiles is run.
  • Files can be restored to an alternative system or to an alternative directory on the same system as the Exchange Server.
  • The restorefiles operation fails if a previously restored file exists, except for VSS backup files.
  • The command continues until it succeeds, or until the destination volume does not contain enough space for the operation.
  • When you restore files from an inactive backup or an active incremental backup, use the /object parameter to specify the name of the backup object. The object name uniquely identifies the backup instance in IBM Storage Protect server storage. A list of backup object names is obtained by issuing the query tsm * /all command.

A VSS restorefiles operation overwrites files that exist and have the same name. If a log file from an incremental backup has the same name as the log file from the full backup operation, you can run two consecutive restorefiles operations to the same directory:

  • Run the following command to restore a full backup: 
    tdpexcc restorefiles DB1 FULL /into=d:\temprestore
  • Run the following command to restore the log files during the incremental restore: 
    tdpexcc restorefiles DB1 INCR /into=d:\temprestore

    The /into parameter can be a directory on any mounted local disk. It is not possible to use a mapped network drive as a restore destination.

Before you issue the restorefiles command, make sure that you have sufficient disk space to hold all of the flat files. For example, if your database and logs are 50 GB in size, you need 50 GB available in the destination directory that is specified by the /into parameter. For VSS backups, do not issue a restorefiles command to the existing location of the production or active database. Those files are overwritten.