Tivoli Header

Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide

Restore

The restore command obtains copies of backup versions of your files from a server. To restore files, specify the directories or selected files, or select the files from a list. Restore files to the directory from which you backed them up or to a different directory. Tivoli Storage Manager uses the preservepath option with the subtree value as the default for restoring files. For more information, see Preservepath.

If you set the subdir option to yes when restoring a specific path and file, Tivoli Storage Manager recursively restores all subdirectories under that path, and any instances of the specified file that exist under any of those subdirectories.

Note:
An error will occur if you attempt to restore a file whose name is the same as an existing file's short name. For example, if you attempt to restore a file you specifically named ABCDEF~1.DOC into the same directory where a file named abcdefghijk.doc exists, the restore will fail because the Windows operating system equates the file named abcdefghijk.doc to a short name of ABCDEF~1.DOC. The restore function treats this as a duplicate file.

If this error should occur, perform any of the following actions to correct it:

See the Microsoft Knowledge Base article Q121007, How to Disable the 8.3 Name Creation on NTFS Partitions, for more information.

If the restore command is retried because of a communication failure or session loss, the transfer statistics display the bytes Tivoli Storage Manager attempted to transfer across all command attempts. Therefore, the statistics for bytes transferred may not match file statistics, such as those for file size.

Virtual Volume and Virtual Mount Point (Windows 2000 NTFS)

When restoring all file system data, including virtual volumes and mount points, restore the virtual mount point before restoring any data inside the virtual volume. Otherwise, all data in the virtual volume is restored to the parent directory of the virtual volume.

Attention: When the client is instructed to restore the files on the mount volume, it first determines whether a mount point exists for the specified mount volume. If a mount volume exists in the specified location, the following error message appears:

  ANS5179E Restoring a volume mount point to a non-empty directory
and Tivoli Storage Manager will not overwrite the mount volume to avoid potential data loss. To restore the mount volume, first delete the mount point associated with it.

You can restore a virtual mount point to a network drive; however, the restored mount point indicates the virtual volume in the network workstation, not the local client virtual volume. For best results, only restore a virtual mount point to a network drive when the network workstation already has the identical virtual mount point defined. To restore the mount volume, first delete the mount point associated with it.

To restore a mount point using the GUI or Web client, you must restore the root of the drive where the mount point is defined. If you select the mount point itself, Tivoli Storage Manager restores all mounted data, but not the mount junction.

If you use the command line client to restore mounted data, back up the mount point in addition to backing up the mounted data. If the mount point is not backed up, you cannot use the command line client to restore any data inside the mounted volume. For best results, back up at least one mount point for any virtual volume you want to restore.

Restoring Microsoft DFS Junctions

To restore Microsoft DFS junctions, you must restore Microsoft DFS root. If you select the junction point itself, Tivoli Storage Manager restores data under junction, but not the junction itself. If you select a junction point that no longer exists under DFS root, Tivoli Storage Manager creates a local directory under DFS root with the same name as the junction before restoring data.

Restoring Active Files

When restoring active and inactive versions of the same file using the replace option, only the most recently restored file is replaced.

Performing Restores with version 3.1.0.5 or Later

If you are using client version 3.1.0.5 or later, the workstation name is part of the file name. Therefore, if you back up files on one workstation and you want to restore them to another workstation, you must specify a destination. This is true even if you are restoring to the same physical workstation, but the workstation has a new name. For example, to restore the c:\doc\h2.doc file to its original directory on the workstation, named star, you would enter:

   dsmc restore c:\doc\h2.doc \\star\c$\

To restore the file to star which has now been renamed meteor, you would enter:

   dsmc restore c:\doc\h2.doc \\meteor\c$\

You could also enter:

   dsmc restore c:\doc\h2.doc \\star\c$\

This example is valid because the workstation name is not included in the specification, so the local workstation is assumed (meteor, in this case).

Restoring from File Spaces that are not Unicode Enabled

For Windows NT, 2000, XP, and Windows.NET clients: If you want to restore from file spaces that are not Unicode enabled, you must specify the source on the server and a destination on the client. For example, you backed up your H-disk, named \\your-node\h$, prior to installing the Unicode-enabled client. After the installation, you issue the following command for a selective backup:

   sel h:\logs\*.log

