![]() |
![]() |
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.
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.
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 directoryand 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.
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.
When restoring active and inactive versions of the same file using the replace option, only the most recently restored file is replaced.
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).
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\
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
You can use these common options with the restore command: replace, subdir. See Chapter 9, Setting Processing Options for information about common options.
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$'}.
When entering the destinationfilespec, please consider the following:
Examples
Command: restore c:\devel\projecta\budget.fin
Command: restore file budget.fin
Command: rest {"abc"}\proj\*.*
Command: rest c:\devel\projecta\*.c
Command: rest {winnt}\devel\projecta\*.c
Command: restore c:\devel\projecta\*.c c:\newdevel\projectn
Command: restore c:\project\* -pi -ina
Command: res \\your-node\h$_OLD\docs\myresume.doc h:\docs\
Command: res -filelist=c:\avi\restorelist.txt c:\NewRestoreLocation\