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