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