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

Retrieve

The retrieve command obtains copies of archived files from the Tivoli Storage Manager server. You can retrieve specific files or entire directories. Use the description option to specify the descriptions assigned to the files you want to retrieve.

You can also use the pick option to display a list of your archives. From this list, you can select an archive to retrieve.

Retrieve the files into the same directory from which they were archived, or in a different directory. Tivoli Storage Manager uses the preservepath option with the subtree value as the default for restoring files. For more information, see Chapter 10, "Using Options with Commands".

Note:

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

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

• Retrieve the file with the short file name you specified, to a different location.
• Stop the retrieve, and change the name of the existing file.
• Disable the short file name support on Windows.
• Do not use file names that would conflict with the short file naming convention; for example, do not use ABCDEF~1.DOC.

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

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

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

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

You could also enter:

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

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

Retrieving from File Spaces that are not Unicode Enabled

For Windows NT, 2000, XP, and Windows.NET clients: If you want to retrieve archives from file spaces that were renamed by the Unicode-enabled client, you must specify the source on the server and a destination on the client. For example, you archived files from your H-disk, named \\your-node\h$ prior to installing the client. After the installation, you issue the following archive command:

   arc h:\logs\*.log

Before the archive takes place, the server renames the file space to \\your-node\h$_OLD. The archive 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 retrieve a file from the (old) renamed file space to its original location, you must enter both the source and destination as follows:

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

Windows 2000, XP, Windows.NET Considerations

Tivoli Storage Manager retrieves named streams on a file basis only. Directories in Windows 2000, XP, and Windows.NET can contain named streams. Named streams attached to a directory will always be overwritten (regardless of the value of the prompt option) during the retrieve.

When retrieving sparse files to a non-NTFS file system, set the Server communication time out value (idletimeout) to the maximum value of 255 to avoid client session timeout.

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

• If the user performing the retrieve does not have a disk quota (e.g., belongs to the Backup Operator Group), Tivoli Storage Manager will not retrieve any data that exceeds the retrieve user's disk quota and will display a "Disk Full" message.
• If the user performing the retrieve does not have a disk quota (e.g., belongs to the Administrator Group), Tivoli Storage Manager will retrieve all data and transfer ownership of those files which exceed the original owner's disk quota to the user performing the retrieve (in this case, the Administrator).

Supported Clients

This command is valid for all Windows clients.

Syntax

>>-RETrieve--+----------+--+- sourcefilespec----------------+--->
             '- options-'  '- {filespacename}sourcefilespec-'
 
>--+----------------------+------------------------------------><
   '- destinationfilespec-'
 
 

Parameters

options

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

For information about common options you can use with the retrieve command, see Chapter 9, Setting Processing Options.

sourcefilespec

Specifies the path and file name that you want to retrieve. Use wildcard characters to specify a group of files or all the files in a directory. See Maximum File Size for Operations for the maximum file size for retrieve processing.

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 retrieve. This name is the drive label on the workstation drive from which the files were archived.

Use the file space name if the drive label name has changed, or if you are retrieving files archived from another node with drive label names that are different from yours.

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 retrieve the files to. 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:

• If the sourcefilespec names a single file, the destinationfilespec can be a file or a directory.
• If the sourcefilespec is wildcarded or you specify the subdir=yes option, the destinationfilespec must be a directory and end with a directory delimiter (\).

Note:

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

Examples

Task

Retrieve a single file named budget.fin.

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

Task

Retrieve all files with an extension of .c from the c:\devel\projecta directory.

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

Task

Retrieve all files with a file extension of .c from the \devel\projecta directory on the winnt file space.

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

Task

Retrieve all files in the c:\devel directory.

Command: ret c:\devel\*

Task

Retrieve files from the abc file space proj directory.

Command: ret {abc}\proj\*.*

Task

Retrieve 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 the \projectn\projecta directory does not exist, it is created.

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

Task

Retrieve files in the c:\project directory. Use the pick option.

Command: ret c:\project\* -pick

Task

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

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