lustre/tests/test-framework.sh

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