lustre/tests/test-framework.sh

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