Copies the file data to a tape pool, or pools, and sets the file state to
premigrated
.
The commands can be used with the
mmapplypolicy command by specifying the
command name and command options in the
EXEC and
OPTS statements
in the policy file, as in the following example:
RULE EXTERNAL POOL 'tape_tier'
EXEC '/opt/ibm/ltfsee/bin/eeadm'
OPTS '-p MyPool1@Lib1,MyPool2@Lib2'
The mmapplypolicy command first identifies the files that match the
MIGRATE rule for the eeadm premigratemigrate command (or the
LIST rule for the eeadm list command), and then passes the list
of files to the command in the EXEC statement. The EXEC statement
then initiates the data movement between the tiers.
Alternatively, you can create the list of files manually and run the command by specifying the
list as <inputfile>.
Syntax
- eeadm premigrate
<inputfile>
-p
<list of pools>
[OPTIONS]
- eeadm list
<inputfile>
--premigrate
-p
<list of pools>
[OPTIONS]
-
- Required parameters
-
- <inputfile>
- Specifies the name of the input file that defines the files to premigrate. The file must be in
the following format:
- Each line ends with -- <filename> with a space before and after the double dash (the file
list record format of the mmapplypolicy command).
- Each line contains a file name with an absolute path or a relative path that is based on the
working directory. This format is unavailable when you run the command with
the --mmbackup option.
If <inputfile> is omitted, the command attempts to read the names of
files to premigrate from stdin.
The lines must be separated by a single LF
character (0x0A), and the LF character in the file name must be escaped as
\n .
- -p, --pools <list_of_pools>
- Specifies up to three target tape pools to which the files are to be premigrated. If multiple
pools are specified, they must be separated by a comma. The tape pool can be specified in the one of
the following formats. The second format (pool_name) can be used only in a single
tape library configuration.
- pool_name@library_name
- pool_name
The -p option must be specified in the OPTS parameter of the EXTERNAL POOL rule if this
command is used with the mmapplypolicy command.
- --premigrate
- This option is required in
OPTS if the LIST policy is
used.
-
- Optional parameter
-
- --mmbackup <shadow_db_path>
- The command accepts this option but ignores it, and thus it copies the file data to tapes
regardless of whether it is backed up or not. The <shadow_db_path> is either
the mount point of a GPFS file system or the path to an independent file set root to which the
mmbackup command was run against. It is the path where the
mmbackup shadow database is typically located.
-
- Common option
-
- -h, --help
- Shows this help text and exit.
Return codes
- 0 (zero)
- The operation completed successfully for all of the specified files.
- Nonzero
- The operation failed for all or some of the specified files.
Examples
eeadm premigrate CANDIDATES.LST -p MyPool
eeadm premigrate CANDIDATES.LST -p poolA@library1,poolB@library2
eeadm premigrate CANDIDATES.LST -p MyPool --mmbackup /gpfs/fs0