Tivoli Header

Tivoli Space Manager for UNIX Using the Hierarchical Storage Management Clients

Restoremigstate

The restoremigstate option specifies whether you want to restore or retrieve stub files or backup-archive versions of migrated and premigrated files during a restore-retrieve operation. Use this option with the backup-archive client restore and retrieve commands.

Place this option in your dsm.opt file.

You can restore or retrieve a stub file for a migrated or premigrated file only when:

When the number of days elapse that you specified with the migfileexpiration option, the migrated file is removed from storage.

If you specify restoremigstate yes, and if the migrated or premigrated file has not expired, the file is restored or retrieved to a stub file, regardless of whether it is marked for expiration.

The restoremigstate option restores a file if it is backed up after migration. If the file is backed up before migration, you cannot restore a stub file because a server stub file copy does not exist.

Files with ACLs are restored in a premigrated state regardless of the setting for restoremigstate.

Attention: The restoremigstate option does not support hardlinked files. If you want to restore or retrieve a stub file for a hardlinked file, delete all files from your local file system that are hardlinked together. When one file in a set of hardlinked files is migrated, all of the hardlinked files in the set become stub files. When you enter the restore command with the restoremigstate option, and restore a stub file for a hardlinked file, the stub file has the same name as the file that was originally migrated. Stub files are not restored for any other files that previously were in the hardlinked set of files.

Syntax

                    .-Yes-.
>>-RESToremigstate--+-----+------------------------------------><
                    '-No--'
 
 

Parameters

Yes
Restores or retrieves migrated and premigrated files to stub files on your local file system during a restore or retrieve operation. The files remain migrated. This is the default.

Attention: A stub file created during a restore or retrieve operation contains the information that is necessary to recall the migrated file from storage. It does not contain any leading bytes of data from the file. Any recall mode that was set previously for the migrated file (for example, migrate-on-close or read-without-recall) is not stored in the stub file. The recall mode is set to normal for all files that are restored or retrieved to stub files.

No
Restores or retrieves backup-archive versions of migrated files to your local file system during a restore or retrieve operation. The files become resident.


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