From: Linda Bebernes Date: Wed, 18 Sep 2013 16:54:25 +0000 (-0700) Subject: LUDOC-54 option: Documented lfs_migrate -c option. X-Git-Tag: 2.5.0~27 X-Git-Url: https://git.whamcloud.com/gitweb?a=commitdiff_plain;h=refs%2Fchanges%2F87%2F7687%2F3;p=doc%2Fmanual.git LUDOC-54 option: Documented lfs_migrate -c option. Updated lfs_migrate options in Section 32.2. Enhanced note in Chapter 16 "Upgrading" about disabling wide striping on an MDS to be downgraded. Signed-off-by: Linda Bebernes Change-Id: I1c945ad775d89eadb508951ab6ff3d071788229e Reviewed-on: http://review.whamcloud.com/7687 Tested-by: Hudson Reviewed-by: Jian Yu Reviewed-by: Richard Henwood --- diff --git a/UpgradingLustre.xml b/UpgradingLustre.xml index a7738e9..41fa15e 100644 --- a/UpgradingLustre.xml +++ b/UpgradingLustre.xml @@ -73,18 +73,34 @@ In Lustre release 2.2, a feature has been added that allows striping across up to 2000 OSTs. By default, this "wide striping" feature is disabled. It is - activated by setting the large-xattr option on the MDT using either + activated by setting the large_xattr option on the MDT using either mkfs.lustre or tune2fs. For example after upgrading an existing file system to Lustre release 2.2 or later, wide striping can be enabled by running the following command on the MDT device before mounting it:tune2fs -O large_xattrOnce the wide striping feature is enabled and in use on the MDT, it is not possible to directly downgrade the MDT file system to an earlier - version of the Lustre software that does not support wide striping. The only way to disable - wide striping is to delete all files with a large_xattr extended attribute, - unmount the MDT, and run the following command to - turn off the large-xattr - option:tune2fs -O ^large_xattr - + version of the Lustre software that does not support wide striping. To disable wide striping: + + Delete all wide-striped files. + OR + Use lfs_migrate with the option -c + stripe_count (set stripe_count + to 160) to move the files to another location. + + + Unmount the MDT. + + + Run the following command to turn off the large_xattr + option:tune2fs -O ^large_xattr + + + + + To generate a list of all files with more than 160 stripes use lfs + find with the --stripe-count + option:lfs find ${mountpoint} --stripe-count=+160 + In Lustre release 2.4, a new feature allows using multiple MDTs, which can each serve one or more remote sub-directories in the file system. The root directory diff --git a/UserUtilities.xml b/UserUtilities.xml index ea242ea..ac9ff93 100644 --- a/UserUtilities.xml +++ b/UserUtilities.xml @@ -660,7 +660,7 @@ lfs help The lfs_migrate utility is a simple tool to migrate files between Lustre OSTs.
Synopsis - lfs_migrate [-c|-s] [-h] [-l] [-n] [-y] [file|directory ...] + lfs_migrate [-c stripecount] [-h] [-l] [-n] [-q] [-R] [-s] [-y] [file|directory ...]
Description @@ -689,26 +689,21 @@ lfs help - -c - - - Compares file data after migrate (default value, use -s to disable). - - - - - -s + + -c stripecount - Skips file data comparison after migrate (use -c to enable). + Restripe file using the specified stripe count. This option may not be + specified at the same time as the -R option. - -h + + -h - Displays help information. + Display help information. @@ -716,7 +711,9 @@ lfs help -l - Migrates files with hard links (skips, by default). Files with multiple hard links are split into multiple separate files by lfs_migrate, so they are skipped, by default, to avoid breaking the hard links. + Migrate files with hard links (skips, by default). Files with multiple hard + links are split into multiple separate files by lfs_migrate, so + they are skipped, by default, to avoid breaking the hard links. @@ -724,7 +721,7 @@ lfs help -n - Only prints the names of files to be migrated. + Only print the names of files to be migrated. @@ -732,15 +729,29 @@ lfs help -q - Runs quietly (does not print filenames or status). + Run quietly (does not print filenames or status). + -R + Restripe file using default directory striping instead of keeping striping. + This option may not be specified at the same time as the -c + option. + + + + -s + Skip file data comparison after migrate. Default is to compare migrated file + against original to verify correctness. + + - --y + + -y - Answers 'y' to usage warning without prompting (for scripts). + Answer 'y' to usage warning without prompting + (for scripts, use with caution).