Mercurial > illumos > illumos-gate
comparison usr/src/test/zfs-tests/doc/README @ 13899:0bcf78798346
3311 Want a test framework for arbitrary OS unit tests
3312 Add a testrunner package for OS unit tests
3313 Add a testrunner package to convert ZFS tests from STF
Reviewed by: Matt Ahrens <matthew.ahrens@delphix.com>
Reviewed by: Will Guyette <will.guyette@delphix.com>
Reviewed by: Dan Kimmel <dan.kimmel@delphix.com>
Reviewed by: Adam Leventhal <ahl@delphix.com>
Reviewed by: Henrik Mattson <henrik.mattson@delphix.com>
Reviewed by: Sonu Pillai <sonu.pillai@delphix.com>
Reviewed by: Christopher Siden <chris.siden@delphix.com>
Reviewed by: George Wilson <george.wilson@delphix.com>
Reviewed by: Richard Lowe <richlowe@richlowe.net>
Approved by: Richard Lowe <richlowe@richlowe.net>
author | John Wren Kennedy <john.kennedy@delphix.com> |
---|---|
date | Wed, 05 Dec 2012 22:04:50 -0500 |
parents | |
children | 91e6d0c446e5 |
comparison
equal
deleted
inserted
replaced
13898:7f822b09519b | 13899:0bcf78798346 |
---|---|
1 # | |
2 # This file and its contents are supplied under the terms of the | |
3 # Common Development and Distribution License ("CDDL"), version 1.0. | |
4 # You may only use this file in accordance with the terms of version | |
5 # 1.0 of the CDDL. | |
6 # | |
7 # A full copy of the text of the CDDL should have accompanied this | |
8 # source. A copy of the CDDL is also available via the Internet at | |
9 # http://www.illumos.org/license/CDDL. | |
10 # | |
11 | |
12 # | |
13 # Copyright (c) 2012 by Delphix. All rights reserved. | |
14 # | |
15 | |
16 ZFS Test Suite README | |
17 | |
18 1. Building and installing the ZFS Test Suite | |
19 2. Running the ZFS Test Suite | |
20 3. Test results | |
21 | |
22 -------------------------------------------------------------------------------- | |
23 | |
24 1. Building and installing the ZFS Test Suite | |
25 | |
26 The ZFS Test Suite runs under the testrunner framework (which can be installed | |
27 as pkg:/system/test/testrunner). To build both the ZFS Test Suite and the | |
28 testrunner without running a full nightly: | |
29 | |
30 build_machine$ bldenv [-d] <your_env_file> | |
31 build_machine$ cd $SRC/test | |
32 build_machine$ dmake install | |
33 build_machine$ cd $SRC/pkg | |
34 build_machine$ dmake install | |
35 | |
36 Then set the publisher on the test machine to point to your repository and | |
37 install the ZFS Test Suite. | |
38 | |
39 test_machine# pkg install pkg:/system/test/zfstest | |
40 | |
41 Note, the framework will be installed automatically, as the ZFS Test Suite | |
42 depends on it. | |
43 | |
44 2. Running the ZFS Test Suite | |
45 | |
46 The pre-requisites for running the ZFS Test Suite are: | |
47 - Three scratch disks | |
48 - Specify the disks you wish to use in the $DISKS variable, as a | |
49 space delimited list like this: DISKS='c3t1d0 c3t2d0 c3t3d0' | |
50 - Use the '-a' option to the zfstest script and all unused disks on | |
51 the system are eligible. With '-a' specified, $DISKS is ignored. | |
52 - A non-root user with the full set of basic privileges and the ability | |
53 to sudo(1M) to root without a password to run the test. | |
54 - Specify any pools you wish to preserve as a space delimited list in | |
55 the $KEEP variable. The root pool is added automatically. | |
56 | |
57 Once the pre-requisites are satisfied, simply run the zfstest script: | |
58 | |
59 test_machine$ /opt/zfs-tests/bin/zfstest [-aq] | |
60 | |
61 When the '-q' option is specified, it is passed to run(1) which causes output | |
62 to be written to the console only for tests that do not pass and the results | |
63 summary. | |
64 | |
65 The ZFS Test Suite allows the user to specify a subset of the tests via a | |
66 runfile. The format of the runfile is explained in run(1), and the files that | |
67 zfstest uses are available for reference under /opt/zfs-tests/runfiles. To | |
68 specify a custom runfile, use the -c option: | |
69 | |
70 test_machine$ /opt/zfs-tests/bin/zfstest [-aq] -c my_tests.run | |
71 | |
72 3. Test results | |
73 | |
74 While the ZFS Test Suite is running, one informational line is printed at the | |
75 end of each test, and a results summary is printed at the end of the run. The | |
76 results summary includes the location of the complete logs, which is of the | |
77 form /var/tmp/test_results/<ISO 8601 date>. |