The dsmmigundelete command recreates deleted stub files for migrated files, and creates stub files for premigrated files for which an original file does not exist on your local file system. The file then becomes a migrated file.
You must have root user authority to use this command.
When a stub file or an original copy of a premigrated file is deleted from your local file system, the corresponding migrated or premigrated file is marked for expiration when reconciliation runs again.
Syntax
>>-DSMMIGUNDELETE--+----------------+--+---------+------------->< '-filesystemspec-' '-options-'
Parameters
- options
- –Recover
- Recreates stub files that have been removed from your file system.
Use this option if you need better performance during the recover
process.Important: This option recreates all of the existing stub files that overwrites all premigrated or recalled files. Data is lost from the last migration up to when this option is used! After the dsmmigundelete -recover command is issued, there is no way you can check whether the data of the local stub file is different from the contents of the file in the Tivoli® Storage Manager server.
Use this option only if all or most of the files in the file system are stub files and you need good performance during stub file recreation.
For performance purposes, do not use this option with the detail option.
Files that were never migrated are not recreated.
- –Detail
- Displays detailed information about which stub file is being recreated
to the file system.
Do not use this option with the recover option.
- –Expiring
- Recreates a stub file for a migrated file if a corresponding stub
file does not exist on your local file system, whether the migrated
file was marked for expiration or not. Or, it creates a stub file
for a premigrated file if a corresponding original file does not exist
on your local file system, whether the premigrated file was marked
for expiration or not.
Issue the dsmmigundelete command with the expiring option if you ran reconciliation since the files were deleted.
If you do not use the expiring option, the HSM client recreates a stub file for a migrated file if a corresponding stub file does not exist on your local file system and the migrated file was not marked for expiration. Or, it creates a stub file for a premigrated file if a corresponding original file does not exist on your local file system, and the premigrated file was not marked for expiration.
Enter the dsmmigundelete command without the expiring option if you did not run reconciliation since the files were deleted.
- –ERRORLOGName=file_path
- Specifies the path and file name of the error log file to be used by this command. Output from only this command is logged to the specified file. Other commands and daemons write output to the error log file specified by the errorlogname option in options file dsm.sys or dsm.opt, or as specified by the DSM_LOG environment variable. If any part of the path you specify does not exist, the Tivoli Storage Manager for Space Management client creates it.
- –Logname=file_path
- Specifies the path and file name of the log file to be used by this command. The kinds of events that are logged to the file are specified with the hsmlogeventflags option. Error events are not logged to the file.
- –SErver=server_name
Specify the target server for the task. This option is valid only in a multiple-server environment. If the file system is managed by multiple servers and you do not specify server, the task is attempted with the default migration server.
If a file is coupled with a server, the value of this option must be that coupled server. If you specify another Tivoli Storage Manager server, the task fails.
- filesystemspec
- The name of the file system for which you want to recreate deleted stub files and create stub files for premigrated files that were deleted from your local file system. The default is all file systems for which space management is active. You can specify more than one file system name. If you specify several file system names, separate each name with one or more blank spaces.
Examples
| Task | Command |
|---|---|
| Recreate stub files that were accidentally deleted from the /home file system. Recreate stub files regardless of the expiration status of the migration copies (use the expiring option). Reconciliation was run since the files were deleted. Results are logged in the log file /tmp/undeletelog. | dsmmigundelete -expiring -Logname=/tmp/undeletelog /home |
| Recreate stub files for migrated files in the /home file system. Recreate stub files only for those migration copies that are not marked for expiration (do not use the expiring option). Reconciliation was not run because the files were deleted. Entries are made in the log file /tmp/undeletelog. | dsmmigundelete -L=/tmp/undeletelog /home |
| Recreates stub files for migrated files that had been removed from the /trullofs file system. | dsmmigundelete -recover /trullofs |