Whamcloud - gitweb
32dbc8764fc428fa0199af23761e801d61d24940
[fs/lustre-release.git] / lustre / tests / test-framework.sh
1 #!/bin/bash
2
3 trap 'print_summary && print_stack_trace | tee $TF_FAIL && \
4     echo "$TESTSUITE: FAIL: test-framework exiting on error"' ERR
5 set -e
6
7 export LANG=en_US
8 export REFORMAT=${REFORMAT:-""}
9 export WRITECONF=${WRITECONF:-""}
10 export VERBOSE=${VERBOSE:-false}
11 export GSS=${GSS:-false}
12 export GSS_SK=${GSS_SK:-false}
13 export GSS_KRB5=false
14 export GSS_PIPEFS=false
15 export SHARED_KEY=${SHARED_KEY:-false}
16 export SK_PATH=${SK_PATH:-/tmp/test-framework-keys}
17 export SK_OM_PATH=$SK_PATH'/tmp-request-mount'
18 export SK_MOUNTED=${SK_MOUNTED:-false}
19 export SK_FLAVOR=${SK_FLAVOR:-ski}
20 export SK_NO_KEY=${SK_NO_KEY:-true}
21 export SK_UNIQUE_NM=${SK_UNIQUE_NM:-false}
22 export SK_S2S=${SK_S2S:-false}
23 export SK_S2SNM=${SK_S2SNM:-TestFrameNM}
24 export SK_S2SNMCLI=${SK_S2SNMCLI:-TestFrameNMCli}
25 export SK_SKIPFIRST=${SK_SKIPFIRST:-true}
26 export IDENTITY_UPCALL=default
27 export QUOTA_AUTO=1
28 export FLAKEY=${FLAKEY:-true}
29 # specify environment variable containing batch job name for server statistics
30 export JOBID_VAR=${JOBID_VAR:-"procname_uid"}  # or "existing" or "disable"
31
32 #export PDSH="pdsh -S -Rssh -w"
33 export MOUNT_CMD=${MOUNT_CMD:-"mount -t lustre"}
34 export UMOUNT=${UMOUNT:-"umount -d"}
35
36 export LSNAPSHOT_CONF="/etc/ldev.conf"
37 export LSNAPSHOT_LOG="/var/log/lsnapshot.log"
38
39 # sles12 umount has a issue with -d option
40 [ -e /etc/SuSE-release ] && grep -w VERSION /etc/SuSE-release | grep -wq 12 && {
41         export UMOUNT="umount"
42 }
43
44 # function used by scripts run on remote nodes
45 LUSTRE=${LUSTRE:-$(cd $(dirname $0)/..; echo $PWD)}
46 . $LUSTRE/tests/functions.sh
47 . $LUSTRE/tests/yaml.sh
48
49 export LD_LIBRARY_PATH=${LUSTRE}/utils/.libs:${LUSTRE}/utils:${LD_LIBRARY_PATH}
50
51 LUSTRE_TESTS_CFG_DIR=${LUSTRE_TESTS_CFG_DIR:-${LUSTRE}/tests/cfg}
52
53 EXCEPT_LIST_FILE=${EXCEPT_LIST_FILE:-${LUSTRE_TESTS_CFG_DIR}/tests-to-skip.sh}
54
55 if [ -f "$EXCEPT_LIST_FILE" ]; then
56     echo "Reading test skip list from $EXCEPT_LIST_FILE"
57     cat $EXCEPT_LIST_FILE
58     . $EXCEPT_LIST_FILE
59 fi
60
61 # check config files for options in decreasing order of preference
62 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/lustre.conf ] &&
63     MODPROBECONF=/etc/modprobe.d/lustre.conf
64 [ -z "$MODPROBECONF" -a -f /etc/modprobe.d/Lustre ] &&
65     MODPROBECONF=/etc/modprobe.d/Lustre
66 [ -z "$MODPROBECONF" -a -f /etc/modprobe.conf ] &&
67     MODPROBECONF=/etc/modprobe.conf
68
69 sanitize_parameters() {
70         for i in DIR DIR1 DIR2 MOUNT MOUNT1 MOUNT2
71         do
72                 local path=${!i}
73                 if [ -d "$path" ]; then
74                         eval export $i=$(echo $path | sed -r 's/\/+$//g')
75                 fi
76         done
77 }
78 assert_DIR () {
79         local failed=""
80         [[ $DIR/ = $MOUNT/* ]] ||
81                 { failed=1 && echo "DIR=$DIR not in $MOUNT. Aborting."; }
82         [[ $DIR1/ = $MOUNT1/* ]] ||
83                 { failed=1 && echo "DIR1=$DIR1 not in $MOUNT1. Aborting."; }
84         [[ $DIR2/ = $MOUNT2/* ]] ||
85                 { failed=1 && echo "DIR2=$DIR2 not in $MOUNT2. Aborting"; }
86
87         [ -n "$failed" ] && exit 99 || true
88 }
89
90 usage() {
91     echo "usage: $0 [-r] [-f cfgfile]"
92     echo "       -r: reformat"
93
94     exit
95 }
96
97 print_summary () {
98         trap 0
99         [ -z "$DEFAULT_SUITES" ] && return 0
100         [ -n "$ONLY" ] && echo "WARNING: ONLY is set to $(echo $ONLY)"
101         local details
102         local form="%-13s %-17s %-9s %s %s\n"
103
104         printf "$form" "status" "script" "Total(sec)" "E(xcluded) S(low)"
105         echo "---------------------------------------------------------------"
106     for O in $DEFAULT_SUITES; do
107         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
108         [ "${!O}" = "no" ] && continue || true
109         local o=$(echo $O  | tr "[:upper:]_" "[:lower:]-")
110         local log=${TMP}/${o}.log
111         if is_sanity_benchmark $o; then
112             log=${TMP}/sanity-benchmark.log
113         fi
114         local slow=
115         local skipped=
116         local total=
117         local status=Unfinished
118         if [ -f $log ]; then
119                 skipped=$(grep excluded $log | awk '{ printf " %s", $3 }' |
120                         sed 's/test_//g')
121                 slow=$(egrep "^PASS|^FAIL" $log | tr -d "("| sed s/s\)$//g |
122                         sort -nr -k 3  | head -n5 |  awk '{ print $2":"$3"s" }')
123                 total=$(grep duration $log | awk '{ print $2 }')
124                 if [ "${!O}" = "done" ]; then
125                         status=Done
126                 fi
127                 if $DDETAILS; then
128                         local durations=$(egrep "^PASS|^FAIL" $log |
129                                 tr -d "("| sed s/s\)$//g |
130                                 awk '{ print $2":"$3"|" }')
131                         details=$(printf "%s\n%s %s %s\n" "$details" \
132                                 "DDETAILS" "$O" "$(echo $durations)")
133                 fi
134         fi
135         printf "$form" $status "$O" "${total}" "E=$skipped"
136         printf "$form" "-" "-" "-" "S=$(echo $slow)"
137     done
138
139     for O in $DEFAULT_SUITES; do
140         O=$(echo $O  | tr "-" "_" | tr "[:lower:]" "[:upper:]")
141         if [ "${!O}" = "no" ]; then
142             printf "$form" "Skipped" "$O" ""
143         fi
144     done
145
146     # print the detailed tests durations if DDETAILS=true
147     if $DDETAILS; then
148         echo "$details"
149     fi
150 }
151
152 # Get information about the Lustre environment. The information collected
153 # will be used in Lustre tests.
154 # usage: get_lustre_env
155 # input: No required or optional arguments
156 # output: No return values, environment variables are exported
157
158 get_lustre_env() {
159
160         export mds1_FSTYPE=${mds1_FSTYPE:-$(facet_fstype mds1)}
161         export ost1_FSTYPE=${ost1_FSTYPE:-$(facet_fstype ost1)}
162
163         export MGS_VERSION=$(lustre_version_code mgs)
164         export MDS1_VERSION=$(lustre_version_code mds1)
165         export OST1_VERSION=$(lustre_version_code ost1)
166         export CLIENT_VERSION=$(lustre_version_code client)
167
168         # Prefer using "mds1" directly instead of SINGLEMDS.
169         # Keep this for compat until it is removed from scripts.
170         export SINGLEMDS=${SINGLEMDS:-mds1}
171 }
172
173 init_test_env() {
174         export LUSTRE=$(absolute_path $LUSTRE)
175         export TESTSUITE=$(basename $0 .sh)
176         export TEST_FAILED=false
177         export FAIL_ON_SKIP_ENV=${FAIL_ON_SKIP_ENV:-false}
178         export RPC_MODE=${RPC_MODE:-false}
179         export DO_CLEANUP=${DO_CLEANUP:-true}
180         export KEEP_ZPOOL=${KEEP_ZPOOL:-false}
181         export CLEANUP_DM_DEV=false
182         export PAGE_SIZE=$(get_page_size client)
183
184         export MKE2FS=$MKE2FS
185         if [ -z "$MKE2FS" ]; then
186                 if which mkfs.ldiskfs >/dev/null 2>&1; then
187                         export MKE2FS=mkfs.ldiskfs
188                 else
189                         export MKE2FS=mke2fs
190                 fi
191         fi
192
193         export DEBUGFS=$DEBUGFS
194         if [ -z "$DEBUGFS" ]; then
195                 if which debugfs.ldiskfs >/dev/null 2>&1; then
196                         export DEBUGFS=debugfs.ldiskfs
197                 else
198                         export DEBUGFS=debugfs
199                 fi
200         fi
201
202         export TUNE2FS=$TUNE2FS
203         if [ -z "$TUNE2FS" ]; then
204                 if which tunefs.ldiskfs >/dev/null 2>&1; then
205                         export TUNE2FS=tunefs.ldiskfs
206                 else
207                         export TUNE2FS=tune2fs
208                 fi
209         fi
210
211         export E2LABEL=$E2LABEL
212         if [ -z "$E2LABEL" ]; then
213                 if which label.ldiskfs >/dev/null 2>&1; then
214                         export E2LABEL=label.ldiskfs
215                 else
216                         export E2LABEL=e2label
217                 fi
218         fi
219
220         export DUMPE2FS=$DUMPE2FS
221         if [ -z "$DUMPE2FS" ]; then
222                 if which dumpfs.ldiskfs >/dev/null 2>&1; then
223                         export DUMPE2FS=dumpfs.ldiskfs
224                 else
225                         export DUMPE2FS=dumpe2fs
226                 fi
227         fi
228
229         export E2FSCK=$E2FSCK
230         if [ -z "$E2FSCK" ]; then
231                 if which fsck.ldiskfs >/dev/null 2>&1; then
232                         export E2FSCK=fsck.ldiskfs
233                 else
234                          export E2FSCK=e2fsck
235                 fi
236         fi
237
238         export RESIZE2FS=$RESIZE2FS
239         if [ -z "$RESIZE2FS" ]; then
240                 if which resizefs.ldiskfs >/dev/null 2>&1; then
241                         export RESIZE2FS=resizefs.ldiskfs
242                 else
243                         export RESIZE2FS=resize2fs
244                 fi
245         fi
246
247         export LFSCK_ALWAYS=${LFSCK_ALWAYS:-"no"} # check fs after test suite
248         export FSCK_MAX_ERR=4   # File system errors left uncorrected
249
250         export ZFS=${ZFS:-zfs}
251         export ZPOOL=${ZPOOL:-zpool}
252         export ZDB=${ZDB:-zdb}
253         export PARTPROBE=${PARTPROBE:-partprobe}
254
255         #[ -d /r ] && export ROOT=${ROOT:-/r}
256         export TMP=${TMP:-$ROOT/tmp}
257         export TESTSUITELOG=${TMP}/${TESTSUITE}.log
258         export LOGDIR=${LOGDIR:-${TMP}/test_logs/$(date +%s)}
259         export TESTLOG_PREFIX=$LOGDIR/$TESTSUITE
260
261         export HOSTNAME=${HOSTNAME:-$(hostname -s)}
262         if ! echo $PATH | grep -q $LUSTRE/utils; then
263                 export PATH=$LUSTRE/utils:$PATH
264         fi
265         if ! echo $PATH | grep -q $LUSTRE/utils/gss; then
266                 export PATH=$LUSTRE/utils/gss:$PATH
267         fi
268         if ! echo $PATH | grep -q $LUSTRE/tests; then
269                 export PATH=$LUSTRE/tests:$PATH
270         fi
271         if ! echo $PATH | grep -q $LUSTRE/../lustre-iokit/sgpdd-survey; then
272                 export PATH=$LUSTRE/../lustre-iokit/sgpdd-survey:$PATH
273         fi
274         export LST=${LST:-"$LUSTRE/../lnet/utils/lst"}
275         [ ! -f "$LST" ] && export LST=$(which lst)
276         export SGPDDSURVEY=${SGPDDSURVEY:-"$LUSTRE/../lustre-iokit/sgpdd-survey/sgpdd-survey")}
277         [ ! -f "$SGPDDSURVEY" ] && export SGPDDSURVEY=$(which sgpdd-survey)
278         export MCREATE=${MCREATE:-mcreate}
279         export MULTIOP=${MULTIOP:-multiop}
280         # Ubuntu, at least, has a truncate command in /usr/bin
281         # so fully path our truncate command.
282         export TRUNCATE=${TRUNCATE:-$LUSTRE/tests/truncate}
283         export FSX=${FSX:-$LUSTRE/tests/fsx}
284         export MDSRATE=${MDSRATE:-"$LUSTRE/tests/mpi/mdsrate"}
285         [ ! -f "$MDSRATE" ] && export MDSRATE=$(which mdsrate 2> /dev/null)
286         if ! echo $PATH | grep -q $LUSTRE/tests/racer; then
287                 export PATH=$LUSTRE/tests/racer:$PATH:
288         fi
289         if ! echo $PATH | grep -q $LUSTRE/tests/mpi; then
290                 export PATH=$LUSTRE/tests/mpi:$PATH
291         fi
292         export RSYNC_RSH=${RSYNC_RSH:-rsh}
293
294         export LCTL=${LCTL:-"$LUSTRE/utils/lctl"}
295         [ ! -f "$LCTL" ] && export LCTL=$(which lctl)
296         export LFS=${LFS:-"$LUSTRE/utils/lfs"}
297         [ ! -f "$LFS" ] && export LFS=$(which lfs)
298
299         export PERM_CMD=${PERM_CMD:-"$LCTL conf_param"}
300
301         export L_GETIDENTITY=${L_GETIDENTITY:-"$LUSTRE/utils/l_getidentity"}
302         if [ ! -f "$L_GETIDENTITY" ]; then
303                 if `which l_getidentity > /dev/null 2>&1`; then
304                         export L_GETIDENTITY=$(which l_getidentity)
305                 else
306                         export L_GETIDENTITY=NONE
307                 fi
308         fi
309         export LL_DECODE_FILTER_FID=${LL_DECODE_FILTER_FID:-"$LUSTRE/utils/ll_decode_filter_fid"}
310         [ ! -f "$LL_DECODE_FILTER_FID" ] && export LL_DECODE_FILTER_FID="ll_decode_filter_fid"
311         export LL_DECODE_LINKEA=${LL_DECODE_LINKEA:-"$LUSTRE/utils/ll_decode_linkea"}
312         [ ! -f "$LL_DECODE_LINKEA" ] && export LL_DECODE_LINKEA="ll_decode_linkea"
313         export MKFS=${MKFS:-"$LUSTRE/utils/mkfs.lustre"}
314         [ ! -f "$MKFS" ] && export MKFS="mkfs.lustre"
315         export TUNEFS=${TUNEFS:-"$LUSTRE/utils/tunefs.lustre"}
316         [ ! -f "$TUNEFS" ] && export TUNEFS="tunefs.lustre"
317         export CHECKSTAT="${CHECKSTAT:-"checkstat -v"} "
318         export LUSTRE_RMMOD=${LUSTRE_RMMOD:-$LUSTRE/scripts/lustre_rmmod}
319         [ ! -f "$LUSTRE_RMMOD" ] &&
320                 export LUSTRE_RMMOD=$(which lustre_rmmod 2> /dev/null)
321         export LUSTRE_ROUTES_CONVERSION=${LUSTRE_ROUTES_CONVERSION:-$LUSTRE/scripts/lustre_routes_conversion}
322         [ ! -f "$LUSTRE_ROUTES_CONVERSION" ] &&
323                 export LUSTRE_ROUTES_CONVERSION=$(which lustre_routes_conversion 2> /dev/null)
324         export LFS_MIGRATE=${LFS_MIGRATE:-$LUSTRE/scripts/lfs_migrate}
325         [ ! -f "$LFS_MIGRATE" ] &&
326                 export LFS_MIGRATE=$(which lfs_migrate 2> /dev/null)
327         export LR_READER=${LR_READER:-"$LUSTRE/utils/lr_reader"}
328         [ ! -f "$LR_READER" ] &&
329                 export LR_READER=$(which lr_reader 2> /dev/null)
330         [ -z "$LR_READER" ] && export LR_READER="/usr/sbin/lr_reader"
331         export LSOM_SYNC=${LSOM_SYNC:-"$LUSTRE/utils/llsom_sync"}
332         [ ! -f "$LSOM_SYNC" ] &&
333                 export LSOM_SYNC=$(which llsom_sync 2> /dev/null)
334         [ -z "$LSOM_SYNC" ] && export LSOM_SYNC="/usr/sbin/llsom_sync"
335         export NAME=${NAME:-local}
336         export LGSSD=${LGSSD:-"$LUSTRE/utils/gss/lgssd"}
337         [ "$GSS_PIPEFS" = "true" ] && [ ! -f "$LGSSD" ] &&
338                 export LGSSD=$(which lgssd)
339         export LSVCGSSD=${LSVCGSSD:-"$LUSTRE/utils/gss/lsvcgssd"}
340         [ ! -f "$LSVCGSSD" ] && export LSVCGSSD=$(which lsvcgssd 2> /dev/null)
341         export KRB5DIR=${KRB5DIR:-"/usr/kerberos"}
342         export DIR2
343         export SAVE_PWD=${SAVE_PWD:-$LUSTRE/tests}
344         export AT_MAX_PATH
345         export LDEV=${LDEV:-"$LUSTRE/scripts/ldev"}
346         [ ! -f "$LDEV" ] && export LDEV=$(which ldev 2> /dev/null)
347
348         export DMSETUP=${DMSETUP:-dmsetup}
349         export DM_DEV_PATH=${DM_DEV_PATH:-/dev/mapper}
350         export LOSETUP=${LOSETUP:-losetup}
351
352         if [ "$ACCEPTOR_PORT" ]; then
353                 export PORT_OPT="--port $ACCEPTOR_PORT"
354         fi
355
356         if $SHARED_KEY; then
357                 $RPC_MODE || echo "Using GSS shared-key feature"
358                 which lgss_sk > /dev/null 2>&1 ||
359                         error_exit "built with lgss_sk disabled! SEC=$SEC"
360                 GSS=true
361                 GSS_SK=true
362                 SEC=$SK_FLAVOR
363         fi
364
365         case "x$SEC" in
366                 xkrb5*)
367                 $RPC_MODE || echo "Using GSS/krb5 ptlrpc security flavor"
368                 which lgss_keyring > /dev/null 2>&1 ||
369                         error_exit "built with gss disabled! SEC=$SEC"
370                 GSS=true
371                 GSS_KRB5=true
372                 ;;
373         esac
374
375         case "x$IDUP" in
376                 xtrue)
377                         IDENTITY_UPCALL=true
378                         ;;
379                 xfalse)
380                         IDENTITY_UPCALL=false
381                         ;;
382         esac
383
384         export LOAD_MODULES_REMOTE=${LOAD_MODULES_REMOTE:-false}
385
386         # Paths on remote nodes, if different
387         export RLUSTRE=${RLUSTRE:-$LUSTRE}
388         export RPWD=${RPWD:-$PWD}
389         export I_MOUNTED=${I_MOUNTED:-"no"}
390         export AUSTER_CLEANUP=${AUSTER_CLEANUP:-false}
391         if [ ! -f /lib/modules/$(uname -r)/kernel/fs/lustre/mdt.ko -a \
392              ! -f /lib/modules/$(uname -r)/updates/kernel/fs/lustre/mdt.ko -a \
393              ! -f /lib/modules/$(uname -r)/extra/kernel/fs/lustre/mdt.ko -a \
394              ! -f $LUSTRE/mdt/mdt.ko ]; then
395             export CLIENTMODSONLY=yes
396         fi
397
398         export SHUTDOWN_ATTEMPTS=${SHUTDOWN_ATTEMPTS:-3}
399         export OSD_TRACK_DECLARES_LBUG=${OSD_TRACK_DECLARES_LBUG:-"yes"}
400
401         # command line
402
403         while getopts "rvwf:" opt $*; do
404                 case $opt in
405                         f) CONFIG=$OPTARG;;
406                         r) REFORMAT=yes;;
407                         v) VERBOSE=true;;
408                         w) WRITECONF=writeconf;;
409                         \?) usage;;
410                 esac
411         done
412
413         shift $((OPTIND - 1))
414         ONLY=${ONLY:-$*}
415
416         # print the durations of each test if "true"
417         DDETAILS=${DDETAILS:-false}
418         [ "$TESTSUITELOG" ] && rm -f $TESTSUITELOG || true
419         if ! $RPC_MODE; then
420                 rm -f $TMP/*active
421         fi
422
423         export TF_FAIL=${TF_FAIL:-$TMP/tf.fail}
424
425         # Constants used in more than one test script
426         export LOV_MAX_STRIPE_COUNT=2000
427
428         export MACHINEFILE=${MACHINEFILE:-$TMP/$(basename $0 .sh).machines}
429         . ${CONFIG:=$LUSTRE/tests/cfg/$NAME.sh}
430         get_lustre_env
431
432 }
433
434 check_cpt_number() {
435         local facet=$1
436         local ncpts
437
438         ncpts=$(do_facet $facet "lctl get_param -n " \
439                 "cpu_partition_table 2>/dev/null| wc -l" || echo 1)
440
441         if [ $ncpts -eq 0 ]; then
442                 echo "1"
443         else
444                 echo $ncpts
445         fi
446 }
447
448 # Return a numeric version code based on a version string.  The version
449 # code is useful for comparison two version strings to see which is newer.
450 version_code() {
451         # split arguments like "1.8.6-wc3" into "1", "8", "6", "wc3"
452         eval set -- $(tr "[:punct:]" " " <<< $*)
453
454         echo -n "$((($1 << 16) | ($2 << 8) | $3))"
455 }
456
457 export LINUX_VERSION=$(uname -r | sed -e "s/\([0-9]*\.[0-9]*\.[0-9]*\).*/\1/")
458 export LINUX_VERSION_CODE=$(version_code ${LINUX_VERSION//\./ })
459
460 # Report the Lustre build version string (e.g. 1.8.7.3 or 2.4.1).
461 #
462 # usage: lustre_build_version
463 #
464 # All Lustre versions support "lctl get_param" to report the version of the
465 # code running in the kernel (what our tests are interested in), but it
466 # doesn't work without modules loaded.  After 2.9.53 and in upstream kernels
467 # the "version" parameter doesn't include "lustre: " at the beginning.
468 # If that fails, call "lctl lustre_build_version" which prints either (or both)
469 # the userspace and kernel build versions, but until 2.8.55 required root
470 # access to get the Lustre kernel version.  If that also fails, fall back to
471 # using "lctl --version", which is easy to parse and works without the kernel
472 # modules, but was only added in 2.6.50 and only prints the lctl tool version,
473 # not the module version, though they are usually the same.
474 #
475 # Various commands and their output format for different Lustre versions:
476 # lctl get_param version:       2.9.55
477 # lctl get_param version:       lustre: 2.8.53
478 # lctl get_param version:       lustre: 2.6.52
479 #                               kernel: patchless_client
480 #                               build: v2_6_92_0-2.6.32-431.el6_lustre.x86_64
481 # lctl lustre_build_version:    Lustre version: 2.8.53_27_gae67fc01
482 # lctl lustre_build_version:    error: lustre_build_version: Permission denied
483 #       (as non-root user)      lctl   version: v2_6_92_0-2.6.32-431.el6.x86_64
484 # lctl lustre_build_version:    Lustre version: 2.5.3-2.6.32.26-175.fc12.x86_64
485 #                               lctl   version: 2.5.3-2.6.32..26-175fc12.x86_64
486 # lctl --version:               lctl 2.6.50
487 #
488 # output: prints version string to stdout in (up to 4) dotted-decimal values
489 lustre_build_version() {
490         local facet=${1:-client}
491         local ver=$(do_facet $facet "$LCTL get_param -n version 2>/dev/null ||
492                                 $LCTL lustre_build_version 2>/dev/null ||
493                                 $LCTL --version 2>/dev/null | cut -d' ' -f2")
494         local lver=$(egrep -i "lustre: |version: " <<<"$ver" | head -n 1)
495         [ -n "$lver" ] && ver="$lver"
496
497         sed -e 's/[^:]*: //' -e 's/^v//' -e 's/[ -].*//' -e 's/_/./g' <<<$ver |
498                 cut -d. -f1-4
499 }
500
501 # Report the Lustre numeric build version code for the supplied facet.
502 lustre_version_code() {
503         version_code $(lustre_build_version $1)
504 }
505
506 module_loaded () {
507         /sbin/lsmod | grep -q "^\<$1\>"
508 }
509
510 PRLFS=false
511 lustre_insmod() {
512         local module=$1
513         shift
514         local args="$@"
515         local msg
516         local rc=0
517
518         if ! $PRLFS; then
519                 msg="$(insmod $module $args 2>&1)" && return 0 || rc=$?
520         fi
521
522         # parallels can't load modules directly from prlfs, use /tmp instead
523         if $PRLFS || [[ "$(stat -f -c%t $module)" == "7c7c6673" ]]; then
524                 local target="$(mktemp)"
525
526                 cp "$module" "$target"
527                 insmod $target $args
528                 rc=$?
529                 [[ $rc == 0 ]] && PRLFS=true
530                 rm -f $target
531         else
532                 echo "$msg"
533         fi
534         return $rc
535 }
536
537 # Load a module on the system where this is running.
538 #
539 # usage: load_module module_name [module arguments for insmod/modprobe]
540 #
541 # If module arguments are not given but MODOPTS_<MODULE> is set, then its value
542 # will be used as the arguments.  Otherwise arguments will be obtained from
543 # /etc/modprobe.conf, from /etc/modprobe.d/Lustre, or else none will be used.
544 #
545 load_module() {
546         local module=$1 # '../libcfs/libcfs/libcfs', 'obdclass/obdclass', ...
547         shift
548         local ext=".ko"
549         local base=$(basename $module $ext)
550         local path
551         local -A module_is_loaded_aa
552         local optvar
553         local mod
554
555         for mod in $(lsmod | awk '{ print $1; }'); do
556                 module_is_loaded_aa[${mod//-/_}]=true
557         done
558
559         module_is_loaded() {
560                 ${module_is_loaded_aa[${1//-/_}]:-false}
561         }
562
563         if module_is_loaded $base; then
564                 return
565         fi
566
567         if [[ -f $LUSTRE/$module$ext ]]; then
568                 path=$LUSTRE/$module$ext
569         elif [[ "$base" == lnet_selftest ]] &&
570              [[ -f $LUSTRE/../lnet/selftest/$base$ext ]]; then
571                 path=$LUSTRE/../lnet/selftest/$base$ext
572         else
573                 path=''
574         fi
575
576         if [[ -n "$path" ]]; then
577                 # Try to load any non-Lustre modules that $module depends on.
578                 for mod in $(modinfo --field=depends $path | tr ',' ' '); do
579                         if ! module_is_loaded $mod; then
580                                 modprobe $mod
581                         fi
582                 done
583         fi
584
585         # If no module arguments were passed then get them from
586         # $MODOPTS_<MODULE>, otherwise from modprobe.conf.
587         if [ $# -eq 0 ]; then
588                 # $MODOPTS_<MODULE>; we could use associative arrays, but that's
589                 # not in Bash until 4.x, so we resort to eval.
590                 optvar="MODOPTS_$(basename $module | tr a-z A-Z)"
591                 eval set -- \$$optvar
592                 if [ $# -eq 0 -a -n "$MODPROBECONF" ]; then
593                         # Nothing in $MODOPTS_<MODULE>; try modprobe.conf
594                         local opt
595                         opt=$(awk -v var="^options $base" '$0 ~ var \
596                               {gsub("'"options $base"'",""); print}' \
597                                 $MODPROBECONF)
598                         set -- $(echo -n $opt)
599
600                         # Ensure we have accept=all for lnet
601                         if [[ "$base" == lnet ]]; then
602                                 # OK, this is a bit wordy...
603                                 local arg accept_all_present=false
604
605                                 for arg in "$@"; do
606                                         [[ "$arg" == accept=all ]] &&
607                                                 accept_all_present=true
608                                 done
609
610                                 $accept_all_present || set -- "$@" accept=all
611                         fi
612
613                         export $optvar="$*"
614                 fi
615         fi
616
617         [ $# -gt 0 ] && echo "${module} options: '$*'"
618
619         # Note that insmod will ignore anything in modprobe.conf, which is why
620         # we're passing options on the command-line. If $path does not exist
621         # then we must be testing a "make install" or"rpm" installation. Also
622         # note that failing to load ptlrpc_gss is not considered fatal.
623         if [[ -n "$path" ]]; then
624                 lustre_insmod $path "$@"
625         elif [[ "$base" == ptlrpc_gss ]]; then
626                 if ! modprobe $base "$@" 2>/dev/null; then
627                         echo "gss/krb5 is not supported"
628                 fi
629         else
630                 modprobe $base "$@"
631         fi
632 }
633
634 load_modules_local() {
635         if [ -n "$MODPROBE" ]; then
636                 # use modprobe
637                 echo "Using modprobe to load modules"
638                 return 0
639         fi
640
641         # Create special udev test rules on every node
642         if [ -f $LUSTRE/lustre/conf/99-lustre.rules ]; then {
643                 sed -e 's|/usr/sbin/lctl|$LCTL|g' $LUSTRE/lustre/conf/99-lustre.rules > /etc/udev/rules.d/99-lustre-test.rules
644         } else {
645                 echo "SUBSYSTEM==\"lustre\", ACTION==\"change\", ENV{PARAM}==\"?*\", RUN+=\"$LCTL set_param '\$env{PARAM}=\$env{SETTING}'\"" > /etc/udev/rules.d/99-lustre-test.rules
646         } fi
647         udevadm control --reload-rules
648         udevadm trigger
649
650         # For kmemleak-enabled kernels we need clear all past state
651         # that obviously has nothing to do with this Lustre run
652         # Disable automatic memory scanning to avoid perf hit.
653         if [ -f /sys/kernel/debug/kmemleak ] ; then
654                 echo scan=off > /sys/kernel/debug/kmemleak
655                 echo scan > /sys/kernel/debug/kmemleak
656                 echo clear > /sys/kernel/debug/kmemleak
657         fi
658
659         echo Loading modules from $LUSTRE
660
661         local ncpus
662
663         if [ -f /sys/devices/system/cpu/online ]; then
664                 ncpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/online) + 1))
665                 echo "detected $ncpus online CPUs by sysfs"
666         else
667                 ncpus=$(getconf _NPROCESSORS_CONF 2>/dev/null)
668                 local rc=$?
669                 if [ $rc -eq 0 ]; then
670                         echo "detected $ncpus online CPUs by getconf"
671                 else
672                         echo "Can't detect number of CPUs"
673                         ncpus=1
674                 fi
675         fi
676
677         # if there is only one CPU core, libcfs can only create one partition
678         # if there is more than 4 CPU cores, libcfs should create multiple CPU
679         # partitions. So we just force libcfs to create 2 partitions for
680         # system with 2 or 4 cores
681         if [ $ncpus -le 4 ] && [ $ncpus -gt 1 ]; then
682                 # force to enable multiple CPU partitions
683                 echo "Force libcfs to create 2 CPU partitions"
684                 MODOPTS_LIBCFS="cpu_npartitions=2 $MODOPTS_LIBCFS"
685         else
686                 echo "libcfs will create CPU partition based on online CPUs"
687         fi
688
689         load_module ../libcfs/libcfs/libcfs
690         # Prevent local MODOPTS_LIBCFS being passed as part of environment
691         # variable to remote nodes
692         unset MODOPTS_LIBCFS
693
694         set_default_debug
695         load_module ../lnet/lnet/lnet
696
697         LNDPATH=${LNDPATH:-"../lnet/klnds"}
698         if [ -z "$LNETLND" ]; then
699                 case $NETTYPE in
700                 o2ib*)  LNETLND="o2iblnd/ko2iblnd" ;;
701                 tcp*)   LNETLND="socklnd/ksocklnd" ;;
702                 *)      local lnd="${NETTYPE%%[0-9]}lnd"
703                         [ -f "$LNDPATH/$lnd/k$lnd.ko" ] &&
704                                 LNETLND="$lnd/k$lnd" ||
705                                 LNETLND="socklnd/ksocklnd"
706                 esac
707         fi
708         load_module ../lnet/klnds/$LNETLND
709         load_module obdclass/obdclass
710         load_module ptlrpc/ptlrpc
711         load_module ptlrpc/gss/ptlrpc_gss
712         load_module fld/fld
713         load_module fid/fid
714         load_module lmv/lmv
715         load_module osc/osc
716         load_module mdc/mdc
717         load_module lov/lov
718         load_module mgc/mgc
719         load_module obdecho/obdecho
720         if ! client_only; then
721                 load_module lfsck/lfsck
722                 [ "$LQUOTA" != "no" ] &&
723                         load_module quota/lquota $LQUOTAOPTS
724                 if [[ $(node_fstypes $HOSTNAME) == *zfs* ]]; then
725                         load_module osd-zfs/osd_zfs
726                 elif [[ $(node_fstypes $HOSTNAME) == *ldiskfs* ]]; then
727                         load_module ../ldiskfs/ldiskfs
728                         load_module osd-ldiskfs/osd_ldiskfs
729                 fi
730                 load_module mgs/mgs
731                 load_module mdd/mdd
732                 load_module mdt/mdt
733                 load_module ost/ost
734                 load_module lod/lod
735                 load_module osp/osp
736                 load_module ofd/ofd
737                 load_module osp/osp
738         fi
739
740         load_module llite/lustre
741         [ -d /r ] && OGDB=${OGDB:-"/r/tmp"}
742         OGDB=${OGDB:-$TMP}
743         rm -f $OGDB/ogdb-$HOSTNAME
744         $LCTL modules > $OGDB/ogdb-$HOSTNAME
745
746         # 'mount' doesn't look in $PATH, just sbin
747         local mount_lustre=$LUSTRE/utils/mount.lustre
748         if [ -f $mount_lustre ]; then
749                 local sbin_mount=$(readlink -f /sbin)/mount.lustre
750                 if grep -qw "$sbin_mount" /proc/mounts; then
751                         cmp -s $mount_lustre $sbin_mount || umount $sbin_mount
752                 fi
753                 if ! grep -qw "$sbin_mount" /proc/mounts; then
754                         [ ! -f "$sbin_mount" ] && touch "$sbin_mount"
755                         if [ ! -s "$sbin_mount" -a -w "$sbin_mount" ]; then
756                                 cat <<- EOF > "$sbin_mount"
757                                 #!/bin/sh
758                                 #STUB MARK
759                                 echo "This $sbin_mount just a mountpoint." 1>&2
760                                 echo "It is never supposed to be run." 1>&2
761                                 logger -p emerg -- "using stub $sbin_mount $@"
762                                 exit 1
763                                 EOF
764                                 chmod a+x $sbin_mount
765                         fi
766                         mount --bind $mount_lustre $sbin_mount ||
767                                 error "can't bind $mount_lustre to $sbin_mount"
768                 fi
769         fi
770 }
771
772 load_modules () {
773         load_modules_local
774         # bug 19124
775         # load modules on remote nodes optionally
776         # lustre-tests have to be installed on these nodes
777         if $LOAD_MODULES_REMOTE; then
778                 local list=$(comma_list $(remote_nodes_list))
779                 if [ -n "$list" ]; then
780                         echo "loading modules on: '$list'"
781                         do_rpc_nodes "$list" load_modules_local
782                 fi
783         fi
784 }
785
786 check_mem_leak () {
787     LEAK_LUSTRE=$(dmesg | tail -n 30 | grep "obd_memory.*leaked" || true)
788     LEAK_PORTALS=$(dmesg | tail -n 20 | grep "Portals memory leaked" || true)
789     if [ "$LEAK_LUSTRE" -o "$LEAK_PORTALS" ]; then
790         echo "$LEAK_LUSTRE" 1>&2
791         echo "$LEAK_PORTALS" 1>&2
792         mv $TMP/debug $TMP/debug-leak.`date +%s` || true
793         echo "Memory leaks detected"
794         [ -n "$IGNORE_LEAK" ] && { echo "ignoring leaks" && return 0; } || true
795         return 1
796     fi
797 }
798
799 unload_modules() {
800         wait_exit_ST client # bug 12845
801
802         $LUSTRE_RMMOD ldiskfs || return 2
803
804         [ -f /etc/udev/rules.d/99-lustre-test.rules ] &&
805                 rm /etc/udev/rules.d/99-lustre-test.rules
806         udevadm control --reload-rules
807         udevadm trigger
808
809         if $LOAD_MODULES_REMOTE; then
810                 local list=$(comma_list $(remote_nodes_list))
811                 if [ -n "$list" ]; then
812                         echo "unloading modules on: '$list'"
813                         do_rpc_nodes "$list" $LUSTRE_RMMOD ldiskfs
814                         do_rpc_nodes "$list" check_mem_leak
815                         do_rpc_nodes "$list" "rm -f /etc/udev/rules.d/99-lustre-test.rules"
816                         do_rpc_nodes "$list" "udevadm control --reload-rules"
817                         do_rpc_nodes "$list" "udevadm trigger"
818                 fi
819         fi
820
821         local sbin_mount=$(readlink -f /sbin)/mount.lustre
822         if grep -qe "$sbin_mount " /proc/mounts; then
823                 umount $sbin_mount || true
824                 [ -s $sbin_mount ] && ! grep -q "STUB MARK" $sbin_mount ||
825                         rm -f $sbin_mount
826         fi
827
828         check_mem_leak || return 254
829
830         echo "modules unloaded."
831         return 0
832 }
833
834 fs_log_size() {
835         local facet=${1:-$SINGLEMDS}
836         local size=0
837
838         case $(facet_fstype $facet) in
839                 ldiskfs) size=50;; # largest seen is 44, leave some headroom
840                 # grant_block_size is in bytes, allow at least 2x max blocksize
841                 zfs)     size=$(lctl get_param osc.$FSNAME*.import |
842                                 awk '/grant_block_size:/ {print $2/512; exit;}')
843                           ;;
844         esac
845
846         echo -n $((size * MDSCOUNT))
847 }
848
849 fs_inode_ksize() {
850         local facet=${1:-$SINGLEMDS}
851         local fstype=$(facet_fstype $facet)
852         local size=0
853         case $fstype in
854                 ldiskfs) size=4;;  # ~4KB per inode
855                 zfs)     size=11;; # 10 to 11KB per inode
856         esac
857
858         echo -n $size
859 }
860
861 check_gss_daemon_nodes() {
862     local list=$1
863     dname=$2
864
865     do_nodesv $list "num=\\\$(ps -o cmd -C $dname | grep $dname | wc -l);
866 if [ \\\"\\\$num\\\" -ne 1 ]; then
867     echo \\\$num instance of $dname;
868     exit 1;
869 fi; "
870 }
871
872 check_gss_daemon_facet() {
873     facet=$1
874     dname=$2
875
876     num=`do_facet $facet ps -o cmd -C $dname | grep $dname | wc -l`
877     if [ $num -ne 1 ]; then
878         echo "$num instance of $dname on $facet"
879         return 1
880     fi
881     return 0
882 }
883
884 send_sigint() {
885     local list=$1
886     shift
887     echo Stopping $@ on $list
888     do_nodes $list "killall -2 $@ 2>/dev/null || true"
889 }
890
891 # start gss daemons on all nodes, or "daemon" on "nodes" if set
892 start_gss_daemons() {
893         local nodes=$1
894         local daemon=$2
895
896         if [ "$nodes" ] && [ "$daemon" ] ; then
897                 echo "Starting gss daemon on nodes: $nodes"
898                 do_nodes $nodes "$daemon" || return 8
899                 return 0
900         fi
901
902         nodes=$(comma_list $(mdts_nodes))
903         echo "Starting gss daemon on mds: $nodes"
904         if $GSS_SK; then
905                 # Start all versions, in case of switching
906                 do_nodes $nodes "$LSVCGSSD -vvv -s -m -o -z" || return 1
907         else
908                 do_nodes $nodes "$LSVCGSSD -v" || return 1
909         fi
910         if $GSS_PIPEFS; then
911                 do_nodes $nodes "$LGSSD -v" || return 2
912         fi
913
914         nodes=$(comma_list $(osts_nodes))
915         echo "Starting gss daemon on ost: $nodes"
916         if $GSS_SK; then
917                 # Start all versions, in case of switching
918                 do_nodes $nodes "$LSVCGSSD -vvv -s -m -o -z" || return 3
919         else
920                 do_nodes $nodes "$LSVCGSSD -v" || return 3
921         fi
922         # starting on clients
923
924         local clients=${CLIENTS:-$HOSTNAME}
925         if $GSS_PIPEFS; then
926                 echo "Starting $LGSSD on clients $clients "
927                 do_nodes $clients  "$LGSSD -v" || return 4
928         fi
929
930         # wait daemons entering "stable" status
931         sleep 5
932
933         #
934         # check daemons are running
935         #
936         nodes=$(comma_list $(mdts_nodes) $(osts_nodes))
937         check_gss_daemon_nodes $nodes lsvcgssd || return 5
938         if $GSS_PIPEFS; then
939                 nodes=$(comma_list $(mdts_nodes))
940                 check_gss_daemon_nodes $nodes lgssd || return 6
941         fi
942         if $GSS_PIPEFS; then
943                 check_gss_daemon_nodes $clients lgssd || return 7
944         fi
945 }
946
947 stop_gss_daemons() {
948         local nodes=$(comma_list $(mdts_nodes))
949
950         send_sigint $nodes lsvcgssd lgssd
951
952         nodes=$(comma_list $(osts_nodes))
953         send_sigint $nodes lsvcgssd
954
955         nodes=${CLIENTS:-$HOSTNAME}
956         send_sigint $nodes lgssd
957 }
958
959 add_sk_mntflag() {
960         # Add mount flags for shared key
961         local mt_opts=$@
962         if grep -q skpath <<< "$mt_opts" ; then
963                 mt_opts=$(echo $mt_opts |
964                         sed -e "s#skpath=[^ ,]*#skpath=$SK_PATH#")
965         else
966                 if [ -z "$mt_opts" ]; then
967                         mt_opts="-o skpath=$SK_PATH"
968                 else
969                         mt_opts="$mt_opts,skpath=$SK_PATH"
970                 fi
971         fi
972         echo -n $mt_opts
973 }
974
975 init_gss() {
976         if $SHARED_KEY; then
977                 GSS=true
978                 GSS_SK=true
979         fi
980
981         if ! $GSS; then
982                 return
983         fi
984
985         case $LUSTRE in
986         /usr/lib/lustre/* | /usr/lib64/lustre/* | /usr/lib/lustre | \
987         /usr/lib64/lustre )
988                 from_build_tree=false
989                 ;;
990         *)
991                 from_build_tree=true
992                 ;;
993         esac
994
995         if ! module_loaded ptlrpc_gss; then
996                 load_module ptlrpc/gss/ptlrpc_gss
997                 module_loaded ptlrpc_gss ||
998                         error_exit "init_gss: GSS=$GSS, but gss/krb5 missing"
999         fi
1000
1001         if $GSS_KRB5 || $GSS_SK; then
1002                 start_gss_daemons || error_exit "start gss daemon failed! rc=$?"
1003         fi
1004
1005         if $GSS_SK && $SK_NO_KEY; then
1006                 local numclients=${1:-$CLIENTCOUNT}
1007                 local clients=${CLIENTS:-$HOSTNAME}
1008
1009                 # security ctx config for keyring
1010                 SK_NO_KEY=false
1011                 local lgssc_conf_file="/etc/request-key.d/lgssc.conf"
1012
1013                 if $from_build_tree; then
1014                         mkdir -p $SK_OM_PATH
1015                         if grep -q request-key /proc/mounts > /dev/null; then
1016                                 echo "SSK: Request key already mounted."
1017                         else
1018                                 mount -o bind $SK_OM_PATH /etc/request-key.d/
1019                         fi
1020                         local lgssc_conf_line='create lgssc * * '
1021                         lgssc_conf_line+=$(which lgss_keyring)
1022                         lgssc_conf_line+=' %o %k %t %d %c %u %g %T %P %S'
1023                         echo "$lgssc_conf_line" > $lgssc_conf_file
1024                 fi
1025
1026                 [ -e $lgssc_conf_file ] ||
1027                         error_exit "Could not find key options in $lgssc_conf_file"
1028                 echo "$lgssc_conf_file content is:"
1029                 cat $lgssc_conf_file
1030
1031                 if ! local_mode; then
1032                         if $from_build_tree; then
1033                                 do_nodes $(comma_list $(all_nodes)) "mkdir -p \
1034                                         $SK_OM_PATH"
1035                                 do_nodes $(comma_list $(all_nodes)) "mount \
1036                                         -o bind $SK_OM_PATH \
1037                                         /etc/request-key.d/"
1038                                 do_nodes $(comma_list $(all_nodes)) "rsync \
1039                                         -aqv $HOSTNAME:$lgssc_conf_file \
1040                                         $lgssc_conf_file >/dev/null 2>&1"
1041                         else
1042                                 do_nodes $(comma_list $(all_nodes)) \
1043                                         "echo $lgssc_conf_file: ; \
1044                                         cat $lgssc_conf_file"
1045                         fi
1046                 fi
1047
1048                 # create shared key on all nodes
1049                 mkdir -p $SK_PATH/nodemap
1050                 rm -f $SK_PATH/$FSNAME.key $SK_PATH/nodemap/c*.key \
1051                         $SK_PATH/$FSNAME-*.key
1052                 # for nodemap testing each client may need own key,
1053                 # and S2S now requires keys as well, both for "client"
1054                 # and for "server"
1055                 if $SK_S2S; then
1056                         lgss_sk -t server -f$FSNAME -n $SK_S2SNMCLI \
1057                                 -w $SK_PATH/$FSNAME-nmclient.key \
1058                                 -d /dev/urandom >/dev/null 2>&1
1059                         lgss_sk -t mgs,server -f$FSNAME -n $SK_S2SNM \
1060                                 -w $SK_PATH/$FSNAME-s2s-server.key \
1061                                 -d /dev/urandom >/dev/null 2>&1
1062                 fi
1063                 # basic key create
1064                 lgss_sk -t server -f$FSNAME -w $SK_PATH/$FSNAME.key \
1065                         -d /dev/urandom >/dev/null 2>&1
1066                 # per-nodemap keys
1067                 for i in $(seq 0 $((numclients - 1))); do
1068                         lgss_sk -t server -f$FSNAME -n c$i \
1069                                 -w $SK_PATH/nodemap/c$i.key -d /dev/urandom \
1070                                 >/dev/null 2>&1
1071                 done
1072                 # Distribute keys
1073                 if ! local_mode; then
1074                         for lnode in $(all_nodes); do
1075                                 scp -r $SK_PATH ${lnode}:$(dirname $SK_PATH)/
1076                         done
1077                 fi
1078                 # Set client keys to client type to generate prime P
1079                 if local_mode; then
1080                         do_nodes $(all_nodes) "lgss_sk -t client,server -m \
1081                                 $SK_PATH/$FSNAME.key >/dev/null 2>&1"
1082                 else
1083                         do_nodes $clients "lgss_sk -t client -m \
1084                                 $SK_PATH/$FSNAME.key >/dev/null 2>&1"
1085                         do_nodes $clients "find $SK_PATH/nodemap -name \*.key | \
1086                                 xargs -IX lgss_sk -t client -m X >/dev/null 2>&1"
1087                 fi
1088                 # This is required for servers as well, if S2S in use
1089                 if $SK_S2S; then
1090                         do_nodes $(comma_list $(mdts_nodes)) \
1091                                 "cp $SK_PATH/$FSNAME-s2s-server.key \
1092                                 $SK_PATH/$FSNAME-s2s-client.key; lgss_sk \
1093                                 -t client -m $SK_PATH/$FSNAME-s2s-client.key \
1094                                 >/dev/null 2>&1"
1095                         do_nodes $(comma_list $(osts_nodes)) \
1096                                 "cp $SK_PATH/$FSNAME-s2s-server.key \
1097                                 $SK_PATH/$FSNAME-s2s-client.key; lgss_sk \
1098                                 -t client -m $SK_PATH/$FSNAME-s2s-client.key \
1099                                 >/dev/null 2>&1"
1100                         do_nodes $clients "lgss_sk -t client \
1101                                 -m $SK_PATH/$FSNAME-nmclient.key \
1102                                  >/dev/null 2>&1"
1103                 fi
1104         fi
1105         if $GSS_SK; then
1106                 # mount options for servers and clients
1107                 MGS_MOUNT_OPTS=$(add_sk_mntflag $MGS_MOUNT_OPTS)
1108                 MDS_MOUNT_OPTS=$(add_sk_mntflag $MDS_MOUNT_OPTS)
1109                 OST_MOUNT_OPTS=$(add_sk_mntflag $OST_MOUNT_OPTS)
1110                 MOUNT_OPTS=$(add_sk_mntflag $MOUNT_OPTS)
1111                 SEC=$SK_FLAVOR
1112         fi
1113
1114         if [ -n "$LGSS_KEYRING_DEBUG" ]; then
1115                 lctl set_param -n \
1116                         sptlrpc.gss.lgss_keyring.debug_level=$LGSS_KEYRING_DEBUG
1117         fi
1118 }
1119
1120 cleanup_gss() {
1121         if $GSS; then
1122                 stop_gss_daemons
1123                 # maybe cleanup credential cache?
1124         fi
1125 }
1126
1127 cleanup_sk() {
1128         if $GSS_SK; then
1129                 case $LUSTRE in
1130                 /usr/lib/lustre/* | /usr/lib64/lustre/* | /usr/lib/lustre | \
1131                 /usr/lib64/lustre )
1132                         from_build_tree=false
1133                         ;;
1134                 *)
1135                         from_build_tree=true
1136                         ;;
1137                 esac
1138
1139                 if $SK_S2S; then
1140                         do_node $(mgs_node) "$LCTL nodemap_del $SK_S2SNM"
1141                         do_node $(mgs_node) "$LCTL nodemap_del $SK_S2SNMCLI"
1142                         $RPC_MODE || echo "Sleeping for 10 sec for Nodemap.."
1143                         sleep 10
1144                 fi
1145                 stop_gss_daemons
1146                 $RPC_MODE || echo "Cleaning up Shared Key.."
1147                 do_nodes $(comma_list $(all_nodes)) "rm -f \
1148                         $SK_PATH/$FSNAME*.key $SK_PATH/nodemap/$FSNAME*.key"
1149                 do_nodes $(comma_list $(all_nodes)) "keyctl show | \
1150                   awk '/lustre/ { print \\\$1 }' | xargs -IX keyctl unlink X"
1151                 if $from_build_tree; then
1152                         # Remove the mount and clean up the files we added to
1153                         # SK_PATH
1154                         do_nodes $(comma_list $(all_nodes)) "while grep -q \
1155                                 request-key.d /proc/mounts; do umount \
1156                                 /etc/request-key.d/; done"
1157                         do_nodes $(comma_list $(all_nodes)) "rm -f \
1158                                 $SK_OM_PATH/lgssc.conf"
1159                         do_nodes $(comma_list $(all_nodes)) "rmdir $SK_OM_PATH"
1160                 fi
1161                 SK_NO_KEY=true
1162         fi
1163 }
1164
1165 facet_svc() {
1166         local facet=$1
1167         local var=${facet}_svc
1168
1169         echo -n ${!var}
1170 }
1171
1172 facet_type() {
1173         local facet=$1
1174
1175         echo -n $facet | sed -e 's/^fs[0-9]\+//' -e 's/[0-9_]\+//' |
1176                 tr '[:lower:]' '[:upper:]'
1177 }
1178
1179 facet_number() {
1180         local facet=$1
1181
1182         if [ $facet == mgs ] || [ $facet == client ]; then
1183                 return 1
1184         fi
1185
1186         echo -n $facet | sed -e 's/^fs[0-9]\+//' | sed -e 's/^[a-z]\+//'
1187 }
1188
1189 facet_fstype() {
1190         local facet=$1
1191         local var
1192
1193         var=${facet}_FSTYPE
1194         if [ -n "${!var}" ]; then
1195                 echo -n ${!var}
1196                 return
1197         fi
1198
1199         var=$(facet_type $facet)FSTYPE
1200         if [ -n "${!var}" ]; then
1201                 echo -n ${!var}
1202                 return
1203         fi
1204
1205         if [ -n "$FSTYPE" ]; then
1206                 echo -n $FSTYPE
1207                 return
1208         fi
1209
1210         if [[ $facet == mgs ]] && combined_mgs_mds; then
1211                 facet_fstype mds1
1212                 return
1213         fi
1214
1215         return 1
1216 }
1217
1218 node_fstypes() {
1219         local node=$1
1220         local fstypes
1221         local fstype
1222         local facets=$(get_facets)
1223         local facet
1224
1225         for facet in ${facets//,/ }; do
1226                 if [ $node == $(facet_host $facet) ] ||
1227                    [ $node == "$(facet_failover_host $facet)" ]; then
1228                         fstype=$(facet_fstype $facet)
1229                         if [[ $fstypes != *$fstype* ]]; then
1230                                 fstypes+="${fstypes:+,}$fstype"
1231                         fi
1232                 fi
1233         done
1234         echo -n $fstypes
1235 }
1236
1237 facet_index() {
1238         local facet=$1
1239         local num=$(facet_number $facet)
1240         local index
1241
1242         if [[ $(facet_type $facet) = OST ]]; then
1243                 index=OSTINDEX${num}
1244                 if [[ -n "${!index}" ]]; then
1245                         echo -n ${!index}
1246                         return
1247                 fi
1248
1249                 index=${OST_INDICES[num - 1]}
1250         fi
1251
1252         [[ -n "$index" ]] || index=$((num - 1))
1253         echo -n $index
1254 }
1255
1256 devicelabel() {
1257         local facet=$1
1258         local dev=$2
1259         local label
1260         local fstype=$(facet_fstype $facet)
1261
1262         case $fstype in
1263         ldiskfs)
1264                 label=$(do_facet ${facet} "$E2LABEL ${dev} 2>/dev/null");;
1265         zfs)
1266                 label=$(do_facet ${facet} "$ZFS get -H -o value lustre:svname \
1267                                            ${dev} 2>/dev/null");;
1268         *)
1269                 error "unknown fstype!";;
1270         esac
1271
1272         echo -n $label
1273 }
1274
1275 mdsdevlabel() {
1276         local num=$1
1277         local device=$(mdsdevname $num)
1278         local label=$(devicelabel mds$num ${device} | grep -v "CMD: ")
1279         echo -n $label
1280 }
1281
1282 ostdevlabel() {
1283         local num=$1
1284         local device=$(ostdevname $num)
1285         local label=$(devicelabel ost$num ${device} | grep -v "CMD: ")
1286         echo -n $label
1287 }
1288
1289 #
1290 # Get the device of a facet.
1291 #
1292 facet_device() {
1293         local facet=$1
1294         local device
1295
1296         case $facet in
1297                 mgs) device=$(mgsdevname) ;;
1298                 mds*) device=$(mdsdevname $(facet_number $facet)) ;;
1299                 ost*) device=$(ostdevname $(facet_number $facet)) ;;
1300                 fs2mds) device=$(mdsdevname 1_2) ;;
1301                 fs2ost) device=$(ostdevname 1_2) ;;
1302                 fs3ost) device=$(ostdevname 2_2) ;;
1303                 *) ;;
1304         esac
1305
1306         echo -n $device
1307 }
1308
1309 #
1310 # Get the virtual device of a facet.
1311 #
1312 facet_vdevice() {
1313         local facet=$1
1314         local device
1315
1316         case $facet in
1317                 mgs) device=$(mgsvdevname) ;;
1318                 mds*) device=$(mdsvdevname $(facet_number $facet)) ;;
1319                 ost*) device=$(ostvdevname $(facet_number $facet)) ;;
1320                 fs2mds) device=$(mdsvdevname 1_2) ;;
1321                 fs2ost) device=$(ostvdevname 1_2) ;;
1322                 fs3ost) device=$(ostvdevname 2_2) ;;
1323                 *) ;;
1324         esac
1325
1326         echo -n $device
1327 }
1328
1329 running_in_vm() {
1330         local virt=$(virt-what 2> /dev/null)
1331
1332         [ $? -eq 0 ] && [ -n "$virt" ] && { echo $virt; return; }
1333
1334         virt=$(dmidecode -s system-product-name | awk '{print $1}')
1335
1336         case $virt in
1337                 VMware|KVM|VirtualBox|Parallels|Bochs)
1338                         echo $virt | tr '[A-Z]' '[a-z]' ;;
1339                 *) ;;
1340         esac
1341 }
1342
1343 #
1344 # Re-read the partition table on failover partner host.
1345 # After a ZFS storage pool is created on a shared device, the partition table
1346 # on the device may change. However, the operating system on the failover
1347 # host may not notice the change automatically. Without the up-to-date partition
1348 # block devices, 'zpool import ..' cannot find the labels, whose positions are
1349 # relative to partition rather than disk beginnings.
1350 #
1351 # This function performs partprobe on the failover host to make it re-read the
1352 # partition table.
1353 #
1354 refresh_partition_table() {
1355         local facet=$1
1356         local device=$2
1357         local host
1358
1359         host=$(facet_passive_host $facet)
1360         if [[ -n "$host" ]]; then
1361                 do_node $host "$PARTPROBE $device"
1362         fi
1363 }
1364
1365 #
1366 # Get ZFS storage pool name.
1367 #
1368 zpool_name() {
1369         local facet=$1
1370         local device
1371         local poolname
1372
1373         device=$(facet_device $facet)
1374         # poolname is string before "/"
1375         poolname="${device%%/*}"
1376
1377         echo -n $poolname
1378 }
1379
1380 #
1381 #
1382 # Get ZFS local fsname.
1383 #
1384 zfs_local_fsname() {
1385         local facet=$1
1386         local lfsname=$(basename $(facet_device $facet))
1387
1388         echo -n $lfsname
1389 }
1390
1391 #
1392 # Create ZFS storage pool.
1393 #
1394 create_zpool() {
1395         local facet=$1
1396         local poolname=$2
1397         local vdev=$3
1398         shift 3
1399         local opts=${@:-"-o cachefile=none"}
1400
1401         do_facet $facet "lsmod | grep zfs >&/dev/null || modprobe zfs;
1402                 $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1403                 $ZPOOL create -f $opts $poolname $vdev"
1404 }
1405
1406 #
1407 # Create ZFS file system.
1408 #
1409 create_zfs() {
1410         local facet=$1
1411         local dataset=$2
1412         shift 2
1413         local opts=${@:-"-o mountpoint=legacy"}
1414
1415         do_facet $facet "$ZFS list -H $dataset >/dev/null 2>&1 ||
1416                 $ZFS create $opts $dataset"
1417 }
1418
1419 #
1420 # Export ZFS storage pool.
1421 # Before exporting the pool, all datasets within the pool should be unmounted.
1422 #
1423 export_zpool() {
1424         local facet=$1
1425         shift
1426         local opts="$@"
1427         local poolname
1428
1429         poolname=$(zpool_name $facet)
1430
1431         if [[ -n "$poolname" ]]; then
1432                 do_facet $facet "! $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1433                         grep -q ^$poolname/ /proc/mounts ||
1434                         $ZPOOL export $opts $poolname"
1435         fi
1436 }
1437
1438 #
1439 # Destroy ZFS storage pool.
1440 # Destroy the given pool and free up any devices for other use. This command
1441 # tries to unmount any active datasets before destroying the pool.
1442 # -f    Force any active datasets contained within the pool to be unmounted.
1443 #
1444 destroy_zpool() {
1445         local facet=$1
1446         local poolname=${2:-$(zpool_name $facet)}
1447
1448         if [[ -n "$poolname" ]]; then
1449                 do_facet $facet "! $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1450                         $ZPOOL destroy -f $poolname"
1451         fi
1452 }
1453
1454 #
1455 # Import ZFS storage pool.
1456 # Force importing, even if the pool appears to be potentially active.
1457 #
1458 import_zpool() {
1459         local facet=$1
1460         shift
1461         local opts=${@:-"-o cachefile=none -o failmode=panic"}
1462         local poolname
1463
1464         poolname=$(zpool_name $facet)
1465
1466         if [[ -n "$poolname" ]]; then
1467                 opts+=" -d $(dirname $(facet_vdevice $facet))"
1468                 do_facet $facet "lsmod | grep zfs >&/dev/null || modprobe zfs;
1469                         $ZPOOL list -H $poolname >/dev/null 2>&1 ||
1470                         $ZPOOL import -f $opts $poolname"
1471         fi
1472 }
1473
1474 #
1475 # Reimport ZFS storage pool with new name
1476 #
1477 reimport_zpool() {
1478         local facet=$1
1479         local newpool=$2
1480         local opts="-o cachefile=none"
1481         local poolname=$(zpool_name $facet)
1482
1483         opts+=" -d $(dirname $(facet_vdevice $facet))"
1484         do_facet $facet "$ZPOOL export $poolname;
1485                          $ZPOOL import $opts $poolname $newpool"
1486 }
1487
1488 #
1489 # Set the "cachefile=none" property on ZFS storage pool so that the pool
1490 # is not automatically imported on system startup.
1491 #
1492 # In a failover environment, this will provide resource level fencing which
1493 # will ensure that the same ZFS storage pool will not be imported concurrently
1494 # on different nodes.
1495 #
1496 disable_zpool_cache() {
1497         local facet=$1
1498         local poolname
1499
1500         poolname=$(zpool_name $facet)
1501
1502         if [[ -n "$poolname" ]]; then
1503                 do_facet $facet "$ZPOOL set cachefile=none $poolname"
1504         fi
1505 }
1506
1507 #
1508 # This and set_osd_param() shall be used to access OSD parameters
1509 # once existed under "obdfilter":
1510 #
1511 #   mntdev
1512 #   stats
1513 #   read_cache_enable
1514 #   writethrough_cache_enable
1515 #
1516 get_osd_param() {
1517         local nodes=$1
1518         local device=${2:-$FSNAME-OST*}
1519         local name=$3
1520
1521         do_nodes $nodes "$LCTL get_param -n obdfilter.$device.$name \
1522                 osd-*.$device.$name 2>&1" | grep -v 'error:'
1523 }
1524
1525 set_osd_param() {
1526         local nodes=$1
1527         local device=${2:-$FSNAME-OST*}
1528         local name=$3
1529         local value=$4
1530
1531         do_nodes $nodes "$LCTL set_param -n obdfilter.$device.$name=$value \
1532                 osd-*.$device.$name=$value 2>&1" | grep -v 'error:'
1533 }
1534
1535 set_debug_size () {
1536     local dz=${1:-$DEBUG_SIZE}
1537
1538     if [ -f /sys/devices/system/cpu/possible ]; then
1539         local cpus=$(($(cut -d "-" -f 2 /sys/devices/system/cpu/possible)+1))
1540     else
1541         local cpus=$(getconf _NPROCESSORS_CONF 2>/dev/null)
1542     fi
1543
1544     # bug 19944, adjust size to be -gt num_possible_cpus()
1545     # promise 2MB for every cpu at least
1546     if [ -n "$cpus" ] && [ $((cpus * 2)) -gt $dz ]; then
1547         dz=$((cpus * 2))
1548     fi
1549     lctl set_param debug_mb=$dz
1550 }
1551
1552 set_default_debug () {
1553         local debug=${1:-"$PTLDEBUG"}
1554         local subsys=${2:-"$SUBSYSTEM"}
1555         local debug_size=${3:-$DEBUG_SIZE}
1556
1557         [ -n "$debug" ] && lctl set_param debug="$debug" >/dev/null
1558         [ -n "$subsys" ] && lctl set_param subsystem_debug="${subsys# }" >/dev/null
1559
1560         [ -n "$debug_size" ] && set_debug_size $debug_size > /dev/null
1561 }
1562
1563 set_default_debug_nodes () {
1564         local nodes="$1"
1565         local debug="${2:-"$PTLDEBUG"}"
1566         local subsys="${3:-"$SUBSYSTEM"}"
1567         local debug_size="${4:-$DEBUG_SIZE}"
1568
1569         if [[ ,$nodes, = *,$HOSTNAME,* ]]; then
1570                 nodes=$(exclude_items_from_list "$nodes" "$HOSTNAME")
1571                 set_default_debug
1572         fi
1573
1574         [[ -z "$nodes" ]] ||
1575                 do_rpc_nodes "$nodes" set_default_debug \
1576                         \\\"$debug\\\" \\\"$subsys\\\" $debug_size || true
1577 }
1578
1579 set_default_debug_facet () {
1580         local facet=$1
1581         local debug="${2:-"$PTLDEBUG"}"
1582         local subsys="${3:-"$SUBSYSTEM"}"
1583         local debug_size="${4:-$DEBUG_SIZE}"
1584         local node=$(facet_active_host $facet)
1585
1586         [ -n "$node" ] || error "No host defined for facet $facet"
1587
1588         set_default_debug_nodes $node "$debug" "$subsys" $debug_size
1589 }
1590
1591 set_hostid () {
1592     local hostid=${1:-$(hostid)}
1593
1594     if [ ! -s /etc/hostid ]; then
1595         printf $(echo -n $hostid |
1596             sed 's/\(..\)\(..\)\(..\)\(..\)/\\x\4\\x\3\\x\2\\x\1/') >/etc/hostid
1597     fi
1598 }
1599
1600 # Facet functions
1601 mount_facets () {
1602         local facets=${1:-$(get_facets)}
1603         local facet
1604
1605         for facet in ${facets//,/ }; do
1606                 mount_facet $facet
1607                 local RC=$?
1608                 [ $RC -eq 0 ] && continue
1609
1610                 if [ "$TESTSUITE.$TESTNAME" = "replay-dual.test_0a" ]; then
1611                         skip_noexit "Restart of $facet failed!." &&
1612                                 touch $LU482_FAILED
1613                 else
1614                         error "Restart of $facet failed!"
1615                 fi
1616                 return $RC
1617         done
1618 }
1619
1620 #
1621 # Add argument "arg" (e.g., "loop") to the comma-separated list
1622 # of arguments for option "opt" (e.g., "-o") on command
1623 # line "opts" (e.g., "-o flock").
1624 #
1625 csa_add() {
1626         local opts=$1
1627         local opt=$2
1628         local arg=$3
1629         local opt_pattern="\([[:space:]]\+\|^\)$opt"
1630
1631         if echo "$opts" | grep -q $opt_pattern; then
1632                 opts=$(echo "$opts" | sed -e \
1633                         "s/$opt_pattern[[:space:]]*[^[:space:]]\+/&,$arg/")
1634         else
1635                 opts+="${opts:+ }$opt $arg"
1636         fi
1637         echo -n "$opts"
1638 }
1639
1640 #
1641 # Associate loop device with a given regular file.
1642 # Return the loop device.
1643 #
1644 setup_loop_device() {
1645         local facet=$1
1646         local file=$2
1647
1648         do_facet $facet "loop_dev=\\\$($LOSETUP -j $file | cut -d : -f 1);
1649                          if [[ -z \\\$loop_dev ]]; then
1650                                 loop_dev=\\\$($LOSETUP -f);
1651                                 $LOSETUP \\\$loop_dev $file || loop_dev=;
1652                          fi;
1653                          echo -n \\\$loop_dev"
1654 }
1655
1656 #
1657 # Detach a loop device.
1658 #
1659 cleanup_loop_device() {
1660         local facet=$1
1661         local loop_dev=$2
1662
1663         do_facet $facet "! $LOSETUP $loop_dev >/dev/null 2>&1 ||
1664                          $LOSETUP -d $loop_dev"
1665 }
1666
1667 #
1668 # Check if a given device is a block device.
1669 #
1670 is_blkdev() {
1671         local facet=$1
1672         local dev=$2
1673         local size=${3:-""}
1674
1675         [[ -n "$dev" ]] || return 1
1676         do_facet $facet "test -b $dev" || return 1
1677         if [[ -n "$size" ]]; then
1678                 local in=$(do_facet $facet "dd if=$dev of=/dev/null bs=1k \
1679                                             count=1 skip=$size 2>&1" |
1680                                             awk '($3 == "in") { print $1 }')
1681                 [[ "$in" = "1+0" ]] || return 1
1682         fi
1683 }
1684
1685 #
1686 # Check if a given device is a device-mapper device.
1687 #
1688 is_dm_dev() {
1689         local facet=$1
1690         local dev=$2
1691
1692         [[ -n "$dev" ]] || return 1
1693         do_facet $facet "$DMSETUP status $dev >/dev/null 2>&1"
1694 }
1695
1696 #
1697 # Check if a given device is a device-mapper flakey device.
1698 #
1699 is_dm_flakey_dev() {
1700         local facet=$1
1701         local dev=$2
1702         local type
1703
1704         [[ -n "$dev" ]] || return 1
1705
1706         type=$(do_facet $facet "$DMSETUP status $dev 2>&1" |
1707                awk '{print $3}')
1708         [[ $type = flakey ]] && return 0 || return 1
1709 }
1710
1711 #
1712 # Check if device-mapper flakey device is supported by the kernel
1713 # of $facet node or not.
1714 #
1715 dm_flakey_supported() {
1716         local facet=$1
1717
1718         $FLAKEY || return 1
1719         do_facet $facet "modprobe dm-flakey;
1720                          $DMSETUP targets | grep -q flakey" &> /dev/null
1721 }
1722
1723 #
1724 # Get the device-mapper flakey device name of a given facet.
1725 #
1726 dm_facet_devname() {
1727         local facet=$1
1728         [[ $facet = mgs ]] && combined_mgs_mds && facet=mds1
1729
1730         echo -n ${facet}_flakey
1731 }
1732
1733 #
1734 # Get the device-mapper flakey device of a given facet.
1735 # A device created by dmsetup will appear as /dev/mapper/<device-name>.
1736 #
1737 dm_facet_devpath() {
1738         local facet=$1
1739
1740         echo -n $DM_DEV_PATH/$(dm_facet_devname $facet)
1741 }
1742
1743 #
1744 # Set a device-mapper device with a new table.
1745 #
1746 # The table has the following format:
1747 # <logical_start_sector> <num_sectors> <target_type> <target_args>
1748 #
1749 # flakey <target_args> includes:
1750 # <destination_device> <offset> <up_interval> <down_interval> \
1751 # [<num_features> [<feature_arguments>]]
1752 #
1753 # linear <target_args> includes:
1754 # <destination_device> <start_sector>
1755 #
1756 dm_set_dev_table() {
1757         local facet=$1
1758         local dm_dev=$2
1759         local target_type=$3
1760         local num_sectors
1761         local real_dev
1762         local tmp
1763         local table
1764
1765         read tmp num_sectors tmp real_dev tmp \
1766                 <<< $(do_facet $facet "$DMSETUP table $dm_dev")
1767
1768         case $target_type in
1769         flakey)
1770                 table="0 $num_sectors flakey $real_dev 0 0 1800 1 drop_writes"
1771                 ;;
1772         linear)
1773                 table="0 $num_sectors linear $real_dev 0"
1774                 ;;
1775         *) error "invalid target type $target_type" ;;
1776         esac
1777
1778         do_facet $facet "$DMSETUP suspend --nolockfs --noflush $dm_dev" ||
1779                 error "failed to suspend $dm_dev"
1780         do_facet $facet "$DMSETUP load $dm_dev --table \\\"$table\\\"" ||
1781                 error "failed to load $target_type table into $dm_dev"
1782         do_facet $facet "$DMSETUP resume $dm_dev" ||
1783                 error "failed to resume $dm_dev"
1784 }
1785
1786 #
1787 # Set a device-mapper flakey device as "read-only" by using the "drop_writes"
1788 # feature parameter.
1789 #
1790 # drop_writes:
1791 #       All write I/O is silently ignored.
1792 #       Read I/O is handled correctly.
1793 #
1794 dm_set_dev_readonly() {
1795         local facet=$1
1796         local dm_dev=${2:-$(dm_facet_devpath $facet)}
1797
1798         dm_set_dev_table $facet $dm_dev flakey
1799 }
1800
1801 #
1802 # Set a device-mapper device to traditional linear mapping mode.
1803 #
1804 dm_clear_dev_readonly() {
1805         local facet=$1
1806         local dm_dev=${2:-$(dm_facet_devpath $facet)}
1807
1808         dm_set_dev_table $facet $dm_dev linear
1809 }
1810
1811 #
1812 # Set the device of a given facet as "read-only".
1813 #
1814 set_dev_readonly() {
1815         local facet=$1
1816         local svc=${facet}_svc
1817
1818         if [[ $(facet_fstype $facet) = zfs ]] ||
1819            ! dm_flakey_supported $facet; then
1820                 do_facet $facet $LCTL --device ${!svc} readonly
1821         else
1822                 dm_set_dev_readonly $facet
1823         fi
1824 }
1825
1826 #
1827 # Get size in 512-byte sectors (BLKGETSIZE64 / 512) of a given device.
1828 #
1829 get_num_sectors() {
1830         local facet=$1
1831         local dev=$2
1832         local num_sectors
1833
1834         num_sectors=$(do_facet $facet "blockdev --getsz $dev 2>/dev/null")
1835         [[ ${PIPESTATUS[0]} = 0 && -n "$num_sectors" ]] || num_sectors=0
1836         echo -n $num_sectors
1837 }
1838
1839 #
1840 # Create a device-mapper device with a given block device or regular file (will
1841 # be associated with loop device).
1842 # Return the full path of the device-mapper device.
1843 #
1844 dm_create_dev() {
1845         local facet=$1
1846         local real_dev=$2                                  # destination device
1847         local dm_dev_name=${3:-$(dm_facet_devname $facet)} # device name
1848         local dm_dev=$DM_DEV_PATH/$dm_dev_name            # device-mapper device
1849
1850         # check if the device-mapper device to be created already exists
1851         if is_dm_dev $facet $dm_dev; then
1852                 # if the existing device was set to "read-only", then clear it
1853                 ! is_dm_flakey_dev $facet $dm_dev ||
1854                         dm_clear_dev_readonly $facet $dm_dev
1855
1856                 echo -n $dm_dev
1857                 return 0
1858         fi
1859
1860         # check if the destination device is a block device, and if not,
1861         # associate it with a loop device
1862         is_blkdev $facet $real_dev ||
1863                 real_dev=$(setup_loop_device $facet $real_dev)
1864         [[ -n "$real_dev" ]] || { echo -n $real_dev; return 2; }
1865
1866         # now create the device-mapper device
1867         local num_sectors=$(get_num_sectors $facet $real_dev)
1868         local table="0 $num_sectors linear $real_dev 0"
1869         local rc=0
1870
1871         do_facet $facet "$DMSETUP create $dm_dev_name --table \\\"$table\\\"" ||
1872                 { rc=${PIPESTATUS[0]}; dm_dev=; }
1873         do_facet $facet "$DMSETUP mknodes >/dev/null 2>&1"
1874
1875         echo -n $dm_dev
1876         return $rc
1877 }
1878
1879 #
1880 # Map the facet name to its device variable name.
1881 #
1882 facet_device_alias() {
1883         local facet=$1
1884         local dev_alias=$facet
1885
1886         case $facet in
1887                 fs2mds) dev_alias=mds1_2 ;;
1888                 fs2ost) dev_alias=ost1_2 ;;
1889                 fs3ost) dev_alias=ost2_2 ;;
1890                 *) ;;
1891         esac
1892
1893         echo -n $dev_alias
1894 }
1895
1896 #
1897 # Save the original value of the facet device and export the new value.
1898 #
1899 export_dm_dev() {
1900         local facet=$1
1901         local dm_dev=$2
1902
1903         local active_facet=$(facet_active $facet)
1904         local dev_alias=$(facet_device_alias $active_facet)
1905         local dev_name=${dev_alias}_dev
1906         local dev=${!dev_name}
1907
1908         if [[ $active_facet = $facet ]]; then
1909                 local failover_dev=${dev_alias}failover_dev
1910                 if [[ ${!failover_dev} = $dev ]]; then
1911                         eval export ${failover_dev}_saved=$dev
1912                         eval export ${failover_dev}=$dm_dev
1913                 fi
1914         else
1915                 dev_alias=$(facet_device_alias $facet)
1916                 local facet_dev=${dev_alias}_dev
1917                 if [[ ${!facet_dev} = $dev ]]; then
1918                         eval export ${facet_dev}_saved=$dev
1919                         eval export ${facet_dev}=$dm_dev
1920                 fi
1921         fi
1922
1923         eval export ${dev_name}_saved=$dev
1924         eval export ${dev_name}=$dm_dev
1925 }
1926
1927 #
1928 # Restore the saved value of the facet device.
1929 #
1930 unexport_dm_dev() {
1931         local facet=$1
1932
1933         [[ $facet = mgs ]] && combined_mgs_mds && facet=mds1
1934         local dev_alias=$(facet_device_alias $facet)
1935
1936         local saved_dev=${dev_alias}_dev_saved
1937         [[ -z ${!saved_dev} ]] ||
1938                 eval export ${dev_alias}_dev=${!saved_dev}
1939
1940         saved_dev=${dev_alias}failover_dev_saved
1941         [[ -z ${!saved_dev} ]] ||
1942                 eval export ${dev_alias}failover_dev=${!saved_dev}
1943 }
1944
1945 #
1946 # Remove a device-mapper device.
1947 # If the destination device is a loop device, then also detach it.
1948 #
1949 dm_cleanup_dev() {
1950         local facet=$1
1951         local dm_dev=${2:-$(dm_facet_devpath $facet)}
1952         local major
1953         local minor
1954
1955         is_dm_dev $facet $dm_dev || return 0
1956
1957         read major minor <<< $(do_facet $facet "$DMSETUP table $dm_dev" |
1958                 awk '{ print $4 }' | awk -F: '{ print $1" "$2 }')
1959
1960         do_facet $facet "$DMSETUP remove $dm_dev"
1961         do_facet $facet "$DMSETUP mknodes >/dev/null 2>&1"
1962
1963         unexport_dm_dev $facet
1964
1965         # detach a loop device
1966         [[ $major -ne 7 ]] || cleanup_loop_device $facet /dev/loop$minor
1967
1968         # unload dm-flakey module
1969         do_facet $facet "modprobe -r dm-flakey" || true
1970 }
1971
1972 mount_facet() {
1973         local facet=$1
1974         shift
1975         local active_facet=$(facet_active $facet)
1976         local dev_alias=$(facet_device_alias $active_facet)
1977         local dev=${dev_alias}_dev
1978         local opt=${facet}_opt
1979         local mntpt=$(facet_mntpt $facet)
1980         local opts="${!opt} $@"
1981         local fstype=$(facet_fstype $facet)
1982         local devicelabel
1983         local dm_dev=${!dev}
1984
1985         module_loaded lustre || load_modules
1986
1987         case $fstype in
1988         ldiskfs)
1989                 if dm_flakey_supported $facet; then
1990                         dm_dev=$(dm_create_dev $facet ${!dev})
1991                         [[ -n "$dm_dev" ]] || dm_dev=${!dev}
1992                 fi
1993
1994                 is_blkdev $facet $dm_dev || opts=$(csa_add "$opts" -o loop)
1995
1996                 devicelabel=$(do_facet ${facet} "$E2LABEL $dm_dev");;
1997         zfs)
1998                 # import ZFS storage pool
1999                 import_zpool $facet || return ${PIPESTATUS[0]}
2000
2001                 devicelabel=$(do_facet ${facet} "$ZFS get -H -o value \
2002                                                 lustre:svname $dm_dev");;
2003         *)
2004                 error "unknown fstype!";;
2005         esac
2006
2007         echo "Starting ${facet}: $opts $dm_dev $mntpt"
2008         # for testing LU-482 error handling in mount_facets() and test_0a()
2009         if [ -f $TMP/test-lu482-trigger ]; then
2010                 RC=2
2011         else
2012                 do_facet ${facet} \
2013                         "mkdir -p $mntpt; $MOUNT_CMD $opts $dm_dev $mntpt"
2014                 RC=${PIPESTATUS[0]}
2015         fi
2016
2017         if [ $RC -ne 0 ]; then
2018                 echo "Start of $dm_dev on ${facet} failed ${RC}"
2019                 return $RC
2020         fi
2021
2022         health=$(do_facet ${facet} "$LCTL get_param -n health_check")
2023         if [[ "$health" != "healthy" ]]; then
2024                 error "$facet is in a unhealthy state"
2025         fi
2026
2027         set_default_debug_facet $facet
2028
2029         if [[ $opts =~ .*nosvc.* ]]; then
2030                 echo "Start $dm_dev without service"
2031         else
2032
2033                 case $fstype in
2034                 ldiskfs)
2035                         wait_update_facet ${facet} "$E2LABEL $dm_dev \
2036                                 2>/dev/null | grep -E ':[a-zA-Z]{3}[0-9]{4}'" \
2037                                 "" || error "$dm_dev failed to initialize!";;
2038                 zfs)
2039                         wait_update_facet ${facet} "$ZFS get -H -o value \
2040                                 lustre:svname $dm_dev 2>/dev/null | \
2041                                 grep -E ':[a-zA-Z]{3}[0-9]{4}'" "" ||
2042                                 error "$dm_dev failed to initialize!";;
2043
2044                 *)
2045                         error "unknown fstype!";;
2046                 esac
2047         fi
2048
2049         # commit the device label change to disk
2050         if [[ $devicelabel =~ (:[a-zA-Z]{3}[0-9]{4}) ]]; then
2051                 echo "Commit the device label on ${!dev}"
2052                 do_facet $facet "sync; sleep 1; sync"
2053         fi
2054
2055
2056         label=$(devicelabel ${facet} $dm_dev)
2057         [ -z "$label" ] && echo no label for $dm_dev && exit 1
2058         eval export ${facet}_svc=${label}
2059         echo Started ${label}
2060
2061         export_dm_dev $facet $dm_dev
2062
2063         return $RC
2064 }
2065
2066 # start facet device options
2067 start() {
2068         local facet=$1
2069         shift
2070         local device=$1
2071         shift
2072         local dev_alias=$(facet_device_alias $facet)
2073
2074         eval export ${dev_alias}_dev=${device}
2075         eval export ${facet}_opt=\"$@\"
2076
2077         local varname=${dev_alias}failover_dev
2078         if [ -n "${!varname}" ] ; then
2079                 eval export ${dev_alias}failover_dev=${!varname}
2080         else
2081                 eval export ${dev_alias}failover_dev=$device
2082         fi
2083
2084         local mntpt=$(facet_mntpt $facet)
2085         do_facet ${facet} mkdir -p $mntpt
2086         eval export ${facet}_MOUNT=$mntpt
2087         mount_facet ${facet}
2088         RC=$?
2089
2090         return $RC
2091 }
2092
2093 stop() {
2094         local running
2095         local facet=$1
2096         shift
2097         local HOST=$(facet_active_host $facet)
2098         [[ -z $HOST ]] && echo stop: no host for $facet && return 0
2099
2100         local mntpt=$(facet_mntpt $facet)
2101         running=$(do_facet ${facet} "grep -c $mntpt' ' /proc/mounts || true")
2102         if [ ${running} -ne 0 ]; then
2103                 echo "Stopping $mntpt (opts:$@) on $HOST"
2104                 do_facet ${facet} $UMOUNT $@ $mntpt
2105         fi
2106
2107         # umount should block, but we should wait for unrelated obd's
2108         # like the MGS or MGC to also stop.
2109         wait_exit_ST ${facet} || return ${PIPESTATUS[0]}
2110
2111         if [[ $(facet_fstype $facet) == zfs ]]; then
2112                 # export ZFS storage pool
2113                 [ "$KEEP_ZPOOL" = "true" ] || export_zpool $facet
2114         elif dm_flakey_supported $facet; then
2115                 local host=${facet}_HOST
2116                 local failover_host=${facet}failover_HOST
2117                 if [[ -n ${!failover_host} && ${!failover_host} != ${!host} ]]||
2118                         $CLEANUP_DM_DEV || [[ $facet = fs* ]]; then
2119                         dm_cleanup_dev $facet
2120                 fi
2121         fi
2122 }
2123
2124 # get mdt quota type
2125 mdt_quota_type() {
2126         local varsvc=${SINGLEMDS}_svc
2127         do_facet $SINGLEMDS $LCTL get_param -n \
2128                 osd-$(facet_fstype $SINGLEMDS).${!varsvc}.quota_slave.enabled
2129 }
2130
2131 # get ost quota type
2132 ost_quota_type() {
2133         # All OSTs should have same quota type
2134         local varsvc=ost1_svc
2135         do_facet ost1 $LCTL get_param -n \
2136                 osd-$(facet_fstype ost1).${!varsvc}.quota_slave.enabled
2137 }
2138
2139 # restore old quota type settings
2140 restore_quota() {
2141         if [ "$old_MDT_QUOTA_TYPE" ]; then
2142                 if [[ $PERM_CMD == *"set_param -P"* ]]; then
2143                         do_facet mgs $PERM_CMD \
2144                                 osd-*.$FSNAME-MDT*.quota_slave.enable = \
2145                                 $old_MDT_QUOTA_TYPE
2146                 else
2147                         do_facet mgs $PERM_CMD \
2148                                 $FSNAME.quota.mdt=$old_MDT_QUOTA_TYPE
2149                 fi
2150         fi
2151         if [ "$old_OST_QUOTA_TYPE" ]; then
2152                 if [[ $PERM_CMD == *"set_param -P"* ]]; then
2153                         do_facet mgs $PERM_CMD \
2154                                 osd-*.$FSNAME-OST*.quota_slave.enable = \
2155                                 $old_OST_QUOTA_TYPE
2156                 else
2157                         do_facet mgs $LCTL conf_param \
2158                                 $FSNAME.quota.ost=$old_OST_QUOTA_TYPE
2159                 fi
2160         fi
2161 }
2162
2163 # Handle the case when there is a space in the lfs df
2164 # "filesystem summary" line the same as when there is no space.
2165 # This will allow fixing the "lfs df" summary line in the future.
2166 lfs_df() {
2167         $LFS df $* | sed -e 's/filesystem /filesystem_/'
2168 }
2169
2170 # Get free inodes on the MDT specified by mdt index, free indoes on
2171 # the whole filesystem will be returned when index == -1.
2172 mdt_free_inodes() {
2173         local index=$1
2174         local free_inodes
2175         local mdt_uuid
2176
2177         if [ $index -eq -1 ]; then
2178                 mdt_uuid="summary"
2179         else
2180                 mdt_uuid=$(mdtuuid_from_index $index)
2181         fi
2182
2183         free_inodes=$(lfs_df -i $MOUNT | grep $mdt_uuid | awk '{print $4}')
2184         echo $free_inodes
2185 }
2186
2187 #
2188 # Get the OST device status from 'lfs df' with a given OST index.
2189 #
2190 ost_dev_status() {
2191         local ost_idx=$1
2192         local mnt_pnt=${2:-$MOUNT}
2193         local ost_uuid
2194
2195         ost_uuid=$(ostuuid_from_index $ost_idx $mnt_pnt)
2196         lfs_df $mnt_pnt | awk '/'$ost_uuid'/ { print $7 }'
2197 }
2198
2199 setup_quota(){
2200         local mntpt=$1
2201
2202         # save old quota type & set new quota type
2203         local mdt_qtype=$(mdt_quota_type)
2204         local ost_qtype=$(ost_quota_type)
2205
2206         echo "[HOST:$HOSTNAME] [old_mdt_qtype:$mdt_qtype]" \
2207                 "[old_ost_qtype:$ost_qtype] [new_qtype:$QUOTA_TYPE]"
2208
2209         export old_MDT_QUOTA_TYPE=$mdt_qtype
2210         export old_OST_QUOTA_TYPE=$ost_qtype
2211
2212         if [[ $PERM_CMD == *"set_param -P"* ]]; then
2213                 do_facet mgs $PERM_CMD \
2214                         osd-*.$FSNAME-MDT*.quota_slave.enable=$QUOTA_TYPE
2215                 do_facet mgs $PERM_CMD \
2216                         osd-*.$FSNAME-OST*.quota_slave.enable=$QUOTA_TYPE
2217         else
2218                 do_facet mgs $PERM_CMD $FSNAME.quota.mdt=$QUOTA_TYPE ||
2219                         error "set mdt quota type failed"
2220                 do_facet mgs $PERM_CMD $FSNAME.quota.ost=$QUOTA_TYPE ||
2221                         error "set ost quota type failed"
2222         fi
2223
2224         local quota_usrs=$QUOTA_USERS
2225
2226         # get_filesystem_size
2227         local disksz=$(lfs_df $mntpt | grep "summary" | awk '{print $2}')
2228         local blk_soft=$((disksz + 1024))
2229         local blk_hard=$((blk_soft + blk_soft / 20)) # Go 5% over
2230
2231         local inodes=$(lfs_df -i $mntpt | grep "summary" | awk '{print $2}')
2232         local i_soft=$inodes
2233         local i_hard=$((i_soft + i_soft / 20))
2234
2235         echo "Total disk size: $disksz  block-softlimit: $blk_soft" \
2236                 "block-hardlimit: $blk_hard inode-softlimit: $i_soft" \
2237                 "inode-hardlimit: $i_hard"
2238
2239         local cmd
2240         for usr in $quota_usrs; do
2241                 echo "Setting up quota on $HOSTNAME:$mntpt for $usr..."
2242                 for type in u g; do
2243                         cmd="$LFS setquota -$type $usr -b $blk_soft"
2244                         cmd="$cmd -B $blk_hard -i $i_soft -I $i_hard $mntpt"
2245                         echo "+ $cmd"
2246                         eval $cmd || error "$cmd FAILED!"
2247                 done
2248                 # display the quota status
2249                 echo "Quota settings for $usr : "
2250                 $LFS quota -v -u $usr $mntpt || true
2251         done
2252 }
2253
2254 zconf_mount() {
2255         local client=$1
2256         local mnt=$2
2257         local opts=${3:-$MOUNT_OPTS}
2258         opts=${opts:+-o $opts}
2259         local flags=${4:-$MOUNT_FLAGS}
2260
2261         local device=$MGSNID:/$FSNAME$FILESET
2262         if [ -z "$mnt" -o -z "$FSNAME" ]; then
2263                 echo "Bad mount command: opt=$flags $opts dev=$device " \
2264                      "mnt=$mnt"
2265                 exit 1
2266         fi
2267
2268         if $GSS_SK; then
2269                 # update mount option with skpath
2270                 opts=$(add_sk_mntflag $opts)
2271         fi
2272
2273         echo "Starting client: $client: $flags $opts $device $mnt"
2274         do_node $client mkdir -p $mnt
2275         if [ -n "$FILESET" -a -z "$SKIP_FILESET" ];then
2276                 do_node $client $MOUNT_CMD $flags $opts $MGSNID:/$FSNAME \
2277                         $mnt || return 1
2278                 #disable FILESET if not supported
2279                 do_nodes $client lctl get_param -n \
2280                         mdc.$FSNAME-MDT0000*.import | grep -q subtree ||
2281                                 device=$MGSNID:/$FSNAME
2282                 do_node $client mkdir -p $mnt/$FILESET
2283                 do_node $client "! grep -q $mnt' ' /proc/mounts ||
2284                         umount $mnt"
2285         fi
2286         if $GSS_SK && ($SK_UNIQUE_NM || $SK_S2S); then
2287                 # Mount using nodemap key
2288                 local mountkey=$SK_PATH/$FSNAME-nmclient.key
2289                 if $SK_UNIQUE_NM; then
2290                         mountkey=$SK_PATH/nodemap/c0.key
2291                 fi
2292                 local prunedopts=$(echo $opts |
2293                                 sed -e "s#skpath=[^,^ ]*#skpath=$mountkey#g")
2294                 do_node $client $MOUNT_CMD $flags $prunedopts $device $mnt ||
2295                                 return 1
2296         else
2297                 do_node $client $MOUNT_CMD $flags $opts $device $mnt ||
2298                                 return 1
2299         fi
2300
2301         set_default_debug_nodes $client
2302
2303         return 0
2304 }
2305
2306 zconf_umount() {
2307         local client=$1
2308         local mnt=$2
2309         local force
2310         local busy
2311         local need_kill
2312         local running=$(do_node $client "grep -c $mnt' ' /proc/mounts") || true
2313
2314         [ "$3" ] && force=-f
2315         [ $running -eq 0 ] && return 0
2316
2317         echo "Stopping client $client $mnt (opts:$force)"
2318         do_node $client lsof -t $mnt || need_kill=no
2319         if [ "x$force" != "x" ] && [ "x$need_kill" != "xno" ]; then
2320                 pids=$(do_node $client lsof -t $mnt | sort -u);
2321                 if [ -n "$pids" ]; then
2322                         do_node $client kill -9 $pids || true
2323                 fi
2324         fi
2325
2326         busy=$(do_node $client "umount $force $mnt 2>&1" | grep -c "busy") ||
2327                 true
2328         if [ $busy -ne 0 ] ; then
2329                 echo "$mnt is still busy, wait one second" && sleep 1
2330                 do_node $client umount $force $mnt
2331         fi
2332 }
2333
2334 # nodes is comma list
2335 sanity_mount_check_nodes () {
2336     local nodes=$1
2337     shift
2338     local mnts="$@"
2339     local mnt
2340
2341     # FIXME: assume that all cluster nodes run the same os
2342     [ "$(uname)" = Linux ] || return 0
2343
2344     local rc=0
2345     for mnt in $mnts ; do
2346         do_nodes $nodes "running=\\\$(grep -c $mnt' ' /proc/mounts);
2347 mpts=\\\$(mount | grep -c $mnt' ');
2348 if [ \\\$running -ne \\\$mpts ]; then
2349     echo \\\$(hostname) env are INSANE!;
2350     exit 1;
2351 fi"
2352     [ $? -eq 0 ] || rc=1
2353     done
2354     return $rc
2355 }
2356
2357 sanity_mount_check_servers () {
2358     [ -n "$CLIENTONLY" ] &&
2359         { echo "CLIENTONLY mode, skip mount_check_servers"; return 0; } || true
2360     echo Checking servers environments
2361
2362     # FIXME: modify get_facets to display all facets wo params
2363     local facets="$(get_facets OST),$(get_facets MDS),mgs"
2364     local node
2365     local mntpt
2366     local facet
2367     for facet in ${facets//,/ }; do
2368         node=$(facet_host ${facet})
2369         mntpt=$(facet_mntpt $facet)
2370         sanity_mount_check_nodes $node $mntpt ||
2371             { error "server $node environments are insane!"; return 1; }
2372     done
2373 }
2374
2375 sanity_mount_check_clients () {
2376     local clients=${1:-$CLIENTS}
2377     local mntpt=${2:-$MOUNT}
2378     local mntpt2=${3:-$MOUNT2}
2379
2380     [ -z $clients ] && clients=$(hostname)
2381     echo Checking clients $clients environments
2382
2383     sanity_mount_check_nodes $clients $mntpt $mntpt2 ||
2384        error "clients environments are insane!"
2385 }
2386
2387 sanity_mount_check () {
2388     sanity_mount_check_servers || return 1
2389     sanity_mount_check_clients || return 2
2390 }
2391
2392 # mount clients if not mouted
2393 zconf_mount_clients() {
2394         local clients=$1
2395         local mnt=$2
2396         local opts=${3:-$MOUNT_OPTS}
2397         opts=${opts:+-o $opts}
2398         local flags=${4:-$MOUNT_FLAGS}
2399         local device=$MGSNID:/$FSNAME$FILESET
2400         if [ -z "$mnt" -o -z "$FSNAME" ]; then
2401                 echo "Bad conf mount command: opt=$flags $opts dev=$device " \
2402                      "mnt=$mnt"
2403                 exit 1
2404         fi
2405
2406         echo "Starting client $clients: $flags $opts $device $mnt"
2407         do_nodes $clients mkdir -p $mnt
2408         if [ -n "$FILESET" -a -z "$SKIP_FILESET" ]; then
2409                 if $GSS_SK && ($SK_UNIQUE_NM || $SK_S2S); then
2410                         # Mount with own nodemap key
2411                         local i=0
2412                         # Mount all server nodes first with per-NM keys
2413                         for nmclient in ${clients//,/ }; do
2414 #                               do_nodes $(comma_list $(all_server_nodes)) "lgss_sk -t server -l $SK_PATH/nodemap/c$i.key -n c$i"
2415                                 do_nodes $(comma_list $(all_server_nodes)) "lgss_sk -t server -l $SK_PATH/nodemap/c$i.key"
2416                                 i=$((i + 1))
2417                         done
2418                         # set perms for per-nodemap keys else permission denied
2419                         do_nodes $(comma_list $(all_nodes)) \
2420                                 "keyctl show | grep lustre | cut -c1-11 |
2421                                 sed -e 's/ //g;' |
2422                                 xargs -IX keyctl setperm X 0x3f3f3f3f"
2423                         local mountkey=$SK_PATH/$FSNAME-nmclient.key
2424                         i=0
2425                         for nmclient in ${clients//,/ }; do
2426                                 if $SK_UNIQUE_NM; then
2427                                         mountkey=$SK_PATH/nodemap/c$i.key
2428                                 fi
2429                                 do_node $nmclient "! grep -q $mnt' ' \
2430                                         /proc/mounts || umount $mnt"
2431                                 local prunedopts=$(add_sk_mntflag $prunedopts);
2432                                 prunedopts=$(echo $prunedopts | sed -e \
2433                                         "s#skpath=[^ ^,]*#skpath=$mountkey#g")
2434                                 set -x
2435                                 do_nodes $(comma_list $(all_server_nodes)) \
2436                                         "keyctl show"
2437                                 set +x
2438                                 do_node $nmclient $MOUNT_CMD $flags \
2439                                         $prunedopts $MGSNID:/$FSNAME $mnt ||
2440                                         return 1
2441                                 i=$((i + 1))
2442                         done
2443                 else
2444                         do_nodes $clients "! grep -q $mnt' ' /proc/mounts ||
2445                                         umount $mnt"
2446                         do_nodes $clients $MOUNT_CMD $flags $opts \
2447                                         $MGSNID:/$FSNAME $mnt || return 1
2448                 fi
2449                 #disable FILESET if not supported
2450                 do_nodes $clients lctl get_param -n \
2451                         mdc.$FSNAME-MDT0000*.import | grep -q subtree ||
2452                                 device=$MGSNID:/$FSNAME
2453                 do_nodes $clients mkdir -p $mnt/$FILESET
2454                 do_nodes $clients "! grep -q $mnt' ' /proc/mounts ||
2455                         umount $mnt"
2456         fi
2457
2458         if $GSS_SK && ($SK_UNIQUE_NM || $SK_S2S); then
2459                 # Mount with nodemap key
2460                 local i=0
2461                 local mountkey=$SK_PATH/$FSNAME-nmclient.key
2462                 for nmclient in ${clients//,/ }; do
2463                         if $SK_UNIQUE_NM; then
2464                                 mountkey=$SK_PATH/nodemap/c$i.key
2465                         fi
2466                         local prunedopts=$(echo $opts | sed -e \
2467                                 "s#skpath=[^ ^,]*#skpath=$mountkey#g");
2468                         do_node $nmclient "! grep -q $mnt' ' /proc/mounts ||
2469                                 umount $mnt"
2470                         do_node $nmclient "
2471                 running=\\\$(mount | grep -c $mnt' ');
2472                 rc=0;
2473                 if [ \\\$running -eq 0 ] ; then
2474                         mkdir -p $mnt;
2475                         $MOUNT_CMD $flags $prunedopts $device $mnt;
2476                         rc=\\\$?;
2477                 else
2478                         lustre_mnt_count=\\\$(mount | grep $mnt' ' | \
2479                                 grep 'type lustre' | wc -l);
2480                         if [ \\\$running -ne \\\$lustre_mnt_count ] ; then
2481                                 echo zconf_mount_clients FAILED: \
2482                                         mount count \\\$running, not matching \
2483                                         with mount count of 'type lustre' \
2484                                         \\\$lustre_mnt_count;
2485                                 rc=1;
2486                         fi;
2487                 fi;
2488         exit \\\$rc" || return ${PIPESTATUS[0]}
2489
2490                         i=$((i + 1))
2491                 done
2492         else
2493
2494                 local tmpopts=$opts
2495                 if $SHARED_KEY; then
2496                         tmpopts=$(add_sk_mntflag $opts)
2497                 fi
2498                 do_nodes $clients "
2499 running=\\\$(mount | grep -c $mnt' ');
2500 rc=0;
2501 if [ \\\$running -eq 0 ] ; then
2502         mkdir -p $mnt;
2503         $MOUNT_CMD $flags $tmpopts $device $mnt;
2504         rc=\\\$?;
2505 fi;
2506 exit \\\$rc" || return ${PIPESTATUS[0]}
2507         fi
2508
2509         echo "Started clients $clients: "
2510         do_nodes $clients "mount | grep $mnt' '"
2511
2512         set_default_debug_nodes $clients
2513
2514         return 0
2515 }
2516
2517 zconf_umount_clients() {
2518     local clients=$1
2519     local mnt=$2
2520     local force
2521
2522     [ "$3" ] && force=-f
2523
2524     echo "Stopping clients: $clients $mnt (opts:$force)"
2525     do_nodes $clients "running=\\\$(grep -c $mnt' ' /proc/mounts);
2526 if [ \\\$running -ne 0 ] ; then
2527 echo Stopping client \\\$(hostname) $mnt opts:$force;
2528 lsof $mnt || need_kill=no;
2529 if [ "x$force" != "x" -a "x\\\$need_kill" != "xno" ]; then
2530     pids=\\\$(lsof -t $mnt | sort -u);
2531     if [ -n \\\"\\\$pids\\\" ]; then
2532              kill -9 \\\$pids;
2533     fi
2534 fi;
2535 while umount $force $mnt 2>&1 | grep -q "busy"; do
2536     echo "$mnt is still busy, wait one second" && sleep 1;
2537 done;
2538 fi"
2539 }
2540
2541 shutdown_node () {
2542     local node=$1
2543     echo + $POWER_DOWN $node
2544     $POWER_DOWN $node
2545 }
2546
2547 shutdown_node_hard () {
2548     local host=$1
2549     local attempts=$SHUTDOWN_ATTEMPTS
2550
2551     for i in $(seq $attempts) ; do
2552         shutdown_node $host
2553         sleep 1
2554         wait_for_function --quiet "! ping -w 3 -c 1 $host" 5 1 && return 0
2555         echo "waiting for $host to fail attempts=$attempts"
2556         [ $i -lt $attempts ] || \
2557             { echo "$host still pingable after power down! attempts=$attempts" && return 1; }
2558     done
2559 }
2560
2561 shutdown_client() {
2562     local client=$1
2563     local mnt=${2:-$MOUNT}
2564     local attempts=3
2565
2566     if [ "$FAILURE_MODE" = HARD ]; then
2567         shutdown_node_hard $client
2568     else
2569        zconf_umount_clients $client $mnt -f
2570     fi
2571 }
2572
2573 facets_on_host () {
2574     local host=$1
2575     local facets="$(get_facets OST),$(get_facets MDS)"
2576     local affected
2577
2578     combined_mgs_mds || facets="$facets,mgs"
2579
2580     for facet in ${facets//,/ }; do
2581         if [ $(facet_active_host $facet) == $host ]; then
2582            affected="$affected $facet"
2583         fi
2584     done
2585
2586     echo $(comma_list $affected)
2587 }
2588
2589 facet_up() {
2590         local facet=$1
2591         local host=${2:-$(facet_host $facet)}
2592
2593         local label=$(convert_facet2label $facet)
2594         do_node $host $LCTL dl | awk '{ print $4 }' | grep -q "^$label\$"
2595 }
2596
2597 facets_up_on_host () {
2598     local host=$1
2599     local facets=$(facets_on_host $host)
2600     local affected_up
2601
2602     for facet in ${facets//,/ }; do
2603         if $(facet_up $facet $host); then
2604             affected_up="$affected_up $facet"
2605         fi
2606     done
2607
2608     echo $(comma_list $affected_up)
2609 }
2610
2611 shutdown_facet() {
2612         local facet=$1
2613         local affected_facet
2614         local affected_facets
2615
2616         if [[ "$FAILURE_MODE" = HARD ]]; then
2617                 if [[ $(facet_fstype $facet) = ldiskfs ]] &&
2618                         dm_flakey_supported $facet; then
2619                         affected_facets=$(affected_facets $facet)
2620                         for affected_facet in ${affected_facets//,/ }; do
2621                                 unexport_dm_dev $affected_facet
2622                         done
2623                 fi
2624
2625                 shutdown_node_hard $(facet_active_host $facet)
2626         else
2627                 stop $facet
2628         fi
2629 }
2630
2631 reboot_node() {
2632     local node=$1
2633     echo + $POWER_UP $node
2634     $POWER_UP $node
2635 }
2636
2637 remount_facet() {
2638     local facet=$1
2639
2640     stop $facet
2641     mount_facet $facet
2642 }
2643
2644 reboot_facet() {
2645         local facet=$1
2646         if [ "$FAILURE_MODE" = HARD ]; then
2647                 reboot_node $(facet_active_host $facet)
2648         else
2649                 sleep 10
2650         fi
2651 }
2652
2653 boot_node() {
2654     local node=$1
2655     if [ "$FAILURE_MODE" = HARD ]; then
2656        reboot_node $node
2657        wait_for_host $node
2658     fi
2659 }
2660
2661 facets_hosts () {
2662     local facets=$1
2663     local hosts
2664
2665     for facet in ${facets//,/ }; do
2666         hosts=$(expand_list $hosts $(facet_host $facet) )
2667     done
2668
2669     echo $hosts
2670 }
2671
2672 _check_progs_installed () {
2673     local progs=$@
2674     local rc=0
2675
2676     for prog in $progs; do
2677         if ! [ "$(which $prog)"  -o  "${!prog}" ]; then
2678            echo $prog missing on $(hostname)
2679            rc=1
2680         fi
2681     done
2682     return $rc
2683 }
2684
2685 check_progs_installed () {
2686         local nodes=$1
2687         shift
2688
2689         do_rpc_nodes "$nodes" _check_progs_installed $@
2690 }
2691
2692 # recovery-scale functions
2693 node_var_name() {
2694     echo __$(echo $1 | tr '-' '_' | tr '.' '_')
2695 }
2696
2697 start_client_load() {
2698         local client=$1
2699         local load=$2
2700         local var=$(node_var_name $client)_load
2701         eval export ${var}=$load
2702
2703         do_node $client "PATH=$PATH MOUNT=$MOUNT ERRORS_OK=$ERRORS_OK \
2704                         BREAK_ON_ERROR=$BREAK_ON_ERROR \
2705                         END_RUN_FILE=$END_RUN_FILE \
2706                         LOAD_PID_FILE=$LOAD_PID_FILE \
2707                         TESTLOG_PREFIX=$TESTLOG_PREFIX \
2708                         TESTNAME=$TESTNAME \
2709                         DBENCH_LIB=$DBENCH_LIB \
2710                         DBENCH_SRC=$DBENCH_SRC \
2711                         CLIENT_COUNT=$((CLIENTCOUNT - 1)) \
2712                         LFS=$LFS \
2713                         LCTL=$LCTL \
2714                         FSNAME=$FSNAME \
2715                         MPIRUN=$MPIRUN \
2716                         MPIRUN_OPTIONS=\\\"$MPIRUN_OPTIONS\\\" \
2717                         MACHINEFILE_OPTION=\\\"$MACHINEFILE_OPTION\\\" \
2718                         num_clients=$(get_node_count ${CLIENTS//,/ }) \
2719                         ior_THREADS=$ior_THREADS ior_iteration=$ior_iteration \
2720                         ior_blockSize=$ior_blockSize \
2721                         ior_blockUnit=$ior_blockUnit \
2722                         ior_xferSize=$ior_xferSize ior_type=$ior_type \
2723                         ior_DURATION=$ior_DURATION \
2724                         ior_stripe_params=\\\"$ior_stripe_params\\\" \
2725                         ior_custom_params=\\\"$ior_custom_param\\\" \
2726                         mpi_ior_custom_threads=$mpi_ior_custom_threads \
2727                         run_${load}.sh" &
2728         local ppid=$!
2729         log "Started client load: ${load} on $client"
2730
2731         # get the children process IDs
2732         local pids=$(ps --ppid $ppid -o pid= | xargs)
2733         CLIENT_LOAD_PIDS="$CLIENT_LOAD_PIDS $ppid $pids"
2734         return 0
2735 }
2736
2737 start_client_loads () {
2738         local -a clients=(${1//,/ })
2739         local numloads=${#CLIENT_LOADS[@]}
2740
2741         for ((nodenum=0; nodenum < ${#clients[@]}; nodenum++ )); do
2742                 local load=$((nodenum % numloads))
2743                 start_client_load ${clients[nodenum]} ${CLIENT_LOADS[load]}
2744         done
2745         # bug 22169: wait the background threads to start
2746         sleep 2
2747 }
2748
2749 # only for remote client
2750 check_client_load () {
2751         local client=$1
2752         local var=$(node_var_name $client)_load
2753         local testload=run_${!var}.sh
2754
2755         ps auxww | grep -v grep | grep $client | grep -q $testload || return 1
2756
2757         # bug 18914: try to connect several times not only when
2758         # check ps, but  while check_node_health also
2759
2760         local tries=3
2761         local RC=254
2762         while [ $RC = 254 -a $tries -gt 0 ]; do
2763                 let tries=$tries-1
2764                 # assume success
2765                 RC=0
2766                 if ! check_node_health $client; then
2767                         RC=${PIPESTATUS[0]}
2768                         if [ $RC -eq 254 ]; then
2769                                 # FIXME: not sure how long we shuold sleep here
2770                                 sleep 10
2771                                 continue
2772                         fi
2773                         echo "check node health failed: RC=$RC "
2774                         return $RC
2775                 fi
2776         done
2777         # We can continue try to connect if RC=254
2778         # Just print the warning about this
2779         if [ $RC = 254 ]; then
2780                 echo "got a return status of $RC from do_node while checking " \
2781                 "node health on $client"
2782         fi
2783
2784         # see if the load is still on the client
2785         tries=3
2786         RC=254
2787         while [ $RC = 254 -a $tries -gt 0 ]; do
2788                 let tries=$tries-1
2789                 # assume success
2790                 RC=0
2791                 if ! do_node $client \
2792                         "ps auxwww | grep -v grep | grep -q $testload"; then
2793                         RC=${PIPESTATUS[0]}
2794                         sleep 30
2795                 fi
2796         done
2797         if [ $RC = 254 ]; then
2798                 echo "got a return status of $RC from do_node while checking " \
2799                 "(node health and 'ps') the client load on $client"
2800                 # see if we can diagnose a bit why this is
2801         fi
2802
2803         return $RC
2804 }
2805 check_client_loads () {
2806    local clients=${1//,/ }
2807    local client=
2808    local rc=0
2809
2810    for client in $clients; do
2811       check_client_load $client
2812       rc=${PIPESTATUS[0]}
2813       if [ "$rc" != 0 ]; then
2814         log "Client load failed on node $client, rc=$rc"
2815         return $rc
2816       fi
2817    done
2818 }
2819
2820 restart_client_loads () {
2821     local clients=${1//,/ }
2822     local expectedfail=${2:-""}
2823     local client=
2824     local rc=0
2825
2826     for client in $clients; do
2827         check_client_load $client
2828         rc=${PIPESTATUS[0]}
2829         if [ "$rc" != 0 -a "$expectedfail" ]; then
2830             local var=$(node_var_name $client)_load
2831             start_client_load $client ${!var}
2832             echo "Restarted client load ${!var}: on $client. Checking ..."
2833             check_client_load $client
2834             rc=${PIPESTATUS[0]}
2835             if [ "$rc" != 0 ]; then
2836                 log "Client load failed to restart on node $client, rc=$rc"
2837                 # failure one client load means test fail
2838                 # we do not need to check other
2839                 return $rc
2840             fi
2841         else
2842             return $rc
2843         fi
2844     done
2845 }
2846
2847 # Start vmstat and save its process ID in a file.
2848 start_vmstat() {
2849     local nodes=$1
2850     local pid_file=$2
2851
2852     [ -z "$nodes" -o -z "$pid_file" ] && return 0
2853
2854     do_nodes $nodes \
2855         "vmstat 1 > $TESTLOG_PREFIX.$TESTNAME.vmstat.\\\$(hostname -s).log \
2856         2>/dev/null </dev/null & echo \\\$! > $pid_file"
2857 }
2858
2859 # Display the nodes on which client loads failed.
2860 print_end_run_file() {
2861     local file=$1
2862     local node
2863
2864     [ -s $file ] || return 0
2865
2866     echo "Found the END_RUN_FILE file: $file"
2867     cat $file
2868
2869     # A client load will stop if it finds the END_RUN_FILE file.
2870     # That does not mean the client load actually failed though.
2871     # The first node in END_RUN_FILE is the one we are interested in.
2872     read node < $file
2873
2874     if [ -n "$node" ]; then
2875         local var=$(node_var_name $node)_load
2876
2877         local prefix=$TESTLOG_PREFIX
2878         [ -n "$TESTNAME" ] && prefix=$prefix.$TESTNAME
2879         local stdout_log=$prefix.run_${!var}_stdout.$node.log
2880         local debug_log=$(echo $stdout_log | sed 's/\(.*\)stdout/\1debug/')
2881
2882         echo "Client load ${!var} failed on node $node:"
2883         echo "$stdout_log"
2884         echo "$debug_log"
2885     fi
2886 }
2887
2888 # Stop the process which had its PID saved in a file.
2889 stop_process() {
2890     local nodes=$1
2891     local pid_file=$2
2892
2893     [ -z "$nodes" -o -z "$pid_file" ] && return 0
2894
2895     do_nodes $nodes "test -f $pid_file &&
2896         { kill -s TERM \\\$(cat $pid_file); rm -f $pid_file; }" || true
2897 }
2898
2899 # Stop all client loads.
2900 stop_client_loads() {
2901     local nodes=${1:-$CLIENTS}
2902     local pid_file=$2
2903
2904     # stop the client loads
2905     stop_process $nodes $pid_file
2906
2907     # clean up the processes that started them
2908     [ -n "$CLIENT_LOAD_PIDS" ] && kill -9 $CLIENT_LOAD_PIDS 2>/dev/null || true
2909 }
2910 # End recovery-scale functions
2911
2912 # verify that lustre actually cleaned up properly
2913 cleanup_check() {
2914         VAR=$(lctl get_param -n catastrophe 2>&1)
2915         if [ $? = 0 ] ; then
2916                 if [ $VAR != 0 ]; then
2917                         error "LBUG/LASSERT detected"
2918                 fi
2919         fi
2920         BUSY=$(dmesg | grep -i destruct || true)
2921         if [ -n "$BUSY" ]; then
2922                 echo "$BUSY" 1>&2
2923                 [ -e $TMP/debug ] && mv $TMP/debug $TMP/debug-busy.$(date +%s)
2924                 exit 205
2925         fi
2926
2927         check_mem_leak || exit 204
2928
2929         [[ $($LCTL dl 2>/dev/null | wc -l) -gt 0 ]] && $LCTL dl &&
2930                 echo "$TESTSUITE: lustre didn't clean up..." 1>&2 &&
2931                 return 202 || true
2932
2933         if module_loaded lnet || module_loaded libcfs; then
2934                 echo "$TESTSUITE: modules still loaded..." 1>&2
2935                 /sbin/lsmod 1>&2
2936                 return 203
2937         fi
2938         return 0
2939 }
2940
2941 wait_update () {
2942         local verbose=false
2943         if [[ "$1" == "--verbose" ]]; then
2944                 shift
2945                 verbose=true
2946         fi
2947
2948         local node=$1
2949         local TEST=$2
2950         local FINAL=$3
2951         local MAX=${4:-90}
2952         local RESULT
2953         local PREV_RESULT
2954         local WAIT=0
2955         local sleep=1
2956         local print=10
2957
2958         PREV_RESULT=$(do_node $node "$TEST")
2959         while [ true ]; do
2960                 RESULT=$(do_node $node "$TEST")
2961                 if [[ "$RESULT" == "$FINAL" ]]; then
2962                         [[ -z "$RESULT" || $WAIT -le $sleep ]] ||
2963                                 echo "Updated after ${WAIT}s: wanted '$FINAL'"\
2964                                      "got '$RESULT'"
2965                         return 0
2966                 fi
2967                 if [[ $verbose && "$RESULT" != "$PREV_RESULT" ]]; then
2968                         echo "Changed after ${WAIT}s: from '$PREV_RESULT'"\
2969                              "to '$RESULT'"
2970                         PREV_RESULT=$RESULT
2971                 fi
2972                 [[ $WAIT -ge $MAX ]] && break
2973                 [[ $((WAIT % print)) -eq 0 ]] &&
2974                         echo "Waiting $((MAX - WAIT)) secs for update"
2975                 WAIT=$((WAIT + sleep))
2976                 sleep $sleep
2977         done
2978         echo "Update not seen after ${MAX}s: wanted '$FINAL' got '$RESULT'"
2979         return 3
2980 }
2981
2982 wait_update_facet() {
2983         local verbose=
2984         [ "$1" = "--verbose" ] && verbose="$1" && shift
2985
2986         local facet=$1
2987         shift
2988         wait_update $verbose $(facet_active_host $facet) "$@"
2989 }
2990
2991 sync_all_data() {
2992         do_nodes $(comma_list $(mdts_nodes)) \
2993             "lctl set_param -n os[cd]*.*MDT*.force_sync=1"
2994         do_nodes $(comma_list $(osts_nodes)) \
2995             "lctl set_param -n osd*.*OS*.force_sync=1" 2>&1 |
2996                 grep -v 'Found no match'
2997 }
2998
2999 wait_zfs_commit() {
3000         local zfs_wait=${2:-5}
3001
3002         # the occupied disk space will be released
3003         # only after TXGs are committed
3004         if [[ $(facet_fstype $1) == zfs ]]; then
3005                 echo "sleep $zfs_wait for ZFS $(facet_fstype $1)"
3006                 sleep $zfs_wait
3007         fi
3008 }
3009
3010 fill_ost() {
3011         local filename=$1
3012         local ost_idx=$2
3013         local lwm=$3  #low watermark
3014         local size_mb #how many MB should we write to pass watermark
3015         local ost_name=$(ostname_from_index $ost_idx)
3016
3017         free_kb=$($LFS df $MOUNT | awk "/$ost_name/ { print \$4 }")
3018         size_mb=0
3019         if (( $free_kb / 1024 > lwm )); then
3020                 size_mb=$((free_kb / 1024 - lwm))
3021         fi
3022         #If 10% of free space cross low watermark use it
3023         if (( $free_kb / 10240 > size_mb )); then
3024                 size_mb=$((free_kb / 10240))
3025         else
3026                 #At least we need to store 1.1 of difference between
3027                 #free space and low watermark
3028                 size_mb=$((size_mb + size_mb / 10))
3029         fi
3030         if (( lwm <= $free_kb / 1024 )) ||
3031            [ ! -f $DIR/${filename}.fill_ost$ost_idx ]; then
3032                 $LFS setstripe -i $ost_idx -c1 $DIR/${filename}.fill_ost$ost_idx
3033                 dd if=/dev/zero of=$DIR/${filename}.fill_ost$ost_idx bs=1M \
3034                         count=$size_mb oflag=append conv=notrunc
3035         fi
3036
3037         sleep_maxage
3038
3039         free_kb=$($LFS df $MOUNT | awk "/$ost_name/ { print \$4 }")
3040         echo "OST still has $((free_kb / 1024)) MB free"
3041 }
3042
3043 # This checks only the primary MDS
3044 ost_watermarks_get() {
3045         local ost_idx=$1
3046         local ost_name=$(ostname_from_index $ost_idx)
3047         local mdtosc_proc=$(get_mdtosc_proc_path $SINGLEMDS $ost_name)
3048
3049         local hwm=$(do_facet $SINGLEMDS $LCTL get_param -n \
3050                         osp.$mdtosc_proc.reserved_mb_high)
3051         local lwm=$(do_facet $SINGLEMDS $LCTL get_param -n \
3052                         osp.$mdtosc_proc.reserved_mb_low)
3053
3054         echo "$lwm $hwm"
3055 }
3056
3057 # Note that we set watermarks on all MDSes (necessary for striped dirs)
3058 ost_watermarks_set() {
3059         local ost_idx=$1
3060         local lwm=$2
3061         local hwm=$3
3062         local ost_name=$(ostname_from_index $ost_idx)
3063         local facets=$(get_facets MDS)
3064
3065         do_nodes $(comma_list $(mdts_nodes)) $LCTL set_param -n \
3066                 osp.*$ost_name*.reserved_mb_low=$lwm \
3067                 osp.*$ost_name*.reserved_mb_high=$hwm > /dev/null
3068
3069         # sleep to ensure we see the change
3070         sleep_maxage
3071 }
3072
3073 ost_watermarks_set_low_space() {
3074         local ost_idx=$1
3075         local wms=$(ost_watermarks_get $ost_idx)
3076         local ost_name=$(ostname_from_index $ost_idx)
3077
3078         local old_lwm=$(echo $wms | awk '{ print $1 }')
3079         local old_hwm=$(echo $wms | awk '{ print $2 }')
3080
3081         local blocks=$($LFS df $MOUNT | awk "/$ost_name/ { print \$4 }")
3082         # minimal extension size is 64M
3083         local new_lwm=50
3084         if (( $blocks / 1024 > 50 )); then
3085                 new_lwm=$((blocks / 1024 - 50))
3086         fi
3087         local new_hwm=$((new_lwm + 5))
3088
3089         ost_watermarks_set $ost_idx $new_lwm $new_hwm
3090         echo "watermarks: $old_lwm $old_hwm $new_lwm $new_hwm"
3091 }
3092
3093 # Set watermarks to ~current available space & then write data to fill it
3094 # Note OST is not *actually* full after this, it just reports ENOSPC in the
3095 # internal statfs used by the stripe allocator
3096 #
3097 # first parameter is the filename-prefix, which must get under t-f cleanup
3098 # requirements (rm -rf $DIR/[Rdfs][0-9]*), i.e. $tfile work fine
3099 ost_watermarks_set_enospc() {
3100         local filename=$1
3101         local ost_idx=$2
3102         # on the mdt's osc
3103         local ost_name=$(ostname_from_index $ost_idx)
3104         local facets=$(get_facets MDS)
3105         local wms
3106         local MDS
3107
3108         for MDS in ${facets//,/ }; do
3109                 local mdtosc_proc=$(get_mdtosc_proc_path $MDS $ost_name)
3110
3111                 do_facet $MDS $LCTL get_param -n \
3112                         osp.$mdtosc_proc.reserved_mb_high ||
3113                         skip  "remote MDS does not support reserved_mb_high"
3114         done
3115
3116         wms=$(ost_watermarks_set_low_space $ost_idx)
3117         local new_lwm=$(echo $wms | awk '{ print $4 }')
3118         fill_ost $filename $ost_idx $new_lwm
3119         #First enospc could execute orphan deletion so repeat
3120         fill_ost $filename $ost_idx $new_lwm
3121         echo $wms
3122 }
3123
3124 ost_watermarks_enospc_delete_files() {
3125         local filename=$1
3126         local ost_idx=$2
3127
3128         rm -f $DIR/${filename}.fill_ost$ost_idx
3129
3130         wait_delete_completed
3131         wait_mds_ost_sync
3132 }
3133
3134 # clean up from "ost_watermarks_set_enospc"
3135 ost_watermarks_clear_enospc() {
3136         local filename=$1
3137         local ost_idx=$2
3138         local old_lwm=$4
3139         local old_hwm=$5
3140
3141         ost_watermarks_enospc_delete_files $filename $ost_idx
3142         ost_watermarks_set $ost_idx $old_lwm $old_hwm
3143         echo "set OST$ost_idx lwm back to $old_lwm, hwm back to $old_hwm"
3144 }
3145
3146 wait_delete_completed_mds() {
3147         local max_wait=${1:-20}
3148         local mds2sync=""
3149         local stime=$(date +%s)
3150         local etime
3151         local node
3152         local changes
3153
3154         # find MDS with pending deletions
3155         for node in $(mdts_nodes); do
3156                 changes=$(do_node $node "$LCTL get_param -n osc.*MDT*.sync_*" \
3157                         2>/dev/null | calc_sum)
3158                 if [[ $changes -eq 0 ]]; then
3159                         continue
3160                 fi
3161                 mds2sync="$mds2sync $node"
3162         done
3163         if [ -z "$mds2sync" ]; then
3164                 wait_zfs_commit $SINGLEMDS
3165                 return 0
3166         fi
3167         mds2sync=$(comma_list $mds2sync)
3168
3169         # sync MDS transactions
3170         do_nodes $mds2sync "$LCTL set_param -n os[cd]*.*MD*.force_sync 1"
3171
3172         # wait till all changes are sent and commmitted by OSTs
3173         # for ldiskfs space is released upon execution, but DMU
3174         # do this upon commit
3175
3176         local WAIT=0
3177         while [[ $WAIT -ne $max_wait ]]; do
3178                 changes=$(do_nodes $mds2sync \
3179                         "$LCTL get_param -n osc.*MDT*.sync_*" | calc_sum)
3180                 #echo "$node: $changes changes on all"
3181                 if [[ $changes -eq 0 ]]; then
3182                         wait_zfs_commit $SINGLEMDS
3183
3184                         # the occupied disk space will be released
3185                         # only after TXGs are committed
3186                         wait_zfs_commit ost1
3187                         return 0
3188                 fi
3189                 sleep 1
3190                 WAIT=$((WAIT + 1))
3191         done
3192
3193         etime=$(date +%s)
3194         echo "Delete is not completed in $((etime - stime)) seconds"
3195         do_nodes $mds2sync "$LCTL get_param osc.*MDT*.sync_*"
3196         return 1
3197 }
3198
3199 wait_for_host() {
3200     local hostlist=$1
3201
3202     # we can use "for" here because we are waiting the slowest
3203     for host in ${hostlist//,/ }; do
3204         check_network "$host" 900
3205     done
3206     while ! do_nodes $hostlist hostname  > /dev/null; do sleep 5; done
3207 }
3208
3209 wait_for_facet() {
3210     local facetlist=$1
3211     local hostlist
3212
3213     for facet in ${facetlist//,/ }; do
3214         hostlist=$(expand_list $hostlist $(facet_active_host $facet))
3215     done
3216     wait_for_host $hostlist
3217 }
3218
3219 _wait_recovery_complete () {
3220     local param=$1
3221
3222     # Use default policy if $2 is not passed by caller.
3223     local MAX=${2:-$(max_recovery_time)}
3224
3225     local WAIT=0
3226     local STATUS=
3227
3228     while [ $WAIT -lt $MAX ]; do
3229         STATUS=$(lctl get_param -n $param | grep status)
3230         echo $param $STATUS
3231         [[ $STATUS = "status: COMPLETE" || $STATUS = "status: INACTIVE" ]] && return 0
3232         sleep 5
3233         WAIT=$((WAIT + 5))
3234         echo "Waiting $((MAX - WAIT)) secs for $param recovery done. $STATUS"
3235     done
3236     echo "$param recovery not done in $MAX sec. $STATUS"
3237     return 1
3238 }
3239
3240 wait_recovery_complete () {
3241     local facet=$1
3242
3243     # with an assumption that at_max is the same on all nodes
3244     local MAX=${2:-$(max_recovery_time)}
3245
3246     local facets=$facet
3247     if [ "$FAILURE_MODE" = HARD ]; then
3248         facets=$(facets_on_host $(facet_active_host $facet))
3249     fi
3250     echo affected facets: $facets
3251
3252         # we can use "for" here because we are waiting the slowest
3253         for facet in ${facets//,/ }; do
3254                 local var_svc=${facet}_svc
3255                 local param="*.${!var_svc}.recovery_status"
3256
3257                 local host=$(facet_active_host $facet)
3258                 do_rpc_nodes "$host" _wait_recovery_complete $param $MAX
3259         done
3260 }
3261
3262 wait_mds_ost_sync () {
3263         # just because recovery is done doesn't mean we've finished
3264         # orphan cleanup. Wait for llogs to get synchronized.
3265         echo "Waiting for orphan cleanup..."
3266         # MAX value includes time needed for MDS-OST reconnection
3267         local MAX=$(( TIMEOUT * 2 ))
3268         local WAIT_TIMEOUT=${1:-$MAX}
3269         local WAIT=0
3270         local new_wait=true
3271         local list=$(comma_list $(mdts_nodes))
3272         local cmd="$LCTL get_param -n osp.*osc*.old_sync_processed"
3273         if ! do_facet $SINGLEMDS \
3274                 "$LCTL list_param osp.*osc*.old_sync_processed 2> /dev/null"
3275         then
3276                 # old way, use mds_sync
3277                 new_wait=false
3278                 list=$(comma_list $(osts_nodes))
3279                 cmd="$LCTL get_param -n obdfilter.*.mds_sync"
3280         fi
3281
3282         echo "wait $WAIT_TIMEOUT secs maximumly for $list mds-ost sync done."
3283         while [ $WAIT -lt $WAIT_TIMEOUT ]; do
3284                 local -a sync=($(do_nodes $list "$cmd"))
3285                 local con=1
3286                 local i
3287                 for ((i=0; i<${#sync[@]}; i++)); do
3288                         if $new_wait; then
3289                                 [ ${sync[$i]} -eq 1 ] && continue
3290                         else
3291                                 [ ${sync[$i]} -eq 0 ] && continue
3292                         fi
3293                         # there is a not finished MDS-OST synchronization
3294                         con=0
3295                         break;
3296                 done
3297                 sleep 2 # increase waiting time and cover statfs cache
3298                 [ ${con} -eq 1 ] && return 0
3299                 echo "Waiting $WAIT secs for $list $i mds-ost sync done."
3300                 WAIT=$((WAIT + 2))
3301         done
3302
3303         # show which nodes are not finished.
3304         cmd=$(echo $cmd | sed 's/-n//')
3305         do_nodes $list "$cmd"
3306         echo "$facet recovery node $i not done in $WAIT_TIMEOUT sec. $STATUS"
3307         return 1
3308 }
3309
3310 # Wait OSTs to be active on both client and MDT side.
3311 wait_osts_up() {
3312         local cmd="$LCTL get_param -n lov.$FSNAME-clilov-*.target_obd |
3313                 awk 'BEGIN {c = 0} /ACTIVE/{c += 1} END {printf \\\"%d\\\", c}'"
3314         wait_update $HOSTNAME "eval $cmd" $OSTCOUNT ||
3315                 error "wait_update OSTs up on client failed"
3316
3317         cmd="$LCTL get_param osp.$FSNAME-OST*-MDT0000.prealloc_last_id |
3318              awk '/=[1-9][0-9]/ { c += 1 } END { printf \\\"%d\\\", c }'"
3319         wait_update_facet $SINGLEMDS "eval $cmd" $OSTCOUNT ||
3320                 error "wait_update OSTs up on MDT0000 failed"
3321 }
3322
3323 wait_destroy_complete () {
3324         echo "Waiting for local destroys to complete"
3325         # MAX value shouldn't be big as this mean server responsiveness
3326         # never increase this just to make test pass but investigate
3327         # why it takes so long time
3328         local MAX=5
3329         local WAIT=0
3330         while [ $WAIT -lt $MAX ]; do
3331                 local -a RPCs=($($LCTL get_param -n osc.*.destroys_in_flight))
3332                 local con=1
3333                 local i
3334
3335                 for ((i=0; i<${#RPCs[@]}; i++)); do
3336                         [ ${RPCs[$i]} -eq 0 ] && continue
3337                         # there are still some destroy RPCs in flight
3338                         con=0
3339                         break;
3340                 done
3341                 sleep 1
3342                 [ ${con} -eq 1 ] && return 0 # done waiting
3343                 echo "Waiting ${WAIT}s for local destroys to complete"
3344                 WAIT=$((WAIT + 1))
3345         done
3346         echo "Local destroys weren't done in $MAX sec."
3347         return 1
3348 }
3349
3350 wait_delete_completed() {
3351         wait_delete_completed_mds $1 || return $?
3352         wait_destroy_complete || return $?
3353 }
3354
3355 wait_exit_ST () {
3356     local facet=$1
3357
3358     local WAIT=0
3359     local INTERVAL=1
3360     local running
3361     # conf-sanity 31 takes a long time cleanup
3362     while [ $WAIT -lt 300 ]; do
3363         running=$(do_facet ${facet} "lsmod | grep lnet > /dev/null &&
3364 lctl dl | grep ' ST ' || true")
3365         [ -z "${running}" ] && return 0
3366         echo "waited $WAIT for${running}"
3367         [ $INTERVAL -lt 64 ] && INTERVAL=$((INTERVAL + INTERVAL))
3368         sleep $INTERVAL
3369         WAIT=$((WAIT + INTERVAL))
3370     done
3371     echo "service didn't stop after $WAIT seconds.  Still running:"
3372     echo ${running}
3373     return 1
3374 }
3375
3376 wait_remote_prog () {
3377    local prog=$1
3378    local WAIT=0
3379    local INTERVAL=5
3380    local rc=0
3381
3382    [ "$PDSH" = "no_dsh" ] && return 0
3383
3384    while [ $WAIT -lt $2 ]; do
3385         running=$(ps uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep) || true
3386         [ -z "${running}" ] && return 0 || true
3387         echo "waited $WAIT for: "
3388         echo "$running"
3389         [ $INTERVAL -lt 60 ] && INTERVAL=$((INTERVAL + INTERVAL))
3390         sleep $INTERVAL
3391         WAIT=$((WAIT + INTERVAL))
3392     done
3393     local pids=$(ps  uax | grep "$PDSH.*$prog.*$MOUNT" | grep -v grep | awk '{print $2}')
3394     [ -z "$pids" ] && return 0
3395     echo "$PDSH processes still exists after $WAIT seconds.  Still running: $pids"
3396     # FIXME: not portable
3397     for pid in $pids; do
3398         cat /proc/${pid}/status || true
3399         cat /proc/${pid}/wchan || true
3400         echo "Killing $pid"
3401         kill -9 $pid || true
3402         sleep 1
3403         ps -P $pid && rc=1
3404     done
3405
3406     return $rc
3407 }
3408
3409 lfs_df_check() {
3410         local clients=${1:-$CLIENTS}
3411
3412         if [ -z "$clients" ]; then
3413                 $LFS df $MOUNT
3414         else
3415                 $PDSH $clients "$LFS df $MOUNT" > /dev/null
3416         fi
3417 }
3418
3419 clients_up() {
3420         # not every config has many clients
3421         sleep 1
3422         lfs_df_check
3423 }
3424
3425 client_up() {
3426         # usually checked on particular client or locally
3427         sleep 1
3428         lfs_df_check $1
3429 }
3430
3431 client_evicted() {
3432     ! client_up $1
3433 }
3434
3435 client_reconnect_try() {
3436         local f=$MOUNT/recon
3437
3438         uname -n >> $f
3439         if [ -z "$CLIENTS" ]; then
3440                 $LFS df $MOUNT; uname -n >> $f
3441         else
3442                 do_nodes $CLIENTS "$LFS df $MOUNT; uname -n >> $f" > /dev/null
3443         fi
3444         echo "Connected clients: $(cat $f)"
3445         ls -l $f > /dev/null
3446         rm $f
3447 }
3448
3449 client_reconnect() {
3450         # one client_reconnect_try call does not always do the job...
3451         while true ; do
3452                 client_reconnect_try && break
3453                 sleep 1
3454         done
3455 }
3456
3457 affected_facets () {
3458     local facet=$1
3459
3460     local host=$(facet_active_host $facet)
3461     local affected=$facet
3462
3463     if [ "$FAILURE_MODE" = HARD ]; then
3464         affected=$(facets_up_on_host $host)
3465     fi
3466     echo $affected
3467 }
3468
3469 facet_failover() {
3470         local E2FSCK_ON_MDT0=false
3471         if [ "$1" == "--fsck" ]; then
3472                 shift
3473                 [ $(facet_fstype $SINGLEMDS) == ldiskfs ] &&
3474                         E2FSCK_ON_MDT0=true
3475         fi
3476
3477         local facets=$1
3478         local sleep_time=$2
3479         local -a affecteds
3480         local facet
3481         local total=0
3482         local index=0
3483         local skip
3484
3485         #Because it will only get up facets, we need get affected
3486         #facets before shutdown
3487         #For HARD Failure mode, it needs make sure facets on the same
3488         #HOST will only be shutdown and reboot once
3489         for facet in ${facets//,/ }; do
3490                 local affected_facet
3491                 skip=0
3492                 #check whether facet has been included in other affected facets
3493                 for ((index=0; index<$total; index++)); do
3494                         [[ *,$facet,* == ,${affecteds[index]}, ]] && skip=1
3495                 done
3496
3497                 if [ $skip -eq 0 ]; then
3498                         affecteds[$total]=$(affected_facets $facet)
3499                         total=$((total+1))
3500                 fi
3501         done
3502
3503         for ((index=0; index<$total; index++)); do
3504                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
3505                 local host=$(facet_active_host $facet)
3506                 echo "Failing ${affecteds[index]} on $host"
3507                 shutdown_facet $facet
3508         done
3509
3510         $E2FSCK_ON_MDT0 && (run_e2fsck $(facet_active_host $SINGLEMDS) \
3511                 $(mdsdevname 1) "-n" || error "Running e2fsck")
3512
3513         for ((index=0; index<$total; index++)); do
3514                 facet=$(echo ${affecteds[index]} | tr -s " " | cut -d"," -f 1)
3515                 echo reboot facets: ${affecteds[index]}
3516
3517                 reboot_facet $facet
3518
3519                 change_active ${affecteds[index]}
3520
3521                 wait_for_facet ${affecteds[index]}
3522                 if $GSS_SK; then
3523                         init_gss
3524                         init_facets_vars_simple
3525                 fi
3526                 # start mgs first if it is affected
3527                 if ! combined_mgs_mds &&
3528                         list_member ${affecteds[index]} mgs; then
3529                         mount_facet mgs || error "Restart of mgs failed"
3530                 fi
3531                 # FIXME; has to be changed to mount all facets concurrently
3532                 affected=$(exclude_items_from_list ${affecteds[index]} mgs)
3533                 echo mount facets: ${affecteds[index]}
3534                 mount_facets ${affecteds[index]}
3535                 if $GSS_SK; then
3536                         do_nodes $(comma_list $(all_nodes)) \
3537                                 "keyctl show | grep lustre | cut -c1-11 |
3538                                 sed -e 's/ //g;' |
3539                                 xargs -IX keyctl setperm X 0x3f3f3f3f"
3540                 fi
3541         done
3542 }
3543
3544 obd_name() {
3545     local facet=$1
3546 }
3547
3548 replay_barrier() {
3549         local facet=$1
3550         do_facet $facet "sync; sync; sync"
3551         $LFS df $MOUNT
3552
3553         # make sure there will be no seq change
3554         local clients=${CLIENTS:-$HOSTNAME}
3555         local f=fsa-\\\$\(hostname\)
3556         do_nodes $clients "mcreate $MOUNT/$f; rm $MOUNT/$f"
3557         do_nodes $clients "if [ -d $MOUNT2 ]; then mcreate $MOUNT2/$f; rm $MOUNT2/$f; fi"
3558
3559         local svc=${facet}_svc
3560         do_facet $facet $LCTL --device ${!svc} notransno
3561         #
3562         # If a ZFS OSD is made read-only here, its pool is "freezed". This
3563         # in-memory state has to be cleared by either rebooting the host or
3564         # exporting and reimporting the pool.
3565         #
3566         # Although the uberblocks are not updated when a pool is freezed,
3567         # transactions are still written to the disks. Modified blocks may be
3568         # cached in memory when tests try reading them back. The
3569         # export-and-reimport process also evicts any cached pool data from
3570         # memory to provide the correct "data loss" semantics.
3571         #
3572         # In the test framework, the exporting and importing operations are
3573         # handled by stop() and mount_facet() separately, which are used
3574         # inside fail() and fail_abort().
3575         #
3576         set_dev_readonly $facet
3577         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
3578         $LCTL mark "local REPLAY BARRIER on ${!svc}"
3579 }
3580
3581 replay_barrier_nodf() {
3582         local facet=$1    echo running=${running}
3583         do_facet $facet "sync; sync; sync"
3584         local svc=${facet}_svc
3585         echo Replay barrier on ${!svc}
3586         do_facet $facet $LCTL --device ${!svc} notransno
3587         set_dev_readonly $facet
3588         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
3589         $LCTL mark "local REPLAY BARRIER on ${!svc}"
3590 }
3591
3592 replay_barrier_nosync() {
3593         local facet=$1    echo running=${running}
3594         local svc=${facet}_svc
3595         echo Replay barrier on ${!svc}
3596         do_facet $facet $LCTL --device ${!svc} notransno
3597         set_dev_readonly $facet
3598         do_facet $facet $LCTL mark "$facet REPLAY BARRIER on ${!svc}"
3599         $LCTL mark "local REPLAY BARRIER on ${!svc}"
3600 }
3601
3602 #
3603 # Get Lustre client uuid for a given Lustre mount point.
3604 #
3605 get_client_uuid() {
3606         local mntpnt=${1:-$MOUNT}
3607
3608         local name=$($LFS getname $mntpnt | cut -d' ' -f1)
3609         local uuid=$($LCTL get_param -n llite.$name.uuid)
3610
3611         echo -n $uuid
3612 }
3613
3614 mds_evict_client() {
3615         local mntpnt=${1:-$MOUNT}
3616         local uuid=$(get_client_uuid $mntpnt)
3617
3618         do_facet $SINGLEMDS \
3619                 "$LCTL set_param -n mdt.${mds1_svc}.evict_client $uuid"
3620 }
3621
3622 ost_evict_client() {
3623         local mntpnt=${1:-$MOUNT}
3624         local uuid=$(get_client_uuid $mntpnt)
3625
3626         do_facet ost1 \
3627                 "$LCTL set_param -n obdfilter.${ost1_svc}.evict_client $uuid"
3628 }
3629
3630 fail() {
3631         local facets=$1
3632         local clients=${CLIENTS:-$HOSTNAME}
3633
3634         SK_NO_KEY_save=$SK_NO_KEY
3635         if $GSS_SK; then
3636                 export SK_NO_KEY=false
3637         fi
3638         facet_failover $* || error "failover: $?"
3639         export SK_NO_KEY=$SK_NO_KEY_save
3640         # to initiate all OSC idling connections
3641         clients_up
3642         wait_clients_import_state "$clients" "$facets" "\(FULL\|IDLE\)"
3643         clients_up || error "post-failover stat: $?"
3644 }
3645
3646 fail_nodf() {
3647         local facet=$1
3648         facet_failover $facet
3649 }
3650
3651 fail_abort() {
3652         local facet=$1
3653         stop $facet
3654         change_active $facet
3655         wait_for_facet $facet
3656         mount_facet $facet -o abort_recovery
3657         clients_up || echo "first stat failed: $?"
3658         clients_up || error "post-failover stat: $?"
3659 }
3660
3661 host_nids_address() {
3662         local nodes=$1
3663         local net=${2:-"."}
3664
3665         do_nodes $nodes "$LCTL list_nids | grep $net | cut -f 1 -d @"
3666 }
3667
3668 h2name_or_ip() {
3669         if [ "$1" = "'*'" ]; then echo \'*\'; else
3670                 echo $1"@$2"
3671         fi
3672 }
3673
3674 h2nettype() {
3675         if [[ -n "$NETTYPE" ]]; then
3676                 h2name_or_ip "$1" "$NETTYPE"
3677         else
3678                 h2name_or_ip "$1" "$2"
3679         fi
3680 }
3681 declare -fx h2nettype
3682
3683 # Wrapper function to print the deprecation warning
3684 h2tcp() {
3685         echo "h2tcp: deprecated, use h2nettype instead" 1>&2
3686         if [[ -n "$NETTYPE" ]]; then
3687                 h2nettype "$@"
3688         else
3689                 h2nettype "$1" "tcp"
3690         fi
3691 }
3692
3693 # Wrapper function to print the deprecation warning
3694 h2o2ib() {
3695         echo "h2o2ib: deprecated, use h2nettype instead" 1>&2
3696         if [[ -n "$NETTYPE" ]]; then
3697                 h2nettype "$@"
3698         else
3699                 h2nettype "$1" "o2ib"
3700         fi
3701 }
3702
3703 # This enables variables in cfg/"setup".sh files to support the pdsh HOSTLIST
3704 # expressions format. As a bonus we can then just pass in those variables
3705 # to pdsh. What this function does is take a HOSTLIST type string and
3706 # expand it into a space deliminated list for us.
3707 hostlist_expand() {
3708     local hostlist=$1
3709     local offset=$2
3710     local myList
3711     local item
3712     local list
3713
3714     [ -z "$hostlist" ] && return
3715
3716     # Translate the case of [..],..,[..] to [..] .. [..]
3717     list="${hostlist/],/] }"
3718     front=${list%%[*}
3719     [[ "$front" == *,* ]] && {
3720         new="${list%,*} "
3721         old="${list%,*},"
3722         list=${list/${old}/${new}}
3723     }
3724
3725     for item in $list; do
3726         # Test if we have any []'s at all
3727         if [ "$item" != "${item/\[/}" ]; then {
3728             # Expand the [*] into list
3729             name=${item%%[*}
3730             back=${item#*]}
3731
3732             if [ "$name" != "$item" ]; then
3733                 group=${item#$name[*}
3734                 group=${group%%]*}
3735
3736                 for range in ${group//,/ }; do
3737                     local order
3738
3739                     begin=${range%-*}
3740                     end=${range#*-}
3741
3742                     # Number of leading zeros
3743                     padlen=${#begin}
3744                     padlen2=${#end}
3745                     end=$(echo $end | sed 's/0*//')
3746                     [[ -z "$end" ]] && end=0
3747                     [[ $padlen2 -gt $padlen ]] && {
3748                         [[ $padlen2 -eq ${#end} ]] && padlen2=0
3749                         padlen=$padlen2
3750                     }
3751                     begin=$(echo $begin | sed 's/0*//')
3752                     [ -z $begin ] && begin=0
3753
3754                     if [ ! -z "${begin##[!0-9]*}" ]; then
3755                         order=$(seq -f "%0${padlen}g" $begin $end)
3756                     else
3757                         order=$(eval echo {$begin..$end});
3758                     fi
3759
3760                     for num in $order; do
3761                         value="${name#*,}${num}${back}"
3762                         [ "$value" != "${value/\[/}" ] && {
3763                             value=$(hostlist_expand "$value")
3764                         }
3765                         myList="$myList $value"
3766                     done
3767                 done
3768             fi
3769         } else {
3770             myList="$myList $item"
3771         } fi
3772     done
3773     myList=${myList//,/ }
3774     myList=${myList:1} # Remove first character which is a space
3775
3776     # Filter any duplicates without sorting
3777     list="$myList "
3778     myList="${list%% *}"
3779
3780     while [[ "$list" != ${myList##* } ]]; do
3781         local tlist=" $list"
3782         list=${tlist// ${list%% *} / }
3783         list=${list:1}
3784         myList="$myList ${list%% *}"
3785     done
3786     myList="${myList%* }";
3787
3788     # We can select an object at an offset in the list
3789     [ $# -eq 2 ] && {
3790         cnt=0
3791         for item in $myList; do
3792             let cnt=cnt+1
3793             [ $cnt -eq $offset ] && {
3794                 myList=$item
3795             }
3796         done
3797         [ $(get_node_count $myList) -ne 1 ] && myList=""
3798     }
3799     echo $myList
3800 }
3801
3802 facet_host() {
3803         local facet=$1
3804         local varname
3805
3806         [ "$facet" == client ] && echo -n $HOSTNAME && return
3807         varname=${facet}_HOST
3808         if [ -z "${!varname}" ]; then
3809                 if [ "${facet:0:3}" == "ost" ]; then
3810                         local fh=${facet%failover}_HOST
3811                         eval export ${facet}_HOST=${!fh}
3812                         if [ -z "${!varname}" ]; then
3813                                 eval export ${facet}_HOST=${ost_HOST}
3814