1#!/bin/ksh
2
3#
4# This file and its contents are supplied under the terms of the
5# Common Development and Distribution License ("CDDL"), version 1.0.
6# You may only use this file in accordance with the terms of version
7# 1.0 of the CDDL.
8#
9# A full copy of the text of the CDDL should have accompanied this
10# source.  A copy of the CDDL is also available via the Internet at
11# http://www.illumos.org/license/CDDL.
12#
13
14#
15# Copyright (c) 2015, 2021 by Delphix. All rights reserved.
16#
17
18#
19# Description:
20# Trigger fio runs using the sequential_reads job file. The number of runs and
21# data collected is determined by the PERF_* variables. See do_fio_run for
22# details about these variables.
23#
24# The files to read from are created prior to the first fio run, and used
25# for all fio runs. This test will exercise cached read performance from
26# a clone filesystem. The data is initially cached in the ARC and then
27# a snapshot and clone are created. All the performance runs are then
28# initiated against the clone filesystem to exercise the performance of
29# reads when the ARC has to create another buffer from a different dataset.
30# It will also exercise the need to evict the duplicate buffer once the last
31# reference on that buffer is released.
32#
33
34. $STF_SUITE/include/libtest.shlib
35. $STF_SUITE/tests/perf/perf.shlib
36
37function cleanup
38{
39	# kill fio and iostat
40	pkill fio
41	pkill iostat
42	recreate_perf_pool
43}
44
45trap "log_fail \"Measure IO stats during random read load\"" SIGTERM
46log_onexit cleanup
47
48recreate_perf_pool
49populate_perf_filesystems
50
51# Make sure the working set can be cached in the arc. Aim for 1/2 of arc.
52export TOTAL_SIZE=$(($(get_max_arc_size) / 2))
53
54# Variables specific to this test for use by fio.
55export PERF_NTHREADS=${PERF_NTHREADS:-'64 128'}
56export PERF_NTHREADS_PER_FS=${PERF_NTHREADS_PER_FS:-'0'}
57export PERF_IOSIZES=${PERF_IOSIZES:-'128k 1m'}
58
59# Layout the files to be used by the read tests. Create as many files as the
60# largest number of threads. An fio run with fewer threads will use a subset
61# of the available files.
62export NUMJOBS=$(get_max $PERF_NTHREADS)
63export FILE_SIZE=$((TOTAL_SIZE / NUMJOBS))
64export DIRECTORY=$(get_directory)
65log_must fio $FIO_SCRIPTS/mkfiles.fio
66
67#
68# Only a single filesystem is used by this test. To be defensive, we
69# double check that TESTFS only contains a single filesystem. We
70# wouldn't want to assume this was the case, and have it actually
71# contain multiple filesystem (causing cascading failures later).
72#
73log_must test $(get_nfilesystems) -eq 1
74
75log_note "Creating snapshot, $TESTSNAP, of $TESTFS"
76create_snapshot $TESTFS $TESTSNAP
77log_note "Creating clone, $PERFPOOL/$TESTCLONE, from $TESTFS@$TESTSNAP"
78create_clone $TESTFS@$TESTSNAP $PERFPOOL/$TESTCLONE
79
80#
81# We want to run FIO against the clone we created above, and not the
82# clone's originating filesystem. Thus, we override the default behavior
83# and explicitly set TESTFS to the clone.
84#
85export TESTFS=$PERFPOOL/$TESTCLONE
86
87# Set up the scripts and output files that will log performance data.
88lun_list=$(pool_to_lun_list $PERFPOOL)
89log_note "Collecting backend IO stats with lun list $lun_list"
90if is_linux; then
91	typeset perf_record_cmd="perf record -F 99 -a -g -q \
92	    -o /dev/stdout -- sleep ${PERF_RUNTIME}"
93
94	export collect_scripts=(
95	    "zpool iostat -lpvyL $PERFPOOL 1" "zpool.iostat"
96	    "$PERF_SCRIPTS/prefetch_io.sh $PERFPOOL 1" "prefetch"
97	    "vmstat -t 1" "vmstat"
98	    "mpstat -P ALL 1" "mpstat"
99	    "iostat -tdxyz 1" "iostat"
100	    "$perf_record_cmd" "perf"
101	)
102else
103	export collect_scripts=(
104	    "$PERF_SCRIPTS/io.d $PERFPOOL $lun_list 1" "io"
105	    "$PERF_SCRIPTS/prefetch_io.d $PERFPOOL 1" "prefetch"
106	    "vmstat -T d 1" "vmstat"
107	    "mpstat -T d 1" "mpstat"
108	    "iostat -T d -xcnz 1" "iostat"
109	)
110fi
111
112log_note "Sequential cached reads from $DIRECTORY with " \
113    "ettings: $(print_perf_settings)"
114do_fio_run sequential_reads.fio false false
115log_pass "Measure IO stats during sequential cached read load"
116