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