lustre/tests/test-framework.sh

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