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