5 # lfs_migrate: a simple tool to copy and check files.
7 # To avoid allocating objects on one or more OSTs, they should be
8 # deactivated on the MDS via "lctl --device {device_number} deactivate",
9 # where {device_number} is from the output of "lctl dl" on the MDS.
11 # To guard against corruption, the file is compared after migration
12 # to verify the copy is correct and the file has not been modified.
13 # This is not a protection against the file being open by another
14 # process, but it would catch the worst cases of in-use files, but
15 # to be 100% safe the administrator needs to ensure this is safe.
22 echo "usage: lfs_migrate [-c|-s] [-h] [-l] [-n] [-y] [file|dir ...]" 1>&2
23 echo " -c compare file data after migrate (default)" 1>&2
24 echo " -s skip file data comparison after migrate" 1>&2
25 echo " -h show this usage message" 1>&2
26 echo " -l migrate files with hard links (skip by default)" 1>&2
27 echo " -n only print the names of files to be migrated" 1>&2
28 echo " -y answer 'y' to usage question" 1>&2
29 echo " if no file or directory is given, file list is read from stdin"
31 echo "e.g.: lfs_migrate -c /mnt/lustre/file"
32 echo " lfs find /scratch -O lustre-OST0004 -size +4G | lfs_migrate -y"
38 while getopts "chlnqsy" opt $*; do
42 n) OPT_DRYRUN=n; OPT_YES=y;;
51 if [ -z "$OPT_YES" ]; then
53 echo "lfs_migrate is currently NOT SAFE for moving in-use files." 1>&2
54 echo "Use it only when you are sure migrated files are unused." 1>&2
56 echo "If emptying OST(s) that are not disabled on the MDS, new" 1>&2
57 echo "files may use them. To prevent MDS allocating any files on" 1>&2
58 echo "OSTNNNN run 'lctl --device %{fsname}-OSTNNNN-osc deactivate'" 1>&2
59 echo "on the MDS." 1>&2
60 echo -n "Continue? (y/n) "
62 [ "$CHECK" != "y" -a "$CHECK" != "yes" ] && exit 1
65 # if rsync has --xattr support, then try to copy the xattrs.
66 $RSYNC --help 2>&1 | grep -q xattr && RSYNC_OPTS="$RSYNC_OPTS -X"
67 $RSYNC --help 2>&1 | grep -q acls && RSYNC_OPTS="$RSYNC_OPTS -A"
68 # If rsync copies lustre xattrs in the future, then we can skip lfs (bug 22189)
69 strings $(which $RSYNC) 2>&1 | grep -q lustre && LFS=:
72 while read OLDNAME; do
75 # avoid duplicate stat if possible
76 TYPE_LINK=($(stat -c "%h %F" "$OLDNAME" || true))
78 # skip non-regular files, since they don't have any objects
79 # and there is no point in trying to migrate them.
80 if [ "${TYPE_LINK[1]}" != "regular" ]; then
81 echo -e "not a regular file, skipped"
85 if [ -z "$OPT_NLINK" -a ${TYPE_LINK[0]} -gt 1 ]; then
86 echo -e "multiple hard links, skipped"
90 # working out write perms is hard, let the shell do it
91 if [ ! -w "$OLDNAME" ]; then
92 echo -e "no write permission, skipped"
96 if [ "$OPT_DRYRUN" ]; then
97 echo -e "dry run, skipped"
102 # if rsync copies Lustre xattrs properly in the future
103 # (i.e. before the file data, so that it preserves striping)
104 # then we don't need to do this getstripe/mktemp stuff.
106 COUNT=$($LFS getstripe -c "$OLDNAME" 2> /dev/null)
107 SIZE=$($LFS getstripe -s "$OLDNAME" 2> /dev/null)
108 [ -z "$COUNT" -o -z "$SIZE" ] && UNLINK=""
109 NEWNAME=$(mktemp $UNLINK "$OLDNAME.tmp.XXXXXX")
110 if [ $? -ne 0 -o -z "$NEWNAME" ]; then
111 echo -e "\r$OLDNAME: can't make temp file, skipped" 1>&2
115 [ "$UNLINK" ] && $LFS setstripe -c${COUNT} -s${SIZE} "$NEWNAME"
117 # we use --inplace, since we created our own temp file already
118 if ! $RSYNC -a --inplace $RSYNC_OPTS "$OLDNAME" "$NEWNAME";then
119 echo -e "\r$OLDNAME: copy error, exiting" 1>&2
124 if [ "$OPT_CHECK" ] && ! cmp "$OLDNAME" "$NEWNAME"; then
125 echo -e "\r$NEWNAME: compare failed, exiting" 1>&2
129 if ! mv "$NEWNAME" "$OLDNAME"; then
130 echo -e "\r$OLDNAME: rename error, exiting" 1>&2
137 if [ "$#" -eq 0 ]; then
142 lfs find "$1" -type f | lfs_migrate
144 echo $1 | lfs_migrate