lustre/tests/test-framework.sh

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