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
37command -v fio > /dev/null || log_unsupported "fio missing"
38
39function cleanup
40{
41	# kill fio and iostat
42	pkill fio
43	pkill iostat
44	recreate_perf_pool
45}
46
47trap "log_fail \"Measure IO stats during random read load\"" SIGTERM
48log_onexit cleanup
49
50recreate_perf_pool
51populate_perf_filesystems
52
53# Make sure the working set can be cached in the arc. Aim for 1/2 of arc.
54export TOTAL_SIZE=$(($(get_max_arc_size) / 2))
55
56# Variables specific to this test for use by fio.
57export PERF_NTHREADS=${PERF_NTHREADS:-'64 128'}
58export PERF_NTHREADS_PER_FS=${PERF_NTHREADS_PER_FS:-'0'}
59export PERF_IOSIZES=${PERF_IOSIZES:-'128k'}
60export PERF_SYNC_TYPES=${PERF_SYNC_TYPES:-'1'}
61
62# Layout the files to be used by the read tests. Create as many files as the
63# largest number of threads. An fio run with fewer threads will use a subset
64# of the available files.
65export NUMJOBS=$(get_max $PERF_NTHREADS)
66export FILE_SIZE=$((TOTAL_SIZE / NUMJOBS))
67export DIRECTORY=$(get_directory)
68log_must fio $FIO_SCRIPTS/mkfiles.fio
69
70#
71# Only a single filesystem is used by this test. To be defensive, we
72# double check that TESTFS only contains a single filesystem. We
73# wouldn't want to assume this was the case, and have it actually
74# contain multiple filesystem (causing cascading failures later).
75#
76log_must test $(get_nfilesystems) -eq 1
77
78log_note "Creating snapshot, $TESTSNAP, of $TESTFS"
79create_snapshot $TESTFS $TESTSNAP
80log_note "Creating clone, $PERFPOOL/$TESTCLONE, from $TESTFS@$TESTSNAP"
81create_clone $TESTFS@$TESTSNAP $PERFPOOL/$TESTCLONE
82
83#
84# We want to run FIO against the clone we created above, and not the
85# clone's originating filesystem. Thus, we override the default behavior
86# and explicitly set TESTFS to the clone.
87#
88export TESTFS=$PERFPOOL/$TESTCLONE
89
90# Set up the scripts and output files that will log performance data.
91lun_list=$(pool_to_lun_list $PERFPOOL)
92log_note "Collecting backend IO stats with lun list $lun_list"
93if is_linux; then
94	typeset perf_record_cmd="perf record -F 99 -a -g -q \
95	    -o /dev/stdout -- sleep ${PERF_RUNTIME}"
96
97	export collect_scripts=(
98	    "zpool iostat -lpvyL $PERFPOOL 1" "zpool.iostat"
99	    "$PERF_SCRIPTS/prefetch_io.sh $PERFPOOL 1" "prefetch"
100	    "vmstat -t 1" "vmstat"
101	    "mpstat -P ALL 1" "mpstat"
102	    "iostat -tdxyz 1" "iostat"
103	    "$perf_record_cmd" "perf"
104	)
105else
106	export collect_scripts=(
107	    "$PERF_SCRIPTS/io.d $PERFPOOL $lun_list 1" "io"
108	    "$PERF_SCRIPTS/prefetch_io.d $PERFPOOL 1" "prefetch"
109	    "vmstat -T d 1" "vmstat"
110	    "mpstat -T d 1" "mpstat"
111	    "iostat -T d -xcnz 1" "iostat"
112	)
113fi
114
115log_note "Sequential cached reads from $DIRECTORY with " \
116    "ettings: $(print_perf_settings)"
117do_fio_run sequential_reads.fio false false
118log_pass "Measure IO stats during sequential cached read load"
119