The dsmmigrate command selects specific files from the local file system and migrates them to a Tivoli® Storage Manager server.
If the file exists in a file system with a different server stanza than the last processed file, a new session starts for each migrated file. This action can happen as a result of links from one file system to another.
The first file migrates even if the file size exceeds the quota that you specified for the file system. When migration occurs, the ddf command displays zero migrated and premigrated bytes for the file system. If the total number of bytes exceeds the quota after the file migrates, the next file is not migrated.
.------------------------------. V | >>-DSMMIGRATE--+---------+----+-filespec-----------------+-+--->< '-options-' '- -FIlelist--=--file_path-'
When the attributes are set and the preview size is defined, a recall operation begins only when an application reads the stub file beyond the preview section of the stub file. If an operation reads only the preview section of the stub file, the file is not recalled.
This option applies only if streaming recall mode is set.
If the previewsize option is set for the stub file, a recall operation starts only when an application reads beyond the preview section of the stub file.
The default value is No.
The Tivoli Storage Manager for Space Management client does not migrate contents of symbolic links. Symbolic links are not followed during recursive selective migration.
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 Tivoli Storage Manager server, you must specify that server. If a file is not coupled with a Tivoli Storage Manager server, you can specify any Tivoli Storage Manager server that was added to the multiple-server environment.
For Tivoli Storage Manager for Space Management clients on AIX® GPFS™ and Linux x86_64 GPFS file systems, you can specify 0 or a multiple of the file system block size. The default value is 0.
For Tivoli Storage Manager for Space Management clients on AIX Enhanced Journaled Files Systems (JFS2), you can specify a multiple of the file system fragment size. The default value is the file system fragment size.
For all file system types, the maximum value for a stub file size is 1 GB.
/home/dir/file1
"/fs1/dir2/file3"
"/fs2/my files/file4"
../tivoli/'file1'
"'fs3'/dir3/'file.txt'"
fs4/dir/a"file".txt
'/fs4/dir/file.txt'
/fs5/dir/file*with?wildcards.txt
If the list file name that you specify with the filelist option does not exist, the command fails.
Task | Command |
---|---|
Migrate all files in a directory that is named /migfs2/test/dir1 and in all of its subdirectories. Display the information. | dsmmigrate -Recursive -Detail /migfs2/test/dir1 |
Migrate a file that is named tf04 from the current directory and display the information. Log the results in the file /tmp/miglog. | dsmmigrate -Detail -L=/tmp/miglog tf04 |
Migrate all files in a file list that is named /tmp/filelist.
Log the results in the file /tmp/miglog. Set the stub size to 4096 bytes and the
preview size to 2048 bytes. Restriction: When a file is recalled, the preview size affects
recall processing only if streaming recall mode is set and readstartsrecall=yes.
You can set streaming recall mode with the minstreamfilesize option
on the dsmmigfs command or with the recallmode option
on the dsmattr command.
|
dsmmigrate -logname=/tmp/miglog -filelist=/tmp/filelist -stubsize=4096 -previewsize=2048 -readstartsrecall=yes |
Use a shell application to build a list of files that are owned by user ibm, and then migrate the files. | find /hsmfilesystem -user ibm -print > /tmp/filelist dsmmigrate -filelist=/tmp/filelist |
Premigrate the file /migfs2/test/file1, but do not replace the local file with a stub. | dsmmigrate -p /migfs2/test/file1 |
Migrate all premigrated files in directory /migfs2/test/dir1/ and in all of the subdirectories | dsmmigrate -R -ST /migfs2/test/dir1 |