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