Tivoli Header
Tivoli Storage Manager for Windows Backup-Archive Clients Installation and User's Guide
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).
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\
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\
[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]