lustre/doc/lfs-migrate.1

   1 .TH LFS-MIGRATE 1 2015-12-07 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lfs migrate \- migrate files or directories between MDTs or OSTs.
   4 .SH SYNOPSIS
   5 .B lfs migrate
   6 \fI-m mdt_idx\fR [-v|--verbose] \fI<directory>\fR
   7 .br
   8 .B lfs migrate
   9 .RI [OPTIONS] ... <file|directory>\fR...
  10 .br
  11 .SH DESCRIPTION
  12 Migrate MDT inodes or OST objects between MDTs and OSTs respectively. For the
  13 case of MDT inode migration:
  14 .TP
  15 .B migrate -m|--mdt-index <mdt_idx> \fIdirectory\fR
  16 .br
  17 Move the file metadata (inode) from one MDT to MDT with index \fBmdt_idx\fR.
  18 Migration of striped directories or individual files between MDTs is not
  19 currently supported. Only the root user can migrate directories.  Files that
  20 have been archived by HSM or are currently open are skipped by MDT inode
  21 migration. Access to files within the directory is blocked until migration is
  22 complete.
  23 .TP
  24 \fIWARNING\fR
  25 A migrated file or directory will have a new inode number and FID.  As
  26 a consequence, files archieved by Lustre HSM cannot currently be migrated
  27 and migrated files that have a new inode number may confuse backup tools.
  28 .TP
  29 For the case of OST object migration:
  30 .TP
  31 .B migrate
  32 .B [--stripe-count|-c \fIstripe_count\fR]
  33 .B [--stripe-index|-i \fIstart_ost_idx\fR]
  34 .B [--stripe-size|-S \fIstripe_size\fR]
  35 .B [--pool|-p \fIpool_name\fR]
  36 .B [--ost-list|-o \fIost_indices\fR]
  37 .B [--block|-b]
  38 .B [--non-block|-n] \fIfile|directory\fR
  39 .br
  40 Migrate can also be used for OST objects by omitting \fI-m\fR option. In this
  41 mode, the command has identical options to
  42 .BR lfs-setstripe (1).
  43 The difference between migrate and setstripe is that \fImigrate\fR will
  44 re-layout the data in existing files using the new layout parameter by copying
  45 the data from the existing OST(s) to the new OST(s). In contrast,
  46 \fIsetstripe\fR is used for creating new files with the specified layout.  For
  47 more information, see setstripe in lfs(1).
  48 .P
  49 NOTE: lfs migrate has a complementary script
  50 .B lfs_migrate
  51 which is used to provide extra functionality when migrating file data
  52 between OSTs and has a separate man page.
  53 .SH EXAMPLES
  54 Move the inodes contained in ./testremote from their current MDT to the
  55 MDT with index 0:
  56 .HP
  57 .B $ lfs migrate -m 0 ./testremote
  58 .SH AUTHOR
  59 The lfs command is part of the Lustre filesystem.
  60 .SH SEE ALSO
  61 .BR lfs (1),
  62 .BR lfs-setdirstripe (1),
  63 .BR lfs-getdirstripe (1),
  64 .BR lfs-mkdir (1),
  65 .BR lfs_migrate (1),
  66 .BR lctl (8),