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