Whamcloud - gitweb
LU-10401 tests: add -F so list_param prints entry type
[fs/lustre-release.git] / lustre / tests / test-framework.sh
1 #!/bin/bash
2
3 trap 'print_summary && print_stack_trace | tee $TF_FAIL && \
4     echo "$TESTSUITE: FAIL: test-framework exiting on error"' ERR
5 set -e
6
7 export LANG=en_US
8 export REFORMAT=${REFORMAT:-""}
9 export WRITECONF=${WRITECONF:-""}
10 export VERBOSE=${VERBOSE:-false}
11 export GSS=${GSS:-false}
12 export GSS_SK=${GSS_SK:-false}
13 export GSS_KRB5=false
14 export GSS_PIPEFS=false
15 export SHARED_KEY=${SHARED_KEY:-false}
16 export SK_PATH=${SK_PATH:-/tmp/test-framework-keys}
17 export SK_OM_PATH=$SK_PATH'/tmp-request-mount'
18 export SK_MOUNTED=${SK_MOUNTED:-false}
19 export SK_FLAVOR=${SK_FLAVOR:-ski}
20 export SK_NO_KEY=${SK_NO_KEY:-true}
21 export SK_UNIQUE_NM=${SK_UNIQUE_NM:-false}
22 export SK_S2S=${SK_S2S:-false}
23 export SK_S2SNM=${SK_S2SNM:-TestFrameNM}
24 export SK_S2SNMCLI=${SK_S2SNMCLI:-TestFrameNMCli}
25 export SK_SKIPFIRST=${SK_SKIPFIRST:-true}
26 export IDENTITY_UPCALL=default
27 export QUOTA_AUTO=1
28 export FLAKEY=${FLAKEY:-true}
29 # specify environment variable containing batch job name for server statistics
30 export JOBID_VAR=${JOBID_VAR:-"procname_uid"}  # or "existing" or "disable"
31
32 #export PDSH="pdsh -S -Rssh -w"
33 export MOUNT_CMD=${MOUNT_CMD:-"mount -t lustre"}
34 export UMOUNT=${UMOUNT:-"umount -d"}
35
36 export LSNAPSHOT_CONF="/etc/ldev.conf"
37 export LSNAPSHOT_LOG="/var/log/lsnapshot.log"
38
39 # sles12 umount has a issue with -d option
40 [ -e /etc/SuSE-release ] && grep -w VERSION /etc/SuSE-release | grep -wq 12 && {
41         export UMOUNT="umount"
42 }
43
44 # function used by scripts run on remote nodes
45 LUSTRE=${LUSTRE:-$(cd $(dirname $0)/..; echo $PWD)}
46 . $LUSTRE/tests/functions.sh
47 . $LUSTRE/tests/yaml.sh
48
49 export LD_LIBRARY_PATH=${LUSTRE}/utils/.libs:${LUSTRE}/utils:${LD_LIBRARY_PATH}
50
51 LUSTRE_TESTS_CFG_DIR=${LUSTRE_TESTS_CFG_DIR:-${LUSTRE}/tests/cfg}
52
53 EXCEPT_LIST_FILE=${EXCEPT_LIST_FILE:-${LUSTRE_TESTS_CFG_DIR}/tests-to-skip.sh}
54
55 if [ -f "$EXCEPT_LIST_FILE" ]; then
56     echo "Reading test skip list from $EXCEPT_LIST_FILE"
57     cat $EXCEPT_LIST_FILE
58     . $EXCEPT_LIST_FILE
59 fi
60
61 # check config files for options in decreasing order of preference
62 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/lustre.conf ] &&
63     MODPROBECONF=/etc/modprobe.d/lustre.conf
64 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/Lustre ] &&
65     MODPROBECONF=/etc/modprobe.d/Lustre
66 [ -z "$MODPROBECONF" -a -f /etc/modprobe.conf ] &&
67     MODPROBECONF=/etc/modprobe.conf
68
69 sanitize_parameters() {
70         for i in DIR DIR1 DIR2 MOUNT MOUNT1 MOUNT2
71         do
72                 local path=${!i}
73                 if [ -d "$path" ]; then
74                         eval export $i=$(echo $path | sed -r 's/\/+$//g')
75                 fi
76         done
77 }
78 assert_DIR () {
79         local failed=""
80         [[ $DIR/ = $MOUNT/* ]] ||
81                 { failed=1 && echo "DIR=$DIR not in $MOUNT. Aborting."; }
82         [[ $DIR1/ = $MOUNT1/* ]] ||
83                 { failed=1 && echo "DIR1=$DIR1 not in $MOUNT1. Aborting."; }
84         [[ $DIR2/ = $MOUNT2/* ]] ||
85                 { failed=1 && echo "DIR2=$DIR2 not in $MOUNT2. Aborting"; }
86
87         [ -n "$failed" ] && exit 99 || true
88 }
89
90 usage() {
91     echo "usage: $0 [-r] [-f cfgfile]"
92     echo "       -r: reformat"
93
94     exit
95 }
96
97 print_summary () {
98         trap 0
99         [ -z "$DEFAULT_SUITES" ] && return 0
100         [ -n "$ONLY" ] && echo "WARNING: ONLY is set to $(echo $ONLY)"
101         local details
102         local form="%-13s %-17s %-9s %s %s\n"
103
104         printf "$form" "status" "script" "Total(sec)" "E(xcluded) S(low)"
105         echo "---------------------------------------------------------------"
106     for O in $DEFAULT_SUITES; do
107         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
108         [ "${!O}" = "no" ] && continue || true
109         local o=$(echo $O  | tr "[:upper:]_" "[:lower:]-")
110         local log=${TMP}/${o}.log
111         if is_sanity_benchmark $o; then
112             log=${TMP}/sanity-benchmark.log
113         fi
114         local slow=
115         local skipped=
116         local total=
117         local status=Unfinished
118         if [ -f $log ]; then
119                 skipped=$(grep excluded $log | awk '{ printf " %s", $3 }' |
120                         sed 's/test_//g')
121                 slow=$(egrep "^PASS|^FAIL" $log | tr -d "("| sed s/s\)$//g |
122                         sort -nr -k 3  | head -n5 |  awk '{ print $2":"$3"s" }')
123                 total=$(grep duration $log | awk '{ print $2 }')
124                 if [ "${!O}" = "done" ]; then
125                         status=Done
126                 fi
127                 if $DDETAILS; then
128                         local durations=$(egrep "^PASS|^FAIL" $log |
129                                 tr -d "("| sed s/s\)$//g |
130                                 awk '{ print $2":"$3"|" }')
131                         details=$(printf "%s\n%s %s %s\n" "$details" \
132                                 "DDETAILS" "$O" "$(echo $durations)")
133                 fi
134         fi
135         printf "$form" $status "$O" "${total}" "E=$skipped"
136         printf "$form" "-" "-" "-" "S=$(echo $slow)"
137     done
138
139     for O in $DEFAULT_SUITES; do
140         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
141         if [ "${!O}" = "no" ]; then
142             printf "$form" "Skipped" "$O" ""
143         fi
144     done
145
146     # print the detailed tests durations if DDETAILS=true
147     if $DDETAILS; then
148         echo "$details"
149     fi
150 }
151
152 # Get information about the Lustre environment. The information collected
153 # will be used in Lustre tests.
154 # usage: get_lustre_env
155 # input: No required or optional arguments
156 # output: No return values, environment variables are exported
157
158 get_lustre_env() {
159
160         export mds1_FSTYPE=${mds1_FSTYPE:-$(facet_fstype mds1)}
161         export ost1_FSTYPE=${ost1_FSTYPE:-$(facet_fstype ost1)}
162
163         export MGS_VERSION=$(lustre_version_code mgs)
164         export MDS1_VERSION=$(lustre_version_code mds1)
165         export OST1_VERSION=$(lustre_version_code ost1)
166         export CLIENT_VERSION=$(lustre_version_code client)
167
168         # Prefer using "mds1" directly instead of SINGLEMDS.
169         # Keep this for compat until it is removed from scripts.
170         export SINGLEMDS=${SINGLEMDS:-mds1}
171 }
172
173 init_test_env() {
174         export LUSTRE=$(absolute_path $LUSTRE)
175         export TESTSUITE=$(basename $0 .sh)
176         export TEST_FAILED=false
177         export FAIL_ON_SKIP_ENV=${FAIL_ON_SKIP_ENV:-false}
178         export RPC_MODE=${RPC_MODE:-false}
179         export DO_CLEANUP=${DO_CLEANUP:-true}
180         export KEEP_ZPOOL=${KEEP_ZPOOL:-false}
181         export CLEANUP_DM_DEV=false
182         export PAGE_SIZE=$(get_page_size client)
183
184         export MKE2FS=$MKE2FS
185         if [ -z "$MKE2FS" ]; then
186                 if which mkfs.ldiskfs >/dev/null 2>&1; then
187                         export MKE2FS=mkfs.ldiskfs
188                 else
189                         export MKE2FS=mke2fs
190                 fi
191         fi
192
193         export DEBUGFS=$DEBUGFS
194         if [ -z "$DEBUGFS" ]; then
195                 if which debugfs.ldiskfs >/dev/null 2>&1; then
196                         export DEBUGFS=debugfs.ldiskfs
197                 else
198                         export DEBUGFS=debugfs
199                 fi
200         fi
201
202         export TUNE2FS=$TUNE2FS
203         if [ -z "$TUNE2FS" ]; then
204                 if which tunefs.ldiskfs >/dev/null 2>&1; then
205                         export TUNE2FS=tunefs.ldiskfs
206                 else
207                         export TUNE2FS=tune2fs
208                 fi
209         fi
210
211         export E2LABEL=$E2LABEL
212         if [ -z "$E2LABEL" ]; then
213                 if which label.ldiskfs >/dev/null 2>&1; then
214                         export E2LABEL=label.ldiskfs
215                 else
216                         export E2LABEL=e2label
217                 fi
218         fi
219
220         export DUMPE2FS=$DUMPE2FS
221         if [ -z "$DUMPE2FS" ]; then
222                 if which dumpfs.ldiskfs >/dev/null 2>&1; then
223                         export DUMPE2FS=dumpfs.ldiskfs
224                 else
225                         export DUMPE2FS=dumpe2fs
226                 fi
227         fi
228
229         export E2FSCK=$E2FSCK
230         if [ -z "$E2FSCK" ]; then
231                 if which fsck.ldiskfs >/dev/null 2>&1; then
232                         export E2FSCK=fsck.ldiskfs
233                 else
234                          export E2FSCK=e2fsck
235                 fi
236         fi
237
238         export RESIZE2FS=$RESIZE2FS
239         if [ -z "$RESIZE2FS" ]; then
240                 if which resizefs.ldiskfs >/dev/null 2>&1; then
241                         export RESIZE2FS=resizefs.ldiskfs
242                 else
243                         export RESIZE2FS=resize2fs
244                 fi
245         fi
246
247         export LFSCK_ALWAYS=${LFSCK_ALWAYS:-"no"} # check fs after test suite
248         export FSCK_MAX_ERR=4   # File system errors left uncorrected
249
250         export ZFS=${ZFS:-zfs}
251         export ZPOOL=${ZPOOL:-zpool}
252         export ZDB=${ZDB:-zdb}
253         export PARTPROBE=${PARTPROBE:-partprobe}
254
255         #[ -d /r ] && export ROOT=${ROOT:-/r}
256         export TMP=${TMP:-$ROOT/tmp}
257         export TESTSUITELOG=${TMP}/${TESTSUITE}.log
258         export LOGDIR=${LOGDIR:-${TMP}/test_logs/$(date +%s)}
259         export TESTLOG_PREFIX=$LOGDIR/$TESTSUITE
260
261         export HOSTNAME=${HOSTNAME:-$(hostname -s)}
262         if ! echo $PATH | grep -q $LUSTRE/utils; then
263                 export PATH=$LUSTRE/utils:$PATH
264         fi
265         if ! echo $PATH | grep -q $LUSTRE/utils/gss; then
266                 export PATH=$LUSTRE/utils/gss:$PATH
267         fi
268         if ! echo $PATH | grep -q $LUSTRE/tests; then
269                 export PATH=$LUSTRE/tests:$PATH
270         fi
271         if ! echo $PATH | grep -q $LUSTRE/../lustre-iokit/sgpdd-survey; then
272                 export PATH=$LUSTRE/../lustre-iokit/sgpdd-survey:$PATH
273         fi
274         export LST=${LST:-"$LUSTRE/../lnet/utils/lst"}
275         [ ! -f "$LST" ] && export LST=$(which lst)
276         export SGPDDSURVEY=${SGPDDSURVEY:-"$LUSTRE/../lustre-iokit/sgpdd-survey/sgpdd-survey")}
277         [ ! -f "$SGPDDSURVEY" ] && export SGPDDSURVEY=$(which sgpdd-survey)
278         export MCREATE=${MCREATE:-mcreate}
279         export MULTIOP=${MULTIOP:-multiop}
280         # Ubuntu, at least, has a truncate command in /usr/bin
281         # so fully path our truncate command.
282         export TRUNCATE=${TRUNCATE:-$LUSTRE/tests/truncate}
283         export FSX=${FSX:-$LUSTRE/tests/fsx}
284         export MDSRATE=${MDSRATE:-"$LUSTRE/tests/mpi/mdsrate"}
285         [ ! -f "$MDSRATE" ] && export MDSRATE=$(which mdsrate 2> /dev/null)
286         if ! echo $PATH | grep -q $LUSTRE/tests/racer; then
287                 export PATH=$LUSTRE/tests/racer:$PATH:
288         fi
289         if ! echo $PATH | grep -q $LUSTRE/tests/mpi; then
290                 export PATH=$LUSTRE/tests/mpi:$PATH
291         fi
292         export RSYNC_RSH=${RSYNC_RSH:-rsh}
293
294         export LCTL=${LCTL:-"$LUSTRE/utils/lctl"}
295         [ ! -f "$LCTL" ] && export LCTL=$(which lctl)
296         export LFS=${LFS:-"$LUSTRE/utils/lfs"}
297         [ ! -f "$LFS" ] && export LFS=$(which lfs)
298
299         export PERM_CMD=${PERM_CMD:-"$LCTL conf_param"}
300
301         export L_GETIDENTITY=${L_GETIDENTITY:-"$LUSTRE/utils/l_getidentity"}
302         if [ ! -f "$L_GETIDENTITY" ]; then
303                 if `which l_getidentity > /dev/null 2>&1`; then
304                         export L_GETIDENTITY=$(which l_getidentity)
305                 else
306                         export L_GETIDENTITY=NONE
307                 fi
308         fi
309         export LL_DECODE_FILTER_FID=${LL_DECODE_FILTER_FID:-"$LUSTRE/utils/ll_decode_filter_fid"}
310         [ ! -f "$LL_DECODE_FILTER_FID" ] && export LL_DECODE_FILTER_FID="ll_decode_filter_fid"
311         export LL_DECODE_LINKEA=${LL_DECODE_LINKEA:-"$LUSTRE/utils/ll_decode_linkea"}
312         [ ! -f "$LL_DECODE_LINKEA" ] && export LL_DECODE_LINKEA="ll_decode_linkea"
313         export MKFS=${MKFS:-"$LUSTRE/utils/mkfs.lustre"}
314         [ ! -f "$MKFS" ] && export MKFS="mkfs.lustre"
315         export TUNEFS=${TUNEFS:-"$LUSTRE/utils/tunefs.lustre"}
316         [ ! -f "$TUNEFS" ] && export TUNEFS="tunefs.lustre"
317         export CHECKSTAT="${CHECKSTAT:-"checkstat -v"} "
318         export LUSTRE_RMMOD=${LUSTRE_RMMOD:-$LUSTRE/scripts/lustre_rmmod}
319         [ ! -f "$LUSTRE_RMMOD" ] &&
320                 export LUSTRE_RMMOD=$(which lustre_rmmod 2> /dev/null)
321         export LUSTRE_ROUTES_CONVERSION=${LUSTRE_ROUTES_CONVERSION:-$LUSTRE/scripts/lustre_routes_conversion}
322         [ ! -f "$LUSTRE_ROUTES_CONVERSION" ] &&
323                 export LUSTRE_ROUTES_CONVERSION=$(which lustre_routes_conversion 2> /dev/null)
324         export LFS_MIGRATE=${LFS_MIGRATE:-$LUSTRE/scripts/lfs_migrate}
325         [ ! -f "$LFS_MIGRATE" ] &&
326                 export LFS_MIGRATE=$(which lfs_migrate 2> /dev/null)
327         export LR_READER=${LR_READER:-"$LUSTRE/utils/lr_reader"}
328         [ ! -f "$LR_READER" ] &&
329                 export LR_READER=$(which lr_reader 2> /dev/null)
330         [ -z "$LR_READER" ] && export LR_READER="/usr/sbin/lr_reader"
331         export LSOM_SYNC=${LSOM_SYNC:-"$LUSTRE/utils/llsom_sync"}
332         [ ! -f "$LSOM_SYNC" ] &&
333                 export LSOM_SYNC=$(which llsom_sync 2> /dev/null)
334         [ -z "$LSOM_SYNC" ] && export LSOM_SYNC="/usr/sbin/llsom_sync"
335         export NAME=${NAME:-local}
336         export LGSSD=${LGSSD:-"$LUSTRE/utils/gss/lgssd"}
337         [ "$GSS_PIPEFS" = "true" ] && [ ! -f "$LGSSD" ] &&
338                 export LGSSD=$(which lgssd)
339         export LSVCGSSD=${LSVCGSSD:-"$LUSTRE/utils/gss/lsvcgssd"}
340         [ ! -f "$LSVCGSSD" ] && export LSVCGSSD=$(which lsvcgssd 2> /dev/null)
341         export KRB5DIR=${KRB5DIR:-"/usr/kerberos"}
342         export DIR2
343         export SAVE_PWD=${SAVE_PWD:-$LUSTRE/tests}
344         export AT_MAX_PATH
345         export LDEV=${LDEV:-"$LUSTRE/scripts/ldev"}
346         [ ! -f "$LDEV" ] && export LDEV=$(which ldev 2> /dev/null)
347
348         export DMSETUP=${DMSETUP:-dmsetup}
349         export DM_DEV_PATH=${DM_DEV_PATH:-/dev/mapper}
350         export LOSETUP=${LOSETUP:-losetup}
351
352         if [ "$ACCEPTOR_PORT" ]; then
353                 export PORT_OPT="--port $ACCEPTOR_PORT"
354         fi
355
356         if $SHARED_KEY; then
357                 $RPC_MODE || echo "Using GSS shared-key feature"
358                 which lgss_sk > /dev/null 2>&1 ||
359                         error_exit "built with lgss_sk disabled! SEC=$SEC"
360                 GSS=true
361                 GSS_SK=true
362                 SEC=$SK_FLAVOR
363         fi
364
365         case "x$SEC" in
366                 xkrb5*)
367                 $RPC_MODE || echo "Using GSS/krb5 ptlrpc security flavor"
368                 which lgss_keyring > /dev/null 2>&1 ||
369                         error_exit "built with gss disabled! SEC=$SEC"
370                 GSS=true
371                 GSS_KRB5=true
372                 ;;
373         esac
374
375         case "x$IDUP" in
376                 xtrue)
377                         IDENTITY_UPCALL=true
378                         ;;
379                 xfalse)
380                         IDENTITY_UPCALL=false
381                         ;;
382         esac
383
384         export LOAD_MODULES_REMOTE=${LOAD_MODULES_REMOTE:-false}
385
386         # Paths on remote nodes, if different
387         export RLUSTRE=${RLUSTRE:-$LUSTRE}
388         export RPWD=${RPWD:-$PWD}
389         export I_MOUNTED=${I_MOUNTED:-"no"}
390         export AUSTER_CLEANUP=${AUSTER_CLEANUP:-false}
391         if [ ! -f /lib/modules/$(uname -r)/kernel/fs/lustre/mdt.ko -a \
392              ! -f /lib/modules/$(uname -r)/updates/kernel/fs/lustre/mdt.ko -a \
393              ! -f /lib/modules/$(uname -r)/extra/kernel/fs/lustre/mdt.ko -a \
394              ! -f $LUSTRE/mdt/mdt.ko ]; then
395             export CLIENTMODSONLY=yes
396         fi
397
398         export SHUTDOWN_ATTEMPTS=${SHUTDOWN_ATTEMPTS:-3}
399         export OSD_TRACK_DECLARES_LBUG=${OSD_TRACK_DECLARES_LBUG:-"yes"}
400
401         # command line
402
403         while getopts "rvwf:" opt $*; do
404                 case $opt in
405                         f) CONFIG=$OPTARG;;
406                         r) REFORMAT=yes;;
407                         v) VERBOSE=true;;
408                         w) WRITECONF=writeconf;;
409                         \?) usage;;
410                 esac
411         done
412
413         shift $((OPTIND - 1))
414         ONLY=${ONLY:-$*}
415
416         # print the durations of each test if "true"
417         DDETAILS=${DDETAILS:-false}
418         [ "$TESTSUITELOG" ] && rm -f $TESTSUITELOG || true
419         if ! $RPC_MODE; then
420                 rm -f $TMP/*active
421         fi
422
423         export TF_FAIL=${TF_FAIL:-$TMP/tf.fail}
424
425         # Constants used in more than one test script
426         export LOV_MAX_STRIPE_COUNT=2000
427
428         export MACHINEFILE=${MACHINEFILE:-$TMP/$(basename $0 .sh).machines}
429         . ${CONFIG:=$LUSTRE/tests/cfg/$NAME.sh}
430         get_lustre_env
431
432         # use localrecov to enable recovery for local clients, LU-12722
433         [[ $MDS1_VERSION -lt $(version_code 2.13.52) ]] ||
434                 export MDS_MOUNT_OPTS=${MDS_MOUNT_OPTS:-"-o localrecov"}
435         [[ $OST1_VERSION -lt $(version_code 2.13.52) ]] ||
436                 export OST_MOUNT_OPTS=${OST_MOUNT_OPTS:-"-o localrecov"}
437 }
438
439 check_cpt_number() {
440         local facet=$1
441         local ncpts
442
443         ncpts=$(do_facet $facet "lctl get_param -n " \
444                 "cpu_partition_table 2>/dev/null| wc -l" || echo 1)
445
446         if [ $ncpts -eq 0 ]; then
447                 echo "1"
448         else
449                 echo $ncpts
450         fi
451 }
452
453 # Return a numeric version code based on a version string.  The version
454 # code is useful for comparison two version strings to see which is newer.
455 version_code() {
456         # split arguments like "1.8.6-wc3" into "1", "8", "6", "wc3"
457         eval set -- $(tr "[:punct:]" " " <<< $*)
458
459         echo -n $(((${1:-0} << 16) | (${2:-0} << 8) | ${3:-0}))
460 }
461
462 export LINUX_VERSION=$(uname -r | sed -e "s/\([0-9]*\.[0-9]*\.[0-9]*\).*/\1/")
463 export LINUX_VERSION_CODE=$(version_code ${LINUX_VERSION//\./ })
464
465 # Report the Lustre build version string (e.g. 1.8.7.3 or 2.4.1).
466 #
467 # usage: lustre_build_version
468 #
469 # All Lustre versions support "lctl get_param" to report the version of the
470 # code running in the kernel (what our tests are interested in), but it
471 # doesn't work without modules loaded.  After 2.9.53 and in upstream kernels
472 # the "version" parameter doesn't include "lustre: " at the beginning.
473 # If that fails, call "lctl lustre_build_version" which prints either (or both)
474 # the userspace and kernel build versions, but until 2.8.55 required root
475 # access to get the Lustre kernel version.  If that also fails, fall back to
476 # using "lctl --version", which is easy to parse and works without the kernel
477 # modules, but was only added in 2.6.50 and only prints the lctl tool version,
478 # not the module version, though they are usually the same.
479 #
480 # Various commands and their output format for different Lustre versions:
481 # lctl get_param version:       2.9.55
482 # lctl get_param version:       lustre: 2.8.53
483 # lctl get_param version:       lustre: 2.6.52
484 #                               kernel: patchless_client
485 #                               build: v2_6_92_0-2.6.32-431.el6_lustre.x86_64
486 # lctl lustre_build_version:    Lustre version: 2.8.53_27_gae67fc01
487 # lctl lustre_build_version:    error: lustre_build_version: Permission denied
488 #       (as non-root user)      lctl   version: v2_6_92_0-2.6.32-431.el6.x86_64
489 # lctl lustre_build_version:    Lustre version: 2.5.3-2.6.32.26-175.fc12.x86_64
490 #                               lctl   version: 2.5.3-2.6.32..26-175fc12.x86_64
491 # lctl --version:               lctl 2.6.50
492 #
493 # output: prints version string to stdout in (up to 4) dotted-decimal values
494 lustre_build_version() {
495         local facet=${1:-client}
496         local facet_version=${facet}_VERSION
497
498         # if the global variable is already set, then use that
499         [ -n "${!facet_version}" ] && echo ${!facet_version} && return
500
501         # this is the currently-running version of the kernel modules
502         local ver=$(do_facet $facet "$LCTL get_param -n version 2>/dev/null")
503         # we mostly test 2.10+ systems, only try others if the above fails
504         if [ -z "$ver" ]; then
505                 ver=$(do_facet $facet "$LCTL lustre_build_version 2>/dev/null")
506         fi
507         if [ -z "$ver" ]; then
508                 ver=$(do_facet $facet "$LCTL --version 2>/dev/null" |
509                       cut -d' ' -f2)
510         fi
511         local lver=$(egrep -i "lustre: |version: " <<<"$ver" | head -n 1)
512         [ -n "$lver" ] && ver="$lver"
513
514         lver=$(sed -e 's/[^:]*: //' -e 's/^v//' -e 's/[ -].*//' <<<$ver |
515                tr _ . | cut -d. -f1-4)
516
517         # save in global variable for the future
518         export $facet_version=$lver
519
520         echo $lver
521 }
522
523 # Report the Lustre numeric build version code for the supplied facet.
524 lustre_version_code() {
525         version_code $(lustre_build_version $1)
526 }
527
528 module_loaded () {
529         /sbin/lsmod | grep -q "^\<$1\>"
530 }
531
532 PRLFS=false
533 lustre_insmod() {
534         local module=$1
535         shift
536         local args="$@"
537         local msg
538         local rc=0
539
540         if ! $PRLFS; then
541                 msg="$(insmod $module $args 2>&1)" && return 0 || rc=$?
542         fi
543
544         # parallels can't load modules directly from prlfs, use /tmp instead
545         if $PRLFS || [[ "$(stat -f -c%t $module)" == "7c7c6673" ]]; then
546                 local target="$(mktemp)"
547
548                 cp "$module" "$target"
549                 insmod $target $args
550                 rc=$?
551                 [[ $rc == 0 ]] && PRLFS=true
552                 rm -f $target
553         else
554                 echo "$msg"
555         fi
556         return $rc
557 }
558
559 # Load a module on the system where this is running.
560 #
561 # usage: load_module module_name [module arguments for insmod/modprobe]
562 #
563 # If module arguments are not given but MODOPTS_<MODULE> is set, then its value
564 # will be used as the arguments.  Otherwise arguments will be obtained from
565 # /etc/modprobe.conf, from /etc/modprobe.d/Lustre, or else none will be used.
566 #
567 load_module() {
568         local module=$1 # '../libcfs/libcfs/libcfs', 'obdclass/obdclass', ...
569         shift
570         local ext=".ko"
571         local base=$(basename $module $ext)
572         local path
573         local -A module_is_loaded_aa
574         local optvar
575         local mod
576
577         for mod in $(lsmod | awk '{ print $1; }'); do
578                 module_is_loaded_aa[${mod//-/_}]=true
579         done
580
581         module_is_loaded() {
582                 ${module_is_loaded_aa[${1//-/_}]:-false}
583         }
584
585         if module_is_loaded $base; then
586                 return
587         fi
588
589         if [[ -f $LUSTRE/$module$ext ]]; then
590                 path=$LUSTRE/$module$ext
591         elif [[ "$base" == lnet_selftest ]] &&
592              [[ -f $LUSTRE/../lnet/selftest/$base$ext ]]; then
593                 path=$LUSTRE/../lnet/selftest/$base$ext
594         else
595                 path=''
596         fi
597
598         if [[ -n "$path" ]]; then
599                 # Try to load any non-Lustre modules that $module depends on.
600                 for mod in $(modinfo --field=depends $path | tr ',' ' '); do
601                         if ! module_is_loaded $mod; then
602                                 modprobe $mod
603                         fi
604                 done
605         fi
606
607         # If no module arguments were passed then get them from
608         # $MODOPTS_<MODULE>, otherwise from modprobe.conf.
609         if [ $# -eq 0 ]; then
610                 # $MODOPTS_<MODULE>; we could use associative arrays, but that's
611                 # not in Bash until 4.x, so we resort to eval.
612                 optvar="MODOPTS_$(basename $module | tr a-z A-Z)"
613                 eval set -- \$$optvar
614                 if [ $# -eq 0 -a -n "$MODPROBECONF" ]; then
615                         # Nothing in $MODOPTS_<MODULE>; try modprobe.conf
616                         local opt
617                         opt=$(awk -v var="^options $base" '$0 ~ var \
618                               {gsub("'"options $base"'",""); print}' \
619                                 $MODPROBECONF)
620                         set -- $(echo -n $opt)
621
622                         # Ensure we have accept=all for lnet
623                         if [[ "$base" == lnet ]]; then
624                                 # OK, this is a bit wordy...
625                                 local arg accept_all_present=false
626
627                                 for arg in "$@"; do
628                                         [[ "$arg" == accept=all ]] &&
629                                                 accept_all_present=true
630                                 done
631
632                                 $accept_all_present || set -- "$@" accept=all
633                         fi
634
635                         export $optvar="$*"
636                 fi
637         fi
638
639         [ $# -gt 0 ] && echo "${module} options: '$*'"
640
641         # Note that insmod will ignore anything in modprobe.conf, which is why
642         # we're passing options on the command-line. If $path does not exist
643         # then we must be testing a "make install" or"rpm" installation. Also
644         # note that failing to load ptlrpc_gss is not considered fatal.
645         if [[ -n "$path" ]]; then
646                 lustre_insmod $path "$@"
647         elif [[ "$base" == ptlrpc_gss ]]; then
648                 if ! modprobe $base "$@" 2>/dev/null; then
649                         echo "gss/krb5 is not supported"
650                 fi
651         else
652                 modprobe $base "$@"
653         fi
654 }
655
656 load_modules_local() {
657         if [ -n "$MODPROBE" ]; then
658                 # use modprobe
659                 echo "Using modprobe to load modules"
660                 return 0
661         fi
662
663         # Create special udev test rules on every node
664         if [ -f $LUSTRE/lustre/conf/99-lustre.rules ]; then {
665                 sed -e 's|/usr/sbin/lctl|$LCTL|g' $LUSTRE/lustre/conf/99-lustre.rules > /etc/udev/rules.d/99-lustre-test.rules
666         } else {
667                 echo "SUBSYSTEM==\"lustre\", ACTION==\"change\", ENV{PARAM}==\"?*\", RUN+=\"$LCTL set_param '\$env{PARAM}=\$env{SETTING}'\"" > /etc/udev/rules.d/99-lustre-test.rules
668         } fi
669         udevadm control --reload-rules
670         udevadm trigger
671
672         # For kmemleak-enabled kernels we need clear all past state
673         # that obviously has nothing to do with this Lustre run
674         # Disable automatic memory scanning to avoid perf hit.
675         if [ -f /sys/kernel/debug/kmemleak ] ; then
676                 echo scan=off > /sys/kernel/debug/kmemleak
677                 echo scan > /sys/kernel/debug/kmemleak
678                 echo clear > /sys/kernel/debug/kmemleak
679         fi
680
681         echo Loading modules from $LUSTRE
682
683         local ncpus
684
685         if [ -f /sys/devices/system/cpu/online ]; then
686                 ncpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/online) + 1))
687                 echo "detected $ncpus online CPUs by sysfs"
688         else
689                 ncpus=$(getconf _NPROCESSORS_CONF 2>/dev/null)
690                 local rc=$?
691                 if [ $rc -eq 0 ]; then
692                         echo "detected $ncpus online CPUs by getconf"
693                 else
694                         echo "Can't detect number of CPUs"
695                         ncpus=1
696                 fi
697         fi
698
699         # if there is only one CPU core, libcfs can only create one partition
700         # if there is more than 4 CPU cores, libcfs should create multiple CPU
701         # partitions. So we just force libcfs to create 2 partitions for
702         # system with 2 or 4 cores
703         local saved_opts="$MODOPTS_LIBCFS"
704         if [ $ncpus -le 4 ] && [ $ncpus -gt 1 ]; then
705                 # force to enable multiple CPU partitions
706                 echo "Force libcfs to create 2 CPU partitions"
707                 MODOPTS_LIBCFS="cpu_npartitions=2 $MODOPTS_LIBCFS"
708         else
709                 echo "libcfs will create CPU partition based on online CPUs"
710         fi
711
712         load_module ../libcfs/libcfs/libcfs
713         # Prevent local MODOPTS_LIBCFS being passed as part of environment
714         # variable to remote nodes
715         MODOPTS_LIBCFS=$saved_opts
716
717         set_default_debug
718         load_module ../lnet/lnet/lnet
719
720         LNDPATH=${LNDPATH:-"../lnet/klnds"}
721         if [ -z "$LNETLND" ]; then
722                 case $NETTYPE in
723                 o2ib*)  LNETLND="o2iblnd/ko2iblnd" ;;
724                 tcp*)   LNETLND="socklnd/ksocklnd" ;;
725                 *)      local lnd="${NETTYPE%%[0-9]}lnd"
726                         [ -f "$LNDPATH/$lnd/k$lnd.ko" ] &&
727                                 LNETLND="$lnd/k$lnd" ||
728                                 LNETLND="socklnd/ksocklnd"
729                 esac
730         fi
731         load_module ../lnet/klnds/$LNETLND
732         load_module obdclass/obdclass
733         load_module ptlrpc/ptlrpc
734         load_module ptlrpc/gss/ptlrpc_gss
735         load_module fld/fld
736         load_module fid/fid
737         load_module lmv/lmv
738         load_module osc/osc
739         load_module mdc/mdc
740         load_module lov/lov
741         load_module mgc/mgc
742         load_module obdecho/obdecho
743         if ! client_only; then
744                 load_module lfsck/lfsck
745                 [ "$LQUOTA" != "no" ] &&
746                         load_module quota/lquota $LQUOTAOPTS
747                 if [[ $(node_fstypes $HOSTNAME) == *zfs* ]]; then
748                         load_module osd-zfs/osd_zfs
749                 elif [[ $(node_fstypes $HOSTNAME) == *ldiskfs* ]]; then
750                         load_module ../ldiskfs/ldiskfs
751                         load_module osd-ldiskfs/osd_ldiskfs
752                 fi
753                 load_module mgs/mgs
754                 load_module mdd/mdd
755                 load_module mdt/mdt
756                 load_module ost/ost
757                 load_module lod/lod
758                 load_module osp/osp
759                 load_module ofd/ofd
760                 load_module osp/osp
761         fi
762
763         load_module llite/lustre
764         [ -d /r ] && OGDB=${OGDB:-"/r/tmp"}
765         OGDB=${OGDB:-$TMP}
766         rm -f $OGDB/ogdb-$HOSTNAME
767         $LCTL modules > $OGDB/ogdb-$HOSTNAME
768
769         # 'mount' doesn't look in $PATH, just sbin
770         local mount_lustre=$LUSTRE/utils/mount.lustre
771         if [ -f $mount_lustre ]; then
772                 local sbin_mount=$(readlink -f /sbin)/mount.lustre
773                 if grep -qw "$sbin_mount" /proc/mounts; then
774                         cmp -s $mount_lustre $sbin_mount || umount $sbin_mount
775                 fi
776                 if ! grep -qw "$sbin_mount" /proc/mounts; then
777                         [ ! -f "$sbin_mount" ] && touch "$sbin_mount"
778                         if [ ! -s "$sbin_mount" -a -w "$sbin_mount" ]; then
779                                 cat <<- EOF > "$sbin_mount"
780                                 #!/bin/sh
781                                 #STUB MARK
782                                 echo "This $sbin_mount just a mountpoint." 1>&2
783                                 echo "It is never supposed to be run." 1>&2
784                                 logger -p emerg -- "using stub $sbin_mount $@"
785                                 exit 1
786                                 EOF
787                                 chmod a+x $sbin_mount
788                         fi
789                         mount --bind $mount_lustre $sbin_mount ||
790                                 error "can't bind $mount_lustre to $sbin_mount"
791                 fi
792         fi
793 }
794
795 load_modules () {
796         load_modules_local
797         # bug 19124
798         # load modules on remote nodes optionally
799         # lustre-tests have to be installed on these nodes
800         if $LOAD_MODULES_REMOTE; then
801                 local list=$(comma_list $(remote_nodes_list))
802                 if [ -n "$list" ]; then
803                         echo "loading modules on: '$list'"
804                         do_rpc_nodes "$list" load_modules_local
805                 fi
806         fi
807 }
808
809 check_mem_leak () {
810     LEAK_LUSTRE=$(dmesg | tail -n 30 | grep "obd_memory.*leaked" || true)
811     LEAK_PORTALS=$(dmesg | tail -n 20 | grep "Portals memory leaked" || true)
812     if [ "$LEAK_LUSTRE" -o "$LEAK_PORTALS" ]; then
813         echo "$LEAK_LUSTRE" 1>&2
814         echo "$LEAK_PORTALS" 1>&2
815         mv $TMP/debug $TMP/debug-leak.`date +%s` || true
816         echo "Memory leaks detected"
817         [ -n "$IGNORE_LEAK" ] && { echo "ignoring leaks" && return 0; } || true
818         return 1
819     fi
820 }
821
822 unload_modules() {
823         wait_exit_ST client # bug 12845
824
825         $LUSTRE_RMMOD ldiskfs || return 2
826
827         [ -f /etc/udev/rules.d/99-lustre-test.rules ] &&
828                 rm /etc/udev/rules.d/99-lustre-test.rules
829         udevadm control --reload-rules
830         udevadm trigger
831
832         if $LOAD_MODULES_REMOTE; then
833                 local list=$(comma_list $(remote_nodes_list))
834                 if [ -n "$list" ]; then
835                         echo "unloading modules on: '$list'"
836                         do_rpc_nodes "$list" $LUSTRE_RMMOD ldiskfs
837                         do_rpc_nodes "$list" check_mem_leak
838                         do_rpc_nodes "$list" "rm -f /etc/udev/rules.d/99-lustre-test.rules"
839                         do_rpc_nodes "$list" "udevadm control --reload-rules"
840                         do_rpc_nodes "$list" "udevadm trigger"
841                 fi
842         fi
843
844         local sbin_mount=$(readlink -f /sbin)/mount.lustre
845         if grep -qe "$sbin_mount " /proc/mounts; then
846                 umount $sbin_mount || true
847                 [ -s $sbin_mount ] && ! grep -q "STUB MARK" $sbin_mount ||
848                         rm -f $sbin_mount
849         fi
850
851         check_mem_leak || return 254
852
853         echo "modules unloaded."
854         return 0
855 }
856
857 fs_log_size() {
858         local facet=${1:-$SINGLEMDS}
859         local size=0
860
861         case $(facet_fstype $facet) in
862                 ldiskfs) size=50;; # largest seen is 44, leave some headroom
863                 # grant_block_size is in bytes, allow at least 2x max blocksize
864                 zfs)     size=$(lctl get_param osc.$FSNAME*.import |
865                                 awk '/grant_block_size:/ {print $2/512; exit;}')
866                           ;;
867         esac
868
869         echo -n $((size * MDSCOUNT))
870 }
871
872 fs_inode_ksize() {
873         local facet=${1:-$SINGLEMDS}
874         local fstype=$(facet_fstype $facet)
875         local size=0
876         case $fstype in
877                 ldiskfs) size=4;;  # ~4KB per inode
878                 zfs)     size=11;; # 10 to 11KB per inode
879         esac
880
881         echo -n $size
882 }
883
884 check_gss_daemon_nodes() {
885     local list=$1
886     dname=$2
887
888     do_nodesv $list "num=\\\$(ps -o cmd -C $dname | grep $dname | wc -l);
889 if [ \\\"\\\$num\\\" -ne 1 ]; then
890     echo \\\$num instance of $dname;
891     exit 1;
892 fi; "
893 }
894
895 check_gss_daemon_facet() {
896     facet=$1
897     dname=$2
898
899     num=`do_facet $facet ps -o cmd -C $dname | grep $dname | wc -l`
900     if [ $num -ne 1 ]; then
901         echo "$num instance of $dname on $facet"
902         return 1
903     fi
904     return 0
905 }
906
907 send_sigint() {
908     local list=$1
909     shift
910     echo Stopping $@ on $list
911     do_nodes $list "killall -2 $@ 2>/dev/null || true"
912 }
913
914 # start gss daemons on all nodes, or "daemon" on "nodes" if set
915 start_gss_daemons() {
916         local nodes=$1
917         local daemon=$2
918
919         if [ "$nodes" ] && [ "$daemon" ] ; then
920                 echo "Starting gss daemon on nodes: $nodes"
921                 do_nodes $nodes "$daemon" || return 8
922                 return 0
923         fi
924
925         nodes=$(comma_list $(mdts_nodes))
926         echo "Starting gss daemon on mds: $nodes"
927         if $GSS_SK; then
928                 # Start all versions, in case of switching
929                 do_nodes $nodes "$LSVCGSSD -vvv -s -m -o -z" || return 1
930         else
931                 do_nodes $nodes "$LSVCGSSD -v" || return 1
932         fi
933         if $GSS_PIPEFS; then
934                 do_nodes $nodes "$LGSSD -v" || return 2
935         fi
936
937         nodes=$(comma_list $(osts_nodes))
938         echo "Starting gss daemon on ost: $nodes"
939         if $GSS_SK; then
940                 # Start all versions, in case of switching
941                 do_nodes $nodes "$LSVCGSSD -vvv -s -m -o -z" || return 3
942         else
943                 do_nodes $nodes "$LSVCGSSD -v" || return 3
944         fi
945         # starting on clients
946
947         local clients=${CLIENTS:-$HOSTNAME}
948         if $GSS_PIPEFS; then
949                 echo "Starting $LGSSD on clients $clients "
950                 do_nodes $clients  "$LGSSD -v" || return 4
951         fi
952
953         # wait daemons entering "stable" status
954         sleep 5
955
956         #
957         # check daemons are running
958         #
959         nodes=$(comma_list $(mdts_nodes) $(osts_nodes))
960         check_gss_daemon_nodes $nodes lsvcgssd || return 5
961         if $GSS_PIPEFS; then
962                 nodes=$(comma_list $(mdts_nodes))
963                 check_gss_daemon_nodes $nodes lgssd || return 6
964         fi
965         if $GSS_PIPEFS; then
966                 check_gss_daemon_nodes $clients lgssd || return 7
967         fi
968 }
969
970 stop_gss_daemons() {
971         local nodes=$(comma_list $(mdts_nodes))
972
973         send_sigint $nodes lsvcgssd lgssd
974
975         nodes=$(comma_list $(osts_nodes))
976         send_sigint $nodes lsvcgssd
977
978         nodes=${CLIENTS:-$HOSTNAME}
979         send_sigint $nodes lgssd
980 }
981
982 add_sk_mntflag() {
983         # Add mount flags for shared key
984         local mt_opts=$@
985         if grep -q skpath <<< "$mt_opts" ; then
986                 mt_opts=$(echo $mt_opts |
987                         sed -e "s#skpath=[^ ,]*#skpath=$SK_PATH#")
988         else
989                 if [ -z "$mt_opts" ]; then
990                         mt_opts="-o skpath=$SK_PATH"
991                 else
992                         mt_opts="$mt_opts,skpath=$SK_PATH"
993                 fi
994         fi
995         echo -n $mt_opts
996 }
997
998 from_build_tree() {
999         local from_tree
1000
1001         case $LUSTRE in
1002         /usr/lib/lustre/* | /usr/lib64/lustre/* | /usr/lib/lustre | \
1003         /usr/lib64/lustre )
1004                 from_tree=false
1005                 ;;
1006         *)
1007                 from_tree=true
1008                 ;;
1009         esac
1010
1011         [ $from_tree = true ]
1012 }
1013
1014 init_gss() {
1015         if $SHARED_KEY; then
1016                 GSS=true
1017                 GSS_SK=true
1018         fi
1019
1020         if ! $GSS; then
1021                 return
1022         fi
1023
1024         if ! module_loaded ptlrpc_gss; then
1025                 load_module ptlrpc/gss/ptlrpc_gss
1026                 module_loaded ptlrpc_gss ||
1027                         error_exit "init_gss: GSS=$GSS, but gss/krb5 missing"
1028         fi
1029
1030         if $GSS_KRB5 || $GSS_SK; then
1031                 start_gss_daemons || error_exit "start gss daemon failed! rc=$?"
1032         fi
1033
1034         if $GSS_SK && $SK_NO_KEY; then
1035                 local numclients=${1:-$CLIENTCOUNT}
1036                 local clients=${CLIENTS:-$HOSTNAME}
1037
1038                 # security ctx config for keyring
1039                 SK_NO_KEY=false
1040                 local lgssc_conf_file="/etc/request-key.d/lgssc.conf"
1041
1042                 if from_build_tree; then
1043                         mkdir -p $SK_OM_PATH
1044                         if grep -q request-key /proc/mounts > /dev/null; then
1045                                 echo "SSK: Request key already mounted."
1046                         else
1047                                 mount -o bind $SK_OM_PATH /etc/request-key.d/
1048                         fi
1049                         local lgssc_conf_line='create lgssc * * '
1050                         lgssc_conf_line+=$(which lgss_keyring)
1051                         lgssc_conf_line+=' %o %k %t %d %c %u %g %T %P %S'
1052                         echo "$lgssc_conf_line" > $lgssc_conf_file
1053                 fi
1054
1055                 [ -e $lgssc_conf_file ] ||
1056                         error_exit "Could not find key options in $lgssc_conf_file"
1057                 echo "$lgssc_conf_file content is:"
1058                 cat $lgssc_conf_file
1059
1060                 if ! local_mode; then
1061                         if from_build_tree; then
1062                                 do_nodes $(comma_list $(all_nodes)) "mkdir -p \
1063                                         $SK_OM_PATH"
1064                                 do_nodes $(comma_list $(all_nodes)) "mount \
1065                                         -o bind $SK_OM_PATH \
1066                                         /etc/request-key.d/"
1067                                 do_nodes $(comma_list $(all_nodes)) "rsync \
1068                                         -aqv $HOSTNAME:$lgssc_conf_file \
1069                                         $lgssc_conf_file >/dev/null 2>&1"
1070                         else
1071                                 do_nodes $(comma_list $(all_nodes)) \
1072                                         "echo $lgssc_conf_file: ; \
1073                                         cat $lgssc_conf_file"
1074                         fi
1075                 fi
1076
1077                 # create shared key on all nodes
1078                 mkdir -p $SK_PATH/nodemap
1079                 rm -f $SK_PATH/$FSNAME.key $SK_PATH/nodemap/c*.key \
1080                         $SK_PATH/$FSNAME-*.key
1081                 # for nodemap testing each client may need own key,
1082                 # and S2S now requires keys as well, both for "client"
1083                 # and for "server"
1084                 if $SK_S2S; then
1085                         lgss_sk -t server -f$FSNAME -n $SK_S2SNMCLI \
1086                                 -w $SK_PATH/$FSNAME-nmclient.key \
1087                                 -d /dev/urandom >/dev/null 2>&1
1088                         lgss_sk -t mgs,server -f$FSNAME -n $SK_S2SNM \
1089                                 -w $SK_PATH/$FSNAME-s2s-server.key \
1090                                 -d /dev/urandom >/dev/null 2>&1
1091                 fi
1092                 # basic key create
1093                 lgss_sk -t server -f$FSNAME -w $SK_PATH/$FSNAME.key \
1094                         -d /dev/urandom >/dev/null 2>&1
1095                 # per-nodemap keys
1096                 for i in $(seq 0 $((numclients - 1))); do
1097                         lgss_sk -t server -f$FSNAME -n c$i \
1098                                 -w $SK_PATH/nodemap/c$i.key -d /dev/urandom \
1099                                 >/dev/null 2>&1
1100                 done
1101                 # Distribute keys
1102                 if ! local_mode; then
1103                         for lnode in $(all_nodes); do
1104                                 scp -r $SK_PATH ${lnode}:$(dirname $SK_PATH)/
1105                         done
1106                 fi
1107                 # Set client keys to client type to generate prime P
1108                 if local_mode; then
1109                         do_nodes $(all_nodes) "lgss_sk -t client,server -m \
1110                                 $SK_PATH/$FSNAME.key >/dev/null 2>&1"
1111                 else
1112                         do_nodes $clients "lgss_sk -t client -m \
1113                                 $SK_PATH/$FSNAME.key >/dev/null 2>&1"
1114                         do_nodes $clients "find $SK_PATH/nodemap -name \*.key | \
1115                                 xargs -IX lgss_sk -t client -m X >/dev/null 2>&1"
1116                 fi
1117                 # This is required for servers as well, if S2S in use
1118                 if $SK_S2S; then
1119                         do_nodes $(comma_list $(mdts_nodes)) \
1120                                 "cp $SK_PATH/$FSNAME-s2s-server.key \
1121                                 $SK_PATH/$FSNAME-s2s-client.key; lgss_sk \
1122                                 -t client -m $SK_PATH/$FSNAME-s2s-client.key \
1123                                 >/dev/null 2>&1"
1124                         do_nodes $(comma_list $(osts_nodes)) \
1125                                 "cp $SK_PATH/$FSNAME-s2s-server.key \
1126                                 $SK_PATH/$FSNAME-s2s-client.key; lgss_sk \
1127                                 -t client -m $SK_PATH/$FSNAME-s2s-client.key \
1128                                 >/dev/null 2>&1"
1129                         do_nodes $clients "lgss_sk -t client \
1130                                 -m $SK_PATH/$FSNAME-nmclient.key \
1131                                  >/dev/null 2>&1"
1132                 fi
1133         fi
1134         if $GSS_SK; then
1135                 # mount options for servers and clients
1136                 MGS_MOUNT_OPTS=$(add_sk_mntflag $MGS_MOUNT_OPTS)
1137                 MDS_MOUNT_OPTS=$(add_sk_mntflag $MDS_MOUNT_OPTS)
1138                 OST_MOUNT_OPTS=$(add_sk_mntflag $OST_MOUNT_OPTS)
1139                 MOUNT_OPTS=$(add_sk_mntflag $MOUNT_OPTS)
1140                 SEC=$SK_FLAVOR
1141                 if [ -z "$LGSS_KEYRING_DEBUG" ]; then
1142                         LGSS_KEYRING_DEBUG=4
1143                 fi
1144         fi
1145
1146         if [ -n "$LGSS_KEYRING_DEBUG" ] && \
1147                ( local_mode || from_build_tree ); then
1148                 lctl set_param -n \
1149                      sptlrpc.gss.lgss_keyring.debug_level=$LGSS_KEYRING_DEBUG
1150         elif [ -n "$LGSS_KEYRING_DEBUG" ]; then
1151                 do_nodes $(comma_list $(all_nodes)) "modprobe ptlrpc_gss && \
1152                 lctl set_param -n \
1153                    sptlrpc.gss.lgss_keyring.debug_level=$LGSS_KEYRING_DEBUG"
1154         fi
1155 }
1156
1157 cleanup_gss() {
1158         if $GSS; then
1159                 stop_gss_daemons
1160                 # maybe cleanup credential cache?
1161         fi
1162 }
1163
1164 cleanup_sk() {
1165         if $GSS_SK; then
1166                 if $SK_S2S; then
1167                         do_node $(mgs_node) "$LCTL nodemap_del $SK_S2SNM"
1168                         do_node $(mgs_node) "$LCTL nodemap_del $SK_S2SNMCLI"
1169                         $RPC_MODE || echo "Sleeping for 10 sec for Nodemap.."
1170                         sleep 10
1171                 fi
1172                 stop_gss_daemons
1173                 $RPC_MODE || echo "Cleaning up Shared Key.."
1174                 do_nodes $(comma_list $(all_nodes)) "rm -f \
1175                         $SK_PATH/$FSNAME*.key $SK_PATH/nodemap/$FSNAME*.key"
1176                 do_nodes $(comma_list $(all_nodes)) "keyctl show | \
1177                   awk '/lustre/ { print \\\$1 }' | xargs -IX keyctl unlink X"
1178                 if from_build_tree; then
1179                         # Remove the mount and clean up the files we added to
1180                         # SK_PATH
1181                         do_nodes $(comma_list $(all_nodes)) "while grep -q \
1182                                 request-key.d /proc/mounts; do umount \
1183                                 /etc/request-key.d/; done"
1184                         do_nodes $(comma_list $(all_nodes)) "rm -f \
1185                                 $SK_OM_PATH/lgssc.conf"
1186                         do_nodes $(comma_list $(all_nodes)) "rmdir $SK_OM_PATH"
1187                 fi
1188                 SK_NO_KEY=true
1189         fi
1190 }
1191
1192 facet_svc() {
1193         local facet=$1
1194         local var=${facet}_svc
1195
1196         echo -n ${!var}
1197 }
1198
1199 facet_type() {
1200         local facet=$1
1201
1202         echo -n $facet | sed -e 's/^fs[0-9]\+//' -e 's/[0-9_]\+//' |
1203                 tr '[:lower:]' '[:upper:]'
1204 }
1205
1206 facet_number() {
1207         local facet=$1
1208
1209         if [ $facet == mgs ] || [ $facet == client ]; then
1210                 return 1
1211         fi
1212
1213         echo -n $facet | sed -e 's/^fs[0-9]\+//' | sed -e 's/^[a-z]\+//'
1214 }
1215
1216 facet_fstype() {
1217         local facet=$1
1218         local var
1219
1220         var=${facet}_FSTYPE
1221         if [ -n "${!var}" ]; then
1222                 echo -n ${!var}
1223                 return
1224         fi
1225
1226         var=$(facet_type $facet)FSTYPE
1227         if [ -n "${!var}" ]; then
1228                 echo -n ${!var}
1229                 return
1230         fi
1231
1232         if [ -n "$FSTYPE" ]; then
1233                 echo -n $FSTYPE
1234                 return
1235         fi
1236
1237         if [[ $facet == mgs ]] && combined_mgs_mds; then
1238                 facet_fstype mds1
1239                 return
1240         fi
1241
1242         return 1
1243 }
1244
1245 node_fstypes() {
1246         local node=$1
1247         local fstypes
1248         local fstype
1249         local facets=$(get_facets)
1250         local facet
1251
1252         for facet in ${facets//,/ }; do
1253                 if [ $node == $(facet_host $facet) ] ||
1254                    [ $node == "$(facet_failover_host $facet)" ]; then
1255                         fstype=$(facet_fstype $facet)
1256                         if [[ $fstypes != *$fstype* ]]; then
1257                                 fstypes+="${fstypes:+,}$fstype"
1258                         fi
1259                 fi
1260         done
1261         echo -n $fstypes
1262 }
1263
1264 facet_index() {
1265         local facet=$1
1266         local num=$(facet_number $facet)
1267         local index
1268
1269         if [[ $(facet_type $facet) = OST ]]; then
1270                 index=OSTINDEX${num}
1271                 if [[ -n "${!index}" ]]; then
1272                         echo -n ${!index}
1273                         return
1274                 fi
1275
1276                 index=${OST_INDICES[num - 1]}
1277         fi
1278
1279         [[ -n "$index" ]] || index=$((num - 1))
1280         echo -n $index
1281 }
1282
1283 devicelabel() {
1284         local facet=$1
1285         local dev=$2
1286         local label
1287         local fstype=$(facet_fstype $facet)
1288
1289         case $fstype in
1290         ldiskfs)
1291                 label=$(do_facet ${facet} "$E2LABEL ${dev} 2>/dev/null");;
1292         zfs)
1293                 label=$(do_facet ${facet} "$ZFS get -H -o value lustre:svname \
1294                                            ${dev} 2>/dev/null");;
1295         *)
1296                 error "unknown fstype!";;
1297         esac
1298
1299         echo -n $label
1300 }
1301
1302 mdsdevlabel() {
1303         local num=$1
1304         local device=$(mdsdevname $num)
1305         local label=$(devicelabel mds$num ${device} | grep -v "CMD: ")
1306         echo -n $label
1307 }
1308
1309 ostdevlabel() {
1310         local num=$1
1311         local device=$(ostdevname $num)
1312         local label=$(devicelabel ost$num ${device} | grep -v "CMD: ")
1313         echo -n $label
1314 }
1315
1316 #
1317 # Get the device of a facet.
1318 #
1319 facet_device() {
1320         local facet=$1
1321         local device
1322
1323         case $facet in
1324                 mgs) device=$(mgsdevname) ;;
1325                 mds*) device=$(mdsdevname $(facet_number $facet)) ;;
1326                 ost*) device=$(ostdevname $(facet_number $facet)) ;;
1327                 fs2mds) device=$(mdsdevname 1_2) ;;
1328                 fs2ost) device=$(ostdevname 1_2) ;;
1329                 fs3ost) device=$(ostdevname 2_2) ;;
1330                 *) ;;
1331         esac
1332
1333         echo -n $device
1334 }
1335
1336 #
1337 # Get the virtual device of a facet.
1338 #
1339 facet_vdevice() {
1340         local facet=$1
1341         local device
1342
1343         case $facet in
1344                 mgs) device=$(mgsvdevname) ;;
1345                 mds*) device=$(mdsvdevname $(facet_number $facet)) ;;
1346                 ost*) device=$(ostvdevname $(facet_number $facet)) ;;
1347                 fs2mds) device=$(mdsvdevname 1_2) ;;
1348                 fs2ost) device=$(ostvdevname 1_2) ;;
1349                 fs3ost) device=$(ostvdevname 2_2) ;;
1350                 *) ;;
1351         esac
1352
1353         echo -n $device
1354 }
1355
1356 running_in_vm() {
1357         local virt=$(virt-what 2> /dev/null)
1358
1359         [ $? -eq 0 ] && [ -n "$virt" ] && { echo $virt; return; }
1360
1361         virt=$(dmidecode -s system-product-name | awk '{print $1}')
1362
1363         case $virt in
1364                 VMware|KVM|VirtualBox|Parallels|Bochs)
1365                         echo $virt | tr '[A-Z]' '[a-z]' ;;
1366                 *) ;;
1367         esac
1368 }
1369
1370 #
1371 # Re-read the partition table on failover partner host.
1372 # After a ZFS storage pool is created on a shared device, the partition table
1373 # on the device may change. However, the operating system on the failover
1374 # host may not notice the change automatically. Without the up-to-date partition
1375 # block devices, 'zpool import ..' cannot find the labels, whose positions are
1376 # relative to partition rather than disk beginnings.
1377 #
1378 # This function performs partprobe on the failover host to make it re-read the
1379 # partition table.
1380 #
1381 refresh_partition_table() {
1382         local facet=$1
1383         local device=$2
1384         local host
1385
1386         host=$(facet_passive_host $facet)
1387         if [[ -n "$host" ]]; then
1388                 do_node $host "$PARTPROBE $device"
1389         fi
1390 }
1391
1392 #
1393 # Get ZFS storage pool name.
1394 #
1395 zpool_name() {
1396         local facet=$1
1397         local device
1398         local poolname
1399
1400         device=$(facet_device $facet)
1401         # poolname is string before "/"
1402         poolname="${device%%/*}"
1403
1404         echo -n $poolname
1405 }
1406
1407 #
1408 #
1409 # Get ZFS local fsname.
1410 #
1411 zfs_local_fsname() {
1412         local facet=$1
1413         local lfsname=$(basename $(facet_device $facet))
1414
1415         echo -n $lfsname
1416 }
1417
1418 #
1419 # Create ZFS storage pool.
1420 #
1421 create_zpool() {
1422         local facet=$1
1423         local poolname=$2
1424         local vdev=$3
1425         shift 3
1426         local opts=${@:-"-o cachefile=none"}
1427
1428         do_facet $facet "lsmod | grep zfs >&/dev/null || modprobe zfs;
1429                 $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1430                 $ZPOOL create -f $opts $poolname $vdev"
1431 }
1432
1433 #
1434 # Create ZFS file system.
1435 #
1436 create_zfs() {
1437         local facet=$1
1438         local dataset=$2
1439         shift 2
1440         local opts=${@:-"-o mountpoint=legacy"}
1441
1442         do_facet $facet "$ZFS list -H $dataset >/dev/null 2>&1 ||
1443                 $ZFS create $opts $dataset"
1444 }
1445
1446 #
1447 # Export ZFS storage pool.
1448 # Before exporting the pool, all datasets within the pool should be unmounted.
1449 #
1450 export_zpool() {
1451         local facet=$1
1452         shift
1453         local opts="$@"
1454         local poolname
1455
1456         poolname=$(zpool_name $facet)
1457
1458         if [[ -n "$poolname" ]]; then
1459                 do_facet $facet "! $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1460                         grep -q ^$poolname/ /proc/mounts ||
1461                         $ZPOOL export $opts $poolname"
1462         fi
1463 }
1464
1465 #
1466 # Destroy ZFS storage pool.
1467 # Destroy the given pool and free up any devices for other use. This command
1468 # tries to unmount any active datasets before destroying the pool.
1469 # -f    Force any active datasets contained within the pool to be unmounted.
1470 #
1471 destroy_zpool() {
1472         local facet=$1
1473         local poolname=${2:-$(zpool_name $facet)}
1474
1475         if [[ -n "$poolname" ]]; then
1476                 do_facet $facet "! $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1477                         $ZPOOL destroy -f $poolname"
1478         fi
1479 }
1480
1481 #
1482 # Import ZFS storage pool.
1483 # Force importing, even if the pool appears to be potentially active.
1484 #
1485 import_zpool() {
1486         local facet=$1
1487         shift
1488         local opts=${@:-"-o cachefile=none -o failmode=panic"}
1489         local poolname
1490
1491         poolname=$(zpool_name $facet)
1492
1493         if [[ -n "$poolname" ]]; then
1494                 opts+=" -d $(dirname $(facet_vdevice $facet))"
1495                 do_facet $facet "lsmod | grep zfs >&/dev/null || modprobe zfs;
1496                         $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1497                         $ZPOOL import -f $opts $poolname"
1498         fi
1499 }
1500
1501 #
1502 # Reimport ZFS storage pool with new name
1503 #
1504 reimport_zpool() {
1505         local facet=$1
1506         local newpool=$2
1507         local opts="-o cachefile=none"
1508         local poolname=$(zpool_name $facet)
1509
1510         opts+=" -d $(dirname $(facet_vdevice $facet))"
1511         do_facet $facet "$ZPOOL export $poolname;
1512                          $ZPOOL import $opts $poolname $newpool"
1513 }
1514
1515 #
1516 # Set the "cachefile=none" property on ZFS storage pool so that the pool
1517 # is not automatically imported on system startup.
1518 #
1519 # In a failover environment, this will provide resource level fencing which
1520 # will ensure that the same ZFS storage pool will not be imported concurrently
1521 # on different nodes.
1522 #
1523 disable_zpool_cache() {
1524         local facet=$1
1525         local poolname
1526
1527         poolname=$(zpool_name $facet)
1528
1529         if [[ -n "$poolname" ]]; then
1530                 do_facet $facet "$ZPOOL set cachefile=none $poolname"
1531         fi
1532 }
1533
1534 #
1535 # This and set_osd_param() shall be used to access OSD parameters
1536 # once existed under "obdfilter":
1537 #
1538 #   mntdev
1539 #   stats
1540 #   read_cache_enable
1541 #   writethrough_cache_enable
1542 #
1543 get_osd_param() {
1544         local nodes=$1
1545         local device=${2:-$FSNAME-OST*}
1546         local name=$3
1547
1548         do_nodes $nodes "$LCTL get_param -n obdfilter.$device.$name \
1549                 osd-*.$device.$name 2>&1" | grep -v 'error:'
1550 }
1551
1552 set_osd_param() {
1553         local nodes=$1
1554         local device=${2:-$FSNAME-OST*}
1555         local name=$3
1556         local value=$4
1557
1558         do_nodes $nodes "$LCTL set_param -n obdfilter.$device.$name=$value \
1559                 osd-*.$device.$name=$value 2>&1" | grep -v 'error:'
1560 }
1561
1562 set_debug_size () {
1563     local dz=${1:-$DEBUG_SIZE}
1564
1565     if [ -f /sys/devices/system/cpu/possible ]; then
1566         local cpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/possible)+1))
1567     else
1568         local cpus=$(getconf _NPROCESSORS_CONF 2>/dev/null)
1569     fi
1570
1571     # bug 19944, adjust size to be -gt num_possible_cpus()
1572     # promise 2MB for every cpu at least
1573     if [ -n "$cpus" ] && [ $((cpus * 2)) -gt $dz ]; then
1574         dz=$((cpus * 2))
1575     fi
1576     lctl set_param debug_mb=$dz
1577 }
1578
1579 set_default_debug () {
1580         local debug=${1:-"$PTLDEBUG"}
1581         local subsys=${2:-"$SUBSYSTEM"}
1582         local debug_size=${3:-$DEBUG_SIZE}
1583
1584         [ -n "$debug" ] && lctl set_param debug="$debug" >/dev/null
1585         [ -n "$subsys" ] && lctl set_param subsystem_debug="${subsys# }" >/dev/null
1586
1587         [ -n "$debug_size" ] && set_debug_size $debug_size > /dev/null
1588 }
1589
1590 set_default_debug_nodes () {
1591         local nodes="$1"
1592         local debug="${2:-"$PTLDEBUG"}"
1593         local subsys="${3:-"$SUBSYSTEM"}"
1594         local debug_size="${4:-$DEBUG_SIZE}"
1595
1596         if [[ ,$nodes, = *,$HOSTNAME,* ]]; then
1597                 nodes=$(exclude_items_from_list "$nodes" "$HOSTNAME")
1598                 set_default_debug
1599         fi
1600
1601         [[ -z "$nodes" ]] ||
1602                 do_rpc_nodes "$nodes" set_default_debug \
1603                         \\\"$debug\\\" \\\"$subsys\\\" $debug_size || true
1604 }
1605
1606 set_default_debug_facet () {
1607         local facet=$1
1608         local debug="${2:-"$PTLDEBUG"}"
1609         local subsys="${3:-"$SUBSYSTEM"}"
1610         local debug_size="${4:-$DEBUG_SIZE}"
1611         local node=$(facet_active_host $facet)
1612
1613         [ -n "$node" ] || error "No host defined for facet $facet"
1614
1615         set_default_debug_nodes $node "$debug" "$subsys" $debug_size
1616 }
1617
1618 set_hostid () {
1619     local hostid=${1:-$(hostid)}
1620
1621     if [ ! -s /etc/hostid ]; then
1622         printf $(echo -n $hostid |
1623             sed 's/\(..\)\(..\)\(..\)\(..\)/\\x\4\\x\3\\x\2\\x\1/') >/etc/hostid
1624     fi
1625 }
1626
1627 # Facet functions
1628 mount_facets () {
1629         local facets=${1:-$(get_facets)}
1630         local facet
1631
1632         for facet in ${facets//,/ }; do
1633                 mount_facet $facet
1634                 local RC=$?
1635                 [ $RC -eq 0 ] && continue
1636
1637                 if [ "$TESTSUITE.$TESTNAME" = "replay-dual.test_0a" ]; then
1638                         skip_noexit "Restart of $facet failed!." &&
1639                                 touch $LU482_FAILED
1640                 else
1641                         error "Restart of $facet failed!"
1642                 fi
1643                 return $RC
1644         done
1645 }
1646
1647 #
1648 # Add argument "arg" (e.g., "loop") to the comma-separated list
1649 # of arguments for option "opt" (e.g., "-o") on command
1650 # line "opts" (e.g., "-o flock").
1651 #
1652 csa_add() {
1653         local opts=$1
1654         local opt=$2
1655         local arg=$3
1656         local opt_pattern="\([[:space:]]\+\|^\)$opt"
1657
1658         if echo "$opts" | grep -q $opt_pattern; then
1659                 opts=$(echo "$opts" | sed -e \
1660                         "s/$opt_pattern[[:space:]]*[^[:space:]]\+/&,$arg/")
1661         else
1662                 opts+="${opts:+ }$opt $arg"
1663         fi
1664         echo -n "$opts"
1665 }
1666
1667 #
1668 # Associate loop device with a given regular file.
1669 # Return the loop device.
1670 #
1671 setup_loop_device() {
1672         local facet=$1
1673         local file=$2
1674
1675         do_facet $facet "loop_dev=\\\$($LOSETUP -j $file | cut -d : -f 1);
1676                          if [[ -z \\\$loop_dev ]]; then
1677                                 loop_dev=\\\$($LOSETUP -f);
1678                                 $LOSETUP \\\$loop_dev $file || loop_dev=;
1679                          fi;
1680                          echo -n \\\$loop_dev"
1681 }
1682
1683 #
1684 # Detach a loop device.
1685 #
1686 cleanup_loop_device() {
1687         local facet=$1
1688         local loop_dev=$2
1689
1690         do_facet $facet "! $LOSETUP $loop_dev >/dev/null 2>&1 ||
1691                          $LOSETUP -d $loop_dev"
1692 }
1693
1694 #
1695 # Check if a given device is a block device.
1696 #
1697 is_blkdev() {
1698         local facet=$1
1699         local dev=$2
1700         local size=${3:-""}
1701
1702         [[ -n "$dev" ]] || return 1
1703         do_facet $facet "test -b $dev" || return 1
1704         if [[ -n "$size" ]]; then
1705                 local in=$(do_facet $facet "dd if=$dev of=/dev/null bs=1k \
1706                                             count=1 skip=$size 2>&1" |
1707                                             awk '($3 == "in") { print $1 }')
1708                 [[ "$in" = "1+0" ]] || return 1
1709         fi
1710 }
1711
1712 #
1713 # Check if a given device is a device-mapper device.
1714 #
1715 is_dm_dev() {
1716         local facet=$1
1717         local dev=$2
1718
1719         [[ -n "$dev" ]] || return 1
1720         do_facet $facet "$DMSETUP status $dev >/dev/null 2>&1"
1721 }
1722
1723 #
1724 # Check if a given device is a device-mapper flakey device.
1725 #
1726 is_dm_flakey_dev() {
1727         local facet=$1
1728         local dev=$2
1729         local type
1730
1731         [[ -n "$dev" ]] || return 1
1732
1733         type=$(do_facet $facet "$DMSETUP status $dev 2>&1" |
1734                awk '{print $3}')
1735         [[ $type = flakey ]] && return 0 || return 1
1736 }
1737
1738 #
1739 # Check if device-mapper flakey device is supported by the kernel
1740 # of $facet node or not.
1741 #
1742 dm_flakey_supported() {
1743         local facet=$1
1744
1745         $FLAKEY || return 1
1746         do_facet $facet "modprobe dm-flakey;
1747                          $DMSETUP targets | grep -q flakey" &> /dev/null
1748 }
1749
1750 #
1751 # Get the device-mapper flakey device name of a given facet.
1752 #
1753 dm_facet_devname() {
1754         local facet=$1
1755         [[ $facet = mgs ]] && combined_mgs_mds && facet=mds1
1756
1757         echo -n ${facet}_flakey
1758 }
1759
1760 #
1761 # Get the device-mapper flakey device of a given facet.
1762 # A device created by dmsetup will appear as /dev/mapper/<device-name>.
1763 #
1764 dm_facet_devpath() {
1765         local facet=$1
1766
1767         echo -n $DM_DEV_PATH/$(dm_facet_devname $facet)
1768 }
1769
1770 #
1771 # Set a device-mapper device with a new table.
1772 #
1773 # The table has the following format:
1774 # <logical_start_sector> <num_sectors> <target_type> <target_args>
1775 #
1776 # flakey <target_args> includes:
1777 # <destination_device> <offset> <up_interval> <down_interval> \
1778 # [<num_features> [<feature_arguments>]]
1779 #
1780 # linear <target_args> includes:
1781 # <destination_device> <start_sector>
1782 #
1783 dm_set_dev_table() {
1784         local facet=$1
1785         local dm_dev=$2
1786         local target_type=$3
1787         local num_sectors
1788         local real_dev
1789         local tmp
1790         local table
1791
1792         read tmp num_sectors tmp real_dev tmp \
1793                 <<< $(do_facet $facet "$DMSETUP table $dm_dev")
1794
1795         case $target_type in
1796         flakey)
1797                 table="0 $num_sectors flakey $real_dev 0 0 1800 1 drop_writes"
1798                 ;;
1799         linear)
1800                 table="0 $num_sectors linear $real_dev 0"
1801                 ;;
1802         *) error "invalid target type $target_type" ;;
1803         esac
1804
1805         do_facet $facet "$DMSETUP suspend --nolockfs --noflush $dm_dev" ||
1806                 error "failed to suspend $dm_dev"
1807         do_facet $facet "$DMSETUP load $dm_dev --table \\\"$table\\\"" ||
1808                 error "failed to load $target_type table into $dm_dev"
1809         do_facet $facet "$DMSETUP resume $dm_dev" ||
1810                 error "failed to resume $dm_dev"
1811 }
1812
1813 #
1814 # Set a device-mapper flakey device as "read-only" by using the "drop_writes"
1815 # feature parameter.
1816 #
1817 # drop_writes:
1818 #       All write I/O is silently ignored.
1819 #       Read I/O is handled correctly.
1820 #
1821 dm_set_dev_readonly() {
1822         local facet=$1
1823         local dm_dev=${2:-$(dm_facet_devpath $facet)}
1824
1825         dm_set_dev_table $facet $dm_dev flakey
1826 }
1827
1828 #
1829 # Set a device-mapper device to traditional linear mapping mode.
1830 #
1831 dm_clear_dev_readonly() {
1832         local facet=$1
1833         local dm_dev=${2:-$(dm_facet_devpath $facet)}
1834
1835         dm_set_dev_table $facet $dm_dev linear
1836 }
1837
1838 #
1839 # Set the device of a given facet as "read-only".
1840 #
1841 set_dev_readonly() {
1842         local facet=$1
1843         local svc=${facet}_svc
1844
1845         if [[ $(facet_fstype $facet) = zfs ]] ||
1846            ! dm_flakey_supported $facet; then
1847                 do_facet $facet $LCTL --device ${!svc} readonly
1848         else
1849                 dm_set_dev_readonly $facet
1850         fi
1851 }
1852
1853 #
1854 # Get size in 512-byte sectors (BLKGETSIZE64 / 512) of a given device.
1855 #
1856 get_num_sectors() {
1857         local facet=$1
1858         local dev=$2
1859         local num_sectors
1860
1861         num_sectors=$(do_facet $facet "blockdev --getsz $dev 2>/dev/null")
1862         [[ ${PIPESTATUS[0]} = 0 && -n "$num_sectors" ]] || num_sectors=0
1863         echo -n $num_sectors
1864 }
1865
1866 #
1867 # Create a device-mapper device with a given block device or regular file (will
1868 # be associated with loop device).
1869 # Return the full path of the device-mapper device.
1870 #
1871 dm_create_dev() {
1872         local facet=$1
1873         local real_dev=$2                                  # destination device
1874         local dm_dev_name=${3:-$(dm_facet_devname $facet)} # device name
1875         local dm_dev=$DM_DEV_PATH/$dm_dev_name            # device-mapper device
1876
1877         # check if the device-mapper device to be created already exists
1878         if is_dm_dev $facet $dm_dev; then
1879                 # if the existing device was set to "read-only", then clear it
1880                 ! is_dm_flakey_dev $facet $dm_dev ||
1881                         dm_clear_dev_readonly $facet $dm_dev
1882
1883                 echo -n $dm_dev
1884                 return 0
1885         fi
1886
1887         # check if the destination device is a block device, and if not,
1888         # associate it with a loop device
1889         is_blkdev $facet $real_dev ||
1890                 real_dev=$(setup_loop_device $facet $real_dev)
1891         [[ -n "$real_dev" ]] || { echo -n $real_dev; return 2; }
1892
1893         # now create the device-mapper device
1894         local num_sectors=$(get_num_sectors $facet $real_dev)
1895         local table="0 $num_sectors linear $real_dev 0"
1896         local rc=0
1897
1898         do_facet $facet "$DMSETUP create $dm_dev_name --table \\\"$table\\\"" ||
1899                 { rc=${PIPESTATUS[0]}; dm_dev=; }
1900         do_facet $facet "$DMSETUP mknodes >/dev/null 2>&1"
1901
1902         echo -n $dm_dev
1903         return $rc
1904 }
1905
1906 #
1907 # Map the facet name to its device variable name.
1908 #
1909 facet_device_alias() {
1910         local facet=$1
1911         local dev_alias=$facet
1912
1913         case $facet in
1914                 fs2mds) dev_alias=mds1_2 ;;
1915                 fs2ost) dev_alias=ost1_2 ;;
1916                 fs3ost) dev_alias=ost2_2 ;;
1917                 *) ;;
1918         esac
1919
1920         echo -n $dev_alias
1921 }
1922
1923 #
1924 # Save the original value of the facet device and export the new value.
1925 #
1926 export_dm_dev() {
1927         local facet=$1
1928         local dm_dev=$2
1929
1930         local active_facet=$(facet_active $facet)
1931         local dev_alias=$(facet_device_alias $active_facet)
1932         local dev_name=${dev_alias}_dev
1933         local dev=${!dev_name}
1934
1935         if [[ $active_facet = $facet ]]; then
1936                 local failover_dev=${dev_alias}failover_dev
1937                 if [[ ${!failover_dev} = $dev ]]; then
1938                         eval export ${failover_dev}_saved=$dev
1939                         eval export ${failover_dev}=$dm_dev
1940                 fi
1941         else
1942                 dev_alias=$(facet_device_alias $facet)
1943                 local facet_dev=${dev_alias}_dev
1944                 if [[ ${!facet_dev} = $dev ]]; then
1945                         eval export ${facet_dev}_saved=$dev
1946                         eval export ${facet_dev}=$dm_dev
1947                 fi
1948         fi
1949
1950         eval export ${dev_name}_saved=$dev
1951         eval export ${dev_name}=$dm_dev
1952 }
1953
1954 #
1955 # Restore the saved value of the facet device.
1956 #
1957 unexport_dm_dev() {
1958         local facet=$1
1959
1960         [[ $facet = mgs ]] && combined_mgs_mds && facet=mds1
1961         local dev_alias=$(facet_device_alias $facet)
1962
1963         local saved_dev=${dev_alias}_dev_saved
1964         [[ -z ${!saved_dev} ]] ||
1965                 eval export ${dev_alias}_dev=${!saved_dev}
1966
1967         saved_dev=${dev_alias}failover_dev_saved
1968         [[ -z ${!saved_dev} ]] ||
1969                 eval export ${dev_alias}failover_dev=${!saved_dev}
1970 }
1971
1972 #
1973 # Remove a device-mapper device.
1974 # If the destination device is a loop device, then also detach it.
1975 #
1976 dm_cleanup_dev() {
1977         local facet=$1
1978         local dm_dev=${2:-$(dm_facet_devpath $facet)}
1979         local major
1980         local minor
1981
1982         is_dm_dev $facet $dm_dev || return 0
1983
1984         read major minor <<< $(do_facet $facet "$DMSETUP table $dm_dev" |
1985                 awk '{ print $4 }' | awk -F: '{ print $1" "$2 }')
1986
1987         do_facet $facet "$DMSETUP remove $dm_dev"
1988         do_facet $facet "$DMSETUP mknodes >/dev/null 2>&1"
1989
1990         unexport_dm_dev $facet
1991
1992         # detach a loop device
1993         [[ $major -ne 7 ]] || cleanup_loop_device $facet /dev/loop$minor
1994
1995         # unload dm-flakey module
1996         do_facet $facet "modprobe -r dm-flakey" || true
1997 }
1998
1999 mount_facet() {
2000         local facet=$1
2001         shift
2002         local active_facet=$(facet_active $facet)
2003         local dev_alias=$(facet_device_alias $active_facet)
2004         local dev=${dev_alias}_dev
2005         local opt=${facet}_opt
2006         local mntpt=$(facet_mntpt $facet)
2007         local opts="${!opt} $@"
2008         local fstype=$(facet_fstype $facet)
2009         local devicelabel
2010         local dm_dev=${!dev}
2011
2012         module_loaded lustre || load_modules
2013
2014         case $fstype in
2015         ldiskfs)
2016                 if dm_flakey_supported $facet; then
2017                         dm_dev=$(dm_create_dev $facet ${!dev})
2018                         [[ -n "$dm_dev" ]] || dm_dev=${!dev}
2019                 fi
2020
2021                 is_blkdev $facet $dm_dev || opts=$(csa_add "$opts" -o loop)
2022
2023                 devicelabel=$(do_facet ${facet} "$E2LABEL $dm_dev");;
2024         zfs)
2025                 # import ZFS storage pool
2026                 import_zpool $facet || return ${PIPESTATUS[0]}
2027
2028                 devicelabel=$(do_facet ${facet} "$ZFS get -H -o value \
2029                                                 lustre:svname $dm_dev");;
2030         *)
2031                 error "unknown fstype!";;
2032         esac
2033
2034         echo "Starting ${facet}: $opts $dm_dev $mntpt"
2035         # for testing LU-482 error handling in mount_facets() and test_0a()
2036         if [ -f $TMP/test-lu482-trigger ]; then
2037                 RC=2
2038         else
2039                 do_facet ${facet} \
2040                         "mkdir -p $mntpt; $MOUNT_CMD $opts $dm_dev $mntpt"
2041                 RC=${PIPESTATUS[0]}
2042         fi
2043
2044         if [ $RC -ne 0 ]; then
2045                 echo "Start of $dm_dev on ${facet} failed ${RC}"
2046                 return $RC
2047         fi
2048
2049         health=$(do_facet ${facet} "$LCTL get_param -n health_check")
2050         if [[ "$health" != "healthy" ]]; then
2051                 error "$facet is in a unhealthy state"
2052         fi
2053
2054         set_default_debug_facet $facet
2055
2056         if [[ $opts =~ .*nosvc.* ]]; then
2057                 echo "Start $dm_dev without service"
2058         else
2059
2060                 case $fstype in
2061                 ldiskfs)
2062                         wait_update_facet ${facet} "$E2LABEL $dm_dev \
2063                                 2>/dev/null | grep -E ':[a-zA-Z]{3}[0-9]{4}'" \
2064                                 "" || error "$dm_dev failed to initialize!";;
2065                 zfs)
2066                         wait_update_facet ${facet} "$ZFS get -H -o value \
2067                                 lustre:svname $dm_dev 2>/dev/null | \
2068                                 grep -E ':[a-zA-Z]{3}[0-9]{4}'" "" ||
2069                                 error "$dm_dev failed to initialize!";;
2070
2071                 *)
2072                         error "unknown fstype!";;
2073                 esac
2074         fi
2075
2076         # commit the device label change to disk
2077         if [[ $devicelabel =~ (:[a-zA-Z]{3}[0-9]{4}) ]]; then
2078                 echo "Commit the device label on ${!dev}"
2079                 do_facet $facet "sync; sleep 1; sync"
2080         fi
2081
2082
2083         label=$(devicelabel ${facet} $dm_dev)
2084         [ -z "$label" ] && echo no label for $dm_dev && exit 1
2085         eval export ${facet}_svc=${label}
2086         echo Started ${label}
2087
2088         export_dm_dev $facet $dm_dev
2089
2090         return $RC
2091 }
2092
2093 # start facet device options
2094 start() {
2095         local facet=$1
2096         shift
2097         local device=$1
2098         shift
2099         local dev_alias=$(facet_device_alias $facet)
2100
2101         eval export ${dev_alias}_dev=${device}
2102         eval export ${facet}_opt=\"$@\"
2103
2104         local varname=${dev_alias}failover_dev
2105         if [ -n "${!varname}" ] ; then
2106                 eval export ${dev_alias}failover_dev=${!varname}
2107         else
2108                 eval export ${dev_alias}failover_dev=$device
2109         fi
2110
2111         local mntpt=$(facet_mntpt $facet)
2112         do_facet ${facet} mkdir -p $mntpt
2113         eval export ${facet}_MOUNT=$mntpt
2114         mount_facet ${facet}
2115         RC=$?
2116
2117         return $RC
2118 }
2119
2120 stop() {
2121         local running
2122         local facet=$1
2123         shift
2124         local HOST=$(facet_active_host $facet)
2125         [[ -z $HOST ]] && echo stop: no host for $facet && return 0
2126
2127         local mntpt=$(facet_mntpt $facet)
2128         running=$(do_facet ${facet} "grep -c $mntpt' ' /proc/mounts || true")
2129         if [ ${running} -ne 0 ]; then
2130                 echo "Stopping $mntpt (opts:$@) on $HOST"
2131                 do_facet ${facet} $UMOUNT $@ $mntpt
2132         fi
2133
2134         # umount should block, but we should wait for unrelated obd's
2135         # like the MGS or MGC to also stop.
2136         wait_exit_ST ${facet} || return ${PIPESTATUS[0]}
2137
2138         if [[ $(facet_fstype $facet) == zfs ]]; then
2139                 # export ZFS storage pool
2140                 [ "$KEEP_ZPOOL" = "true" ] || export_zpool $facet
2141         elif dm_flakey_supported $facet; then
2142                 local host=${facet}_HOST
2143                 local failover_host=${facet}failover_HOST
2144                 if [[ -n ${!failover_host} && ${!failover_host} != ${!host} ]]||
2145                         $CLEANUP_DM_DEV || [[ $facet = fs* ]]; then
2146                         dm_cleanup_dev $facet
2147                 fi
2148         fi
2149 }
2150
2151 # get mdt quota type
2152 mdt_quota_type() {
2153         local varsvc=${SINGLEMDS}_svc
2154         do_facet $SINGLEMDS $LCTL get_param -n \
2155                 osd-$(facet_fstype $SINGLEMDS).${!varsvc}.quota_slave.enabled
2156 }
2157
2158 # get ost quota type
2159 ost_quota_type() {
2160         # All OSTs should have same quota type
2161         local varsvc=ost1_svc
2162         do_facet ost1 $LCTL get_param -n \
2163                 osd-$(facet_fstype ost1).${!varsvc}.quota_slave.enabled
2164 }
2165
2166 # restore old quota type settings
2167 restore_quota() {
2168         if [ "$old_MDT_QUOTA_TYPE" ]; then
2169                 if [[ $PERM_CMD == *"set_param -P"* ]]; then
2170                         do_facet mgs $PERM_CMD \
2171                                 osd-*.$FSNAME-MDT*.quota_slave.enable = \
2172                                 $old_MDT_QUOTA_TYPE
2173                 else
2174                         do_facet mgs $PERM_CMD \
2175                                 $FSNAME.quota.mdt=$old_MDT_QUOTA_TYPE
2176                 fi
2177         fi
2178         if [ "$old_OST_QUOTA_TYPE" ]; then
2179                 if [[ $PERM_CMD == *"set_param -P"* ]]; then
2180                         do_facet mgs $PERM_CMD \
2181                                 osd-*.$FSNAME-OST*.quota_slave.enable = \
2182                                 $old_OST_QUOTA_TYPE
2183                 else
2184                         do_facet mgs $LCTL conf_param \
2185                                 $FSNAME.quota.ost=$old_OST_QUOTA_TYPE
2186                 fi
2187         fi
2188 }
2189
2190 # Handle the case when there is a space in the lfs df
2191 # "filesystem summary" line the same as when there is no space.
2192 # This will allow fixing the "lfs df" summary line in the future.
2193 lfs_df() {
2194         $LFS df $* | sed -e 's/filesystem /filesystem_/'
2195 }
2196
2197 # Get free inodes on the MDT specified by mdt index, free indoes on
2198 # the whole filesystem will be returned when index == -1.
2199 mdt_free_inodes() {
2200         local index=$1
2201         local free_inodes
2202         local mdt_uuid
2203
2204         if [ $index -eq -1 ]; then
2205                 mdt_uuid="summary"
2206         else
2207                 mdt_uuid=$(mdtuuid_from_index $index)
2208         fi
2209
2210         free_inodes=$(lfs_df -i $MOUNT | grep $mdt_uuid | awk '{print $4}')
2211         echo $free_inodes
2212 }
2213
2214 #
2215 # Get the OST device status from 'lfs df' with a given OST index.
2216 #
2217 ost_dev_status() {
2218         local ost_idx=$1
2219         local mnt_pnt=${2:-$MOUNT}
2220         local opts=$3
2221         local ost_uuid
2222
2223         ost_uuid=$(ostuuid_from_index $ost_idx $mnt_pnt)
2224         lfs_df $opts $mnt_pnt | awk '/'$ost_uuid'/ { print $7 }'
2225 }
2226
2227 setup_quota(){
2228         local mntpt=$1
2229
2230         # save old quota type & set new quota type
2231         local mdt_qtype=$(mdt_quota_type)
2232         local ost_qtype=$(ost_quota_type)
2233
2234         echo "[HOST:$HOSTNAME] [old_mdt_qtype:$mdt_qtype]" \
2235                 "[old_ost_qtype:$ost_qtype] [new_qtype:$QUOTA_TYPE]"
2236
2237         export old_MDT_QUOTA_TYPE=$mdt_qtype
2238         export old_OST_QUOTA_TYPE=$ost_qtype
2239
2240         if [[ $PERM_CMD == *"set_param -P"* ]]; then
2241                 do_facet mgs $PERM_CMD \
2242                         osd-*.$FSNAME-MDT*.quota_slave.enable=$QUOTA_TYPE
2243                 do_facet mgs $PERM_CMD \
2244                         osd-*.$FSNAME-OST*.quota_slave.enable=$QUOTA_TYPE
2245         else
2246                 do_facet mgs $PERM_CMD $FSNAME.quota.mdt=$QUOTA_TYPE ||
2247                         error "set mdt quota type failed"
2248                 do_facet mgs $PERM_CMD $FSNAME.quota.ost=$QUOTA_TYPE ||
2249                         error "set ost quota type failed"
2250         fi
2251
2252         local quota_usrs=$QUOTA_USERS
2253
2254         # get_filesystem_size
2255         local disksz=$(lfs_df $mntpt | grep "summary" | awk '{print $2}')
2256         local blk_soft=$((disksz + 1024))
2257         local blk_hard=$((blk_soft + blk_soft / 20)) # Go 5% over
2258
2259         local inodes=$(lfs_df -i $mntpt | grep "summary" | awk '{print $2}')
2260         local i_soft=$inodes
2261         local i_hard=$((i_soft + i_soft / 20))
2262
2263         echo "Total disk size: $disksz  block-softlimit: $blk_soft" \
2264                 "block-hardlimit: $blk_hard inode-softlimit: $i_soft" \
2265                 "inode-hardlimit: $i_hard"
2266
2267         local cmd
2268         for usr in $quota_usrs; do
2269                 echo "Setting up quota on $HOSTNAME:$mntpt for $usr..."
2270                 for type in u g; do
2271                         cmd="$LFS setquota -$type $usr -b $blk_soft"
2272                         cmd="$cmd -B $blk_hard -i $i_soft -I $i_hard $mntpt"
2273                         echo "+ $cmd"
2274                         eval $cmd || error "$cmd FAILED!"
2275                 done
2276                 # display the quota status
2277                 echo "Quota settings for $usr : "
2278                 $LFS quota -v -u $usr $mntpt || true
2279         done
2280 }
2281
2282 zconf_mount() {
2283         local client=$1
2284         local mnt=$2
2285         local opts=${3:-$MOUNT_OPTS}
2286         opts=${opts:+-o $opts}
2287         local flags=${4:-$MOUNT_FLAGS}
2288
2289         local device=$MGSNID:/$FSNAME$FILESET
2290         if [ -z "$mnt" -o -z "$FSNAME" ]; then
2291                 echo "Bad mount command: opt=$flags $opts dev=$device " \
2292                      "mnt=$mnt"
2293                 exit 1
2294         fi
2295
2296         if $GSS_SK; then
2297                 # update mount option with skpath
2298                 opts=$(add_sk_mntflag $opts)
2299         fi
2300
2301         echo "Starting client: $client: $flags $opts $device $mnt"
2302         do_node $client mkdir -p $mnt
2303         if [ -n "$FILESET" -a -z "$SKIP_FILESET" ];then
2304                 do_node $client $MOUNT_CMD $flags $opts $MGSNID:/$FSNAME \
2305                         $mnt || return 1
2306                 #disable FILESET if not supported
2307                 do_nodes $client lctl get_param -n \
2308                         mdc.$FSNAME-MDT0000*.import | grep -q subtree ||
2309                                 device=$MGSNID:/$FSNAME
2310                 do_node $client mkdir -p $mnt/$FILESET
2311                 do_node $client "! grep -q $mnt' ' /proc/mounts ||
2312                         umount $mnt"
2313         fi
2314         if $GSS_SK && ($SK_UNIQUE_NM || $SK_S2S); then
2315                 # Mount using nodemap key
2316                 local mountkey=$SK_PATH/$FSNAME-nmclient.key
2317                 if $SK_UNIQUE_NM; then
2318                         mountkey=$SK_PATH/nodemap/c0.key
2319                 fi
2320                 local prunedopts=$(echo $opts |
2321                                 sed -e "s#skpath=[^,^ ]*#skpath=$mountkey#g")
2322                 do_node $client $MOUNT_CMD $flags $prunedopts $device $mnt ||
2323                                 return 1
2324         else
2325                 do_node $client $MOUNT_CMD $flags $opts $device $mnt ||
2326                                 return 1
2327         fi
2328
2329         set_default_debug_nodes $client
2330
2331         return 0
2332 }
2333
2334 zconf_umount() {
2335         local client=$1
2336         local mnt=$2
2337         local force
2338         local busy
2339         local need_kill
2340         local running=$(do_node $client "grep -c $mnt' ' /proc/mounts") || true
2341
2342         [ "$3" ] && force=-f
2343         [ $running -eq 0 ] && return 0
2344
2345         echo "Stopping client $client $mnt (opts:$force)"
2346         do_node $client lsof -t $mnt || need_kill=no
2347         if [ "x$force" != "x" ] && [ "x$need_kill" != "xno" ]; then
2348                 pids=$(do_node $client lsof -t $mnt | sort -u);
2349                 if [ -n "$pids" ]; then
2350                         do_node $client kill -9 $pids || true
2351                 fi
2352         fi
2353
2354         busy=$(do_node $client "umount $force $mnt 2>&1" | grep -c "busy") ||
2355                 true
2356         if [ $busy -ne 0 ] ; then
2357                 echo "$mnt is still busy, wait one second" && sleep 1
2358                 do_node $client umount $force $mnt
2359         fi
2360 }
2361
2362 # Mount the file system on the MDS
2363 mount_mds_client() {
2364         local mds_HOST=${SINGLEMDS}_HOST
2365         echo $mds_HOST
2366         zconf_mount $mds1_HOST $MOUNT2 $MOUNT_OPTS ||
2367                 error "unable to mount $MOUNT2 on MDS"
2368 }
2369
2370 # Unmount the file system on the MDS
2371 umount_mds_client() {
2372         local mds_HOST=${SINGLEMDS}_HOST
2373         zconf_umount $mds1_HOST $MOUNT2
2374         do_facet $SINGLEMDS "rmdir $MOUNT2"
2375 }
2376
2377 # nodes is comma list
2378 sanity_mount_check_nodes () {
2379     local nodes=$1
2380     shift
2381     local mnts="$@"
2382     local mnt
2383
2384     # FIXME: assume that all cluster nodes run the same os
2385     [ "$(uname)" = Linux ] || return 0
2386
2387     local rc=0
2388     for mnt in $mnts ; do
2389         do_nodes $nodes "running=\\\$(grep -c $mnt' ' /proc/mounts);
2390 mpts=\\\$(mount | grep -c $mnt' ');
2391 if [ \\\$running -ne \\\$mpts ]; then
2392     echo \\\$(hostname) env are INSANE!;
2393     exit 1;
2394 fi"
2395     [ $? -eq 0 ] || rc=1
2396     done
2397     return $rc
2398 }
2399
2400 sanity_mount_check_servers () {
2401     [ -n "$CLIENTONLY" ] &&
2402         { echo "CLIENTONLY mode, skip mount_check_servers"; return 0; } || true
2403     echo Checking servers environments
2404
2405     # FIXME: modify get_facets to display all facets wo params
2406     local facets="$(get_facets OST),$(get_facets MDS),mgs"
2407     local node
2408     local mntpt
2409     local facet
2410     for facet in ${facets//,/ }; do
2411         node=$(facet_host ${facet})
2412         mntpt=$(facet_mntpt $facet)
2413         sanity_mount_check_nodes $node $mntpt ||
2414             { error "server $node environments are insane!"; return 1; }
2415     done
2416 }
2417
2418 sanity_mount_check_clients () {
2419     local clients=${1:-$CLIENTS}
2420     local mntpt=${2:-$MOUNT}
2421     local mntpt2=${3:-$MOUNT2}
2422
2423     [ -z $clients ] && clients=$(hostname)
2424     echo Checking clients $clients environments
2425
2426     sanity_mount_check_nodes $clients $mntpt $mntpt2 ||
2427        error "clients environments are insane!"
2428 }
2429
2430 sanity_mount_check () {
2431     sanity_mount_check_servers || return 1
2432     sanity_mount_check_clients || return 2
2433 }
2434
2435 # mount clients if not mouted
2436 zconf_mount_clients() {
2437         local clients=$1
2438         local mnt=$2
2439         local opts=${3:-$MOUNT_OPTS}
2440         opts=${opts:+-o $opts}
2441         local flags=${4:-$MOUNT_FLAGS}
2442         local device=$MGSNID:/$FSNAME$FILESET
2443         if [ -z "$mnt" -o -z "$FSNAME" ]; then
2444                 echo "Bad conf mount command: opt=$flags $opts dev=$device " \
2445                      "mnt=$mnt"
2446                 exit 1
2447         fi
2448
2449         echo "Starting client $clients: $flags $opts $device $mnt"
2450         do_nodes $clients mkdir -p $mnt
2451         if [ -n "$FILESET" -a -z "$SKIP_FILESET" ]; then
2452                 if $GSS_SK && ($SK_UNIQUE_NM || $SK_S2S); then
2453                         # Mount with own nodemap key
2454                         local i=0
2455                         # Mount all server nodes first with per-NM keys
2456                         for nmclient in ${clients//,/ }; do
2457 #                               do_nodes $(comma_list $(all_server_nodes)) "lgss_sk -t server -l $SK_PATH/nodemap/c$i.key -n c$i"
2458                                 do_nodes $(comma_list $(all_server_nodes)) "lgss_sk -t server -l $SK_PATH/nodemap/c$i.key"
2459                                 i=$((i + 1))
2460                         done
2461                         # set perms for per-nodemap keys else permission denied
2462                         do_nodes $(comma_list $(all_nodes)) \
2463                                 "keyctl show | grep lustre | cut -c1-11 |
2464                                 sed -e 's/ //g;' |
2465                                 xargs -IX keyctl setperm X 0x3f3f3f3f"
2466                         local mountkey=$SK_PATH/$FSNAME-nmclient.key
2467                         i=0
2468                         for nmclient in ${clients//,/ }; do
2469                                 if $SK_UNIQUE_NM; then
2470                                         mountkey=$SK_PATH/nodemap/c$i.key
2471                                 fi
2472                                 do_node $nmclient "! grep -q $mnt' ' \
2473                                         /proc/mounts || umount $mnt"
2474                                 local prunedopts=$(add_sk_mntflag $prunedopts);
2475                                 prunedopts=$(echo $prunedopts | sed -e \
2476                                         "s#skpath=[^ ^,]*#skpath=$mountkey#g")
2477                                 set -x
2478                                 do_nodes $(comma_list $(all_server_nodes)) \
2479                                         "keyctl show"
2480                                 set +x
2481                                 do_node $nmclient $MOUNT_CMD $flags \
2482                                         $prunedopts $MGSNID:/$FSNAME $mnt ||
2483                                         return 1
2484                                 i=$((i + 1))
2485                         done
2486                 else
2487                         do_nodes $clients "! grep -q $mnt' ' /proc/mounts ||
2488                                         umount $mnt"
2489                         do_nodes $clients $MOUNT_CMD $flags $opts \
2490                                         $MGSNID:/$FSNAME $mnt || return 1
2491                 fi
2492                 #disable FILESET if not supported
2493                 do_nodes $clients lctl get_param -n \
2494                         mdc.$FSNAME-MDT0000*.import | grep -q subtree ||
2495                                 device=$MGSNID:/$FSNAME
2496                 do_nodes $clients mkdir -p $mnt/$FILESET
2497                 do_nodes $clients "! grep -q $mnt' ' /proc/mounts ||
2498                         umount $mnt"
2499         fi
2500
2501         if $GSS_SK && ($SK_UNIQUE_NM || $SK_S2S); then
2502                 # Mount with nodemap key
2503                 local i=0
2504                 local mountkey=$SK_PATH/$FSNAME-nmclient.key
2505                 for nmclient in ${clients//,/ }; do
2506                         if $SK_UNIQUE_NM; then
2507                                 mountkey=$SK_PATH/nodemap/c$i.key
2508                         fi
2509                         local prunedopts=$(echo $opts | sed -e \
2510                                 "s#skpath=[^ ^,]*#skpath=$mountkey#g");
2511                         do_node $nmclient "! grep -q $mnt' ' /proc/mounts ||
2512                                 umount $mnt"
2513                         do_node $nmclient "
2514                 running=\\\$(mount | grep -c $mnt' ');
2515                 rc=0;
2516                 if [ \\\$running -eq 0 ] ; then
2517                         mkdir -p $mnt;
2518                         $MOUNT_CMD $flags $prunedopts $device $mnt;
2519                         rc=\\\$?;
2520                 else
2521                         lustre_mnt_count=\\\$(mount | grep $mnt' ' | \
2522                                 grep 'type lustre' | wc -l);
2523                         if [ \\\$running -ne \\\$lustre_mnt_count ] ; then
2524                                 echo zconf_mount_clients FAILED: \
2525                                         mount count \\\$running, not matching \
2526                                         with mount count of 'type lustre' \
2527                                         \\\$lustre_mnt_count;
2528                                 rc=1;
2529                         fi;
2530                 fi;
2531         exit \\\$rc" || return ${PIPESTATUS[0]}
2532
2533                         i=$((i + 1))
2534                 done
2535         else
2536
2537                 local tmpopts=$opts
2538                 if $SHARED_KEY; then
2539                         tmpopts=$(add_sk_mntflag $opts)
2540                 fi
2541                 do_nodes $clients "
2542 running=\\\$(mount | grep -c $mnt' ');
2543 rc=0;
2544 if [ \\\$running -eq 0 ] ; then
2545         mkdir -p $mnt;
2546         $MOUNT_CMD $flags $tmpopts $device $mnt;
2547         rc=\\\$?;
2548 fi;
2549 exit \\\$rc" || return ${PIPESTATUS[0]}
2550         fi
2551
2552         echo "Started clients $clients: "
2553         do_nodes $clients "mount | grep $mnt' '"
2554
2555         set_default_debug_nodes $clients
2556
2557         return 0
2558 }
2559
2560 zconf_umount_clients() {
2561     local clients=$1
2562     local mnt=$2
2563     local force
2564
2565     [ "$3" ] && force=-f
2566
2567     echo "Stopping clients: $clients $mnt (opts:$force)"
2568     do_nodes $clients "running=\\\$(grep -c $mnt' ' /proc/mounts);
2569 if [ \\\$running -ne 0 ] ; then
2570 echo Stopping client \\\$(hostname) $mnt opts:$force;
2571 lsof $mnt || need_kill=no;
2572 if [ "x$force" != "x" -a "x\\\$need_kill" != "xno" ]; then
2573     pids=\\\$(lsof -t $mnt | sort -u);
2574     if [ -n \\\"\\\$pids\\\" ]; then
2575              kill -9 \\\$pids;
2576     fi
2577 fi;
2578 while umount $force $mnt 2>&1 | grep -q "busy"; do
2579     echo "$mnt is still busy, wait one second" && sleep 1;
2580 done;
2581 fi"
2582 }
2583
2584 shutdown_node () {
2585     local node=$1
2586     echo + $POWER_DOWN $node
2587     $POWER_DOWN $node
2588 }
2589
2590 shutdown_node_hard () {
2591     local host=$1
2592     local attempts=$SHUTDOWN_ATTEMPTS
2593
2594     for i in $(seq $attempts) ; do
2595         shutdown_node $host
2596         sleep 1
2597         wait_for_function --quiet "! ping -w 3 -c 1 $host" 5 1 && return 0
2598         echo "waiting for $host to fail attempts=$attempts"
2599         [ $i -lt $attempts ] || \
2600             { echo "$host still pingable after power down! attempts=$attempts" && return 1; }
2601     done
2602 }
2603
2604 shutdown_client() {
2605     local client=$1
2606     local mnt=${2:-$MOUNT}
2607     local attempts=3
2608
2609     if [ "$FAILURE_MODE" = HARD ]; then
2610         shutdown_node_hard $client
2611     else
2612        zconf_umount_clients $client $mnt -f
2613     fi
2614 }
2615
2616 facets_on_host () {
2617     local host=$1
2618     local facets="$(get_facets OST),$(get_facets MDS)"
2619     local affected
2620
2621     combined_mgs_mds || facets="$facets,mgs"
2622
2623     for facet in ${facets//,/ }; do
2624         if [ $(facet_active_host $facet) == $host ]; then
2625            affected="$affected $facet"
2626         fi
2627     done
2628
2629     echo $(comma_list $affected)
2630 }
2631
2632 facet_up() {
2633         local facet=$1
2634         local host=${2:-$(facet_host $facet)}
2635
2636         local label=$(convert_facet2label $facet)
2637         do_node $host $LCTL dl | awk '{ print $4 }' | grep -q "^$label\$"
2638 }
2639
2640 facets_up_on_host () {
2641     local host=$1
2642     local facets=$(facets_on_host $host)
2643     local affected_up
2644
2645     for facet in ${facets//,/ }; do
2646         if $(facet_up $facet $host); then
2647             affected_up="$affected_up $facet"
2648         fi
2649     done
2650
2651     echo $(comma_list $affected_up)
2652 }
2653
2654 shutdown_facet() {
2655         local facet=$1
2656         local affected_facet
2657         local affected_facets
2658
2659         if [[ "$FAILURE_MODE" = HARD ]]; then
2660                 if [[ $(facet_fstype $facet) = ldiskfs ]] &&
2661                         dm_flakey_supported $facet; then
2662                         affected_facets=$(affected_facets $facet)
2663                         for affected_facet in ${affected_facets//,/ }; do
2664                                 unexport_dm_dev $affected_facet
2665                         done
2666                 fi
2667
2668                 shutdown_node_hard $(facet_active_host $facet)
2669         else
2670                 stop $facet
2671         fi
2672 }
2673
2674 reboot_node() {
2675     local node=$1
2676     echo + $POWER_UP $node
2677     $POWER_UP $node
2678 }
2679
2680 remount_facet() {
2681     local facet=$1
2682
2683     stop $facet
2684     mount_facet $facet
2685 }
2686
2687 reboot_facet() {
2688         local facet=$1
2689         if [ "$FAILURE_MODE" = HARD ]; then
2690                 reboot_node $(facet_active_host $facet)
2691         else
2692                 sleep 10
2693         fi
2694 }
2695
2696 boot_node() {
2697     local node=$1
2698     if [ "$FAILURE_MODE" = HARD ]; then
2699        reboot_node $node
2700        wait_for_host $node
2701     fi
2702 }
2703
2704 facets_hosts () {
2705     local facets=$1
2706     local hosts
2707
2708     for facet in ${facets//,/ }; do
2709         hosts=$(expand_list $hosts $(facet_host $facet) )
2710     done
2711
2712     echo $hosts
2713 }
2714
2715 _check_progs_installed () {
2716     local progs=$@
2717     local rc=0
2718
2719     for prog in $progs; do
2720         if ! [ "$(which $prog)"  -o  "${!prog}" ]; then
2721            echo $prog missing on $(hostname)
2722            rc=1
2723         fi
2724     done
2725     return $rc
2726 }
2727
2728 check_progs_installed () {
2729         local nodes=$1
2730         shift
2731
2732         do_rpc_nodes "$nodes" _check_progs_installed $@
2733 }
2734
2735 # recovery-scale functions
2736 node_var_name() {
2737     echo __$(echo $1 | tr '-' '_' | tr '.' '_')
2738 }
2739
2740 start_client_load() {
2741         local client=$1
2742         local load=$2
2743         local var=$(node_var_name $client)_load
2744         eval export ${var}=$load
2745
2746         do_node $client "PATH=$PATH MOUNT=$MOUNT ERRORS_OK=$ERRORS_OK \
2747                         BREAK_ON_ERROR=$BREAK_ON_ERROR \
2748                         END_RUN_FILE=$END_RUN_FILE \
2749                         LOAD_PID_FILE=$LOAD_PID_FILE \
2750                         TESTLOG_PREFIX=$TESTLOG_PREFIX \
2751                         TESTNAME=$TESTNAME \
2752                         DBENCH_LIB=$DBENCH_LIB \
2753                         DBENCH_SRC=$DBENCH_SRC \
2754                         CLIENT_COUNT=$((CLIENTCOUNT - 1)) \
2755                         LFS=$LFS \
2756                         LCTL=$LCTL \
2757                         FSNAME=$FSNAME \
2758                         MPIRUN=$MPIRUN \
2759                         MPIRUN_OPTIONS=\\\"$MPIRUN_OPTIONS\\\" \
2760                         MACHINEFILE_OPTION=\\\"$MACHINEFILE_OPTION\\\" \
2761                         num_clients=$(get_node_count ${CLIENTS//,/ }) \
2762                         ior_THREADS=$ior_THREADS ior_iteration=$ior_iteration \
2763                         ior_blockSize=$ior_blockSize \
2764                         ior_blockUnit=$ior_blockUnit \
2765                         ior_xferSize=$ior_xferSize ior_type=$ior_type \
2766                         ior_DURATION=$ior_DURATION \
2767                         ior_stripe_params=\\\"$ior_stripe_params\\\" \
2768                         ior_custom_params=\\\"$ior_custom_param\\\" \
2769                         mpi_ior_custom_threads=$mpi_ior_custom_threads \
2770                         run_${load}.sh" &
2771         local ppid=$!
2772         log "Started client load: ${load} on $client"
2773
2774         # get the children process IDs
2775         local pids=$(ps --ppid $ppid -o pid= | xargs)
2776         CLIENT_LOAD_PIDS="$CLIENT_LOAD_PIDS $ppid $pids"
2777         return 0
2778 }
2779
2780 start_client_loads () {
2781         local -a clients=(${1//,/ })
2782         local numloads=${#CLIENT_LOADS[@]}
2783
2784         for ((nodenum=0; nodenum < ${#clients[@]}; nodenum++ )); do
2785                 local load=$((nodenum % numloads))
2786                 start_client_load ${clients[nodenum]} ${CLIENT_LOADS[load]}
2787         done
2788         # bug 22169: wait the background threads to start
2789         sleep 2
2790 }
2791
2792 # only for remote client
2793 check_client_load () {
2794         local client=$1
2795         local var=$(node_var_name $client)_load
2796         local testload=run_${!var}.sh
2797
2798         ps auxww | grep -v grep | grep $client | grep -q $testload || return 1
2799
2800         # bug 18914: try to connect several times not only when
2801         # check ps, but  while check_node_health also
2802
2803         local tries=3
2804         local RC=254
2805         while [ $RC = 254 -a $tries -gt 0 ]; do
2806                 let tries=$tries-1
2807                 # assume success
2808                 RC=0
2809                 if ! check_node_health $client; then
2810                         RC=${PIPESTATUS[0]}
2811                         if [ $RC -eq 254 ]; then
2812                                 # FIXME: not sure how long we shuold sleep here
2813                                 sleep 10
2814                                 continue
2815                         fi
2816                         echo "check node health failed: RC=$RC "
2817                         return $RC
2818                 fi
2819         done
2820         # We can continue try to connect if RC=254
2821         # Just print the warning about this
2822         if [ $RC = 254 ]; then
2823                 echo "got a return status of $RC from do_node while checking " \
2824                 "node health on $client"
2825         fi
2826
2827         # see if the load is still on the client
2828         tries=3
2829         RC=254
2830         while [ $RC = 254 -a $tries -gt 0 ]; do
2831                 let tries=$tries-1
2832                 # assume success
2833                 RC=0
2834                 if ! do_node $client \
2835                         "ps auxwww | grep -v grep | grep -q $testload"; then
2836                         RC=${PIPESTATUS[0]}
2837                         sleep 30
2838                 fi
2839         done
2840         if [ $RC = 254 ]; then
2841                 echo "got a return status of $RC from do_node while checking " \
2842                 "(node health and 'ps') the client load on $client"
2843                 # see if we can diagnose a bit why this is
2844         fi
2845
2846         return $RC
2847 }
2848 check_client_loads () {
2849    local clients=${1//,/ }
2850    local client=
2851    local rc=0
2852
2853    for client in $clients; do
2854       check_client_load $client
2855       rc=${PIPESTATUS[0]}
2856       if [ "$rc" != 0 ]; then
2857         log "Client load failed on node $client, rc=$rc"
2858         return $rc
2859       fi
2860    done
2861 }
2862
2863 restart_client_loads () {
2864     local clients=${1//,/ }
2865     local expectedfail=${2:-""}
2866     local client=
2867     local rc=0
2868
2869     for client in $clients; do
2870         check_client_load $client
2871         rc=${PIPESTATUS[0]}
2872         if [ "$rc" != 0 -a "$expectedfail" ]; then
2873             local var=$(node_var_name $client)_load
2874             start_client_load $client ${!var}
2875             echo "Restarted client load ${!var}: on $client. Checking ..."
2876             check_client_load $client
2877             rc=${PIPESTATUS[0]}
2878             if [ "$rc" != 0 ]; then
2879                 log "Client load failed to restart on node $client, rc=$rc"
2880                 # failure one client load means test fail
2881                 # we do not need to check other
2882                 return $rc
2883             fi
2884         else
2885             return $rc
2886         fi
2887     done
2888 }
2889
2890 # Start vmstat and save its process ID in a file.
2891 start_vmstat() {
2892     local nodes=$1
2893     local pid_file=$2
2894
2895     [ -z "$nodes" -o -z "$pid_file" ] && return 0
2896
2897     do_nodes $nodes \
2898         "vmstat 1 > $TESTLOG_PREFIX.$TESTNAME.vmstat.\\\$(hostname -s).log \
2899         2>/dev/null </dev/null & echo \\\$! > $pid_file"
2900 }
2901
2902 # Display the nodes on which client loads failed.
2903 print_end_run_file() {
2904     local file=$1
2905     local node
2906
2907     [ -s $file ] || return 0
2908
2909     echo "Found the END_RUN_FILE file: $file"
2910     cat $file
2911
2912     # A client load will stop if it finds the END_RUN_FILE file.
2913     # That does not mean the client load actually failed though.
2914     # The first node in END_RUN_FILE is the one we are interested in.
2915     read node < $file
2916
2917     if [ -n "$node" ]; then
2918         local var=$(node_var_name $node)_load
2919
2920         local prefix=$TESTLOG_PREFIX
2921         [ -n "$TESTNAME" ] && prefix=$prefix.$TESTNAME
2922         local stdout_log=$prefix.run_${!var}_stdout.$node.log
2923         local debug_log=$(echo $stdout_log | sed 's/\(.*\)stdout/\1debug/')
2924
2925         echo "Client load ${!var} failed on node $node:"
2926         echo "$stdout_log"
2927         echo "$debug_log"
2928     fi
2929 }
2930
2931 # Stop the process which had its PID saved in a file.
2932 stop_process() {
2933     local nodes=$1
2934     local pid_file=$2
2935
2936     [ -z "$nodes" -o -z "$pid_file" ] && return 0
2937
2938     do_nodes $nodes "test -f $pid_file &&
2939         { kill -s TERM \\\$(cat $pid_file); rm -f $pid_file; }" || true
2940 }
2941
2942 # Stop all client loads.
2943 stop_client_loads() {
2944     local nodes=${1:-$CLIENTS}
2945     local pid_file=$2
2946
2947     # stop the client loads
2948     stop_process $nodes $pid_file
2949
2950     # clean up the processes that started them
2951     [ -n "$CLIENT_LOAD_PIDS" ] && kill -9 $CLIENT_LOAD_PIDS 2>/dev/null || true
2952 }
2953 # End recovery-scale functions
2954
2955 # verify that lustre actually cleaned up properly
2956 cleanup_check() {
2957         VAR=$(lctl get_param -n catastrophe 2>&1)
2958         if [ $? = 0 ] ; then
2959                 if [ $VAR != 0 ]; then
2960                         error "LBUG/LASSERT detected"
2961                 fi
2962         fi
2963         BUSY=$(dmesg | grep -i destruct || true)
2964         if [ -n "$BUSY" ]; then
2965                 echo "$BUSY" 1>&2
2966                 [ -e $TMP/debug ] && mv $TMP/debug $TMP/debug-busy.$(date +%s)
2967                 exit 205
2968         fi
2969
2970         check_mem_leak || exit 204
2971
2972         [[ $($LCTL dl 2>/dev/null | wc -l) -gt 0 ]] && $LCTL dl &&
2973                 echo "$TESTSUITE: lustre didn't clean up..." 1>&2 &&
2974                 return 202 || true
2975
2976         if module_loaded lnet || module_loaded libcfs; then
2977                 echo "$TESTSUITE: modules still loaded..." 1>&2
2978                 /sbin/lsmod 1>&2
2979                 return 203
2980         fi
2981         return 0
2982 }
2983
2984 wait_update () {
2985         local verbose=false
2986         if [[ "$1" == "--verbose" ]]; then
2987                 shift
2988                 verbose=true
2989         fi
2990
2991         local node=$1
2992         local TEST=$2
2993         local FINAL=$3
2994         local MAX=${4:-90}
2995         local RESULT
2996         local PREV_RESULT
2997         local WAIT=0
2998         local sleep=1
2999         local print=10
3000
3001         PREV_RESULT=$(do_node $node "$TEST")
3002         while [ true ]; do
3003                 RESULT=$(do_node $node "$TEST")
3004                 if [[ "$RESULT" == "$FINAL" ]]; then
3005                         [[ -z "$RESULT" || $WAIT -le $sleep ]] ||
3006                                 echo "Updated after ${WAIT}s: wanted '$FINAL'"\
3007                                      "got '$RESULT'"
3008                         return 0
3009                 fi
3010                 if [[ $verbose && "$RESULT" != "$PREV_RESULT" ]]; then
3011                         echo "Changed after ${WAIT}s: from '$PREV_RESULT'"\
3012                              "to '$RESULT'"
3013                         PREV_RESULT=$RESULT
3014                 fi
3015                 [[ $WAIT -ge $MAX ]] && break
3016                 [[ $((WAIT % print)) -eq 0 ]] &&
3017                         echo "Waiting $((MAX - WAIT)) secs for update"
3018                 WAIT=$((WAIT + sleep))
3019                 sleep $sleep
3020         done
3021         echo "Update not seen after ${MAX}s: wanted '$FINAL' got '$RESULT'"
3022         return 3
3023 }
3024
3025 wait_update_facet() {
3026         local verbose=
3027         [ "$1" = "--verbose" ] && verbose="$1" && shift
3028
3029         local facet=$1
3030         shift
3031         wait_update $verbose $(facet_active_host $facet) "$@"
3032 }
3033
3034 sync_all_data() {
3035         do_nodes $(comma_list $(mdts_nodes)) \
3036             "lctl set_param -n os[cd]*.*MDT*.force_sync=1"
3037         do_nodes $(comma_list $(osts_nodes)) \
3038             "lctl set_param -n osd*.*OS*.force_sync=1" 2>&1 |
3039                 grep -v 'Found no match'
3040 }
3041
3042 wait_zfs_commit() {
3043         local zfs_wait=${2:-5}
3044
3045         # the occupied disk space will be released
3046         # only after TXGs are committed
3047         if [[ $(facet_fstype $1) == zfs ]]; then
3048                 echo "sleep $zfs_wait for ZFS $(facet_fstype $1)"
3049                 sleep $zfs_wait
3050         fi
3051 }
3052
3053 fill_ost() {
3054         local filename=$1
3055         local ost_idx=$2
3056         local lwm=$3  #low watermark
3057         local size_mb #how many MB should we write to pass watermark
3058         local ost_name=$(ostname_from_index $ost_idx)
3059
3060         free_kb=$($LFS df $MOUNT | awk "/$ost_name/ { print \$4 }")
3061         size_mb=0
3062         if (( $free_kb / 1024 > lwm )); then
3063                 size_mb=$((free_kb / 1024 - lwm))
3064         fi
3065         #If 10% of free space cross low watermark use it
3066         if (( $free_kb / 10240 > size_mb )); then
3067                 size_mb=$((free_kb / 10240))
3068         else
3069                 #At least we need to store 1.1 of difference between
3070                 #free space and low watermark
3071                 size_mb=$((size_mb + size_mb / 10))
3072         fi
3073         if (( lwm <= $free_kb / 1024 )) ||
3074            [ ! -f $DIR/${filename}.fill_ost$ost_idx ]; then
3075                 $LFS setstripe -i $ost_idx -c1 $DIR/${filename}.fill_ost$ost_idx
3076                 dd if=/dev/zero of=$DIR/${filename}.fill_ost$ost_idx bs=1M \
3077                         count=$size_mb oflag=append conv=notrunc
3078         fi
3079
3080         sleep_maxage
3081
3082         free_kb=$($LFS df $MOUNT | awk "/$ost_name/ { print \$4 }")
3083         echo "OST still has $((free_kb / 1024)) MB free"
3084 }
3085
3086 # This checks only the primary MDS
3087 ost_watermarks_get() {
3088         local ost_idx=$1
3089         local ost_name=$(ostname_from_index $ost_idx)
3090         local mdtosc_proc=$(get_mdtosc_proc_path $SINGLEMDS $ost_name)
3091
3092         local hwm=$(do_facet $SINGLEMDS $LCTL get_param -n \
3093                         osp.$mdtosc_proc.reserved_mb_high)
3094         local lwm=$(do_facet $SINGLEMDS $LCTL get_param -n \
3095                         osp.$mdtosc_proc.reserved_mb_low)
3096
3097         echo "$lwm $hwm"
3098 }
3099
3100 # Note that we set watermarks on all MDSes (necessary for striped dirs)
3101 ost_watermarks_set() {
3102         local ost_idx=$1
3103         local lwm=$2
3104         local hwm=$3
3105         local ost_name=$(ostname_from_index $ost_idx)
3106         local facets=$(get_facets MDS)
3107
3108         do_nodes $(comma_list $(mdts_nodes)) $LCTL set_param -n \
3109                 osp.*$ost_name*.reserved_mb_low=$lwm \
3110                 osp.*$ost_name*.reserved_mb_high=$hwm > /dev/null
3111
3112         # sleep to ensure we see the change
3113         sleep_maxage
3114 }
3115
3116 ost_watermarks_set_low_space() {
3117         local ost_idx=$1
3118         local wms=$(ost_watermarks_get $ost_idx)
3119         local ost_name=$(ostname_from_index $ost_idx)
3120
3121         local old_lwm=$(echo $wms | awk '{ print $1 }')
3122         local old_hwm=$(echo $wms | awk '{ print $2 }')
3123
3124         local blocks=$($LFS df $MOUNT | awk "/$ost_name/ { print \$4 }")
3125         # minimal extension size is 64M
3126         local new_lwm=50
3127         if (( $blocks / 1024 > 50 )); then
3128                 new_lwm=$((blocks / 1024 - 50))
3129         fi
3130         local new_hwm=$((new_lwm + 5))
3131
3132         ost_watermarks_set $ost_idx $new_lwm $new_hwm
3133         echo "watermarks: $old_lwm $old_hwm $new_lwm $new_hwm"
3134 }
3135
3136 # Set watermarks to ~current available space & then write data to fill it
3137 # Note OST is not *actually* full after this, it just reports ENOSPC in the
3138 # internal statfs used by the stripe allocator
3139 #
3140 # first parameter is the filename-prefix, which must get under t-f cleanup
3141 # requirements (rm -rf $DIR/[Rdfs][0-9]*), i.e. $tfile work fine
3142 ost_watermarks_set_enospc() {
3143         local filename=$1
3144         local ost_idx=$2
3145         # on the mdt's osc
3146         local ost_name=$(ostname_from_index $ost_idx)
3147         local facets=$(get_facets MDS)
3148         local wms
3149         local MDS
3150
3151         for MDS in ${facets//,/ }; do
3152                 local mdtosc_proc=$(get_mdtosc_proc_path $MDS $ost_name)
3153
3154                 do_facet $MDS $LCTL get_param -n \
3155                         osp.$mdtosc_proc.reserved_mb_high ||
3156                         skip  "remote MDS does not support reserved_mb_high"
3157         done
3158
3159         wms=$(ost_watermarks_set_low_space $ost_idx)
3160         local new_lwm=$(echo $wms | awk '{ print $4 }')
3161         fill_ost $filename $ost_idx $new_lwm
3162         #First enospc could execute orphan deletion so repeat
3163         fill_ost $filename $ost_idx $new_lwm
3164         echo $wms
3165 }
3166
3167 ost_watermarks_enospc_delete_files() {
3168         local filename=$1
3169         local ost_idx=$2
3170
3171         rm -f $DIR/${filename}.fill_ost$ost_idx
3172
3173         wait_delete_completed
3174         wait_mds_ost_sync
3175 }
3176
3177 # clean up from "ost_watermarks_set_enospc"
3178 ost_watermarks_clear_enospc() {
3179         local filename=$1
3180         local ost_idx=$2
3181         local old_lwm=$4
3182         local old_hwm=$5
3183
3184         ost_watermarks_enospc_delete_files $filename $ost_idx
3185         ost_watermarks_set $ost_idx $old_lwm $old_hwm
3186         echo "set OST$ost_idx lwm back to $old_lwm, hwm back to $old_hwm"
3187 }
3188
3189 wait_delete_completed_mds() {
3190         local max_wait=${1:-20}
3191         local mds2sync=""
3192         local stime=$(date +%s)
3193         local etime
3194         local node
3195         local changes
3196
3197         # find MDS with pending deletions
3198         for node in $(mdts_nodes); do
3199                 changes=$(do_node $node "$LCTL get_param -n osc.*MDT*.sync_*" \
3200                         2>/dev/null | calc_sum)
3201                 if [[ $changes -eq 0 ]]; then
3202                         continue
3203                 fi
3204                 mds2sync="$mds2sync $node"
3205         done
3206         if [ -z "$mds2sync" ]; then
3207                 wait_zfs_commit $SINGLEMDS
3208                 return 0
3209         fi
3210         mds2sync=$(comma_list $mds2sync)
3211
3212         # sync MDS transactions
3213         do_nodes $mds2sync "$LCTL set_param -n os[cd]*.*MD*.force_sync 1"
3214
3215         # wait till all changes are sent and commmitted by OSTs
3216         # for ldiskfs space is released upon execution, but DMU
3217         # do this upon commit
3218
3219         local WAIT=0
3220         while [[ $WAIT -ne $max_wait ]]; do
3221                 changes=$(do_nodes $mds2sync \
3222                         "$LCTL get_param -n osc.*MDT*.sync_*" | calc_sum)
3223                 #echo "$node: $changes changes on all"
3224                 if [[ $changes -eq 0 ]]; then
3225                         wait_zfs_commit $SINGLEMDS
3226
3227                         # the occupied disk space will be released
3228                         # only after TXGs are committed
3229                         wait_zfs_commit ost1
3230                         return 0
3231                 fi
3232                 sleep 1
3233                 WAIT=$((WAIT + 1))
3234         done
3235
3236         etime=$(date +%s)
3237         echo "Delete is not completed in $((etime - stime)) seconds"
3238         do_nodes $mds2sync "$LCTL get_param osc.*MDT*.sync_*"
3239         return 1
3240 }
3241
3242 wait_for_host() {
3243         local hostlist=$1
3244
3245         # we can use "for" here because we are waiting the slowest
3246         for host in ${hostlist//,/ }; do
3247                 check_network "$host" 900
3248         done
3249         while ! do_nodes $hostlist hostname  > /dev/null; do sleep 5; done
3250 }
3251
3252 wait_for_facet() {
3253     local facetlist=$1
3254     local hostlist
3255
3256     for facet in ${facetlist//,/ }; do
3257         hostlist=$(expand_list $hostlist $(facet_active_host $facet))
3258     done
3259     wait_for_host $hostlist
3260 }
3261
3262 _wait_recovery_complete () {
3263     local param=$1
3264
3265     # Use default policy if $2 is not passed by caller.
3266     local MAX=${2:-$(max_recovery_time)}
3267
3268     local WAIT=0
3269     local STATUS=
3270
3271     while [ $WAIT -lt $MAX ]; do
3272         STATUS=$(lctl get_param -n $param | grep status)
3273         echo $param $STATUS
3274         [[ $STATUS = "status: COMPLETE" || $STATUS = "status: INACTIVE" ]] && return 0
3275         sleep 5
3276         WAIT=$((WAIT + 5))
3277         echo "Waiting $((MAX - WAIT)) secs for $param recovery done. $STATUS"
3278     done
3279     echo "$param recovery not done in $MAX sec. $STATUS"
3280     return 1
3281 }
3282
3283 wait_recovery_complete () {
3284     local facet=$1
3285
3286     # with an assumption that at_max is the same on all nodes
3287     local MAX=${2:-$(max_recovery_time)}
3288
3289     local facets=$facet
3290     if [ "$FAILURE_MODE" = HARD ]; then
3291         facets=$(facets_on_host $(facet_active_host $facet))
3292     fi
3293     echo affected facets: $facets
3294
3295         # we can use "for" here because we are waiting the slowest
3296         for facet in ${facets//,/ }; do
3297                 local var_svc=${facet}_svc
3298                 local param="*.${!var_svc}.recovery_status"
3299
3300                 local host=$(facet_active_host $facet)
3301                 do_rpc_nodes "$host" _wait_recovery_complete $param $MAX
3302         done
3303 }
3304
3305 wait_mds_ost_sync () {
3306         # just because recovery is done doesn't mean we've finished
3307         # orphan cleanup. Wait for llogs to get synchronized.
3308         echo "Waiting for orphan cleanup..."
3309         # MAX value includes time needed for MDS-OST reconnection
3310         local MAX=$(( TIMEOUT * 2 ))
3311         local WAIT_TIMEOUT=${1:-$MAX}
3312         local WAIT=0
3313         local new_wait=true
3314         local list=$(comma_list $(mdts_nodes))
3315         local cmd="$LCTL get_param -n osp.*osc*.old_sync_processed"
3316         if ! do_facet $SINGLEMDS \
3317                 "$LCTL list_param osp.*osc*.old_sync_processed 2> /dev/null"
3318         then
3319                 # old way, use mds_sync
3320                 new_wait=false
3321                 list=$(comma_list $(osts_nodes))
3322                 cmd="$LCTL get_param -n obdfilter.*.mds_sync"
3323         fi
3324
3325         echo "wait $WAIT_TIMEOUT secs maximumly for $list mds-ost sync done."
3326         while [ $WAIT -lt $WAIT_TIMEOUT ]; do
3327                 local -a sync=($(do_nodes $list "$cmd"))
3328                 local con=1
3329                 local i
3330                 for ((i=0; i<${#sync[@]}; i++)); do
3331                         if $new_wait; then
3332                                 [ ${sync[$i]} -eq 1 ] && continue
3333                         else
3334                                 [ ${sync[$i]} -eq 0 ] && continue
3335                         fi
3336                         # there is a not finished MDS-OST synchronization
3337                         con=0
3338                         break;
3339                 done
3340                 sleep 2 # increase waiting time and cover statfs cache
3341                 [ ${con} -eq 1 ] && return 0
3342                 echo "Waiting $WAIT secs for $list $i mds-ost sync done."
3343                 WAIT=$((WAIT + 2))
3344         done
3345
3346         # show which nodes are not finished.
3347         cmd=$(echo $cmd | sed 's/-n//')
3348         do_nodes $list "$cmd"
3349         echo "$facet recovery node $i not done in $WAIT_TIMEOUT sec. $STATUS"
3350         return 1
3351 }
3352
3353 # Wait OSTs to be active on both client and MDT side.
3354 wait_osts_up() {
3355         local cmd="$LCTL get_param -n lov.$FSNAME-clilov-*.target_obd |
3356                 awk 'BEGIN {c = 0} /ACTIVE/{c += 1} END {printf \\\"%d\\\", c}'"
3357         wait_update $HOSTNAME "eval $cmd" $OSTCOUNT ||
3358                 error "wait_update OSTs up on client failed"
3359
3360         cmd="$LCTL get_param osp.$FSNAME-OST*-MDT0000.prealloc_last_id |
3361              awk '/=[1-9][0-9]/ { c += 1 } END { printf \\\"%d\\\", c }'"
3362         wait_update_facet $SINGLEMDS "eval $cmd" $OSTCOUNT ||
3363                 error "wait_update OSTs up on MDT0000 failed"
3364 }
3365
3366 wait_destroy_complete () {
3367         echo "Waiting for local destroys to complete"
3368         # MAX value shouldn't be big as this mean server responsiveness
3369         # never increase this just to make test pass but investigate
3370         # why it takes so long time
3371         local MAX=5
3372         local WAIT=0
3373         while [ $WAIT -lt $MAX ]; do
3374                 local -a RPCs=($($LCTL get_param -n osc.*.destroys_in_flight))
3375                 local con=1
3376                 local i
3377
3378                 for ((i=0; i<${#RPCs[@]}; i++)); do
3379                         [ ${RPCs[$i]} -eq 0 ] && continue
3380                         # there are still some destroy RPCs in flight
3381                         con=0
3382                         break;
3383                 done
3384                 sleep 1
3385                 [ ${con} -eq 1 ] && return 0 # done waiting
3386                 echo "Waiting ${WAIT}s for local destroys to complete"
3387                 WAIT=$((WAIT + 1))
3388         done
3389         echo "Local destroys weren't done in $MAX sec."
3390         return 1
3391 }
3392
3393 wait_delete_completed() {
3394         wait_delete_completed_mds $1 || return $?
3395         wait_destroy_complete || return $?
3396 }
3397
3398 wait_exit_ST () {
3399     local facet=$1
3400
3401     local WAIT=0
3402     local INTERVAL=1
3403     local running
3404     # conf-sanity 31 takes a long time cleanup
3405     while [ $WAIT -lt 300 ]; do
3406         running=$(do_facet ${facet} "lsmod | grep lnet > /dev/null &&
3407 lctl dl | grep ' ST ' || true")
3408         [ -z "${running}" ] && return 0
3409         echo "waited $WAIT for${running}"
3410         [ $INTERVAL -lt 64 ] && INTERVAL=$((INTERVAL + INTERVAL))
3411         sleep $INTERVAL
3412         WAIT=$((WAIT + INTERVAL))
3413     done
3414     echo "service didn't stop after $WAIT seconds.  Still running:"
3415     echo ${running}
3416     return 1
3417 }
3418
3419 wait_remote_prog () {
3420    local prog=$1
3421    local WAIT=0
3422    local INTERVAL=5
3423    local rc=0
3424
3425    [ "$PDSH" = "no_dsh" ] && return 0
3426
3427    while [ $WAIT -lt $2 ]; do
3428         running=$(ps uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep) || true
3429         [ -z "${running}" ] && return 0 || true
3430         echo "waited $WAIT for: "
3431         echo "$running"
3432         [ $INTERVAL -lt 60 ] && INTERVAL=$((INTERVAL + INTERVAL))
3433         sleep $INTERVAL
3434         WAIT=$((WAIT + INTERVAL))
3435     done
3436     local pids=$(ps  uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep | awk '{print $2}')
3437     [ -z "$pids" ] && return 0
3438     echo "$PDSH processes still exists after $WAIT seconds.  Still running: $pids"
3439     # FIXME: not portable
3440     for pid in $pids; do
3441         cat /proc/${pid}/status || true
3442         cat /proc/${pid}/wchan || true
3443         echo "Killing $pid"
3444         kill -9 $pid || true
3445         sleep 1
3446         ps -P $pid && rc=1
3447     done
3448
3449     return $rc
3450 }
3451
3452 lfs_df_check() {
3453         local clients=${1:-$CLIENTS}
3454
3455         if [ -z "$clients" ]; then
3456                 $LFS df $MOUNT
3457         else
3458                 $PDSH $clients "$LFS df $MOUNT" > /dev/null
3459         fi
3460 }
3461
3462 clients_up() {
3463         # not every config has many clients
3464         sleep 1
3465         lfs_df_check
3466 }
3467
3468 client_up() {
3469         # usually checked on particular client or locally
3470         sleep 1
3471         lfs_df_check $1
3472 }
3473
3474 client_evicted() {
3475     ! client_up $1
3476 }
3477
3478 client_reconnect_try() {
3479         local f=$MOUNT/recon
3480
3481         uname -n >> $f
3482         if [ -z "$CLIENTS" ]; then
3483                 $LFS df $MOUNT; uname -n >> $f
3484         else
3485                 do_nodes $CLIENTS "$LFS df $MOUNT; uname -n >> $f" > /dev/null
3486         fi
3487         echo "Connected clients: $(cat $f)"
3488         ls -l $f > /dev/null
3489         rm $f
3490 }
3491
3492 client_reconnect() {
3493         # one client_reconnect_try call does not always do the job...
3494         while true ; do
3495                 client_reconnect_try && break
3496                 sleep 1
3497         done
3498 }
3499
3500 affected_facets () {
3501     local facet=$1
3502
3503     local host=$(facet_active_host $facet)
3504     local affected=$facet
3505
3506     if [ "$FAILURE_MODE" = HARD ]; then
3507         affected=$(facets_up_on_host $host)
3508     fi
3509     echo $affected
3510 }
3511
3512 facet_failover() {
3513         local E2FSCK_ON_MDT0=false
3514         if [ "$1" == "--fsck" ]; then
3515                 shift
3516                 [ $(facet_fstype $SINGLEMDS) == ldiskfs ] &&
3517                         E2FSCK_ON_MDT0=true
3518         fi
3519
3520         local facets=$1
3521         local sleep_time=$2
3522         local -a affecteds
3523         local facet
3524         local total=0
3525         local index=0
3526         local skip
3527
3528         #Because it will only get up facets, we need get affected
3529         #facets before shutdown
3530         #For HARD Failure mode, it needs make sure facets on the same
3531         #HOST will only be shutdown and reboot once
3532         for facet in ${facets//,/ }; do
3533                 local affected_facet
3534                 skip=0
3535                 #check whether facet has been included in other affected facets
3536                 for ((index=0; index<$total; index++)); do
3537                         [[ *,$facet,* == ,${affecteds[index]}, ]] && skip=1
3538                 done
3539
3540                 if [ $skip -eq 0 ]; then
3541                         affecteds[$total]=$(affected_facets $facet)
3542                         total=$((total+1))
3543                 fi
3544         done
3545
3546         for ((index=0; index<$total; index++)); do
3547                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
3548                 local host=$(facet_active_host $facet)
3549                 echo "Failing ${affecteds[index]} on $host"
3550                 shutdown_facet $facet
3551         done
3552
3553         $E2FSCK_ON_MDT0 && (run_e2fsck $(facet_active_host $SINGLEMDS) \
3554                 $(mdsdevname 1) "-n" || error "Running e2fsck")
3555
3556         for ((index=0; index<$total; index++)); do
3557                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
3558                 echo reboot facets: ${affecteds[index]}
3559
3560                 reboot_facet $facet
3561
3562                 change_active ${affecteds[index]}
3563
3564                 wait_for_facet ${affecteds[index]}
3565                 if $GSS_SK; then
3566                         init_gss
3567                         init_facets_vars_simple
3568                 fi
3569                 # start mgs first if it is affected
3570                 if ! combined_mgs_mds &&
3571                         list_member ${affecteds[index]} mgs; then
3572                         mount_facet mgs || error "Restart of mgs failed"
3573                 fi
3574                 # FIXME; has to be changed to mount all facets concurrently
3575                 affected=$(exclude_items_from_list ${affecteds[index]} mgs)
3576                 echo mount facets: ${affecteds[index]}
3577                 mount_facets ${affecteds[index]}
3578                 if $GSS_SK; then
3579                         do_nodes $(comma_list $(all_nodes)) \
3580                                 "keyctl show | grep lustre | cut -c1-11 |
3581                                 sed -e 's/ //g;' |
3582                                 xargs -IX keyctl setperm X 0x3f3f3f3f"
3583                 fi
3584         done
3585 }
3586
3587 obd_name() {
3588     local facet=$1
3589 }
3590
3591 replay_barrier() {
3592         local facet=$1
3593         do_facet $facet "sync; sync; sync"
3594         $LFS df $MOUNT
3595
3596         # make sure there will be no seq change
3597         local clients=${CLIENTS:-$HOSTNAME}
3598         local f=fsa-\\\$\(hostname\)
3599         do_nodes $clients "mcreate $MOUNT/$f; rm $MOUNT/$f"
3600         do_nodes $clients "if [ -d $MOUNT2 ]; then mcreate $MOUNT2/$f; rm $MOUNT2/$f; fi"
3601
3602         local svc=${facet}_svc
3603         do_facet $facet $LCTL --device ${!svc} notransno
3604         #
3605         # If a ZFS OSD is made read-only here, its pool is "freezed". This
3606         # in-memory state has to be cleared by either rebooting the host or
3607         # exporting and reimporting the pool.
3608         #
3609         # Although the uberblocks are not updated when a pool is freezed,
3610         # transactions are still written to the disks. Modified blocks may be
3611         # cached in memory when tests try reading them back. The
3612         # export-and-reimport process also evicts any cached pool data from
3613         # memory to provide the correct "data loss" semantics.
3614         #
3615         # In the test framework, the exporting and importing operations are
3616         # handled by stop() and mount_facet() separately, which are used
3617         # inside fail() and fail_abort().
3618         #
3619         set_dev_readonly $facet
3620         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
3621         $LCTL mark "local REPLAY BARRIER on ${!svc}"
3622 }
3623
3624 replay_barrier_nodf() {
3625         local facet=$1    echo running=${running}
3626         do_facet $facet "sync; sync; sync"
3627         local svc=${facet}_svc
3628         echo Replay barrier on ${!svc}
3629         do_facet $facet $LCTL --device ${!svc} notransno
3630         set_dev_readonly $facet
3631         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
3632         $LCTL mark "local REPLAY BARRIER on ${!svc}"
3633 }
3634
3635 replay_barrier_nosync() {
3636         local facet=$1    echo running=${running}
3637         local svc=${facet}_svc
3638         echo Replay barrier on ${!svc}
3639         do_facet $facet $LCTL --device ${!svc} notransno
3640         set_dev_readonly $facet
3641         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
3642         $LCTL mark "local REPLAY BARRIER on ${!svc}"
3643 }
3644
3645 #
3646 # Get Lustre client uuid for a given Lustre mount point.
3647 #
3648 get_client_uuid() {
3649         local mntpnt=${1:-$MOUNT}
3650
3651         local name=$($LFS getname $mntpnt | cut -d' ' -f1)
3652         local uuid=$($LCTL get_param -n llite.$name.uuid)
3653
3654         echo -n $uuid
3655 }
3656
3657 mds_evict_client() {
3658         local mntpnt=${1:-$MOUNT}
3659         local uuid=$(get_client_uuid $mntpnt)
3660
3661         do_facet $SINGLEMDS \
3662                 "$LCTL set_param -n mdt.${mds1_svc}.evict_client $uuid"
3663 }
3664
3665 ost_evict_client() {
3666         local mntpnt=${1:-$MOUNT}
3667         local uuid=$(get_client_uuid $mntpnt)
3668
3669         do_facet ost1 \
3670                 "$LCTL set_param -n obdfilter.${ost1_svc}.evict_client $uuid"
3671 }
3672
3673 fail() {
3674         local facets=$1
3675         local clients=${CLIENTS:-$HOSTNAME}
3676
3677         SK_NO_KEY_save=$SK_NO_KEY
3678         if $GSS_SK; then
3679                 export SK_NO_KEY=false
3680         fi
3681         facet_failover $* || error "failover: $?"
3682         export SK_NO_KEY=$SK_NO_KEY_save
3683         # to initiate all OSC idling connections
3684         clients_up
3685         wait_clients_import_state "$clients" "$facets" "\(FULL\|IDLE\)"
3686         clients_up || error "post-failover stat: $?"
3687 }
3688
3689 fail_nodf() {
3690         local facet=$1
3691         facet_failover $facet
3692 }
3693
3694 fail_abort() {
3695         local facet=$1
3696         stop $facet
3697         change_active $facet
3698         wait_for_facet $facet
3699         mount_facet $facet -o abort_recovery
3700         clients_up || echo "first stat failed: $?"
3701         clients_up || error "post-failover stat: $?"
3702 }
3703
3704 host_nids_address() {
3705         local nodes=$1
3706         local net=${2:-"."}
3707
3708         do_nodes $nodes "$LCTL list_nids | grep $net | cut -f 1 -d @"
3709 }
3710
3711 h2name_or_ip() {
3712         if [ "$1" = "'*'" ]; then echo \'*\'; else
3713                 echo $1"@$2"
3714         fi
3715 }
3716
3717 h2nettype() {
3718         if [[ -n "$NETTYPE" ]]; then
3719                 h2name_or_ip "$1" "$NETTYPE"
3720         else
3721                 h2name_or_ip "$1" "$2"
3722         fi
3723 }
3724 declare -fx h2nettype
3725
3726 # Wrapper function to print the deprecation warning
3727 h2tcp() {
3728         echo "h2tcp: deprecated, use h2nettype instead" 1>&2
3729         if [[ -n "$NETTYPE" ]]; then
3730                 h2nettype "$@"
3731         else
3732                 h2nettype "$1" "tcp"
3733         fi
3734 }
3735
3736 # Wrapper function to print the deprecation warning
3737 h2o2ib() {
3738         echo "h2o2ib: deprecated, use h2nettype instead" 1>&2
3739         if [[ -n "$NETTYPE" ]]; then
3740                 h2nettype "$@"
3741         else
3742                 h2nettype "$1" "o2ib"
3743         fi
3744 }
3745
3746 # This enables variables in cfg/"setup".sh files to support the pdsh HOSTLIST
3747 # expressions format. As a bonus we can then just pass in those variables
3748 # to pdsh. What this function does is take a HOSTLIST type string and
3749 # expand it into a space deliminated list for us.
3750 hostlist_expand() {
3751     local hostlist=$1
3752     local offset=$2
3753     local myList
3754     local item
3755     local list
3756
3757     [ -z "$hostlist" ] && return
3758
3759     # Translate the case of [..],..,[..] to [..] .. [..]
3760     list="${hostlist/],/] }"
3761     front=${list%%[*}
3762     [[ "$front" == *,* ]] && {
3763         new="${list%,*} "
3764         old="${list%,*},"
3765         list=${list/${old}/${new}}
3766     }
3767
3768     for item in $list; do
3769         # Test if we have any []'s at all
3770         if [ "$item" != "${item/\[/}" ]; then {
3771             # Expand the [*] into list
3772             name=${item%%[*}
3773             back=${item#*]}
3774
3775             if [ "$name" != "$item" ]; then
3776                 group=${item#$name[*}
3777                 group=${group%%]*}
3778
3779                 for range in ${group//,/ }; do
3780                     local order
3781
3782                     begin=${range%-*}
3783                     end=${range#*-}
3784
3785                     # Number of leading zeros
3786                     padlen=${#begin}
3787                     padlen2=${#end}
3788                     end=$(echo $end | sed 's/0*//')
3789                     [[ -z "$end" ]] && end=0
3790                     [[ $padlen2 -gt $padlen ]] && {
3791                         [[ $padlen2 -eq ${#end} ]] && padlen2=0
3792                         padlen=$padlen2
3793                     }
3794                     begin=$(echo $begin | sed 's/0*//')
3795                     [ -z $begin ] && begin=0
3796
3797                     if [ ! -z "${begin##[!0-9]*}" ]; then
3798                         order=$(seq -f "%0${padlen}g" $begin $end)
3799                     else
3800                         order=$(eval echo {$begin..$end});
3801                     fi
3802
3803                     for num in $order; do
3804                         value="${name#*,}${num}${back}"
3805                         [ "$value" != "${value/\[/}" ] && {
3806                             value=$(hostlist_expand "$value")
3807                         }
3808                         myList="$myList $value"
3809                     done
3810                 done
3811             fi
3812         } else {
3813             myList="$myList $item"
3814         } fi
3815     done
3816     myList=${myList//,/ }
3817     myList=${myList:1} # Remove first character which is a space
3818
3819     # Filter any duplicates without sorting
3820     list="$myList "
3821     myList="${list%% *}"
3822
3823     while [[ "$list" != ${myList##* } ]]; do
3824         local tlist=" $list"
3825         list=${tlist// ${list%% *} / }
3826         list=${list:1}
3827         myList="$myList ${list%% *}"
3828     done
3829     myList="${myList%* }";
3830
3831     # We can select an object at an offset in the list
3832     [ $# -eq 2 ] && {
3833         cnt=0
3834         for item in $myList; do
3835             let cnt=cnt+1
3836             [ $cnt -eq $offset ] && {
3837                 myList=$item
3838             }
3839         done
3840         [ $(get_node_count $myList) -ne 1 ] && myList=""
3841     }
3842     echo $myList
3843 }
3844
3845 facet_host() {
3846         local facet=$1
3847         local varname
3848
3849         [ "$facet" == client ] && echo -n $HOSTNAME && return
3850         varname=${facet}_HOST
3851         if [ -z "${!varname}" ]; then
3852                 if [ "${facet:0:3}" == "ost" ]; then
3853                         local fh=${facet%failover}_HOST
3854                         eval export ${facet}_HOST=${!fh}
3855                         if [ -z "${!varname}" ]; then
3856                                 eval export ${facet}_HOST=${ost_HOST}
3857                         fi
3858                 elif [ "${facet:0:3}" == "mdt" -o \
3859                         "${facet:0:3}" == "mds" -o \
3860                         "${facet:0:3}" == "mgs" ]; then
3861                         eval export ${facet}_HOST=${mds_HOST}
3862                 fi
3863         fi
3864         echo -n ${!varname}
3865 }
3866
3867 facet_failover_host() {
3868         local facet=$1
3869         local varname
3870
3871         var=${facet}failover_HOST
3872         if [ -n "${!var}" ]; then
3873                 echo ${!var}
3874                 return
3875         fi
3876
3877         if [ "${facet:0:3}" == "mdt" -o "${facet:0:3}" == "mds" -o \
3878              "${facet:0:3}" == "mgs" ]; then
3879
3880                 eval export ${facet}failover_host=${mds_HOST}
3881                 echo ${mds_HOST}
3882                 return
3883         fi
3884
3885         if [[ $facet == ost* ]]; then
3886                 eval export ${facet}failover_host=${ost_HOST}
3887                 echo ${ost_HOST}
3888                 return
3889         fi
3890 }
3891
3892 facet_active() {
3893     local facet=$1
3894     local activevar=${facet}active
3895
3896     if [ -f $TMP/${facet}active ] ; then
3897         source $TMP/${facet}active
3898     fi
3899
3900     active=${!activevar}
3901     if [ -z "$active" ] ; then
3902         echo -n ${facet}
3903     else
3904         echo -n ${active}
3905     fi
3906 }
3907
3908 facet_active_host() {
3909         facet_host $(facet_active $1)
3910 }
3911
3912 # Get the passive failover partner host of facet.
3913 facet_passive_host() {
3914         local facet=$1
3915         [[ $facet = client ]] && return
3916
3917         local host=${facet}_HOST
3918         local failover_host=${facet}failover_HOST
3919         local active_host=$(facet_active_host $facet)
3920
3921         [[ -z ${!failover_host} || ${!failover_host} = ${!host} ]] && return
3922
3923         if [[ $active_host = ${!host} ]]; then
3924                 echo -n ${!failover_host}
3925         else
3926                 echo -n ${!host}
3927         fi
3928 }
3929
3930 change_active() {
3931     local facetlist=$1
3932     local facet
3933
3934     facetlist=$(exclude_items_from_list $facetlist mgs)
3935
3936     for facet in ${facetlist//,/ }; do
3937     local failover=${facet}failover
3938     local host=`facet_host $failover`
3939     [ -z "$host" ] && return
3940
3941     local curactive=`facet_active $facet`
3942     if [ -z "${curactive}" -o "$curactive" == "$failover" ] ; then
3943         eval export ${facet}active=$facet
3944     else
3945         eval export ${facet}active=$failover
3946     fi
3947     # save the active host for this facet
3948     local activevar=${facet}active
3949     echo "$activevar=${!activevar}" > $TMP/$activevar
3950     [[ $facet = mds1 ]] && combined_mgs_mds && \
3951         echo "mgsactive=${!activevar}" > $TMP/mgsactive
3952     local TO=`facet_active_host $facet`
3953     echo "Failover $facet to $TO"
3954     done
3955 }
3956
3957 do_node() {
3958     local verbose=false
3959     # do not stripe off hostname if verbose, bug 19215
3960     if [ x$1 = x--verbose ]; then
3961         shift
3962         verbose=true
3963     fi
3964
3965     local HOST=$1
3966     shift
3967     local myPDSH=$PDSH
3968     if [ "$HOST" = "$HOSTNAME" ]; then
3969         myPDSH="no_dsh"
3970     elif [ -z "$myPDSH" -o "$myPDSH" = "no_dsh" ]; then
3971         echo "cannot run remote command on $HOST with $myPDSH"
3972         return 128
3973     fi
3974     if $VERBOSE; then
3975         echo "CMD: $HOST $@" >&2
3976         $myPDSH $HOST "$LCTL mark \"$@\"" > /dev/null 2>&1 || :
3977     fi
3978
3979         if [[ "$myPDSH" == "rsh" ]] ||
3980            [[ "$myPDSH" == *pdsh* && "$myPDSH" != *-S* ]]; then
3981                 # we need this because rsh and pdsh do not return
3982                 # exit code of an executed command
3983                 local command_status="$TMP/cs"
3984                 eval $myPDSH $HOST ":> $command_status"
3985                 eval $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests;
3986                                      PATH=\$PATH:/sbin:/usr/sbin;
3987                                      cd $RPWD;
3988                                      LUSTRE=\"$RLUSTRE\" sh -c \"$@\") ||
3989                                      echo command failed >$command_status"
3990                 [[ -n "$($myPDSH $HOST cat $command_status)" ]] && return 1 ||
3991                         return 0
3992         fi
3993
3994     if $verbose ; then
3995         # print HOSTNAME for myPDSH="no_dsh"
3996         if [[ $myPDSH = no_dsh ]]; then
3997             $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")" | sed -e "s/^/${HOSTNAME}: /"
3998         else
3999             $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")"
4000         fi
4001     else
4002         $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")" | sed "s/^${HOST}: //"
4003     fi
4004     return ${PIPESTATUS[0]}
4005 }
4006
4007 do_nodev() {
4008     do_node --verbose "$@"
4009 }
4010
4011 single_local_node () {
4012    [ "$1" = "$HOSTNAME" ]
4013 }
4014
4015 # Outputs environment variable assignments that should be passed to remote nodes
4016 get_env_vars() {
4017         local var
4018         local value
4019         local facets=$(get_facets)
4020         local facet
4021
4022         for var in ${!MODOPTS_*}; do
4023                 value=${!var//\"/\\\"}
4024                 echo -n " ${var}=\"$value\""
4025         done
4026
4027         for facet in ${facets//,/ }; do
4028                 var=${facet}_FSTYPE
4029                 if [ -n "${!var}" ]; then
4030                         echo -n " $var=${!var}"
4031                 fi
4032         done
4033
4034         for var in MGSFSTYPE MDSFSTYPE OSTFSTYPE; do
4035                 if [ -n "${!var}" ]; then
4036                         echo -n " $var=${!var}"
4037                 fi
4038         done
4039
4040         for var in VERBOSE; do
4041                 if [ -n "${!var}" ]; then
4042                         echo -n " $var=${!var}"
4043                 fi
4044         done
4045
4046         if [ -n "$FSTYPE" ]; then
4047                 echo -n " FSTYPE=$FSTYPE"
4048         fi
4049
4050         for var in LNETLND NETTYPE; do
4051                 if [ -n "${!var}" ]; then
4052                         echo -n " $var=${!var}"
4053                 fi
4054         done
4055 }
4056
4057 do_nodes() {
4058     local verbose=false
4059     # do not stripe off hostname if verbose, bug 19215
4060     if [ x$1 = x--verbose ]; then
4061         shift
4062         verbose=true
4063     fi
4064
4065     local rnodes=$1
4066     shift
4067
4068     if single_local_node $rnodes; then
4069         if $verbose; then
4070            do_nodev $rnodes "$@"
4071         else
4072            do_node $rnodes "$@"
4073         fi
4074         return $?
4075     fi
4076
4077     # This is part from do_node
4078     local myPDSH=$PDSH
4079
4080     [ -z "$myPDSH" -o "$myPDSH" = "no_dsh" -o "$myPDSH" = "rsh" ] && \
4081         echo "cannot run remote command on $rnodes with $myPDSH" && return 128
4082
4083     export FANOUT=$(get_node_count "${rnodes//,/ }")
4084     if $VERBOSE; then
4085         echo "CMD: $rnodes $@" >&2
4086         $myPDSH $rnodes "$LCTL mark \"$@\"" > /dev/null 2>&1 || :
4087     fi
4088
4089     # do not replace anything from pdsh output if -N is used
4090     # -N     Disable hostname: prefix on lines of output.
4091     if $verbose || [[ $myPDSH = *-N* ]]; then
4092         $myPDSH $rnodes "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" $(get_env_vars) sh -c \"$@\")"
4093     else
4094         $myPDSH $rnodes "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" $(get_env_vars) sh -c \"$@\")" | sed -re "s/^[^:]*: //g"
4095     fi
4096     return ${PIPESTATUS[0]}
4097 }
4098
4099 ##
4100 # Execute commands on a single service's host
4101 #
4102 # The \a facet (service) may be on a local or remote node, which is
4103 # determined at the time the command is run.
4104 #
4105 # usage: do_facet $facet command [arg ...]
4106 do_facet() {
4107         local facet=$1
4108         shift
4109         local HOST=$(facet_active_host $facet)
4110         [ -z $HOST ] && echo "No host defined for facet ${facet}" && exit 1
4111         do_node $HOST "$@"
4112 }
4113
4114 # Function: do_facet_random_file $FACET $FILE $SIZE
4115 # Creates FILE with random content on the given FACET of given SIZE
4116
4117 do_facet_random_file() {
4118         local facet="$1"
4119         local fpath="$2"
4120         local fsize="$3"
4121         local cmd="dd if=/dev/urandom of='$fpath' bs=$fsize count=1"
4122         do_facet $facet "$cmd 2>/dev/null"
4123 }
4124
4125 do_facet_create_file() {
4126         local facet="$1"
4127         local fpath="$2"
4128         local fsize="$3"
4129         local cmd="dd if=/dev/zero of='$fpath' bs=$fsize count=1"
4130         do_facet $facet "$cmd 2>/dev/null"
4131 }
4132
4133 do_nodesv() {
4134     do_nodes --verbose "$@"
4135 }
4136
4137 add() {
4138         local facet=$1
4139         shift
4140         # make sure its not already running
4141         stop ${facet} -f
4142         rm -f $TMP/${facet}active
4143         [[ $facet = mds1 ]] && combined_mgs_mds && rm -f $TMP/mgsactive
4144         do_facet ${facet} $MKFS $* || return ${PIPESTATUS[0]}
4145
4146         if [[ $(facet_fstype $facet) == zfs ]]; then
4147                 #
4148                 # After formatting a ZFS target, "cachefile=none" property will
4149                 # be set on the ZFS storage pool so that the pool is not
4150                 # automatically imported on system startup. And then the pool
4151                 # will be exported so as to leave the importing and exporting
4152                 # operations handled by mount_facet() and stop() separately.
4153                 #
4154                 refresh_partition_table $facet $(facet_vdevice $facet)
4155                 disable_zpool_cache $facet
4156                 export_zpool $facet
4157         fi
4158 }
4159
4160 # Device formatted as ost
4161 ostdevname() {
4162         local num=$1
4163         local DEVNAME=OSTDEV$num
4164
4165         local fstype=$(facet_fstype ost$num)
4166
4167         case $fstype in
4168                 ldiskfs )
4169                         local dev=ost${num}_dev
4170                         [[ -n ${!dev} ]] && eval DEVPTR=${!dev} ||
4171                         #if $OSTDEVn isn't defined, default is $OSTDEVBASE + num
4172                         eval DEVPTR=${!DEVNAME:=${OSTDEVBASE}${num}};;
4173                 zfs )
4174                         #try $OSTZFSDEVn - independent of vdev
4175                         DEVNAME=OSTZFSDEV$num
4176                         eval DEVPTR=${!DEVNAME:=${FSNAME}-ost${num}/ost${num}};;
4177                 * )
4178                         error "unknown fstype!";;
4179         esac
4180
4181     echo -n $DEVPTR
4182 }
4183
4184 # Physical device location of data
4185 ostvdevname() {
4186         local num=$1
4187         local DEVNAME
4188         local VDEVPTR
4189
4190         local fstype=$(facet_fstype ost$num)
4191
4192         case $fstype in
4193                 ldiskfs )
4194                         # vdevs are not supported by ldiskfs
4195                         eval VDEVPTR="";;
4196                 zfs )
4197                         #if $OSTDEVn isn't defined, default is $OSTDEVBASE{n}
4198                         # Device formatted by zfs
4199                         DEVNAME=OSTDEV$num
4200                         eval VDEVPTR=${!DEVNAME:=${OSTDEVBASE}${num}};;
4201                 * )
4202                         error "unknown fstype!";;
4203         esac
4204
4205         echo -n $VDEVPTR
4206 }
4207
4208 # Logical device formatted for lustre
4209 mdsdevname() {
4210         local num=$1
4211         local DEVNAME=MDSDEV$num
4212
4213         local fstype=$(facet_fstype mds$num)
4214
4215         case $fstype in
4216                 ldiskfs )
4217                         local dev=mds${num}_dev
4218                         [[ -n ${!dev} ]] && eval DEVPTR=${!dev} ||
4219                         #if $MDSDEVn isn't defined, default is $MDSDEVBASE{n}
4220                         eval DEVPTR=${!DEVNAME:=${MDSDEVBASE}${num}};;
4221                 zfs )
4222                         # try $MDSZFSDEVn - independent of vdev
4223                         DEVNAME=MDSZFSDEV$num
4224                         eval DEVPTR=${!DEVNAME:=${FSNAME}-mdt${num}/mdt${num}};;
4225                 * )
4226                         error "unknown fstype!";;
4227         esac
4228
4229         echo -n $DEVPTR
4230 }
4231
4232 # Physical location of data
4233 mdsvdevname() {
4234         local VDEVPTR=""
4235         local num=$1
4236         local fstype=$(facet_fstype mds$num)
4237
4238         case $fstype in
4239                 ldiskfs )
4240                         # vdevs are not supported by ldiskfs
4241                         eval VDEVPTR="";;
4242                 zfs )
4243                         # if $MDSDEVn isn't defined, default is $MDSDEVBASE{n}
4244                         # Device formatted by ZFS
4245                         local DEVNAME=MDSDEV$num
4246                         eval VDEVPTR=${!DEVNAME:=${MDSDEVBASE}${num}};;
4247                 * )
4248                         error "unknown fstype!";;
4249         esac
4250
4251         echo -n $VDEVPTR
4252 }
4253
4254 mgsdevname() {
4255         local DEVPTR
4256         local fstype=$(facet_fstype mgs)
4257
4258         case $fstype in
4259         ldiskfs )
4260                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
4261                    ( [ -z "$MGSDEV" ] || [ $MGSDEV = $MDSDEV1 ] ); then
4262                         DEVPTR=$(mdsdevname 1)
4263                 else
4264                         [[ -n $mgs_dev ]] && DEVPTR=$mgs_dev ||
4265                         DEVPTR=$MGSDEV
4266                 fi;;
4267         zfs )
4268                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
4269                     ( [ -z "$MGSZFSDEV" ] &&
4270                         [ -z "$MGSDEV" -o "$MGSDEV" = $(mdsvdevname 1) ] ); then
4271                         DEVPTR=$(mdsdevname 1)
4272                 else
4273                         DEVPTR=${MGSZFSDEV:-${FSNAME}-mgs/mgs}
4274                 fi;;
4275         * )
4276                 error "unknown fstype!";;
4277         esac
4278
4279         echo -n $DEVPTR
4280 }
4281
4282 mgsvdevname() {
4283         local VDEVPTR=""
4284
4285         local fstype=$(facet_fstype mgs)
4286
4287         case $fstype in
4288         ldiskfs )
4289                 # vdevs are not supported by ldiskfs
4290                 ;;
4291         zfs )
4292                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
4293                    ( [ -z "$MGSDEV" ] &&
4294                        [ -z "$MGSZFSDEV" -o "$MGSZFSDEV" = $(mdsdevname 1) ]); then
4295                         VDEVPTR=$(mdsvdevname 1)
4296                 elif [ -n "$MGSDEV" ]; then
4297                         VDEVPTR=$MGSDEV
4298                 fi;;
4299         * )
4300                 error "unknown fstype!";;
4301         esac
4302
4303         echo -n $VDEVPTR
4304 }
4305
4306 facet_mntpt () {
4307     local facet=$1
4308     [[ $facet = mgs ]] && combined_mgs_mds && facet="mds1"
4309
4310     local var=${facet}_MOUNT
4311     eval mntpt=${!var:-${MOUNT}-$facet}
4312
4313     echo -n $mntpt
4314 }
4315
4316 mount_ldiskfs() {
4317         local facet=$1
4318         local dev=$(facet_device $facet)
4319         local mnt=${2:-$(facet_mntpt $facet)}
4320         local opts
4321         local dm_dev=$dev
4322
4323         if dm_flakey_supported $facet; then
4324                 dm_dev=$(dm_create_dev $facet $dev)
4325                 [[ -n "$dm_dev" ]] || dm_dev=$dev
4326         fi
4327         is_blkdev $facet $dm_dev || opts=$(csa_add "$opts" -o loop)
4328         export_dm_dev $facet $dm_dev
4329
4330         do_facet $facet mount -t ldiskfs $opts $dm_dev $mnt
4331 }
4332
4333 unmount_ldiskfs() {
4334         local facet=$1
4335         local dev=$(facet_device $facet)
4336         local mnt=${2:-$(facet_mntpt $facet)}
4337
4338         do_facet $facet $UMOUNT $mnt
4339 }
4340
4341 var_name() {
4342         echo -n "$1" | tr -c '[:alnum:]\n' '_'
4343 }
4344
4345 mount_zfs() {
4346         local facet=$1
4347         local ds=$(facet_device $facet)
4348         local mnt=${2:-$(facet_mntpt $facet)}
4349         local canmnt
4350         local mntpt
4351
4352         import_zpool $facet
4353         canmnt=$(do_facet $facet $ZFS get -H -o value canmount $ds)
4354         mntpt=$(do_facet $facet $ZFS get -H -o value mountpoint $ds)
4355         do_facet $facet $ZFS set canmount=noauto $ds
4356         #
4357         # The "legacy" mount method is used here because "zfs unmount $mnt"
4358         # calls stat(2) on $mnt/../*, which may include $MOUNT.  If certain
4359         # targets are not available at the time, the stat(2) on $MOUNT will
4360         # hang.
4361         #
4362         do_facet $facet $ZFS set mountpoint=legacy $ds
4363         do_facet $facet mount -t zfs $ds $mnt
4364         eval export mz_$(var_name ${facet}_$ds)_canmount=$canmnt
4365         eval export mz_$(var_name ${facet}_$ds)_mountpoint=$mntpt
4366 }
4367
4368 unmount_zfs() {
4369         local facet=$1
4370         local ds=$(facet_device $facet)
4371         local mnt=${2:-$(facet_mntpt $facet)}
4372         local var_mntpt=mz_$(var_name ${facet}_$ds)_mountpoint
4373         local var_canmnt=mz_$(var_name ${facet}_$ds)_canmount
4374         local mntpt=${!var_mntpt}
4375         local canmnt=${!var_canmnt}
4376
4377         unset $var_mntpt
4378         unset $var_canmnt
4379         do_facet $facet umount $mnt
4380         do_facet $facet $ZFS set mountpoint=$mntpt $ds
4381         do_facet $facet $ZFS set canmount=$canmnt $ds
4382         export_zpool $facet
4383 }
4384
4385 mount_fstype() {
4386         local facet=$1
4387         local mnt=$2
4388         local fstype=$(facet_fstype $facet)
4389
4390         mount_$fstype $facet $mnt
4391 }
4392
4393 unmount_fstype() {
4394         local facet=$1
4395         local mnt=$2
4396         local fstype=$(facet_fstype $facet)
4397
4398         unmount_$fstype $facet $mnt
4399 }
4400
4401 ########
4402 ## MountConf setup
4403
4404 stopall() {
4405         # make sure we are using the primary server, so test-framework will
4406         # be able to clean up properly.
4407         activemds=`facet_active mds1`
4408         if [ $activemds != "mds1" ]; then
4409                 fail mds1
4410         fi
4411
4412         local clients=$CLIENTS
4413         [ -z $clients ] && clients=$(hostname)
4414
4415         zconf_umount_clients $clients $MOUNT "$*" || true
4416         [ -n "$MOUNT2" ] && zconf_umount_clients $clients $MOUNT2 "$*" || true
4417
4418         [ -n "$CLIENTONLY" ] && return
4419
4420         # The add fn does rm ${facet}active file, this would be enough
4421         # if we use do_facet <facet> only after the facet added, but
4422         # currently we use do_facet mds in local.sh
4423         for num in `seq $MDSCOUNT`; do
4424                 stop mds$num -f
4425                 rm -f ${TMP}/mds${num}active
4426         done
4427         combined_mgs_mds && rm -f $TMP/mgsactive
4428
4429         for num in `seq $OSTCOUNT`; do
4430                 stop ost$num -f
4431                 rm -f $TMP/ost${num}active
4432         done
4433
4434         if ! combined_mgs_mds ; then
4435                 stop mgs
4436         fi
4437
4438         if $SHARED_KEY; then
4439                 export SK_MOUNTED=false
4440         fi
4441
4442         return 0
4443 }
4444
4445 cleanup_echo_devs () {
4446         trap 0
4447         local dev
4448         local devs=$($LCTL dl | grep echo | awk '{print $4}')
4449
4450         for dev in $devs; do
4451                 $LCTL --device $dev cleanup
4452                 $LCTL --device $dev detach
4453         done
4454 }
4455
4456 cleanupall() {
4457         nfs_client_mode && return
4458         cifs_client_mode && return
4459
4460         cleanup_echo_devs
4461         CLEANUP_DM_DEV=true stopall $*
4462
4463         unload_modules
4464         cleanup_sk
4465         cleanup_gss
4466 }
4467
4468 combined_mgs_mds () {
4469         [[ "$(mdsdevname 1)" = "$(mgsdevname)" ]] &&
4470                 [[ "$(facet_host mds1)" = "$(facet_host mgs)" ]]
4471 }
4472
4473 lower() {
4474         echo -n "$1" | tr '[:upper:]' '[:lower:]'
4475 }
4476
4477 upper() {
4478         echo -n "$1" | tr '[:lower:]' '[:upper:]'
4479 }
4480
4481 squash_opt() {
4482         local var="$*"
4483         local other=""
4484         local opt_o=""
4485         local opt_e=""
4486         local first_e=0
4487         local first_o=0
4488         local take=""
4489
4490         var=$(echo "$var" | sed -e 's/,\( \)*/,/g')
4491         for i in $(echo "$var"); do
4492                 if [ "$i" == "-O" ]; then
4493                         take="o";
4494                         first_o=$(($first_o + 1))
4495                         continue;
4496                 fi
4497                 if [ "$i" == "-E" ]; then
4498                         take="e";
4499                         first_e=$(($first_e + 1 ))
4500                         continue;
4501                 fi
4502                 case $take in
4503                         "o")
4504                                 [ $first_o -gt 1 ] && opt_o+=",";
4505                                 opt_o+="$i";
4506                                 ;;
4507                         "e")
4508                                 [ $first_e -gt 1 ] && opt_e+=",";
4509                                 opt_e+="$i";
4510                                 ;;
4511                         *)
4512                                 other+=" $i";
4513                                 ;;
4514                 esac
4515                 take=""
4516         done
4517
4518         echo -n "$other"
4519         [ -n "$opt_o" ] && echo " -O $opt_o"
4520         [ -n "$opt_e" ] && echo " -E $opt_e"
4521 }
4522
4523 mkfs_opts() {
4524         local facet=$1
4525         local dev=$2
4526         local fsname=${3:-"$FSNAME"}
4527         local type=$(facet_type $facet)
4528         local index=$(facet_index $facet)
4529         local fstype=$(facet_fstype $facet)
4530         local host=$(facet_host $facet)
4531         local opts
4532         local fs_mkfs_opts
4533         local var
4534
4535         if [ $type == MGS ] || ( [ $type == MDS ] &&
4536                                  [ "$dev" == $(mgsdevname) ] &&
4537                                  [ "$host" == "$(facet_host mgs)" ] ); then
4538                 opts="--mgs"
4539         else
4540                 opts="--mgsnode=$MGSNID"
4541         fi
4542
4543         if [ $type != MGS ]; then
4544                 opts+=" --fsname=$fsname --$(lower ${type/MDS/MDT}) \
4545                         --index=$index"
4546         fi
4547
4548         var=${facet}failover_HOST
4549         if [ -n "${!var}" ] && [ ${!var} != $(facet_host $facet) ]; then
4550                 opts+=" --failnode=$(h2nettype ${!var})"
4551         fi
4552
4553         opts+=${TIMEOUT:+" --param=sys.timeout=$TIMEOUT"}
4554         opts+=${LDLM_TIMEOUT:+" --param=sys.ldlm_timeout=$LDLM_TIMEOUT"}
4555
4556         if [ $type == MDS ]; then
4557                 opts+=${MDSCAPA:+" --param-mdt.capa=$MDSCAPA"}
4558                 opts+=${DEF_STRIPE_SIZE:+" --param=lov.stripesize=$DEF_STRIPE_SIZE"}
4559                 opts+=${DEF_STRIPE_COUNT:+" --param=lov.stripecount=$DEF_STRIPE_COUNT"}
4560                 opts+=${L_GETIDENTITY:+" --param=mdt.identity_upcall=$L_GETIDENTITY"}
4561
4562                 if [ $fstype == ldiskfs ]; then
4563                         fs_mkfs_opts+="-O ea_inode,large_dir"
4564
4565                         var=${facet}_JRN
4566                         if [ -n "${!var}" ]; then
4567                                 fs_mkfs_opts+=" -J device=${!var}"
4568                         else
4569                                 fs_mkfs_opts+=${MDSJOURNALSIZE:+" -J size=$MDSJOURNALSIZE"}
4570                         fi
4571                         fs_mkfs_opts+=${MDSISIZE:+" -i $MDSISIZE"}
4572                 fi
4573         fi
4574
4575         if [ $type == OST ]; then
4576                 opts+=${OSSCAPA:+" --param=ost.capa=$OSSCAPA"}
4577
4578                 if [ $fstype == ldiskfs ]; then
4579                         var=${facet}_JRN
4580                         if [ -n "${!var}" ]; then
4581                                 fs_mkfs_opts+=" -J device=${!var}"
4582                         else
4583                                 fs_mkfs_opts+=${OSTJOURNALSIZE:+" -J size=$OSTJOURNALSIZE"}
4584                         fi
4585                 fi
4586         fi
4587
4588         opts+=" --backfstype=$fstype"
4589
4590         var=${type}SIZE
4591         if [ -n "${!var}" ]; then
4592                 opts+=" --device-size=${!var}"
4593         fi
4594
4595         var=$(upper $fstype)_MKFS_OPTS
4596         fs_mkfs_opts+=${!var:+" ${!var}"}
4597
4598         var=${type}_FS_MKFS_OPTS
4599         fs_mkfs_opts+=${!var:+" ${!var}"}
4600
4601         [ $fstype == ldiskfs ] && fs_mkfs_opts=$(squash_opt $fs_mkfs_opts)
4602
4603         if [ -n "${fs_mkfs_opts## }" ]; then
4604                 opts+=" --mkfsoptions=\\\"${fs_mkfs_opts## }\\\""
4605         fi
4606
4607         var=${type}OPT
4608         opts+=${!var:+" ${!var}"}
4609
4610         echo -n "$opts"
4611 }
4612
4613 mountfs_opts() {
4614         local facet=$1
4615         local type=$(facet_type $facet)
4616         local var=${type}_MOUNT_FS_OPTS
4617         local opts=""
4618         if [ -n "${!var}" ]; then
4619                 opts+=" --mountfsoptions=${!var}"
4620         fi
4621         echo -n "$opts"
4622 }
4623
4624 check_ost_indices() {
4625         local index_count=${#OST_INDICES[@]}
4626         [[ $index_count -eq 0 || $OSTCOUNT -le $index_count ]] && return 0
4627
4628         # OST count is greater than the index count in $OST_INDEX_LIST.
4629         # We need check whether there are duplicate indices.
4630         local i
4631         local j
4632         local index
4633         for i in $(seq $((index_count + 1)) $OSTCOUNT); do
4634                 index=$(facet_index ost$i)
4635                 for j in $(seq 0 $((index_count - 1))); do
4636                         [[ $index -ne ${OST_INDICES[j]} ]] ||
4637                         error "ost$i has the same index $index as ost$((j+1))"
4638                 done
4639         done
4640 }
4641
4642 __touch_device()
4643 {
4644         local facet_type=$1 # mgs || mds || ost
4645         local facet_num=$2
4646         local facet=${1}${2}
4647         local device
4648
4649         case "$(facet_fstype $facet)" in
4650         ldiskfs)
4651                 device=$(${facet_type}devname $facet_num)
4652                 ;;
4653         zfs)
4654                 device=$(${facet_type}vdevname $facet_num)
4655                 ;;
4656         *)
4657                 error "Unhandled filesystem type"
4658                 ;;
4659         esac
4660
4661         do_facet $facet "[ -e \"$device\" ]" && return
4662
4663         # Note: the following check only works with absolute paths
4664         [[ ! "$device" =~ ^/dev/ ]] || [[ "$device" =~ ^/dev/shm/ ]] ||
4665                 error "$facet: device '$device' does not exist"
4666
4667         # zpool create doesn't like empty files
4668         [[ $(facet_fstype $facet) == zfs ]] && return 0
4669
4670         do_facet $facet "touch \"${device}\""
4671 }
4672
4673 format_mgs() {
4674         local quiet
4675
4676         if ! $VERBOSE; then
4677                 quiet=yes
4678         fi
4679         echo "Format mgs: $(mgsdevname)"
4680         reformat_external_journal mgs
4681
4682         # touch "device" in case it is a loopback file for testing and needs to
4683         # be created. mkfs.lustre doesn't do this to avoid accidentally writing
4684         # to non-existent files in /dev if the admin made a typo during setup
4685         __touch_device mgs
4686
4687         add mgs $(mkfs_opts mgs $(mgsdevname)) $(mountfs_opts mgs) --reformat \
4688                 $(mgsdevname) $(mgsvdevname) ${quiet:+>/dev/null} || exit 10
4689 }
4690
4691 format_mdt() {
4692         local num=$1
4693         local quiet
4694
4695         if ! $VERBOSE; then
4696                 quiet=yes
4697         fi
4698         echo "Format mds$num: $(mdsdevname $num)"
4699         reformat_external_journal mds$num
4700
4701         __touch_device mds $num
4702
4703         add mds$num $(mkfs_opts mds$num $(mdsdevname ${num})) \
4704                 $(mountfs_opts mds$num) --reformat $(mdsdevname $num) \
4705                 $(mdsvdevname $num) ${quiet:+>/dev/null} || exit 10
4706 }
4707
4708 format_ost() {
4709         local num=$1
4710
4711         if ! $VERBOSE; then
4712                 quiet=yes
4713         fi
4714         echo "Format ost$num: $(ostdevname $num)"
4715         reformat_external_journal ost$num
4716
4717         __touch_device ost $num
4718
4719         add ost$num $(mkfs_opts ost$num $(ostdevname ${num})) \
4720                 $(mountfs_opts ost$num) --reformat $(ostdevname $num) \
4721                 $(ostvdevname ${num}) ${quiet:+>/dev/null} || exit 10
4722 }
4723
4724 formatall() {
4725         stopall -f
4726         # Set hostid for ZFS/SPL zpool import protection
4727         # (Assumes MDS version is also OSS version)
4728         if [ $(lustre_version_code $SINGLEMDS) -ge $(version_code 2.8.54) ];
4729         then
4730                 do_rpc_nodes "$(comma_list $(all_server_nodes))" set_hostid
4731         fi
4732
4733         # We need ldiskfs here, may as well load them all
4734         load_modules
4735         [ -n "$CLIENTONLY" ] && return
4736         echo Formatting mgs, mds, osts
4737         if ! combined_mgs_mds ; then
4738                 format_mgs
4739         fi
4740
4741         for num in $(seq $MDSCOUNT); do
4742                 format_mdt $num
4743         done
4744
4745         export OST_INDICES=($(hostlist_expand "$OST_INDEX_LIST"))
4746         check_ost_indices
4747         for num in $(seq $OSTCOUNT); do
4748                 format_ost $num
4749         done
4750 }
4751
4752 mount_client() {
4753         grep " $1 " /proc/mounts || zconf_mount $HOSTNAME $*
4754 }
4755
4756 umount_client() {
4757         grep " $1 " /proc/mounts && zconf_umount $HOSTNAME $*
4758 }
4759
4760 # return value:
4761 # 0: success, the old identity set already.
4762 # 1: success, the old identity does not set.
4763 # 2: fail.
4764 switch_identity() {
4765     local num=$1
4766     local switch=$2
4767     local j=`expr $num - 1`
4768     local MDT="`(do_facet mds$num lctl get_param -N mdt.*MDT*$j 2>/dev/null | cut -d"." -f2 2>/dev/null) || true`"
4769
4770     if [ -z "$MDT" ]; then
4771         return 2
4772     fi
4773
4774     local old="`do_facet mds$num "lctl get_param -n mdt.$MDT.identity_upcall"`"
4775
4776     if $switch; then
4777         do_facet mds$num "lctl set_param -n mdt.$MDT.identity_upcall \"$L_GETIDENTITY\""
4778     else
4779         do_facet mds$num "lctl set_param -n mdt.$MDT.identity_upcall \"NONE\""
4780     fi
4781
4782     do_facet mds$num "lctl set_param -n mdt/$MDT/identity_flush=-1"
4783
4784     if [ $old = "NONE" ]; then
4785         return 1
4786     else
4787         return 0
4788     fi
4789 }
4790
4791 remount_client()
4792 {
4793         zconf_umount $HOSTNAME $1 || error "umount failed"
4794         zconf_mount $HOSTNAME $1 || error "mount failed"
4795 }
4796
4797 writeconf_facet() {
4798         local facet=$1
4799         local dev=$2
4800
4801         stop ${facet} -f
4802         rm -f $TMP/${facet}active
4803         do_facet ${facet} "$TUNEFS --quiet --writeconf $dev" || return 1
4804         return 0
4805 }
4806
4807 writeconf_all () {
4808         local mdt_count=${1:-$MDSCOUNT}
4809         local ost_count=${2:-$OSTCOUNT}
4810         local rc=0
4811
4812         for num in $(seq $mdt_count); do
4813                 DEVNAME=$(mdsdevname $num)
4814                 writeconf_facet mds$num $DEVNAME || rc=$?
4815         done
4816
4817         for num in $(seq $ost_count); do
4818                 DEVNAME=$(ostdevname $num)
4819                 writeconf_facet ost$num $DEVNAME || rc=$?
4820         done
4821         return $rc
4822 }
4823
4824 mountmgs() {
4825         if ! combined_mgs_mds ; then
4826                 start mgs $(mgsdevname) $MGS_MOUNT_OPTS
4827         fi
4828 }
4829
4830 mountmds() {
4831         local num
4832         local devname
4833         local host
4834         local varname
4835         for num in $(seq $MDSCOUNT); do
4836                 devname=$(mdsdevname $num)
4837                 start mds$num $devname $MDS_MOUNT_OPTS
4838
4839                 # We started mds$num, now we should set mds${num}_HOST
4840                 # and mds${num}failover_HOST variables properly if they
4841                 # are not set.
4842                 host=$(facet_host mds$num)
4843                 for varname in mds${num}_HOST mds${num}failover_HOST; do
4844                         if [[ -z "${!varname}" ]]; then
4845                                 eval $varname=$host
4846                         fi
4847                 done
4848                 if [ $IDENTITY_UPCALL != "default" ]; then
4849                         switch_identity $num $IDENTITY_UPCALL
4850                 fi
4851         done
4852 }
4853
4854 mountoss() {
4855         local num
4856         local devname
4857         local host
4858         local varname
4859         for num in $(seq $OSTCOUNT); do
4860                 devname=$(ostdevname $num)
4861                 start ost$num $devname $OST_MOUNT_OPTS
4862
4863                 # We started ost$num, now we should set ost${num}_HOST
4864                 # and ost${num}failover_HOST variables properly if they
4865                 # are not set.
4866                 host=$(facet_host ost$num)
4867                 for varname in ost${num}_HOST ost${num}failover_HOST; do
4868                         if [[ -z "${!varname}" ]]; then
4869                                 eval $varname=$host
4870                         fi
4871                 done
4872         done
4873 }
4874
4875 mountcli() {
4876         [ "$DAEMONFILE" ] && $LCTL debug_daemon start $DAEMONFILE $DAEMONSIZE
4877         if [ ! -z $arg1 ]; then
4878                 [ "$arg1" = "server_only" ] && return
4879         fi
4880         mount_client $MOUNT
4881         if [ -n "$CLIENTS" ]; then
4882                 zconf_mount_clients $CLIENTS $MOUNT
4883         fi
4884         clients_up
4885
4886         if [ "$MOUNT_2" ]; then
4887                 mount_client $MOUNT2
4888                 if [ -n "$CLIENTS" ]; then
4889                         zconf_mount_clients $CLIENTS $MOUNT2
4890                 fi
4891         fi
4892 }
4893
4894 sk_nodemap_setup() {
4895         local sk_map_name=${1:-$SK_S2SNM}
4896         local sk_map_nodes=${2:-$HOSTNAME}
4897         do_node $(mgs_node) "$LCTL nodemap_add $sk_map_name"
4898         for servernode in $sk_map_nodes; do
4899                 local nids=$(do_nodes $servernode "$LCTL list_nids")
4900                 for nid in $nids; do
4901                         do_node $(mgs_node) "$LCTL nodemap_add_range --name \
4902                                 $sk_map_name --range $nid"
4903                 done
4904         done
4905 }
4906
4907 setupall() {
4908         local arg1=$1
4909
4910         nfs_client_mode && return
4911         cifs_client_mode && return
4912
4913         sanity_mount_check || error "environments are insane!"
4914
4915         load_modules
4916
4917         init_gss
4918
4919         if [ -z "$CLIENTONLY" ]; then
4920                 echo Setup mgs, mdt, osts
4921                 echo $WRITECONF | grep -q "writeconf" && writeconf_all
4922
4923                 if $SK_MOUNTED; then
4924                         echo "Shared Key file system already mounted"
4925                 else
4926                         mountmgs
4927                         mountmds
4928                         mountoss
4929                         if $SHARED_KEY; then
4930                                 export SK_MOUNTED=true
4931                         fi
4932                 fi
4933                 if $GSS_SK; then
4934                         echo "GSS_SK: setting kernel keyring perms"
4935                         do_nodes $(comma_list $(all_nodes)) \
4936                                 "keyctl show | grep lustre | cut -c1-11 |
4937                                 sed -e 's/ //g;' |
4938                                 xargs -IX keyctl setperm X 0x3f3f3f3f"
4939
4940                         if $SK_S2S; then
4941                                 # Need to start one nodemap for servers,
4942                                 # and one for clients.
4943                                 sk_nodemap_setup $SK_S2SNM \
4944                                         $(comma_list $(all_server_nodes))
4945                                 mountcli
4946                                 sk_nodemap_setup $SK_S2SNMCLI \
4947                                         ${CLIENTS:-$HOSTNAME}
4948                                 echo "Nodemap set up for SK S2S, remounting."
4949                                 stopall
4950                                 mountmgs
4951                                 mountmds
4952                                 mountoss
4953                         fi
4954                 fi
4955         fi
4956
4957         # wait a while to allow sptlrpc configuration be propogated to targets,
4958         # only needed when mounting new target devices.
4959         if $GSS; then
4960                 sleep 10
4961         fi
4962
4963         mountcli
4964         init_param_vars
4965
4966         # by remounting mdt before ost, initial connect from mdt to ost might
4967         # timeout because ost is not ready yet. wait some time to its fully
4968         # recovery. initial obd_connect timeout is 5s; in GSS case it's
4969         # preceeded by a context negotiation rpc with $TIMEOUT.
4970         # FIXME better by monitoring import status.
4971         if $GSS; then
4972                 if $GSS_SK; then
4973                         set_rule $FSNAME any cli2mdt $SK_FLAVOR
4974                         set_rule $FSNAME any cli2ost $SK_FLAVOR
4975                         if $SK_SKIPFIRST; then
4976                                 export SK_SKIPFIRST=false
4977
4978                                 sleep 30
4979                                 do_nodes $CLIENTS \
4980                                          "lctl set_param osc.*.idle_connect=1"
4981                                 return
4982                         else
4983                                 wait_flavor cli2mdt $SK_FLAVOR
4984                                 wait_flavor cli2ost $SK_FLAVOR
4985                         fi
4986                 else
4987                         set_flavor_all $SEC
4988                 fi
4989                 sleep $((TIMEOUT + 5))
4990         else
4991                 sleep 5
4992         fi
4993 }
4994
4995 mounted_lustre_filesystems() {
4996         awk '($3 ~ "lustre" && $1 ~ ":") { print $2 }' /proc/mounts
4997 }
4998
4999 init_facet_vars () {
5000         [ -n "$CLIENTONLY" ] && return 0
5001         local facet=$1
5002         shift
5003         local device=$1
5004
5005         shift
5006
5007         eval export ${facet}_dev=${device}
5008         eval export ${facet}_opt=\"$@\"
5009
5010         local dev=${facet}_dev
5011
5012         # We need to loop for the label
5013         # in case its not initialized yet.
5014         for wait_time in {0,1,3,5,10}; do
5015
5016                 if [ $wait_time -gt 0 ]; then
5017                         echo "${!dev} not yet initialized,"\
5018                                 "waiting ${wait_time} seconds."
5019                         sleep $wait_time
5020                 fi
5021
5022                 local label=$(devicelabel ${facet} ${!dev})
5023
5024                 # Check to make sure the label does
5025                 # not include ffff at the end of the label.
5026                 # This indicates it has not been initialized yet.
5027
5028                 if [[ $label =~ [f|F]{4}$ ]]; then
5029                         # label is not initialized, unset the result
5030                         # and either try again or fail
5031                         unset label
5032                 else
5033                         break
5034                 fi
5035         done
5036
5037         [ -z "$label" ] && echo no label for ${!dev} && exit 1
5038
5039         eval export ${facet}_svc=${label}
5040
5041         local varname=${facet}failover_HOST
5042         if [ -z "${!varname}" ]; then
5043                 eval export $varname=$(facet_host $facet)
5044         fi
5045
5046         varname=${facet}_HOST
5047         if [ -z "${!varname}" ]; then
5048                 eval export $varname=$(facet_host $facet)
5049         fi
5050
5051         # ${facet}failover_dev is set in cfg file
5052         varname=${facet}failover_dev
5053         if [ -n "${!varname}" ] ; then
5054                 eval export ${facet}failover_dev=${!varname}
5055         else
5056                 eval export ${facet}failover_dev=$device
5057         fi
5058
5059         # get mount point of already mounted device
5060         # is facet_dev is already mounted then use the real
5061         #  mount point of this facet; otherwise use $(facet_mntpt $facet)
5062         # i.e. ${facet}_MOUNT if specified by user or default
5063         local mntpt=$(do_facet ${facet} cat /proc/mounts | \
5064                         awk '"'${!dev}'" == $1 && $3 == "lustre" { print $2 }')
5065         if [ -z $mntpt ]; then
5066                 mntpt=$(facet_mntpt $facet)
5067         fi
5068         eval export ${facet}_MOUNT=$mntpt
5069 }
5070
5071 init_facets_vars () {
5072         local DEVNAME
5073
5074         if ! remote_mds_nodsh; then
5075                 for num in $(seq $MDSCOUNT); do
5076                         DEVNAME=`mdsdevname $num`
5077                         init_facet_vars mds$num $DEVNAME $MDS_MOUNT_OPTS
5078                 done
5079         fi
5080
5081         combined_mgs_mds || init_facet_vars mgs $(mgsdevname) $MGS_MOUNT_OPTS
5082
5083         if ! remote_ost_nodsh; then
5084                 for num in $(seq $OSTCOUNT); do
5085                         DEVNAME=$(ostdevname $num)
5086                         init_facet_vars ost$num $DEVNAME $OST_MOUNT_OPTS
5087                 done
5088         fi
5089 }
5090
5091 init_facets_vars_simple () {
5092         local devname
5093
5094         if ! remote_mds_nodsh; then
5095                 for num in $(seq $MDSCOUNT); do
5096                         devname=$(mdsdevname $num)
5097                         eval export mds${num}_dev=${devname}
5098                         eval export mds${num}_opt=\"${MDS_MOUNT_OPTS}\"
5099                 done
5100         fi
5101
5102         if ! combined_mgs_mds ; then
5103                 eval export mgs_dev=$(mgsdevname)
5104                 eval export mgs_opt=\"${MGS_MOUNT_OPTS}\"
5105         fi
5106
5107         if ! remote_ost_nodsh; then
5108                 for num in $(seq $OSTCOUNT); do
5109                         devname=$(ostdevname $num)
5110                         eval export ost${num}_dev=${devname}
5111                         eval export ost${num}_opt=\"${OST_MOUNT_OPTS}\"
5112                 done
5113         fi
5114 }
5115
5116 osc_ensure_active () {
5117     local facet=$1
5118     local timeout=$2
5119     local period=0
5120
5121     while [ $period -lt $timeout ]; do
5122         count=$(do_facet $facet "lctl dl | grep ' IN osc ' 2>/dev/null | wc -l")
5123         if [ $count -eq 0 ]; then
5124             break
5125         fi
5126
5127         echo "There are $count OST are inactive, wait $period seconds, and try again"
5128         sleep 3
5129         period=$((period+3))
5130     done
5131
5132     [ $period -lt $timeout ] || log "$count OST are inactive after $timeout seconds, give up"
5133 }
5134
5135 set_conf_param_and_check() {
5136         local myfacet=$1
5137         local TEST=$2
5138         local PARAM=$3
5139         local ORIG=$(do_facet $myfacet "$TEST")
5140         if [ $# -gt 3 ]; then
5141                 local FINAL=$4
5142         else
5143                 local -i FINAL
5144                 FINAL=$((ORIG + 5))
5145         fi
5146         echo "Setting $PARAM from $ORIG to $FINAL"
5147         do_facet mgs "$LCTL conf_param $PARAM='$FINAL'" ||
5148                 error "conf_param $PARAM failed"
5149
5150         wait_update_facet $myfacet "$TEST" "$FINAL" ||
5151                 error "check $PARAM failed!"
5152 }
5153
5154 set_persistent_param() {
5155         local myfacet=$1
5156         local test_param=$2
5157         local param=$3
5158         local orig=$(do_facet $myfacet "$LCTL get_param -n $test_param")
5159
5160         if [ $# -gt 3 ]; then
5161                 local final=$4
5162         else
5163                 local -i final
5164                 final=$((orig + 5))
5165         fi
5166
5167         if [[ $PERM_CMD == *"set_param -P"* ]]; then
5168                 echo "Setting $test_param from $orig to $final"
5169                 do_facet mgs "$PERM_CMD $test_param='$final'" ||
5170                         error "$PERM_CMD $test_param failed"
5171         else
5172                 echo "Setting $param from $orig to $final"
5173                 do_facet mgs "$PERM_CMD $param='$final'" ||
5174                         error "$PERM_CMD $param failed"
5175         fi
5176 }
5177
5178 set_persistent_param_and_check() {
5179         local myfacet=$1
5180         local test_param=$2
5181         local param=$3
5182         local orig=$(do_facet $myfacet "$LCTL get_param -n $test_param")
5183
5184         if [ $# -gt 3 ]; then
5185                 local final=$4
5186         else
5187                 local -i final
5188                 final=$((orig + 5))
5189         fi
5190
5191         set_persistent_param $myfacet $test_param $param "$final"
5192
5193         wait_update_facet $myfacet "$LCTL get_param -n $test_param" "$final" ||
5194                 error "check $param failed!"
5195 }
5196
5197 init_param_vars () {
5198         TIMEOUT=$(lctl get_param -n timeout)
5199         TIMEOUT=${TIMEOUT:-20}
5200
5201         if [ -n "$arg1" ]; then
5202                 [ "$arg1" = "server_only" ] && return
5203         fi
5204
5205         remote_mds_nodsh && log "Using TIMEOUT=$TIMEOUT" && return 0
5206
5207         TIMEOUT=$(do_facet $SINGLEMDS "lctl get_param -n timeout")
5208         log "Using TIMEOUT=$TIMEOUT"
5209
5210         osc_ensure_active $SINGLEMDS $TIMEOUT
5211         osc_ensure_active client $TIMEOUT
5212         $LCTL set_param osc.*.idle_timeout=debug
5213
5214         if [ -n "$(lctl get_param -n mdc.*.connect_flags|grep jobstats)" ]; then
5215                 local current_jobid_var=$($LCTL get_param -n jobid_var)
5216
5217                 if [ $JOBID_VAR = "existing" ]; then
5218                         echo "keeping jobstats as $current_jobid_var"
5219                 elif [ $current_jobid_var != $JOBID_VAR ]; then
5220                         echo "setting jobstats to $JOBID_VAR"
5221
5222                         set_persistent_param_and_check client \
5223                                 "jobid_var" "$FSNAME.sys.jobid_var" $JOBID_VAR
5224                 fi
5225         else
5226                 echo "jobstats not supported by server"
5227         fi
5228
5229         if [ $QUOTA_AUTO -ne 0 ]; then
5230                 if [ "$ENABLE_QUOTA" ]; then
5231                         echo "enable quota as required"
5232                         setup_quota $MOUNT || return 2
5233                 else
5234                         echo "disable quota as required"
5235                         # $LFS quotaoff -ug $MOUNT > /dev/null 2>&1
5236                 fi
5237         fi
5238
5239         (( MDS1_VERSION <= $(version_code 2.13.52) )) ||
5240                 do_nodes $(comma_list $(mdts_nodes)) \
5241                         "$LCTL set_param lod.*.mdt_hash=crush"
5242         return 0
5243 }
5244
5245 nfs_client_mode () {
5246     if [ "$NFSCLIENT" ]; then
5247         echo "NFSCLIENT mode: setup, cleanup, check config skipped"
5248         local clients=$CLIENTS
5249         [ -z $clients ] && clients=$(hostname)
5250
5251         # FIXME: remove hostname when 19215 fixed
5252         do_nodes $clients "echo \\\$(hostname); grep ' '$MOUNT' ' /proc/mounts"
5253         declare -a nfsexport=(`grep ' '$MOUNT' ' /proc/mounts | awk '{print $1}' | awk -F: '{print $1 " "  $2}'`)
5254         if [[ ${#nfsexport[@]} -eq 0 ]]; then
5255                 error_exit NFSCLIENT=$NFSCLIENT mode, but no NFS export found!
5256         fi
5257         do_nodes ${nfsexport[0]} "echo \\\$(hostname); df -T  ${nfsexport[1]}"
5258         return
5259     fi
5260     return 1
5261 }
5262
5263 cifs_client_mode () {
5264         [ x$CIFSCLIENT = xyes ] &&
5265                 echo "CIFSCLIENT=$CIFSCLIENT mode: setup, cleanup, check config skipped"
5266 }
5267
5268 check_config_client () {
5269     local mntpt=$1
5270
5271     local mounted=$(mount | grep " $mntpt ")
5272     if [ -n "$CLIENTONLY" ]; then
5273         # bug 18021
5274         # CLIENTONLY should not depend on *_HOST settings
5275         local mgc=$($LCTL device_list | awk '/MGC/ {print $4}')
5276         # in theory someone could create a new,
5277         # client-only config file that assumed lustre was already
5278         # configured and didn't set the MGSNID. If MGSNID is not set,
5279         # then we should use the mgs nid currently being used
5280         # as the default value. bug 18021
5281         [[ x$MGSNID = x ]] &&
5282             MGSNID=${mgc//MGC/}
5283
5284         if [[ x$mgc != xMGC$MGSNID ]]; then
5285             if [ "$mgs_HOST" ]; then
5286                 local mgc_ip=$(ping -q -c1 -w1 $mgs_HOST | grep PING | awk '{print $3}' | sed -e "s/(//g" -e "s/)//g")
5287 #                [[ x$mgc = xMGC$mgc_ip@$NETTYPE ]] ||
5288 #                    error_exit "MGSNID=$MGSNID, mounted: $mounted, MGC : $mgc"
5289             fi
5290         fi
5291         return 0
5292     fi
5293
5294     echo Checking config lustre mounted on $mntpt
5295     local mgshost=$(mount | grep " $mntpt " | awk -F@ '{print $1}')
5296     mgshost=$(echo $mgshost | awk -F: '{print $1}')
5297
5298 }
5299
5300 check_config_clients () {
5301         local clients=${CLIENTS:-$HOSTNAME}
5302         local mntpt=$1
5303
5304         nfs_client_mode && return
5305         cifs_client_mode && return
5306
5307         do_rpc_nodes "$clients" check_config_client $mntpt
5308
5309         sanity_mount_check || error "environments are insane!"
5310 }
5311
5312 check_timeout () {
5313     local mdstimeout=$(do_facet $SINGLEMDS "lctl get_param -n timeout")
5314     local cltimeout=$(lctl get_param -n timeout)
5315     if [ $mdstimeout -ne $TIMEOUT ] || [ $mdstimeout -ne $cltimeout ]; then
5316         error "timeouts are wrong! mds: $mdstimeout, client: $cltimeout, TIMEOUT=$TIMEOUT"
5317         return 1
5318     fi
5319 }
5320
5321 is_mounted () {
5322         local mntpt=$1
5323         [ -z $mntpt ] && return 1
5324         local mounted=$(mounted_lustre_filesystems)
5325
5326         echo $mounted' ' | grep -w -q $mntpt' '
5327 }
5328
5329 is_empty_dir() {
5330         [ $(find $1 -maxdepth 1 -print | wc -l) = 1 ] && return 0
5331         return 1
5332 }
5333
5334 # empty lustre filesystem may have empty directories lost+found and .lustre
5335 is_empty_fs() {
5336         # exclude .lustre & lost+found
5337         [ $(find $1 -maxdepth 1 -name lost+found -o -name .lustre -prune -o \
5338                 -print | wc -l) = 1 ] || return 1
5339         [ ! -d $1/lost+found ] || is_empty_dir $1/lost+found || return 1
5340         if [ $(lustre_version_code $SINGLEMDS) -gt $(version_code 2.4.0) ]; then
5341                 # exclude .lustre/fid (LU-2780)
5342                 [ $(find $1/.lustre -maxdepth 1 -name fid -prune -o \
5343                         -print | wc -l) = 1 ] || return 1
5344         else
5345                 [ ! -d $1/.lustre ] || is_empty_dir $1/.lustre || return 1
5346         fi
5347         return 0
5348 }
5349
5350 check_and_setup_lustre() {
5351         sanitize_parameters
5352         nfs_client_mode && return
5353         cifs_client_mode && return
5354
5355         local MOUNTED=$(mounted_lustre_filesystems)
5356
5357         local do_check=true
5358         # 1.
5359         # both MOUNT and MOUNT2 are not mounted
5360         if ! is_mounted $MOUNT && ! is_mounted $MOUNT2; then
5361                 [ "$REFORMAT" = "yes" ] && CLEANUP_DM_DEV=true formatall
5362                 # setupall mounts both MOUNT and MOUNT2 (if MOUNT_2 is set)
5363                 setupall
5364                 is_mounted $MOUNT || error "NAME=$NAME not mounted"
5365                 export I_MOUNTED=yes
5366                 do_check=false
5367     # 2.
5368     # MOUNT2 is mounted
5369     elif is_mounted $MOUNT2; then
5370             # 3.
5371             # MOUNT2 is mounted, while MOUNT_2 is not set
5372             if ! [ "$MOUNT_2" ]; then
5373                 cleanup_mount $MOUNT2
5374                 export I_UMOUNTED2=yes
5375
5376             # 4.
5377             # MOUNT2 is mounted, MOUNT_2 is set
5378             else
5379                 # FIXME: what to do if check_config failed?
5380                 # i.e. if:
5381                 # 1) remote client has mounted other Lustre fs ?
5382                 # 2) it has insane env ?
5383                 # let's try umount MOUNT2 on all clients and mount it again:
5384                 if ! check_config_clients $MOUNT2; then
5385                     cleanup_mount $MOUNT2
5386                     restore_mount $MOUNT2
5387                     export I_MOUNTED2=yes
5388                 fi
5389             fi
5390
5391     # 5.
5392     # MOUNT is mounted MOUNT2 is not mounted
5393     elif [ "$MOUNT_2" ]; then
5394         restore_mount $MOUNT2
5395         export I_MOUNTED2=yes
5396     fi
5397
5398     if $do_check; then
5399         # FIXME: what to do if check_config failed?
5400         # i.e. if:
5401         # 1) remote client has mounted other Lustre fs?
5402         # 2) lustre is mounted on remote_clients atall ?
5403         check_config_clients $MOUNT
5404         init_facets_vars
5405         init_param_vars
5406
5407         set_default_debug_nodes $(comma_list $(nodes_list))
5408     fi
5409
5410         if [ -z "$CLIENTONLY" -a $(lower $OSD_TRACK_DECLARES_LBUG) == 'yes' ]; then
5411                 local facets=""
5412                 [ "$(facet_fstype ost1)" = "ldiskfs" ] &&
5413                         facets="$(get_facets OST)"
5414                 [ "$(facet_fstype mds1)" = "ldiskfs" ] &&
5415                         facets="$facets,$(get_facets MDS)"
5416                 [ "$(facet_fstype mgs)" = "ldiskfs" ] &&
5417                         facets="$facets,mgs"
5418                 local nodes="$(facets_hosts ${facets})"
5419                 if [ -n "$nodes" ] ; then
5420                         do_nodes $nodes "$LCTL set_param \
5421                                  osd-ldiskfs.track_declares_assert=1 || true"
5422                 fi
5423         fi
5424
5425         if [ -n "$fs_STRIPEPARAMS" ]; then
5426                 setstripe_getstripe $MOUNT $fs_STRIPEPARAMS
5427         fi
5428         if $GSS_SK; then
5429                 set_flavor_all null
5430         elif $GSS; then
5431                 set_flavor_all $SEC
5432         fi
5433
5434         if [ "$ONLY" == "setup" ]; then
5435                 exit 0
5436         fi
5437 }
5438
5439 restore_mount () {
5440    local clients=${CLIENTS:-$HOSTNAME}
5441    local mntpt=$1
5442
5443    zconf_mount_clients $clients $mntpt
5444 }
5445
5446 cleanup_mount () {
5447         local clients=${CLIENTS:-$HOSTNAME}
5448         local mntpt=$1
5449
5450         zconf_umount_clients $clients $mntpt
5451 }
5452
5453 cleanup_and_setup_lustre() {
5454     if [ "$ONLY" == "cleanup" -o "`mount | grep $MOUNT`" ]; then
5455         lctl set_param debug=0 || true
5456         cleanupall
5457         if [ "$ONLY" == "cleanup" ]; then
5458             exit 0
5459         fi
5460     fi
5461     check_and_setup_lustre
5462 }
5463
5464 # Get all of the server target devices from a given server node and type.
5465 get_mnt_devs() {
5466         local node=$1
5467         local type=$2
5468         local devs
5469         local dev
5470
5471         if [ "$type" == ost ]; then
5472                 devs=$(get_osd_param $node "" mntdev)
5473         else
5474                 devs=$(do_node $node $LCTL get_param -n osd-*.$FSNAME-M*.mntdev)
5475         fi
5476         for dev in $devs; do
5477                 case $dev in
5478                 *loop*) do_node $node "losetup $dev" | \
5479                                 sed -e "s/.*(//" -e "s/).*//" ;;
5480                 *) echo $dev ;;
5481                 esac
5482         done
5483 }
5484
5485 # Get all of the server target devices.
5486 get_svr_devs() {
5487         local node
5488         local i
5489
5490         # Master MDS parameters used by lfsck
5491         MDTNODE=$(facet_active_host $SINGLEMDS)
5492         MDTDEV=$(echo $(get_mnt_devs $MDTNODE mdt) | awk '{print $1}')
5493
5494         # MDT devices
5495         i=0
5496         for node in $(mdts_nodes); do
5497                 MDTDEVS[i]=$(get_mnt_devs $node mdt)
5498                 i=$((i + 1))
5499         done
5500
5501         # OST devices
5502         i=0
5503         for node in $(osts_nodes); do
5504                 OSTDEVS[i]=$(get_mnt_devs $node ost)
5505                 i=$((i + 1))
5506         done
5507 }
5508
5509 # Run e2fsck on MDT or OST device.
5510 run_e2fsck() {
5511         local node=$1
5512         local target_dev=$2
5513         local extra_opts=$3
5514         local cmd="$E2FSCK -d -v -t -t -f $extra_opts $target_dev"
5515         local log=$TMP/e2fsck.log
5516         local rc=0
5517
5518         echo $cmd
5519         do_node $node $cmd 2>&1 | tee $log
5520         rc=${PIPESTATUS[0]}
5521         if [ -n "$(grep "DNE mode isn't supported" $log)" ]; then
5522                 rm -f $log
5523                 if [ $MDSCOUNT -gt 1 ]; then
5524                         skip_noexit "DNE mode isn't supported!"
5525                         cleanupall
5526                         exit_status
5527                 else
5528                         error "It's not DNE mode."
5529                 fi
5530         fi
5531         rm -f $log
5532
5533         [ $rc -le $FSCK_MAX_ERR ] ||
5534                 error "$cmd returned $rc, should be <= $FSCK_MAX_ERR"
5535
5536         return 0
5537 }
5538
5539 #
5540 # Run resize2fs on MDT or OST device.
5541 #
5542 run_resize2fs() {
5543         local facet=$1
5544         local device=$2
5545         local size=$3
5546         shift 3
5547         local opts="$@"
5548
5549         do_facet $facet "$RESIZE2FS $opts $device $size"
5550 }
5551
5552 # verify a directory is shared among nodes.
5553 check_shared_dir() {
5554         local dir=$1
5555         local list=${2:-$(comma_list $(nodes_list))}
5556
5557         [ -z "$dir" ] && return 1
5558         do_rpc_nodes "$list" check_logdir $dir
5559         check_write_access $dir "$list" || return 1
5560         return 0
5561 }
5562
5563 run_lfsck() {
5564         do_nodes $(comma_list $(mdts_nodes) $(osts_nodes)) \
5565                 $LCTL set_param printk=+lfsck
5566         do_facet $SINGLEMDS "$LCTL lfsck_start -M $FSNAME-MDT0000 -r -A -t all"
5567
5568         for k in $(seq $MDSCOUNT); do
5569                 # wait up to 10+1 minutes for LFSCK to complete
5570                 wait_update_facet --verbose mds${k} "$LCTL get_param -n \
5571                         mdd.$(facet_svc mds${k}).lfsck_layout |
5572                         awk '/^status/ { print \\\$2 }'" "completed" 600 ||
5573                         error "MDS${k} layout isn't the expected 'completed'"
5574                 wait_update_facet --verbose mds${k} "$LCTL get_param -n \
5575                         mdd.$(facet_svc mds${k}).lfsck_namespace |
5576                         awk '/^status/ { print \\\$2 }'" "completed" 60 ||
5577                         error "MDS${k} namespace isn't the expected 'completed'"
5578         done
5579         local rep_mdt=$(do_nodes $(comma_list $(mdts_nodes)) \
5580                         $LCTL get_param -n mdd.$FSNAME-*.lfsck_* |
5581                         awk '/repaired/ { print $2 }' | calc_sum)
5582         local rep_ost=$(do_nodes $(comma_list $(osts_nodes)) \
5583                         $LCTL get_param -n obdfilter.$FSNAME-*.lfsck_* |
5584                         awk '/repaired/ { print $2 }' | calc_sum)
5585         local repaired=$((rep_mdt + rep_ost))
5586         [ $repaired -eq 0 ] ||
5587                 error "lfsck repaired $rep_mdt MDT and $rep_ost OST errors"
5588 }
5589
5590 dump_file_contents() {
5591         local nodes=$1
5592         local dir=$2
5593         local logname=$3
5594         local node
5595
5596         if [ -z "$nodes" -o -z "$dir" -o -z "$logname" ]; then
5597                 error_noexit false \
5598                         "Invalid parameters for dump_file_contents()"
5599                 return 1
5600         fi
5601         for node in ${nodes}; do
5602                 do_node $node "for i in \\\$(find $dir -type f); do
5603                                 echo ====\\\${i}=======================;
5604                                 cat \\\${i};
5605                                 done" >> ${logname}.${node}.log
5606         done
5607 }
5608
5609 dump_command_output() {
5610         local nodes=$1
5611         local cmd=$2
5612         local logname=$3
5613         local node
5614
5615         if [ -z "$nodes" -o -z "$cmd" -o -z "$logname" ]; then
5616                 error_noexit false \
5617                         "Invalid parameters for dump_command_output()"
5618                 return 1
5619         fi
5620
5621         for node in ${nodes}; do
5622                 do_node $node "echo ====${cmd}=======================;
5623                                 $cmd" >> ${logname}.${node}.log
5624         done
5625 }
5626
5627 log_zfs_info() {
5628         local logname=$1
5629
5630         # dump file contents from /proc/spl in case of zfs test
5631         if [ "$(facet_fstype ost1)" = "zfs" ]; then
5632                 dump_file_contents "$(osts_nodes)" "/proc/spl" "${logname}"
5633                 dump_command_output \
5634                         "$(osts_nodes)" "zpool events -v" "${logname}"
5635         fi
5636
5637         if [ "$(facet_fstype $SINGLEMDS)" = "zfs" ]; then
5638                 dump_file_contents "$(mdts_nodes)" "/proc/spl" "${logname}"
5639                 dump_command_output \
5640                         "$(mdts_nodes)" "zpool events -v" "${logname}"
5641         fi
5642 }
5643
5644 check_and_cleanup_lustre() {
5645         if [ "$LFSCK_ALWAYS" = "yes" -a "$TESTSUITE" != "sanity-lfsck" -a \
5646              "$TESTSUITE" != "sanity-scrub" ]; then
5647                 run_lfsck
5648         fi
5649
5650         if is_mounted $MOUNT; then
5651                 if $DO_CLEANUP; then
5652                         [ -n "$DIR" ] && rm -rf $DIR/[Rdfs][0-9]* ||
5653                                 error "remove sub-test dirs failed"
5654                 else
5655                         echo "skip cleanup"
5656                 fi
5657                 [ "$ENABLE_QUOTA" ] && restore_quota || true
5658         fi
5659
5660         if [ "$I_UMOUNTED2" = "yes" ]; then
5661                 restore_mount $MOUNT2 || error "restore $MOUNT2 failed"
5662         fi
5663
5664         if [ "$I_MOUNTED2" = "yes" ]; then
5665                 cleanup_mount $MOUNT2
5666         fi
5667
5668         if [[ "$I_MOUNTED" = "yes" ]] && ! $AUSTER_CLEANUP; then
5669                 cleanupall -f || error "cleanup failed"
5670                 unset I_MOUNTED
5671         fi
5672 }
5673
5674 #######
5675 # General functions
5676
5677 wait_for_function () {
5678     local quiet=""
5679
5680     # suppress fn both stderr and stdout
5681     if [ "$1" = "--quiet" ]; then
5682         shift
5683         quiet=" > /dev/null 2>&1"
5684
5685     fi
5686
5687     local fn=$1
5688     local max=${2:-900}
5689     local sleep=${3:-5}
5690
5691     local wait=0
5692
5693     while true; do
5694
5695         eval $fn $quiet && return 0
5696
5697         wait=$((wait + sleep))
5698         [ $wait -lt $max ] || return 1
5699         echo waiting $fn, $((max - wait)) secs left ...
5700         sleep $sleep
5701     done
5702 }
5703
5704 check_network() {
5705         local host=$1
5706         local max=$2
5707         local sleep=${3:-5}
5708
5709         [ "$host" = "$HOSTNAME" ] && return 0
5710
5711         if ! wait_for_function --quiet "ping -c 1 -w 3 $host" $max $sleep; then
5712                 echo "$(date +'%H:%M:%S (%s)') waited for $host network ${max}s"
5713                 exit 1
5714         fi
5715 }
5716
5717 no_dsh() {
5718     shift
5719     eval $@
5720 }
5721
5722 # Convert a space-delimited list to a comma-delimited list.  If the input is
5723 # only whitespace, ensure the output is empty (i.e. "") so [ -n $list ] works
5724 comma_list() {
5725         # echo is used to convert newlines to spaces, since it doesn't
5726         # introduce a trailing space as using "tr '\n' ' '" does
5727         echo $(tr -s " " "\n" <<< $* | sort -b -u) | tr ' ' ','
5728 }
5729
5730 list_member () {
5731     local list=$1
5732     local item=$2
5733     echo $list | grep -qw $item
5734 }
5735
5736 # list, excluded are the comma separated lists
5737 exclude_items_from_list () {
5738     local list=$1
5739     local excluded=$2
5740     local item
5741
5742     list=${list//,/ }
5743     for item in ${excluded//,/ }; do
5744         list=$(echo " $list " | sed -re "s/\s+$item\s+/ /g")
5745     done
5746     echo $(comma_list $list)
5747 }
5748
5749 # list, expand  are the comma separated lists
5750 expand_list () {
5751     local list=${1//,/ }
5752     local expand=${2//,/ }
5753     local expanded=
5754
5755     expanded=$(for i in $list $expand; do echo $i; done | sort -u)
5756     echo $(comma_list $expanded)
5757 }
5758
5759 testslist_filter () {
5760     local script=$LUSTRE/tests/${TESTSUITE}.sh
5761
5762     [ -f $script ] || return 0
5763
5764     local start_at=$START_AT
5765     local stop_at=$STOP_AT
5766
5767     local var=${TESTSUITE//-/_}_START_AT
5768     [ x"${!var}" != x ] && start_at=${!var}
5769     var=${TESTSUITE//-/_}_STOP_AT
5770     [ x"${!var}" != x ] && stop_at=${!var}
5771
5772     sed -n 's/^test_\([^ (]*\).*/\1/p' $script | \
5773         awk ' BEGIN { if ("'${start_at:-0}'" != 0) flag = 1 }
5774             /^'${start_at}'$/ {flag = 0}
5775             {if (flag == 1) print $0}
5776             /^'${stop_at}'$/ { flag = 1 }'
5777 }
5778
5779 absolute_path() {
5780     (cd `dirname $1`; echo $PWD/`basename $1`)
5781 }
5782
5783 get_facets () {
5784     local types=${1:-"OST MDS MGS"}
5785
5786     local list=""
5787
5788     for entry in $types; do
5789         local name=$(echo $entry | tr "[:upper:]" "[:lower:]")
5790         local type=$(echo $entry | tr "[:lower:]" "[:upper:]")
5791
5792         case $type in
5793                 MGS ) list="$list $name";;
5794             MDS|OST|AGT ) local count=${type}COUNT
5795                        for ((i=1; i<=${!count}; i++)) do
5796                           list="$list ${name}$i"
5797                       done;;
5798                   * ) error "Invalid facet type"
5799                  exit 1;;
5800         esac
5801     done
5802     echo $(comma_list $list)
5803 }
5804
5805 ##################################
5806 # Adaptive Timeouts funcs
5807
5808 at_is_enabled() {
5809     # only check mds, we assume at_max is the same on all nodes
5810     local at_max=$(do_facet $SINGLEMDS "lctl get_param -n at_max")
5811     if [ $at_max -eq 0 ]; then
5812         return 1
5813     else
5814         return 0
5815     fi
5816 }
5817
5818 at_get() {
5819     local facet=$1
5820     local at=$2
5821
5822     # suppose that all ost-s have the same $at value set
5823     [ $facet != "ost" ] || facet=ost1
5824
5825     do_facet $facet "lctl get_param -n $at"
5826 }
5827
5828 at_max_get() {
5829     at_get $1 at_max
5830 }
5831
5832 at_min_get() {
5833         at_get $1 at_min
5834 }
5835
5836 at_max_set() {
5837     local at_max=$1
5838     shift
5839
5840     local facet
5841     local hosts
5842     for facet in $@; do
5843         if [ $facet == "ost" ]; then
5844             facet=$(get_facets OST)
5845         elif [ $facet == "mds" ]; then
5846             facet=$(get_facets MDS)
5847         fi
5848         hosts=$(expand_list $hosts $(facets_hosts $facet))
5849     done
5850
5851     do_nodes $hosts lctl set_param at_max=$at_max
5852 }
5853
5854 ##################################
5855 # OBD_FAIL funcs
5856
5857 drop_request() {
5858 # OBD_FAIL_MDS_ALL_REQUEST_NET
5859     RC=0
5860     do_facet $SINGLEMDS lctl set_param fail_val=0 fail_loc=0x123
5861     do_facet client "$1" || RC=$?
5862     do_facet $SINGLEMDS lctl set_param fail_loc=0
5863     return $RC
5864 }
5865
5866 drop_reply() {
5867 # OBD_FAIL_MDS_ALL_REPLY_NET
5868         RC=0
5869         do_facet $SINGLEMDS $LCTL set_param fail_loc=0x122
5870         eval "$@" || RC=$?
5871         do_facet $SINGLEMDS $LCTL set_param fail_loc=0
5872         return $RC
5873 }
5874
5875 drop_reint_reply() {
5876 # OBD_FAIL_MDS_REINT_NET_REP
5877         RC=0
5878         do_facet $SINGLEMDS $LCTL set_param fail_loc=0x119
5879         eval "$@" || RC=$?
5880         do_facet $SINGLEMDS $LCTL set_param fail_loc=0
5881         return $RC
5882 }
5883
5884 drop_update_reply() {
5885 # OBD_FAIL_OUT_UPDATE_NET_REP
5886         local index=$1
5887         shift 1
5888         RC=0
5889         do_facet mds${index} lctl set_param fail_loc=0x1701
5890         do_facet client "$@" || RC=$?
5891         do_facet mds${index} lctl set_param fail_loc=0
5892         return $RC
5893 }
5894
5895 pause_bulk() {
5896 #define OBD_FAIL_OST_BRW_PAUSE_BULK      0x214
5897         RC=0
5898
5899         local timeout=${2:-0}
5900         # default is (obd_timeout / 4) if unspecified
5901         echo "timeout is $timeout/$2"
5902         do_facet ost1 lctl set_param fail_val=$timeout fail_loc=0x80000214
5903         do_facet client "$1" || RC=$?
5904         do_facet client "sync"
5905         do_facet ost1 lctl set_param fail_loc=0
5906         return $RC
5907 }
5908
5909 drop_ldlm_cancel() {
5910 #define OBD_FAIL_LDLM_CANCEL_NET                        0x304
5911         local RC=0
5912         local list=$(comma_list $(mdts_nodes) $(osts_nodes))
5913         do_nodes $list lctl set_param fail_loc=0x304
5914
5915         do_facet client "$@" || RC=$?
5916
5917         do_nodes $list lctl set_param fail_loc=0
5918         return $RC
5919 }
5920
5921 drop_bl_callback_once() {
5922         local rc=0
5923         do_facet client lctl set_param ldlm.namespaces.*.early_lock_cancel=0
5924 #define OBD_FAIL_LDLM_BL_CALLBACK_NET                   0x305
5925         do_facet client lctl set_param fail_loc=0x80000305
5926         do_facet client "$@" || rc=$?
5927         do_facet client lctl set_param fail_loc=0
5928         do_facet client lctl set_param fail_val=0
5929         do_facet client lctl set_param ldlm.namespaces.*.early_lock_cancel=1
5930         return $rc
5931 }
5932
5933 drop_bl_callback() {
5934         rc=0
5935         do_facet client lctl set_param ldlm.namespaces.*.early_lock_cancel=0
5936 #define OBD_FAIL_LDLM_BL_CALLBACK_NET                   0x305
5937         do_facet client lctl set_param fail_loc=0x305
5938         do_facet client "$@" || rc=$?
5939         do_facet client lctl set_param fail_loc=0
5940         do_facet client lctl set_param fail_val=0
5941         do_facet client lctl set_param ldlm.namespaces.*.early_lock_cancel=1
5942         return $rc
5943 }
5944
5945 drop_mdt_ldlm_reply() {
5946 #define OBD_FAIL_MDS_LDLM_REPLY_NET     0x157
5947     RC=0
5948     local list=$(comma_list $(mdts_nodes))
5949     do_nodes $list lctl set_param fail_loc=0x157
5950
5951     do_facet client "$@" || RC=$?
5952
5953     do_nodes $list lctl set_param fail_loc=0
5954     return $RC
5955 }
5956
5957 drop_mdt_ldlm_reply_once() {
5958 #define OBD_FAIL_MDS_LDLM_REPLY_NET     0x157
5959     RC=0
5960     local list=$(comma_list $(mdts_nodes))
5961     do_nodes $list lctl set_param fail_loc=0x80000157
5962
5963     do_facet client "$@" || RC=$?
5964
5965     do_nodes $list lctl set_param fail_loc=0
5966     return $RC
5967 }
5968
5969 clear_failloc() {
5970     facet=$1
5971     pause=$2
5972     sleep $pause
5973     echo "clearing fail_loc on $facet"
5974     do_facet $facet "lctl set_param fail_loc=0 2>/dev/null || true"
5975 }
5976
5977 set_nodes_failloc () {
5978         local fv=${3:-0}
5979         do_nodes $(comma_list $1)  lctl set_param fail_val=$fv fail_loc=$2
5980 }
5981
5982 cancel_lru_locks() {
5983         #$LCTL mark "cancel_lru_locks $1 start"
5984         $LCTL set_param -n ldlm.namespaces.*$1*.lru_size=clear
5985         $LCTL get_param ldlm.namespaces.*$1*.lock_unused_count | grep -v '=0'
5986         #$LCTL mark "cancel_lru_locks $1 stop"
5987 }
5988
5989 default_lru_size()
5990 {
5991         NR_CPU=$(grep -c "processor" /proc/cpuinfo)
5992         DEFAULT_LRU_SIZE=$((100 * NR_CPU))
5993         echo "$DEFAULT_LRU_SIZE"
5994 }
5995
5996 lru_resize_enable()
5997 {
5998     lctl set_param ldlm.namespaces.*$1*.lru_size=0
5999 }
6000
6001 lru_resize_disable()
6002 {
6003     lctl set_param ldlm.namespaces.*$1*.lru_size $(default_lru_size)
6004 }
6005
6006 flock_is_enabled()
6007 {
6008         local mountpath=${1:-$MOUNT}
6009         local RC=0
6010
6011         [ -z "$(mount | grep "$mountpath .*flock" | grep -v noflock)" ] && RC=1
6012         return $RC
6013 }
6014
6015 pgcache_empty() {
6016     local FILE
6017     for FILE in `lctl get_param -N "llite.*.dump_page_cache"`; do
6018         if [ `lctl get_param -n $FILE | wc -l` -gt 1 ]; then
6019             echo there is still data in page cache $FILE ?
6020             lctl get_param -n $FILE
6021             return 1
6022         fi
6023     done
6024     return 0
6025 }
6026
6027 debugsave() {
6028         DEBUGSAVE="$(lctl get_param -n debug)"
6029         DEBUGSAVE_SERVER=$(do_facet $SINGLEMDS "$LCTL get_param -n debug")
6030 }
6031
6032 debugrestore() {
6033         [ -n "$DEBUGSAVE" ] &&
6034                 do_nodes $CLIENTS "$LCTL set_param debug=\\\"${DEBUGSAVE}\\\""||
6035                 true
6036         DEBUGSAVE=""
6037
6038         [ -n "$DEBUGSAVE_SERVER" ] &&
6039                 do_nodes $(comma_list $(all_server_nodes)) \
6040                          "$LCTL set_param debug=\\\"${DEBUGSAVE_SERVER}\\\"" ||
6041                          true
6042         DEBUGSAVE_SERVER=""
6043 }
6044
6045 debug_size_save() {
6046     DEBUG_SIZE_SAVED="$(lctl get_param -n debug_mb)"
6047 }
6048
6049 debug_size_restore() {
6050     [ -n "$DEBUG_SIZE_SAVED" ] && \
6051         do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug_mb=$DEBUG_SIZE_SAVED"
6052     DEBUG_SIZE_SAVED=""
6053 }
6054
6055 start_full_debug_logging() {
6056         debugsave
6057         debug_size_save
6058
6059         local fulldebug=-1
6060         local debug_size=150
6061         local nodes=$(comma_list $(nodes_list))
6062
6063         do_nodes $nodes "$LCTL set_param debug=$fulldebug debug_mb=$debug_size"
6064 }
6065
6066 stop_full_debug_logging() {
6067         debug_size_restore
6068         debugrestore
6069 }
6070
6071 # prints bash call stack
6072 print_stack_trace() {
6073         local skip=${1:-1}
6074         echo "  Trace dump:"
6075         for (( i=$skip; i < ${#BASH_LINENO[*]} ; i++ )) ; do
6076                 local src=${BASH_SOURCE[$i]}
6077                 local lineno=${BASH_LINENO[$i-1]}
6078                 local funcname=${FUNCNAME[$i]}
6079                 echo "  = $src:$lineno:$funcname()"
6080         done
6081 }
6082
6083 report_error() {
6084         local TYPE=${TYPE:-"FAIL"}
6085
6086         local dump=true
6087         # do not dump logs if $1=false
6088         if [ "x$1" = "xfalse" ]; then
6089                 shift
6090                 dump=false
6091         fi
6092
6093         log " ${TESTSUITE} ${TESTNAME}: @@@@@@ ${TYPE}: $@ "
6094         (print_stack_trace 2) >&2
6095         mkdir -p $LOGDIR
6096         # We need to dump the logs on all nodes
6097         if $dump; then
6098                 gather_logs $(comma_list $(nodes_list))
6099         fi
6100
6101         debugrestore
6102         [ "$TESTSUITELOG" ] &&
6103                 echo "$TESTSUITE: $TYPE: $TESTNAME $@" >> $TESTSUITELOG
6104         if [ -z "$*" ]; then
6105                 echo "error() without useful message, please fix" > $LOGDIR/err
6106         else
6107                 if [[ `echo $TYPE | grep ^IGNORE` ]]; then
6108                         echo "$@" > $LOGDIR/ignore
6109                 else
6110                         echo "$@" > $LOGDIR/err
6111                 fi
6112         fi
6113
6114         # cleanup the env for failed tests
6115         reset_fail_loc
6116 }
6117
6118 ##################################
6119 # Test interface
6120 ##################################
6121
6122 # usage: stack_trap arg sigspec
6123 #
6124 # stack_trap() behaves like bash's built-in trap, except that it "stacks" the
6125 # command "arg" on top of previously defined commands for "sigspec" instead
6126 # of overwriting them.
6127 # stacked traps are executed in reverse order of their registration
6128 #
6129 # arg and sigspec have the same meaning as in man (1) trap
6130 stack_trap()
6131 {
6132         local arg="$1"
6133         local sigspec="${2:-EXIT}"
6134
6135         # Use "trap -p" to get the quoting right
6136         local old_trap="$(trap -p "$sigspec")"
6137         # Append ";" and remove the leading "trap -- '" added by "trap -p"
6138         old_trap="${old_trap:+"; ${old_trap#trap -- \'}"}"
6139
6140         # Once again, use "trap -p" to get the quoting right
6141         local new_trap="$(trap -- "$arg" "$sigspec"
6142                           trap -p "$sigspec"
6143                           trap -- '' "$sigspec")"
6144
6145         # Remove the trailing "' $sigspec" part added by "trap -p" and merge
6146         #
6147         # The resulting string should be safe to "eval" as it is (supposedly
6148         # correctly) quoted by "trap -p"
6149         eval "${new_trap%\' $sigspec}${old_trap:-"' $sigspec"}"
6150 }
6151
6152 error_noexit() {
6153         report_error "$@"
6154 }
6155
6156 exit_status () {
6157         local status=0
6158         local log=$TESTSUITELOG
6159
6160         [ -f "$log" ] && grep -qw FAIL $log && status=1
6161         exit $status
6162 }
6163
6164 error() {
6165         report_error "$@"
6166         exit 1
6167 }
6168
6169 error_exit() {
6170         report_error "$@"
6171         exit 1
6172 }
6173
6174 # use only if we are ignoring failures for this test, bugno required.
6175 # (like ALWAYS_EXCEPT, but run the test and ignore the results.)
6176 # e.g. error_ignore bz5494 "your message" or
6177 # error_ignore LU-5494 "your message"
6178 error_ignore() {
6179         local TYPE="IGNORE ($1)"
6180         shift
6181         report_error "$@"
6182 }
6183
6184 error_and_remount() {
6185         report_error "$@"
6186         remount_client $MOUNT
6187         exit 1
6188 }
6189
6190 # Throw an error if it's not running in vm - usually for performance
6191 # verification
6192 error_not_in_vm() {
6193         local virt=$(running_in_vm)
6194         if [[ -n "$virt" ]]; then
6195                 echo "running in VM '$virt', ignore error"
6196                 error_ignore env=$virt "$@"
6197         else
6198                 error "$@"
6199         fi
6200 }
6201
6202 #
6203 # Function: skip_env()
6204 # Purpose:  to skip a test during developer testing because some tool
6205 #           is missing, but fail the test in release testing because the test
6206 #           environment is not configured properly".
6207 #
6208 skip_env () {
6209         $FAIL_ON_SKIP_ENV && error false $@ || skip $@
6210 }
6211
6212 skip_noexit() {
6213         echo
6214         log " SKIP: $TESTSUITE $TESTNAME $@"
6215
6216         if [[ -n "$ALWAYS_SKIPPED" ]]; then
6217                 skip_logged $TESTNAME "$@"
6218         else
6219                 mkdir -p $LOGDIR
6220                 echo "$@" > $LOGDIR/skip
6221         fi
6222
6223         [[ -n "$TESTSUITELOG" ]] &&
6224                 echo "$TESTSUITE: SKIP: $TESTNAME $@" >> $TESTSUITELOG || true
6225         unset TESTNAME
6226 }
6227
6228 skip() {
6229         skip_noexit $@
6230         exit 0
6231 }
6232
6233 build_test_filter() {
6234         EXCEPT="$EXCEPT $(testslist_filter)"
6235
6236         for O in $ONLY; do
6237                 if [[ $O = [0-9]*-[0-9]* ]]; then
6238                         for num in $(seq $(echo $O | tr '-' ' ')); do
6239                                 eval ONLY_$num=true
6240                         done
6241                 else
6242                         eval ONLY_${O}=true
6243                 fi
6244         done
6245
6246         [ "$EXCEPT$ALWAYS_EXCEPT" ] &&
6247                 log "excepting tests: `echo $EXCEPT $ALWAYS_EXCEPT`"
6248         [ "$EXCEPT_SLOW" ] &&
6249                 log "skipping tests SLOW=no: `echo $EXCEPT_SLOW`"
6250         for E in $EXCEPT; do
6251                 eval EXCEPT_${E}=true
6252         done
6253         for E in $ALWAYS_EXCEPT; do
6254                 eval EXCEPT_ALWAYS_${E}=true
6255         done
6256         for E in $EXCEPT_SLOW; do
6257                 eval EXCEPT_SLOW_${E}=true
6258         done
6259         for G in $GRANT_CHECK_LIST; do
6260                 eval GCHECK_ONLY_${G}=true
6261         done
6262 }
6263
6264 basetest() {
6265     if [[ $1 = [a-z]* ]]; then
6266         echo $1
6267     else
6268         echo ${1%%[a-zA-Z]*}
6269     fi
6270 }
6271
6272 # print a newline if the last test was skipped
6273 export LAST_SKIPPED=
6274 export ALWAYS_SKIPPED=
6275 #
6276 # Main entry into test-framework. This is called with the number and
6277 # description of a test. The number is used to find the function to run
6278 # the test using "test_$name".
6279 #
6280 # This supports a variety of methods of specifying specific test to
6281 # run or not run:
6282 # - ONLY= env variable with space-separated list of test numbers to run
6283 # - EXCEPT= env variable with space-separated list of test numbers to exclude
6284 #
6285 run_test() {
6286         assert_DIR
6287         local testnum=$1
6288         local testmsg=$2
6289         export base=$(basetest $testnum)
6290         export TESTNAME=test_$testnum
6291         LAST_SKIPPED=
6292         ALWAYS_SKIPPED=
6293
6294         # Check the EXCEPT, ALWAYS_EXCEPT and SLOW lists to see if we
6295         # need to skip the current test. If so, set the ALWAYS_SKIPPED flag.
6296         local isexcept=EXCEPT_$testnum
6297         local isexcept_base=EXCEPT_$base
6298         if [ ${!isexcept}x != x ]; then
6299                 ALWAYS_SKIPPED="y"
6300                 skip_message="skipping excluded test $testnum"
6301         elif [ ${!isexcept_base}x != x ]; then
6302                 ALWAYS_SKIPPED="y"
6303                 skip_message="skipping excluded test $testnum (base $base)"
6304         fi
6305
6306         isexcept=EXCEPT_ALWAYS_$testnum
6307         isexcept_base=EXCEPT_ALWAYS_$base
6308         if [ ${!isexcept}x != x ]; then
6309                 ALWAYS_SKIPPED="y"
6310                 skip_message="skipping ALWAYS excluded test $testnum"
6311         elif [ ${!isexcept_base}x != x ]; then
6312                 ALWAYS_SKIPPED="y"
6313                 skip_message="skipping ALWAYS excluded test $testnum (base $base)"
6314         fi
6315
6316         isexcept=EXCEPT_SLOW_$testnum
6317         isexcept_base=EXCEPT_SLOW_$base
6318         if [ ${!isexcept}x != x ]; then
6319                 ALWAYS_SKIPPED="y"
6320                 skip_message="skipping SLOW test $testnum"
6321         elif [ ${!isexcept_base}x != x ]; then
6322                 ALWAYS_SKIPPED="y"
6323                 skip_message="skipping SLOW test $testnum (base $base)"
6324         fi
6325
6326         # If there are tests on the ONLY list, check if the current test
6327         # is on that list and, if so, check if the test is to be skipped
6328         # and if we are supposed to honor the skip lists.
6329         if [ -n "$ONLY" ]; then
6330                 local isonly=ONLY_$testnum
6331                 local isonly_base=ONLY_$base
6332                 if [[ ${!isonly}x != x || ${!isonly_base}x != x ]]; then
6333
6334                         if [[ -n "$ALWAYS_SKIPPED" && -n "$HONOR_EXCEPT" ]]; then
6335                                 LAST_SKIPPED="y"
6336                                 skip_noexit "$skip_message"
6337                                 return 0
6338                         else
6339                                 [ -n "$LAST_SKIPPED" ] &&
6340                                         echo "" && LAST_SKIPPED=
6341                                 ALWAYS_SKIPPED=
6342                                 run_one_logged $testnum "$testmsg"
6343                                 return $?
6344                         fi
6345
6346                 else
6347                         LAST_SKIPPED="y"
6348                         return 0
6349                 fi
6350         fi
6351
6352         if [ -n "$ALWAYS_SKIPPED" ]; then
6353                 LAST_SKIPPED="y"
6354                 skip_noexit "$skip_message"
6355                 return 0
6356         else
6357                 run_one_logged $testnum "$testmsg"
6358                 return $?
6359         fi
6360 }
6361
6362 log() {
6363         echo "$*" >&2
6364         load_module ../libcfs/libcfs/libcfs
6365
6366     local MSG="$*"
6367     # Get rid of '
6368     MSG=${MSG//\'/\\\'}
6369     MSG=${MSG//\(/\\\(}
6370     MSG=${MSG//\)/\\\)}
6371     MSG=${MSG//\;/\\\;}
6372     MSG=${MSG//\|/\\\|}
6373     MSG=${MSG//\>/\\\>}
6374     MSG=${MSG//\</\\\<}
6375     MSG=${MSG//\//\\\/}
6376     do_nodes $(comma_list $(nodes_list)) $LCTL mark "$MSG" 2> /dev/null || true
6377 }
6378
6379 trace() {
6380         log "STARTING: $*"
6381         strace -o $TMP/$1.strace -ttt $*
6382         RC=$?
6383         log "FINISHED: $*: rc $RC"
6384         return 1
6385 }
6386
6387 complete () {
6388     local duration=$1
6389
6390     banner test complete, duration $duration sec
6391     [ -f "$TESTSUITELOG" ] && egrep .FAIL $TESTSUITELOG || true
6392     echo duration $duration >>$TESTSUITELOG
6393 }
6394
6395 pass() {
6396         # Set TEST_STATUS here. It will be used for logging the result.
6397         TEST_STATUS="PASS"
6398
6399         if [[ -f $LOGDIR/err ]]; then
6400                 TEST_STATUS="FAIL"
6401         elif [[ -f $LOGDIR/skip ]]; then
6402                 TEST_STATUS="SKIP"
6403         fi
6404         echo "$TEST_STATUS $@" 2>&1 | tee -a $TESTSUITELOG
6405 }
6406
6407 check_mds() {
6408     local FFREE=$(do_node $SINGLEMDS \
6409         lctl get_param -n osd*.*MDT*.filesfree | calc_sum)
6410     local FTOTAL=$(do_node $SINGLEMDS \
6411         lctl get_param -n osd*.*MDT*.filestotal | calc_sum)
6412
6413     [ $FFREE -ge $FTOTAL ] && error "files free $FFREE > total $FTOTAL" || true
6414 }
6415
6416 reset_fail_loc () {
6417         echo -n "Resetting fail_loc on all nodes..."
6418         do_nodes $(comma_list $(nodes_list)) "lctl set_param -n fail_loc=0 \
6419             fail_val=0 2>/dev/null" || true
6420         echo done.
6421 }
6422
6423
6424 #
6425 # Log a message (on all nodes) padded with "=" before and after.
6426 # Also appends a timestamp and prepends the testsuite name.
6427 #
6428
6429 EQUALS="===================================================================================================="
6430 banner() {
6431     msg="== ${TESTSUITE} $*"
6432     last=${msg: -1:1}
6433     [[ $last != "=" && $last != " " ]] && msg="$msg "
6434     msg=$(printf '%s%.*s'  "$msg"  $((${#EQUALS} - ${#msg})) $EQUALS )
6435     # always include at least == after the message
6436     log "$msg== $(date +"%H:%M:%S (%s)")"
6437 }
6438
6439 check_dmesg_for_errors() {
6440         local res
6441         local errors="VFS: Busy inodes after unmount of\|\
6442 ldiskfs_check_descriptors: Checksum for group 0 failed\|\
6443 group descriptors corrupted"
6444
6445         res=$(do_nodes $(comma_list $(nodes_list)) "dmesg" | grep "$errors")
6446         [ -z "$res" ] && return 0
6447         echo "Kernel error detected: $res"
6448         return 1
6449 }
6450
6451 #
6452 # Run a single test function and cleanup after it.
6453 #
6454 # This function should be run in a subshell so the test func can
6455 # exit() without stopping the whole script.
6456 #
6457 run_one() {
6458         local testnum=$1
6459         local testmsg="$2"
6460         local SAVE_UMASK=`umask`
6461         umask 0022
6462
6463         if ! grep -q $DIR /proc/mounts; then
6464                 $SETUP
6465         fi
6466
6467         banner "test $testnum: $testmsg"
6468         test_${testnum} || error "test_$testnum failed with $?"
6469         cd $SAVE_PWD
6470         reset_fail_loc
6471         check_grant ${testnum} || error "check_grant $testnum failed with $?"
6472         check_node_health
6473         check_dmesg_for_errors || error "Error in dmesg detected"
6474         if [ "$PARALLEL" != "yes" ]; then
6475                 ps auxww | grep -v grep | grep -q "multiop " &&
6476                                         error "multiop still running"
6477         fi
6478         umask $SAVE_UMASK
6479         $CLEANUP
6480         return 0
6481 }
6482
6483 #
6484 # Wrapper around run_one to ensure:
6485 #  - test runs in subshell
6486 #  - output of test is saved to separate log file for error reporting
6487 #  - test result is saved to data file
6488 #
6489 run_one_logged() {
6490         local before=$SECONDS
6491         local testnum=$1
6492         local testmsg=$2
6493         export tfile=f${testnum}.${TESTSUITE}
6494         export tdir=d${testnum}.${TESTSUITE}
6495         local name=$TESTSUITE.$TESTNAME.test_log.$(hostname -s).log
6496         local test_log=$LOGDIR/$name
6497         local zfs_log_name=$TESTSUITE.$TESTNAME.zfs_log
6498         local zfs_debug_log=$LOGDIR/$zfs_log_name
6499         local SAVE_UMASK=$(umask)
6500         local rc=0
6501         umask 0022
6502
6503         rm -f $LOGDIR/err $LOGDIR/ignore $LOGDIR/skip
6504         echo
6505         # if ${ONLY_$testnum} set, repeat $ONLY_REPEAT times, otherwise once
6506         local isonly=ONLY_$testnum
6507         local repeat=${!isonly:+$ONLY_REPEAT}
6508
6509         for testiter in $(seq ${repeat:-1}); do
6510                 local before_sub=$SECONDS
6511                 log_sub_test_begin $TESTNAME
6512
6513                 # remove temp files between repetitions to avoid test failures
6514                 [ -n "$append" -a -n "$DIR" -a -n "$tdir" -a -n "$tfile" ] &&
6515                         rm -rf $DIR/$tdir* $DIR/$tfile*
6516                 # loop around subshell so stack_trap EXIT triggers each time
6517                 (run_one $testnum "$testmsg") 2>&1 | tee -i $append $test_log
6518                 rc=${PIPESTATUS[0]}
6519                 local append=-a
6520                 local duration_sub=$((SECONDS - before_sub))
6521                 local test_error
6522
6523                 [[ $rc != 0 && ! -f $LOGDIR/err ]] &&
6524                         echo "$TESTNAME returned $rc" | tee $LOGDIR/err
6525
6526                 if [[ -f $LOGDIR/err ]]; then
6527                         test_error=$(cat $LOGDIR/err)
6528                         TEST_STATUS="FAIL"
6529                 elif [[ -f $LOGDIR/ignore ]]; then
6530                         test_error=$(cat $LOGDIR/ignore)
6531                 elif [[ -f $LOGDIR/skip ]]; then
6532                         test_error=$(cat $LOGDIR/skip)
6533                         TEST_STATUS="SKIP"
6534                 else
6535                         TEST_STATUS="PASS"
6536                 fi
6537
6538                 pass "$testnum" "(${duration_sub}s)"
6539                 log_sub_test_end $TEST_STATUS $duration_sub "$rc" "$test_error"
6540                 [[ $rc != 0 ]] && break
6541         done
6542
6543         if [[ "$TEST_STATUS" != "SKIP" && -f $TF_SKIP ]]; then
6544                 rm -f $TF_SKIP
6545         fi
6546
6547         if [ -f $LOGDIR/err ]; then
6548                 log_zfs_info "$zfs_debug_log"
6549                 $FAIL_ON_ERROR && exit $rc
6550         fi
6551
6552         umask $SAVE_UMASK
6553
6554         unset TESTNAME
6555         unset tdir
6556         unset tfile
6557
6558         return 0
6559 }
6560
6561 #
6562 # Print information of skipped tests to result.yml
6563 #
6564 skip_logged(){
6565         log_sub_test_begin $1
6566         shift
6567         log_sub_test_end "SKIP" "0" "0" "$@"
6568 }
6569
6570 canonical_path() {
6571         (cd $(dirname $1); echo $PWD/$(basename $1))
6572 }
6573
6574 grant_from_clients() {
6575         local nodes="$1"
6576
6577         # get client grant
6578         do_nodes $nodes "$LCTL get_param -n osc.${FSNAME}-*.cur_*grant_bytes" |
6579                 calc_sum
6580 }
6581
6582 grant_from_servers() {
6583         local nodes="$1"
6584
6585         # get server grant
6586         # which is tot_granted less grant_precreate
6587         do_nodes $nodes "$LCTL get_param obdfilter.${FSNAME}-OST*.tot_granted" \
6588                 " obdfilter.${FSNAME}-OST*.tot_pending" \
6589                 " obdfilter.${FSNAME}-OST*.grant_precreate" |
6590                 tr '=' ' ' | awk '/tot_granted/{ total += $2 };
6591                                   /tot_pending/{ total -= $2 };
6592                                   /grant_precreate/{ total -= $2 };
6593                                   END { printf("%0.0f", total) }'
6594 }
6595
6596 check_grant() {
6597         export base=$(basetest $1)
6598         [ "$CHECK_GRANT" == "no" ] && return 0
6599
6600         local isonly_base=GCHECK_ONLY_${base}
6601         local isonly=GCHECK_ONLY_$1
6602         [ ${!isonly_base}x == x -a ${!isonly}x == x ] && return 0
6603
6604         echo -n "checking grant......"
6605
6606         local osts=$(comma_list $(osts_nodes))
6607         local clients=$CLIENTS
6608         [ -z "$clients" ] && clients=$(hostname)
6609
6610         # sync all the data and make sure no pending data on server
6611         do_nodes $clients sync
6612         clients_up # initiate all idling connections
6613
6614         # get client grant
6615         cli_grant=$(grant_from_clients $clients)
6616
6617         # get server grant
6618         # which is tot_granted less grant_precreate
6619         srv_grant=$(grant_from_servers $osts)
6620
6621         count=0
6622         # check whether client grant == server grant
6623         while [[ $cli_grant != $srv_grant && count++ -lt 30 ]]; do
6624                 echo "wait for client:$cli_grant == server:$srv_grant"
6625                 sleep 1
6626                 cli_grant=$(grant_from_clients $clients)
6627                 srv_grant=$(grant_from_servers $osts)
6628         done
6629         if [[ $cli_grant -ne $srv_grant ]]; then
6630                 do_nodes $(comma_list $(osts_nodes)) \
6631                         "$LCTL get_param obdfilter.${FSNAME}-OST*.tot*" \
6632                         "obdfilter.${FSNAME}-OST*.grant_*"
6633                 do_nodes $clients "$LCTL get_param osc.${FSNAME}-*.cur_*_bytes"
6634                 error "failed grant check: client:$cli_grant server:$srv_grant"
6635         else
6636                 echo "pass grant check: client:$cli_grant server:$srv_grant"
6637         fi
6638 }
6639
6640 ########################
6641 # helper functions
6642
6643 osc_to_ost()
6644 {
6645     osc=$1
6646     ost=`echo $1 | awk -F_ '{print $3}'`
6647     if [ -z $ost ]; then
6648         ost=`echo $1 | sed 's/-osc.*//'`
6649     fi
6650     echo $ost
6651 }
6652
6653 ostuuid_from_index()
6654 {
6655     $LFS osts $2 | sed -ne "/^$1: /s/.* \(.*\) .*$/\1/p"
6656 }
6657
6658 ostname_from_index() {
6659     local uuid=$(ostuuid_from_index $1)
6660     echo ${uuid/_UUID/}
6661 }
6662
6663 mdtname_from_index() {
6664         local uuid=$(mdtuuid_from_index $1)
6665         echo ${uuid/_UUID/}
6666 }
6667
6668 mdssize_from_index () {
6669         local mdt=$(mdtname_from_index $2)
6670         $LFS df $1 | grep $mdt | awk '{ print $2 }'
6671 }
6672
6673 index_from_ostuuid()
6674 {
6675     $LFS osts $2 | sed -ne "/${1}/s/\(.*\): .* .*$/\1/p"
6676 }
6677
6678 mdtuuid_from_index()
6679 {
6680     $LFS mdts $2 | sed -ne "/^$1: /s/.* \(.*\) .*$/\1/p"
6681 }
6682
6683 # Description:
6684 #   Return unique identifier for given hostname
6685 host_id() {
6686         local host_name=$1
6687         echo $host_name | md5sum | cut -d' ' -f1
6688 }
6689
6690 # Description:
6691 #   Returns list of ip addresses for each interface
6692 local_addr_list() {
6693         ip addr | awk '/inet\ / {print $2}' | awk -F\/ '{print $1}'
6694 }
6695
6696 is_local_addr() {
6697         local addr=$1
6698         # Cache address list to avoid mutiple execution of local_addr_list
6699         LOCAL_ADDR_LIST=${LOCAL_ADDR_LIST:-$(local_addr_list)}
6700         local i
6701         for i in $LOCAL_ADDR_LIST ; do
6702                 [[ "$i" == "$addr" ]] && return 0
6703         done
6704         return 1
6705 }
6706
6707 local_node() {
6708         local host_name=$1
6709         local is_local="IS_LOCAL_$(host_id $host_name)"
6710         if [ -z "${!is_local-}" ] ; then
6711                 eval $is_local=0
6712                 local host_ip=$($LUSTRE/tests/resolveip $host_name)
6713                 is_local_addr "$host_ip" && eval $is_local=1
6714         fi
6715         [[ "${!is_local}" == "1" ]]
6716 }
6717
6718 remote_node () {
6719         local node=$1
6720         local_node $node && return 1
6721         return 0
6722 }
6723
6724 remote_mds ()
6725 {
6726     local node
6727     for node in $(mdts_nodes); do
6728         remote_node $node && return 0
6729     done
6730     return 1
6731 }
6732
6733 remote_mds_nodsh()
6734 {
6735         [ -n "$CLIENTONLY" ] && return 0 || true
6736         remote_mds && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$mds_HOST" ]
6737 }
6738
6739 require_dsh_mds()
6740 {
6741         remote_mds_nodsh && echo "SKIP: $TESTSUITE: remote MDS with nodsh" &&
6742                 MSKIPPED=1 && return 1
6743         return 0
6744 }
6745
6746 remote_ost ()
6747 {
6748     local node
6749     for node in $(osts_nodes) ; do
6750         remote_node $node && return 0
6751     done
6752     return 1
6753 }
6754
6755 remote_ost_nodsh()
6756 {
6757         [ -n "$CLIENTONLY" ] && return 0 || true
6758         remote_ost && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$ost_HOST" ]
6759 }
6760
6761 require_dsh_ost()
6762 {
6763         remote_ost_nodsh && echo "SKIP: $TESTSUITE: remote OST with nodsh" && \
6764             OSKIPPED=1 && return 1
6765         return 0
6766 }
6767
6768 remote_mgs_nodsh()
6769 {
6770         [ -n "$CLIENTONLY" ] && return 0 || true
6771         local MGS
6772         MGS=$(facet_host mgs)
6773         remote_node $MGS && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$ost_HOST" ]
6774 }
6775
6776 local_mode ()
6777 {
6778     remote_mds_nodsh || remote_ost_nodsh || \
6779         $(single_local_node $(comma_list $(nodes_list)))
6780 }
6781
6782 remote_servers () {
6783     remote_ost && remote_mds
6784 }
6785
6786 # Get the active nodes for facets.
6787 facets_nodes () {
6788         local facets=$1
6789         local facet
6790         local nodes
6791         local nodes_sort
6792         local i
6793
6794         for facet in ${facets//,/ }; do
6795                 nodes="$nodes $(facet_active_host $facet)"
6796         done
6797
6798         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6799         echo -n $nodes_sort
6800 }
6801
6802 # Get name of the active MGS node.
6803 mgs_node () {
6804         echo -n $(facets_nodes $(get_facets MGS))
6805 }
6806
6807 # Get all of the active MDS nodes.
6808 mdts_nodes () {
6809         echo -n $(facets_nodes $(get_facets MDS))
6810 }
6811
6812 # Get all of the active OSS nodes.
6813 osts_nodes () {
6814         echo -n $(facets_nodes $(get_facets OST))
6815 }
6816
6817 # Get all of the active AGT (HSM agent) nodes.
6818 agts_nodes () {
6819         echo -n $(facets_nodes $(get_facets AGT))
6820 }
6821
6822 # Get all of the client nodes and active server nodes.
6823 nodes_list () {
6824         local nodes=$HOSTNAME
6825         local nodes_sort
6826         local i
6827
6828         # CLIENTS (if specified) contains the local client
6829         [ -n "$CLIENTS" ] && nodes=${CLIENTS//,/ }
6830
6831         if [ "$PDSH" -a "$PDSH" != "no_dsh" ]; then
6832                 nodes="$nodes $(facets_nodes $(get_facets))"
6833         fi
6834
6835         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6836         echo -n $nodes_sort
6837 }
6838
6839 # Get all of the remote client nodes and remote active server nodes.
6840 remote_nodes_list () {
6841         echo -n $(nodes_list) | sed -re "s/\<$HOSTNAME\>//g"
6842 }
6843
6844 # Get all of the MDS nodes, including active and passive nodes.
6845 all_mdts_nodes () {
6846         local host
6847         local failover_host
6848         local nodes
6849         local nodes_sort
6850         local i
6851
6852         for i in $(seq $MDSCOUNT); do
6853                 host=mds${i}_HOST
6854                 failover_host=mds${i}failover_HOST
6855                 nodes="$nodes ${!host} ${!failover_host}"
6856         done
6857
6858         [ -n "$nodes" ] || nodes="${mds_HOST} ${mdsfailover_HOST}"
6859         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6860         echo -n $nodes_sort
6861 }
6862
6863 # Get all of the OSS nodes, including active and passive nodes.
6864 all_osts_nodes () {
6865         local host
6866         local failover_host
6867         local nodes=
6868         local nodes_sort
6869         local i
6870
6871         for i in $(seq $OSTCOUNT); do
6872                 host=ost${i}_HOST
6873                 failover_host=ost${i}failover_HOST
6874                 nodes="$nodes ${!host} ${!failover_host}"
6875         done
6876
6877         [ -n "$nodes" ] || nodes="${ost_HOST} ${ostfailover_HOST}"
6878         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6879         echo -n $nodes_sort
6880 }
6881
6882 # Get all of the server nodes, including active and passive nodes.
6883 all_server_nodes () {
6884         local nodes
6885         local nodes_sort
6886         local i
6887
6888         nodes="$mgs_HOST $mgsfailover_HOST $(all_mdts_nodes) $(all_osts_nodes)"
6889
6890         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6891         echo -n $nodes_sort
6892 }
6893
6894 # Get all of the client and server nodes, including active and passive nodes.
6895 all_nodes () {
6896         local nodes=$HOSTNAME
6897         local nodes_sort
6898         local i
6899
6900         # CLIENTS (if specified) contains the local client
6901         [ -n "$CLIENTS" ] && nodes=${CLIENTS//,/ }
6902
6903         if [ "$PDSH" -a "$PDSH" != "no_dsh" ]; then
6904                 nodes="$nodes $(all_server_nodes)"
6905         fi
6906
6907         nodes_sort=$(for i in $nodes; do echo $i; done | sort -u)
6908         echo -n $nodes_sort
6909 }
6910
6911 init_clients_lists () {
6912     # Sanity check: exclude the local client from RCLIENTS
6913     local clients=$(hostlist_expand "$RCLIENTS")
6914     local rclients=$(exclude_items_from_list "$clients" $HOSTNAME)
6915
6916     # Sanity check: exclude the dup entries
6917     RCLIENTS=$(for i in ${rclients//,/ }; do echo $i; done | sort -u)
6918
6919     clients="$SINGLECLIENT $HOSTNAME $RCLIENTS"
6920
6921     # Sanity check: exclude the dup entries from CLIENTS
6922     # for those configs which has SINGLCLIENT set to local client
6923     clients=$(for i in $clients; do echo $i; done | sort -u)
6924
6925     CLIENTS=$(comma_list $clients)
6926     local -a remoteclients=($RCLIENTS)
6927     for ((i=0; $i<${#remoteclients[@]}; i++)); do
6928             varname=CLIENT$((i + 2))
6929             eval $varname=${remoteclients[i]}
6930     done
6931
6932     CLIENTCOUNT=$((${#remoteclients[@]} + 1))
6933 }
6934
6935 get_random_entry () {
6936     local rnodes=$1
6937
6938     rnodes=${rnodes//,/ }
6939
6940     local -a nodes=($rnodes)
6941     local num=${#nodes[@]}
6942     local i=$((RANDOM * num * 2 / 65536))
6943
6944     echo ${nodes[i]}
6945 }
6946
6947 client_only () {
6948         [ -n "$CLIENTONLY" ] || [ "x$CLIENTMODSONLY" = "xyes" ]
6949 }
6950
6951 check_versions () {
6952     [ "$(lustre_version_code client)" = "$(lustre_version_code $SINGLEMDS)" -a \
6953       "$(lustre_version_code client)" = "$(lustre_version_code ost1)" ]
6954 }
6955
6956 get_node_count() {
6957     local nodes="$@"
6958     echo $nodes | wc -w || true
6959 }
6960
6961 mixed_ost_devs () {
6962     local nodes=$(osts_nodes)
6963     local osscount=$(get_node_count "$nodes")
6964     [ ! "$OSTCOUNT" = "$osscount" ]
6965 }
6966
6967 mixed_mdt_devs () {
6968     local nodes=$(mdts_nodes)
6969     local mdtcount=$(get_node_count "$nodes")
6970     [ ! "$MDSCOUNT" = "$mdtcount" ]
6971 }
6972
6973 generate_machine_file() {
6974     local nodes=${1//,/ }
6975     local machinefile=$2
6976     rm -f $machinefile
6977     for node in $nodes; do
6978         echo $node >>$machinefile || \
6979             { echo "can not generate machinefile $machinefile" && return 1; }
6980     done
6981 }
6982
6983 get_stripe () {
6984         local file=$1/stripe
6985
6986         touch $file
6987         $LFS getstripe -v $file || error "getstripe $file failed"
6988         rm -f $file
6989 }
6990
6991 setstripe_nfsserver () {
6992         local dir=$1
6993         local nfsexportdir=$2
6994         shift
6995         shift
6996
6997         local -a nfsexport=($(awk '"'$dir'" ~ $2 && $3 ~ "nfs" && $2 != "/" \
6998                 { print $1 }' /proc/mounts | cut -f 1 -d :))
6999
7000         # check that only one nfs mounted
7001         [[ -z $nfsexport ]] && echo "$dir is not nfs mounted" && return 1
7002         (( ${#nfsexport[@]} == 1 )) ||
7003                 error "several nfs mounts found for $dir: ${nfsexport[@]} !"
7004
7005         do_nodev ${nfsexport[0]} lfs setstripe $nfsexportdir "$@"
7006 }
7007
7008 # Check and add a test group.
7009 add_group() {
7010         local group_id=$1
7011         local group_name=$2
7012         local rc=0
7013
7014         local gid=$(getent group $group_name | cut -d: -f3)
7015         if [[ -n "$gid" ]]; then
7016                 [[ "$gid" -eq "$group_id" ]] || {
7017                         error_noexit "inconsistent group ID:" \
7018                                      "new: $group_id, old: $gid"
7019                         rc=1
7020                 }
7021         else
7022                 groupadd -g $group_id $group_name
7023                 rc=${PIPESTATUS[0]}
7024         fi
7025
7026         return $rc
7027 }
7028
7029 # Check and add a test user.
7030 add_user() {
7031         local user_id=$1
7032         shift
7033         local user_name=$1
7034         shift
7035         local group_name=$1
7036         shift
7037         local home=$1
7038         shift
7039         local opts="$@"
7040         local rc=0
7041
7042         local uid=$(getent passwd $user_name | cut -d: -f3)
7043         if [[ -n "$uid" ]]; then
7044                 if [[ "$uid" -eq "$user_id" ]]; then
7045                         local dir=$(getent passwd $user_name | cut -d: -f6)
7046                         if [[ "$dir" != "$home" ]]; then
7047                                 mkdir -p $home
7048                                 usermod -d $home $user_name
7049                                 rc=${PIPESTATUS[0]}
7050                         fi
7051                 else
7052                         error_noexit "inconsistent user ID:" \
7053                                      "new: $user_id, old: $uid"
7054                         rc=1
7055                 fi
7056         else
7057                 mkdir -p $home
7058                 useradd -M -u $user_id -d $home -g $group_name $opts $user_name
7059                 rc=${PIPESTATUS[0]}
7060         fi
7061
7062         return $rc
7063 }
7064
7065 check_runas_id_ret() {
7066     local myRC=0
7067     local myRUNAS_UID=$1
7068     local myRUNAS_GID=$2
7069     shift 2
7070     local myRUNAS=$@
7071     if [ -z "$myRUNAS" ]; then
7072         error_exit "myRUNAS command must be specified for check_runas_id"
7073     fi
7074     if $GSS_KRB5; then
7075         $myRUNAS krb5_login.sh || \
7076             error "Failed to refresh Kerberos V5 TGT for UID $myRUNAS_ID."
7077     fi
7078     mkdir $DIR/d0_runas_test
7079     chmod 0755 $DIR
7080     chown $myRUNAS_UID:$myRUNAS_GID $DIR/d0_runas_test
7081     $myRUNAS touch $DIR/d0_runas_test/f$$ || myRC=$?
7082     rm -rf $DIR/d0_runas_test
7083     return $myRC
7084 }
7085
7086 check_runas_id() {
7087     local myRUNAS_UID=$1
7088     local myRUNAS_GID=$2
7089     shift 2
7090     local myRUNAS=$@
7091     check_runas_id_ret $myRUNAS_UID $myRUNAS_GID $myRUNAS || \
7092         error "unable to write to $DIR/d0_runas_test as UID $myRUNAS_UID.
7093         Please set RUNAS_ID to some UID which exists on MDS and client or
7094         add user $myRUNAS_UID:$myRUNAS_GID on these nodes."
7095 }
7096
7097 # obtain the UID/GID for MPI_USER
7098 get_mpiuser_id() {
7099     local mpi_user=$1
7100
7101     MPI_USER_UID=$(do_facet client "getent passwd $mpi_user | cut -d: -f3;
7102 exit \\\${PIPESTATUS[0]}") || error_exit "failed to get the UID for $mpi_user"
7103
7104     MPI_USER_GID=$(do_facet client "getent passwd $mpi_user | cut -d: -f4;
7105 exit \\\${PIPESTATUS[0]}") || error_exit "failed to get the GID for $mpi_user"
7106 }
7107
7108 # obtain and cache Kerberos ticket-granting ticket
7109 refresh_krb5_tgt() {
7110     local myRUNAS_UID=$1
7111     local myRUNAS_GID=$2
7112     shift 2
7113     local myRUNAS=$@
7114     if [ -z "$myRUNAS" ]; then
7115         error_exit "myRUNAS command must be specified for refresh_krb5_tgt"
7116     fi
7117
7118     CLIENTS=${CLIENTS:-$HOSTNAME}
7119     do_nodes $CLIENTS "set -x
7120 if ! $myRUNAS krb5_login.sh; then
7121     echo "Failed to refresh Krb5 TGT for UID/GID $myRUNAS_UID/$myRUNAS_GID."
7122     exit 1
7123 fi"
7124 }
7125
7126 # Run multiop in the background, but wait for it to print
7127 # "PAUSING" to its stdout before returning from this function.
7128 multiop_bg_pause() {
7129     MULTIOP_PROG=${MULTIOP_PROG:-$MULTIOP}
7130     FILE=$1
7131     ARGS=$2
7132
7133     TMPPIPE=/tmp/multiop_open_wait_pipe.$$
7134     mkfifo $TMPPIPE
7135
7136     echo "$MULTIOP_PROG $FILE v$ARGS"
7137     $MULTIOP_PROG $FILE v$ARGS > $TMPPIPE &
7138
7139     echo "TMPPIPE=${TMPPIPE}"
7140     read -t 60 multiop_output < $TMPPIPE
7141     if [ $? -ne 0 ]; then
7142         rm -f $TMPPIPE
7143         return 1
7144     fi
7145     rm -f $TMPPIPE
7146     if [ "$multiop_output" != "PAUSING" ]; then
7147         echo "Incorrect multiop output: $multiop_output"
7148         kill -9 $PID
7149         return 1
7150     fi
7151
7152     return 0
7153 }
7154
7155 do_and_time () {
7156         local cmd="$1"
7157         local start
7158         local rc
7159
7160         start=$SECONDS
7161         eval '$cmd'
7162         [ ${PIPESTATUS[0]} -eq 0 ] || rc=1
7163
7164         echo $((SECONDS - start))
7165         return $rc
7166 }
7167
7168 inodes_available () {
7169         local IFree=$($LFS df -i $MOUNT | grep ^$FSNAME | awk '{ print $4 }' |
7170                 sort -un | head -n1) || return 1
7171         echo $((IFree))
7172 }
7173
7174 mdsrate_inodes_available () {
7175         local min_inodes=$(inodes_available)
7176         echo $((min_inodes * 99 / 100))
7177 }
7178
7179 # reset stat counters
7180 clear_stats() {
7181         local paramfile="$1"
7182         lctl set_param -n $paramfile=0
7183 }
7184
7185 # sum stat items
7186 calc_stats() {
7187         local paramfile="$1"
7188         local stat="$2"
7189         lctl get_param -n $paramfile |
7190                 awk '/^'$stat'/ { sum += $2 } END { printf("%0.0f", sum) }'
7191 }
7192
7193 calc_sum () {
7194         awk '{sum += $1} END { printf("%0.0f", sum) }'
7195 }
7196
7197 calc_osc_kbytes () {
7198         $LFS df $MOUNT > /dev/null
7199         $LCTL get_param -n osc.*[oO][sS][cC][-_][0-9a-f]*.$1 | calc_sum
7200 }
7201
7202 # save_lustre_params(comma separated facet list, parameter_mask)
7203 # generate a stream of formatted strings (<facet> <param name>=<param value>)
7204 save_lustre_params() {
7205         local facets=$1
7206         local facet
7207         local facet_svc
7208
7209         for facet in ${facets//,/ }; do
7210                 facet_svc=$(facet_svc $facet)
7211                 do_facet $facet \
7212                         "params=\\\$($LCTL get_param $2);
7213                          [[ -z \\\"$facet_svc\\\" ]] && param= ||
7214                          param=\\\$(grep $facet_svc <<< \\\"\\\$params\\\");
7215                          [[ -z \\\$param ]] && param=\\\"\\\$params\\\";
7216                          while read s; do echo $facet \\\$s;
7217                          done <<< \\\"\\\$param\\\""
7218         done
7219 }
7220
7221 # restore lustre parameters from input stream, produces by save_lustre_params
7222 restore_lustre_params() {
7223         local facet
7224         local name
7225         local val
7226
7227         while IFS=" =" read facet name val; do
7228                 do_facet $facet "$LCTL set_param -n $name=$val"
7229         done
7230 }
7231
7232 check_node_health() {
7233         local nodes=${1:-$(comma_list $(nodes_list))}
7234
7235         for node in ${nodes//,/ }; do
7236                 check_network "$node" 5
7237                 if [ $? -eq 0 ]; then
7238                         do_node $node "$LCTL get_param catastrophe 2>&1" |
7239                                 grep -q "catastrophe=1" &&
7240                                 error "$node:LBUG/LASSERT detected" || true
7241                 fi
7242         done
7243 }
7244
7245 mdsrate_cleanup () {
7246         if [ -d $4 ]; then
7247                 mpi_run ${MACHINEFILE_OPTION} $2 -np $1 ${MDSRATE} --unlink \
7248                         --nfiles $3 --dir $4 --filefmt $5 $6
7249                 rmdir $4
7250         fi
7251 }
7252
7253 delayed_recovery_enabled () {
7254     local var=${SINGLEMDS}_svc
7255     do_facet $SINGLEMDS lctl get_param -n mdd.${!var}.stale_export_age > /dev/null 2>&1
7256 }
7257
7258 ########################
7259
7260 convert_facet2label() {
7261         local facet=$1
7262
7263         if [ x$facet = xost ]; then
7264                 facet=ost1
7265         elif [ x$facet = xmgs ] && combined_mgs_mds ; then
7266                 facet=mds1
7267         fi
7268
7269         local varsvc=${facet}_svc
7270
7271         if [ -n ${!varsvc} ]; then
7272                 echo ${!varsvc}
7273         else
7274                 error "No label for $facet!"
7275         fi
7276 }
7277
7278 get_clientosc_proc_path() {
7279         echo "${1}-osc-[-0-9a-f]*"
7280 }
7281
7282 # If the 2.0 MDS was mounted on 1.8 device, then the OSC and LOV names
7283 # used by MDT would not be changed.
7284 # mdt lov: fsname-mdtlov
7285 # mdt osc: fsname-OSTXXXX-osc
7286 mds_on_old_device() {
7287     local mds=${1:-"$SINGLEMDS"}
7288
7289     if [ $(lustre_version_code $mds) -gt $(version_code 1.9.0) ]; then
7290         do_facet $mds "lctl list_param osc.$FSNAME-OST*-osc \
7291             > /dev/null 2>&1" && return 0
7292     fi
7293     return 1
7294 }
7295
7296 get_mdtosc_proc_path() {
7297         local mds_facet=$1
7298         local ost_label=${2:-"*OST*"}
7299
7300         [ "$mds_facet" = "mds" ] && mds_facet=$SINGLEMDS
7301         local mdt_label=$(convert_facet2label $mds_facet)
7302         local mdt_index=$(echo $mdt_label | sed -e 's/^.*-//')
7303
7304         if [[ $ost_label = *OST* ]]; then
7305                 echo "${ost_label}-osc-${mdt_index}"
7306         else
7307                 echo "${ost_label}-osp-${mdt_index}"
7308         fi
7309 }
7310
7311 get_osc_import_name() {
7312     local facet=$1
7313     local ost=$2
7314     local label=$(convert_facet2label $ost)
7315
7316     if [ "${facet:0:3}" = "mds" ]; then
7317         get_mdtosc_proc_path $facet $label
7318         return 0
7319     fi
7320
7321     get_clientosc_proc_path $label
7322     return 0
7323 }
7324
7325 _wait_import_state () {
7326     local expected=$1
7327     local CONN_PROC=$2
7328     local maxtime=${3:-$(max_recovery_time)}
7329     local error_on_failure=${4:-1}
7330     local CONN_STATE
7331     local i=0
7332
7333         CONN_STATE=$($LCTL get_param -n $CONN_PROC 2>/dev/null | cut -f2 | uniq)
7334     while ! echo "${CONN_STATE}" | egrep -q "^${expected}\$" ; do
7335         if [ "${expected}" == "DISCONN" ]; then
7336             # for disconn we can check after proc entry is removed
7337             [ "x${CONN_STATE}" == "x" ] && return 0
7338             #  with AT enabled, we can have connect request timeout near of
7339             # reconnect timeout and test can't see real disconnect
7340             [ "${CONN_STATE}" == "CONNECTING" ] && return 0
7341         fi
7342         if [ $i -ge $maxtime ]; then
7343             [ $error_on_failure -ne 0 ] && \
7344                 error "can't put import for $CONN_PROC into ${expected}" \
7345                       "state after $i sec, have ${CONN_STATE}"
7346             return 1
7347         fi
7348         sleep 1
7349         # Add uniq for multi-mount case
7350         CONN_STATE=$($LCTL get_param -n $CONN_PROC 2>/dev/null | cut -f2 | uniq)
7351         i=$(($i + 1))
7352     done
7353
7354     log "$CONN_PROC in ${CONN_STATE} state after $i sec"
7355     return 0
7356 }
7357
7358 wait_import_state() {
7359     local state=$1
7360     local params=$2
7361     local maxtime=${3:-$(max_recovery_time)}
7362     local error_on_failure=${4:-1}
7363     local param
7364
7365     for param in ${params//,/ }; do
7366         _wait_import_state $state $param $maxtime $error_on_failure || return
7367     done
7368 }
7369
7370 wait_import_state_mount() {
7371         if ! is_mounted $MOUNT && ! is_mounted $MOUNT2; then
7372                 return 0
7373         fi
7374
7375         wait_import_state $*
7376 }
7377
7378 # One client request could be timed out because server was not ready
7379 # when request was sent by client.
7380 # The request timeout calculation details :
7381 # ptl_send_rpc ()
7382 #      /* We give the server rq_timeout secs to process the req, and
7383 #      add the network latency for our local timeout. */
7384 #      request->rq_deadline = request->rq_sent + request->rq_timeout +
7385 #           ptlrpc_at_get_net_latency(request) ;
7386 #
7387 # ptlrpc_connect_import ()
7388 #      request->rq_timeout = INITIAL_CONNECT_TIMEOUT
7389 #
7390 # init_imp_at () ->
7391 #   -> at_init(&at->iat_net_latency, 0, 0) -> iat_net_latency=0
7392 # ptlrpc_at_get_net_latency(request) ->
7393 #       at_get (max (iat_net_latency=0, at_min)) = at_min
7394 #
7395 # i.e.:
7396 # request->rq_timeout + ptlrpc_at_get_net_latency(request) =
7397 # INITIAL_CONNECT_TIMEOUT + at_min
7398 #
7399 # We will use obd_timeout instead of INITIAL_CONNECT_TIMEOUT
7400 # because we can not get this value in runtime,
7401 # the value depends on configure options, and it is not stored in /proc.
7402 # obd_support.h:
7403 # #define CONNECTION_SWITCH_MIN 5U
7404 # #define INITIAL_CONNECT_TIMEOUT max(CONNECTION_SWITCH_MIN,obd_timeout/20)
7405
7406 request_timeout () {
7407     local facet=$1
7408
7409     # request->rq_timeout = INITIAL_CONNECT_TIMEOUT
7410     local init_connect_timeout=$TIMEOUT
7411     [[ $init_connect_timeout -ge 5 ]] || init_connect_timeout=5
7412
7413     local at_min=$(at_get $facet at_min)
7414
7415     echo $(( init_connect_timeout + at_min ))
7416 }
7417
7418 _wait_osc_import_state() {
7419         local facet=$1
7420         local ost_facet=$2
7421         local expected=$3
7422         local target=$(get_osc_import_name $facet $ost_facet)
7423         local param="os[cp].${target}.ost_server_uuid"
7424         local params=$param
7425         local i=0
7426
7427         # 1. wait the deadline of client 1st request (it could be skipped)
7428         # 2. wait the deadline of client 2nd request
7429         local maxtime=$(( 2 * $(request_timeout $facet)))
7430
7431         if [[ $facet == client* ]]; then
7432                 # During setup time, the osc might not be setup, it need wait
7433                 # until list_param can return valid value.
7434                 params=$($LCTL list_param $param 2>/dev/null || true)
7435                 while [ -z "$params" ]; do
7436                         if [ $i -ge $maxtime ]; then
7437                                 echo "can't get $param in $maxtime secs"
7438                                 return 1
7439                         fi
7440                         sleep 1
7441                         i=$((i + 1))
7442                         params=$($LCTL list_param $param 2>/dev/null || true)
7443                 done
7444         fi
7445
7446         if [[ $ost_facet = mds* ]]; then
7447                 # no OSP connection to itself
7448                 if [[ $facet = $ost_facet ]]; then
7449                         return 0
7450                 fi
7451                 param="osp.${target}.mdt_server_uuid"
7452                 params=$param
7453         fi
7454
7455         if ! do_rpc_nodes "$(facet_active_host $facet)" \
7456                         wait_import_state $expected "$params" $maxtime; then
7457                 error "$facet: import is not in $expected state after $maxtime"
7458                 return 1
7459         fi
7460
7461         return 0
7462 }
7463
7464 wait_osc_import_state() {
7465         local facet=$1
7466         local ost_facet=$2
7467         local expected=$3
7468         local num
7469
7470         if [[ $facet = mds ]]; then
7471                 for num in $(seq $MDSCOUNT); do
7472                         _wait_osc_import_state mds$num "$ost_facet" "$expected"
7473                 done
7474         else
7475                 _wait_osc_import_state "$facet" "$ost_facet" "$expected"
7476         fi
7477 }
7478
7479 wait_osc_import_ready() {
7480         wait_osc_import_state $1 $2 "\(FULL\|IDLE\)"
7481 }
7482
7483 _wait_mgc_import_state() {
7484         local facet=$1
7485         local expected=$2
7486         local error_on_failure=${3:-1}
7487         local param="mgc.*.mgs_server_uuid"
7488         local params=$param
7489         local i=0
7490
7491         # 1. wait the deadline of client 1st request (it could be skipped)
7492         # 2. wait the deadline of client 2nd request
7493         local maxtime=$(( 2 * $(request_timeout $facet)))
7494
7495         if [[ $facet == client* ]]; then
7496                 # During setup time, the osc might not be setup, it need wait
7497                 # until list_param can return valid value. And also if there
7498                 # are mulitple osc entries we should list all of them before
7499                 # go to wait.
7500                 params=$($LCTL list_param $param 2>/dev/null || true)
7501                 while [ -z "$params" ]; do
7502                         if [ $i -ge $maxtime ]; then
7503                                 echo "can't get $param in $maxtime secs"
7504                                 return 1
7505                         fi
7506                         sleep 1
7507                         i=$((i + 1))
7508                         params=$($LCTL list_param $param 2>/dev/null || true)
7509                 done
7510         fi
7511         if ! do_rpc_nodes "$(facet_active_host $facet)" \
7512                         wait_import_state $expected "$params" $maxtime \
7513                                           $error_on_failure; then
7514                 if [ $error_on_failure -ne 0 ]; then
7515                     error "import is not in ${expected} state"
7516                 fi
7517                 return 1
7518         fi
7519
7520         return 0
7521 }
7522
7523 wait_mgc_import_state() {
7524         local facet=$1
7525         local expected=$2
7526         local error_on_failure=${3:-1}
7527         local num
7528
7529         if [[ $facet = mds ]]; then
7530                 for num in $(seq $MDSCOUNT); do
7531                         _wait_mgc_import_state mds$num "$expected" \
7532                                                $error_on_failure || return
7533                 done
7534         else
7535                 _wait_mgc_import_state "$facet" "$expected"
7536                                        $error_on_failure || return
7537         fi
7538 }
7539
7540 wait_dne_interconnect() {
7541         local num
7542
7543         if [ $MDSCOUNT -gt 1 ]; then
7544                 for num in $(seq $MDSCOUNT); do
7545                         wait_osc_import_ready mds mds$num
7546                 done
7547         fi
7548 }
7549
7550 get_clientmdc_proc_path() {
7551     echo "${1}-mdc-*"
7552 }
7553
7554 get_clientmgc_proc_path() {
7555     echo "*"
7556 }
7557
7558 do_rpc_nodes () {
7559         local list=$1
7560         shift
7561
7562         [ -z "$list" ] && return 0
7563
7564         # Add paths to lustre tests for 32 and 64 bit systems.
7565         local LIBPATH="/usr/lib/lustre/tests:/usr/lib64/lustre/tests:"
7566         local TESTPATH="$RLUSTRE/tests:"
7567         local RPATH="PATH=${TESTPATH}${LIBPATH}${PATH}:/sbin:/bin:/usr/sbin:"
7568         do_nodesv $list "${RPATH} NAME=${NAME} bash rpc.sh $@ "
7569 }
7570
7571 wait_clients_import_state () {
7572         local list=$1
7573         local facet=$2
7574         local expected=$3
7575
7576         local facets=$facet
7577
7578         if [ "$FAILURE_MODE" = HARD ]; then
7579                 facets=$(facets_on_host $(facet_active_host $facet))
7580         fi
7581
7582         for facet in ${facets//,/ }; do
7583                 local label=$(convert_facet2label $facet)
7584                 local proc_path
7585                 case $facet in
7586                 ost* ) proc_path="osc.$(get_clientosc_proc_path \
7587                                   $label).ost_server_uuid" ;;
7588                 mds* ) proc_path="mdc.$(get_clientmdc_proc_path \
7589                                   $label).mds_server_uuid" ;;
7590                 mgs* ) proc_path="mgc.$(get_clientmgc_proc_path \
7591                                   $label).mgs_server_uuid" ;;
7592                 *) error "unknown facet!" ;;
7593                 esac
7594
7595                 local params=$(expand_list $params $proc_path)
7596         done
7597
7598         if ! do_rpc_nodes "$list" wait_import_state_mount "$expected" $params;
7599         then
7600                 error "import is not in ${expected} state"
7601                 return 1
7602         fi
7603 }
7604
7605 wait_osp_active() {
7606         local facet=$1
7607         local tgt_name=$2
7608         local tgt_idx=$3
7609         local expected=$4
7610         local num
7611
7612         # wait until all MDTs are in the expected state
7613         for ((num = 1; num <= $MDSCOUNT; num++)); do
7614                 local mdtosp=$(get_mdtosc_proc_path mds${num} ${tgt_name})
7615                 local wait=0
7616                 local mproc
7617
7618                 if [ $facet = "mds" ]; then
7619                         mproc="osp.$mdtosp.active"
7620                         [ $num -eq $((tgt_idx + 1)) ] && continue
7621                 else
7622                         mproc="osc.$mdtosp.active"
7623                 fi
7624
7625                 echo "check $mproc"
7626                 while [ 1 ]; do
7627                         sleep 5
7628                         local result=$(do_facet mds${num} "$LCTL get_param -n $mproc")
7629                         local max=30
7630
7631                         [ ${PIPESTATUS[0]} = 0 ] || error "Can't read $mproc"
7632                         if [ $result -eq $expected ]; then
7633                                 echo -n "target updated after "
7634                                 echo "$wait sec (got $result)"
7635                                 break
7636                         fi
7637                         wait=$((wait + 5))
7638                         if [ $wait -eq $max ]; then
7639                                 error "$tgt_name: wanted $expected got $result"
7640                         fi
7641                         echo "Waiting $((max - wait)) secs for $tgt_name"
7642                 done
7643         done
7644 }
7645
7646 oos_full() {
7647         local -a AVAILA
7648         local -a GRANTA
7649         local -a TOTALA
7650         local OSCFULL=1
7651         AVAILA=($(do_nodes $(comma_list $(osts_nodes)) \
7652                   $LCTL get_param obdfilter.*.kbytesavail))
7653         GRANTA=($(do_nodes $(comma_list $(osts_nodes)) \
7654                   $LCTL get_param -n obdfilter.*.tot_granted))
7655         TOTALA=($(do_nodes $(comma_list $(osts_nodes)) \
7656                   $LCTL get_param -n obdfilter.*.kbytestotal))
7657         for ((i=0; i<${#AVAILA[@]}; i++)); do
7658                 local -a AVAIL1=(${AVAILA[$i]//=/ })
7659                 local -a TOTAL=(${TOTALA[$i]//=/ })
7660                 GRANT=$((${GRANTA[$i]}/1024))
7661                 # allow 1% of total space in bavail because of delayed
7662                 # allocation with ZFS which might release some free space after
7663                 # txg commit.  For small devices, we set a mininum of 8MB
7664                 local LIMIT=$((${TOTAL} / 100 + 8000))
7665                 echo -n $(echo ${AVAIL1[0]} | cut -d"." -f2) avl=${AVAIL1[1]} \
7666                         grnt=$GRANT diff=$((AVAIL1[1] - GRANT)) limit=${LIMIT}
7667                 [ $((AVAIL1[1] - GRANT)) -lt $LIMIT ] && OSCFULL=0 && \
7668                         echo " FULL" || echo
7669         done
7670         return $OSCFULL
7671 }
7672
7673 list_pool() {
7674         echo -e "$(do_facet $SINGLEMDS $LCTL pool_list $1 | sed '1d')"
7675 }
7676
7677 check_pool_not_exist() {
7678         local fsname=${1%%.*}
7679         local poolname=${1##$fsname.}
7680         [[ $# -ne 1 ]] && return 0
7681         [[ x$poolname = x ]] &&  return 0
7682         list_pool $fsname | grep -w $1 && return 1
7683         return 0
7684 }
7685
7686 create_pool() {
7687         local fsname=${1%%.*}
7688         local poolname=${1##$fsname.}
7689
7690         stack_trap "destroy_test_pools $fsname" EXIT
7691         do_facet mgs lctl pool_new $1
7692         local RC=$?
7693         # get param should return err unless pool is created
7694         [[ $RC -ne 0 ]] && return $RC
7695
7696         for mds_id in $(seq $MDSCOUNT); do
7697                 local mdt_id=$((mds_id-1))
7698                 local lodname=$fsname-MDT$(printf "%04x" $mdt_id)-mdtlov
7699                 wait_update_facet mds$mds_id \
7700                         "lctl get_param -n lod.$lodname.pools.$poolname \
7701                                 2>/dev/null || echo foo" "" ||
7702                         error "mds$mds_id: pool_new failed $1"
7703         done
7704         wait_update $HOSTNAME "lctl get_param -n lov.$fsname-*.pools.$poolname \
7705                 2>/dev/null || echo foo" "" || error "pool_new failed $1"
7706
7707         add_pool_to_list $1
7708         return $RC
7709 }
7710
7711 add_pool_to_list () {
7712         local fsname=${1%%.*}
7713         local poolname=${1##$fsname.}
7714
7715         local listvar=${fsname}_CREATED_POOLS
7716         local temp=${listvar}=$(expand_list ${!listvar} $poolname)
7717         eval export $temp
7718 }
7719
7720 remove_pool_from_list () {
7721         local fsname=${1%%.*}
7722         local poolname=${1##$fsname.}
7723
7724         local listvar=${fsname}_CREATED_POOLS
7725         local temp=${listvar}=$(exclude_items_from_list ${!listvar} $poolname)
7726         eval export $temp
7727 }
7728
7729 destroy_pool_int() {
7730         local ost
7731         local OSTS=$(list_pool $1)
7732         for ost in $OSTS; do
7733                 do_facet mgs lctl pool_remove $1 $ost
7734         done
7735         wait_update_facet $SINGLEMDS "lctl pool_list $1 | wc -l" "1" ||
7736                 error "MDS: pool_list $1 failed"
7737         do_facet mgs lctl pool_destroy $1
7738 }
7739
7740 # <fsname>.<poolname> or <poolname>
7741 destroy_pool() {
7742         local fsname=${1%%.*}
7743         local poolname=${1##$fsname.}
7744
7745         [[ x$fsname = x$poolname ]] && fsname=$FSNAME
7746
7747         local RC
7748
7749         check_pool_not_exist $fsname.$poolname
7750         [[ $? -eq 0 ]] && return 0
7751
7752         destroy_pool_int $fsname.$poolname
7753         RC=$?
7754         [[ $RC -ne 0 ]] && return $RC
7755         for mds_id in $(seq $MDSCOUNT); do
7756                 local mdt_id=$((mds_id-1))
7757                 local lodname=$fsname-MDT$(printf "%04x" $mdt_id)-mdtlov
7758                 wait_update_facet mds$mds_id \
7759                         "lctl get_param -n lod.$lodname.pools.$poolname \
7760                                 2>/dev/null || echo foo" "foo" ||
7761                         error "mds$mds_id: destroy pool failed $1"
7762         done
7763         wait_update $HOSTNAME "lctl get_param -n lov.$fsname-*.pools.$poolname \
7764                 2>/dev/null || echo foo" "foo" || error "destroy pool failed $1"
7765
7766         remove_pool_from_list $fsname.$poolname
7767
7768         return $RC
7769 }
7770
7771 destroy_pools () {
7772         local fsname=${1:-$FSNAME}
7773         local poolname
7774         local listvar=${fsname}_CREATED_POOLS
7775
7776         [ x${!listvar} = x ] && return 0
7777
7778         echo "Destroy the created pools: ${!listvar}"
7779         for poolname in ${!listvar//,/ }; do
7780                 destroy_pool $fsname.$poolname
7781         done
7782 }
7783
7784 destroy_test_pools () {
7785         trap 0
7786         local fsname=${1:-$FSNAME}
7787         destroy_pools $fsname || true
7788 }
7789
7790 gather_logs () {
7791         local list=$1
7792
7793         local ts=$(date +%s)
7794         local docp=true
7795
7796         if [[ ! -f "$YAML_LOG" ]]; then
7797                 # init_logging is not performed before gather_logs,
7798                 # so the $LOGDIR needs to be checked here
7799                 check_shared_dir $LOGDIR && touch $LOGDIR/shared
7800         fi
7801
7802         [ -f $LOGDIR/shared ] && docp=false
7803
7804         # dump lustre logs, dmesg, and journal if GSS_SK=true
7805
7806         prefix="$TESTLOG_PREFIX.$TESTNAME"
7807         suffix="$ts.log"
7808         echo "Dumping lctl log to ${prefix}.*.${suffix}"
7809
7810         if [ -n "$CLIENTONLY" -o "$PDSH" == "no_dsh" ]; then
7811                 echo "Dumping logs only on local client."
7812                 $LCTL dk > ${prefix}.debug_log.$(hostname -s).${suffix}
7813                 dmesg > ${prefix}.dmesg.$(hostname -s).${suffix}
7814                 [ "$SHARED_KEY" = true ] && find $SK_PATH -name '*.key' -exec \
7815                         lgss_sk -r {} \; &> \
7816                         ${prefix}.ssk_keys.$(hostname -s).${suffix}
7817                 [ "$SHARED_KEY" = true ] && lctl get_param 'nodemap.*.*' > \
7818                         ${prefix}.nodemaps.$(hostname -s).${suffix}
7819                 [ "$GSS_SK" = true ] && keyctl show > \
7820                         ${prefix}.keyring.$(hostname -s).${suffix}
7821                 [ "$GSS_SK" = true ] && journalctl -a > \
7822                         ${prefix}.journal.$(hostname -s).${suffix}
7823                 return
7824         fi
7825
7826         do_nodesv $list \
7827                 "$LCTL dk > ${prefix}.debug_log.\\\$(hostname -s).${suffix};
7828                 dmesg > ${prefix}.dmesg.\\\$(hostname -s).${suffix}"
7829         if [ "$SHARED_KEY" = true ]; then
7830                 do_nodesv $list "find $SK_PATH -name '*.key' -exec \
7831                         lgss_sk -r {} \; &> \
7832                         ${prefix}.ssk_keys.\\\$(hostname -s).${suffix}"
7833                 do_facet mds1 "lctl get_param 'nodemap.*.*' > \
7834                         ${prefix}.nodemaps.\\\$(hostname -s).${suffix}"
7835         fi
7836         if [ "$GSS_SK" = true ]; then
7837                 do_nodesv $list "keyctl show > \
7838                         ${prefix}.keyring.\\\$(hostname -s).${suffix}"
7839                 do_nodesv $list "journalctl -a > \
7840                         ${prefix}.journal.\\\$(hostname -s).${suffix}"
7841         fi
7842
7843         if [ ! -f $LOGDIR/shared ]; then
7844                 do_nodes $list rsync -az "${prefix}.*.${suffix}" \
7845                          $HOSTNAME:$LOGDIR
7846         fi
7847 }
7848
7849 do_ls () {
7850     local mntpt_root=$1
7851     local num_mntpts=$2
7852     local dir=$3
7853     local i
7854     local cmd
7855     local pids
7856     local rc=0
7857
7858     for i in $(seq 0 $num_mntpts); do
7859         cmd="ls -laf ${mntpt_root}$i/$dir"
7860         echo + $cmd;
7861         $cmd > /dev/null &
7862         pids="$pids $!"
7863     done
7864     echo pids=$pids
7865     for pid in $pids; do
7866         wait $pid || rc=$?
7867     done
7868
7869     return $rc
7870 }
7871
7872 # check_and_start_recovery_timer()
7873 #       service_time = at_est2timeout(service_time);
7874 #       service_time += 2 * INITIAL_CONNECT_TIMEOUT;
7875 #       service_time += 2 * (CONNECTION_SWITCH_MAX + CONNECTION_SWITCH_INC);
7876
7877 #define INITIAL_CONNECT_TIMEOUT max(CONNECTION_SWITCH_MIN, obd_timeout/20)
7878 #define CONNECTION_SWITCH_MAX min(50, max(CONNECTION_SWITCH_MIN, obd_timeout))
7879 #define CONNECTION_SWITCH_MIN 5
7880 #define CONNECTION_SWITCH_INC 5
7881 max_recovery_time() {
7882         local init_connect_timeout=$((TIMEOUT / 20))
7883         ((init_connect_timeout >= 5)) || init_connect_timeout=5
7884
7885         local service_time=$(($(at_max_get client) * 9 / 4 + 5))
7886         service_time=$((service_time + 2 * (init_connect_timeout + 50 + 5)))
7887
7888         echo -n $service_time
7889 }
7890
7891 recovery_time_min() {
7892         local connection_switch_min=5
7893         local connection_switch_inc=5
7894         local connection_switch_max
7895         local reconnect_delay_max
7896         local initial_connect_timeout
7897         local max
7898         local timout_20
7899
7900         #connection_switch_max=min(50, max($connection_switch_min,$TIMEOUT)
7901         (($connection_switch_min > $TIMEOUT)) &&
7902                 max=$connection_switch_min || max=$TIMEOUT
7903         (($max < 50)) && connection_switch_max=$max || connection_switch_max=50
7904
7905         #initial_connect_timeout = max(connection_switch_min, obd_timeout/20)
7906         timeout_20=$((TIMEOUT/20))
7907         (($connection_switch_min > $timeout_20)) &&
7908                 initial_connect_timeout=$connection_switch_min ||
7909                 initial_connect_timeout=$timeout_20
7910
7911         reconnect_delay_max=$((connection_switch_max + connection_switch_inc + \
7912                                initial_connect_timeout))
7913         echo $((2 * reconnect_delay_max))
7914 }
7915
7916 get_clients_mount_count () {
7917         local clients=${CLIENTS:-$HOSTNAME}
7918
7919         # we need to take into account the clients mounts and
7920         # exclude mds/ost mounts if any;
7921         do_nodes $clients cat /proc/mounts | grep lustre |
7922                 grep -w $MOUNT | wc -l
7923 }
7924
7925 # gss functions
7926 PROC_CLI="srpc_info"
7927 PROC_CON="srpc_contexts"
7928
7929 combination()
7930 {
7931     local M=$1
7932     local N=$2
7933     local R=1
7934
7935     if [ $M -lt $N ]; then
7936         R=0
7937     else
7938         N=$((N + 1))
7939         while [ $N -lt $M ]; do
7940             R=$((R * N))
7941             N=$((N + 1))
7942         done
7943     fi
7944
7945     echo $R
7946     return 0
7947 }
7948
7949 calc_connection_cnt() {
7950         local dir=$1
7951
7952         # MDT->MDT = 2 * C(M, 2)
7953         # MDT->OST = M * O
7954         # CLI->OST = C * O
7955         # CLI->MDT = C * M
7956         comb_m2=$(combination $MDSCOUNT 2)
7957
7958         local num_clients=$(get_clients_mount_count)
7959
7960         local cnt_mdt2mdt=$((comb_m2 * 2))
7961         local cnt_mdt2ost=$((MDSCOUNT * OSTCOUNT))
7962         local cnt_cli2ost=$((num_clients * OSTCOUNT))
7963         local cnt_cli2mdt=$((num_clients * MDSCOUNT))
7964         if is_mounted $MOUNT2; then
7965                 cnt_cli2mdt=$((cnt_cli2mdt * 2))
7966                 cnt_cli2ost=$((cnt_cli2ost * 2))
7967         fi
7968         if local_mode; then
7969                 cnt_mdt2mdt=0
7970                 cnt_mdt2ost=0
7971                 cnt_cli2ost=2
7972                 cnt_cli2mdt=1
7973         fi
7974         local cnt_all2ost=$((cnt_mdt2ost + cnt_cli2ost))
7975         local cnt_all2mdt=$((cnt_mdt2mdt + cnt_cli2mdt))
7976         local cnt_all2all=$((cnt_mdt2ost + cnt_mdt2mdt \
7977                 + cnt_cli2ost + cnt_cli2mdt))
7978
7979         local var=cnt_$dir
7980         local res=${!var}
7981
7982         echo $res
7983 }
7984
7985 set_rule()
7986 {
7987     local tgt=$1
7988     local net=$2
7989     local dir=$3
7990     local flavor=$4
7991     local cmd="$tgt.srpc.flavor"
7992
7993     if [ $net == "any" ]; then
7994         net="default"
7995     fi
7996     cmd="$cmd.$net"
7997
7998     if [ $dir != "any" ]; then
7999         cmd="$cmd.$dir"
8000     fi
8001
8002     cmd="$cmd=$flavor"
8003     log "Setting sptlrpc rule: $cmd"
8004     do_facet mgs "$LCTL conf_param $cmd"
8005 }
8006
8007 count_contexts()
8008 {
8009         local output=$1
8010         local total_ctx=$(echo "$output" | grep -c "expire.*key.*hdl")
8011         echo $total_ctx
8012 }
8013
8014 count_flvr()
8015 {
8016     local output=$1
8017     local flavor=$2
8018     local count=0
8019
8020     rpc_flvr=`echo $flavor | awk -F - '{ print $1 }'`
8021     bulkspec=`echo $flavor | awk -F - '{ print $2 }'`
8022
8023     count=`echo "$output" | grep "rpc flavor" | grep $rpc_flvr | wc -l`
8024
8025     if [ "x$bulkspec" != "x" ]; then
8026         algs=`echo $bulkspec | awk -F : '{ print $2 }'`
8027
8028         if [ "x$algs" != "x" ]; then
8029             bulk_count=`echo "$output" | grep "bulk flavor" | grep $algs | wc -l`
8030         else
8031             bulk=`echo $bulkspec | awk -F : '{ print $1 }'`
8032             if [ $bulk == "bulkn" ]; then
8033                 bulk_count=`echo "$output" | grep "bulk flavor" \
8034                             | grep "null/null" | wc -l`
8035             elif [ $bulk == "bulki" ]; then
8036                 bulk_count=`echo "$output" | grep "bulk flavor" \
8037                             | grep "/null" | grep -v "null/" | wc -l`
8038             else
8039                 bulk_count=`echo "$output" | grep "bulk flavor" \
8040                             | grep -v "/null" | grep -v "null/" | wc -l`
8041             fi
8042         fi
8043
8044         [ $bulk_count -lt $count ] && count=$bulk_count
8045     fi
8046
8047     echo $count
8048 }
8049
8050 flvr_cnt_cli2mdt()
8051 {
8052     local flavor=$1
8053     local cnt
8054
8055     local clients=${CLIENTS:-$HOSTNAME}
8056
8057     for c in ${clients//,/ }; do
8058         local output=$(do_node $c lctl get_param -n \
8059                  mdc.*-*-mdc-*.$PROC_CLI 2>/dev/null)
8060         local tmpcnt=$(count_flvr "$output" $flavor)
8061         if $GSS_SK && [ $flavor != "null" ]; then
8062                 # tmpcnt=min(contexts,flavors) to ensure SK context is on
8063                 output=$(do_node $c lctl get_param -n \
8064                          mdc.*-MDT*-mdc-*.$PROC_CON 2>/dev/null)
8065                 local outcon=$(count_contexts "$output")
8066                 if [ "$outcon" -lt "$tmpcnt" ]; then
8067                         tmpcnt=$outcon
8068                 fi
8069         fi
8070         cnt=$((cnt + tmpcnt))
8071     done
8072     echo $cnt
8073 }
8074
8075 flvr_cnt_cli2ost()
8076 {
8077     local flavor=$1
8078     local cnt
8079
8080     local clients=${CLIENTS:-$HOSTNAME}
8081
8082     for c in ${clients//,/ }; do
8083         # reconnect if idle
8084         do_node $c lctl set_param osc.*.idle_connect=1 >/dev/null 2>&1
8085         local output=$(do_node $c lctl get_param -n \
8086                  osc.*OST*-osc-[^M][^D][^T]*.$PROC_CLI 2>/dev/null)
8087         local tmpcnt=$(count_flvr "$output" $flavor)
8088         if $GSS_SK && [ $flavor != "null" ]; then
8089                 # tmpcnt=min(contexts,flavors) to ensure SK context is on
8090                 output=$(do_node $c lctl get_param -n \
8091                          osc.*OST*-osc-[^M][^D][^T]*.$PROC_CON 2>/dev/null)
8092                 local outcon=$(count_contexts "$output")
8093                 if [ "$outcon" -lt "$tmpcnt" ]; then
8094                         tmpcnt=$outcon
8095                 fi
8096         fi
8097         cnt=$((cnt + tmpcnt))
8098     done
8099     echo $cnt
8100 }
8101
8102 flvr_cnt_mdt2mdt()
8103 {
8104     local flavor=$1
8105     local cnt=0
8106
8107     if [ $MDSCOUNT -le 1 ]; then
8108         echo 0
8109         return
8110     fi
8111
8112     for num in `seq $MDSCOUNT`; do
8113         local output=$(do_facet mds$num lctl get_param -n \
8114                 osp.*-MDT*osp-MDT*.$PROC_CLI 2>/dev/null)
8115         local tmpcnt=$(count_flvr "$output" $flavor)
8116         if $GSS_SK && [ $flavor != "null" ]; then
8117                 # tmpcnt=min(contexts,flavors) to ensure SK context is on
8118                 output=$(do_facet mds$num lctl get_param -n \
8119                         osp.*-MDT*osp-MDT*.$PROC_CON 2>/dev/null)
8120                 local outcon=$(count_contexts "$output")
8121                 if [ "$outcon" -lt "$tmpcnt" ]; then
8122                         tmpcnt=$outcon
8123                 fi
8124         fi
8125         cnt=$((cnt + tmpcnt))
8126     done
8127     echo $cnt;
8128 }
8129
8130 flvr_cnt_mdt2ost()
8131 {
8132     local flavor=$1
8133     local cnt=0
8134     local mdtosc
8135
8136     for num in `seq $MDSCOUNT`; do
8137         mdtosc=$(get_mdtosc_proc_path mds$num)
8138         mdtosc=${mdtosc/-MDT*/-MDT\*}
8139         local output=$(do_facet mds$num lctl get_param -n \
8140                        os[cp].$mdtosc.$PROC_CLI 2>/dev/null)
8141         local tmpcnt=$(count_flvr "$output" $flavor)
8142         if $GSS_SK && [ $flavor != "null" ]; then
8143                 # tmpcnt=min(contexts,flavors) to ensure SK context is on
8144                 output=$(do_facet mds$num lctl get_param -n \
8145                          os[cp].$mdtosc.$PROC_CON 2>/dev/null)
8146                 local outcon=$(count_contexts "$output")
8147                 if [ "$outcon" -lt "$tmpcnt" ]; then
8148                         tmpcnt=$outcon
8149                 fi
8150         fi
8151         cnt=$((cnt + tmpcnt))
8152     done
8153     echo $cnt;
8154 }
8155
8156 flvr_cnt_mgc2mgs()
8157 {
8158     local flavor=$1
8159
8160     local output=$(do_facet client lctl get_param -n mgc.*.$PROC_CLI \
8161                         2>/dev/null)
8162     count_flvr "$output" $flavor
8163 }
8164
8165 do_check_flavor()
8166 {
8167     local dir=$1        # from to
8168     local flavor=$2     # flavor expected
8169     local res=0
8170
8171     if [ $dir == "cli2mdt" ]; then
8172         res=`flvr_cnt_cli2mdt $flavor`
8173     elif [ $dir == "cli2ost" ]; then
8174         res=`flvr_cnt_cli2ost $flavor`
8175     elif [ $dir == "mdt2mdt" ]; then
8176         res=`flvr_cnt_mdt2mdt $flavor`
8177     elif [ $dir == "mdt2ost" ]; then
8178         res=`flvr_cnt_mdt2ost $flavor`
8179     elif [ $dir == "all2ost" ]; then
8180         res1=`flvr_cnt_mdt2ost $flavor`
8181         res2=`flvr_cnt_cli2ost $flavor`
8182         res=$((res1 + res2))
8183     elif [ $dir == "all2mdt" ]; then
8184         res1=`flvr_cnt_mdt2mdt $flavor`
8185         res2=`flvr_cnt_cli2mdt $flavor`
8186         res=$((res1 + res2))
8187     elif [ $dir == "all2all" ]; then
8188         res1=`flvr_cnt_mdt2ost $flavor`
8189         res2=`flvr_cnt_cli2ost $flavor`
8190         res3=`flvr_cnt_mdt2mdt $flavor`
8191         res4=`flvr_cnt_cli2mdt $flavor`
8192         res=$((res1 + res2 + res3 + res4))
8193     fi
8194
8195     echo $res
8196 }
8197
8198 wait_flavor()
8199 {
8200         local dir=$1        # from to
8201         local flavor=$2     # flavor expected
8202         local expect=${3:-$(calc_connection_cnt $dir)} # number expected
8203         local WAITFLAVOR_MAX=20 # how many retries before abort?
8204
8205         local res=0
8206         for ((i = 0; i < $WAITFLAVOR_MAX; i++)); do
8207                 echo -n "checking $dir..."
8208                 res=$(do_check_flavor $dir $flavor)
8209                 echo "found $res/$expect $flavor connections"
8210                 [ $res -ge $expect ] && return 0
8211                 sleep 4
8212         done
8213
8214         echo "Error checking $flavor of $dir: expect $expect, actual $res"
8215 #       echo "Dumping additional logs for SK debug.."
8216         do_nodes $(comma_list $(all_server_nodes)) "keyctl show"
8217         if $dump; then
8218                 gather_logs $(comma_list $(nodes_list))
8219         fi
8220         return 1
8221 }
8222
8223 restore_to_default_flavor()
8224 {
8225         local proc="mgs.MGS.live.$FSNAME"
8226
8227         echo "restoring to default flavor..."
8228
8229         local nrule=$(do_facet mgs lctl get_param -n $proc 2>/dev/null |
8230                 grep ".srpc.flavor" | wc -l)
8231
8232         # remove all existing rules if any
8233         if [ $nrule -ne 0 ]; then
8234                 echo "$nrule existing rules"
8235                 for rule in $(do_facet mgs lctl get_param -n $proc 2>/dev/null |
8236                     grep ".srpc.flavor."); do
8237                         echo "remove rule: $rule"
8238                         spec=`echo $rule | awk -F = '{print $1}'`
8239                         do_facet mgs "$LCTL conf_param -d $spec"
8240                 done
8241         fi
8242
8243         # verify no rules left
8244         nrule=$(do_facet mgs lctl get_param -n $proc 2>/dev/null |
8245                 grep ".srpc.flavor." | wc -l)
8246         [ $nrule -ne 0 ] && error "still $nrule rules left"
8247
8248         # wait for default flavor to be applied
8249         if $GSS_SK; then
8250                 if $SK_S2S; then
8251                         set_rule $FSNAME any any $SK_FLAVOR
8252                         wait_flavor all2all $SK_FLAVOR
8253                 else
8254                         set_rule $FSNAME any cli2mdt $SK_FLAVOR
8255                         set_rule $FSNAME any cli2ost $SK_FLAVOR
8256                         wait_flavor cli2mdt $SK_FLAVOR
8257                         wait_flavor cli2ost $SK_FLAVOR
8258                 fi
8259                 echo "GSS_SK now at default flavor: $SK_FLAVOR"
8260         else
8261                 wait_flavor all2all null
8262         fi
8263 }
8264
8265 set_flavor_all()
8266 {
8267         local flavor=${1:-null}
8268
8269         echo "setting all flavor to $flavor"
8270
8271         # FIXME need parameter to this fn
8272         # and remove global vars
8273         local cnt_all2all=$(calc_connection_cnt all2all)
8274
8275         local res=$(do_check_flavor all2all $flavor)
8276         if [ $res -eq $cnt_all2all ]; then
8277                 echo "already have total $res $flavor connections"
8278                 return
8279         fi
8280
8281         echo "found $res $flavor out of total $cnt_all2all connections"
8282         restore_to_default_flavor
8283
8284         [[ $flavor = null ]] && return 0
8285
8286         if $GSS_SK && [ $flavor != "null" ]; then
8287                 if $SK_S2S; then
8288                         set_rule $FSNAME any any $flavor
8289                         wait_flavor all2all $flavor
8290                 else
8291                         set_rule $FSNAME any cli2mdt $flavor
8292                         set_rule $FSNAME any cli2ost $flavor
8293                         set_rule $FSNAME any mdt2ost null
8294                         set_rule $FSNAME any mdt2mdt null
8295                         wait_flavor cli2mdt $flavor
8296                         wait_flavor cli2ost $flavor
8297                 fi
8298                 echo "GSS_SK now at flavor: $flavor"
8299         else
8300                 set_rule $FSNAME any any $flavor
8301                 wait_flavor all2all $flavor
8302         fi
8303 }
8304
8305
8306 check_logdir() {
8307     local dir=$1
8308     # Checking for shared logdir
8309     if [ ! -d $dir ]; then
8310         # Not found. Create local logdir
8311         mkdir -p $dir
8312     else
8313         touch $dir/check_file.$(hostname -s)
8314     fi
8315     return 0
8316 }
8317
8318 check_write_access() {
8319         local dir=$1
8320         local list=${2:-$(comma_list $(nodes_list))}
8321         local node
8322         local file
8323
8324         for node in ${list//,/ }; do
8325                 file=$dir/check_file.$(short_nodename $node)
8326                 if [[ ! -f "$file" ]]; then
8327                         # Logdir not accessible/writable from this node.
8328                         return 1
8329                 fi
8330                 rm -f $file || return 1
8331         done
8332         return 0
8333 }
8334
8335 init_logging() {
8336         [[ -n $YAML_LOG ]] && return
8337         local save_umask=$(umask)
8338         umask 0000
8339
8340         export YAML_LOG=${LOGDIR}/results.yml
8341         mkdir -p $LOGDIR
8342         init_clients_lists
8343
8344         # If the yaml log already exists then we will just append to it
8345         if [ ! -f $YAML_LOG ]; then
8346                 if check_shared_dir $LOGDIR; then
8347                         touch $LOGDIR/shared
8348                         echo "Logging to shared log directory: $LOGDIR"
8349                 else
8350                         echo "Logging to local directory: $LOGDIR"
8351                 fi
8352
8353                 yml_nodes_file $LOGDIR >> $YAML_LOG
8354                 yml_results_file >> $YAML_LOG
8355         fi
8356
8357         umask $save_umask
8358
8359         # log actual client and server versions if needed for debugging
8360         log "Client: $(lustre_build_version client)"
8361         log "MDS: $(lustre_build_version mds1)"
8362         log "OSS: $(lustre_build_version ost1)"
8363 }
8364
8365 log_test() {
8366     yml_log_test $1 >> $YAML_LOG
8367 }
8368
8369 log_test_status() {
8370      yml_log_test_status $@ >> $YAML_LOG
8371 }
8372
8373 log_sub_test_begin() {
8374     yml_log_sub_test_begin "$@" >> $YAML_LOG
8375 }
8376
8377 log_sub_test_end() {
8378     yml_log_sub_test_end "$@" >> $YAML_LOG
8379 }
8380
8381 run_llverdev()
8382 {
8383         local dev=$1
8384         local llverdev_opts=$2
8385         local devname=$(basename $1)
8386         local size=$(grep "$devname"$ /proc/partitions | awk '{print $3}')
8387         # loop devices aren't in /proc/partitions
8388         [ "x$size" == "x" ] && local size=$(ls -l $dev | awk '{print $5}')
8389
8390         size=$(($size / 1024 / 1024)) # Gb
8391
8392         local partial_arg=""
8393         # Run in partial (fast) mode if the size
8394         # of a partition > 1 GB
8395         [ $size -gt 1 ] && partial_arg="-p"
8396
8397         llverdev --force $partial_arg $llverdev_opts $dev
8398 }
8399
8400 run_llverfs()
8401 {
8402         local dir=$1
8403         local llverfs_opts=$2
8404         local use_partial_arg=$3
8405         local partial_arg=""
8406         local size=$(df -B G $dir |tail -n 1 |awk '{print $2}' |sed 's/G//') #GB
8407
8408         # Run in partial (fast) mode if the size
8409         # of a partition > 1 GB
8410         [ "x$use_partial_arg" != "xno" ] && [ $size -gt 1 ] && partial_arg="-p"
8411
8412         llverfs $partial_arg $llverfs_opts $dir
8413 }
8414
8415 #Remove objects from OST
8416 remove_ost_objects() {
8417         local facet=$1
8418         local ostdev=$2
8419         local group=$3
8420         shift 3
8421         local objids="$@"
8422         local mntpt=$(facet_mntpt $facet)
8423         local opts=$OST_MOUNT_OPTS
8424         local i
8425         local rc
8426
8427         echo "removing objects from $ostdev on $facet: $objids"
8428         if ! test -b $ostdev; then
8429                 opts=$(csa_add "$opts" -o loop)
8430         fi
8431         mount -t $(facet_fstype $facet) $opts $ostdev $mntpt ||
8432                 return $?
8433         rc=0
8434         for i in $objids; do
8435                 rm $mntpt/O/$group/d$((i % 32))/$i || { rc=$?; break; }
8436         done
8437         umount -f $mntpt || return $?
8438         return $rc
8439 }
8440
8441 #Remove files from MDT
8442 remove_mdt_files() {
8443         local facet=$1
8444         local mdtdev=$2
8445         shift 2
8446         local files="$@"
8447         local mntpt=$(facet_mntpt $facet)
8448         local opts=$MDS_MOUNT_OPTS
8449
8450         echo "removing files from $mdtdev on $facet: $files"
8451         if [ $(facet_fstype $facet) == ldiskfs ] &&
8452            ! do_facet $facet test -b $mdtdev; then
8453                 opts=$(csa_add "$opts" -o loop)
8454         fi
8455         mount -t $(facet_fstype $facet) $opts $mdtdev $mntpt ||
8456                 return $?
8457         rc=0
8458         for f in $files; do
8459                 rm $mntpt/ROOT/$f || { rc=$?; break; }
8460         done
8461         umount -f $mntpt || return $?
8462         return $rc
8463 }
8464
8465 duplicate_mdt_files() {
8466         local facet=$1
8467         local mdtdev=$2
8468         shift 2
8469         local files="$@"
8470         local mntpt=$(facet_mntpt $facet)
8471         local opts=$MDS_MOUNT_OPTS
8472
8473         echo "duplicating files on $mdtdev on $facet: $files"
8474         mkdir -p $mntpt || return $?
8475         if [ $(facet_fstype $facet) == ldiskfs ] &&
8476            ! do_facet $facet test -b $mdtdev; then
8477                 opts=$(csa_add "$opts" -o loop)
8478         fi
8479         mount -t $(facet_fstype $facet) $opts $mdtdev $mntpt ||
8480                 return $?
8481
8482     do_umount() {
8483         trap 0
8484         popd > /dev/null
8485         rm $tmp
8486         umount -f $mntpt
8487     }
8488     trap do_umount EXIT
8489
8490     tmp=$(mktemp $TMP/setfattr.XXXXXXXXXX)
8491     pushd $mntpt/ROOT > /dev/null || return $?
8492     rc=0
8493     for f in $files; do
8494         touch $f.bad || return $?
8495         getfattr -n trusted.lov $f | sed "s#$f#&.bad#" > $tmp
8496         rc=${PIPESTATUS[0]}
8497         [ $rc -eq 0 ] || return $rc
8498         setfattr --restore $tmp || return $?
8499     done
8500     do_umount
8501 }
8502
8503 run_sgpdd () {
8504     local devs=${1//,/ }
8505     shift
8506     local params=$@
8507     local rslt=$TMP/sgpdd_survey
8508
8509     # sgpdd-survey cleanups ${rslt}.* files
8510
8511     local cmd="rslt=$rslt $params scsidevs=\"$devs\" $SGPDDSURVEY"
8512     echo + $cmd
8513     eval $cmd
8514     cat ${rslt}.detail
8515 }
8516
8517 # returns the canonical name for an ldiskfs device
8518 ldiskfs_canon() {
8519         local dev="$1"
8520         local facet="$2"
8521
8522         do_facet $facet "dv=\\\$($LCTL get_param -n $dev);
8523                          if foo=\\\$(lvdisplay -c \\\$dv 2>/dev/null); then
8524                                 echo dm-\\\${foo##*:};
8525                          else
8526                                 name=\\\$(basename \\\$dv);
8527                                 if [[ \\\$name = *flakey* ]]; then
8528                                         name=\\\$(lsblk -o NAME,KNAME |
8529                                                 awk /\\\$name/'{print \\\$NF}');
8530                                 fi;
8531                                 echo \\\$name;
8532                          fi;"
8533 }
8534
8535 is_sanity_benchmark() {
8536     local benchmarks="dbench bonnie iozone fsx"
8537     local suite=$1
8538     for b in $benchmarks; do
8539         if [ "$b" == "$suite" ]; then
8540             return 0
8541         fi
8542     done
8543     return 1
8544 }
8545
8546 min_ost_size () {
8547         $LFS df | grep OST | awk '{print $4}' | sort -un | head -1
8548 }
8549
8550 #
8551 # Get the available size (KB) of a given obd target.
8552 #
8553 get_obd_size() {
8554         local facet=$1
8555         local obd=$2
8556         local size
8557
8558         [[ $facet != client ]] || return 0
8559
8560         size=$(do_facet $facet $LCTL get_param -n *.$obd.kbytesavail | head -n1)
8561         echo -n $size
8562 }
8563
8564 #
8565 # Get the page size (bytes) on a given facet node.
8566 # The local client page_size is directly available in PAGE_SIZE.
8567 #
8568 get_page_size() {
8569         local facet=$1
8570         local page_size=$(getconf PAGE_SIZE 2>/dev/null)
8571
8572         [ -z "$CLIENTONLY" -a "$facet" != "client" ] &&
8573                 page_size=$(do_facet $facet getconf PAGE_SIZE)
8574         echo -n ${page_size:-4096}
8575 }
8576
8577 #
8578 # Get the block count of the filesystem.
8579 #
8580 get_block_count() {
8581         local facet=$1
8582         local device=$2
8583         local count
8584
8585         [ -z "$CLIENTONLY" ] && count=$(do_facet $facet "$DUMPE2FS -h $device 2>&1" |
8586                 awk '/^Block count:/ {print $3}')
8587         echo -n ${count:-0}
8588 }
8589
8590 # Get the block size of the filesystem.
8591 get_block_size() {
8592         local facet=$1
8593         local device=$2
8594         local size
8595
8596         [ -z "$CLIENTONLY" ] && size=$(do_facet $facet "$DUMPE2FS -h $device 2>&1" |
8597                 awk '/^Block size:/ {print $3}')
8598         echo -n ${size:-0}
8599 }
8600
8601 # Check whether the "ea_inode" feature is enabled or not, to allow
8602 # ldiskfs xattrs over one block in size.  Allow both the historical
8603 # Lustre feature name (large_xattr) and the upstream name (ea_inode).
8604 large_xattr_enabled() {
8605         [[ $(facet_fstype $SINGLEMDS) == zfs ]] && return 1
8606
8607         local mds_dev=$(mdsdevname ${SINGLEMDS//mds/})
8608
8609         do_facet $SINGLEMDS "$DUMPE2FS -h $mds_dev 2>&1 |
8610                 grep -E -q '(ea_inode|large_xattr)'"
8611         return ${PIPESTATUS[0]}
8612 }
8613
8614 # Get the maximum xattr size supported by the filesystem.
8615 max_xattr_size() {
8616         $LCTL get_param -n llite.*.max_easize
8617 }
8618
8619 # Dump the value of the named xattr from a file.
8620 get_xattr_value() {
8621     local xattr_name=$1
8622     local file=$2
8623
8624     echo "$(getfattr -n $xattr_name --absolute-names --only-values $file)"
8625 }
8626
8627 # Generate a string with size of $size bytes.
8628 generate_string() {
8629     local size=${1:-1024} # in bytes
8630
8631     echo "$(head -c $size < /dev/zero | tr '\0' y)"
8632 }
8633
8634 reformat_external_journal() {
8635         local facet=$1
8636         local var
8637
8638         var=${facet}_JRN
8639         if [ -n "${!var}" ]; then
8640                 local rcmd="do_facet $facet"
8641
8642                 echo "reformat external journal on $facet:${!var}"
8643                 ${rcmd} mke2fs -O journal_dev ${!var} || return 1
8644         fi
8645 }
8646
8647 # MDT file-level backup/restore
8648 mds_backup_restore() {
8649         local facet=$1
8650         local igif=$2
8651         local devname=$(mdsdevname $(facet_number $facet))
8652         local mntpt=$(facet_mntpt brpt)
8653         local rcmd="do_facet $facet"
8654         local metaea=${TMP}/backup_restore.ea
8655         local metadata=${TMP}/backup_restore.tgz
8656         local opts=${MDS_MOUNT_FS_OPTS}
8657         local svc=${facet}_svc
8658
8659         if ! ${rcmd} test -b ${devname}; then
8660                 opts=$(csa_add "$opts" -o loop)
8661         fi
8662
8663         echo "file-level backup/restore on $facet:${devname}"
8664
8665         # step 1: build mount point
8666         ${rcmd} mkdir -p $mntpt
8667         # step 2: cleanup old backup
8668         ${rcmd} rm -f $metaea $metadata
8669         # step 3: mount dev
8670         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 1
8671         if [ ! -z $igif ]; then
8672                 # step 3.5: rm .lustre
8673                 ${rcmd} rm -rf $mntpt/ROOT/.lustre || return 1
8674         fi
8675         # step 4: backup metaea
8676         echo "backup EA"
8677         ${rcmd} "cd $mntpt && getfattr -R -d -m '.*' -P . > $metaea && cd -" ||
8678                 return 2
8679         # step 5: backup metadata
8680         echo "backup data"
8681         ${rcmd} tar zcf $metadata -C $mntpt/ . > /dev/null 2>&1 || return 3
8682         # step 6: umount
8683         ${rcmd} $UMOUNT $mntpt || return 4
8684         # step 8: reformat dev
8685         echo "reformat new device"
8686         format_mdt $(facet_number $facet)
8687         # step 9: mount dev
8688         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 7
8689         # step 10: restore metadata
8690         echo "restore data"
8691         ${rcmd} tar zxfp $metadata -C $mntpt > /dev/null 2>&1 || return 8
8692         # step 11: restore metaea
8693         echo "restore EA"
8694         ${rcmd} "cd $mntpt && setfattr --restore=$metaea && cd - " || return 9
8695         # step 12: remove recovery logs
8696         echo "remove recovery logs"
8697         ${rcmd} rm -fv $mntpt/OBJECTS/* $mntpt/CATALOGS
8698         # step 13: umount dev
8699         ${rcmd} $UMOUNT $mntpt || return 10
8700         # step 14: cleanup tmp backup
8701         ${rcmd} rm -f $metaea $metadata
8702         # step 15: reset device label - it's not virgin on
8703         ${rcmd} e2label $devname ${!svc}
8704 }
8705
8706 # remove OI files
8707 mds_remove_ois() {
8708         local facet=$1
8709         local idx=$2
8710         local devname=$(mdsdevname $(facet_number $facet))
8711         local mntpt=$(facet_mntpt brpt)
8712         local rcmd="do_facet $facet"
8713         local opts=${MDS_MOUNT_FS_OPTS}
8714
8715         if ! ${rcmd} test -b ${devname}; then
8716                 opts=$(csa_add "$opts" -o loop)
8717         fi
8718
8719         echo "removing OI files on $facet: idx=${idx}"
8720
8721         # step 1: build mount point
8722         ${rcmd} mkdir -p $mntpt
8723         # step 2: mount dev
8724         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 1
8725         if [ -z $idx ]; then
8726                 # step 3: remove all OI files
8727                 ${rcmd} rm -fv $mntpt/oi.16*
8728         elif [ $idx -lt 2 ]; then
8729                 ${rcmd} rm -fv $mntpt/oi.16.${idx}
8730         else
8731                 local i
8732
8733                 # others, rm oi.16.[idx, idx * idx, idx ** ...]
8734                 for ((i=${idx}; i<64; i=$((i * idx)))); do
8735                         ${rcmd} rm -fv $mntpt/oi.16.${i}
8736                 done
8737         fi
8738         # step 4: umount
8739         ${rcmd} $UMOUNT $mntpt || return 2
8740         # OI files will be recreated when mounted as lustre next time.
8741 }
8742
8743 # generate maloo upload-able log file name
8744 # \param logname specify unique part of file name
8745 generate_logname() {
8746         local logname=${1:-"default_logname"}
8747
8748         echo "$TESTLOG_PREFIX.$TESTNAME.$logname.$(hostname -s).log"
8749 }
8750
8751 # make directory on different MDTs
8752 test_mkdir() {
8753         local path
8754         local p_option
8755         local hash_type
8756         local hash_name=("all_char" "fnv_1a_64" "crush")
8757         local dirstripe_count=${DIRSTRIPE_COUNT:-"2"}
8758         local dirstripe_index=${DIRSTRIPE_INDEX:-$((base % $MDSCOUNT))}
8759         local OPTIND=1
8760
8761         while getopts "c:H:i:p" opt; do
8762                 case $opt in
8763                         c) dirstripe_count=$OPTARG;;
8764                         H) hash_type=$OPTARG;;
8765                         i) dirstripe_index=$OPTARG;;
8766                         p) p_option="-p";;
8767                         \?) error "only support -c -H -i -p";;
8768                 esac
8769         done
8770
8771         shift $((OPTIND - 1))
8772         [ $# -eq 1 ] || error "Only creating single directory is supported"
8773         path="$*"
8774
8775         if [ "$p_option" == "-p" ]; then
8776                 local parent=$(dirname $path)
8777
8778                 [ -d $path ] && return 0
8779                 if [ ! -d ${parent} ]; then
8780                         mkdir -p ${parent} ||
8781                                 error "mkdir parent '$parent' failed"
8782                 fi
8783         fi
8784
8785         if [ $MDSCOUNT -le 1 ]; then
8786                 mkdir $path || error "mkdir '$path' failed"
8787         else
8788                 local mdt_index
8789
8790                 if [ $dirstripe_index -eq -1 ]; then
8791                         mdt_index=$((base % MDSCOUNT))
8792                 else
8793                         mdt_index=$dirstripe_index
8794                 fi
8795
8796                 # randomly choose hash type
8797                 [ -z "$hash_type" ] &&
8798                         hash_type=${hash_name[$((RANDOM % ${#hash_name[@]}))]}
8799
8800                 if (($MDS1_VERSION >= $(version_code 2.8.0))); then
8801                         if [ $dirstripe_count -eq -1 ]; then
8802                                 dirstripe_count=$((RANDOM % MDSCOUNT + 1))
8803                         fi
8804                 else
8805                         dirstripe_count=1
8806                 fi
8807
8808                 echo "striped dir -i$mdt_index -c$dirstripe_count -H $hash_type $path"
8809                 $LFS mkdir -i$mdt_index -c$dirstripe_count -H $hash_type $path ||
8810                         error "mkdir -i $mdt_index -c$dirstripe_count -H $hash_type $path failed"
8811         fi
8812 }
8813
8814 # free_fd: find the smallest and not in use file descriptor [above @last_fd]
8815 #
8816 # If called many times, passing @last_fd will avoid repeated searching
8817 # already-open FDs repeatedly if we know they are still in use.
8818 #
8819 # usage: free_fd [last_fd]
8820 free_fd()
8821 {
8822         local max_fd=$(ulimit -n)
8823         local fd=$((${1:-2} + 1))
8824
8825         while [[ $fd -le $max_fd && -e /proc/self/fd/$fd ]]; do
8826                 ((++fd))
8827         done
8828         [ $fd -lt $max_fd ] || error "finding free file descriptor failed"
8829         echo $fd
8830 }
8831
8832 check_mount_and_prep()
8833 {
8834         is_mounted $MOUNT || setupall
8835
8836         rm -rf $DIR/[df][0-9]* || error "Fail to cleanup the env!"
8837         mkdir $DIR/$tdir || error "Fail to mkdir $DIR/$tdir."
8838         for idx in $(seq $MDSCOUNT); do
8839                 local name="MDT$(printf '%04x' $((idx - 1)))"
8840                 rm -rf $MOUNT/.lustre/lost+found/$name/*
8841         done
8842 }
8843
8844 # calcule how many ost-objects to be created.
8845 precreated_ost_obj_count()
8846 {
8847         local mdt_idx=$1
8848         local ost_idx=$2
8849         local mdt_name="MDT$(printf '%04x' $mdt_idx)"
8850         local ost_name="OST$(printf '%04x' $ost_idx)"
8851         local proc_path="${FSNAME}-${ost_name}-osc-${mdt_name}"
8852         local last_id=$(do_facet mds$((mdt_idx + 1)) lctl get_param -n \
8853                         osp.$proc_path.prealloc_last_id)
8854         local next_id=$(do_facet mds$((mdt_idx + 1)) lctl get_param -n \
8855                         osp.$proc_path.prealloc_next_id)
8856         echo $((last_id - next_id + 1))
8857 }
8858
8859 check_file_in_pool()
8860 {
8861         local file=$1
8862         local pool=$2
8863         local tlist="$3"
8864         local res=$($LFS getstripe $file | grep 0x | cut -f2)
8865         for i in $res
8866         do
8867                 for t in $tlist ; do
8868                         [ "$i" -eq "$t" ] && continue 2
8869                 done
8870
8871                 echo "pool list: $tlist"
8872                 echo "striping: $res"
8873                 error_noexit "$file not allocated in $pool"
8874                 return 1
8875         done
8876         return 0
8877 }
8878
8879 pool_add() {
8880         echo "Creating new pool"
8881         local pool=$1
8882
8883         create_pool $FSNAME.$pool ||
8884                 { error_noexit "No pool created, result code $?"; return 1; }
8885         [ $($LFS pool_list $FSNAME | grep -c "$FSNAME.${pool}\$") -eq 1 ] ||
8886                 { error_noexit "$pool not in lfs pool_list"; return 2; }
8887 }
8888
8889 pool_add_targets() {
8890         echo "Adding targets to pool"
8891         local pool=$1
8892         local first=$2
8893         local last=$3
8894         local step=${4:-1}
8895
8896         if [ -z $last ]; then
8897                 local list=$first
8898         else
8899                 local list=$(seq $first $step $last)
8900         fi
8901
8902         local t=$(for i in $list; do printf "$FSNAME-OST%04x_UUID " $i; done)
8903         do_facet mgs $LCTL pool_add \
8904                         $FSNAME.$pool $FSNAME-OST[$first-$last/$step]
8905
8906         # wait for OSTs to be added to the pool
8907         for mds_id in $(seq $MDSCOUNT); do
8908                 local mdt_id=$((mds_id-1))
8909                 local lodname=$FSNAME-MDT$(printf "%04x" $mdt_id)-mdtlov
8910                 wait_update_facet mds$mds_id \
8911                         "lctl get_param -n lod.$lodname.pools.$pool |
8912                                 sort -u | tr '\n' ' ' " "$t" || {
8913                         error_noexit "mds$mds_id: Add to pool failed"
8914                         return 3
8915                 }
8916         done
8917         wait_update $HOSTNAME "lctl get_param -n lov.$FSNAME-*.pools.$pool \
8918                         | sort -u | tr '\n' ' ' " "$t" || {
8919                 error_noexit "Add to pool failed"
8920                 return 1
8921         }
8922         local lfscount=$($LFS pool_list $FSNAME.$pool | grep -c "\-OST")
8923         local addcount=$(((last - first) / step + 1))
8924         [ $lfscount -eq $addcount ] || {
8925                 error_noexit "lfs pool_list bad ost count" \
8926                                                 "$lfscount != $addcount"
8927                 return 2
8928         }
8929 }
8930
8931 pool_set_dir() {
8932         local pool=$1
8933         local tdir=$2
8934         echo "Setting pool on directory $tdir"
8935
8936         $LFS setstripe -c 2 -p $pool $tdir && return 0
8937
8938         error_noexit "Cannot set pool $pool to $tdir"
8939         return 1
8940 }
8941
8942 pool_check_dir() {
8943         local pool=$1
8944         local tdir=$2
8945         echo "Checking pool on directory $tdir"
8946
8947         local res=$($LFS getstripe --pool $tdir | sed "s/\s*$//")
8948         [ "$res" = "$pool" ] && return 0
8949
8950         error_noexit "Pool on '$tdir' is '$res', not '$pool'"
8951         return 1
8952 }
8953
8954 pool_dir_rel_path() {
8955         echo "Testing relative path works well"
8956         local pool=$1
8957         local tdir=$2
8958         local root=$3
8959
8960         mkdir -p $root/$tdir/$tdir
8961         cd $root/$tdir
8962         pool_set_dir $pool $tdir          || return 1
8963         pool_set_dir $pool ./$tdir        || return 2
8964         pool_set_dir $pool ../$tdir       || return 3
8965         pool_set_dir $pool ../$tdir/$tdir || return 4
8966         rm -rf $tdir; cd - > /dev/null
8967 }
8968
8969 pool_alloc_files() {
8970         echo "Checking files allocation from directory pool"
8971         local pool=$1
8972         local tdir=$2
8973         local count=$3
8974         local tlist="$4"
8975
8976         local failed=0
8977         for i in $(seq -w 1 $count)
8978         do
8979                 local file=$tdir/file-$i
8980                 touch $file
8981                 check_file_in_pool $file $pool "$tlist" || \
8982                         failed=$((failed + 1))
8983         done
8984         [ "$failed" = 0 ] && return 0
8985
8986         error_noexit "$failed files not allocated in $pool"
8987         return 1
8988 }
8989
8990 pool_create_files() {
8991         echo "Creating files in pool"
8992         local pool=$1
8993         local tdir=$2
8994         local count=$3
8995         local tlist="$4"
8996
8997         mkdir -p $tdir
8998         local failed=0
8999         for i in $(seq -w 1 $count)
9000         do
9001                 local file=$tdir/spoo-$i
9002                 $LFS setstripe -p $pool $file
9003                 check_file_in_pool $file $pool "$tlist" || \
9004                         failed=$((failed + 1))
9005         done
9006         [ "$failed" = 0 ] && return 0
9007
9008         error_noexit "$failed files not allocated in $pool"
9009         return 1
9010 }
9011
9012 pool_lfs_df() {
9013         echo "Checking 'lfs df' output"
9014         local pool=$1
9015
9016         local t=$($LCTL get_param -n lov.$FSNAME-clilov-*.pools.$pool |
9017                         tr '\n' ' ')
9018         local res=$($LFS df --pool $FSNAME.$pool |
9019                         awk '{print $1}' |
9020                         grep "$FSNAME-OST" |
9021                         tr '\n' ' ')
9022         [ "$res" = "$t" ] && return 0
9023
9024         error_noexit "Pools OSTs '$t' is not '$res' that lfs df reports"
9025         return 1
9026 }
9027
9028 pool_file_rel_path() {
9029         echo "Creating files in a pool with relative pathname"
9030         local pool=$1
9031         local tdir=$2
9032
9033         mkdir -p $tdir ||
9034                 { error_noexit "unable to create $tdir"; return 1 ; }
9035         local file="/..$tdir/$tfile-1"
9036         $LFS setstripe -p $pool $file ||
9037                 { error_noexit "unable to create $file" ; return 2 ; }
9038
9039         cd $tdir
9040         $LFS setstripe -p $pool $tfile-2 || {
9041                 error_noexit "unable to create $tfile-2 in $tdir"
9042                 return 3
9043         }
9044 }
9045
9046 pool_remove_first_target() {
9047         echo "Removing first target from a pool"
9048         pool_remove_target $1 -1
9049 }
9050
9051 pool_remove_target() {
9052         local pool=$1
9053         local index=$2
9054
9055         local pname="lov.$FSNAME-*.pools.$pool"
9056         if [ $index -eq -1 ]; then
9057                 local t=$($LCTL get_param -n $pname | head -1)
9058         else
9059                 local t=$(printf "$FSNAME-OST%04x_UUID" $index)
9060         fi
9061
9062         echo "Removing $t from $pool"
9063         do_facet mgs $LCTL pool_remove $FSNAME.$pool $t
9064         for mds_id in $(seq $MDSCOUNT); do
9065                 local mdt_id=$((mds_id-1))
9066                 local lodname=$FSNAME-MDT$(printf "%04x" $mdt_id)-mdtlov
9067                 wait_update_facet mds$mds_id \
9068                         "lctl get_param -n lod.$lodname.pools.$pool |
9069                                 grep $t" "" || {
9070                         error_noexit "mds$mds_id: $t not removed from" \
9071                         "$FSNAME.$pool"
9072                         return 2
9073                 }
9074         done
9075         wait_update $HOSTNAME "lctl get_param -n $pname | grep $t" "" || {
9076                 error_noexit "$t not removed from $FSNAME.$pool"
9077                 return 1
9078         }
9079 }
9080
9081 pool_remove_all_targets() {
9082         echo "Removing all targets from pool"
9083         local pool=$1
9084         local file=$2
9085         local pname="lov.$FSNAME-*.pools.$pool"
9086         for t in $($LCTL get_param -n $pname | sort -u)
9087         do
9088                 do_facet mgs $LCTL pool_remove $FSNAME.$pool $t
9089         done
9090         for mds_id in $(seq $MDSCOUNT); do
9091                 local mdt_id=$((mds_id-1))
9092                 local lodname=$FSNAME-MDT$(printf "%04x" $mdt_id)-mdtlov
9093                 wait_update_facet mds$mds_id "lctl get_param -n \
9094                         lod.$lodname.pools.$pool" "" || {
9095                         error_noexit "mds$mds_id: Pool $pool not drained"
9096                         return 4
9097                 }
9098         done
9099         wait_update $HOSTNAME "lctl get_param -n $pname" "" || {
9100                 error_noexit "Pool $FSNAME.$pool cannot be drained"
9101                 return 1
9102         }
9103         # striping on an empty/nonexistant pool should fall back
9104         # to "pool of everything"
9105         touch $file || {
9106                 error_noexit "failed to use fallback striping for empty pool"
9107                 return 2
9108         }
9109         # setstripe on an empty pool should fail
9110         $LFS setstripe -p $pool $file 2>/dev/null && {
9111                 error_noexit "expected failure when creating file" \
9112                                                         "with empty pool"
9113                 return 3
9114         }
9115         return 0
9116 }
9117
9118 pool_remove() {
9119         echo "Destroying pool"
9120         local pool=$1
9121         local file=$2
9122
9123         do_facet mgs $LCTL pool_destroy $FSNAME.$pool
9124
9125         sleep 2
9126         # striping on an empty/nonexistant pool should fall back
9127         # to "pool of everything"
9128         touch $file || {
9129                 error_noexit "failed to use fallback striping for missing pool"
9130                 return 1
9131         }
9132         # setstripe on an empty pool should fail
9133         $LFS setstripe -p $pool $file 2>/dev/null && {
9134                 error_noexit "expected failure when creating file" \
9135                                                         "with missing pool"
9136                 return 2
9137         }
9138
9139         # get param should return err once pool is gone
9140         if wait_update $HOSTNAME "lctl get_param -n \
9141                 lov.$FSNAME-*.pools.$pool 2>/dev/null || echo foo" "foo"
9142         then
9143                 remove_pool_from_list $FSNAME.$pool
9144                 return 0
9145         fi
9146         error_noexit "Pool $FSNAME.$pool is not destroyed"
9147         return 3
9148 }
9149
9150 # Get and check the actual stripe count of one file.
9151 # Usage: check_stripe_count <file> <expected_stripe_count>
9152 check_stripe_count() {
9153         local file=$1
9154         local expected=$2
9155         local actual
9156
9157         [[ -z "$file" || -z "$expected" ]] &&
9158                 error "check_stripe_count: invalid argument"
9159
9160         local cmd="$LFS getstripe -c $file"
9161         actual=$($cmd) || error "$cmd failed"
9162         actual=${actual%% *}
9163
9164         if [[ $actual -ne $expected ]]; then
9165                 [[ $expected -eq -1 ]] || { $LFS getstripe $file;
9166                         error "$cmd not expected ($expected): found $actual"; }
9167                 [[ $actual -eq $OSTCOUNT ]] || { $LFS getstripe $file;
9168                         error "$cmd not OST count ($OSTCOUNT): found $actual"; }
9169         fi
9170 }
9171
9172 # Get and check the actual list of OST indices on one file.
9173 # Usage: check_obdidx <file> <expected_comma_separated_list_of_ost_indices>
9174 check_obdidx() {
9175         local file=$1
9176         local expected=$2
9177         local obdidx
9178
9179         [[ -z "$file" || -z "$expected" ]] &&
9180                 error "check_obdidx: invalid argument!"
9181
9182         obdidx=$(comma_list $($LFS getstripe $file | grep -A $OSTCOUNT obdidx |
9183                               grep -v obdidx | awk '{print $1}' | xargs))
9184
9185         [[ $obdidx = $expected ]] ||
9186                 error "list of OST indices on $file is $obdidx," \
9187                       "should be $expected"
9188 }
9189
9190 # Get and check the actual OST index of the first stripe on one file.
9191 # Usage: check_start_ost_idx <file> <expected_start_ost_idx>
9192 check_start_ost_idx() {
9193         local file=$1
9194         local expected=$2
9195         local start_ost_idx
9196
9197         [[ -z "$file" || -z "$expected" ]] &&
9198                 error "check_start_ost_idx: invalid argument!"
9199
9200         start_ost_idx=$($LFS getstripe $file | grep -A 1 obdidx |
9201                          grep -v obdidx | awk '{print $1}')
9202
9203         [[ $start_ost_idx = $expected ]] ||
9204                 error "OST index of the first stripe on $file is" \
9205                       "$start_ost_idx, should be $expected"
9206 }
9207
9208 killall_process () {
9209         local clients=${1:-$(hostname)}
9210         local name=$2
9211         local signal=$3
9212         local rc=0
9213
9214         do_nodes $clients "killall $signal $name"
9215 }
9216
9217 lsnapshot_create()
9218 {
9219         do_facet mgs "$LCTL snapshot_create -F $FSNAME $*"
9220 }
9221
9222 lsnapshot_destroy()
9223 {
9224         do_facet mgs "$LCTL snapshot_destroy -F $FSNAME $*"
9225 }
9226
9227 lsnapshot_modify()
9228 {
9229         do_facet mgs "$LCTL snapshot_modify -F $FSNAME $*"
9230 }
9231
9232 lsnapshot_list()
9233 {
9234         do_facet mgs "$LCTL snapshot_list -F $FSNAME $*"
9235 }
9236
9237 lsnapshot_mount()
9238 {
9239         do_facet mgs "$LCTL snapshot_mount -F $FSNAME $*"
9240 }
9241
9242 lsnapshot_umount()
9243 {
9244         do_facet mgs "$LCTL snapshot_umount -F $FSNAME $*"
9245 }
9246
9247 lss_err()
9248 {
9249         local msg=$1
9250
9251         do_facet mgs "cat $LSNAPSHOT_LOG"
9252         error $msg
9253 }
9254
9255 lss_cleanup()
9256 {
9257         echo "Cleaning test environment ..."
9258
9259         # Every lsnapshot command takes exclusive lock with others,
9260         # so can NOT destroy the snapshot during list with 'xargs'.
9261         while true; do
9262                 local ssname=$(lsnapshot_list | grep snapshot_name |
9263                         grep lss_ | awk '{ print $2 }' | head -n 1)
9264                 [ -z "$ssname" ] && break
9265
9266                 lsnapshot_destroy -n $ssname -f ||
9267                         lss_err "Fail to destroy $ssname by force"
9268         done
9269 }
9270
9271 lss_gen_conf_one()
9272 {
9273         local facet=$1
9274         local role=$2
9275         local idx=$3
9276
9277         local host=$(facet_active_host $facet)
9278         local dir=$(dirname $(facet_vdevice $facet))
9279         local pool=$(zpool_name $facet)
9280         local lfsname=$(zfs_local_fsname $facet)
9281         local label=${FSNAME}-${role}$(printf '%04x' $idx)
9282
9283         do_facet mgs \
9284                 "echo '$host - $label zfs:${dir}/${pool}/${lfsname} - -' >> \
9285                 $LSNAPSHOT_CONF"
9286 }
9287
9288 lss_gen_conf()
9289 {
9290         do_facet mgs "rm -f $LSNAPSHOT_CONF"
9291         echo "Generating $LSNAPSHOT_CONF on MGS ..."
9292
9293         if ! combined_mgs_mds ; then
9294                 [ $(facet_fstype mgs) != zfs ] &&
9295                         skip "Lustre snapshot 1 only works for ZFS backend"
9296
9297                 local host=$(facet_active_host mgs)
9298                 local dir=$(dirname $(facet_vdevice mgs))
9299                 local pool=$(zpool_name mgs)
9300                 local lfsname=$(zfs_local_fsname mgs)
9301
9302                 do_facet mgs \
9303                         "echo '$host - MGS zfs:${dir}/${pool}/${lfsname} - -' \
9304                         >> $LSNAPSHOT_CONF" || lss_err "generate lss conf (mgs)"
9305         fi
9306
9307         for num in `seq $MDSCOUNT`; do
9308                 [ $(facet_fstype mds$num) != zfs ] &&
9309                         skip "Lustre snapshot 1 only works for ZFS backend"
9310
9311                 lss_gen_conf_one mds$num MDT $((num - 1)) ||
9312                         lss_err "generate lss conf (mds$num)"
9313         done
9314
9315         for num in `seq $OSTCOUNT`; do
9316                 [ $(facet_fstype ost$num) != zfs ] &&
9317                         skip "Lustre snapshot 1 only works for ZFS backend"
9318
9319                 lss_gen_conf_one ost$num OST $((num - 1)) ||
9320                         lss_err "generate lss conf (ost$num)"
9321         done
9322
9323         do_facet mgs "cat $LSNAPSHOT_CONF"
9324 }
9325
9326 # Parse 'lfs getstripe -d <path_with_dir_name>' for non-composite dir
9327 parse_plain_dir_param()
9328 {
9329         local invalues=($1)
9330         local param=""
9331
9332         if [[ ${invalues[0]} =~ "stripe_count:" ]]; then
9333                 param="-c ${invalues[1]}"
9334         fi
9335         if [[ ${invalues[2]} =~ "stripe_size:" ]]; then
9336                 param="$param -S ${invalues[3]}"
9337         fi
9338         if [[ ${invalues[4]} =~ "pattern:" ]]; then
9339                 if [[ ${invalues[5]} =~ "stripe_offset:" ]]; then
9340                         param="$param -i ${invalues[6]}"
9341                 else
9342                         param="$param -L ${invalues[5]} -i ${invalues[7]}"
9343                 fi
9344         elif [[ ${invalues[4]} =~ "stripe_offset:" ]]; then
9345                 param="$param -i ${invalues[5]}"
9346         fi
9347         echo "$param"
9348 }
9349
9350 parse_plain_param()
9351 {
9352         local line=$1
9353         local val=$(awk '{print $2}' <<< $line)
9354
9355         if [[ $line =~ ^"lmm_stripe_count:" ]]; then
9356                 echo "-c $val"
9357         elif [[ $line =~ ^"lmm_stripe_size:" ]]; then
9358                 echo "-S $val"
9359         elif [[ $line =~ ^"lmm_stripe_offset:" ]]; then
9360                 echo "-i $val"
9361         elif [[ $line =~ ^"lmm_pattern:" ]]; then
9362                 echo "-L $val"
9363         fi
9364 }
9365
9366 parse_layout_param()
9367 {
9368         local mode=""
9369         local val=""
9370         local param=""
9371
9372         while read line; do
9373                 if [[ ! -z $line ]]; then
9374                         if [[ -z $mode ]]; then
9375                                 if [[ $line =~ ^"stripe_count:" ]]; then
9376                                         mode="plain_dir"
9377                                 elif [[ $line =~ ^"lmm_stripe_count:" ]]; then
9378                                         mode="plain_file"
9379                                 elif [[ $line =~ ^"lcm_layout_gen:" ]]; then
9380                                         mode="pfl"
9381                                 fi
9382                         fi
9383
9384                         if [[ $mode = "plain_dir" ]]; then
9385                                 param=$(parse_plain_dir_param "$line")
9386                         elif [[ $mode = "plain_file" ]]; then
9387                                 val=$(parse_plain_param "$line")
9388                                 [[ ! -z $val ]] && param="$param $val"
9389                         elif [[ $mode = "pfl" ]]; then
9390                                 val=$(echo $line | awk '{print $2}')
9391                                 if [[ $line =~ ^"lcme_extent.e_end:" ]]; then
9392                                         if [[ $val = "EOF" ]]; then
9393                                                 param="$param -E -1"
9394                                         else
9395                                                 param="$param -E $val"
9396                                         fi
9397                                 elif [[ $line =~ ^"stripe_count:" ]]; then
9398                                         # pfl dir
9399                                         val=$(parse_plain_dir_param "$line")
9400                                         param="$param $val"
9401                                 else
9402                                         #pfl file
9403                                         val=$(parse_plain_param "$line")
9404                                         [[ ! -z $val ]] && param="$param $val"
9405                                 fi
9406                         fi
9407                 fi
9408         done
9409         echo "$param"
9410 }
9411
9412 get_layout_param()
9413 {
9414         local param=$($LFS getstripe -d $1 | parse_layout_param)
9415         echo "$param"
9416 }
9417
9418 lfsck_verify_pfid()
9419 {
9420         local f
9421         local rc=0
9422
9423         # Cancel locks before setting lfsck_verify_pfid so that errors are more
9424         # controllable
9425         cancel_lru_locks mdc
9426         cancel_lru_locks osc
9427
9428         # make sure PFID is set correctly for files
9429         do_nodes $(comma_list $(osts_nodes)) \
9430                "$LCTL set_param -n obdfilter.${FSNAME}-OST*.lfsck_verify_pfid=1"
9431
9432         for f in "$@"; do
9433                 cat $f &> /dev/nullA ||
9434                         { rc=$?; echo "verify $f failed"; break; }
9435         done
9436
9437         do_nodes $(comma_list $(osts_nodes)) \
9438                "$LCTL set_param -n obdfilter.${FSNAME}-OST*.lfsck_verify_pfid=0"
9439         return $rc
9440 }
9441
9442 # check that clients "oscs" was evicted after "before"
9443 check_clients_evicted() {
9444         local before=$1
9445         shift
9446         local oscs=${@}
9447         local osc
9448         local rc=0
9449
9450         for osc in $oscs; do
9451                 ((rc++))
9452                 echo "Check state for $osc"
9453                 local evicted=$(do_facet client $LCTL get_param osc.$osc.state |
9454                         tail -n 3 | awk -F"[ [,]" \
9455                         '/EVICTED ]$/ { if (mx<$5) {mx=$5;} } END { print mx }')
9456                 if (($? == 0)) && (($evicted > $before)); then
9457                         echo "$osc is evicted at $evicted"
9458                         ((rc--))
9459                 fi
9460         done
9461
9462         [ $rc -eq 0 ] || error "client not evicted from OST"
9463 }
9464
9465 # check that clients OSCS current_state is FULL
9466 check_clients_full() {
9467         local timeout=$1
9468         shift
9469         local oscs=${@}
9470
9471         for osc in $oscs; do
9472                 wait_update_facet client \
9473                         "lctl get_param -n osc.$osc.state |
9474                         grep 'current_state: FULL'" \
9475                         "current_state: FULL" $timeout
9476                 [ $? -eq 0 ] || error "$osc state is not FULL"
9477         done
9478 }
9479
9480 #Changelogs
9481 __changelog_deregister() {
9482         local facet=$1
9483         local mdt="$(facet_svc $facet)"
9484         local cl_user=$2
9485         local rc=0
9486
9487         # skip cleanup if no user registered for this MDT
9488         [ -z "$cl_user" ] && echo "$mdt: no changelog user" && return 0
9489         # user is no longer registered, skip cleanup
9490         changelog_users "$facet" | grep -q "$cl_user" ||
9491                 { echo "$mdt: changelog user '$cl_user' not found"; return 0; }
9492
9493         # From this point, if any operation fails, it is an error
9494         __changelog_clear $facet $cl_user 0 ||
9495                 error_noexit "$mdt: changelog_clear $cl_user 0 fail: $rc"
9496         do_facet $facet $LCTL --device $mdt changelog_deregister $cl_user ||
9497                 error_noexit "$mdt: changelog_deregister '$cl_user' fail: $rc"
9498 }
9499
9500 declare -Ax CL_USERS
9501 changelog_register() {
9502         for M in $(seq $MDSCOUNT); do
9503                 local facet=mds$M
9504                 local mdt="$(facet_svc $facet)"
9505                 local cl_mask
9506
9507                 cl_mask=$(do_facet $facet $LCTL get_param \
9508                              mdd.${mdt}.changelog_mask -n)
9509                 stack_trap "do_facet $facet $LCTL \
9510                         set_param mdd.$mdt.changelog_mask=\'$cl_mask\' -n" EXIT
9511                 do_facet $facet $LCTL set_param mdd.$mdt.changelog_mask=+hsm ||
9512                         error "$mdt: changelog_mask=+hsm failed: $?"
9513
9514                 local cl_user
9515                 cl_user=$(do_facet $facet \
9516                                   $LCTL --device $mdt changelog_register -n) ||
9517                         error "$mdt: register changelog user failed: $?"
9518                 stack_trap "__changelog_deregister $facet $cl_user" EXIT
9519
9520                 stack_trap "CL_USERS[$facet]='${CL_USERS[$facet]}'" EXIT
9521                 # Bash does not support nested arrays, but the format of a
9522                 # cl_user is constrained enough to use whitespaces as separators
9523                 CL_USERS[$facet]+="$cl_user "
9524         done
9525         echo "Registered $MDSCOUNT changelog users: '${CL_USERS[@]% }'"
9526 }
9527
9528 changelog_deregister() {
9529         local cl_user
9530         # bash assoc arrays do not guarantee to list keys in created order
9531         # so reorder to get same order than in changelog_register()
9532         local cl_facets=$(echo "${!CL_USERS[@]}" | tr " " "\n" | sort |
9533                           tr "\n" " ")
9534
9535         for facet in $cl_facets; do
9536                 for cl_user in ${CL_USERS[$facet]}; do
9537                         __changelog_deregister $facet $cl_user || return $?
9538                 done
9539                 unset CL_USERS[$facet]
9540         done
9541 }
9542
9543 changelog_users() {
9544         local facet=$1
9545         local service=$(facet_svc $facet)
9546
9547         do_facet $facet $LCTL get_param -n mdd.$service.changelog_users
9548 }
9549
9550 changelog_user_rec() {
9551         local facet=$1
9552         local cl_user=$2
9553         local service=$(facet_svc $facet)
9554
9555         changelog_users $facet | awk '$1 == "'$cl_user'" { print $2 }'
9556 }
9557
9558 changelog_chmask() {
9559         local mask=$1
9560
9561         do_nodes $(comma_list $(mdts_nodes)) \
9562                 $LCTL set_param mdd.*.changelog_mask="$mask"
9563 }
9564
9565 # usage: __changelog_clear FACET CL_USER [+]INDEX
9566 __changelog_clear()
9567 {
9568         local facet=$1
9569         local mdt="$(facet_svc $facet)"
9570         local cl_user=$2
9571         local -i rec
9572
9573         case "$3" in
9574         +*)
9575                 # Remove the leading '+'
9576                 rec=${3:1}
9577                 rec+=$(changelog_user_rec $facet $cl_user)
9578                 ;;
9579         *)
9580                 rec=$3
9581                 ;;
9582         esac
9583
9584         if [ $rec -eq 0 ]; then
9585                 echo "$mdt: clear the changelog for $cl_user of all records"
9586         else
9587                 echo "$mdt: clear the changelog for $cl_user to record #$rec"
9588         fi
9589         $LFS changelog_clear $mdt $cl_user $rec
9590 }
9591
9592 # usage: changelog_clear [+]INDEX
9593 #
9594 # If INDEX is prefixed with '+', increment every changelog user's record index
9595 # by INDEX. Otherwise, clear the changelog up to INDEX for every changelog
9596 # users.
9597 changelog_clear() {
9598         local rc
9599         # bash assoc arrays do not guarantee to list keys in created order
9600         # so reorder to get same order than in changelog_register()
9601         local cl_facets=$(echo "${!CL_USERS[@]}" | tr " " "\n" | sort |
9602                           tr "\n" " ")
9603
9604         for facet in $cl_facets; do
9605                 for cl_user in ${CL_USERS[$facet]}; do
9606                         __changelog_clear $facet $cl_user $1 || rc=${rc:-$?}
9607                 done
9608         done
9609
9610         return ${rc:-0}
9611 }
9612
9613 changelog_dump() {
9614         local rc
9615
9616         for M in $(seq $MDSCOUNT); do
9617                 local facet=mds$M
9618                 local mdt="$(facet_svc $facet)"
9619                 local output
9620                 local ret
9621
9622                 output=$($LFS changelog $mdt)
9623                 ret=$?
9624                 if [ $ret -ne 0 ]; then
9625                         rc=${rc:-$ret}
9626                 elif [ -n "$output" ]; then
9627                         echo "$output" | sed -e 's/^/'$mdt'./'
9628                 fi
9629         done
9630
9631         return ${rc:-0}
9632 }
9633
9634 changelog_extract_field() {
9635         local cltype=$1
9636         local file=$2
9637         local identifier=$3
9638
9639         changelog_dump | gawk "/$cltype.*$file$/ {
9640                 print gensub(/^.* "$identifier'(\[[^\]]*\]).*$/,"\\1",1)}' |
9641                 tail -1
9642 }
9643
9644 # Prints a changelog record produced by "lfs changelog" as an associative array
9645 #
9646 # Example:
9647 # $> changelog2array 16 01CREAT 10:28:46.968438800 2018.03.09 0x0 \
9648 #                    t=[0x200000401:0x10:0x0] j=touch.501 ef=0xf u=501:501 \
9649 #                    nid=0@lo p=[0x200000007:0x1:0x0] blob
9650 # ([index]='16' [type]='CREAT' [time]='10:28:46.968438800'
9651 #  [date]='2018.03.09' [flags]=0x0 ['target-fid']='[0x200000401:0x10:0x0]'
9652 #  ['jobid']='touch.501' ['extra-flags']='0x0f' [uid]='0' ['gid']='0'
9653 #  ['nid']='0@lo' ['parent-fid']='[0x200000007:0x1:0x0]')
9654 #
9655 # Note that the changelog record is not quoted
9656 # Also note that the line breaks in the output were only added for readability
9657 #
9658 # Typically, you want to eval the output of the command to fill an actual
9659 # associative array, like this:
9660 # $> eval declare -A changelog=$(changelog2array $entry)
9661 #
9662 # It can then be accessed like any bash associative array:
9663 # $> echo "${changelog[index]}" "${changelog[type]}" "${changelog[flags]}"
9664 # 16 CREAT 0x0
9665 # $> echo "${changelog[uid]}":"${changelog[gid]}"
9666 # 501:501
9667 #
9668 changelog2array()
9669 {
9670         # Start the array
9671         printf '('
9672
9673         # A changelog, as printed by "lfs changelog" typically looks like this:
9674         # <index> <type> <time> <date> <flags> <key1=value1> <key2=value2> ...
9675
9676         # Parse the positional part of the changelog
9677
9678         # changelog_dump() prefixes records with their mdt's name
9679         local index="${1##*.}"
9680
9681         printf "[index]='%s' [type]='%s' [time]='%s' [date]='%s' [flags]='%s'" \
9682                "$index" "${2:2}" "$3" "$4" "$5"
9683
9684         # Parse the key/value part of the changelog
9685         for arg in "${@:5}"; do
9686                 # Check it matches a key=value syntax
9687                 [[ "$arg" =~ ^[[:alpha:]]+= ]] || continue
9688
9689                 local key="${arg%%=*}"
9690                 local value="${arg#*=}"
9691
9692                 case "$key" in
9693                 u)
9694                         # u is actually for uid AND gid: u=UID:GID
9695                         printf " [uid]='%s'" "${value%:*}"
9696                         key=gid
9697                         value="${value#*:}"
9698                         ;;
9699                 t)
9700                         key=target-fid
9701                         value="${value#[}"
9702                         value="${value%]}"
9703                         ;;
9704                 j)
9705                         key=jobid
9706                         ;;
9707                 p)
9708                         key=parent-fid
9709                         value="${value#[}"
9710                         value="${value%]}"
9711                         ;;
9712                 ef)
9713                         key=extra-flags
9714                         ;;
9715                 m)
9716                         key=mode
9717                         ;;
9718                 x)
9719                         key=xattr
9720                         ;;
9721                 *)
9722                         ;;
9723                 esac
9724
9725                 printf " ['%s']='%s'" "$key" "$value"
9726         done
9727
9728         # end the array
9729         printf ')'
9730 }
9731
9732 # Format and print a changelog record
9733 #
9734 # Interpreted sequences are:
9735 #       %%      a single %
9736 #       %f      the "flags" attribute of a changelog record
9737 __changelog_printf()
9738 {
9739         local format="$1"
9740
9741         local -i i
9742         for ((i = 0; i < ${#format}; i++)); do
9743                 local char="${format:$i:1}"
9744                 if [ "$char" != % ]; then
9745                         printf '%c' "$char"
9746                         continue
9747                 fi
9748
9749                 i+=1
9750                 char="${format:$i:1}"
9751                 case "$char" in
9752                 f)
9753                         printf '%s' "${changelog[flags]}"
9754                         ;;
9755                 %)
9756                         printf '%'
9757                         ;;
9758                 esac
9759         done
9760         printf '\n'
9761 }
9762
9763 # Filter changelog records
9764 changelog_find()
9765 {
9766         local -A filter
9767         local action='print'
9768         local format
9769
9770         while [ $# -gt 0 ]; do
9771                 case "$1" in
9772                 -print)
9773                         action='print'
9774                         ;;
9775                 -printf)
9776                         action='printf'
9777                         format="$2"
9778                         shift
9779                         ;;
9780                 -*)
9781                         filter[${1#-}]="$2"
9782                         shift
9783                         ;;
9784                 esac
9785                 shift
9786         done
9787
9788         local found=false
9789         local record
9790         changelog_dump | { while read -r record; do
9791                 eval local -A changelog=$(changelog2array $record)
9792                 for key in "${!filter[@]}"; do
9793                         case "$key" in
9794                         *)
9795                                 [ "${changelog[$key]}" == "${filter[$key]}" ]
9796                                 ;;
9797                         esac || continue 2
9798                 done
9799
9800                 found=true
9801
9802                 case "${action:-print}" in
9803                 print)
9804                         printf '%s\n' "$record"
9805                         ;;
9806                 printf)
9807                         __changelog_printf "$format"
9808                         ;;
9809                 esac
9810         done; $found; }
9811 }
9812
9813 restore_layout() {
9814         local dir=$1
9815         local layout=$2
9816
9817         [ ! -d "$dir" ] && return
9818
9819         [ -z "$layout" ] && {
9820                 $LFS setstripe -d $dir || error "error deleting stripe '$dir'"
9821                 return
9822         }
9823
9824         setfattr -n trusted.lov -v $layout $dir ||
9825                 error "error restoring layout '$layout' to '$dir'"
9826 }
9827
9828 # save the layout of a directory, the returned string will be used by
9829 # restore_layout() to restore the layout
9830 save_layout() {
9831         local dir=$1
9832         local str=$(getfattr -n trusted.lov --absolute-names -e hex $dir \
9833                     2> /dev/null | awk -F'=' '/trusted.lov/{ print $2 }')
9834         echo "$str"
9835 }
9836
9837 # save layout of a directory and restore it at exit
9838 save_layout_restore_at_exit() {
9839         local dir=$1
9840         local layout=$(save_layout $dir)
9841
9842         stack_trap "restore_layout $dir $layout" EXIT
9843 }
9844
9845 verify_yaml_layout() {
9846         local src=$1
9847         local dst=$2
9848         local temp=$3
9849         local msg_prefix=$4
9850
9851         echo "getstripe --yaml $src"
9852         $LFS getstripe --yaml $src > $temp || error "getstripe $src failed"
9853         echo "setstripe --yaml=$temp $dst"
9854         $LFS setstripe --yaml=$temp $dst|| error "setstripe $dst failed"
9855
9856         echo "compare"
9857         local layout1=$(get_layout_param $src)
9858         local layout2=$(get_layout_param $dst)
9859         # compare their layout info
9860         [ "$layout1" == "$layout2" ] ||
9861                 error "$msg_prefix $src/$dst layouts are not equal"
9862 }
9863
9864 is_project_quota_supported() {
9865         $ENABLE_PROJECT_QUOTAS || return 1
9866
9867         [[ "$(facet_fstype $SINGLEMDS)" == "ldiskfs" &&
9868            $(lustre_version_code $SINGLEMDS) -gt $(version_code 2.9.55) ]] &&
9869                 do_facet mds1 lfs --help |& grep -q project && return 0
9870
9871         [[ "$(facet_fstype $SINGLEMDS)" == "zfs" &&
9872            $(lustre_version_code $SINGLEMDS) -gt $(version_code 2.10.53) ]] &&
9873                 do_facet mds1 $ZPOOL get all | grep -q project_quota && return 0
9874
9875         return 1
9876 }
9877
9878 # ZFS project quota enable/disable:
9879 #   This  feature  will  become  active as soon as it is enabled and will never
9880 #   return to being disabled. Each filesystem will be upgraded automatically
9881 #   when remounted or when [a] new file is created under that filesystem. The
9882 #   upgrade can also be triggered on filesystems via `zfs set version=current
9883 #   <pool/fs>`. The upgrade process runs in the background and may take a
9884 #   while to complete for the filesystems containing a large number of files.
9885 enable_project_quota() {
9886         is_project_quota_supported || return 0
9887         local zkeeper=${KEEP_ZPOOL}
9888         stack_trap "KEEP_ZPOOL=$zkeeper" EXIT
9889         KEEP_ZPOOL="true"
9890         stopall || error "failed to stopall (1)"
9891
9892         local zfeat_en="feature@project_quota=enabled"
9893         for facet in $(seq -f mds%g $MDSCOUNT) $(seq -f ost%g $OSTCOUNT); do
9894                 local facet_fstype=${facet:0:3}1_FSTYPE
9895                 local devname
9896
9897                 if [ "${!facet_fstype}" = "zfs" ]; then
9898                         devname=$(zpool_name ${facet})
9899                         do_facet ${facet} $ZPOOL set "$zfeat_en" $devname ||
9900                                 error "$ZPOOL set $zfeat_en $devname"
9901                 else
9902                         [ ${facet:0:3} == "mds" ] &&
9903                                 devname=$(mdsdevname ${facet:3}) ||
9904                                 devname=$(ostdevname ${facet:3})
9905                         do_facet ${facet} $TUNE2FS -O project $devname ||
9906                                 error "tune2fs $devname failed"
9907                 fi
9908         done
9909
9910         KEEP_ZPOOL="${zkeeper}"
9911         mount
9912         setupall
9913 }
9914
9915 disable_project_quota() {
9916         is_project_quota_supported || return 0
9917         [ "$mds1_FSTYPE" != "ldiskfs" ] && return 0
9918         stopall || error "failed to stopall (1)"
9919
9920         for num in $(seq $MDSCOUNT); do
9921                 do_facet mds$num $TUNE2FS -Q ^prj $(mdsdevname $num) ||
9922                         error "tune2fs $(mdsdevname $num) failed"
9923         done
9924
9925         for num in $(seq $OSTCOUNT); do
9926                 do_facet ost$num $TUNE2FS -Q ^prj $(ostdevname $num) ||
9927                         error "tune2fs $(ostdevname $num) failed"
9928         done
9929
9930         mount
9931         setupall
9932 }
9933
9934 #
9935 # In order to test multiple remote HSM agents, a new facet type named "AGT" and
9936 # the following associated variables are added:
9937 #
9938 # AGTCOUNT: number of agents
9939 # AGTDEV{N}: target HSM mount point (root path of the backend)
9940 # agt{N}_HOST: hostname of the agent agt{N}
9941 # SINGLEAGT: facet of the single agent
9942 #
9943 # The number of agents is initialized as the number of remote client nodes.
9944 # By default, only single copytool is started on a remote client/agent. If there
9945 # was no remote client, then the copytool will be started on the local client.
9946 #
9947 init_agt_vars() {
9948         local n
9949         local agent
9950
9951         export AGTCOUNT=${AGTCOUNT:-$((CLIENTCOUNT - 1))}
9952         [[ $AGTCOUNT -gt 0 ]] || AGTCOUNT=1
9953
9954         export SHARED_DIRECTORY=${SHARED_DIRECTORY:-$TMP}
9955         if [[ $CLIENTCOUNT -gt 1 ]] &&
9956                 ! check_shared_dir $SHARED_DIRECTORY $CLIENTS; then
9957                 skip_env "SHARED_DIRECTORY should be accessible"\
9958                          "on all client nodes"
9959                 exit 0
9960         fi
9961
9962         # We used to put the HSM archive in $SHARED_DIRECTORY but that
9963         # meant NFS issues could hose sanity-hsm sessions. So now we
9964         # use $TMP instead.
9965         for n in $(seq $AGTCOUNT); do
9966                 eval export AGTDEV$n=\$\{AGTDEV$n:-"$TMP/arc$n"\}
9967                 agent=CLIENT$((n + 1))
9968                 if [[ -z "${!agent}" ]]; then
9969                         [[ $CLIENTCOUNT -eq 1 ]] && agent=CLIENT1 ||
9970                                 agent=CLIENT2
9971                 fi
9972                 eval export agt${n}_HOST=\$\{agt${n}_HOST:-${!agent}\}
9973                 local var=agt${n}_HOST
9974                 [[ ! -z "${!var}" ]] || error "agt${n}_HOST is empty!"
9975         done
9976
9977         export SINGLEAGT=${SINGLEAGT:-agt1}
9978
9979         export HSMTOOL=${HSMTOOL:-"lhsmtool_posix"}
9980         export HSMTOOL_VERBOSE=${HSMTOOL_VERBOSE:-""}
9981         export HSMTOOL_UPDATE_INTERVAL=${HSMTOOL_UPDATE_INTERVAL:=""}
9982         export HSMTOOL_EVENT_FIFO=${HSMTOOL_EVENT_FIFO:=""}
9983         export HSMTOOL_TESTDIR
9984         export HSMTOOL_BASE=$(basename "$HSMTOOL" | cut -f1 -d" ")
9985
9986         HSM_ARCHIVE_NUMBER=2
9987
9988         # The test only support up to 10 MDTs
9989         MDT_PREFIX="mdt.$FSNAME-MDT000"
9990         HSM_PARAM="${MDT_PREFIX}0.hsm"
9991
9992         # archive is purged at copytool setup
9993         HSM_ARCHIVE_PURGE=true
9994
9995         # Don't allow copytool error upon start/setup
9996         HSMTOOL_NOERROR=false
9997 }
9998
9999 # Get the backend root path for the given agent facet.
10000 copytool_device() {
10001         local facet=$1
10002         local dev=AGTDEV$(facet_number $facet)
10003
10004         echo -n ${!dev}
10005 }
10006
10007 get_mdt_devices() {
10008         local mdtno
10009         # get MDT device for each mdc
10010         for mdtno in $(seq 1 $MDSCOUNT); do
10011                 local idx=$(($mdtno - 1))
10012                 MDT[$idx]=$($LCTL get_param -n \
10013                         mdc.$FSNAME-MDT000${idx}-mdc-*.mds_server_uuid |
10014                         awk '{gsub(/_UUID/,""); print $1}' | head -n1)
10015         done
10016 }
10017
10018 search_copytools() {
10019         local hosts=${1:-$(facet_active_host $SINGLEAGT)}
10020         do_nodesv $hosts "pgrep -x $HSMTOOL_BASE"
10021 }
10022
10023 kill_copytools() {
10024         local hosts=${1:-$(facet_active_host $SINGLEAGT)}
10025
10026         echo "Killing existing copytools on $hosts"
10027         do_nodesv $hosts "killall -q $HSMTOOL_BASE" || true
10028 }
10029
10030 wait_copytools() {
10031         local hosts=${1:-$(facet_active_host $SINGLEAGT)}
10032         local wait_timeout=200
10033         local wait_start=$SECONDS
10034         local wait_end=$((wait_start + wait_timeout))
10035         local sleep_time=100000 # 0.1 second
10036
10037         while ((SECONDS < wait_end)); do
10038                 if ! search_copytools $hosts; then
10039                         echo "copytools stopped in $((SECONDS - wait_start))s"
10040                         return 0
10041                 fi
10042
10043                 echo "copytools still running on $hosts"
10044                 usleep $sleep_time
10045                 [ $sleep_time -lt 32000000 ] && # 3.2 seconds
10046                         sleep_time=$(bc <<< "$sleep_time * 2")
10047         done
10048
10049         # try to dump Copytool's stack
10050         do_nodesv $hosts "echo 1 >/proc/sys/kernel/sysrq ; " \
10051                          "echo t >/proc/sysrq-trigger"
10052
10053         echo "copytools failed to stop in ${wait_timeout}s"
10054
10055         return 1
10056 }
10057
10058 copytool_monitor_cleanup() {
10059         local facet=${1:-$SINGLEAGT}
10060         local agent=$(facet_active_host $facet)
10061
10062         if [ -n "$HSMTOOL_MONITOR_DIR" ]; then
10063                 # Should die when the copytool dies, but just in case.
10064                 local cmd="kill \\\$(cat $HSMTOOL_MONITOR_DIR/monitor_pid)"
10065                 cmd+=" 2>/dev/null || true"
10066                 do_node $agent "$cmd"
10067                 do_node $agent "rm -fr $HSMTOOL_MONITOR_DIR"
10068                 export HSMTOOL_MONITOR_DIR=
10069         fi
10070
10071         # The pdsh should die on its own when the monitor dies. Just
10072         # in case, though, try to clean up to avoid any cruft.
10073         if [ -n "$HSMTOOL_MONITOR_PDSH" ]; then
10074                 kill $HSMTOOL_MONITOR_PDSH 2>/dev/null || true
10075                 export HSMTOOL_MONITOR_PDSH=
10076         fi
10077 }
10078
10079 copytool_logfile()
10080 {
10081         local host="$(facet_host "$1")"
10082         local prefix=$TESTLOG_PREFIX
10083         [ -n "$TESTNAME" ] && prefix+=.$TESTNAME
10084
10085         printf "${prefix}.copytool${archive_id}_log.${host}.log"
10086 }
10087
10088 __lhsmtool_rebind()
10089 {
10090         do_facet $facet $HSMTOOL -p "$hsm_root" --rebind "$@" "$mountpoint"
10091 }
10092
10093 __lhsmtool_import()
10094 {
10095         mkdir -p "$(dirname "$2")" ||
10096                 error "cannot create directory '$(dirname "$2")'"
10097         do_facet $facet $HSMTOOL -p "$hsm_root" --import "$@" "$mountpoint"
10098 }
10099
10100 __lhsmtool_setup()
10101 {
10102         local cmd="$HSMTOOL $HSMTOOL_VERBOSE --daemon --hsm-root \"$hsm_root\""
10103         [ -n "$bandwidth" ] && cmd+=" --bandwidth $bandwidth"
10104         [ -n "$archive_id" ] && cmd+=" --archive $archive_id"
10105         [ ${#misc_options[@]} -gt 0 ] &&
10106                 cmd+=" $(IFS=" " echo "$@")"
10107         cmd+=" \"$mountpoint\""
10108
10109         echo "Starting copytool $facet on $(facet_host $facet)"
10110         stack_trap "do_facet $facet libtool execute pkill -x '$HSMTOOL' || true" EXIT
10111         do_facet $facet "$cmd < /dev/null > \"$(copytool_logfile $facet)\" 2>&1"
10112 }
10113
10114 hsm_root() {
10115         local facet="${1:-$SINGLEAGT}"
10116
10117         printf "$(copytool_device "$facet")/${TESTSUITE}.${TESTNAME}/"
10118 }
10119
10120 # Main entry point to perform copytool related operations
10121 #
10122 # Sub-commands:
10123 #
10124 #       setup   setup a copytool to run in the background, that copytool will be
10125 #               killed on EXIT
10126 #       import  import a file from an HSM backend
10127 #       rebind  rebind an archived file to a new fid
10128 #
10129 # Although the semantics might suggest otherwise, one does not need to 'setup'
10130 # a copytool before a call to 'copytool import' or 'copytool rebind'.
10131 #
10132 copytool()
10133 {
10134         local action=$1
10135         shift
10136
10137         # Use default values
10138         local facet=$SINGLEAGT
10139         local mountpoint="${MOUNT2:-$MOUNT}"
10140         local hsm_root="${hsm_root:-$(hsm_root "$facet")}"
10141
10142         # Parse arguments
10143         local fail_on_error=true
10144         local -a misc_options
10145         while [ $# -gt 0 ]; do
10146                 case "$1" in
10147                 -f|--facet)
10148                         shift
10149                         facet="$1"
10150                         ;;
10151                 -m|--mountpoint)
10152                         shift
10153                         mountpoint="$1"
10154                         ;;
10155                 -a|--archive-id)
10156                         shift
10157                         local archive_id="$1"
10158                         ;;
10159                 -h|--hsm-root)
10160                         shift
10161                         hsm_root="$1"
10162                         ;;
10163                 -b|--bwlimit)
10164                         shift
10165                         local bandwidth="$1" # in MB/s
10166                         ;;
10167                 -n|--no-fail)
10168                         local fail_on_error=false
10169                         ;;
10170                 *)
10171                         # Uncommon(/copytool dependent) option
10172                         misc_options+=("$1")
10173                         ;;
10174                 esac
10175                 shift
10176         done
10177
10178         stack_trap "do_facet $facet rm -rf '$hsm_root'" EXIT
10179         do_facet $facet mkdir -p "$hsm_root" ||
10180                 error "mkdir '$hsm_root' failed"
10181
10182         case "$HSMTOOL" in
10183         lhsmtool_posix)
10184                 local copytool=lhsmtool
10185                 ;;
10186         esac
10187
10188         __${copytool}_${action} "${misc_options[@]}"
10189         if [ $? -ne 0 ]; then
10190                 local error_msg
10191
10192                 case $action in
10193                 setup)
10194                         local host="$(facet_host $facet)"
10195                         error_msg="Failed to start copytool $facet on '$host'"
10196                         ;;
10197                 import)
10198                         local src="${misc_options[0]}"
10199                         local dest="${misc_options[1]}"
10200                         error_msg="Failed to import '$src' to '$dest'"
10201                         ;;
10202                 rebind)
10203                         error_msg="could not rebind file"
10204                         ;;
10205                 esac
10206
10207                 $fail_on_error && error "$error_msg" || echo "$error_msg"
10208         fi
10209 }
10210
10211 needclients() {
10212         local client_count=$1
10213         if [[ $CLIENTCOUNT -lt $client_count ]]; then
10214                 skip "Need $client_count or more clients, have $CLIENTCOUNT"
10215                 return 1
10216         fi
10217         return 0
10218 }
10219
10220 path2fid() {
10221         $LFS path2fid $1 | tr -d '[]'
10222         return ${PIPESTATUS[0]}
10223 }
10224
10225 get_hsm_flags() {
10226         local f=$1
10227         local u=$2
10228         local st
10229
10230         if [[ $u == "user" ]]; then
10231                 st=$($RUNAS $LFS hsm_state $f)
10232         else
10233                 u=root
10234                 st=$($LFS hsm_state $f)
10235         fi
10236
10237         [[ $? == 0 ]] || error "$LFS hsm_state $f failed (run as $u)"
10238
10239         st=$(echo $st | cut -f 2 -d" " | tr -d "()," )
10240         echo $st
10241 }
10242
10243 check_hsm_flags() {
10244         local f=$1
10245         local fl=$2
10246
10247         local st=$(get_hsm_flags $f)
10248         [[ $st == $fl ]] || error "hsm flags on $f are $st != $fl"
10249 }
10250
10251 mdts_set_param() {
10252         local arg=$1
10253         local key=$2
10254         local value=$3
10255         local mdtno
10256         local rc=0
10257         if [[ "$value" != "" ]]; then
10258                 value="=$value"
10259         fi
10260         for mdtno in $(seq 1 $MDSCOUNT); do
10261                 local idx=$(($mdtno - 1))
10262                 local facet=mds${mdtno}
10263                 # if $arg include -P option, run 1 set_param per MDT on the MGS
10264                 # else, run set_param on each MDT
10265                 [[ $arg = *"-P"* ]] && facet=mgs
10266                 do_facet $facet $LCTL set_param $arg mdt.${MDT[$idx]}.$key$value
10267                 [[ $? != 0 ]] && rc=1
10268         done
10269         return $rc
10270 }
10271
10272 wait_result() {
10273         local facet=$1
10274         shift
10275         wait_update --verbose $(facet_active_host $facet) "$@"
10276 }
10277
10278 mdts_check_param() {
10279         local key="$1"
10280         local target="$2"
10281         local timeout="$3"
10282         local mdtno
10283         for mdtno in $(seq 1 $MDSCOUNT); do
10284                 local idx=$(($mdtno - 1))
10285                 wait_result mds${mdtno} \
10286                         "$LCTL get_param -n $MDT_PREFIX${idx}.$key" "$target" \
10287                         $timeout ||
10288                         error "$key state is not '$target' on mds${mdtno}"
10289         done
10290 }
10291
10292 cdt_set_mount_state() {
10293         mdts_set_param "-P" hsm_control "$1"
10294         # set_param -P is asynchronous operation and could race with set_param.
10295         # In such case configs could be retrieved and applied at mgc after
10296         # set_param -P completion. Sleep here to avoid race with set_param.
10297         # We need at least 20 seconds. 10 for mgc_requeue_thread to wake up
10298         # MGC_TIMEOUT_MIN_SECONDS + MGC_TIMEOUT_RAND_CENTISEC(5 + 5)
10299         # and 10 seconds to retrieve config from server.
10300         sleep 20
10301 }
10302
10303 cdt_check_state() {
10304         mdts_check_param hsm_control "$1" 20
10305 }
10306
10307 cdt_set_sanity_policy() {
10308         if [[ "$CDT_POLICY_HAD_CHANGED" ]]
10309         then
10310                 # clear all
10311                 mdts_set_param "" hsm.policy "+NRA"
10312                 mdts_set_param "" hsm.policy "-NBR"
10313                 CDT_POLICY_HAD_CHANGED=
10314         fi
10315 }
10316
10317 set_hsm_param() {
10318         local param=$1
10319         local value=$2
10320         local opt=$3
10321         mdts_set_param "$opt -n" "hsm.$param" "$value"
10322         return $?
10323 }
10324
10325 wait_request_state() {
10326         local fid=$1
10327         local request=$2
10328         local state=$3
10329         # 4th arg (mdt index) is optional
10330         local mdtidx=${4:-0}
10331         local mds=mds$(($mdtidx + 1))
10332
10333         local cmd="$LCTL get_param -n ${MDT_PREFIX}${mdtidx}.hsm.actions"
10334         cmd+=" | awk '/'$fid'.*action='$request'/ {print \\\$13}' | cut -f2 -d="
10335
10336         wait_result $mds "$cmd" "$state" 200 ||
10337                 error "request on $fid is not $state on $mds"
10338 }
10339
10340
10341 rmultiop_start() {
10342         local client=$1
10343         local file=$2
10344         local cmds=$3
10345         local WAIT_MAX=${4:-60}
10346         local wait_time=0
10347
10348         # We need to run do_node in bg, because pdsh does not exit
10349         # if child process of run script exists.
10350         # I.e. pdsh does not exit when runmultiop_bg_pause exited,
10351         # because of multiop_bg_pause -> $MULTIOP_PROG &
10352         # By the same reason we need sleep a bit after do_nodes starts
10353         # to let runmultiop_bg_pause start muliop and
10354         # update /tmp/multiop_bg.pid ;
10355         # The rm /tmp/multiop_bg.pid guarantees here that
10356         # we have the updated by runmultiop_bg_pause
10357         # /tmp/multiop_bg.pid file
10358
10359         local pid_file=$TMP/multiop_bg.pid.$$
10360
10361         do_node $client "MULTIOP_PID_FILE=$pid_file LUSTRE= \
10362                         runmultiop_bg_pause $file $cmds" &
10363         local pid=$!
10364         local multiop_pid
10365
10366         while [[ $wait_time -lt $WAIT_MAX ]]; do
10367                 sleep 3
10368                 wait_time=$((wait_time + 3))
10369                 multiop_pid=$(do_node $client cat $pid_file)
10370                 if [ -n "$multiop_pid" ]; then
10371                         break
10372                 fi
10373         done
10374
10375         [ -n "$multiop_pid" ] ||
10376                 error "$client : Can not get multiop_pid from $pid_file "
10377
10378         eval export $(node_var_name $client)_multiop_pid=$multiop_pid
10379         eval export $(node_var_name $client)_do_node_pid=$pid
10380         local var=$(node_var_name $client)_multiop_pid
10381         echo client $client multiop_bg started multiop_pid=${!var}
10382         return $?
10383 }
10384
10385 rmultiop_stop() {
10386         local client=$1
10387         local multiop_pid=$(node_var_name $client)_multiop_pid
10388         local do_node_pid=$(node_var_name $client)_do_node_pid
10389
10390         echo "Stopping multiop_pid=${!multiop_pid} (kill ${!multiop_pid} on $client)"
10391         do_node $client kill -USR1 ${!multiop_pid}
10392
10393         wait ${!do_node_pid}
10394 }
10395
10396 sleep_maxage() {
10397         local delay=$(do_facet $SINGLEMDS lctl get_param -n lo[vd].*.qos_maxage |
10398                       awk '{ print $1 * 2; exit; }')
10399         sleep $delay
10400 }
10401
10402 check_component_count() {
10403         local comp_cnt=$($LFS getstripe --component-count $1)
10404         [ $comp_cnt -eq $2 ] || error "$1, component count $comp_cnt != $2"
10405 }
10406
10407 # Verify there are no init components with "extension" flag
10408 verify_no_init_extension() {
10409         local flg_opts="--component-flags init,extension"
10410         local found=$($LFS find $flg_opts $1 | wc -l)
10411         [ $found -eq 0 ] || error "$1 has component with initialized extension"
10412 }
10413
10414 # Verify there is at least one component starting at 0
10415 verify_comp_at_zero() {
10416         flg_opts="--component-flags init"
10417         found=$($LFS find --component-start 0M $flg_opts $1 | wc -l)
10418         [ $found -eq 1 ] ||
10419                 error "No component starting at zero(!)"
10420 }
10421
10422 # version after which Self-Extending Layouts are available
10423 SEL_VER="2.12.55"
10424
10425 sel_layout_sanity() {
10426         local file=$1
10427         local comp_cnt=$2
10428
10429         verify_no_init_extension $file
10430         verify_comp_at_zero $file
10431         check_component_count $file $comp_cnt
10432 }
10433