Tivoli Header

Tivoli Storage Manager for UNIX 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".

Supported Clients

This command is valid for all UNIX clients.

Syntax

>>-RETrieve--+----------+--+- sourcefilespec---+---------------->
             '- options-'  '- "sourcefilespec"-'
 
>--+----------------------+------------------------------------><
   '- destinationfilespec-'
 
 

Parameters

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

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.

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.

Examples

Task
Retrieve a single file named budget.

Command: retrieve /home/devel/projecta/budget

Task
Retrieve all files with an extension of .c from the /home/devel/projecta directory.

Command: retrieve "/home/devel/projecta/*.c"

Task
Retrieve all files in the /home directory.

Command: retrieve /home/

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

Command: retrieve "/home/devel/projecta/*.c" /home/newdevel/projectn/

Task
Retrieve files in the /user/project directory. Use the pick option.

Command: ret "/user/project/*" -pick

Task
Retrieve all files archived from the /proj directory with the description "2002 survey results."

Command: retrieve "/proj/*" -desc="2002 survey results"

Task
Retrieve archived file /home/devel/budget with description "my budget" to the /dev/rmt1 tape drive.

Command:

mkfifo fifo
dd if=fifo of=/dev/rmt1&
dsmc retrieve -replace=yes -description="mybudget"
/home/devel/budget fifo


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