Tivoli Header

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

Preservepath

The preservepath option specifies how much of the source path to reproduce as part of the target directory path when you restore or retrieve files to a new location. Use the -subdir=yes option to include the entire subtree of the source directory (directories and files below the lowest-level source directory) as source to be restored. If a required target directory does not exist, it is created. If a target file has the same name as a source file, it is overwritten. Use the -replace=prompt option to have Tivoli Storage Manager prompt you before files are overwritten.

Note:
The Tivoli Storage Manager Client API does not support this option.

Supported Clients

This option is valid for all Windows clients.

Syntax

                .-subtree--.
>>-PRESERvepath-+----------+-----------------------------------><
                +-complete-+
                +-nobase---+
                '-none-----'
 
 

Parameters

subtree
Creates the lowest-level source directory as a subdirectory of the target directory. Files from the source directory are stored in the new subdirectory. This is the default.

complete
Restores the entire path, starting from the root, into the specified directory. The entire path includes all the directories except the file space name.

nobase
Restores the contents of the source directory without the lowest level, or base directory, into the specified destination directory.

none
Restores all selected source files to the target directory. No part of the source path at or above the source directory is reproduced at the target.

If you specify subdir=yes, Tivoli Storage Manager restores all files in the source directories to the single target directory.

Examples

Command line:
For the examples below, assume the server file space contains the following backup copies:
c:\h1\m1\file.a
c:\h1\m1\file.b
c:\h1\m1\l1\file.x
c:\h1\m1\l1\file.y

This command:
dsmc res c:\h1\m1\ c:\ann\ -preservep=complete.

Restores these directories and files:

c:\ann\h1\m1\file.a
c:\ann\h1\m1\file.b

This command:
dsmc res c:\h1\m1\ c:\ann\ -preser=nobase.

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b

This command:
dsmc res c:\h1\m1\ c:\ann\ -preser=subtree.

Restores these directories and files:

c:\ann\m1\file.a
c:\ann\m1\file.b

This command:
dsmc res c:\h1\m1\ c:\ann\ -preser=none.

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b

This command:
dsmc res c:\h1\m1\ c:\ann\ -su=yes -preser=
complete

Restores these directories and files:

c:\ann\h1\m1\file.a
c:\ann\h1\m1\file.b
c:\ann\h1\m1\l1\file.x
c:\ann\h1\m1\l1\file.y

This command:
dsmc res c:\h1\m1\ c:\ann\ -su=yes -preser=nobase.

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b
c:\ann\l1\file.x
c:\ann\l1\file.y

This command:
dsmc res c:\h1\m1\ c:\ann\ -su=yes -preser=subtree.

Restores these directories and files:

c:\ann\m1\file.a
c:\ann\m1\file.b
c:\ann\m1\l1\file.x
c:\ann\m1\l1\file.y

This command:
dsmc res c:\h1\m1\ c:\ann\ -su=yes -preser=none.

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b
c:\ann\file.x
c:\ann\file.y

This command:
dsmc res backupset c:\h1\m1\ c:\ann\ -su=yes 
-preser=nobase -loc=file

Restores these directories and files:

c:\ann\file.a
c:\ann\file.b
c:\ann\file.x
c:\ann\file.y


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