Before the backup takes place, the server renames the file space to \\your-node\h$_OLD. The backup continues placing the data specified in the current operation into the Unicode-enabled file space named \\your-node\h$. That file space now contains only the \logs directory and the *.log files. If you want to restore a file from the (old) renamed file space to its original location, you must enter both the source and destination as follows:

   restore \\your-node\h$_OLD\docs\myresume.doc h:\docs\

Windows 2000, XP, Windows.NET Considerations

Tivoli Storage Manager restores named streams on a file basis only. Windows 2000, XP, Windows.NET directories can contain named streams. Named streams attached to a directory will always be overwritten (regardless of the value of the prompt option) during a restore operation.

When restoring sparse files to a non-NTFS file system, set the Tivoli Storage Manager server communication time out value (idletimeout) to the maximum value of 255 to avoid client session timeout. Tivoli Storage Manager is restricted to restoring sparse files that are less then 4 gigabytes in size.

The following issues apply if more data is restored than the Microsoft disk quota allows:

Supported Clients

This command is valid for all Windows clients.

Syntax

            .- FILE-.
>>-REStore--+-------+--+----------+----------------------------->
                       '- options-'
 
>--+- sourcefilespec----------------+--------------------------->
   '- {filespacename}sourcefilespec-'
 
>--+----------------------+------------------------------------><
   '- destinationfilespec-'
 
 

Parameters

file
This parameter specifies that the source file specification is an explicit filename. This parameter is required when you restore a file name from the current path, when you do not specify a relative or absolute path, and when the file name conflicts with one of the reserved restore command keywords, such as restore backupset. See Maximum File Size for Operations for the maximum file size for restore processing.

options
You can use these command line options with the restore command: dirsonly, filelist, filesonly, fromdate, fromnode, fromtime, ifnewer, inactive, latest, pick, pitdate, pittime, preservepath, todate, totime. For more information, see Chapter 10, "Using Options with Commands".

You can use these common options with the restore command: replace, subdir. See Chapter 9, Setting Processing Options for information about common options.

sourcefilespec
Specifies the path and file name in storage that you want to restore. Use wildcard characters to specify a group of files or all the files in a directory.
Note:
If you include filespacename, do not include a drive letter in the file specification.

{filespacename}
Specifies the file space (enclosed in braces) on the server that contains the files you want to restore. This is the name on the workstation drive from which the files were backed up.

Use the filespacename if the drive label name has changed or if you are restoring files backed up from another node with drive labels that are different from yours. This is the drive label name or UNC name on the workstation drive from which the file was backed up. The following example is valid for specifying a UNC name: {'\\machine\C$'}.

Note:
You must specify a mixed or lowercase NTFS file space name enclosed in quotes and braces. For example, {"NTFSDrive"}. Single quotes or double quotes are valid in loop mode. For example: {"NTFSDrive"} and {'NTFSDrive'} are both valid. In batch mode, only single quotes are valid. The single quotes requirement is a restriction of the operating system.

destinationfilespec
Specifies the path and file name where you want to place the retrieved files. If you do not specify a destination, Tivoli Storage Manager restores the files to the original source path.

When entering the destinationfilespec, please consider the following:

Note:
If the destination path or any part of it does not exist, Tivoli Storage Manager will create it.

Examples

Task
Restore a single file named budget.fin.

Command: restore c:\devel\projecta\budget.fin

Task
Restore a single file named budget.fin which resides in the current directory.

Command: restore file budget.fin

Task
Restore files from the abc NTFS file space proj directory.

Command: rest {"abc"}\proj\*.*

Task
Restore all files with a file extension of .c from the c:\devel\projecta directory.

Command: rest c:\devel\projecta\*.c

Task
Restore all files with an extension of .c from the \devel\projecta directory located in the winnt file space.

Command: rest {winnt}\devel\projecta\*.c

Task
Restore all files with a file extension of .c from the c:\devel\projecta directory to the c:\newdevel\projectn\projecta directory. If the projectn or projectn\projecta directory does not exist, it is created.

Command: restore c:\devel\projecta\*.c c:\newdevel\projectn

Task
Restore files in the c:\project directory. Use the pick and inactive options to select active and inactive backup versions.

Command: restore c:\project\* -pi -ina

Task
Restore a file from the renamed file space \\your-node\h$_OLD to its original location. Enter both the source and destination as follows:

Command: res \\your-node\h$_OLD\docs\myresume.doc h:\docs\

Task
Restore files specified in the filelist to a different location.

Command: res -filelist=c:\avi\restorelist.txt c:\NewRestoreLocation\


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]