Whamcloud - gitweb
LU-2571 lfsck: run lfsck on server node
[fs/lustre-release.git] / lustre / tests / test-framework.sh
1 #!/bin/bash
2
3 trap 'print_summary && touch $TF_FAIL && \
4     echo "test-framework exiting on error"' ERR
5 set -e
6 #set -x
7
8 export EJOURNAL=${EJOURNAL:-""}
9 export REFORMAT=${REFORMAT:-""}
10 export WRITECONF=${WRITECONF:-""}
11 export VERBOSE=${VERBOSE:-false}
12 export CATASTROPHE=${CATASTROPHE:-/proc/sys/lnet/catastrophe}
13 export GSS=false
14 export GSS_KRB5=false
15 export GSS_PIPEFS=false
16 export IDENTITY_UPCALL=default
17 export QUOTA_AUTO=1
18 export JOBSTATS_AUTO=${JOBSTATS_AUTO:-1}
19 export JOBID_VAR=${JOBID_VAR:-"procname_uid"}
20
21 # LOAD_LLOOP: LU-409: only load llite_lloop module if kernel < 2.6.32 or
22 #             LOAD_LLOOP is true. LOAD_LLOOP is false by default.
23 export LOAD_LLOOP=${LOAD_LLOOP:-false}
24
25 #export PDSH="pdsh -S -Rssh -w"
26
27 # function used by scripts run on remote nodes
28 LUSTRE=${LUSTRE:-$(cd $(dirname $0)/..; echo $PWD)}
29 . $LUSTRE/tests/functions.sh
30 . $LUSTRE/tests/yaml.sh
31
32 export LD_LIBRARY_PATH=${LUSTRE}/utils:${LD_LIBRARY_PATH}
33
34 LUSTRE_TESTS_CFG_DIR=${LUSTRE_TESTS_CFG_DIR:-${LUSTRE}/tests/cfg}
35
36 EXCEPT_LIST_FILE=${EXCEPT_LIST_FILE:-${LUSTRE_TESTS_CFG_DIR}/tests-to-skip.sh}
37
38 if [ -f "$EXCEPT_LIST_FILE" ]; then
39     echo "Reading test skip list from $EXCEPT_LIST_FILE"
40     cat $EXCEPT_LIST_FILE
41     . $EXCEPT_LIST_FILE
42 fi
43
44 # check config files for options in decreasing order of preference
45 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/lustre.conf ] &&
46     MODPROBECONF=/etc/modprobe.d/lustre.conf
47 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/Lustre ] &&
48     MODPROBECONF=/etc/modprobe.d/Lustre
49 [ -z "$MODPROBECONF" -a -f /etc/modprobe.conf ] &&
50     MODPROBECONF=/etc/modprobe.conf
51
52 assert_DIR () {
53     local failed=""
54     [[ $DIR/ = $MOUNT/* ]] || \
55         { failed=1 && echo "DIR=$DIR not in $MOUNT. Aborting."; }
56     [[ $DIR1/ = $MOUNT1/* ]] || \
57         { failed=1 && echo "DIR1=$DIR1 not in $MOUNT1. Aborting."; }
58     [[ $DIR2/ = $MOUNT2/* ]] || \
59         { failed=1 && echo "DIR2=$DIR2 not in $MOUNT2. Aborting"; }
60
61     [ -n "$failed" ] && exit 99 || true
62 }
63
64 usage() {
65     echo "usage: $0 [-r] [-f cfgfile]"
66     echo "       -r: reformat"
67
68     exit
69 }
70
71 print_summary () {
72     trap 0
73     [ "$TESTSUITE" == "lfsck" ] && return 0
74     [ -n "$ONLY" ] && echo "WARNING: ONLY is set to $(echo $ONLY)"
75     local details
76     local form="%-13s %-17s %-9s %s %s\n"
77     printf "$form" "status" "script" "Total(sec)" "E(xcluded) S(low)"
78     echo "------------------------------------------------------------------------------------"
79     for O in $DEFAULT_SUITES; do
80         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
81         [ "${!O}" = "no" ] && continue || true
82         local o=$(echo $O  | tr "[:upper:]_" "[:lower:]-")
83         local log=${TMP}/${o}.log
84         if is_sanity_benchmark $o; then
85             log=${TMP}/sanity-benchmark.log
86         fi
87         local slow=
88         local skipped=
89         local total=
90         local status=Unfinished
91         if [ -f $log ]; then
92             skipped=$(grep excluded $log | awk '{ printf " %s", $3 }' | sed 's/test_//g')
93             slow=$(egrep "^PASS|^FAIL" $log | tr -d "("| sed s/s\)$//g | sort -nr -k 3  | head -5 |  awk '{ print $2":"$3"s" }')
94             total=$(grep duration $log | awk '{ print $2}')
95             if [ "${!O}" = "done" ]; then
96                 status=Done
97             fi
98             if $DDETAILS; then
99                 local durations=$(egrep "^PASS|^FAIL" $log |  tr -d "("| sed s/s\)$//g | awk '{ print $2":"$3"|" }')
100                 details=$(printf "%s\n%s %s %s\n" "$details" "DDETAILS" "$O" "$(echo $durations)")
101             fi
102         fi
103         printf "$form" $status "$O" "${total}" "E=$skipped"
104         printf "$form" "-" "-" "-" "S=$(echo $slow)"
105     done
106
107     for O in $DEFAULT_SUITES; do
108         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
109         if [ "${!O}" = "no" ]; then
110             printf "$form" "Skipped" "$O" ""
111         fi
112     done
113
114     # print the detailed tests durations if DDETAILS=true
115     if $DDETAILS; then
116         echo "$details"
117     fi
118 }
119
120 init_test_env() {
121         export LUSTRE=$(absolute_path $LUSTRE)
122         export TESTSUITE=$(basename $0 .sh)
123         export TEST_FAILED=false
124         export FAIL_ON_SKIP_ENV=${FAIL_ON_SKIP_ENV:-false}
125         export RPC_MODE=${RPC_MODE:-false}
126
127     export MKE2FS=$MKE2FS
128     if [ -z "$MKE2FS" ]; then
129         if which mkfs.ldiskfs >/dev/null 2>&1; then
130             export MKE2FS=mkfs.ldiskfs
131         else
132             export MKE2FS=mke2fs
133         fi
134     fi
135
136     export DEBUGFS=$DEBUGFS
137     if [ -z "$DEBUGFS" ]; then
138         if which debugfs.ldiskfs >/dev/null 2>&1; then
139             export DEBUGFS=debugfs.ldiskfs
140         else
141             export DEBUGFS=debugfs
142         fi
143     fi
144
145     export TUNE2FS=$TUNE2FS
146     if [ -z "$TUNE2FS" ]; then
147         if which tunefs.ldiskfs >/dev/null 2>&1; then
148             export TUNE2FS=tunefs.ldiskfs
149         else
150             export TUNE2FS=tune2fs
151         fi
152     fi
153
154     export E2LABEL=$E2LABEL
155     if [ -z "$E2LABEL" ]; then
156         if which label.ldiskfs >/dev/null 2>&1; then
157             export E2LABEL=label.ldiskfs
158         else
159             export E2LABEL=e2label
160         fi
161     fi
162
163     export DUMPE2FS=$DUMPE2FS
164     if [ -z "$DUMPE2FS" ]; then
165         if which dumpfs.ldiskfs >/dev/null 2>&1; then
166             export DUMPE2FS=dumpfs.ldiskfs
167         else
168             export DUMPE2FS=dumpe2fs
169         fi
170     fi
171
172     export E2FSCK=$E2FSCK
173     if [ -z "$E2FSCK" ]; then
174         if which fsck.ldiskfs >/dev/null 2>&1; then
175             export E2FSCK=fsck.ldiskfs
176         else
177             export E2FSCK=e2fsck
178         fi
179     fi
180
181     export LFSCK_BIN=${LFSCK_BIN:-lfsck}
182     export LFSCK_ALWAYS=${LFSCK_ALWAYS:-"no"} # check fs after each test suite
183     export FSCK_MAX_ERR=4   # File system errors left uncorrected
184
185         export ZFS=${ZFS:-zfs}
186         export ZPOOL=${ZPOOL:-zpool}
187         export ZDB=${ZDB:-zdb}
188
189     #[ -d /r ] && export ROOT=${ROOT:-/r}
190     export TMP=${TMP:-$ROOT/tmp}
191     export TESTSUITELOG=${TMP}/${TESTSUITE}.log
192     export LOGDIR=${LOGDIR:-${TMP}/test_logs/$(date +%s)}
193     export TESTLOG_PREFIX=$LOGDIR/$TESTSUITE
194
195     export HOSTNAME=${HOSTNAME:-$(hostname -s)}
196     if ! echo $PATH | grep -q $LUSTRE/utils; then
197         export PATH=$LUSTRE/utils:$PATH
198     fi
199     if ! echo $PATH | grep -q $LUSTRE/utils/gss; then
200         export PATH=$LUSTRE/utils/gss:$PATH
201     fi
202     if ! echo $PATH | grep -q $LUSTRE/tests; then
203         export PATH=$LUSTRE/tests:$PATH
204     fi
205     if ! echo $PATH | grep -q $LUSTRE/../lustre-iokit/sgpdd-survey; then
206         export PATH=$LUSTRE/../lustre-iokit/sgpdd-survey:$PATH
207     fi
208     export LST=${LST:-"$LUSTRE/../lnet/utils/lst"}
209     [ ! -f "$LST" ] && export LST=$(which lst)
210     export SGPDDSURVEY=${SGPDDSURVEY:-"$LUSTRE/../lustre-iokit/sgpdd-survey/sgpdd-survey")}
211     [ ! -f "$SGPDDSURVEY" ] && export SGPDDSURVEY=$(which sgpdd-survey)
212     # Ubuntu, at least, has a truncate command in /usr/bin
213     # so fully path our truncate command.
214     export TRUNCATE=${TRUNCATE:-$LUSTRE/tests/truncate}
215     export MDSRATE=${MDSRATE:-"$LUSTRE/tests/mpi/mdsrate"}
216     [ ! -f "$MDSRATE" ] && export MDSRATE=$(which mdsrate 2> /dev/null)
217     if ! echo $PATH | grep -q $LUSTRE/tests/racer; then
218         export PATH=$LUSTRE/tests/racer:$PATH:
219     fi
220     if ! echo $PATH | grep -q $LUSTRE/tests/mpi; then
221         export PATH=$LUSTRE/tests/mpi:$PATH
222     fi
223     export RSYNC_RSH=${RSYNC_RSH:-rsh}
224
225     export LCTL=${LCTL:-"$LUSTRE/utils/lctl"}
226     [ ! -f "$LCTL" ] && export LCTL=$(which lctl)
227     export LFS=${LFS:-"$LUSTRE/utils/lfs"}
228     [ ! -f "$LFS" ] && export LFS=$(which lfs)
229     SETSTRIPE=${SETSTRIPE:-"$LFS setstripe"}
230     GETSTRIPE=${GETSTRIPE:-"$LFS getstripe"}
231
232     export L_GETIDENTITY=${L_GETIDENTITY:-"$LUSTRE/utils/l_getidentity"}
233     if [ ! -f "$L_GETIDENTITY" ]; then
234         if `which l_getidentity > /dev/null 2>&1`; then
235             export L_GETIDENTITY=$(which l_getidentity)
236         else
237             export L_GETIDENTITY=NONE
238         fi
239     fi
240     export LL_DECODE_FILTER_FID=${LL_DECODE_FILTER_FID:-"$LUSTRE/utils/ll_decode_filter_fid"}
241     [ ! -f "$LL_DECODE_FILTER_FID" ] && export LL_DECODE_FILTER_FID="ll_decode_filter_fid"
242     export MKFS=${MKFS:-"$LUSTRE/utils/mkfs.lustre"}
243     [ ! -f "$MKFS" ] && export MKFS="mkfs.lustre"
244     export TUNEFS=${TUNEFS:-"$LUSTRE/utils/tunefs.lustre"}
245     [ ! -f "$TUNEFS" ] && export TUNEFS="tunefs.lustre"
246     export CHECKSTAT="${CHECKSTAT:-"checkstat -v"} "
247     export LUSTRE_RMMOD=${LUSTRE_RMMOD:-$LUSTRE/scripts/lustre_rmmod}
248     [ ! -f "$LUSTRE_RMMOD" ] &&
249         export LUSTRE_RMMOD=$(which lustre_rmmod 2> /dev/null)
250     export LFS_MIGRATE=${LFS_MIGRATE:-$LUSTRE/scripts/lfs_migrate}
251     [ ! -f "$LFS_MIGRATE" ] &&
252         export LFS_MIGRATE=$(which lfs_migrate 2> /dev/null)
253     export NAME=${NAME:-local}
254     export LGSSD=${LGSSD:-"$LUSTRE/utils/gss/lgssd"}
255     [ "$GSS_PIPEFS" = "true" ] && [ ! -f "$LGSSD" ] && \
256         export LGSSD=$(which lgssd)
257     export LSVCGSSD=${LSVCGSSD:-"$LUSTRE/utils/gss/lsvcgssd"}
258     [ ! -f "$LSVCGSSD" ] && export LSVCGSSD=$(which lsvcgssd 2> /dev/null)
259     export KRB5DIR=${KRB5DIR:-"/usr/kerberos"}
260     export DIR2
261     export SAVE_PWD=${SAVE_PWD:-$LUSTRE/tests}
262     export AT_MAX_PATH
263
264     if [ "$ACCEPTOR_PORT" ]; then
265         export PORT_OPT="--port $ACCEPTOR_PORT"
266     fi
267
268     case "x$SEC" in
269         xkrb5*)
270             echo "Using GSS/krb5 ptlrpc security flavor"
271             which lgss_keyring > /dev/null 2>&1 || \
272                 error_exit "built with gss disabled! SEC=$SEC"
273             GSS=true
274             GSS_KRB5=true
275             ;;
276     esac
277
278     case "x$IDUP" in
279         xtrue)
280             IDENTITY_UPCALL=true
281             ;;
282         xfalse)
283             IDENTITY_UPCALL=false
284             ;;
285     esac
286
287     export LOAD_MODULES_REMOTE=${LOAD_MODULES_REMOTE:-false}
288
289     # Paths on remote nodes, if different
290     export RLUSTRE=${RLUSTRE:-$LUSTRE}
291     export RPWD=${RPWD:-$PWD}
292     export I_MOUNTED=${I_MOUNTED:-"no"}
293     if [ ! -f /lib/modules/$(uname -r)/kernel/fs/lustre/mdt.ko -a \
294         ! -f /lib/modules/$(uname -r)/updates/kernel/fs/lustre/mdt.ko -a \
295         ! -f `dirname $0`/../mdt/mdt.ko ]; then
296         export CLIENTMODSONLY=yes
297     fi
298
299     export SHUTDOWN_ATTEMPTS=${SHUTDOWN_ATTEMPTS:-3}
300
301     # command line
302
303     while getopts "rvwf:" opt $*; do
304         case $opt in
305             f) CONFIG=$OPTARG;;
306             r) REFORMAT=--reformat;;
307             v) VERBOSE=true;;
308             w) WRITECONF=writeconf;;
309             \?) usage;;
310         esac
311     done
312
313     shift $((OPTIND - 1))
314     ONLY=${ONLY:-$*}
315
316         # print the durations of each test if "true"
317         DDETAILS=${DDETAILS:-false}
318         [ "$TESTSUITELOG" ] && rm -f $TESTSUITELOG || true
319         if ! $RPC_MODE; then
320                 rm -f $TMP/*active
321         fi
322 }
323
324 check_cpt_number() {
325         local facet=$1
326         local ncpts
327
328         ncpts=$(do_facet $facet "lctl get_param -n " \
329                 "cpu_partition_table 2>/dev/null| wc -l" || echo 1)
330
331         if [ $ncpts -eq 0 ]; then
332                 echo "1"
333         else
334                 echo $ncpts
335         fi
336 }
337
338 version_code() {
339     # split arguments like "1.8.6-wc3" into "1", "8", "6", "wc3"
340     eval set -- $(tr "[:punct:]" " " <<< $*)
341
342     echo -n "$((($1 << 16) | ($2 << 8) | $3))"
343 }
344
345 export LINUX_VERSION=$(uname -r | sed -e "s/[-.]/ /3" -e "s/ .*//")
346 export LINUX_VERSION_CODE=$(version_code ${LINUX_VERSION//\./ })
347
348 module_loaded () {
349    /sbin/lsmod | grep -q "^\<$1\>"
350 }
351
352 # Load a module on the system where this is running.
353 #
354 # Synopsis: load_module module_name [module arguments for insmod/modprobe]
355 #
356 # If module arguments are not given but MODOPTS_<MODULE> is set, then its value
357 # will be used as the arguments.  Otherwise arguments will be obtained from
358 # /etc/modprobe.conf, from /etc/modprobe.d/Lustre, or else none will be used.
359 #
360 load_module() {
361     local optvar
362     EXT=".ko"
363     module=$1
364     shift
365     BASE=`basename $module $EXT`
366
367     module_loaded ${BASE} && return
368
369     # If no module arguments were passed, get them from $MODOPTS_<MODULE>, else from
370     # modprobe.conf
371     if [ $# -eq 0 ]; then
372         # $MODOPTS_<MODULE>; we could use associative arrays, but that's not in
373         # Bash until 4.x, so we resort to eval.
374         optvar="MODOPTS_$(basename $module | tr a-z A-Z)"
375         eval set -- \$$optvar
376         if [ $# -eq 0 -a -n "$MODPROBECONF" ]; then
377                 # Nothing in $MODOPTS_<MODULE>; try modprobe.conf
378                 local opt
379                 opt=$(awk -v var="^options $BASE" '$0 ~ var \
380                         {gsub("'"options $BASE"'",""); print}' $MODPROBECONF)
381                 set -- $(echo -n $opt)
382
383                 # Ensure we have accept=all for lnet
384                 if [ $(basename $module) = lnet ]; then
385                         # OK, this is a bit wordy...
386                         local arg accept_all_present=false
387
388                         for arg in "$@"; do
389                                 [ "$arg" = accept=all ] && \
390                                         accept_all_present=true
391                         done
392                         $accept_all_present || set -- "$@" accept=all
393                 fi
394                 export $optvar="$*"
395         fi
396     fi
397
398     [ $# -gt 0 ] && echo "${module} options: '$*'"
399
400     # Note that insmod will ignore anything in modprobe.conf, which is why we're
401     # passing options on the command-line.
402     if [ "$BASE" == "lnet_selftest" ] && \
403             [ -f ${LUSTRE}/../lnet/selftest/${module}${EXT} ]; then
404         insmod ${LUSTRE}/../lnet/selftest/${module}${EXT}
405     elif [ -f ${LUSTRE}/${module}${EXT} ]; then
406         insmod ${LUSTRE}/${module}${EXT} "$@"
407     else
408         # must be testing a "make install" or "rpm" installation
409         # note failed to load ptlrpc_gss is considered not fatal
410         if [ "$BASE" == "ptlrpc_gss" ]; then
411             modprobe $BASE "$@" 2>/dev/null || echo "gss/krb5 is not supported"
412         else
413             modprobe $BASE "$@"
414         fi
415     fi
416 }
417
418 llite_lloop_enabled() {
419     local n1=$(uname -r | cut -d. -f1)
420     local n2=$(uname -r | cut -d. -f2)
421     local n3=$(uname -r | cut -d- -f1 | cut -d. -f3)
422
423     # load the llite_lloop module for < 2.6.32 kernels
424     if [[ $n1 -lt 2 ]] || [[ $n1 -eq 2 && $n2 -lt 6 ]] || \
425        [[ $n1 -eq 2 && $n2 -eq 6 && $n3 -lt 32 ]] || \
426         $LOAD_LLOOP; then
427         return 0
428     fi
429     return 1
430 }
431
432 load_modules_local() {
433         if [ -n "$MODPROBE" ]; then
434                 # use modprobe
435                 echo "Using modprobe to load modules"
436                 return 0
437         fi
438
439         echo Loading modules from $LUSTRE
440
441         local ncpus
442
443         if [ -f /sys/devices/system/cpu/online ]; then
444                 ncpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/online) + 1))
445                 echo "detected $ncpus online CPUs by sysfs"
446         else
447                 ncpus=$(getconf _NPROCESSORS_CONF 2>/dev/null)
448                 local rc=$?
449                 if [ $rc -eq 0 ]; then
450                         echo "detected $ncpus online CPUs by getconf"
451                 else
452                         echo "Can't detect number of CPUs"
453                         ncpus=1
454                 fi
455         fi
456
457         # if there is only one CPU core, libcfs can only create one partition
458         # if there is more than 4 CPU cores, libcfs should create multiple CPU
459         # partitions. So we just force libcfs to create 2 partitions for
460         # system with 2 or 4 cores
461         if [ $ncpus -le 4 ] && [ $ncpus -gt 1 ]; then
462                 # force to enable multiple CPU partitions
463                 echo "Force libcfs to create 2 CPU partitions"
464                 MODOPTS_LIBCFS="cpu_npartitions=2 $MODOPTS_LIBCFS"
465         else
466                 echo "libcfs will create CPU partition based on online CPUs"
467         fi
468
469         load_module ../libcfs/libcfs/libcfs
470
471     [ "$PTLDEBUG" ] && lctl set_param debug="$PTLDEBUG"
472     [ "$SUBSYSTEM" ] && lctl set_param subsystem_debug="${SUBSYSTEM# }"
473     load_module ../lnet/lnet/lnet
474     LNETLND=${LNETLND:-"socklnd/ksocklnd"}
475     load_module ../lnet/klnds/$LNETLND
476     load_module lvfs/lvfs
477     load_module obdclass/obdclass
478     load_module ptlrpc/ptlrpc
479     load_module ptlrpc/gss/ptlrpc_gss
480     load_module fld/fld
481     load_module fid/fid
482     load_module lmv/lmv
483     load_module mdc/mdc
484     load_module osc/osc
485     load_module lov/lov
486     load_module mgc/mgc
487     load_module obdecho/obdecho
488     if ! client_only; then
489         SYMLIST=/proc/kallsyms
490         grep -q crc16 $SYMLIST || { modprobe crc16 2>/dev/null || true; }
491         grep -q -w jbd $SYMLIST || { modprobe jbd 2>/dev/null || true; }
492         grep -q -w jbd2 $SYMLIST || { modprobe jbd2 2>/dev/null || true; }
493                 [ "$LQUOTA" != "no" ] && load_module quota/lquota $LQUOTAOPTS
494                 if [[ $(node_fstypes $HOSTNAME) == *zfs* ]]; then
495                         modprobe zfs
496                         load_module osd-zfs/osd_zfs
497                 fi
498                 load_module mgs/mgs
499                 load_module mdd/mdd
500                 if [[ $(node_fstypes $HOSTNAME) == *ldiskfs* ]]; then
501                         #
502                         # This block shall be moved up beside osd-zfs as soon
503                         # as osd-ldiskfs stops using mdd symbols.
504                         #
505                         grep -q exportfs_decode_fh $SYMLIST ||
506                                 { modprobe exportfs 2> /dev/null || true; }
507                         load_module ../ldiskfs/ldiskfs/ldiskfs
508                         load_module lvfs/fsfilt_ldiskfs
509                         load_module osd-ldiskfs/osd_ldiskfs
510                 fi
511                 load_module mdt/mdt
512                 load_module ost/ost
513                 load_module lod/lod
514                 load_module osp/osp
515                 load_module ofd/ofd
516                 load_module osp/osp
517     fi
518
519
520     load_module llite/lustre
521     llite_lloop_enabled && load_module llite/llite_lloop
522     [ -d /r ] && OGDB=${OGDB:-"/r/tmp"}
523     OGDB=${OGDB:-$TMP}
524     rm -f $OGDB/ogdb-$HOSTNAME
525     $LCTL modules > $OGDB/ogdb-$HOSTNAME
526
527     # 'mount' doesn't look in $PATH, just sbin
528     if [ -f $LUSTRE/utils/mount.lustre ] && \
529        ! grep -qe "/sbin/mount\.lustre " /proc/mounts; then
530         [ ! -f /sbin/mount.lustre ] && touch /sbin/mount.lustre
531         mount --bind $LUSTRE/utils/mount.lustre /sbin/mount.lustre || true
532     fi
533 }
534
535 load_modules () {
536         load_modules_local
537         # bug 19124
538         # load modules on remote nodes optionally
539         # lustre-tests have to be installed on these nodes
540         if $LOAD_MODULES_REMOTE; then
541                 local list=$(comma_list $(remote_nodes_list))
542                 if [ -n "$list" ]; then
543                         echo "loading modules on: '$list'"
544                         do_rpc_nodes "$list" load_modules_local
545                 fi
546         fi
547 }
548
549 check_mem_leak () {
550     LEAK_LUSTRE=$(dmesg | tail -n 30 | grep "obd_memory.*leaked" || true)
551     LEAK_PORTALS=$(dmesg | tail -n 20 | grep "Portals memory leaked" || true)
552     if [ "$LEAK_LUSTRE" -o "$LEAK_PORTALS" ]; then
553         echo "$LEAK_LUSTRE" 1>&2
554         echo "$LEAK_PORTALS" 1>&2
555         mv $TMP/debug $TMP/debug-leak.`date +%s` || true
556         echo "Memory leaks detected"
557         [ -n "$IGNORE_LEAK" ] && { echo "ignoring leaks" && return 0; } || true
558         return 1
559     fi
560 }
561
562 unload_modules() {
563         wait_exit_ST client # bug 12845
564
565         $LUSTRE_RMMOD ldiskfs || return 2
566
567         if $LOAD_MODULES_REMOTE; then
568                 local list=$(comma_list $(remote_nodes_list))
569                 if [ -n "$list" ]; then
570                         echo "unloading modules on: '$list'"
571                         do_rpc_nodes "$list" $LUSTRE_RMMOD ldiskfs
572                         do_rpc_nodes "$list" check_mem_leak
573                 fi
574         fi
575
576     if grep -qe "/sbin/mount\.lustre" /proc/mounts; then
577         umount /sbin/mount.lustre || true
578         [ -w /sbin/mount.lustre -a ! -s /sbin/mount.lustre ] && \
579             rm -f /sbin/mount.lustre || true
580     fi
581
582     check_mem_leak || return 254
583
584     echo "modules unloaded."
585     return 0
586 }
587
588 check_gss_daemon_nodes() {
589     local list=$1
590     dname=$2
591
592     do_nodesv $list "num=\\\$(ps -o cmd -C $dname | grep $dname | wc -l);
593 if [ \\\"\\\$num\\\" -ne 1 ]; then
594     echo \\\$num instance of $dname;
595     exit 1;
596 fi; "
597 }
598
599 check_gss_daemon_facet() {
600     facet=$1
601     dname=$2
602
603     num=`do_facet $facet ps -o cmd -C $dname | grep $dname | wc -l`
604     if [ $num -ne 1 ]; then
605         echo "$num instance of $dname on $facet"
606         return 1
607     fi
608     return 0
609 }
610
611 send_sigint() {
612     local list=$1
613     shift
614     echo Stopping $@ on $list
615     do_nodes $list "killall -2 $@ 2>/dev/null || true"
616 }
617
618 # start gss daemons on all nodes, or
619 # "daemon" on "list" if set
620 start_gss_daemons() {
621     local list=$1
622     local daemon=$2
623
624     if [ "$list" ] && [ "$daemon" ] ; then
625         echo "Starting gss daemon on nodes: $list"
626         do_nodes $list "$daemon" || return 8
627         return 0
628     fi
629
630     local list=$(comma_list $(mdts_nodes))
631
632     echo "Starting gss daemon on mds: $list"
633     do_nodes $list "$LSVCGSSD -v" || return 1
634     if $GSS_PIPEFS; then
635         do_nodes $list "$LGSSD -v" || return 2
636     fi
637
638     list=$(comma_list $(osts_nodes))
639     echo "Starting gss daemon on ost: $list"
640     do_nodes $list "$LSVCGSSD -v" || return 3
641     # starting on clients
642
643     local clients=${CLIENTS:-`hostname`}
644     if $GSS_PIPEFS; then
645         echo "Starting $LGSSD on clients $clients "
646         do_nodes $clients  "$LGSSD -v" || return 4
647     fi
648
649     # wait daemons entering "stable" status
650     sleep 5
651
652     #
653     # check daemons are running
654     #
655     list=$(comma_list $(mdts_nodes) $(osts_nodes))
656     check_gss_daemon_nodes $list lsvcgssd || return 5
657     if $GSS_PIPEFS; then
658         list=$(comma_list $(mdts_nodes))
659         check_gss_daemon_nodes $list lgssd || return 6
660     fi
661     if $GSS_PIPEFS; then
662         check_gss_daemon_nodes $clients lgssd || return 7
663     fi
664 }
665
666 stop_gss_daemons() {
667     local list=$(comma_list $(mdts_nodes))
668     
669     send_sigint $list lsvcgssd lgssd
670
671     list=$(comma_list $(osts_nodes))
672     send_sigint $list lsvcgssd
673
674     list=${CLIENTS:-`hostname`}
675     send_sigint $list lgssd
676 }
677
678 init_gss() {
679     if $GSS; then
680         if ! module_loaded ptlrpc_gss; then
681             load_module ptlrpc/gss/ptlrpc_gss
682             module_loaded ptlrpc_gss ||
683                 error_exit "init_gss : GSS=$GSS, but gss/krb5 is not supported!"
684         fi
685         start_gss_daemons || error_exit "start gss daemon failed! rc=$?"
686
687         if [ -n "$LGSS_KEYRING_DEBUG" ]; then
688             echo $LGSS_KEYRING_DEBUG > /proc/fs/lustre/sptlrpc/gss/lgss_keyring/debug_level
689         fi
690     fi
691 }
692
693 cleanup_gss() {
694     if $GSS; then
695         stop_gss_daemons
696         # maybe cleanup credential cache?
697     fi
698 }
699
700 facet_type() {
701         local facet=$1
702
703         echo -n $facet | sed -e 's/^fs[0-9]\+//' -e 's/[0-9_]\+//' |
704                 tr '[:lower:]' '[:upper:]'
705 }
706
707 facet_number() {
708         local facet=$1
709
710         if [ $facet == mgs ]; then
711                 return 1
712         fi
713
714         echo -n $facet | sed -e 's/^fs[0-9]\+//' | sed -e 's/^[a-z]\+//'
715 }
716
717 facet_fstype() {
718         local facet=$1
719         local var
720
721         var=${facet}_FSTYPE
722         if [ -n "${!var}" ]; then
723                 echo -n ${!var}
724                 return
725         fi
726
727         var=$(facet_type $facet)FSTYPE
728         if [ -n "${!var}" ]; then
729                 echo -n ${!var}
730                 return
731         fi
732
733         if [ -n "$FSTYPE" ]; then
734                 echo -n $FSTYPE
735                 return
736         fi
737
738         if [[ $facet == mgs ]] && combined_mgs_mds; then
739                 facet_fstype mds1
740                 return
741         fi
742
743         return 1
744 }
745
746 node_fstypes() {
747         local node=$1
748         local fstypes
749         local fstype
750         local facets=$(get_facets)
751         local facet
752
753         for facet in ${facets//,/ }; do
754                 if [ $node == $(facet_host $facet) ] ||
755                    [ $node == "$(facet_failover_host $facet)" ]; then
756                         fstype=$(facet_fstype $facet)
757                         if [[ $fstypes != *$fstype* ]]; then
758                                 fstypes+="${fstypes:+,}$fstype"
759                         fi
760                 fi
761         done
762         echo -n $fstypes
763 }
764
765 devicelabel() {
766         local facet=$1
767         local dev=$2
768         local label
769         local fstype=$(facet_fstype $facet)
770
771         case $fstype in
772         ldiskfs)
773                 label=$(do_facet ${facet} "$E2LABEL ${dev} 2>/dev/null");;
774         zfs)
775                 label=$(do_facet ${facet} "$ZFS get -H -o value lustre:svname \
776                                            ${dev} 2>/dev/null");;
777         *)
778                 error "unknown fstype!";;
779         esac
780
781         echo -n $label
782 }
783
784 mdsdevlabel() {
785         local num=$1
786         local device=$(mdsdevname $num)
787         local label=$(devicelabel mds$num ${device} | grep -v "CMD: ")
788         echo -n $label
789 }
790
791 ostdevlabel() {
792         local num=$1
793         local device=$(ostdevname $num)
794         local label=$(devicelabel ost$num ${device} | grep -v "CMD: ")
795         echo -n $label
796 }
797
798 #
799 # This and set_osd_param() shall be used to access OSD parameters
800 # once existed under "obdfilter":
801 #
802 #   mntdev
803 #   stats
804 #   read_cache_enable
805 #   writethrough_cache_enable
806 #
807 get_osd_param() {
808         local nodes=$1
809         local device=${2:-$FSNAME-OST*}
810         local name=$3
811
812         do_nodes $nodes "$LCTL get_param -n obdfilter.$device.$name \
813                 osd-*.$device.$name 2>&1" | grep -v 'Found no match'
814 }
815
816 set_osd_param() {
817         local nodes=$1
818         local device=${2:-$FSNAME-OST*}
819         local name=$3
820         local value=$4
821
822         do_nodes $nodes "$LCTL set_param -n obdfilter.$device.$name=$value \
823                 osd-*.$device.$name=$value 2>&1" | grep -v 'Found no match'
824 }
825
826 set_debug_size () {
827     local dz=${1:-$DEBUG_SIZE}
828
829     if [ -f /sys/devices/system/cpu/possible ]; then
830         local cpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/possible)+1))
831     else
832         local cpus=$(getconf _NPROCESSORS_CONF)
833     fi
834
835     # bug 19944, adjust size to be -gt num_possible_cpus()
836     # promise 2MB for every cpu at least
837     if [ -n "$cpus" ] && [ $((cpus * 2)) -gt $dz ]; then
838         dz=$((cpus * 2))
839     fi
840     lctl set_param debug_mb=$dz
841 }
842
843 set_default_debug () {
844     local debug=${1:-"$PTLDEBUG"}
845     local subsys=${2:-"$SUBSYSTEM"}
846     local debug_size=${3:-$DEBUG_SIZE}
847
848     [ -n "$debug" ] && lctl set_param debug="$debug" >/dev/null
849     [ -n "$subsys" ] && lctl set_param subsystem_debug="${subsys# }" >/dev/null
850
851     [ -n "$debug_size" ] && set_debug_size $debug_size > /dev/null
852 }
853
854 set_default_debug_nodes () {
855         local nodes="$1"
856
857         if [[ ,$nodes, = *,$HOSTNAME,* ]]; then
858                 nodes=$(exclude_items_from_list "$nodes" "$HOSTNAME")
859                 set_default_debug
860         fi
861
862         do_rpc_nodes "$nodes" set_default_debug \
863                 \\\"$PTLDEBUG\\\" \\\"$SUBSYSTEM\\\" $DEBUG_SIZE || true
864 }
865
866 set_default_debug_facet () {
867     local facet=$1
868     local node=$(facet_active_host $facet)
869     [ -z "$node" ] && echo "No host defined for facet $facet" && exit 1
870
871     set_default_debug_nodes $node
872 }
873
874 # Facet functions
875 mount_facets () {
876         local facets=${1:-$(get_facets)}
877         local facet
878
879         for facet in ${facets//,/ }; do
880                 mount_facet $facet
881                 local RC=$?
882                 [ $RC -eq 0 ] && continue
883
884                 if [ "$TESTSUITE.$TESTNAME" = "replay-dual.test_0a" ]; then
885                         skip "Restart of $facet failed!." && touch $LU482_FAILED
886                 else
887                         error "Restart of $facet failed!"
888                 fi
889                 return $RC
890         done
891 }
892
893 #
894 # Add argument "arg" (e.g., "loop") to the comma-separated list
895 # of arguments for option "opt" (e.g., "-o") on command
896 # line "opts" (e.g., "-o flock").
897 #
898 csa_add() {
899         local opts=$1
900         local opt=$2
901         local arg=$3
902         local opt_pattern="\([[:space:]]\+\|^\)$opt"
903
904         if echo "$opts" | grep -q $opt_pattern; then
905                 opts=$(echo "$opts" | sed -e \
906                         "s/$opt_pattern[[:space:]]*[^[:space:]]\+/&,$arg/")
907         else
908                 opts+="${opts:+ }$opt $arg"
909         fi
910         echo -n "$opts"
911 }
912
913 mount_facet() {
914         local facet=$1
915         shift
916         local dev=$(facet_active $facet)_dev
917         local opt=${facet}_opt
918         local mntpt=$(facet_mntpt $facet)
919         local opts="${!opt} $@"
920
921         if [ $(facet_fstype $facet) == ldiskfs ] &&
922            ! do_facet $facet test -b ${!dev}; then
923                 opts=$(csa_add "$opts" -o loop)
924         fi
925
926         echo "Starting ${facet}: $opts ${!dev} $mntpt"
927         # for testing LU-482 error handling in mount_facets() and test_0a()
928         if [ -f $TMP/test-lu482-trigger ]; then
929                 RC=2
930         else
931                 do_facet ${facet} "mkdir -p $mntpt; mount -t lustre $opts \
932                                    ${!dev} $mntpt"
933                 RC=${PIPESTATUS[0]}
934         fi
935         if [ $RC -ne 0 ]; then
936                 echo "Start of ${!dev} on ${facet} failed ${RC}"
937     else
938         set_default_debug_facet $facet
939
940                 label=$(devicelabel ${facet} ${!dev})
941         [ -z "$label" ] && echo no label for ${!dev} && exit 1
942         eval export ${facet}_svc=${label}
943         echo Started ${label}
944     fi
945     return $RC
946 }
947
948 # start facet device options
949 start() {
950     local facet=$1
951     shift
952     local device=$1
953     shift
954     eval export ${facet}_dev=${device}
955     eval export ${facet}_opt=\"$@\"
956
957     local varname=${facet}failover_dev
958     if [ -n "${!varname}" ] ; then
959         eval export ${facet}failover_dev=${!varname}
960     else
961         eval export ${facet}failover_dev=$device
962     fi
963
964     local mntpt=$(facet_mntpt $facet)
965     do_facet ${facet} mkdir -p $mntpt
966     eval export ${facet}_MOUNT=$mntpt
967     mount_facet ${facet}
968     RC=$?
969     return $RC
970 }
971
972 #
973 # When a ZFS OSD is made read-only by replay_barrier(), its pool is "freezed".
974 # Because stopping corresponding target may not clear this in-memory state, we
975 # need to zap the pool from memory by exporting and reimporting the pool.
976 #
977 # Although the uberblocks are not updated when a pool is freezed, transactions
978 # are still written to the disks.  Modified blocks may be cached in memory when
979 # tests try reading them back.  The export-and-reimport process also evicts any
980 # cached pool data from memory to provide the correct "data loss" semantics.
981 #
982 refresh_disk() {
983         local facet=$1
984         local fstype=$(facet_fstype $facet)
985         local _dev
986         local dev
987         local poolname
988
989         if [ "${fstype}" == "zfs" ]; then
990                 _dev=$(facet_active $facet)_dev
991                 dev=${!_dev} # expand _dev to its value, e.g. ${mds1_dev}
992                 poolname="${dev%%/*}" # poolname is string before "/"
993
994                 if [ "${poolname}" == "" ]; then
995                         echo "invalid dataset name: $dev"
996                         return
997                 fi
998                 do_facet $facet "cp /etc/zfs/zpool.cache /tmp/zpool.cache.back"
999                 do_facet $facet "$ZPOOL export ${poolname}"
1000                 do_facet $facet "$ZPOOL import -f -c /tmp/zpool.cache.back \
1001                                  ${poolname}"
1002         fi
1003 }
1004
1005 stop() {
1006     local running
1007     local facet=$1
1008     shift
1009     local HOST=`facet_active_host $facet`
1010     [ -z $HOST ] && echo stop: no host for $facet && return 0
1011
1012     local mntpt=$(facet_mntpt $facet)
1013     running=$(do_facet ${facet} "grep -c $mntpt' ' /proc/mounts") || true
1014     if [ ${running} -ne 0 ]; then
1015         echo "Stopping $mntpt (opts:$@) on $HOST"
1016         do_facet ${facet} umount -d $@ $mntpt
1017     fi
1018
1019     # umount should block, but we should wait for unrelated obd's
1020     # like the MGS or MGC to also stop.
1021     wait_exit_ST ${facet}
1022 }
1023
1024 # save quota version (both administrative and operational quotas)
1025 # add an additional parameter if mountpoint is ever different from $MOUNT
1026 #
1027 # XXX This function is kept for interoperability with old server (< 2.3.50),
1028 #     it should be removed whenever we drop the interoperability for such
1029 #     server.
1030 quota_save_version() {
1031     local fsname=${2:-$FSNAME}
1032     local spec=$1
1033     local ver=$(tr -c -d "123" <<< $spec)
1034     local type=$(tr -c -d "ug" <<< $spec)
1035
1036     [ -n "$ver" -a "$ver" != "3" ] && error "wrong quota version specifier"
1037
1038     [ -n "$type" ] && { $LFS quotacheck -$type $MOUNT || error "quotacheck has failed"; }
1039
1040     do_facet mgs "lctl conf_param ${fsname}-MDT*.mdd.quota_type=$spec"
1041     local varsvc
1042     local osts=$(get_facets OST)
1043     for ost in ${osts//,/ }; do
1044         varsvc=${ost}_svc
1045         do_facet mgs "lctl conf_param ${!varsvc}.ost.quota_type=$spec"
1046     done
1047 }
1048
1049 # client could mount several lustre
1050 #
1051 # XXX This function is kept for interoperability with old server (< 2.3.50),
1052 #     it should be removed whenever we drop the interoperability for such
1053 #     server.
1054 quota_type() {
1055         local fsname=${1:-$FSNAME}
1056         local rc=0
1057         do_facet $SINGLEMDS lctl get_param mdd.${fsname}-MDT*.quota_type ||
1058                 rc=$?
1059         do_nodes $(comma_list $(osts_nodes)) \
1060                 lctl get_param obdfilter.${fsname}-OST*.quota_type || rc=$?
1061         return $rc 
1062 }
1063
1064 # XXX This function is kept for interoperability with old server (< 2.3.50),
1065 #     it should be removed whenever we drop the interoperability for such
1066 #     server.
1067 restore_quota_old() {
1068         local mntpt=${1:-$MOUNT}
1069         local quota_type=$(quota_type $FSNAME | grep MDT | cut -d "=" -f2)
1070         if [ ! "$old_QUOTA_TYPE" ] ||
1071                 [ "$quota_type" = "$old_QUOTA_TYPE" ]; then
1072                 return
1073         fi
1074         quota_save_version $old_QUOTA_TYPE
1075 }
1076
1077 # XXX This function is kept for interoperability with old server (< 2.3.50),
1078 #     it should be removed whenever we drop the interoperability for such
1079 #     server.
1080 setup_quota_old(){
1081         local mntpt=$1
1082
1083         # no quota enforcement for now and accounting works out of the box
1084         return
1085
1086     # We need save the original quota_type params, and restore them after testing
1087
1088     # Suppose that quota type the same on mds and ost
1089     local quota_type=$(quota_type | grep MDT | cut -d "=" -f2)
1090     [ ${PIPESTATUS[0]} -eq 0 ] || error "quota_type failed!"
1091     echo "[HOST:$HOSTNAME] [old_quota_type:$quota_type] [new_quota_type:$QUOTA_TYPE]"
1092     if [ "$quota_type" != "$QUOTA_TYPE" ]; then
1093         export old_QUOTA_TYPE=$quota_type
1094         quota_save_version $QUOTA_TYPE
1095     else
1096         qtype=$(tr -c -d "ug" <<< $QUOTA_TYPE)
1097         $LFS quotacheck -$qtype $mntpt || error "quotacheck has failed for $type"
1098     fi
1099
1100     local quota_usrs=$QUOTA_USERS
1101
1102     # get_filesystem_size
1103     local disksz=$(lfs_df $mntpt | grep "summary"  | awk '{print $2}')
1104     local blk_soft=$((disksz + 1024))
1105     local blk_hard=$((blk_soft + blk_soft / 20)) # Go 5% over
1106
1107     local Inodes=$(lfs_df -i $mntpt | grep "summary"  | awk '{print $2}')
1108     local i_soft=$Inodes
1109     local i_hard=$((i_soft + i_soft / 20))
1110
1111     echo "Total disk size: $disksz  block-softlimit: $blk_soft block-hardlimit:
1112         $blk_hard inode-softlimit: $i_soft inode-hardlimit: $i_hard"
1113
1114     local cmd
1115     for usr in $quota_usrs; do
1116         echo "Setting up quota on $HOSTNAME:$mntpt for $usr..."
1117         for type in u g; do
1118             cmd="$LFS setquota -$type $usr -b $blk_soft -B $blk_hard -i $i_soft -I $i_hard $mntpt"
1119             echo "+ $cmd"
1120             eval $cmd || error "$cmd FAILED!"
1121         done
1122         # display the quota status
1123         echo "Quota settings for $usr : "
1124         $LFS quota -v -u $usr $mntpt || true
1125     done
1126 }
1127
1128 # get mdt quota type
1129 mdt_quota_type() {
1130         local varsvc=${SINGLEMDS}_svc
1131         do_facet $SINGLEMDS $LCTL get_param -n \
1132                 osd-$(facet_fstype $SINGLEMDS).${!varsvc}.quota_slave.enabled
1133 }
1134
1135 # get ost quota type
1136 ost_quota_type() {
1137         # All OSTs should have same quota type
1138         local varsvc=ost1_svc
1139         do_facet ost1 $LCTL get_param -n \
1140                 osd-$(facet_fstype ost1).${!varsvc}.quota_slave.enabled
1141 }
1142
1143 # restore old quota type settings
1144 restore_quota() {
1145         if [ $(lustre_version_code $SINGLEMDS) -lt $(version_code 2.3.50) ]; then
1146                 restore_quota_old
1147                 return
1148         fi
1149
1150         if [ "$old_MDT_QUOTA_TYPE" ]; then
1151                 do_facet mgs $LCTL conf_param \
1152                         $FSNAME.quota.mdt=$old_MDT_QUOTA_TYPE
1153         fi
1154         if [ "$old_OST_QUOTA_TYPE" ]; then
1155                 do_facet mgs $LCTL conf_param \
1156                         $FSNAME.quota.ost=$old_OST_QUOTA_TYPE
1157         fi
1158 }
1159
1160 # Handle the case when there is a space in the lfs df
1161 # "filesystem summary" line the same as when there is no space.
1162 # This will allow fixing the "lfs df" summary line in the future.
1163 lfs_df() {
1164         $LFS df $* | sed -e 's/filesystem /filesystem_/'
1165 }
1166
1167 setup_quota(){
1168         if [ $(lustre_version_code $SINGLEMDS) -lt $(version_code 2.3.50) ]; then
1169                 setup_quota_old $1
1170                 return
1171         fi
1172
1173         local mntpt=$1
1174
1175         # save old quota type & set new quota type
1176         local mdt_qtype=$(mdt_quota_type)
1177         local ost_qtype=$(ost_quota_type)
1178
1179         echo "[HOST:$HOSTNAME] [old_mdt_qtype:$mdt_qtype]" \
1180                 "[old_ost_qtype:$ost_qtype] [new_qtype:$QUOTA_TYPE]"
1181
1182         export old_MDT_QUOTA_TYPE=$mdt_qtype
1183         export old_OST_QUOTA_TYPE=$ost_qtype
1184
1185         do_facet mgs $LCTL conf_param $FSNAME.quota.mdt=$QUOTA_TYPE ||
1186                 error "set mdt quota type failed"
1187         do_facet mgs $LCTL conf_param $FSNAME.quota.ost=$QUOTA_TYPE ||
1188                 error "set ost quota type failed"
1189
1190         local quota_usrs=$QUOTA_USERS
1191
1192         # get_filesystem_size
1193         local disksz=$(lfs_df $mntpt | grep "summary" | awk '{print $2}')
1194         local blk_soft=$((disksz + 1024))
1195         local blk_hard=$((blk_soft + blk_soft / 20)) # Go 5% over
1196
1197         local inodes=$(lfs_df -i $mntpt | grep "summary" | awk '{print $2}')
1198         local i_soft=$inodes
1199         local i_hard=$((i_soft + i_soft / 20))
1200
1201         echo "Total disk size: $disksz  block-softlimit: $blk_soft" \
1202                 "block-hardlimit: $blk_hard inode-softlimit: $i_soft" \
1203                 "inode-hardlimit: $i_hard"
1204
1205         local cmd
1206         for usr in $quota_usrs; do
1207                 echo "Setting up quota on $HOSTNAME:$mntpt for $usr..."
1208                 for type in u g; do
1209                         cmd="$LFS setquota -$type $usr -b $blk_soft"
1210                         cmd="$cmd -B $blk_hard -i $i_soft -I $i_hard $mntpt"
1211                         echo "+ $cmd"
1212                         eval $cmd || error "$cmd FAILED!"
1213                 done
1214                 # display the quota status
1215                 echo "Quota settings for $usr : "
1216                 $LFS quota -v -u $usr $mntpt || true
1217         done
1218 }
1219
1220 zconf_mount() {
1221     local client=$1
1222     local mnt=$2
1223     local OPTIONS=${3:-$MOUNTOPT}
1224
1225     local device=$MGSNID:/$FSNAME
1226     if [ -z "$mnt" -o -z "$FSNAME" ]; then
1227         echo Bad zconf mount command: opt=$OPTIONS dev=$device mnt=$mnt
1228         exit 1
1229     fi
1230
1231     echo "Starting client: $client: $OPTIONS $device $mnt"
1232     do_node $client mkdir -p $mnt
1233     do_node $client mount -t lustre $OPTIONS $device $mnt || return 1
1234
1235     set_default_debug_nodes $client
1236
1237     return 0
1238 }
1239
1240 zconf_umount() {
1241     local client=$1
1242     local mnt=$2
1243     local force
1244     local busy 
1245     local need_kill
1246
1247     [ "$3" ] && force=-f
1248     local running=$(do_node $client "grep -c $mnt' ' /proc/mounts") || true
1249     if [ $running -ne 0 ]; then
1250         echo "Stopping client $client $mnt (opts:$force)"
1251         do_node $client lsof -t $mnt || need_kill=no
1252         if [ "x$force" != "x" -a "x$need_kill" != "xno" ]; then
1253             pids=$(do_node $client lsof -t $mnt | sort -u);
1254             if [ -n $pids ]; then
1255                 do_node $client kill -9 $pids || true
1256             fi
1257         fi
1258
1259         busy=$(do_node $client "umount $force $mnt 2>&1" | grep -c "busy") || true
1260         if [ $busy -ne 0 ] ; then
1261             echo "$mnt is still busy, wait one second" && sleep 1
1262             do_node $client umount $force $mnt
1263         fi
1264     fi
1265 }
1266
1267 # nodes is comma list
1268 sanity_mount_check_nodes () {
1269     local nodes=$1
1270     shift
1271     local mnts="$@"
1272     local mnt
1273
1274     # FIXME: assume that all cluster nodes run the same os
1275     [ "$(uname)" = Linux ] || return 0
1276
1277     local rc=0
1278     for mnt in $mnts ; do
1279         do_nodes $nodes "running=\\\$(grep -c $mnt' ' /proc/mounts);
1280 mpts=\\\$(mount | grep -c $mnt' ');
1281 if [ \\\$running -ne \\\$mpts ]; then
1282     echo \\\$(hostname) env are INSANE!;
1283     exit 1;
1284 fi"
1285     [ $? -eq 0 ] || rc=1 
1286     done
1287     return $rc
1288 }
1289
1290 sanity_mount_check_servers () {
1291     [ "$CLIENTONLY" ] && 
1292         { echo "CLIENTONLY mode, skip mount_check_servers"; return 0; } || true
1293     echo Checking servers environments
1294
1295     # FIXME: modify get_facets to display all facets wo params
1296     local facets="$(get_facets OST),$(get_facets MDS),mgs"
1297     local node
1298     local mntpt
1299     local facet
1300     for facet in ${facets//,/ }; do
1301         node=$(facet_host ${facet})
1302         mntpt=$(facet_mntpt $facet)
1303         sanity_mount_check_nodes $node $mntpt ||
1304             { error "server $node environments are insane!"; return 1; }
1305     done
1306 }
1307
1308 sanity_mount_check_clients () {
1309     local clients=${1:-$CLIENTS}
1310     local mntpt=${2:-$MOUNT}
1311     local mntpt2=${3:-$MOUNT2}
1312
1313     [ -z $clients ] && clients=$(hostname)
1314     echo Checking clients $clients environments
1315
1316     sanity_mount_check_nodes $clients $mntpt $mntpt2 ||
1317        error "clients environments are insane!"
1318 }
1319
1320 sanity_mount_check () {
1321     sanity_mount_check_servers || return 1
1322     sanity_mount_check_clients || return 2
1323 }
1324
1325 # mount clients if not mouted
1326 zconf_mount_clients() {
1327     local clients=$1
1328     local mnt=$2
1329     local OPTIONS=${3:-$MOUNTOPT}
1330
1331     local device=$MGSNID:/$FSNAME
1332     if [ -z "$mnt" -o -z "$FSNAME" ]; then
1333         echo Bad zconf mount command: opt=$OPTIONS dev=$device mnt=$mnt
1334         exit 1
1335     fi
1336
1337     echo "Starting client $clients: $OPTIONS $device $mnt"
1338
1339     do_nodes $clients "
1340 running=\\\$(mount | grep -c $mnt' ');
1341 rc=0;
1342 if [ \\\$running -eq 0 ] ; then
1343     mkdir -p $mnt;
1344     mount -t lustre $OPTIONS $device $mnt;
1345     rc=\\\$?;
1346 fi;
1347 exit \\\$rc" || return ${PIPESTATUS[0]}
1348
1349     echo "Started clients $clients: "
1350     do_nodes $clients "mount | grep $mnt' '"
1351
1352     set_default_debug_nodes $clients
1353
1354     return 0
1355 }
1356
1357 zconf_umount_clients() {
1358     local clients=$1
1359     local mnt=$2
1360     local force
1361
1362     [ "$3" ] && force=-f
1363
1364     echo "Stopping clients: $clients $mnt (opts:$force)"
1365     do_nodes $clients "running=\\\$(grep -c $mnt' ' /proc/mounts);
1366 if [ \\\$running -ne 0 ] ; then
1367 echo Stopping client \\\$(hostname) $mnt opts:$force;
1368 lsof $mnt || need_kill=no;
1369 if [ "x$force" != "x" -a "x\\\$need_kill" != "xno" ]; then
1370     pids=\\\$(lsof -t $mnt | sort -u);
1371     if [ -n \\\"\\\$pids\\\" ]; then
1372              kill -9 \\\$pids;
1373     fi
1374 fi;
1375 while umount $force $mnt 2>&1 | grep -q "busy"; do
1376     echo "$mnt is still busy, wait one second" && sleep 1;
1377 done;
1378 fi"
1379 }
1380
1381 shutdown_node () {
1382     local node=$1
1383     echo + $POWER_DOWN $node
1384     $POWER_DOWN $node
1385 }
1386
1387 shutdown_node_hard () {
1388     local host=$1
1389     local attempts=$SHUTDOWN_ATTEMPTS
1390
1391     for i in $(seq $attempts) ; do
1392         shutdown_node $host
1393         sleep 1
1394         wait_for_function --quiet "! ping -w 3 -c 1 $host" 5 1 && return 0
1395         echo "waiting for $host to fail attempts=$attempts"
1396         [ $i -lt $attempts ] || \
1397             { echo "$host still pingable after power down! attempts=$attempts" && return 1; } 
1398     done
1399 }
1400
1401 shutdown_client() {
1402     local client=$1
1403     local mnt=${2:-$MOUNT}
1404     local attempts=3
1405
1406     if [ "$FAILURE_MODE" = HARD ]; then
1407         shutdown_node_hard $client
1408     else
1409        zconf_umount_clients $client $mnt -f
1410     fi
1411 }
1412
1413 facets_on_host () {
1414     local host=$1
1415     local facets="$(get_facets OST),$(get_facets MDS)"
1416     local affected
1417
1418     combined_mgs_mds || facets="$facets,mgs"
1419
1420     for facet in ${facets//,/ }; do
1421         if [ $(facet_active_host $facet) == $host ]; then
1422            affected="$affected $facet"
1423         fi
1424     done
1425
1426     echo $(comma_list $affected)
1427 }
1428
1429 facet_up() {
1430         local facet=$1
1431         local host=${2:-$(facet_host $facet)}
1432
1433         local label=$(convert_facet2label $facet)
1434         do_node $host $LCTL dl | awk '{print $4}' | grep -q -x $label
1435 }
1436
1437 facets_up_on_host () {
1438     local host=$1
1439     local facets=$(facets_on_host $host)
1440     local affected_up
1441
1442     for facet in ${facets//,/ }; do
1443         if $(facet_up $facet $host); then
1444             affected_up="$affected_up $facet"
1445         fi
1446     done
1447
1448     echo $(comma_list $affected_up)
1449 }
1450
1451 shutdown_facet() {
1452     local facet=$1
1453
1454     if [ "$FAILURE_MODE" = HARD ]; then
1455         shutdown_node_hard $(facet_active_host $facet)
1456     else
1457         stop $facet
1458     fi
1459 }
1460
1461 reboot_node() {
1462     local node=$1
1463     echo + $POWER_UP $node
1464     $POWER_UP $node
1465 }
1466
1467 remount_facet() {
1468     local facet=$1
1469
1470     stop $facet
1471     mount_facet $facet
1472 }
1473
1474 reboot_facet() {
1475         local facet=$1
1476         if [ "$FAILURE_MODE" = HARD ]; then
1477                 reboot_node $(facet_active_host $facet)
1478         else
1479                 refresh_disk ${facet}
1480                 sleep 10
1481         fi
1482 }
1483
1484 boot_node() {
1485     local node=$1
1486     if [ "$FAILURE_MODE" = HARD ]; then
1487        reboot_node $node
1488        wait_for_host $node
1489     fi
1490 }
1491
1492 facets_hosts () {
1493     local facets=$1
1494     local hosts
1495
1496     for facet in ${facets//,/ }; do
1497         hosts=$(expand_list $hosts $(facet_host $facet) )
1498     done
1499
1500     echo $hosts
1501 }
1502
1503 _check_progs_installed () {
1504     local progs=$@
1505     local rc=0
1506
1507     for prog in $progs; do
1508         if ! [ "$(which $prog)"  -o  "${!prog}" ]; then
1509            echo $prog missing on $(hostname)
1510            rc=1
1511         fi
1512     done
1513     return $rc
1514 }
1515
1516 check_progs_installed () {
1517         local nodes=$1
1518         shift
1519
1520         do_rpc_nodes "$nodes" _check_progs_installed $@
1521 }
1522
1523 # recovery-scale functions
1524 node_var_name() {
1525     echo __$(echo $1 | tr '-' '_' | tr '.' '_')
1526 }
1527
1528 start_client_load() {
1529     local client=$1
1530     local load=$2
1531     local var=$(node_var_name $client)_load
1532     eval export ${var}=$load
1533
1534     do_node $client "PATH=$PATH MOUNT=$MOUNT ERRORS_OK=$ERRORS_OK \
1535 BREAK_ON_ERROR=$BREAK_ON_ERROR \
1536 END_RUN_FILE=$END_RUN_FILE \
1537 LOAD_PID_FILE=$LOAD_PID_FILE \
1538 TESTLOG_PREFIX=$TESTLOG_PREFIX \
1539 TESTNAME=$TESTNAME \
1540 DBENCH_LIB=$DBENCH_LIB \
1541 DBENCH_SRC=$DBENCH_SRC \
1542 LFS=$LFS \
1543 run_${load}.sh" &
1544     local ppid=$!
1545     log "Started client load: ${load} on $client"
1546
1547     # get the children process IDs
1548     local pids=$(ps --ppid $ppid -o pid= | xargs)
1549     CLIENT_LOAD_PIDS="$CLIENT_LOAD_PIDS $ppid $pids"
1550     return 0
1551 }
1552
1553 start_client_loads () {
1554     local -a clients=(${1//,/ })
1555     local numloads=${#CLIENT_LOADS[@]}
1556     local testnum
1557
1558     for ((nodenum=0; nodenum < ${#clients[@]}; nodenum++ )); do
1559         testnum=$((nodenum % numloads))
1560         start_client_load ${clients[nodenum]} ${CLIENT_LOADS[testnum]}
1561     done
1562     # bug 22169: wait the background threads to start
1563     sleep 2
1564 }
1565
1566 # only for remote client
1567 check_client_load () {
1568     local client=$1
1569     local var=$(node_var_name $client)_load
1570     local TESTLOAD=run_${!var}.sh
1571
1572     ps auxww | grep -v grep | grep $client | grep -q "$TESTLOAD" || return 1
1573
1574     # bug 18914: try to connect several times not only when
1575     # check ps, but  while check_catastrophe also
1576     local tries=3
1577     local RC=254
1578     while [ $RC = 254 -a $tries -gt 0 ]; do
1579         let tries=$tries-1
1580         # assume success
1581         RC=0
1582         if ! check_catastrophe $client; then
1583             RC=${PIPESTATUS[0]}
1584             if [ $RC -eq 254 ]; then
1585                 # FIXME: not sure how long we shuold sleep here
1586                 sleep 10
1587                 continue
1588             fi
1589             echo "check catastrophe failed: RC=$RC "
1590             return $RC
1591         fi
1592     done
1593     # We can continue try to connect if RC=254
1594     # Just print the warning about this
1595     if [ $RC = 254 ]; then
1596         echo "got a return status of $RC from do_node while checking catastrophe on $client"
1597     fi
1598
1599     # see if the load is still on the client
1600     tries=3
1601     RC=254
1602     while [ $RC = 254 -a $tries -gt 0 ]; do
1603         let tries=$tries-1
1604         # assume success
1605         RC=0
1606         if ! do_node $client "ps auxwww | grep -v grep | grep -q $TESTLOAD"; then
1607             RC=${PIPESTATUS[0]}
1608             sleep 30
1609         fi
1610     done
1611     if [ $RC = 254 ]; then
1612         echo "got a return status of $RC from do_node while checking (catastrophe and 'ps') the client load on $client"
1613         # see if we can diagnose a bit why this is
1614     fi
1615
1616     return $RC
1617 }
1618 check_client_loads () {
1619    local clients=${1//,/ }
1620    local client=
1621    local rc=0
1622
1623    for client in $clients; do
1624       check_client_load $client
1625       rc=${PIPESTATUS[0]}
1626       if [ "$rc" != 0 ]; then
1627         log "Client load failed on node $client, rc=$rc"
1628         return $rc
1629       fi
1630    done
1631 }
1632
1633 restart_client_loads () {
1634     local clients=${1//,/ }
1635     local expectedfail=${2:-""}
1636     local client=
1637     local rc=0
1638
1639     for client in $clients; do
1640         check_client_load $client
1641         rc=${PIPESTATUS[0]}
1642         if [ "$rc" != 0 -a "$expectedfail" ]; then
1643             local var=$(node_var_name $client)_load
1644             start_client_load $client ${!var}
1645             echo "Restarted client load ${!var}: on $client. Checking ..."
1646             check_client_load $client
1647             rc=${PIPESTATUS[0]}
1648             if [ "$rc" != 0 ]; then
1649                 log "Client load failed to restart on node $client, rc=$rc"
1650                 # failure one client load means test fail
1651                 # we do not need to check other
1652                 return $rc
1653             fi
1654         else
1655             return $rc
1656         fi
1657     done
1658 }
1659
1660 # Start vmstat and save its process ID in a file.
1661 start_vmstat() {
1662     local nodes=$1
1663     local pid_file=$2
1664
1665     [ -z "$nodes" -o -z "$pid_file" ] && return 0
1666
1667     do_nodes $nodes \
1668         "vmstat 1 > $TESTLOG_PREFIX.$TESTNAME.vmstat.\\\$(hostname -s).log \
1669         2>/dev/null </dev/null & echo \\\$! > $pid_file"
1670 }
1671
1672 # Display the nodes on which client loads failed.
1673 print_end_run_file() {
1674     local file=$1
1675     local node
1676
1677     [ -s $file ] || return 0
1678
1679     echo "Found the END_RUN_FILE file: $file"
1680     cat $file
1681
1682     # A client load will stop if it finds the END_RUN_FILE file.
1683     # That does not mean the client load actually failed though.
1684     # The first node in END_RUN_FILE is the one we are interested in.
1685     read node < $file
1686
1687     if [ -n "$node" ]; then
1688         local var=$(node_var_name $node)_load
1689
1690         local prefix=$TESTLOG_PREFIX
1691         [ -n "$TESTNAME" ] && prefix=$prefix.$TESTNAME
1692         local stdout_log=$prefix.run_${!var}_stdout.$node.log
1693         local debug_log=$(echo $stdout_log | sed 's/\(.*\)stdout/\1debug/')
1694
1695         echo "Client load ${!var} failed on node $node:"
1696         echo "$stdout_log"
1697         echo "$debug_log"
1698     fi
1699 }
1700
1701 # Stop the process which had its PID saved in a file.
1702 stop_process() {
1703     local nodes=$1
1704     local pid_file=$2
1705
1706     [ -z "$nodes" -o -z "$pid_file" ] && return 0
1707
1708     do_nodes $nodes "test -f $pid_file &&
1709         { kill -s TERM \\\$(cat $pid_file); rm -f $pid_file; }" || true
1710 }
1711
1712 # Stop all client loads.
1713 stop_client_loads() {
1714     local nodes=${1:-$CLIENTS}
1715     local pid_file=$2
1716
1717     # stop the client loads
1718     stop_process $nodes $pid_file
1719
1720     # clean up the processes that started them
1721     [ -n "$CLIENT_LOAD_PIDS" ] && kill -9 $CLIENT_LOAD_PIDS 2>/dev/null || true
1722 }
1723 # End recovery-scale functions
1724
1725 # verify that lustre actually cleaned up properly
1726 cleanup_check() {
1727     [ -f $CATASTROPHE ] && [ `cat $CATASTROPHE` -ne 0 ] && \
1728         error "LBUG/LASSERT detected"
1729     BUSY=`dmesg | grep -i destruct || true`
1730     if [ "$BUSY" ]; then
1731         echo "$BUSY" 1>&2
1732         [ -e $TMP/debug ] && mv $TMP/debug $TMP/debug-busy.`date +%s`
1733         exit 205
1734     fi
1735
1736     check_mem_leak || exit 204
1737
1738         [ "`lctl dl 2> /dev/null | wc -l`" -gt 0 ] && lctl dl &&
1739                 echo "$TESTSUITE: lustre didn't clean up..." 1>&2 &&
1740                 return 202 || true
1741
1742         if module_loaded lnet || module_loaded libcfs; then
1743                 echo "$TESTSUITE: modules still loaded..." 1>&2
1744                 /sbin/lsmod 1>&2
1745                 return 203
1746         fi
1747         return 0
1748 }
1749
1750 wait_update () {
1751     local node=$1
1752     local TEST=$2
1753     local FINAL=$3
1754     local MAX=${4:-90}
1755
1756         local RESULT
1757         local WAIT=0
1758         local sleep=1
1759         local print=10
1760         while [ true ]; do
1761             RESULT=$(do_node $node "$TEST")
1762             if [ "$RESULT" == "$FINAL" ]; then
1763                 [ -z "$RESULT" -o $WAIT -le $sleep ] ||
1764                     echo "Updated after ${WAIT}s: wanted '$FINAL' got '$RESULT'"
1765                 return 0
1766             fi
1767             [ $WAIT -ge $MAX ] && break
1768             [ $((WAIT % print)) -eq 0 ] &&
1769                 echo "Waiting $((MAX - WAIT)) secs for update"
1770             WAIT=$((WAIT + sleep))
1771             sleep $sleep
1772         done
1773         echo "Update not seen after ${MAX}s: wanted '$FINAL' got '$RESULT'"
1774         return 3
1775 }
1776
1777 wait_update_facet() {
1778         local facet=$1
1779         shift
1780         wait_update $(facet_active_host $facet) "$@"
1781 }
1782
1783 sync_all_data() {
1784         do_node $(osts_nodes) "lctl set_param -n osd*.*OS*.force_sync 1" 2>&1 |
1785                 grep -v 'Found no match'
1786 }
1787
1788 wait_delete_completed_mds() {
1789         local MAX_WAIT=${1:-20}
1790         local mds2sync=""
1791         local stime=`date +%s`
1792         local etime
1793         local node
1794         local changes
1795
1796         # find MDS with pending deletions
1797         for node in $(mdts_nodes); do
1798                 changes=$(do_node $node "lctl get_param -n osc.*MDT*.sync_*" \
1799                         2>/dev/null | calc_sum)
1800                 if [ -z "$changes" ] || [ $changes -eq 0 ]; then
1801                         continue
1802                 fi
1803                 mds2sync="$mds2sync $node"
1804         done
1805         if [ "$mds2sync" == "" ]; then
1806                 return
1807         fi
1808         mds2sync=$(comma_list $mds2sync)
1809
1810         # sync MDS transactions
1811         do_nodes $mds2sync "lctl set_param -n osd*.*MD*.force_sync 1"
1812
1813         # wait till all changes are sent and commmitted by OSTs
1814         # for ldiskfs space is released upon execution, but DMU
1815         # do this upon commit
1816
1817         local WAIT=0
1818         while [ "$WAIT" -ne "$MAX_WAIT" ]; do
1819                 changes=$(do_nodes $mds2sync "lctl get_param -n osc.*MDT*.sync_*" \
1820                         | calc_sum)
1821                 #echo "$node: $changes changes on all"
1822                 if [ "$changes" -eq "0" ]; then
1823                         etime=`date +%s`
1824                         #echo "delete took $((etime - stime)) seconds"
1825                         return
1826                 fi
1827                 sleep 1
1828                 WAIT=$(( WAIT + 1))
1829         done
1830
1831         etime=`date +%s`
1832         echo "Delete is not completed in $((etime - stime)) seconds"
1833         do_nodes $mds2sync "lctl get_param osc.*MDT*.sync_*"
1834 }
1835
1836 wait_for_host() {
1837     local hostlist=$1
1838
1839     # we can use "for" here because we are waiting the slowest
1840     for host in ${hostlist//,/ }; do
1841         check_network "$host" 900
1842     done
1843     while ! do_nodes $hostlist hostname  > /dev/null; do sleep 5; done
1844 }
1845
1846 wait_for_facet() {
1847     local facetlist=$1
1848     local hostlist
1849
1850     for facet in ${facetlist//,/ }; do
1851         hostlist=$(expand_list $hostlist $(facet_active_host $facet))
1852     done
1853     wait_for_host $hostlist
1854 }
1855
1856 _wait_recovery_complete () {
1857     local param=$1
1858
1859     # Use default policy if $2 is not passed by caller.
1860     local MAX=${2:-$(max_recovery_time)}
1861
1862     local WAIT=0
1863     local STATUS=
1864
1865     while [ $WAIT -lt $MAX ]; do
1866         STATUS=$(lctl get_param -n $param | grep status)
1867         echo $param $STATUS
1868         [[ $STATUS = "status: COMPLETE" || $STATUS = "status: INACTIVE" ]] && return 0
1869         sleep 5
1870         WAIT=$((WAIT + 5))
1871         echo "Waiting $((MAX - WAIT)) secs for $param recovery done. $STATUS"
1872     done
1873     echo "$param recovery not done in $MAX sec. $STATUS"
1874     return 1
1875 }
1876
1877 wait_recovery_complete () {
1878     local facet=$1
1879
1880     # with an assumption that at_max is the same on all nodes
1881     local MAX=${2:-$(max_recovery_time)}
1882
1883     local facets=$facet
1884     if [ "$FAILURE_MODE" = HARD ]; then
1885         facets=$(facets_on_host $(facet_active_host $facet))
1886     fi
1887     echo affected facets: $facets
1888
1889         # we can use "for" here because we are waiting the slowest
1890         for facet in ${facets//,/ }; do
1891                 local var_svc=${facet}_svc
1892                 local param="*.${!var_svc}.recovery_status"
1893
1894                 local host=$(facet_active_host $facet)
1895                 do_rpc_nodes "$host" _wait_recovery_complete $param $MAX
1896         done
1897 }
1898
1899 wait_mds_ost_sync () {
1900         # just because recovery is done doesn't mean we've finished
1901         # orphan cleanup. Wait for llogs to get synchronized.
1902         echo "Waiting for orphan cleanup..."
1903         # MAX value includes time needed for MDS-OST reconnection
1904         local MAX=$(( TIMEOUT * 2 ))
1905         local WAIT=0
1906         local new_wait=true
1907         local list=$(comma_list $(mdts_nodes))
1908         local cmd="$LCTL get_param -n osp.*osc*.old_sync_processed"
1909         if ! do_facet $SINGLEMDS \
1910                 "$LCTL list_param osp.*osc*.old_sync_processed 2> /dev/null"
1911         then
1912                 # old way, use mds_sync
1913                 new_wait=false
1914                 list=$(comma_list $(osts_nodes))
1915                 cmd="$LCTL get_param -n obdfilter.*.mds_sync"
1916         fi
1917         while [ $WAIT -lt $MAX ]; do
1918                 local -a sync=($(do_nodes $list "$cmd"))
1919                 local con=1
1920                 local i
1921                 for ((i=0; i<${#sync[@]}; i++)); do
1922                         if $new_wait; then
1923                                 [ ${sync[$i]} -eq 1 ] && continue
1924                         else
1925                                 [ ${sync[$i]} -eq 0 ] && continue
1926                         fi
1927                         # there is a not finished MDS-OST synchronization
1928                         con=0
1929                         break;
1930                 done
1931                 sleep 2 # increase waiting time and cover statfs cache
1932                 [ ${con} -eq 1 ] && return 0
1933                 echo "Waiting $WAIT secs for $facet mds-ost sync done."
1934                 WAIT=$((WAIT + 2))
1935         done
1936         echo "$facet recovery not done in $MAX sec. $STATUS"
1937         return 1
1938 }
1939
1940 wait_destroy_complete () {
1941         echo "Waiting for local destroys to complete"
1942         # MAX value shouldn't be big as this mean server responsiveness
1943         # never increase this just to make test pass but investigate
1944         # why it takes so long time
1945         local MAX=5
1946         local WAIT=0
1947         while [ $WAIT -lt $MAX ]; do
1948                 local -a RPCs=($($LCTL get_param -n osc.*.destroys_in_flight))
1949                 local con=1
1950                 local i
1951
1952                 for ((i=0; i<${#RPCs[@]}; i++)); do
1953                         [ ${RPCs[$i]} -eq 0 ] && continue
1954                         # there are still some destroy RPCs in flight
1955                         con=0
1956                         break;
1957                 done
1958                 sleep 1
1959                 [ ${con} -eq 1 ] && return 0 # done waiting
1960                 echo "Waiting ${WAIT}s for local destroys to complete"
1961                 WAIT=$((WAIT + 1))
1962         done
1963         echo "Local destroys weren't done in $MAX sec."
1964         return 1
1965 }
1966
1967 wait_delete_completed() {
1968         wait_delete_completed_mds $1 || return $?
1969         wait_destroy_complete
1970 }
1971
1972 wait_exit_ST () {
1973     local facet=$1
1974
1975     local WAIT=0
1976     local INTERVAL=1
1977     local running
1978     # conf-sanity 31 takes a long time cleanup
1979     while [ $WAIT -lt 300 ]; do
1980         running=$(do_facet ${facet} "lsmod | grep lnet > /dev/null && lctl dl | grep ' ST '") || true
1981         [ -z "${running}" ] && return 0
1982         echo "waited $WAIT for${running}"
1983         [ $INTERVAL -lt 64 ] && INTERVAL=$((INTERVAL + INTERVAL))
1984         sleep $INTERVAL
1985         WAIT=$((WAIT + INTERVAL))
1986     done
1987     echo "service didn't stop after $WAIT seconds.  Still running:"
1988     echo ${running}
1989     return 1
1990 }
1991
1992 wait_remote_prog () {
1993    local prog=$1
1994    local WAIT=0
1995    local INTERVAL=5
1996    local rc=0
1997
1998    [ "$PDSH" = "no_dsh" ] && return 0
1999
2000    while [ $WAIT -lt $2 ]; do
2001         running=$(ps uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep) || true
2002         [ -z "${running}" ] && return 0 || true
2003         echo "waited $WAIT for: "
2004         echo "$running"
2005         [ $INTERVAL -lt 60 ] && INTERVAL=$((INTERVAL + INTERVAL))
2006         sleep $INTERVAL
2007         WAIT=$((WAIT + INTERVAL))
2008     done
2009     local pids=$(ps  uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep | awk '{print $2}')
2010     [ -z "$pids" ] && return 0
2011     echo "$PDSH processes still exists after $WAIT seconds.  Still running: $pids"
2012     # FIXME: not portable
2013     for pid in $pids; do
2014         cat /proc/${pid}/status || true
2015         cat /proc/${pid}/wchan || true
2016         echo "Killing $pid"
2017         kill -9 $pid || true
2018         sleep 1
2019         ps -P $pid && rc=1
2020     done
2021
2022     return $rc
2023 }
2024
2025 clients_up() {
2026     # not every config has many clients
2027     sleep 1
2028     if [ ! -z "$CLIENTS" ]; then
2029         $PDSH $CLIENTS "stat -f $MOUNT" > /dev/null
2030     else
2031         stat -f $MOUNT > /dev/null
2032     fi
2033 }
2034
2035 client_up() {
2036     local client=$1
2037     # usually checked on particular client or locally
2038     sleep 1
2039     if [ ! -z "$client" ]; then
2040         $PDSH $client "stat -f $MOUNT" > /dev/null
2041     else
2042         stat -f $MOUNT > /dev/null
2043     fi
2044 }
2045
2046 client_evicted() {
2047     ! client_up $1
2048 }
2049
2050 client_reconnect() {
2051     uname -n >> $MOUNT/recon
2052     if [ -z "$CLIENTS" ]; then
2053         df $MOUNT; uname -n >> $MOUNT/recon
2054     else
2055         do_nodes $CLIENTS "df $MOUNT; uname -n >> $MOUNT/recon" > /dev/null
2056     fi
2057     echo Connected clients:
2058     cat $MOUNT/recon
2059     ls -l $MOUNT/recon > /dev/null
2060     rm $MOUNT/recon
2061 }
2062
2063 affected_facets () {
2064     local facet=$1
2065
2066     local host=$(facet_active_host $facet)
2067     local affected=$facet
2068
2069     if [ "$FAILURE_MODE" = HARD ]; then
2070         affected=$(facets_up_on_host $host)
2071     fi
2072     echo $affected
2073 }
2074
2075 facet_failover() {
2076         local facets=$1
2077         local sleep_time=$2
2078         local -a affecteds
2079         local facet
2080         local total=0
2081         local index=0
2082         local skip
2083
2084         #Because it will only get up facets, we need get affected
2085         #facets before shutdown
2086         #For HARD Failure mode, it needs make sure facets on the same
2087         #HOST will only be shutdown and reboot once
2088         for facet in ${facets//,/ }; do
2089                 local affected_facet
2090                 skip=0
2091                 #check whether facet has been included in other affected facets
2092                 for ((index=0; index<$total; index++)); do
2093                         [[ *,$facet,* == ,${affecteds[index]}, ]] && skip=1
2094                 done
2095
2096                 if [ $skip -eq 0 ]; then
2097                         affecteds[$total]=$(affected_facets $facet)
2098                         total=$((total+1))
2099                 fi
2100         done
2101
2102         for ((index=0; index<$total; index++)); do
2103                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
2104                 local host=$(facet_active_host $facet)
2105                 echo "Failing ${affecteds[index]} on $host"
2106                 shutdown_facet $facet
2107         done
2108
2109         for ((index=0; index<$total; index++)); do
2110                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
2111                 echo reboot facets: ${affecteds[index]}
2112
2113                 reboot_facet $facet
2114
2115                 change_active ${affecteds[index]}
2116
2117                 wait_for_facet ${affecteds[index]}
2118                 # start mgs first if it is affected
2119                 if ! combined_mgs_mds &&
2120                         list_member ${affecteds[index]} mgs; then
2121                         mount_facet mgs || error "Restart of mgs failed"
2122                 fi
2123                 # FIXME; has to be changed to mount all facets concurrently
2124                 affected=$(exclude_items_from_list ${affecteds[index]} mgs)
2125                 echo mount facets: ${affecteds[index]}
2126                 mount_facets ${affecteds[index]}
2127         done
2128 }
2129
2130 obd_name() {
2131     local facet=$1
2132 }
2133
2134 replay_barrier() {
2135         local facet=$1
2136         do_facet $facet "sync; sync; sync"
2137         df $MOUNT
2138
2139         # make sure there will be no seq change
2140         local clients=${CLIENTS:-$HOSTNAME}
2141         local f=fsa-\\\$\(hostname\)
2142         do_nodes $clients "mcreate $MOUNT/$f; rm $MOUNT/$f"
2143         do_nodes $clients "if [ -d $MOUNT2 ]; then mcreate $MOUNT2/$f; rm $MOUNT2/$f; fi"
2144
2145         local svc=${facet}_svc
2146         do_facet $facet $LCTL --device ${!svc} notransno
2147         do_facet $facet $LCTL --device ${!svc} readonly
2148         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
2149         $LCTL mark "local REPLAY BARRIER on ${!svc}"
2150 }
2151
2152 replay_barrier_nodf() {
2153         local facet=$1    echo running=${running}
2154         do_facet $facet "sync; sync; sync"
2155         local svc=${facet}_svc
2156         echo Replay barrier on ${!svc}
2157         do_facet $facet $LCTL --device ${!svc} notransno
2158         do_facet $facet $LCTL --device ${!svc} readonly
2159         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
2160         $LCTL mark "local REPLAY BARRIER on ${!svc}"
2161 }
2162
2163 replay_barrier_nosync() {
2164         local facet=$1    echo running=${running}
2165         local svc=${facet}_svc
2166         echo Replay barrier on ${!svc}
2167         do_facet $facet $LCTL --device ${!svc} notransno
2168         do_facet $facet $LCTL --device ${!svc} readonly
2169         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
2170         $LCTL mark "local REPLAY BARRIER on ${!svc}"
2171 }
2172
2173 mds_evict_client() {
2174     UUID=`lctl get_param -n mdc.${mds1_svc}-mdc-*.uuid`
2175     do_facet mds1 "lctl set_param -n mdt.${mds1_svc}.evict_client $UUID"
2176 }
2177
2178 ost_evict_client() {
2179     UUID=`lctl get_param -n devices| grep ${ost1_svc}-osc- | egrep -v 'MDT' | awk '{print $5}'`
2180     do_facet ost1 "lctl set_param -n obdfilter.${ost1_svc}.evict_client $UUID"
2181 }
2182
2183 fail() {
2184         local facets=$1
2185         local clients=${CLIENTS:-$HOSTNAME}
2186
2187         facet_failover $* || error "failover: $?"
2188         wait_clients_import_state "$clients" "$facets" FULL
2189         clients_up || error "post-failover df: $?"
2190 }
2191
2192 fail_nodf() {
2193         local facet=$1
2194         facet_failover $facet
2195 }
2196
2197 fail_abort() {
2198         local facet=$1
2199         stop $facet
2200         refresh_disk ${facet}
2201         change_active $facet
2202         wait_for_facet $facet
2203         mount_facet $facet -o abort_recovery
2204         clients_up || echo "first df failed: $?"
2205         clients_up || error "post-failover df: $?"
2206 }
2207
2208 do_lmc() {
2209     echo There is no lmc.  This is mountconf, baby.
2210     exit 1
2211 }
2212
2213 host_nids_address() {
2214     local nodes=$1
2215     local kind=$2
2216
2217     if [ -n "$kind" ]; then
2218         nids=$(do_nodes $nodes "$LCTL list_nids | grep $kind | cut -f 1 -d '@'")
2219     else
2220         nids=$(do_nodes $nodes "$LCTL list_nids all | cut -f 1 -d '@'")
2221     fi
2222     echo $nids
2223 }
2224
2225 h2name_or_ip() {
2226     if [ "$1" = "client" -o "$1" = "'*'" ]; then echo \'*\'; else
2227         echo $1"@$2"
2228     fi
2229 }
2230
2231 h2ptl() {
2232    if [ "$1" = "client" -o "$1" = "'*'" ]; then echo \'*\'; else
2233        ID=`xtprocadmin -n $1 2>/dev/null | egrep -v 'NID' | awk '{print $1}'`
2234        if [ -z "$ID" ]; then
2235            echo "Could not get a ptl id for $1..."
2236            exit 1
2237        fi
2238        echo $ID"@ptl"
2239    fi
2240 }
2241 declare -fx h2ptl
2242
2243 h2tcp() {
2244     h2name_or_ip "$1" "tcp"
2245 }
2246 declare -fx h2tcp
2247
2248 h2elan() {
2249     if [ "$1" = "client" -o "$1" = "'*'" ]; then echo \'*\'; else
2250         if type __h2elan >/dev/null 2>&1; then
2251             ID=$(__h2elan $1)
2252         else
2253             ID=`echo $1 | sed 's/[^0-9]*//g'`
2254         fi
2255         echo $ID"@elan"
2256     fi
2257 }
2258 declare -fx h2elan
2259
2260 h2o2ib() {
2261     h2name_or_ip "$1" "o2ib"
2262 }
2263 declare -fx h2o2ib
2264
2265 # This enables variables in cfg/"setup".sh files to support the pdsh HOSTLIST
2266 # expressions format. As a bonus we can then just pass in those variables
2267 # to pdsh. What this function does is take a HOSTLIST type string and
2268 # expand it into a space deliminated list for us.
2269 hostlist_expand() {
2270     local hostlist=$1
2271     local offset=$2
2272     local myList
2273     local item
2274     local list
2275
2276     [ -z "$hostlist" ] && return
2277
2278     # Translate the case of [..],..,[..] to [..] .. [..]
2279     list="${hostlist/],/] }"
2280     front=${list%%[*}
2281     [[ "$front" == *,* ]] && {
2282         new="${list%,*} "
2283         old="${list%,*},"
2284         list=${list/${old}/${new}}
2285     }
2286
2287     for item in $list; do
2288         # Test if we have any []'s at all
2289         if [ "$item" != "${item/\[/}" ]; then {
2290             # Expand the [*] into list
2291             name=${item%%[*}
2292             back=${item#*]}
2293
2294             if [ "$name" != "$item" ]; then
2295                 group=${item#$name[*}
2296                 group=${group%%]*}
2297
2298                 for range in ${group//,/ }; do
2299                     begin=${range%-*}
2300                     end=${range#*-}
2301
2302                     # Number of leading zeros
2303                     padlen=${#begin}
2304                     padlen2=${#end}
2305                     end=$(echo $end | sed 's/0*//')
2306                     [[ -z "$end" ]] && end=0
2307                     [[ $padlen2 -gt $padlen ]] && {
2308                         [[ $padlen2 -eq ${#end} ]] && padlen2=0
2309                         padlen=$padlen2
2310                     }
2311                     begin=$(echo $begin | sed 's/0*//')
2312                     [ -z $begin ] && begin=0
2313
2314                     for num in $(seq -f "%0${padlen}g" $begin $end); do
2315                         value="${name#*,}${num}${back}"
2316                         [ "$value" != "${value/\[/}" ] && {
2317                             value=$(hostlist_expand "$value")
2318                         }
2319                         myList="$myList $value"
2320                     done
2321                 done
2322             fi
2323         } else {
2324             myList="$myList $item"
2325         } fi
2326     done
2327     myList=${myList//,/ }
2328     myList=${myList:1} # Remove first character which is a space
2329
2330     # Filter any duplicates without sorting
2331     list="$myList "
2332     myList="${list%% *}"
2333
2334     while [[ "$list" != ${myList##* } ]]; do
2335         list=${list//${list%% *} /}
2336         myList="$myList ${list%% *}"
2337     done
2338     myList="${myList%* }";
2339
2340     # We can select an object at a offset in the list
2341     [ $# -eq 2 ] && {
2342         cnt=0
2343         for item in $myList; do
2344             let cnt=cnt+1
2345             [ $cnt -eq $offset ] && {
2346                 myList=$item
2347             }
2348         done
2349         [ $(get_node_count $myList) -ne 1 ] && myList=""
2350     }
2351     echo $myList
2352 }
2353
2354 facet_host() {
2355         local facet=$1
2356         local varname
2357
2358         [ "$facet" == client ] && echo -n $HOSTNAME && return
2359         varname=${facet}_HOST
2360         if [ -z "${!varname}" ]; then
2361                 if [ "${facet:0:3}" == "ost" ]; then
2362                         eval export ${facet}_HOST=${ost_HOST}
2363                 elif [ "${facet:0:3}" == "mdt" -o \
2364                         "${facet:0:3}" == "mds" -o \
2365                         "${facet:0:3}" == "mgs" ]; then
2366                         eval export ${facet}_HOST=${mds_HOST}
2367                 fi
2368         fi
2369         echo -n ${!varname}
2370 }
2371
2372 facet_failover_host() {
2373         local facet=$1
2374         local varname
2375
2376         var=${facet}failover_HOST
2377         if [ -n "${!var}" ]; then
2378                 echo ${!var}
2379                 return
2380         fi
2381
2382         if [ "${facet:0:3}" == "mdt" -o "${facet:0:3}" == "mds" -o \
2383              "${facet:0:3}" == "mgs" ]; then
2384
2385                 eval export ${facet}failover_host=${mds_HOST}
2386                 echo ${mds_HOST}
2387                 return
2388         fi
2389
2390         if [[ $facet == ost* ]]; then
2391                 eval export ${facet}failover_host=${ost_HOST}
2392                 echo ${ost_HOST}
2393                 return
2394         fi
2395 }
2396
2397 facet_active() {
2398     local facet=$1
2399     local activevar=${facet}active
2400
2401     if [ -f $TMP/${facet}active ] ; then
2402         source $TMP/${facet}active
2403     fi
2404
2405     active=${!activevar}
2406     if [ -z "$active" ] ; then
2407         echo -n ${facet}
2408     else
2409         echo -n ${active}
2410     fi
2411 }
2412
2413 facet_active_host() {
2414     local facet=$1
2415     local active=`facet_active $facet`
2416     if [ "$facet" == client ]; then
2417         echo $HOSTNAME
2418     else
2419         echo `facet_host $active`
2420     fi
2421 }
2422
2423 change_active() {
2424     local facetlist=$1
2425     local facet
2426
2427     facetlist=$(exclude_items_from_list $facetlist mgs)
2428
2429     for facet in ${facetlist//,/ }; do
2430     local failover=${facet}failover
2431     local host=`facet_host $failover`
2432     [ -z "$host" ] && return
2433
2434     local curactive=`facet_active $facet`
2435     if [ -z "${curactive}" -o "$curactive" == "$failover" ] ; then
2436         eval export ${facet}active=$facet
2437     else
2438         eval export ${facet}active=$failover
2439     fi
2440     # save the active host for this facet
2441     local activevar=${facet}active
2442     echo "$activevar=${!activevar}" > $TMP/$activevar
2443     [[ $facet = mds1 ]] && combined_mgs_mds && \
2444         echo "mgsactive=${!activevar}" > $TMP/mgsactive
2445     local TO=`facet_active_host $facet`
2446     echo "Failover $facet to $TO"
2447     done
2448 }
2449
2450 do_node() {
2451     local verbose=false
2452     # do not stripe off hostname if verbose, bug 19215
2453     if [ x$1 = x--verbose ]; then
2454         shift
2455         verbose=true
2456     fi
2457
2458     local HOST=$1
2459     shift
2460     local myPDSH=$PDSH
2461     if [ "$HOST" = "$HOSTNAME" ]; then
2462         myPDSH="no_dsh"
2463     elif [ -z "$myPDSH" -o "$myPDSH" = "no_dsh" ]; then
2464         echo "cannot run remote command on $HOST with $myPDSH"
2465         return 128
2466     fi
2467     if $VERBOSE; then
2468         echo "CMD: $HOST $@" >&2
2469         $myPDSH $HOST "$LCTL mark \"$@\"" > /dev/null 2>&1 || :
2470     fi
2471
2472     if [ "$myPDSH" = "rsh" ]; then
2473 # we need this because rsh does not return exit code of an executed command
2474         local command_status="$TMP/cs"
2475         rsh $HOST ":> $command_status"
2476         rsh $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin;
2477                     cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\") ||
2478                     echo command failed >$command_status"
2479         [ -n "$($myPDSH $HOST cat $command_status)" ] && return 1 || true
2480         return 0
2481     fi
2482
2483     if $verbose ; then
2484         # print HOSTNAME for myPDSH="no_dsh"
2485         if [[ $myPDSH = no_dsh ]]; then
2486             $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")" | sed -e "s/^/${HOSTNAME}: /"
2487         else
2488             $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")"
2489         fi
2490     else
2491         $myPDSH $HOST "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" sh -c \"$@\")" | sed "s/^${HOST}: //"
2492     fi
2493     return ${PIPESTATUS[0]}
2494 }
2495
2496 do_nodev() {
2497     do_node --verbose "$@"
2498 }
2499
2500 single_local_node () {
2501    [ "$1" = "$HOSTNAME" ]
2502 }
2503
2504 # Outputs environment variable assignments that should be passed to remote nodes
2505 get_env_vars() {
2506         local var
2507         local value
2508         local facets=$(get_facets)
2509         local facet
2510
2511         for var in ${!MODOPTS_*}; do
2512                 value=${!var}
2513                 echo -n " ${var}=\"$value\""
2514         done
2515
2516         for facet in ${facets//,/ }; do
2517                 var=${facet}_FSTYPE
2518                 if [ -n "${!var}" ]; then
2519                         echo -n " $var=${!var}"
2520                 fi
2521         done
2522
2523         for var in MGSFSTYPE MDSFSTYPE OSTFSTYPE; do
2524                 if [ -n "${!var}" ]; then
2525                         echo -n " $var=${!var}"
2526                 fi
2527         done
2528
2529         if [ -n "$FSTYPE" ]; then
2530                 echo -n " FSTYPE=$FSTYPE"
2531         fi
2532 }
2533
2534 do_nodes() {
2535     local verbose=false
2536     # do not stripe off hostname if verbose, bug 19215
2537     if [ x$1 = x--verbose ]; then
2538         shift
2539         verbose=true
2540     fi
2541
2542     local rnodes=$1
2543     shift
2544
2545     if single_local_node $rnodes; then
2546         if $verbose; then
2547            do_nodev $rnodes "$@"
2548         else
2549            do_node $rnodes "$@"
2550         fi
2551         return $?
2552     fi
2553
2554     # This is part from do_node
2555     local myPDSH=$PDSH
2556
2557     [ -z "$myPDSH" -o "$myPDSH" = "no_dsh" -o "$myPDSH" = "rsh" ] && \
2558         echo "cannot run remote command on $rnodes with $myPDSH" && return 128
2559
2560     export FANOUT=$(get_node_count "${rnodes//,/ }")
2561     if $VERBOSE; then
2562         echo "CMD: $rnodes $@" >&2
2563         $myPDSH $rnodes "$LCTL mark \"$@\"" > /dev/null 2>&1 || :
2564     fi
2565
2566     # do not replace anything from pdsh output if -N is used
2567     # -N     Disable hostname: prefix on lines of output.
2568     if $verbose || [[ $myPDSH = *-N* ]]; then
2569         $myPDSH $rnodes "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" $(get_env_vars) sh -c \"$@\")"
2570     else
2571         $myPDSH $rnodes "(PATH=\$PATH:$RLUSTRE/utils:$RLUSTRE/tests:/sbin:/usr/sbin; cd $RPWD; LUSTRE=\"$RLUSTRE\" $(get_env_vars) sh -c \"$@\")" | sed -re "s/^[^:]*: //g"
2572     fi
2573     return ${PIPESTATUS[0]}
2574 }
2575
2576 do_facet() {
2577     local facet=$1
2578     shift
2579     local HOST=`facet_active_host $facet`
2580     [ -z $HOST ] && echo No host defined for facet ${facet} && exit 1
2581     do_node $HOST "$@"
2582 }
2583
2584 # Function: do_facet_random_file $FACET $FILE $SIZE
2585 # Creates FILE with random content on the given FACET of given SIZE
2586
2587 do_facet_random_file() {
2588         local facet="$1"
2589         local fpath="$2"
2590         local fsize="$3"
2591         local cmd="dd if=/dev/urandom of='$fpath' bs=$fsize count=1"
2592         do_facet $facet "$cmd 2>/dev/null"
2593 }
2594
2595 do_facet_create_file() {
2596         local facet="$1"
2597         local fpath="$2"
2598         local fsize="$3"
2599         local cmd="dd if=/dev/zero of='$fpath' bs=$fsize count=1"
2600         do_facet $facet "$cmd 2>/dev/null"
2601 }
2602
2603 do_nodesv() {
2604     do_nodes --verbose "$@"
2605 }
2606
2607 add() {
2608     local facet=$1
2609     shift
2610     # make sure its not already running
2611     stop ${facet} -f
2612     rm -f $TMP/${facet}active
2613     [[ $facet = mds1 ]] && combined_mgs_mds && rm -f $TMP/mgsactive
2614     do_facet ${facet} $MKFS $*
2615 }
2616
2617 ostdevname() {
2618     num=$1
2619     DEVNAME=OSTDEV$num
2620
2621         local fstype=$(facet_fstype ost$num)
2622
2623         case $fstype in
2624                 ldiskfs )
2625                         #if $OSTDEVn isn't defined, default is $OSTDEVBASE + num
2626                         eval DEVPTR=${!DEVNAME:=${OSTDEVBASE}${num}};;
2627                 zfs )
2628                         #dataset name is independent of vdev device names
2629                         eval DEVPTR=${FSNAME}-ost${num}/ost${num};;
2630                 * )
2631                         error "unknown fstype!";;
2632         esac
2633
2634     echo -n $DEVPTR
2635 }
2636
2637 ostvdevname() {
2638         num=$1
2639         DEVNAME=OSTDEV$num
2640
2641         local fstype=$(facet_fstype ost$num)
2642
2643         case $fstype in
2644                 ldiskfs )
2645                         # vdevs are not supported by ldiskfs
2646                         eval VDEVPTR="";;
2647                 zfs )
2648                         #if $OSTDEVn isn't defined, default is $OSTDEVBASE + num
2649                         eval VDEVPTR=${!DEVNAME:=${OSTDEVBASE}${num}};;
2650                 * )
2651                         error "unknown fstype!";;
2652         esac
2653
2654         echo -n $VDEVPTR
2655 }
2656
2657 mdsdevname() {
2658     num=$1
2659     DEVNAME=MDSDEV$num
2660
2661         local fstype=$(facet_fstype mds$num)
2662
2663         case $fstype in
2664                 ldiskfs )
2665                         #if $MDSDEVn isn't defined, default is $MDSDEVBASE + num
2666                         eval DEVPTR=${!DEVNAME:=${MDSDEVBASE}${num}};;
2667                 zfs )
2668                         #dataset name is independent of vdev device names
2669                         eval DEVPTR=${FSNAME}-mdt${num}/mdt${num};;
2670                 * )
2671                         error "unknown fstype!";;
2672         esac
2673
2674         echo -n $DEVPTR
2675 }
2676
2677 mdsvdevname() {
2678         num=$1
2679         DEVNAME=MDSDEV$num
2680
2681         local fstype=$(facet_fstype mds$num)
2682
2683         case $fstype in
2684                 ldiskfs )
2685                         # vdevs are not supported by ldiskfs
2686                         eval VDEVPTR="";;
2687                 zfs )
2688                         #if $MDSDEVn isn't defined, default is $MDSDEVBASE + num
2689                         eval VDEVPTR=${!DEVNAME:=${MDSDEVBASE}${num}};;
2690                 * )
2691                         error "unknown fstype!";;
2692         esac
2693
2694         echo -n $VDEVPTR
2695 }
2696
2697 mgsdevname() {
2698         local DEVPTR
2699         local fstype=$(facet_fstype mgs)
2700
2701         case $fstype in
2702         ldiskfs )
2703                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
2704                    ( [ -z "$MGSDEV" ] || [ $MGSDEV = $(mdsdevname 1) ] ); then
2705                         DEVPTR=$(mdsdevname 1)
2706                 else
2707                         DEVPTR=$MGSDEV
2708                 fi;;
2709         zfs )
2710                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
2711                    ( [ -z "$MGSDEV" ] || [ $MGSDEV = $(mdsvdevname 1) ] ); then
2712                         DEVPTR=$(mdsdevname 1)
2713                 else
2714                         DEVPTR=${FSNAME}-mgs/mgs
2715                 fi;;
2716         * )
2717                 error "unknown fstype!";;
2718         esac
2719
2720         echo -n $DEVPTR
2721 }
2722
2723 mgsvdevname() {
2724         local VDEVPTR
2725         DEVNAME=MGSDEV
2726
2727         local fstype=$(facet_fstype mgs)
2728
2729         case $fstype in
2730         ldiskfs )
2731                 # vdevs are not supported by ldiskfs
2732                 ;;
2733         zfs )
2734                 if [ $(facet_host mgs) = $(facet_host mds1) ] &&
2735                    ( [ -z "$MGSDEV" ] || [ $MGSDEV = $(mdsvdevname 1) ] ); then
2736                         VDEVPTR=$(mdsvdevname 1)
2737                 else
2738                         VDEVPTR=$MGSDEV
2739                 fi;;
2740         * )
2741                 error "unknown fstype!";;
2742         esac
2743
2744         echo -n $VDEVPTR
2745 }
2746
2747 facet_mntpt () {
2748     local facet=$1
2749     [[ $facet = mgs ]] && combined_mgs_mds && facet="mds1"
2750
2751     local var=${facet}_MOUNT
2752     eval mntpt=${!var:-${MOUNT%/*}/$facet}
2753
2754     echo -n $mntpt
2755 }
2756
2757 ########
2758 ## MountConf setup
2759
2760 stopall() {
2761     # make sure we are using the primary server, so test-framework will
2762     # be able to clean up properly.
2763     activemds=`facet_active mds1`
2764     if [ $activemds != "mds1" ]; then
2765         fail mds1
2766     fi
2767
2768     local clients=$CLIENTS
2769     [ -z $clients ] && clients=$(hostname)
2770
2771     zconf_umount_clients $clients $MOUNT "$*" || true
2772     [ -n "$MOUNT2" ] && zconf_umount_clients $clients $MOUNT2 "$*" || true
2773
2774     [ "$CLIENTONLY" ] && return
2775     # The add fn does rm ${facet}active file, this would be enough
2776     # if we use do_facet <facet> only after the facet added, but
2777     # currently we use do_facet mds in local.sh
2778     for num in `seq $MDSCOUNT`; do
2779         stop mds$num -f
2780         rm -f ${TMP}/mds${num}active
2781     done
2782     combined_mgs_mds && rm -f $TMP/mgsactive
2783
2784     for num in `seq $OSTCOUNT`; do
2785         stop ost$num -f
2786         rm -f $TMP/ost${num}active
2787     done
2788
2789     if ! combined_mgs_mds ; then
2790         stop mgs
2791     fi
2792
2793     return 0
2794 }
2795
2796 cleanup_echo_devs () {
2797     local devs=$($LCTL dl | grep echo | awk '{print $4}')
2798
2799     for dev in $devs; do
2800         $LCTL --device $dev cleanup
2801         $LCTL --device $dev detach
2802     done
2803 }
2804
2805 cleanupall() {
2806     nfs_client_mode && return
2807
2808     stopall $*
2809     cleanup_echo_devs
2810
2811     unload_modules
2812     cleanup_gss
2813 }
2814
2815 combined_mgs_mds () {
2816         [[ "$(mdsdevname 1)" = "$(mgsdevname)" ]] &&
2817                 [[ "$(facet_host mds1)" = "$(facet_host mgs)" ]]
2818 }
2819
2820 lower() {
2821         echo -n "$1" | tr '[:upper:]' '[:lower:]'
2822 }
2823
2824 upper() {
2825         echo -n "$1" | tr '[:lower:]' '[:upper:]'
2826 }
2827
2828 mkfs_opts() {
2829         local facet=$1
2830         local dev=$2
2831         local fsname=${3:-"$FSNAME"}
2832         local type=$(facet_type $facet)
2833         local index=$(($(facet_number $facet) - 1))
2834         local fstype=$(facet_fstype $facet)
2835         local host=$(facet_host $facet)
2836         local opts
2837         local fs_mkfs_opts
2838         local var
2839
2840         if [ $type == MGS ] && combined_mgs_mds; then
2841                 return 1
2842         fi
2843
2844         if [ $type == MGS ] || ( [ $type == MDS ] &&
2845                                  [ "$dev" == $(mgsdevname) ] &&
2846                                  [ "$host" == "$(facet_host mgs)" ] ); then
2847                 opts="--mgs"
2848         else
2849                 opts="--mgsnode=$MGSNID"
2850         fi
2851
2852         if [ $type != MGS ]; then
2853                 opts+=" --fsname=$fsname --$(lower ${type/MDS/MDT}) \
2854                         --index=$index"
2855         fi
2856
2857         var=${facet}failover_HOST
2858         if [ -n "${!var}" ] && [ ${!var} != $(facet_host $facet) ]; then
2859                 opts+=" --failnode=$(h2$NETTYPE ${!var})"
2860         fi
2861
2862         opts+=${TIMEOUT:+" --param=sys.timeout=$TIMEOUT"}
2863         opts+=${LDLM_TIMEOUT:+" --param=sys.ldlm_timeout=$LDLM_TIMEOUT"}
2864
2865         if [ $type == MDS ]; then
2866                 opts+=${SECLEVEL:+" --param=mdt.sec_level"}
2867                 opts+=${MDSCAPA:+" --param-mdt.capa=$MDSCAPA"}
2868                 opts+=${STRIPE_BYTES:+" --param=lov.stripesize=$STRIPE_BYTES"}
2869                 opts+=${STRIPES_PER_OBJ:+" --param=lov.stripecount=$STRIPES_PER_OBJ"}
2870                 opts+=${L_GETIDENTITY:+" --param=mdt.identity_upcall=$L_GETIDENTITY"}
2871
2872                 if [ $fstype == ldiskfs ]; then
2873                         fs_mkfs_opts+=${MDSJOURNALSIZE:+" -J size=$MDSJOURNALSIZE"}
2874                         fs_mkfs_opts+=${MDSISIZE:+" -i $MDSISIZE"}
2875                 fi
2876         fi
2877
2878         if [ $type == OST ]; then
2879                 opts+=${SECLEVEL:+" --param=ost.sec_level"}
2880                 opts+=${OSSCAPA:+" --param=ost.capa=$OSSCAPA"}
2881
2882                 if [ $fstype == ldiskfs ]; then
2883                         fs_mkfs_opts+=${OSTJOURNALSIZE:+" -J size=$OSTJOURNALSIZE"}
2884                 fi
2885         fi
2886
2887         opts+=" --backfstype=$fstype"
2888
2889         var=${type}SIZE
2890         if [ -n "${!var}" ]; then
2891                 opts+=" --device-size=${!var}"
2892         fi
2893
2894         var=$(upper $fstype)_MKFS_OPTS
2895         fs_mkfs_opts+=${!var:+" ${!var}"}
2896
2897         var=${type}_FS_MKFS_OPTS
2898         fs_mkfs_opts+=${!var:+" ${!var}"}
2899
2900         if [ -n "${fs_mkfs_opts## }" ]; then
2901                 opts+=" --mkfsoptions=\\\"${fs_mkfs_opts## }\\\""
2902         fi
2903
2904         var=${type}OPT
2905         opts+=${!var:+" ${!var}"}
2906
2907         echo -n "$opts"
2908 }
2909
2910 formatall() {
2911         local quiet
2912
2913         if ! $VERBOSE; then
2914                 quiet=yes
2915         fi
2916
2917         stopall
2918         # We need ldiskfs here, may as well load them all
2919         load_modules
2920         [ "$CLIENTONLY" ] && return
2921         echo Formatting mgs, mds, osts
2922         if ! combined_mgs_mds ; then
2923                 echo "Format mgs: $(mgsdevname)"
2924                 add mgs $(mkfs_opts mgs $(mgsdevname)) --reformat \
2925                         $(mgsdevname) $(mgsvdevname) ${quiet:+>/dev/null} ||
2926                         exit 10
2927         fi
2928
2929         for num in $(seq $MDSCOUNT); do
2930                 echo "Format mds$num: $(mdsdevname $num)"
2931                 add mds$num $(mkfs_opts mds$num $(mdsdevname ${num})) \
2932                         --reformat $(mdsdevname $num) $(mdsvdevname $num) \
2933                         ${quiet:+>/dev/null} || exit 10
2934         done
2935
2936         for num in $(seq $OSTCOUNT); do
2937                 echo "Format ost$num: $(ostdevname $num)"
2938                 add ost$num $(mkfs_opts ost$num $(ostdevname ${num})) \
2939                         --reformat $(ostdevname $num) $(ostvdevname ${num}) \
2940                         ${quiet:+>/dev/null} || exit 10
2941         done
2942 }
2943
2944 mount_client() {
2945     grep " $1 " /proc/mounts || zconf_mount $HOSTNAME $*
2946 }
2947
2948 umount_client() {
2949     grep " $1 " /proc/mounts && zconf_umount `hostname` $*
2950 }
2951
2952 # return value:
2953 # 0: success, the old identity set already.
2954 # 1: success, the old identity does not set.
2955 # 2: fail.
2956 switch_identity() {
2957     local num=$1
2958     local switch=$2
2959     local j=`expr $num - 1`
2960     local MDT="`(do_facet mds$num lctl get_param -N mdt.*MDT*$j 2>/dev/null | cut -d"." -f2 2>/dev/null) || true`"
2961
2962     if [ -z "$MDT" ]; then
2963         return 2
2964     fi
2965
2966     local old="`do_facet mds$num "lctl get_param -n mdt.$MDT.identity_upcall"`"
2967
2968     if $switch; then
2969         do_facet mds$num "lctl set_param -n mdt.$MDT.identity_upcall \"$L_GETIDENTITY\""
2970     else
2971         do_facet mds$num "lctl set_param -n mdt.$MDT.identity_upcall \"NONE\""
2972     fi
2973
2974     do_facet mds$num "lctl set_param -n mdt/$MDT/identity_flush=-1"
2975
2976     if [ $old = "NONE" ]; then
2977         return 1
2978     else
2979         return 0
2980     fi
2981 }
2982
2983 remount_client()
2984 {
2985         zconf_umount `hostname` $1 || error "umount failed"
2986         zconf_mount `hostname` $1 || error "mount failed"
2987 }
2988
2989 writeconf_facet() {
2990         local facet=$1
2991         local dev=$2
2992
2993         stop ${facet} -f
2994         rm -f ${facet}active
2995         do_facet ${facet} "$TUNEFS --quiet --writeconf $dev" || return 1
2996         return 0
2997 }
2998
2999 writeconf_all () {
3000         local mdt_count=${1:-$MDSCOUNT}
3001         local ost_count=${2:-$OSTCOUNT}
3002         local rc=0
3003
3004         for num in $(seq $mdt_count); do
3005                 DEVNAME=$(mdsdevname $num)
3006                 writeconf_facet mds$num $DEVNAME || rc=$?
3007         done
3008
3009         for num in $(seq $ost_count); do
3010                 DEVNAME=$(ostdevname $num)
3011                 writeconf_facet ost$num $DEVNAME || rc=$?
3012         done
3013         return $rc
3014 }
3015
3016 setupall() {
3017     nfs_client_mode && return
3018
3019     sanity_mount_check ||
3020         error "environments are insane!"
3021
3022     load_modules
3023
3024     if [ -z "$CLIENTONLY" ]; then
3025         echo Setup mgs, mdt, osts
3026         echo $WRITECONF | grep -q "writeconf" && \
3027             writeconf_all
3028         if ! combined_mgs_mds ; then
3029                         start mgs $(mgsdevname) $MGS_MOUNT_OPTS
3030         fi
3031
3032         for num in `seq $MDSCOUNT`; do
3033             DEVNAME=$(mdsdevname $num)
3034             start mds$num $DEVNAME $MDS_MOUNT_OPTS
3035
3036             # We started mds, now we should set failover variables properly.
3037             # Set mds${num}failover_HOST if it is not set (the default failnode).
3038             local varname=mds${num}failover_HOST
3039             if [ -z "${!varname}" ]; then
3040                 eval mds${num}failover_HOST=$(facet_host mds$num)
3041             fi
3042
3043             if [ $IDENTITY_UPCALL != "default" ]; then
3044                 switch_identity $num $IDENTITY_UPCALL
3045             fi
3046         done
3047         for num in `seq $OSTCOUNT`; do
3048             DEVNAME=$(ostdevname $num)
3049             start ost$num $DEVNAME $OST_MOUNT_OPTS
3050
3051             # We started ost$num, now we should set ost${num}failover variable properly.
3052             # Set ost${num}failover_HOST if it is not set (the default failnode).
3053             varname=ost${num}failover_HOST
3054             if [ -z "${!varname}" ]; then
3055                 eval ost${num}failover_HOST=$(facet_host ost${num})
3056             fi
3057
3058         done
3059     fi
3060
3061     init_gss
3062
3063     # wait a while to allow sptlrpc configuration be propogated to targets,
3064     # only needed when mounting new target devices.
3065     if $GSS; then
3066         sleep 10
3067     fi
3068
3069     [ "$DAEMONFILE" ] && $LCTL debug_daemon start $DAEMONFILE $DAEMONSIZE
3070     mount_client $MOUNT
3071     [ -n "$CLIENTS" ] && zconf_mount_clients $CLIENTS $MOUNT
3072     clients_up
3073
3074     if [ "$MOUNT_2" ]; then
3075         mount_client $MOUNT2
3076         [ -n "$CLIENTS" ] && zconf_mount_clients $CLIENTS $MOUNT2
3077     fi
3078
3079     init_param_vars
3080
3081     # by remounting mdt before ost, initial connect from mdt to ost might
3082     # timeout because ost is not ready yet. wait some time to its fully
3083     # recovery. initial obd_connect timeout is 5s; in GSS case it's preceeded
3084     # by a context negotiation rpc with $TIMEOUT.
3085     # FIXME better by monitoring import status.
3086     if $GSS; then
3087         set_flavor_all $SEC
3088         sleep $((TIMEOUT + 5))
3089     else
3090         sleep 5
3091     fi
3092 }
3093
3094 mounted_lustre_filesystems() {
3095         awk '($3 ~ "lustre" && $1 ~ ":") { print $2 }' /proc/mounts
3096 }
3097
3098 init_facet_vars () {
3099         [ "$CLIENTONLY" ] && return 0
3100         local facet=$1
3101         shift
3102         local device=$1
3103
3104         shift
3105
3106         eval export ${facet}_dev=${device}
3107         eval export ${facet}_opt=\"$@\"
3108
3109         local dev=${facet}_dev
3110
3111         # We need to loop for the label
3112         # in case its not initialized yet.
3113         for wait_time in {0,1,3,5,10}; do
3114
3115                 if [ $wait_time -gt 0 ]; then
3116                         echo "${!dev} not yet initialized,"\
3117                                 "waiting ${wait_time} seconds."
3118                         sleep $wait_time
3119                 fi
3120
3121                 local label=$(devicelabel ${facet} ${!dev})
3122
3123                 # Check to make sure the label does
3124                 # not include ffff at the end of the label.
3125                 # This indicates it has not been initialized yet.
3126
3127                 if [[ $label =~ [f|F]{4}$ ]]; then
3128                         # label is not initialized, unset the result
3129                         # and either try again or fail
3130                         unset label
3131                 else
3132                         break
3133                 fi
3134         done
3135
3136         [ -z "$label" ] && echo no label for ${!dev} && exit 1
3137
3138         eval export ${facet}_svc=${label}
3139
3140         local varname=${facet}failover_HOST
3141         if [ -z "${!varname}" ]; then
3142                 eval export $varname=$(facet_host $facet)
3143         fi
3144
3145         varname=${facet}_HOST
3146         if [ -z "${!varname}" ]; then
3147                 eval export $varname=$(facet_host $facet)
3148         fi
3149
3150         # ${facet}failover_dev is set in cfg file
3151         varname=${facet}failover_dev
3152         if [ -n "${!varname}" ] ; then
3153                 eval export ${facet}failover_dev=${!varname}
3154         else
3155                 eval export ${facet}failover_dev=$device
3156         fi
3157
3158         # get mount point of already mounted device
3159         # is facet_dev is already mounted then use the real
3160         #  mount point of this facet; otherwise use $(facet_mntpt $facet)
3161         # i.e. ${facet}_MOUNT if specified by user or default
3162         local mntpt=$(do_facet ${facet} cat /proc/mounts | \
3163                         awk '"'${!dev}'" == $1 && $3 == "lustre" { print $2 }')
3164         if [ -z $mntpt ]; then
3165                 mntpt=$(facet_mntpt $facet)
3166         fi
3167         eval export ${facet}_MOUNT=$mntpt
3168 }
3169
3170 init_facets_vars () {
3171         local DEVNAME
3172
3173         if ! remote_mds_nodsh; then
3174                 for num in $(seq $MDSCOUNT); do
3175                         DEVNAME=`mdsdevname $num`
3176                         init_facet_vars mds$num $DEVNAME $MDS_MOUNT_OPTS
3177                 done
3178         fi
3179
3180         combined_mgs_mds || init_facet_vars mgs $(mgsdevname) $MGS_MOUNT_OPTS
3181
3182         if ! remote_ost_nodsh; then
3183                 for num in $(seq $OSTCOUNT); do
3184                         DEVNAME=$(ostdevname $num)
3185                         init_facet_vars ost$num $DEVNAME $OST_MOUNT_OPTS
3186                 done
3187         fi
3188 }
3189
3190 osc_ensure_active () {
3191     local facet=$1
3192     local timeout=$2
3193     local period=0
3194
3195     while [ $period -lt $timeout ]; do
3196         count=$(do_facet $facet "lctl dl | grep ' IN osc ' 2>/dev/null | wc -l")
3197         if [ $count -eq 0 ]; then
3198             break
3199         fi
3200
3201         echo "There are $count OST are inactive, wait $period seconds, and try again"
3202         sleep 3
3203         period=$((period+3))
3204     done
3205
3206     [ $period -lt $timeout ] || log "$count OST are inactive after $timeout seconds, give up"
3207 }
3208
3209 set_conf_param_and_check() {
3210         local myfacet=$1
3211         local TEST=$2
3212         local PARAM=$3
3213         local ORIG=$(do_facet $myfacet "$TEST")
3214         if [ $# -gt 3 ]; then
3215                 local FINAL=$4
3216         else
3217                 local -i FINAL
3218                 FINAL=$((ORIG + 5))
3219         fi
3220         echo "Setting $PARAM from $ORIG to $FINAL"
3221         do_facet mgs "$LCTL conf_param $PARAM='$FINAL'" ||
3222                 error "conf_param $PARAM failed"
3223
3224         wait_update $(facet_host $myfacet) "$TEST" "$FINAL" ||
3225                 error "check $PARAM failed!"
3226 }
3227
3228 init_param_vars () {
3229         remote_mds_nodsh ||
3230                 TIMEOUT=$(do_facet $SINGLEMDS "lctl get_param -n timeout")
3231
3232         log "Using TIMEOUT=$TIMEOUT"
3233
3234         osc_ensure_active $SINGLEMDS $TIMEOUT
3235         osc_ensure_active client $TIMEOUT
3236
3237         local jobid_var
3238         if [ -z "$(lctl get_param -n mdc.*.connect_flags | grep jobstats)" ]; then
3239                 jobid_var="none"
3240         elif [ $JOBSTATS_AUTO -ne 0 ]; then
3241                 echo "enable jobstats, set job scheduler as $JOBID_VAR"
3242                 jobid_var=$JOBID_VAR
3243         else
3244                 jobid_var=`$LCTL get_param -n jobid_var`
3245                 if [ $jobid_var != "disable" ]; then
3246                         echo "disable jobstats as required"
3247                         jobid_var="disable"
3248                 else
3249                         jobid_var="none"
3250                 fi
3251         fi
3252
3253         if [ $jobid_var == $JOBID_VAR -o $jobid_var == "disable" ]; then
3254                 do_facet mgs $LCTL conf_param $FSNAME.sys.jobid_var=$jobid_var
3255                 wait_update $HOSTNAME "$LCTL get_param -n jobid_var" \
3256                         $jobid_var || return 1
3257         fi
3258
3259         if [ $QUOTA_AUTO -ne 0 ]; then
3260                 if [ "$ENABLE_QUOTA" ]; then
3261                         echo "enable quota as required"
3262                         setup_quota $MOUNT || return 2
3263                 else
3264                         echo "disable quota as required"
3265                         # $LFS quotaoff -ug $MOUNT > /dev/null 2>&1
3266                 fi
3267         fi
3268         return 0
3269 }
3270
3271 nfs_client_mode () {
3272     if [ "$NFSCLIENT" ]; then
3273         echo "NFSCLIENT mode: setup, cleanup, check config skipped"
3274         local clients=$CLIENTS
3275         [ -z $clients ] && clients=$(hostname)
3276
3277         # FIXME: remove hostname when 19215 fixed
3278         do_nodes $clients "echo \\\$(hostname); grep ' '$MOUNT' ' /proc/mounts"
3279         declare -a nfsexport=(`grep ' '$MOUNT' ' /proc/mounts | awk '{print $1}' | awk -F: '{print $1 " "  $2}'`)
3280         if [[ ${#nfsexport[@]} -eq 0 ]]; then
3281                 error_exit NFSCLIENT=$NFSCLIENT mode, but no NFS export found!
3282         fi
3283         do_nodes ${nfsexport[0]} "echo \\\$(hostname); df -T  ${nfsexport[1]}"
3284         return
3285     fi
3286     return 1
3287 }
3288
3289 check_config_client () {
3290     local mntpt=$1
3291
3292     local mounted=$(mount | grep " $mntpt ")
3293     if [ "$CLIENTONLY" ]; then
3294         # bug 18021
3295         # CLIENTONLY should not depend on *_HOST settings
3296         local mgc=$($LCTL device_list | awk '/MGC/ {print $4}')
3297         # in theory someone could create a new,
3298         # client-only config file that assumed lustre was already
3299         # configured and didn't set the MGSNID. If MGSNID is not set,
3300         # then we should use the mgs nid currently being used 
3301         # as the default value. bug 18021
3302         [[ x$MGSNID = x ]] &&
3303             MGSNID=${mgc//MGC/}
3304
3305         if [[ x$mgc != xMGC$MGSNID ]]; then
3306             if [ "$mgs_HOST" ]; then
3307                 local mgc_ip=$(ping -q -c1 -w1 $mgs_HOST | grep PING | awk '{print $3}' | sed -e "s/(//g" -e "s/)//g")
3308 #                [[ x$mgc = xMGC$mgc_ip@$NETTYPE ]] ||
3309 #                    error_exit "MGSNID=$MGSNID, mounted: $mounted, MGC : $mgc"
3310             fi
3311         fi
3312         return 0
3313     fi
3314
3315     local myMGS_host=$mgs_HOST   
3316     if [ "$NETTYPE" = "ptl" ]; then
3317         myMGS_host=$(h2ptl $mgs_HOST | sed -e s/@ptl//) 
3318     fi
3319
3320     echo Checking config lustre mounted on $mntpt
3321     local mgshost=$(mount | grep " $mntpt " | awk -F@ '{print $1}')
3322     mgshost=$(echo $mgshost | awk -F: '{print $1}')
3323
3324 #    if [ "$mgshost" != "$myMGS_host" ]; then
3325 #            log "Bad config file: lustre is mounted with mgs $mgshost, but mgs_HOST=$mgs_HOST, NETTYPE=$NETTYPE
3326 #                   Please use correct config or set mds_HOST correctly!"
3327 #    fi
3328
3329 }
3330
3331 check_config_clients () {
3332         local clients=${CLIENTS:-$HOSTNAME}
3333         local mntpt=$1
3334
3335         nfs_client_mode && return
3336
3337         do_rpc_nodes "$clients" check_config_client $mntpt
3338
3339         sanity_mount_check || error "environments are insane!"
3340 }
3341
3342 check_timeout () {
3343     local mdstimeout=$(do_facet $SINGLEMDS "lctl get_param -n timeout")
3344     local cltimeout=$(lctl get_param -n timeout)
3345     if [ $mdstimeout -ne $TIMEOUT ] || [ $mdstimeout -ne $cltimeout ]; then
3346         error "timeouts are wrong! mds: $mdstimeout, client: $cltimeout, TIMEOUT=$TIMEOUT"
3347         return 1
3348     fi
3349 }
3350
3351 is_mounted () {
3352     local mntpt=$1
3353     [ -z $mntpt ] && return 1
3354     local mounted=$(mounted_lustre_filesystems)
3355
3356     echo $mounted' ' | grep -w -q $mntpt' '
3357 }
3358
3359 is_empty_dir() {
3360         [ $(find $1 -maxdepth 1 -print | wc -l) = 1 ] && return 0
3361         return 1
3362 }
3363
3364 # empty lustre filesystem may have empty directories lost+found and .lustre
3365 is_empty_fs() {
3366         [ $(find $1 -maxdepth 1 -name lost+found -o -name .lustre -prune -o \
3367                 -print | wc -l) = 1 ] || return 1
3368         [ ! -d $1/lost+found ] || is_empty_dir $1/lost+found || return 1
3369         [ ! -d $1/.lustre ] || is_empty_dir $1/.lustre || return 1
3370         return 0
3371 }
3372
3373 check_and_setup_lustre() {
3374     nfs_client_mode && return
3375
3376     local MOUNTED=$(mounted_lustre_filesystems)
3377
3378     local do_check=true
3379     # 1.
3380     # both MOUNT and MOUNT2 are not mounted
3381     if ! is_mounted $MOUNT && ! is_mounted $MOUNT2; then
3382         [ "$REFORMAT" ] && formatall
3383         # setupall mounts both MOUNT and MOUNT2 (if MOUNT_2 is set)
3384         setupall
3385         is_mounted $MOUNT || error "NAME=$NAME not mounted"
3386         export I_MOUNTED=yes
3387         do_check=false
3388     # 2.
3389     # MOUNT2 is mounted
3390     elif is_mounted $MOUNT2; then
3391             # 3.
3392             # MOUNT2 is mounted, while MOUNT_2 is not set
3393             if ! [ "$MOUNT_2" ]; then
3394                 cleanup_mount $MOUNT2
3395                 export I_UMOUNTED2=yes
3396
3397             # 4.
3398             # MOUNT2 is mounted, MOUNT_2 is set
3399             else
3400                 # FIXME: what to do if check_config failed?
3401                 # i.e. if:
3402                 # 1) remote client has mounted other Lustre fs ?
3403                 # 2) it has insane env ?
3404                 # let's try umount MOUNT2 on all clients and mount it again:
3405                 if ! check_config_clients $MOUNT2; then
3406                     cleanup_mount $MOUNT2
3407                     restore_mount $MOUNT2
3408                     export I_MOUNTED2=yes
3409                 fi
3410             fi 
3411
3412     # 5.
3413     # MOUNT is mounted MOUNT2 is not mounted
3414     elif [ "$MOUNT_2" ]; then
3415         restore_mount $MOUNT2
3416         export I_MOUNTED2=yes
3417     fi
3418
3419     if $do_check; then
3420         # FIXME: what to do if check_config failed?
3421         # i.e. if:
3422         # 1) remote client has mounted other Lustre fs?
3423         # 2) lustre is mounted on remote_clients atall ?
3424         check_config_clients $MOUNT
3425         init_facets_vars
3426         init_param_vars
3427
3428         set_default_debug_nodes $(comma_list $(nodes_list))
3429     fi
3430
3431         init_gss
3432         if $GSS; then
3433                 set_flavor_all $SEC
3434         fi
3435
3436         if [ "$ONLY" == "setup" ]; then
3437                 exit 0
3438         fi
3439 }
3440
3441 restore_mount () {
3442    local clients=${CLIENTS:-$HOSTNAME}
3443    local mntpt=$1
3444
3445    zconf_mount_clients $clients $mntpt
3446 }
3447
3448 cleanup_mount () {
3449     local clients=${CLIENTS:-$HOSTNAME}
3450     local mntpt=$1
3451
3452     zconf_umount_clients $clients $mntpt    
3453 }
3454
3455 cleanup_and_setup_lustre() {
3456     if [ "$ONLY" == "cleanup" -o "`mount | grep $MOUNT`" ]; then
3457         lctl set_param debug=0 || true
3458         cleanupall
3459         if [ "$ONLY" == "cleanup" ]; then
3460             exit 0
3461         fi
3462     fi
3463     check_and_setup_lustre
3464 }
3465
3466 # Get all of the server target devices from a given server node and type.
3467 get_mnt_devs() {
3468         local node=$1
3469         local type=$2
3470         local devs
3471         local dev
3472
3473         if [ "$type" == ost ]; then
3474                 devs=$(get_osd_param $node "" mntdev)
3475         else
3476                 devs=$(do_node $node \
3477                        "lctl get_param -n osd-*.$FSNAME-M*.mntdev")
3478         fi
3479         for dev in $devs; do
3480                 case $dev in
3481                 *loop*) do_node $node "losetup $dev" | \
3482                                 sed -e "s/.*(//" -e "s/).*//" ;;
3483                 *) echo $dev ;;
3484                 esac
3485         done
3486 }
3487
3488 # Get all of the server target devices.
3489 get_svr_devs() {
3490     local i
3491
3492     # MDT device
3493     MDTDEV=$(get_mnt_devs $(mdts_nodes) mdt)
3494
3495     # OST devices
3496     i=0
3497     for node in $(osts_nodes); do
3498         OSTDEVS[i]=$(get_mnt_devs $node ost)
3499         i=$((i + 1))
3500     done
3501 }
3502
3503 # Run e2fsck on MDT or OST device.
3504 run_e2fsck() {
3505     local node=$1
3506     local target_dev=$2
3507     local extra_opts=$3
3508
3509     df > /dev/null      # update statfs data on disk
3510     local cmd="$E2FSCK -d -v -t -t -f $extra_opts $target_dev"
3511     echo $cmd
3512     local rc=0
3513     do_node $node $cmd || rc=$?
3514     [ $rc -le $FSCK_MAX_ERR ] || \
3515         error "$cmd returned $rc, should be <= $FSCK_MAX_ERR"
3516     return 0
3517 }
3518
3519 # verify a directory is shared among nodes.
3520 check_shared_dir() {
3521         local dir=$1
3522
3523         [ -z "$dir" ] && return 1
3524         do_rpc_nodes "$(comma_list $(nodes_list))" check_logdir $dir
3525         check_write_access $dir || return 1
3526         return 0
3527 }
3528
3529 # Run e2fsck on MDT and OST(s) to generate databases used for lfsck.
3530 generate_db() {
3531     local i
3532     local ostidx
3533     local dev
3534
3535         [[ $(lustre_version_code $SINGLEMDS) -ne $(version_code 2.2.0) ]] ||
3536                 { skip "Lustre 2.2.0 lacks the patch for LU-1255"; exit 0; }
3537
3538     check_shared_dir $SHARED_DIRECTORY ||
3539         error "$SHARED_DIRECTORY isn't a shared directory"
3540
3541     export MDSDB=$SHARED_DIRECTORY/mdsdb
3542     export OSTDB=$SHARED_DIRECTORY/ostdb
3543
3544     [ $MDSCOUNT -eq 1 ] || error "CMD is not supported"
3545
3546     run_e2fsck $(mdts_nodes) $MDTDEV "-n --mdsdb $MDSDB"
3547
3548     i=0
3549     ostidx=0
3550     OSTDB_LIST=""
3551     for node in $(osts_nodes); do
3552         for dev in ${OSTDEVS[i]}; do
3553             run_e2fsck $node $dev "-n --mdsdb $MDSDB --ostdb $OSTDB-$ostidx"
3554             OSTDB_LIST="$OSTDB_LIST $OSTDB-$ostidx"
3555             ostidx=$((ostidx + 1))
3556         done
3557         i=$((i + 1))
3558     done
3559 }
3560
3561 # Run lfsck on server node if lfsck can't be found on client (LU-2571)
3562 run_lfsck_remote() {
3563         local cmd="$LFSCK_BIN -c -l --mdsdb $MDSDB --ostdb $OSTDB_LIST $MOUNT"
3564         local client=$1
3565         local mounted=true
3566         local rc=0
3567
3568         #Check if lustre is already mounted
3569         do_rpc_nodes $client is_mounted $MOUNT || mounted=false
3570         if ! $mounted; then
3571                 zconf_mount $client $MOUNT ||
3572                         error "failed to mount Lustre on $client"
3573         fi
3574         #Run lfsck
3575         echo $cmd
3576         do_node $node $cmd || rc=$?
3577         #Umount if necessary
3578         if ! $mounted; then
3579                 zconf_umount $client $MOUNT ||
3580                         error "failed to unmount Lustre on $client"
3581         fi
3582
3583         [ $rc -le $FSCK_MAX_ERR ] ||
3584                 error "$cmd returned $rc, should be <= $FSCK_MAX_ERR"
3585         echo "lfsck finished with rc=$rc"
3586
3587         return $rc
3588 }
3589
3590 run_lfsck() {
3591         local facets="client $SINGLEMDS"
3592         local found=false
3593         local facet
3594         local node
3595         local rc=0
3596
3597         for facet in $facets; do
3598                 node=$(facet_active_host $facet)
3599                 if check_progs_installed $node $LFSCK_BIN; then
3600                         found=true
3601                         break
3602                 fi
3603         done
3604         ! $found && error "None of \"$facets\" supports lfsck"
3605
3606         run_lfsck_remote $node || rc=$?
3607
3608         rm -rvf $MDSDB* $OSTDB* || true
3609         return $rc
3610 }
3611
3612 check_and_cleanup_lustre() {
3613     if [ "$LFSCK_ALWAYS" = "yes" -a "$TESTSUITE" != "lfsck" ]; then
3614         get_svr_devs
3615         generate_db
3616         run_lfsck
3617     fi
3618
3619         if is_mounted $MOUNT; then
3620                 [ -n "$DIR" ] && rm -rf $DIR/[Rdfs][0-9]* ||
3621                         error "remove sub-test dirs failed"
3622                 [ "$ENABLE_QUOTA" ] && restore_quota || true
3623         fi
3624
3625     if [ "$I_UMOUNTED2" = "yes" ]; then
3626         restore_mount $MOUNT2 || error "restore $MOUNT2 failed"
3627     fi
3628
3629     if [ "$I_MOUNTED2" = "yes" ]; then
3630         cleanup_mount $MOUNT2
3631     fi
3632
3633     if [ "$I_MOUNTED" = "yes" ]; then
3634         cleanupall -f || error "cleanup failed"
3635         unset I_MOUNTED
3636     fi
3637 }
3638
3639 #######
3640 # General functions
3641
3642 wait_for_function () {
3643     local quiet=""
3644
3645     # suppress fn both stderr and stdout
3646     if [ "$1" = "--quiet" ]; then
3647         shift
3648         quiet=" > /dev/null 2>&1"
3649
3650     fi
3651
3652     local fn=$1
3653     local max=${2:-900}
3654     local sleep=${3:-5}
3655
3656     local wait=0
3657
3658     while true; do
3659
3660         eval $fn $quiet && return 0
3661
3662         wait=$((wait + sleep))
3663         [ $wait -lt $max ] || return 1
3664         echo waiting $fn, $((max - wait)) secs left ...
3665         sleep $sleep
3666     done
3667 }
3668
3669 check_network() {
3670     local host=$1
3671     local max=$2
3672     local sleep=${3:-5}
3673
3674     echo `date +"%H:%M:%S (%s)"` waiting for $host network $max secs ...
3675     if ! wait_for_function --quiet "ping -c 1 -w 3 $host" $max $sleep ; then
3676         echo "Network not available!"
3677         exit 1
3678     fi
3679
3680     echo `date +"%H:%M:%S (%s)"` network interface is UP
3681 }
3682
3683 no_dsh() {
3684     shift
3685     eval $@
3686 }
3687
3688 # Convert a space-delimited list to a comma-delimited list.  If the input is
3689 # only whitespace, ensure the output is empty (i.e. "") so [ -n $list ] works
3690 comma_list() {
3691         # echo is used to convert newlines to spaces, since it doesn't
3692         # introduce a trailing space as using "tr '\n' ' '" does
3693         echo $(tr -s " " "\n" <<< $* | sort -b -u) | tr ' ' ','
3694 }
3695
3696 list_member () {
3697     local list=$1
3698     local item=$2
3699     echo $list | grep -qw $item
3700 }
3701
3702 # list, excluded are the comma separated lists
3703 exclude_items_from_list () {
3704     local list=$1
3705     local excluded=$2
3706     local item
3707
3708     list=${list//,/ }
3709     for item in ${excluded//,/ }; do
3710         list=$(echo " $list " | sed -re "s/\s+$item\s+/ /g")
3711     done
3712     echo $(comma_list $list)
3713 }
3714
3715 # list, expand  are the comma separated lists
3716 expand_list () {
3717     local list=${1//,/ }
3718     local expand=${2//,/ }
3719     local expanded=
3720
3721     expanded=$(for i in $list $expand; do echo $i; done | sort -u)
3722     echo $(comma_list $expanded)
3723 }
3724
3725 testslist_filter () {
3726     local script=$LUSTRE/tests/${TESTSUITE}.sh
3727
3728     [ -f $script ] || return 0
3729
3730     local start_at=$START_AT
3731     local stop_at=$STOP_AT
3732
3733     local var=${TESTSUITE//-/_}_START_AT
3734     [ x"${!var}" != x ] && start_at=${!var}
3735     var=${TESTSUITE//-/_}_STOP_AT
3736     [ x"${!var}" != x ] && stop_at=${!var}
3737
3738     sed -n 's/^test_\([^ (]*\).*/\1/p' $script | \
3739         awk ' BEGIN { if ("'${start_at:-0}'" != 0) flag = 1 }
3740             /^'${start_at}'$/ {flag = 0}
3741             {if (flag == 1) print $0}
3742             /^'${stop_at}'$/ { flag = 1 }'
3743 }
3744
3745 absolute_path() {
3746     (cd `dirname $1`; echo $PWD/`basename $1`)
3747 }
3748
3749 get_facets () {
3750     local types=${1:-"OST MDS MGS"}
3751
3752     local list=""
3753
3754     for entry in $types; do
3755         local name=$(echo $entry | tr "[:upper:]" "[:lower:]")
3756         local type=$(echo $entry | tr "[:lower:]" "[:upper:]")
3757
3758         case $type in
3759                 MGS ) list="$list $name";;
3760             MDS|OST ) local count=${type}COUNT
3761                        for ((i=1; i<=${!count}; i++)) do
3762                           list="$list ${name}$i"
3763                       done;;
3764                   * ) error "Invalid facet type"
3765                  exit 1;;
3766         esac
3767     done
3768     echo $(comma_list $list)
3769 }
3770
3771 ##################################
3772 # Adaptive Timeouts funcs
3773
3774 at_is_enabled() {
3775     # only check mds, we assume at_max is the same on all nodes
3776     local at_max=$(do_facet $SINGLEMDS "lctl get_param -n at_max")
3777     if [ $at_max -eq 0 ]; then
3778         return 1
3779     else
3780         return 0
3781     fi
3782 }
3783
3784 at_get() {
3785     local facet=$1
3786     local at=$2
3787
3788     # suppose that all ost-s have the same $at value set
3789     [ $facet != "ost" ] || facet=ost1
3790
3791     do_facet $facet "lctl get_param -n $at"
3792 }
3793
3794 at_max_get() {
3795     at_get $1 at_max
3796 }
3797
3798 at_min_get() {
3799         at_get $1 at_min
3800 }
3801
3802 at_max_set() {
3803     local at_max=$1
3804     shift
3805
3806     local facet
3807     local hosts
3808     for facet in $@; do
3809         if [ $facet == "ost" ]; then
3810             facet=$(get_facets OST)
3811         elif [ $facet == "mds" ]; then
3812             facet=$(get_facets MDS)
3813         fi
3814         hosts=$(expand_list $hosts $(facets_hosts $facet))
3815     done
3816
3817     do_nodes $hosts lctl set_param at_max=$at_max
3818 }
3819
3820 ##################################
3821 # OBD_FAIL funcs
3822
3823 drop_request() {
3824 # OBD_FAIL_MDS_ALL_REQUEST_NET
3825     RC=0
3826     do_facet $SINGLEMDS lctl set_param fail_loc=0x123
3827     do_facet client "$1" || RC=$?
3828     do_facet $SINGLEMDS lctl set_param fail_loc=0
3829     return $RC
3830 }
3831
3832 drop_reply() {
3833 # OBD_FAIL_MDS_ALL_REPLY_NET
3834     RC=0
3835     do_facet $SINGLEMDS lctl set_param fail_loc=0x122
3836     do_facet client "$@" || RC=$?
3837     do_facet $SINGLEMDS lctl set_param fail_loc=0
3838     return $RC
3839 }
3840
3841 drop_reint_reply() {
3842 # OBD_FAIL_MDS_REINT_NET_REP
3843     RC=0
3844     do_facet $SINGLEMDS lctl set_param fail_loc=0x119
3845     do_facet client "$@" || RC=$?
3846     do_facet $SINGLEMDS lctl set_param fail_loc=0
3847     return $RC
3848 }
3849
3850 drop_update_reply() {
3851 # OBD_FAIL_UPDATE_OBJ_NET
3852         local index=$1
3853         shift 1
3854         RC=0
3855         do_facet mds${index} lctl set_param fail_loc=0x1500
3856         do_facet client "$@" || RC=$?
3857         do_facet mds${index} lctl set_param fail_loc=0
3858         return $RC
3859 }
3860
3861 pause_bulk() {
3862 #define OBD_FAIL_OST_BRW_PAUSE_BULK      0x214
3863     RC=0
3864     do_facet ost1 lctl set_param fail_loc=0x214
3865     do_facet client "$1" || RC=$?
3866     do_facet client "sync"
3867     do_facet ost1 lctl set_param fail_loc=0
3868     return $RC
3869 }
3870
3871 drop_ldlm_cancel() {
3872 #define OBD_FAIL_LDLM_CANCEL_NET                        0x304
3873         local RC=0
3874         local list=$(comma_list $(mdts_nodes) $(osts_nodes))
3875         do_nodes $list lctl set_param fail_loc=0x304
3876
3877         do_facet client "$@" || RC=$?
3878
3879         do_nodes $list lctl set_param fail_loc=0
3880         return $RC
3881 }
3882
3883 drop_bl_callback() {
3884 #define OBD_FAIL_LDLM_BL_CALLBACK_NET                   0x305
3885         RC=0
3886         do_facet client lctl set_param fail_loc=0x80000305
3887         do_facet client "$@" || RC=$?
3888         do_facet client lctl set_param fail_loc=0
3889         return $RC
3890 }
3891
3892 drop_ldlm_reply() {
3893 #define OBD_FAIL_LDLM_REPLY              0x30c
3894     RC=0
3895     do_facet $SINGLEMDS lctl set_param fail_loc=0x30c
3896     do_facet client "$@" || RC=$?
3897     do_facet $SINGLEMDS lctl set_param fail_loc=0
3898     return $RC
3899 }
3900
3901 clear_failloc() {
3902     facet=$1
3903     pause=$2
3904     sleep $pause
3905     echo "clearing fail_loc on $facet"
3906     do_facet $facet "lctl set_param fail_loc=0 2>/dev/null || true"
3907 }
3908
3909 set_nodes_failloc () {
3910     do_nodes $(comma_list $1)  lctl set_param fail_loc=$2
3911 }
3912
3913 cancel_lru_locks() {
3914     $LCTL mark "cancel_lru_locks $1 start"
3915     for d in `lctl get_param -N ldlm.namespaces.*.lru_size | egrep -i $1`; do
3916         $LCTL set_param -n $d=clear
3917     done
3918     $LCTL get_param ldlm.namespaces.*.lock_unused_count | egrep -i $1 | grep -v '=0'
3919     $LCTL mark "cancel_lru_locks $1 stop"
3920 }
3921
3922 default_lru_size()
3923 {
3924         NR_CPU=$(grep -c "processor" /proc/cpuinfo)
3925         DEFAULT_LRU_SIZE=$((100 * NR_CPU))
3926         echo "$DEFAULT_LRU_SIZE"
3927 }
3928
3929 lru_resize_enable()
3930 {
3931     lctl set_param ldlm.namespaces.*$1*.lru_size=0
3932 }
3933
3934 lru_resize_disable()
3935 {
3936     lctl set_param ldlm.namespaces.*$1*.lru_size $(default_lru_size)
3937 }
3938
3939 pgcache_empty() {
3940     local FILE
3941     for FILE in `lctl get_param -N "llite.*.dump_page_cache"`; do
3942         if [ `lctl get_param -n $FILE | wc -l` -gt 1 ]; then
3943             echo there is still data in page cache $FILE ?
3944             lctl get_param -n $FILE
3945             return 1
3946         fi
3947     done
3948     return 0
3949 }
3950
3951 debugsave() {
3952     DEBUGSAVE="$(lctl get_param -n debug)"
3953 }
3954
3955 debugrestore() {
3956     [ -n "$DEBUGSAVE" ] && \
3957         do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug=\\\"${DEBUGSAVE}\\\";"
3958     DEBUGSAVE=""
3959 }
3960
3961 debug_size_save() {
3962     DEBUG_SIZE_SAVED="$(lctl get_param -n debug_mb)"
3963 }
3964
3965 debug_size_restore() {
3966     [ -n "$DEBUG_SIZE_SAVED" ] && \
3967         do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug_mb=$DEBUG_SIZE_SAVED"
3968     DEBUG_SIZE_SAVED=""
3969 }
3970
3971 start_full_debug_logging() {
3972     debugsave
3973     debug_size_save
3974
3975     local FULLDEBUG=-1
3976     local DEBUG_SIZE=150
3977
3978     do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug_mb=$DEBUG_SIZE"
3979     do_nodes $(comma_list $(nodes_list)) "$LCTL set_param debug=$FULLDEBUG;"
3980 }
3981
3982 stop_full_debug_logging() {
3983     debug_size_restore
3984     debugrestore
3985 }
3986
3987 # prints bash call stack
3988 log_trace_dump() {
3989         echo "  Trace dump:"
3990         for (( i=1; i < ${#BASH_LINENO[*]} ; i++ )) ; do
3991                 local s=${BASH_SOURCE[$i]}
3992                 local l=${BASH_LINENO[$i-1]}
3993                 local f=${FUNCNAME[$i]}
3994                 echo "  = $s:$l:$f()"
3995         done
3996 }
3997
3998 ##################################
3999 # Test interface
4000 ##################################
4001
4002 error_noexit() {
4003     local TYPE=${TYPE:-"FAIL"}
4004
4005     local dump=true
4006     # do not dump logs if $1=false
4007     if [ "x$1" = "xfalse" ]; then
4008         shift
4009         dump=false
4010     fi
4011
4012     log " ${TESTSUITE} ${TESTNAME}: @@@@@@ ${TYPE}: $@ "
4013     log_trace_dump
4014
4015     mkdir -p $LOGDIR
4016     # We need to dump the logs on all nodes
4017     if $dump; then
4018         gather_logs $(comma_list $(nodes_list))
4019     fi
4020
4021         debugrestore
4022         [ "$TESTSUITELOG" ] &&
4023                 echo "$TESTSUITE: $TYPE: $TESTNAME $@" >> $TESTSUITELOG
4024         echo "$@" > $LOGDIR/err
4025 }
4026
4027 exit_status () {
4028         local status=0
4029         local log=$TESTSUITELOG
4030
4031         [ -f "$log" ] && grep -q FAIL $log && status=1
4032         exit $status
4033 }
4034
4035 error() {
4036     error_noexit "$@"
4037     exit 1
4038 }
4039
4040 error_exit() {
4041     error "$@"
4042 }
4043
4044 # use only if we are ignoring failures for this test, bugno required.
4045 # (like ALWAYS_EXCEPT, but run the test and ignore the results.)
4046 # e.g. error_ignore 5494 "your message"
4047 error_ignore() {
4048     local TYPE="IGNORE (bz$1)"
4049     shift
4050     error_noexit "$@"
4051 }
4052
4053 error_and_remount() {
4054         error_noexit "$@"
4055         remount_client $MOUNT
4056         exit 1
4057 }
4058
4059 skip_env () {
4060     $FAIL_ON_SKIP_ENV && error false $@ || skip $@
4061 }
4062
4063 skip() {
4064         echo
4065         log " SKIP: $TESTSUITE $TESTNAME $@"
4066
4067         if [[ -n "$ALWAYS_SKIPPED" ]]; then
4068                 skip_logged $TESTNAME "$@"
4069         else
4070                 mkdir -p $LOGDIR
4071                 echo "$@" > $LOGDIR/skip
4072         fi
4073
4074         [[ -n "$TESTSUITELOG" ]] &&
4075                 echo "$TESTSUITE: SKIP: $TESTNAME $@" >> $TESTSUITELOG || true
4076 }
4077
4078 build_test_filter() {
4079     EXCEPT="$EXCEPT $(testslist_filter)"
4080
4081     [ "$ONLY" ] && log "only running test `echo $ONLY`"
4082     for O in $ONLY; do
4083         eval ONLY_${O}=true
4084     done
4085     [ "$EXCEPT$ALWAYS_EXCEPT" ] && \
4086         log "excepting tests: `echo $EXCEPT $ALWAYS_EXCEPT`"
4087     [ "$EXCEPT_SLOW" ] && \
4088         log "skipping tests SLOW=no: `echo $EXCEPT_SLOW`"
4089     for E in $EXCEPT; do
4090         eval EXCEPT_${E}=true
4091     done
4092     for E in $ALWAYS_EXCEPT; do
4093         eval EXCEPT_ALWAYS_${E}=true
4094     done
4095     for E in $EXCEPT_SLOW; do
4096         eval EXCEPT_SLOW_${E}=true
4097     done
4098     for G in $GRANT_CHECK_LIST; do
4099         eval GCHECK_ONLY_${G}=true
4100         done
4101 }
4102
4103 basetest() {
4104     if [[ $1 = [a-z]* ]]; then
4105         echo $1
4106     else
4107         echo ${1%%[a-z]*}
4108     fi
4109 }
4110
4111 # print a newline if the last test was skipped
4112 export LAST_SKIPPED=
4113 export ALWAYS_SKIPPED=
4114 #
4115 # Main entry into test-framework. This is called with the name and
4116 # description of a test. The name is used to find the function to run
4117 # the test using "test_$name".
4118 #
4119 # This supports a variety of methods of specifying specific test to
4120 # run or not run.  These need to be documented...
4121 #
4122 run_test() {
4123     assert_DIR
4124
4125     export base=`basetest $1`
4126     if [ ! -z "$ONLY" ]; then
4127         testname=ONLY_$1
4128         if [ ${!testname}x != x ]; then
4129             [ "$LAST_SKIPPED" ] && echo "" && LAST_SKIPPED=
4130             run_one_logged $1 "$2"
4131             return $?
4132         fi
4133         testname=ONLY_$base
4134         if [ ${!testname}x != x ]; then
4135             [ "$LAST_SKIPPED" ] && echo "" && LAST_SKIPPED=
4136             run_one_logged $1 "$2"
4137             return $?
4138         fi
4139         LAST_SKIPPED="y"
4140         echo -n "."
4141         return 0
4142     fi
4143
4144         LAST_SKIPPED="y"
4145         ALWAYS_SKIPPED="y"
4146     testname=EXCEPT_$1
4147     if [ ${!testname}x != x ]; then
4148         TESTNAME=test_$1 skip "skipping excluded test $1"
4149         return 0
4150     fi
4151     testname=EXCEPT_$base
4152     if [ ${!testname}x != x ]; then
4153         TESTNAME=test_$1 skip "skipping excluded test $1 (base $base)"
4154         return 0
4155     fi
4156     testname=EXCEPT_ALWAYS_$1
4157     if [ ${!testname}x != x ]; then
4158         TESTNAME=test_$1 skip "skipping ALWAYS excluded test $1"
4159         return 0
4160     fi
4161     testname=EXCEPT_ALWAYS_$base
4162     if [ ${!testname}x != x ]; then
4163         TESTNAME=test_$1 skip "skipping ALWAYS excluded test $1 (base $base)"
4164         return 0
4165     fi
4166     testname=EXCEPT_SLOW_$1
4167     if [ ${!testname}x != x ]; then
4168         TESTNAME=test_$1 skip "skipping SLOW test $1"
4169         return 0
4170     fi
4171     testname=EXCEPT_SLOW_$base
4172     if [ ${!testname}x != x ]; then
4173         TESTNAME=test_$1 skip "skipping SLOW test $1 (base $base)"
4174         return 0
4175     fi
4176
4177     LAST_SKIPPED=
4178     ALWAYS_SKIPPED=
4179     run_one_logged $1 "$2"
4180
4181     return $?
4182 }
4183
4184 log() {
4185     echo "$*"
4186     module_loaded lnet || load_modules
4187
4188     local MSG="$*"
4189     # Get rid of '
4190     MSG=${MSG//\'/\\\'}
4191     MSG=${MSG//\(/\\\(}
4192     MSG=${MSG//\)/\\\)}
4193     MSG=${MSG//\;/\\\;}
4194     MSG=${MSG//\|/\\\|}
4195     MSG=${MSG//\>/\\\>}
4196     MSG=${MSG//\</\\\<}
4197     MSG=${MSG//\//\\\/}
4198     do_nodes $(comma_list $(nodes_list)) $LCTL mark "$MSG" 2> /dev/null || true
4199 }
4200
4201 trace() {
4202         log "STARTING: $*"
4203         strace -o $TMP/$1.strace -ttt $*
4204         RC=$?
4205         log "FINISHED: $*: rc $RC"
4206         return 1
4207 }
4208
4209 complete () {
4210     local duration=$1
4211
4212     banner test complete, duration $duration sec
4213     [ -f "$TESTSUITELOG" ] && egrep .FAIL $TESTSUITELOG || true
4214     echo duration $duration >>$TESTSUITELOG
4215 }
4216
4217 pass() {
4218         # Set TEST_STATUS here. It will be used for logging the result.
4219         TEST_STATUS="PASS"
4220
4221         if [[ -f $LOGDIR/err ]]; then
4222                 TEST_STATUS="FAIL"
4223         elif [[ -f $LOGDIR/skip ]]; then
4224                 TEST_STATUS="SKIP"
4225         fi
4226         echo "$TEST_STATUS $@" 2>&1 | tee -a $TESTSUITELOG
4227 }
4228
4229 check_mds() {
4230     local FFREE=$(do_node $SINGLEMDS \
4231         lctl get_param -n osd*.*MDT*.filesfree | calc_sum)
4232     local FTOTAL=$(do_node $SINGLEMDS \
4233         lctl get_param -n osd*.*MDT*.filestotal | calc_sum)
4234
4235     [ $FFREE -ge $FTOTAL ] && error "files free $FFREE > total $FTOTAL" || true
4236 }
4237
4238 reset_fail_loc () {
4239     echo -n "Resetting fail_loc on all nodes..."
4240     do_nodes $(comma_list $(nodes_list)) "lctl set_param -n fail_loc=0 2>/dev/null || true"
4241     echo done.
4242 }
4243
4244
4245 #
4246 # Log a message (on all nodes) padded with "=" before and after. 
4247 # Also appends a timestamp and prepends the testsuite name.
4248
4249
4250 EQUALS="===================================================================================================="
4251 banner() {
4252     msg="== ${TESTSUITE} $*"
4253     last=${msg: -1:1}
4254     [[ $last != "=" && $last != " " ]] && msg="$msg "
4255     msg=$(printf '%s%.*s'  "$msg"  $((${#EQUALS} - ${#msg})) $EQUALS )
4256     # always include at least == after the message
4257     log "$msg== $(date +"%H:%M:%S (%s)")"
4258 }
4259
4260 #
4261 # Run a single test function and cleanup after it.  
4262 #
4263 # This function should be run in a subshell so the test func can
4264 # exit() without stopping the whole script.
4265 #
4266 run_one() {
4267     local testnum=$1
4268     local message=$2
4269     tfile=f.${TESTSUITE}.${testnum}
4270     export tdir=d0.${TESTSUITE}/d${base}
4271     export TESTNAME=test_$testnum
4272     local SAVE_UMASK=`umask`
4273     umask 0022
4274
4275     banner "test $testnum: $message"
4276     test_${testnum} || error "test_$testnum failed with $?"
4277     cd $SAVE_PWD
4278     reset_fail_loc
4279     check_grant ${testnum} || error "check_grant $testnum failed with $?"
4280     check_catastrophe || error "LBUG/LASSERT detected"
4281         if [ "$PARALLEL" != "yes" ]; then
4282                 ps auxww | grep -v grep | grep -q multiop &&
4283                                         error "multiop still running"
4284         fi
4285     unset TESTNAME
4286     unset tdir
4287     umask $SAVE_UMASK
4288     return 0
4289 }
4290
4291 #
4292 # Wrapper around run_one to ensure:
4293 #  - test runs in subshell
4294 #  - output of test is saved to separate log file for error reporting
4295 #  - test result is saved to data file
4296 #
4297 run_one_logged() {
4298         local BEFORE=`date +%s`
4299         local TEST_ERROR
4300         local name=${TESTSUITE}.test_${1}.test_log.$(hostname -s).log
4301         local test_log=$LOGDIR/$name
4302         rm -rf $LOGDIR/err
4303         rm -rf $LOGDIR/skip
4304         local SAVE_UMASK=`umask`
4305         umask 0022
4306
4307         echo
4308         log_sub_test_begin test_${1}
4309         (run_one $1 "$2") 2>&1 | tee -i $test_log
4310         local RC=${PIPESTATUS[0]}
4311
4312         [ $RC -ne 0 ] && [ ! -f $LOGDIR/err ] && \
4313                 echo "test_$1 returned $RC" | tee $LOGDIR/err
4314
4315         duration=$((`date +%s` - $BEFORE))
4316         pass "$1" "(${duration}s)"
4317
4318         if [[ -f $LOGDIR/err ]]; then
4319                 TEST_ERROR=$(cat $LOGDIR/err)
4320         elif [[ -f $LOGDIR/skip ]]; then
4321                 TEST_ERROR=$(cat $LOGDIR/skip)
4322         fi
4323         log_sub_test_end $TEST_STATUS $duration "$RC" "$TEST_ERROR"
4324
4325         if [ -f $LOGDIR/err ]; then
4326                 $FAIL_ON_ERROR && exit $RC
4327         fi
4328
4329         umask $SAVE_UMASK
4330
4331         return 0
4332 }
4333
4334 #
4335 # Print information of skipped tests to result.yml
4336 #
4337 skip_logged(){
4338         log_sub_test_begin $1
4339         shift
4340         log_sub_test_end "SKIP" "0" "0" "$@"
4341 }
4342
4343 canonical_path() {
4344     (cd `dirname $1`; echo $PWD/`basename $1`)
4345 }
4346
4347
4348 check_grant() {
4349     export base=`basetest $1`
4350     [ "$CHECK_GRANT" == "no" ] && return 0
4351
4352         testname=GCHECK_ONLY_${base}
4353         [ ${!testname}x == x ] && return 0
4354
4355     echo -n "checking grant......"
4356
4357         local clients=$CLIENTS
4358         [ -z $clients ] && clients=$(hostname)
4359
4360     # sync all the data and make sure no pending data on server
4361     do_nodes $clients sync
4362
4363     # get client grant
4364     client_grant=`do_nodes $clients \
4365                     "$LCTL get_param -n osc.${FSNAME}-*.cur_*grant_bytes" | \
4366                     awk '{total += $1} END{print total}'`
4367
4368     # get server grant
4369     server_grant=`do_nodes $(comma_list $(osts_nodes)) \
4370                     "$LCTL get_param -n obdfilter.${FSNAME}-OST*.tot_granted" |
4371                     awk '{total += $1} END{print total}'`
4372
4373     # check whether client grant == server grant
4374     if [ $client_grant -ne $server_grant ]; then
4375         echo "failed: client:${client_grant} server: ${server_grant}."
4376         do_nodes $(comma_list $(osts_nodes)) \
4377                    "$LCTL get_param obdfilter.${FSNAME}-OST*.tot*"
4378         do_nodes $clients "$LCTL get_param osc.${FSNAME}-*.cur_*_bytes"
4379         return 1
4380     else
4381         echo "pass: client:${client_grant} server: ${server_grant}"
4382     fi
4383
4384 }
4385
4386 ########################
4387 # helper functions
4388
4389 osc_to_ost()
4390 {
4391     osc=$1
4392     ost=`echo $1 | awk -F_ '{print $3}'`
4393     if [ -z $ost ]; then
4394         ost=`echo $1 | sed 's/-osc.*//'`
4395     fi
4396     echo $ost
4397 }
4398
4399 ostuuid_from_index()
4400 {
4401     $LFS osts $2 | sed -ne "/^$1: /s/.* \(.*\) .*$/\1/p"
4402 }
4403
4404 ostname_from_index() {
4405     local uuid=$(ostuuid_from_index $1)
4406     echo ${uuid/_UUID/}
4407 }
4408
4409 index_from_ostuuid()
4410 {
4411     $LFS osts $2 | sed -ne "/${1}/s/\(.*\): .* .*$/\1/p"
4412 }
4413
4414 mdtuuid_from_index()
4415 {
4416     $LFS mdts $2 | sed -ne "/^$1: /s/.* \(.*\) .*$/\1/p"
4417 }
4418
4419 # Description:
4420 #   Return unique identifier for given hostname
4421 host_id() {
4422         local host_name=$1
4423         echo $host_name | md5sum | cut -d' ' -f1
4424 }
4425
4426 # Description:
4427 #   Returns list of ip addresses for each interface
4428 local_addr_list() {
4429         ip addr | awk '/inet\ / {print $2}' | awk -F\/ '{print $1}'
4430 }
4431
4432 is_local_addr() {
4433         local addr=$1
4434         # Cache address list to avoid mutiple execution of local_addr_list
4435         LOCAL_ADDR_LIST=${LOCAL_ADDR_LIST:-$(local_addr_list)}
4436         local i
4437         for i in $LOCAL_ADDR_LIST ; do
4438                 [[ "$i" == "$addr" ]] && return 0
4439         done
4440         return 1
4441 }
4442
4443 local_node() {
4444         local host_name=$1
4445         local is_local="IS_LOCAL_$(host_id $host_name)"
4446         if [ -z "${!is_local-}" ] ; then
4447                 eval $is_local=0
4448                 local host_ip=$($LUSTRE/tests/resolveip $host_name)
4449                 is_local_addr "$host_ip" && eval $is_local=1
4450         fi
4451         [[ "${!is_local}" == "1" ]]
4452 }
4453
4454 remote_node () {
4455         local node=$1
4456         local_node $node && return 1
4457         return 0
4458 }
4459
4460 remote_mds ()
4461 {
4462     local node
4463     for node in $(mdts_nodes); do
4464         remote_node $node && return 0
4465     done
4466     return 1
4467 }
4468
4469 remote_mds_nodsh()
4470 {
4471     [ "$CLIENTONLY" ] && return 0 || true
4472     remote_mds && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$mds_HOST" ]
4473 }
4474
4475 require_dsh_mds()
4476 {
4477         remote_mds_nodsh && echo "SKIP: $TESTSUITE: remote MDS with nodsh" && \
4478             MSKIPPED=1 && return 1
4479         return 0
4480 }
4481
4482 remote_ost ()
4483 {
4484     local node
4485     for node in $(osts_nodes) ; do
4486         remote_node $node && return 0
4487     done
4488     return 1
4489 }
4490
4491 remote_ost_nodsh()
4492 {
4493     [ "$CLIENTONLY" ] && return 0 || true 
4494     remote_ost && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$ost_HOST" ]
4495 }
4496
4497 require_dsh_ost()
4498 {
4499         remote_ost_nodsh && echo "SKIP: $TESTSUITE: remote OST with nodsh" && \
4500             OSKIPPED=1 && return 1
4501         return 0
4502 }
4503
4504 remote_mgs_nodsh()
4505 {
4506     local MGS 
4507     MGS=$(facet_host mgs)
4508     remote_node $MGS && [ "$PDSH" = "no_dsh" -o -z "$PDSH" -o -z "$ost_HOST" ]
4509 }
4510
4511 local_mode ()
4512 {
4513     remote_mds_nodsh || remote_ost_nodsh || \
4514         $(single_local_node $(comma_list $(nodes_list)))
4515 }
4516
4517 mdts_nodes () {
4518     local MDSNODES
4519     local NODES_sort
4520     for num in `seq $MDSCOUNT`; do
4521         MDSNODES="$MDSNODES $(facet_host mds$num)"
4522     done
4523     NODES_sort=$(for i in $MDSNODES; do echo $i; done | sort -u)
4524
4525     echo $NODES_sort
4526 }
4527
4528 remote_servers () {
4529     remote_ost && remote_mds
4530 }
4531
4532 facets_nodes () {
4533     local facets=$1
4534     local nodes
4535     local NODES_sort
4536
4537     for facet in ${facets//,/ }; do
4538         if [ "$FAILURE_MODE" = HARD ]; then
4539             nodes="$nodes $(facet_active_host $facet)"
4540         else
4541             nodes="$nodes $(facet_host $facet)"
4542         fi
4543     done
4544     NODES_sort=$(for i in $nodes; do echo $i; done | sort -u)
4545
4546     echo $NODES_sort
4547 }
4548
4549 osts_nodes () {
4550     local facets=$(get_facets OST)
4551     local nodes=$(facets_nodes $facets)
4552
4553     echo $nodes
4554 }
4555
4556 nodes_list () {
4557     # FIXME. We need a list of clients
4558     local myNODES=$HOSTNAME
4559     local myNODES_sort
4560
4561     # CLIENTS (if specified) contains the local client
4562     [ -n "$CLIENTS" ] && myNODES=${CLIENTS//,/ }
4563
4564     if [ "$PDSH" -a "$PDSH" != "no_dsh" ]; then
4565         myNODES="$myNODES $(facets_nodes $(get_facets))"
4566     fi
4567
4568     myNODES_sort=$(for i in $myNODES; do echo $i; done | sort -u)
4569
4570     echo $myNODES_sort
4571 }
4572
4573 remote_nodes_list () {
4574         echo $(nodes_list) | sed -re "s/\<$HOSTNAME\>//g"
4575 }
4576
4577 init_clients_lists () {
4578     # Sanity check: exclude the local client from RCLIENTS
4579     local clients=$(hostlist_expand "$RCLIENTS")
4580     local rclients=$(exclude_items_from_list "$clients" $HOSTNAME)
4581
4582     # Sanity check: exclude the dup entries
4583     RCLIENTS=$(for i in ${rclients//,/ }; do echo $i; done | sort -u)
4584
4585     clients="$SINGLECLIENT $HOSTNAME $RCLIENTS"
4586
4587     # Sanity check: exclude the dup entries from CLIENTS
4588     # for those configs which has SINGLCLIENT set to local client
4589     clients=$(for i in $clients; do echo $i; done | sort -u)
4590
4591     CLIENTS=$(comma_list $clients)
4592     local -a remoteclients=($RCLIENTS)
4593     for ((i=0; $i<${#remoteclients[@]}; i++)); do
4594             varname=CLIENT$((i + 2))
4595             eval $varname=${remoteclients[i]}
4596     done
4597
4598     CLIENTCOUNT=$((${#remoteclients[@]} + 1))
4599 }
4600
4601 get_random_entry () {
4602     local rnodes=$1
4603
4604     rnodes=${rnodes//,/ }
4605
4606     local -a nodes=($rnodes)
4607     local num=${#nodes[@]} 
4608     local i=$((RANDOM * num * 2 / 65536))
4609
4610     echo ${nodes[i]}
4611 }
4612
4613 client_only () {
4614     [ "$CLIENTONLY" ] || [ "$CLIENTMODSONLY" = yes ]
4615 }
4616
4617 is_patchless ()
4618 {
4619     lctl get_param version | grep -q patchless
4620 }
4621
4622 check_versions () {
4623     [ "$(lustre_version_code client)" = "$(lustre_version_code $SINGLEMDS)" -a \
4624       "$(lustre_version_code client)" = "$(lustre_version_code ost1)" ]
4625 }
4626
4627 get_node_count() {
4628     local nodes="$@"
4629     echo $nodes | wc -w || true
4630 }
4631
4632 mixed_ost_devs () {
4633     local nodes=$(osts_nodes)
4634     local osscount=$(get_node_count "$nodes")
4635     [ ! "$OSTCOUNT" = "$osscount" ]
4636 }
4637
4638 mixed_mdt_devs () {
4639     local nodes=$(mdts_nodes)
4640     local mdtcount=$(get_node_count "$nodes")
4641     [ ! "$MDSCOUNT" = "$mdtcount" ]
4642 }
4643
4644 generate_machine_file() {
4645     local nodes=${1//,/ }
4646     local machinefile=$2
4647     rm -f $machinefile
4648     for node in $nodes; do
4649         echo $node >>$machinefile || \
4650             { echo "can not generate machinefile $machinefile" && return 1; }
4651     done
4652 }
4653
4654 get_stripe () {
4655     local file=$1/stripe
4656     touch $file
4657     $LFS getstripe -v $file || error
4658     rm -f $file
4659 }
4660
4661 setstripe_nfsserver () {
4662     local dir=$1
4663
4664     local nfsserver=$(awk '"'$dir'" ~ $2 && $3 ~ "nfs" && $2 != "/" \
4665                 { print $1 }' /proc/mounts | cut -f 1 -d : | head -1)
4666
4667     [ -z $nfsserver ] && echo "$dir is not nfs mounted" && return 1
4668
4669     do_nodev $nfsserver lfs setstripe "$@"
4670 }
4671
4672 # Check and add a test group.
4673 add_group() {
4674         local group_id=$1
4675         local group_name=$2
4676         local rc=0
4677
4678         local gid=$(getent group $group_name | cut -d: -f3)
4679         if [[ -n "$gid" ]]; then
4680                 [[ "$gid" -eq "$group_id" ]] || {
4681                         error_noexit "inconsistent group ID:" \
4682                                      "new: $group_id, old: $gid"
4683                         rc=1
4684                 }
4685         else
4686                 groupadd -g $group_id $group_name
4687                 rc=${PIPESTATUS[0]}
4688         fi
4689
4690         return $rc
4691 }
4692
4693 # Check and add a test user.
4694 add_user() {
4695         local user_id=$1
4696         shift
4697         local user_name=$1
4698         shift
4699         local group_name=$1
4700         shift
4701         local home=$1
4702         shift
4703         local opts="$@"
4704         local rc=0
4705
4706         local uid=$(getent passwd $user_name | cut -d: -f3)
4707         if [[ -n "$uid" ]]; then
4708                 if [[ "$uid" -eq "$user_id" ]]; then
4709                         local dir=$(getent passwd $user_name | cut -d: -f6)
4710                         if [[ "$dir" != "$home" ]]; then
4711                                 mkdir -p $home
4712                                 usermod -d $home $user_name
4713                                 rc=${PIPESTATUS[0]}
4714                         fi
4715                 else
4716                         error_noexit "inconsistent user ID:" \
4717                                      "new: $user_id, old: $uid"
4718                         rc=1
4719                 fi
4720         else
4721                 mkdir -p $home
4722                 useradd -M -u $user_id -d $home -g $group_name $opts $user_name
4723                 rc=${PIPESTATUS[0]}
4724         fi
4725
4726         return $rc
4727 }
4728
4729 check_runas_id_ret() {
4730     local myRC=0
4731     local myRUNAS_UID=$1
4732     local myRUNAS_GID=$2
4733     shift 2
4734     local myRUNAS=$@
4735     if [ -z "$myRUNAS" ]; then
4736         error_exit "myRUNAS command must be specified for check_runas_id"
4737     fi
4738     if $GSS_KRB5; then
4739         $myRUNAS krb5_login.sh || \
4740             error "Failed to refresh Kerberos V5 TGT for UID $myRUNAS_ID."
4741     fi
4742     mkdir $DIR/d0_runas_test
4743     chmod 0755 $DIR
4744     chown $myRUNAS_UID:$myRUNAS_GID $DIR/d0_runas_test
4745     $myRUNAS touch $DIR/d0_runas_test/f$$ || myRC=$?
4746     rm -rf $DIR/d0_runas_test
4747     return $myRC
4748 }
4749
4750 check_runas_id() {
4751     local myRUNAS_UID=$1
4752     local myRUNAS_GID=$2
4753     shift 2
4754     local myRUNAS=$@
4755     check_runas_id_ret $myRUNAS_UID $myRUNAS_GID $myRUNAS || \
4756         error "unable to write to $DIR/d0_runas_test as UID $myRUNAS_UID.
4757         Please set RUNAS_ID to some UID which exists on MDS and client or
4758         add user $myRUNAS_UID:$myRUNAS_GID on these nodes."
4759 }
4760
4761 # obtain the UID/GID for MPI_USER
4762 get_mpiuser_id() {
4763     local mpi_user=$1
4764
4765     MPI_USER_UID=$(do_facet client "getent passwd $mpi_user | cut -d: -f3;
4766 exit \\\${PIPESTATUS[0]}") || error_exit "failed to get the UID for $mpi_user"
4767
4768     MPI_USER_GID=$(do_facet client "getent passwd $mpi_user | cut -d: -f4;
4769 exit \\\${PIPESTATUS[0]}") || error_exit "failed to get the GID for $mpi_user"
4770 }
4771
4772 # obtain and cache Kerberos ticket-granting ticket
4773 refresh_krb5_tgt() {
4774     local myRUNAS_UID=$1
4775     local myRUNAS_GID=$2
4776     shift 2
4777     local myRUNAS=$@
4778     if [ -z "$myRUNAS" ]; then
4779         error_exit "myRUNAS command must be specified for refresh_krb5_tgt"
4780     fi
4781
4782     CLIENTS=${CLIENTS:-$HOSTNAME}
4783     do_nodes $CLIENTS "set -x
4784 if ! $myRUNAS krb5_login.sh; then
4785     echo "Failed to refresh Krb5 TGT for UID/GID $myRUNAS_UID/$myRUNAS_GID."
4786     exit 1
4787 fi"
4788 }
4789
4790 # Run multiop in the background, but wait for it to print
4791 # "PAUSING" to its stdout before returning from this function.
4792 multiop_bg_pause() {
4793     MULTIOP_PROG=${MULTIOP_PROG:-$MULTIOP}
4794     FILE=$1
4795     ARGS=$2
4796
4797     TMPPIPE=/tmp/multiop_open_wait_pipe.$$
4798     mkfifo $TMPPIPE
4799
4800     echo "$MULTIOP_PROG $FILE v$ARGS"
4801     $MULTIOP_PROG $FILE v$ARGS > $TMPPIPE &
4802
4803     echo "TMPPIPE=${TMPPIPE}"
4804     read -t 60 multiop_output < $TMPPIPE
4805     if [ $? -ne 0 ]; then
4806         rm -f $TMPPIPE
4807         return 1
4808     fi
4809     rm -f $TMPPIPE
4810     if [ "$multiop_output" != "PAUSING" ]; then
4811         echo "Incorrect multiop output: $multiop_output"
4812         kill -9 $PID
4813         return 1
4814     fi
4815
4816     return 0
4817 }
4818
4819 do_and_time () {
4820     local cmd=$1
4821     local rc
4822
4823     SECONDS=0
4824     eval '$cmd'
4825     
4826     [ ${PIPESTATUS[0]} -eq 0 ] || rc=1
4827
4828     echo $SECONDS
4829     return $rc
4830 }
4831
4832 inodes_available () {
4833     local IFree=$($LFS df -i $MOUNT | grep ^$FSNAME | awk '{print $4}' | sort -un | head -1) || return 1
4834     echo $IFree
4835 }
4836
4837 mdsrate_inodes_available () {
4838     local min_inodes=$(inodes_available)
4839     echo $((min_inodes * 99 / 100))
4840 }
4841
4842 # reset llite stat counters
4843 clear_llite_stats(){
4844         lctl set_param -n llite.*.stats 0
4845 }
4846
4847 # sum llite stat items
4848 calc_llite_stats() {
4849         local res=$(lctl get_param -n llite.*.stats |
4850                     awk 'BEGIN {s = 0} END {print s} /^'"$1"'/ {s += $2}')
4851         echo $res
4852 }
4853
4854 # reset osc stat counters
4855 clear_osc_stats(){
4856         lctl set_param -n osc.*.osc_stats 0
4857 }
4858
4859 # sum osc stat items
4860 calc_osc_stats() {
4861         local res=$(lctl get_param -n osc.*.osc_stats |
4862                     awk 'BEGIN {s = 0} END {print s} /^'"$1"'/ {s += $2}')
4863         echo $res
4864 }
4865
4866 calc_sum () {
4867         awk 'BEGIN {s = 0}; {s += $1}; END {print s}'
4868 }
4869
4870 calc_osc_kbytes () {
4871         df $MOUNT > /dev/null
4872         $LCTL get_param -n osc.*[oO][sS][cC][-_][0-9a-f]*.$1 | calc_sum
4873 }
4874
4875 # save_lustre_params(node, parameter_mask)
4876 # generate a stream of formatted strings (<node> <param name>=<param value>)
4877 save_lustre_params() {
4878         local s
4879         do_nodesv $1 "lctl get_param $2 | while read s; do echo \\\$s; done"
4880 }
4881
4882 # restore lustre parameters from input stream, produces by save_lustre_params
4883 restore_lustre_params() {
4884         local node
4885         local name
4886         local val
4887         while IFS=" =" read node name val; do
4888                 do_node ${node//:/} "lctl set_param -n $name $val"
4889         done
4890 }
4891
4892 check_catastrophe() {
4893         local rnodes=${1:-$(comma_list $(remote_nodes_list))}
4894         local C=$CATASTROPHE
4895         [ -f $C ] && [ $(cat $C) -ne 0 ] && return 1
4896
4897         [ -z "$rnodes" ] && return 0
4898
4899         local data
4900         data=$(do_nodes "$rnodes" "rc=\\\$([ -f $C ] &&
4901                 echo \\\$(< $C) || echo 0);
4902                 if [ \\\$rc -ne 0 ]; then echo \\\$(hostname): \\\$rc; fi
4903                 exit \\\$rc")
4904         local rc=$?
4905         if [ -n "$data" ]; then
4906             echo $data
4907             return $rc
4908         fi
4909         return 0
4910 }
4911
4912 # CMD: determine mds index where directory inode presents
4913 get_mds_dir () {
4914     local dir=$1
4915     local file=$dir/f0.get_mds_dir_tmpfile
4916
4917     mkdir -p $dir
4918     rm -f $file
4919     sleep 1
4920     local iused=$(lfs df -i $dir | grep MDT | awk '{print $3}')
4921     local -a oldused=($iused)
4922
4923     openfile -f O_CREAT:O_LOV_DELAY_CREATE -m 0644 $file > /dev/null
4924     sleep 1
4925     iused=$(lfs df -i $dir | grep MDT | awk '{print $3}')
4926     local -a newused=($iused)
4927
4928     local num=0
4929     for ((i=0; i<${#newused[@]}; i++)); do
4930          if [ ${oldused[$i]} -lt ${newused[$i]} ];  then
4931              echo $(( i + 1 ))
4932              rm -f $file
4933              return 0
4934          fi
4935     done
4936     error "mdt-s : inodes count OLD ${oldused[@]} NEW ${newused[@]}"
4937 }
4938
4939 mdsrate_cleanup () {
4940         if [ -d $4 ]; then
4941                 mpi_run -np $1 ${MACHINEFILE_OPTION} $2 ${MDSRATE} --unlink \
4942                         --nfiles $3 --dir $4 --filefmt $5 $6
4943                 rmdir $4
4944         fi
4945 }
4946
4947 delayed_recovery_enabled () {
4948     local var=${SINGLEMDS}_svc
4949     do_facet $SINGLEMDS lctl get_param -n mdd.${!var}.stale_export_age > /dev/null 2>&1
4950 }
4951
4952 ########################
4953
4954 convert_facet2label() { 
4955     local facet=$1
4956
4957     if [ x$facet = xost ]; then
4958        facet=ost1
4959     fi
4960
4961     local varsvc=${facet}_svc
4962
4963     if [ -n ${!varsvc} ]; then
4964         echo ${!varsvc}
4965     else  
4966         error "No lablel for $facet!"
4967     fi
4968 }
4969
4970 get_clientosc_proc_path() {
4971     echo "${1}-osc-*"
4972 }
4973
4974 get_lustre_version () {
4975     local facet=${1:-"$SINGLEMDS"}    
4976     do_facet $facet $LCTL get_param -n version | awk '/^lustre:/ {print $2}'
4977 }
4978
4979 lustre_version_code() {
4980     local facet=${1:-"$SINGLEMDS"}
4981     version_code $(get_lustre_version $1)
4982 }
4983
4984 # If the 2.0 MDS was mounted on 1.8 device, then the OSC and LOV names
4985 # used by MDT would not be changed.
4986 # mdt lov: fsname-mdtlov
4987 # mdt osc: fsname-OSTXXXX-osc
4988 mds_on_old_device() {
4989     local mds=${1:-"$SINGLEMDS"}
4990
4991     if [ $(lustre_version_code $mds) -gt $(version_code 1.9.0) ]; then
4992         do_facet $mds "lctl list_param osc.$FSNAME-OST*-osc \
4993             > /dev/null 2>&1" && return 0
4994     fi
4995     return 1
4996 }
4997
4998 get_mdtosc_proc_path() {
4999     local mds_facet=$1
5000     local ost_label=${2:-"*OST*"}
5001
5002     [ "$mds_facet" = "mds" ] && mds_facet=$SINGLEMDS
5003     local mdt_label=$(convert_facet2label $mds_facet)
5004     local mdt_index=$(echo $mdt_label | sed -e 's/^.*-//')
5005
5006     if [ $(lustre_version_code $mds_facet) -le $(version_code 1.8.0) ] ||
5007        mds_on_old_device $mds_facet; then
5008         echo "${ost_label}-osc"
5009     else
5010         echo "${ost_label}-osc-${mdt_index}"
5011     fi
5012 }
5013
5014 get_osc_import_name() {
5015     local facet=$1
5016     local ost=$2
5017     local label=$(convert_facet2label $ost)
5018
5019     if [ "${facet:0:3}" = "mds" ]; then
5020         get_mdtosc_proc_path $facet $label
5021         return 0
5022     fi
5023
5024     get_clientosc_proc_path $label
5025     return 0
5026 }
5027
5028 _wait_import_state () {
5029     local expected=$1
5030     local CONN_PROC=$2
5031     local maxtime=${3:-$(max_recovery_time)}
5032     local CONN_STATE
5033     local i=0
5034
5035         CONN_STATE=$($LCTL get_param -n $CONN_PROC 2>/dev/null | cut -f2 | uniq)
5036     while [ "${CONN_STATE}" != "${expected}" ]; do
5037         if [ "${expected}" == "DISCONN" ]; then
5038             # for disconn we can check after proc entry is removed
5039             [ "x${CONN_STATE}" == "x" ] && return 0
5040             #  with AT enabled, we can have connect request timeout near of
5041             # reconnect timeout and test can't see real disconnect
5042             [ "${CONN_STATE}" == "CONNECTING" ] && return 0
5043         fi
5044         [ $i -ge $maxtime ] && \
5045             error "can't put import for $CONN_PROC into ${expected} state after $i sec, have ${CONN_STATE}" && \
5046             return 1
5047         sleep 1
5048         # Add uniq for multi-mount case
5049         CONN_STATE=$($LCTL get_param -n $CONN_PROC 2>/dev/null | cut -f2 | uniq)
5050         i=$(($i + 1))
5051     done
5052
5053     log "$CONN_PROC in ${CONN_STATE} state after $i sec"
5054     return 0
5055 }
5056
5057 wait_import_state() {
5058     local state=$1
5059     local params=$2
5060     local maxtime=${3:-$(max_recovery_time)}
5061     local param
5062
5063     for param in ${params//,/ }; do
5064         _wait_import_state $state $param $maxtime || return
5065     done
5066 }
5067
5068 wait_import_state_mount() {
5069         if ! is_mounted $MOUNT && ! is_mounted $MOUNT2; then
5070                 return 0
5071         fi
5072
5073         wait_import_state $*
5074 }
5075
5076 # One client request could be timed out because server was not ready
5077 # when request was sent by client.
5078 # The request timeout calculation details :
5079 # ptl_send_rpc ()
5080 #      /* We give the server rq_timeout secs to process the req, and
5081 #      add the network latency for our local timeout. */
5082 #      request->rq_deadline = request->rq_sent + request->rq_timeout +
5083 #           ptlrpc_at_get_net_latency(request) ;
5084 #
5085 # ptlrpc_connect_import ()
5086 #      request->rq_timeout = INITIAL_CONNECT_TIMEOUT
5087 #
5088 # init_imp_at () ->
5089 #   -> at_init(&at->iat_net_latency, 0, 0) -> iat_net_latency=0
5090 # ptlrpc_at_get_net_latency(request) ->
5091 #       at_get (max (iat_net_latency=0, at_min)) = at_min
5092 #
5093 # i.e.:
5094 # request->rq_timeout + ptlrpc_at_get_net_latency(request) =
5095 # INITIAL_CONNECT_TIMEOUT + at_min
5096 #
5097 # We will use obd_timeout instead of INITIAL_CONNECT_TIMEOUT
5098 # because we can not get this value in runtime,
5099 # the value depends on configure options, and it is not stored in /proc.
5100 # obd_support.h:
5101 # #define CONNECTION_SWITCH_MIN 5U
5102 # #define INITIAL_CONNECT_TIMEOUT max(CONNECTION_SWITCH_MIN,obd_timeout/20)
5103
5104 request_timeout () {
5105     local facet=$1
5106
5107     # request->rq_timeout = INITIAL_CONNECT_TIMEOUT
5108     local init_connect_timeout=$TIMEOUT
5109     [[ $init_connect_timeout -ge 5 ]] || init_connect_timeout=5
5110
5111     local at_min=$(at_get $facet at_min)
5112
5113     echo $(( init_connect_timeout + at_min ))
5114 }
5115
5116 wait_osc_import_state() {
5117     local facet=$1
5118     local ost_facet=$2
5119     local expected=$3
5120     local ost=$(get_osc_import_name $facet $ost_facet)
5121
5122         local param="osc.${ost}.ost_server_uuid"
5123         local i=0
5124
5125     # 1. wait the deadline of client 1st request (it could be skipped)
5126     # 2. wait the deadline of client 2nd request
5127     local maxtime=$(( 2 * $(request_timeout $facet)))
5128
5129         #During setup time, the osc might not be setup, it need wait
5130         #until list_param can return valid value. And also if there
5131         #are mulitple osc entries we should list all of them before
5132         #go to wait.
5133         local params=$($LCTL list_param $param || true)
5134         while [ -z "$params" ]; do
5135                 if [ $i -ge $maxtime ]; then
5136                         echo "can't get $param by list_param in $maxtime secs"
5137                         if [[ $facet != client* ]]; then
5138                                 echo "Go with $param directly"
5139                                 params=$param
5140                                 break
5141                         else
5142                                 return 1
5143                         fi
5144                 fi
5145                 sleep 1
5146                 i=$((i + 1))
5147                 params=$($LCTL list_param $param || true)
5148         done
5149
5150         if ! do_rpc_nodes "$(facet_host $facet)" \
5151                         wait_import_state $expected "$params" $maxtime; then
5152                 error "import is not in ${expected} state"
5153                 return 1
5154         fi
5155
5156         return 0
5157 }
5158
5159 get_clientmdc_proc_path() {
5160     echo "${1}-mdc-*"
5161 }
5162
5163 do_rpc_nodes () {
5164         local list=$1
5165         shift
5166
5167         [ -z "$list" ] && return 0
5168
5169         # Add paths to lustre tests for 32 and 64 bit systems.
5170         local RPATH="PATH=$RLUSTRE/tests:/usr/lib/lustre/tests:/usr/lib64/lustre/tests:$PATH"
5171         do_nodesv $list "${RPATH} NAME=${NAME} sh rpc.sh $@ "
5172 }
5173
5174 wait_clients_import_state () {
5175     local list=$1
5176     local facet=$2
5177     local expected=$3
5178
5179     local facets=$facet
5180
5181     if [ "$FAILURE_MODE" = HARD ]; then
5182         facets=$(facets_on_host $(facet_active_host $facet))
5183     fi
5184
5185     for facet in ${facets//,/ }; do
5186     local label=$(convert_facet2label $facet)
5187     local proc_path
5188     case $facet in
5189         ost* ) proc_path="osc.$(get_clientosc_proc_path $label).ost_server_uuid" ;;
5190         mds* ) proc_path="mdc.$(get_clientmdc_proc_path $label).mds_server_uuid" ;;
5191         *) error "unknown facet!" ;;
5192     esac
5193     local params=$(expand_list $params $proc_path)
5194     done
5195
5196         if ! do_rpc_nodes "$list" wait_import_state_mount $expected $params; then
5197                 error "import is not in ${expected} state"
5198                 return 1
5199         fi
5200 }
5201
5202 oos_full() {
5203         local -a AVAILA
5204         local -a GRANTA
5205         local -a TOTALA
5206         local OSCFULL=1
5207         AVAILA=($(do_nodes $(comma_list $(osts_nodes)) \
5208                   $LCTL get_param obdfilter.*.kbytesavail))
5209         GRANTA=($(do_nodes $(comma_list $(osts_nodes)) \
5210                   $LCTL get_param -n obdfilter.*.tot_granted))
5211         TOTALA=($(do_nodes $(comma_list $(osts_nodes)) \
5212                   $LCTL get_param -n obdfilter.*.kbytestotal))
5213         for ((i=0; i<${#AVAILA[@]}; i++)); do
5214                 local -a AVAIL1=(${AVAILA[$i]//=/ })
5215                 local -a TOTAL=(${TOTALA[$i]//=/ })
5216                 GRANT=$((${GRANTA[$i]}/1024))
5217                 # allow 1% of total space in bavail because of delayed
5218                 # allocation with ZFS which might release some free space after
5219                 # txg commit.  For small devices, we set a mininum of 8MB
5220                 local LIMIT=$((${TOTAL} / 100 + 8000))
5221                 echo -n $(echo ${AVAIL1[0]} | cut -d"." -f2) avl=${AVAIL1[1]} \
5222                         grnt=$GRANT diff=$((AVAIL1[1] - GRANT)) limit=${LIMIT}
5223                 [ $((AVAIL1[1] - GRANT)) -lt $LIMIT ] && OSCFULL=0 && \
5224                         echo " FULL" || echo
5225         done
5226         return $OSCFULL
5227 }
5228
5229 pool_list () {
5230    do_facet mgs lctl pool_list $1
5231 }
5232
5233 create_pool() {
5234     local fsname=${1%%.*}
5235     local poolname=${1##$fsname.}
5236
5237     do_facet mgs lctl pool_new $1
5238     local RC=$?
5239     # get param should return err unless pool is created
5240     [[ $RC -ne 0 ]] && return $RC
5241
5242     wait_update $HOSTNAME "lctl get_param -n lov.$fsname-*.pools.$poolname \
5243         2>/dev/null || echo foo" "" || RC=1
5244     if [[ $RC -eq 0 ]]; then
5245         add_pool_to_list $1
5246     else
5247         error "pool_new failed $1"
5248     fi
5249     return $RC
5250 }
5251
5252 add_pool_to_list () {
5253     local fsname=${1%%.*}
5254     local poolname=${1##$fsname.}
5255
5256     local listvar=${fsname}_CREATED_POOLS
5257     eval export ${listvar}=$(expand_list ${!listvar} $poolname)
5258 }
5259
5260 remove_pool_from_list () {
5261     local fsname=${1%%.*}
5262     local poolname=${1##$fsname.}
5263
5264     local listvar=${fsname}_CREATED_POOLS
5265     eval export ${listvar}=$(exclude_items_from_list ${!listvar} $poolname)
5266 }
5267
5268 destroy_pool_int() {
5269     local ost
5270     local OSTS=$(do_facet $SINGLEMDS lctl pool_list $1 | \
5271         awk '$1 !~ /^Pool:/ {print $1}')
5272     for ost in $OSTS; do
5273         do_facet mgs lctl pool_remove $1 $ost
5274     done
5275     do_facet mgs lctl pool_destroy $1
5276 }
5277
5278 # <fsname>.<poolname> or <poolname>
5279 destroy_pool() {
5280     local fsname=${1%%.*}
5281     local poolname=${1##$fsname.}
5282
5283     [[ x$fsname = x$poolname ]] && fsname=$FSNAME
5284
5285     local RC
5286
5287     pool_list $fsname.$poolname || return $?
5288
5289     destroy_pool_int $fsname.$poolname
5290     RC=$?
5291     [[ $RC -ne 0 ]] && return $RC
5292
5293     wait_update $HOSTNAME "lctl get_param -n lov.$fsname-*.pools.$poolname \
5294       2>/dev/null || echo foo" "foo" || RC=1
5295
5296     if [[ $RC -eq 0 ]]; then
5297         remove_pool_from_list $fsname.$poolname
5298     else
5299         error "destroy pool failed $1"
5300     fi
5301     return $RC
5302 }
5303
5304 destroy_pools () {
5305     local fsname=${1:-$FSNAME}
5306     local poolname
5307     local listvar=${fsname}_CREATED_POOLS
5308
5309     pool_list $fsname
5310
5311     [ x${!listvar} = x ] && return 0
5312
5313     echo destroy the created pools: ${!listvar}
5314     for poolname in ${!listvar//,/ }; do
5315         destroy_pool $fsname.$poolname
5316     done
5317 }
5318
5319 cleanup_pools () {
5320     local fsname=${1:-$FSNAME}
5321     trap 0
5322     destroy_pools $fsname
5323 }
5324
5325 gather_logs () {
5326     local list=$1
5327
5328     local ts=$(date +%s)
5329     local docp=true
5330
5331     if [[ ! -f "$YAML_LOG" ]]; then
5332         # init_logging is not performed before gather_logs,
5333         # so the $LOGDIR needs to be checked here
5334         check_shared_dir $LOGDIR && touch $LOGDIR/shared
5335     fi
5336
5337     [ -f $LOGDIR/shared ] && docp=false
5338
5339     # dump lustre logs, dmesg
5340
5341     prefix="$TESTLOG_PREFIX.$TESTNAME"
5342     suffix="$ts.log"
5343     echo "Dumping lctl log to ${prefix}.*.${suffix}"
5344
5345     if [ "$CLIENTONLY" -o "$PDSH" == "no_dsh" ]; then
5346         echo "Dumping logs only on local client."
5347         $LCTL dk > ${prefix}.debug_log.$(hostname -s).${suffix}
5348         dmesg > ${prefix}.dmesg.$(hostname -s).${suffix}
5349         return
5350     fi
5351
5352     do_nodesv $list \
5353         "$LCTL dk > ${prefix}.debug_log.\\\$(hostname -s).${suffix};
5354          dmesg > ${prefix}.dmesg.\\\$(hostname -s).${suffix}"
5355     if [ ! -f $LOGDIR/shared ]; then
5356         do_nodes $list rsync -az "${prefix}.*.${suffix}" $HOSTNAME:$LOGDIR
5357     fi
5358 }
5359
5360 do_ls () {
5361     local mntpt_root=$1
5362     local num_mntpts=$2
5363     local dir=$3
5364     local i
5365     local cmd
5366     local pids
5367     local rc=0
5368
5369     for i in $(seq 0 $num_mntpts); do
5370         cmd="ls -laf ${mntpt_root}$i/$dir"
5371         echo + $cmd;
5372         $cmd > /dev/null &
5373         pids="$pids $!"
5374     done
5375     echo pids=$pids
5376     for pid in $pids; do
5377         wait $pid || rc=$?
5378     done
5379
5380     return $rc
5381 }
5382
5383 # target_start_and_reset_recovery_timer()
5384 #        service_time = at_est2timeout(service_time);
5385 #        service_time += 2 * (CONNECTION_SWITCH_MAX + CONNECTION_SWITCH_INC +
5386 #                             INITIAL_CONNECT_TIMEOUT);
5387 # CONNECTION_SWITCH_MAX : min(25U, max(CONNECTION_SWITCH_MIN,obd_timeout))
5388 #define CONNECTION_SWITCH_INC 1
5389 #define INITIAL_CONNECT_TIMEOUT max(CONNECTION_SWITCH_MIN,obd_timeout/20)
5390 #define CONNECTION_SWITCH_MIN 5U
5391
5392 max_recovery_time () {
5393     local init_connect_timeout=$(( TIMEOUT / 20 ))
5394     [[ $init_connect_timeout -ge 5 ]] || init_connect_timeout=5
5395
5396     local service_time=$(( $(at_max_get client) + $(( 2 * $(( 25 + 1  + init_connect_timeout)) )) ))
5397
5398     echo $service_time 
5399 }
5400
5401 get_clients_mount_count () {
5402     local clients=${CLIENTS:-`hostname`}
5403
5404     # we need to take into account the clients mounts and
5405     # exclude mds/ost mounts if any;
5406     do_nodes $clients cat /proc/mounts | grep lustre | grep $MOUNT | wc -l
5407 }
5408
5409 # gss functions
5410 PROC_CLI="srpc_info"
5411
5412 combination()
5413 {
5414     local M=$1
5415     local N=$2
5416     local R=1
5417
5418     if [ $M -lt $N ]; then
5419         R=0
5420     else
5421         N=$((N + 1))
5422         while [ $N -lt $M ]; do
5423             R=$((R * N))
5424             N=$((N + 1))
5425         done
5426     fi
5427
5428     echo $R
5429     return 0
5430 }
5431
5432 calc_connection_cnt() {
5433     local dir=$1
5434
5435     # MDT->MDT = 2 * C(M, 2)
5436     # MDT->OST = M * O
5437     # CLI->OST = C * O
5438     # CLI->MDT = C * M
5439     comb_m2=$(combination $MDSCOUNT 2)
5440
5441     local num_clients=$(get_clients_mount_count)
5442
5443     local cnt_mdt2mdt=$((comb_m2 * 2))
5444     local cnt_mdt2ost=$((MDSCOUNT * OSTCOUNT))
5445     local cnt_cli2ost=$((num_clients * OSTCOUNT))
5446     local cnt_cli2mdt=$((num_clients * MDSCOUNT))
5447     local cnt_all2ost=$((cnt_mdt2ost + cnt_cli2ost))
5448     local cnt_all2mdt=$((cnt_mdt2mdt + cnt_cli2mdt))
5449     local cnt_all2all=$((cnt_mdt2ost + cnt_mdt2mdt + cnt_cli2ost + cnt_cli2mdt))
5450
5451     local var=cnt_$dir
5452     local res=${!var}
5453
5454     echo $res
5455 }
5456
5457 set_rule()
5458 {
5459     local tgt=$1
5460     local net=$2
5461     local dir=$3
5462     local flavor=$4
5463     local cmd="$tgt.srpc.flavor"
5464
5465     if [ $net == "any" ]; then
5466         net="default"
5467     fi
5468     cmd="$cmd.$net"
5469
5470     if [ $dir != "any" ]; then
5471         cmd="$cmd.$dir"
5472     fi
5473
5474     cmd="$cmd=$flavor"
5475     log "Setting sptlrpc rule: $cmd"
5476     do_facet mgs "$LCTL conf_param $cmd"
5477 }
5478
5479 count_flvr()
5480 {
5481     local output=$1
5482     local flavor=$2
5483     local count=0
5484
5485     rpc_flvr=`echo $flavor | awk -F - '{ print $1 }'`
5486     bulkspec=`echo $flavor | awk -F - '{ print $2 }'`
5487
5488     count=`echo "$output" | grep "rpc flavor" | grep $rpc_flvr | wc -l`
5489
5490     if [ "x$bulkspec" != "x" ]; then
5491         algs=`echo $bulkspec | awk -F : '{ print $2 }'`
5492
5493         if [ "x$algs" != "x" ]; then
5494             bulk_count=`echo "$output" | grep "bulk flavor" | grep $algs | wc -l`
5495         else
5496             bulk=`echo $bulkspec | awk -F : '{ print $1 }'`
5497             if [ $bulk == "bulkn" ]; then
5498                 bulk_count=`echo "$output" | grep "bulk flavor" \
5499                             | grep "null/null" | wc -l`
5500             elif [ $bulk == "bulki" ]; then
5501                 bulk_count=`echo "$output" | grep "bulk flavor" \
5502                             | grep "/null" | grep -v "null/" | wc -l`
5503             else
5504                 bulk_count=`echo "$output" | grep "bulk flavor" \
5505                             | grep -v "/null" | grep -v "null/" | wc -l`
5506             fi
5507         fi
5508
5509         [ $bulk_count -lt $count ] && count=$bulk_count
5510     fi
5511
5512     echo $count
5513 }
5514
5515 flvr_cnt_cli2mdt()
5516 {
5517     local flavor=$1
5518     local cnt
5519
5520     local clients=${CLIENTS:-`hostname`}
5521
5522     for c in ${clients//,/ }; do
5523         output=`do_node $c lctl get_param -n mdc.*-MDT*-mdc-*.$PROC_CLI 2>/dev/null`
5524         tmpcnt=`count_flvr "$output" $flavor`
5525         cnt=$((cnt + tmpcnt))
5526     done
5527     echo $cnt
5528 }
5529
5530 flvr_cnt_cli2ost()
5531 {
5532     local flavor=$1
5533     local cnt
5534
5535     local clients=${CLIENTS:-`hostname`}
5536
5537     for c in ${clients//,/ }; do
5538         output=`do_node $c lctl get_param -n osc.*OST*-osc-[^M][^D][^T]*.$PROC_CLI 2>/dev/null`
5539         tmpcnt=`count_flvr "$output" $flavor`
5540         cnt=$((cnt + tmpcnt))
5541     done
5542     echo $cnt
5543 }
5544
5545 flvr_cnt_mdt2mdt()
5546 {
5547     local flavor=$1
5548     local cnt=0
5549
5550     if [ $MDSCOUNT -le 1 ]; then
5551         echo 0
5552         return
5553     fi
5554
5555     for num in `seq $MDSCOUNT`; do
5556         output=`do_facet mds$num lctl get_param -n mdc.*-MDT*-mdc[0-9]*.$PROC_CLI 2>/dev/null`
5557         tmpcnt=`count_flvr "$output" $flavor`
5558         cnt=$((cnt + tmpcnt))
5559     done
5560     echo $cnt;
5561 }
5562
5563 flvr_cnt_mdt2ost()
5564 {
5565     local flavor=$1
5566     local cnt=0
5567     local mdtosc
5568
5569     for num in `seq $MDSCOUNT`; do
5570         mdtosc=$(get_mdtosc_proc_path mds$num)
5571         mdtosc=${mdtosc/-MDT*/-MDT\*}
5572         output=$(do_facet mds$num lctl get_param -n \
5573             osc.$mdtosc.$PROC_CLI 2>/dev/null)
5574         tmpcnt=`count_flvr "$output" $flavor`
5575         cnt=$((cnt + tmpcnt))
5576     done
5577     echo $cnt;
5578 }
5579
5580 flvr_cnt_mgc2mgs()
5581 {
5582     local flavor=$1
5583
5584     output=`do_facet client lctl get_param -n mgc.*.$PROC_CLI 2>/dev/null`
5585     count_flvr "$output" $flavor
5586 }
5587
5588 do_check_flavor()
5589 {
5590     local dir=$1        # from to
5591     local flavor=$2     # flavor expected
5592     local res=0
5593
5594     if [ $dir == "cli2mdt" ]; then
5595         res=`flvr_cnt_cli2mdt $flavor`
5596     elif [ $dir == "cli2ost" ]; then
5597         res=`flvr_cnt_cli2ost $flavor`
5598     elif [ $dir == "mdt2mdt" ]; then
5599         res=`flvr_cnt_mdt2mdt $flavor`
5600     elif [ $dir == "mdt2ost" ]; then
5601         res=`flvr_cnt_mdt2ost $flavor`
5602     elif [ $dir == "all2ost" ]; then
5603         res1=`flvr_cnt_mdt2ost $flavor`
5604         res2=`flvr_cnt_cli2ost $flavor`
5605         res=$((res1 + res2))
5606     elif [ $dir == "all2mdt" ]; then
5607         res1=`flvr_cnt_mdt2mdt $flavor`
5608         res2=`flvr_cnt_cli2mdt $flavor`
5609         res=$((res1 + res2))
5610     elif [ $dir == "all2all" ]; then
5611         res1=`flvr_cnt_mdt2ost $flavor`
5612         res2=`flvr_cnt_cli2ost $flavor`
5613         res3=`flvr_cnt_mdt2mdt $flavor`
5614         res4=`flvr_cnt_cli2mdt $flavor`
5615         res=$((res1 + res2 + res3 + res4))
5616     fi
5617
5618     echo $res
5619 }
5620
5621 wait_flavor()
5622 {
5623     local dir=$1        # from to
5624     local flavor=$2     # flavor expected
5625     local expect=${3:-$(calc_connection_cnt $dir)}     # number expected
5626
5627     local res=0
5628
5629     for ((i=0;i<20;i++)); do
5630         echo -n "checking $dir..."
5631         res=$(do_check_flavor $dir $flavor)
5632         echo "found $res/$expect $flavor connections"
5633         [ $res -ge $expect ] && return 0
5634         sleep 4
5635     done
5636
5637     echo "Error checking $flavor of $dir: expect $expect, actual $res"
5638     return 1
5639 }
5640
5641 restore_to_default_flavor()
5642 {
5643     local proc="mgs.MGS.live.$FSNAME"
5644
5645     echo "restoring to default flavor..."
5646
5647     nrule=`do_facet mgs lctl get_param -n $proc 2>/dev/null | grep ".srpc.flavor." | wc -l`
5648
5649     # remove all existing rules if any
5650     if [ $nrule -ne 0 ]; then
5651         echo "$nrule existing rules"
5652         for rule in `do_facet mgs lctl get_param -n $proc 2>/dev/null | grep ".srpc.flavor."`; do
5653             echo "remove rule: $rule"
5654             spec=`echo $rule | awk -F = '{print $1}'`
5655             do_facet mgs "$LCTL conf_param -d $spec"
5656         done
5657     fi
5658
5659     # verify no rules left
5660     nrule=`do_facet mgs lctl get_param -n $proc 2>/dev/null | grep ".srpc.flavor." | wc -l`
5661     [ $nrule -ne 0 ] && error "still $nrule rules left"
5662
5663     # wait for default flavor to be applied
5664     # currently default flavor for all connections are 'null'
5665     wait_flavor all2all null
5666     echo "now at default flavor settings"
5667 }
5668
5669 set_flavor_all()
5670 {
5671     local flavor=${1:-null}
5672
5673     echo "setting all flavor to $flavor"
5674
5675     # FIXME need parameter to this fn
5676     # and remove global vars
5677     local cnt_all2all=$(calc_connection_cnt all2all)
5678
5679     local res=$(do_check_flavor all2all $flavor)
5680     if [ $res -eq $cnt_all2all ]; then
5681         echo "already have total $res $flavor connections"
5682         return
5683     fi
5684
5685     echo "found $res $flavor out of total $cnt_all2all connections"
5686     restore_to_default_flavor
5687
5688     [[ $flavor = null ]] && return 0
5689
5690     set_rule $FSNAME any any $flavor
5691     wait_flavor all2all $flavor
5692 }
5693
5694
5695 check_logdir() {
5696     local dir=$1
5697     # Checking for shared logdir
5698     if [ ! -d $dir ]; then
5699         # Not found. Create local logdir
5700         mkdir -p $dir
5701     else
5702         touch $dir/check_file.$(hostname -s)
5703     fi
5704     return 0
5705 }
5706
5707 check_write_access() {
5708     local dir=$1
5709     local node
5710     local file
5711
5712     for node in $(nodes_list); do
5713         file=$dir/check_file.$(short_hostname $node)
5714         if [[ ! -f "$file" ]]; then
5715             # Logdir not accessible/writable from this node.
5716             return 1
5717         fi
5718         rm -f $file || return 1
5719     done
5720     return 0
5721 }
5722
5723 init_logging() {
5724     if [[ -n $YAML_LOG ]]; then
5725         return
5726     fi
5727     local SAVE_UMASK=`umask`
5728     umask 0000
5729
5730     export YAML_LOG=${LOGDIR}/results.yml
5731     mkdir -p $LOGDIR
5732     init_clients_lists
5733
5734     if [ ! -f $YAML_LOG ]; then       # If the yaml log already exists then we will just append to it
5735       if check_shared_dir $LOGDIR; then
5736           touch $LOGDIR/shared
5737           echo "Logging to shared log directory: $LOGDIR"
5738       else
5739           echo "Logging to local directory: $LOGDIR"
5740       fi
5741
5742       yml_nodes_file $LOGDIR >> $YAML_LOG
5743       yml_results_file >> $YAML_LOG
5744     fi
5745
5746     umask $SAVE_UMASK
5747 }
5748
5749 log_test() {
5750     yml_log_test $1 >> $YAML_LOG
5751 }
5752
5753 log_test_status() {
5754      yml_log_test_status $@ >> $YAML_LOG
5755 }
5756
5757 log_sub_test_begin() {
5758     yml_log_sub_test_begin "$@" >> $YAML_LOG
5759 }
5760
5761 log_sub_test_end() {
5762     yml_log_sub_test_end "$@" >> $YAML_LOG
5763 }
5764
5765 run_llverdev()
5766 {
5767         local dev=$1
5768         local llverdev_opts=$2
5769         local devname=$(basename $1)
5770         local size=$(grep "$devname"$ /proc/partitions | awk '{print $3}')
5771         # loop devices aren't in /proc/partitions
5772         [ "x$size" == "x" ] && local size=$(ls -l $dev | awk '{print $5}')
5773
5774         size=$(($size / 1024 / 1024)) # Gb
5775
5776         local partial_arg=""
5777         # Run in partial (fast) mode if the size
5778         # of a partition > 1 GB
5779         [ $size -gt 1 ] && partial_arg="-p"
5780
5781         llverdev --force $partial_arg $llverdev_opts $dev
5782 }
5783
5784 run_llverfs()
5785 {
5786         local dir=$1
5787         local llverfs_opts=$2
5788         local use_partial_arg=$3
5789         local partial_arg=""
5790         local size=$(df -B G $dir |tail -n 1 |awk '{print $2}' |sed 's/G//') #GB
5791
5792         # Run in partial (fast) mode if the size
5793         # of a partition > 1 GB
5794         [ "x$use_partial_arg" != "xno" ] && [ $size -gt 1 ] && partial_arg="-p"
5795
5796         llverfs $partial_arg $llverfs_opts $dir
5797 }
5798
5799 remove_mdt_files() {
5800         local facet=$1
5801         local mdtdev=$2
5802         shift 2
5803         local files="$@"
5804         local mntpt=$(facet_mntpt $facet)
5805         local opts=$MDS_MOUNT_OPTS
5806
5807         echo "removing files from $mdtdev on $facet: $files"
5808         if [ $(facet_fstype $facet) == ldiskfs ] &&
5809            ! do_facet $facet test -b $mdtdev; then
5810                 opts=$(csa_add "$opts" -o loop)
5811         fi
5812         mount -t $(facet_fstype $facet) $opts $mdtdev $mntpt ||
5813                 return $?
5814         rc=0;
5815         for f in $files; do
5816                 rm $mntpt/ROOT/$f || { rc=$?; break; }
5817         done
5818         umount -f $mntpt || return $?
5819         return $rc
5820 }
5821
5822 duplicate_mdt_files() {
5823         local facet=$1
5824         local mdtdev=$2
5825         shift 2
5826         local files="$@"
5827         local mntpt=$(facet_mntpt $facet)
5828         local opts=$MDS_MOUNT_OPTS
5829
5830         echo "duplicating files on $mdtdev on $facet: $files"
5831         mkdir -p $mntpt || return $?
5832         if [ $(facet_fstype $facet) == ldiskfs ] &&
5833            ! do_facet $facet test -b $mdtdev; then
5834                 opts=$(csa_add "$opts" -o loop)
5835         fi
5836         mount -t $(facet_fstype $facet) $opts $mdtdev $mntpt ||
5837                 return $?
5838
5839     do_umount() {
5840         trap 0
5841         popd > /dev/null
5842         rm $tmp
5843         umount -f $mntpt
5844     }
5845     trap do_umount EXIT
5846
5847     tmp=$(mktemp $TMP/setfattr.XXXXXXXXXX)
5848     pushd $mntpt/ROOT > /dev/null || return $?
5849     rc=0
5850     for f in $files; do
5851         touch $f.bad || return $?
5852         getfattr -n trusted.lov $f | sed "s#$f#&.bad#" > $tmp
5853         rc=${PIPESTATUS[0]}
5854         [ $rc -eq 0 ] || return $rc
5855         setfattr --restore $tmp || return $?
5856     done
5857     do_umount
5858 }
5859
5860 run_sgpdd () {
5861     local devs=${1//,/ }
5862     shift
5863     local params=$@
5864     local rslt=$TMP/sgpdd_survey
5865
5866     # sgpdd-survey cleanups ${rslt}.* files
5867
5868     local cmd="rslt=$rslt $params scsidevs=\"$devs\" $SGPDDSURVEY"
5869     echo + $cmd
5870     eval $cmd
5871     cat ${rslt}.detail
5872 }
5873
5874 # returns the canonical name for an ldiskfs device
5875 ldiskfs_canon() {
5876         local dev="$1"
5877         local facet="$2"
5878
5879         do_facet $facet "dv=\\\$(lctl get_param -n $dev);
5880 if foo=\\\$(lvdisplay -c \\\$dv 2>/dev/null); then
5881     echo dm-\\\${foo##*:};
5882 else
5883     echo \\\$(basename \\\$dv);
5884 fi;"
5885 }
5886
5887 is_sanity_benchmark() {
5888     local benchmarks="dbench bonnie iozone fsx"
5889     local suite=$1
5890     for b in $benchmarks; do
5891         if [ "$b" == "$suite" ]; then
5892             return 0
5893         fi
5894     done
5895     return 1
5896 }
5897
5898 min_ost_size () {
5899     $LCTL get_param -n osc.*.kbytesavail | sort -n | head -n1
5900 }
5901
5902 # Get the block size of the filesystem.
5903 get_block_size() {
5904     local facet=$1
5905     local device=$2
5906     local size
5907
5908     size=$(do_facet $facet "$DUMPE2FS -h $device 2>&1" |
5909            awk '/^Block size:/ {print $3}')
5910     echo $size
5911 }
5912
5913 # Check whether the "large_xattr" feature is enabled or not.
5914 large_xattr_enabled() {
5915         [[ $(facet_fstype $SINGLEMDS) == zfs ]] && return 0
5916
5917         local mds_dev=$(mdsdevname ${SINGLEMDS//mds/})
5918
5919         do_facet $SINGLEMDS "$DUMPE2FS -h $mds_dev 2>&1 | grep -q large_xattr"
5920         return ${PIPESTATUS[0]}
5921 }
5922
5923 # Get the maximum xattr size supported by the filesystem.
5924 max_xattr_size() {
5925     local size
5926
5927     if large_xattr_enabled; then
5928         # include/linux/limits.h: #define XATTR_SIZE_MAX 65536
5929         size=65536
5930     else
5931         local mds_dev=$(mdsdevname ${SINGLEMDS//mds/})
5932         local block_size=$(get_block_size $SINGLEMDS $mds_dev)
5933
5934         # maximum xattr size = size of block - size of header -
5935         #                      size of 1 entry - 4 null bytes
5936         size=$((block_size - 32 - 32 - 4))
5937     fi
5938
5939     echo $size
5940 }
5941
5942 # Dump the value of the named xattr from a file.
5943 get_xattr_value() {
5944     local xattr_name=$1
5945     local file=$2
5946
5947     echo "$(getfattr -n $xattr_name --absolute-names --only-values $file)"
5948 }
5949
5950 # Generate a string with size of $size bytes.
5951 generate_string() {
5952     local size=${1:-1024} # in bytes
5953
5954     echo "$(head -c $size < /dev/zero | tr '\0' y)"
5955 }
5956
5957 reformat_external_journal() {
5958         if [ ! -z ${EJOURNAL} ]; then
5959                 local rcmd="do_facet ${SINGLEMDS}"
5960
5961                 echo "reformat external journal on ${SINGLEMDS}:${EJOURNAL}"
5962                 ${rcmd} mke2fs -O journal_dev ${EJOURNAL} || return 1
5963         fi
5964 }
5965
5966 # MDT file-level backup/restore
5967 mds_backup_restore() {
5968         local devname=$(mdsdevname ${SINGLEMDS//mds/})
5969         local mntpt=$(facet_mntpt brpt)
5970         local rcmd="do_facet ${SINGLEMDS}"
5971         local metaea=${TMP}/backup_restore.ea
5972         local metadata=${TMP}/backup_restore.tgz
5973         local opts=${MDS_MOUNT_OPTS}
5974         local svc=${SINGLEMDS}_svc
5975         local igif=$1
5976
5977         if ! ${rcmd} test -b ${devname}; then
5978                 opts=$(csa_add "$opts" -o loop)
5979         fi
5980
5981         echo "file-level backup/restore on ${SINGLEMDS}:${devname}"
5982
5983         # step 1: build mount point
5984         ${rcmd} mkdir -p $mntpt
5985         # step 2: cleanup old backup
5986         ${rcmd} rm -f $metaea $metadata
5987         # step 3: mount dev
5988         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 1
5989         if [ ! -z $igif ]; then
5990                 # step 3.5: rm .lustre
5991                 ${rcmd} rm -rf $mntpt/ROOT/.lustre || return 1
5992         fi
5993         # step 4: backup metaea
5994         echo "backup EA"
5995         ${rcmd} "cd $mntpt && getfattr -R -d -m '.*' -P . > $metaea && cd -" ||
5996                 return 2
5997         # step 5: backup metadata
5998         echo "backup data"
5999         ${rcmd} tar zcf $metadata -C $mntpt/ . > /dev/null 2>&1 || return 3
6000         # step 6: umount
6001         ${rcmd} umount -d $mntpt || return 4
6002         # step 7: reformat external journal if needed
6003         reformat_external_journal || return 5
6004         # step 8: reformat dev
6005         echo "reformat new device"
6006         add ${SINGLEMDS} $(mkfs_opts ${SINGLEMDS}) --backfstype ldiskfs \
6007                 --reformat $devname > /dev/null || return 6
6008         # step 9: mount dev
6009         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 7
6010         # step 10: restore metadata
6011         echo "restore data"
6012         ${rcmd} tar zxfp $metadata -C $mntpt > /dev/null 2>&1 || return 8
6013         # step 11: restore metaea
6014         echo "restore EA"
6015         ${rcmd} "cd $mntpt && setfattr --restore=$metaea && cd - " || return 9
6016         # step 12: remove recovery logs
6017         echo "remove recovery logs"
6018         ${rcmd} rm -fv $mntpt/OBJECTS/* $mntpt/CATALOGS
6019         # step 13: umount dev
6020         ${rcmd} umount -d $mntpt || return 10
6021         # step 14: cleanup tmp backup
6022         ${rcmd} rm -f $metaea $metadata
6023         # step 15: reset device label - it's not virgin on
6024         ${rcmd} e2label $devname ${!svc}
6025 }
6026
6027 # remove OI files
6028 mds_remove_ois() {
6029         local devname=$(mdsdevname ${SINGLEMDS//mds/})
6030         local mntpt=$(facet_mntpt brpt)
6031         local rcmd="do_facet ${SINGLEMDS}"
6032         local idx=$1
6033         local opts=${MDS_MOUNT_OPTS}
6034
6035         if ! ${rcmd} test -b ${devname}; then
6036                 opts=$(csa_add "$opts" -o loop)
6037         fi
6038
6039         echo "remove OI files: idx=${idx}"
6040
6041         # step 1: build mount point
6042         ${rcmd} mkdir -p $mntpt
6043         # step 2: mount dev
6044         ${rcmd} mount -t ldiskfs $opts $devname $mntpt || return 1
6045         if [ -z $idx ]; then
6046                 # step 3: remove all OI files
6047                 ${rcmd} rm -fv $mntpt/oi.16*
6048         elif [ $idx -lt 2 ]; then
6049                 ${rcmd} rm -fv $mntpt/oi.16.${idx}
6050         else
6051                 local i
6052
6053                 # others, rm oi.16.[idx, idx * idx, idx ** ...]
6054                 for ((i=${idx}; i<64; i=$((i * idx)))); do
6055                         ${rcmd} rm -fv $mntpt/oi.16.${i}
6056                 done
6057         fi
6058         # step 4: umount
6059         ${rcmd} umount -d $mntpt || return 2
6060         # OI files will be recreated when mounted as lustre next time.
6061 }
6062
6063 # generate maloo upload-able log file name
6064 # \param logname specify unique part of file name
6065 generate_logname() {
6066         local logname=${1:-"default_logname"}
6067
6068         echo "$TESTLOG_PREFIX.$TESTNAME.$logname.$(hostname -s).log"
6069 }
6070
6071 # mkdir directory on different MDTs
6072 test_mkdir() {
6073         local option
6074         local parent
6075         local child
6076         local path
6077         local dir
6078         local rc=0
6079
6080         if [ $# -eq 2 ]; then
6081                 option=$1
6082                 path=$2
6083         else
6084                 path=$1
6085         fi
6086
6087         child=${path##*/}
6088         parent=${path%/*}
6089
6090         if [ "$parent" == "$child" ]; then
6091                 parent=$(pwd)
6092         fi
6093
6094         if [ "$option" == "-p" -a -d ${parent}/${child} ]; then
6095                 return $rc
6096         fi
6097
6098         # it needs to check whether there is further / in child
6099         dir=$(echo $child | awk -F '/' '{print $2}')
6100         if [ ! -z "$dir" ]; then
6101                 local subparent=$(echo $child | awk -F '/' '{ print $1 }')
6102                 parent=${parent}"/"${subparent}
6103                 child=$dir
6104         fi
6105
6106         if [ ! -d ${parent} ]; then
6107                 if [ "$option" == "-p" ]; then
6108                         mkdir -p ${parent}
6109                 else
6110                         return 1
6111                 fi
6112         fi
6113
6114         if [ $MDSCOUNT -le 1 ]; then
6115                 mkdir $option ${parent}/${child} || rc=$?
6116         else
6117                 local mdt_idx=$($LFS getstripe -M $parent)
6118
6119                 if [ "$mdt_idx" -ne 0 ]; then
6120                         mkdir $option ${parent}/${child} || rc=$?
6121                         return $rc
6122                 fi
6123
6124                 local test_num=$(echo $testnum | sed -e 's/[^0-9]*//g')
6125                 local mdt_idx=$((test_num % MDSCOUNT))
6126                 echo "mkdir $mdt_idx for ${parent}/${child}"
6127                 $LFS setdirstripe -i $mdt_idx ${parent}/${child} || rc=$?
6128         fi
6129         return $rc
6130 }