Mercurial > illumos > illumos-gate
view usr/src/test/os-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 |
line wrap: on
line source
# # This file and its contents are supplied under the terms of the # Common Development and Distribution License ("CDDL"), version 1.0. # You may only use this file in accordance with the terms of version # 1.0 of the CDDL. # # A full copy of the text of the CDDL should have accompanied this # source. A copy of the CDDL is also available via the Internet at # http://www.illumos.org/license/CDDL. # # # Copyright (c) 2012 by Delphix. All rights reserved. # OS Unit Test Suite README 1. Building and installing the OS Unit Test Suite 2. Running the OS Unit Test Suite 3. Test results -------------------------------------------------------------------------------- 1. Building and installing the OS Unit Test Suite The OS Unit Test Suite runs under the testrunner framework (which can be installed as pkg:/system/test/testrunner). To build both the OS Unit Test Suite and the testrunner without running a full nightly: build_machine$ bldenv [-d] <your_env_file> build_machine$ cd $SRC/test build_machine$ dmake install build_machine$ cd $SRC/pkg build_machine$ dmake install Then set the publisher on the test machine to point to your repository and install the OS Unit Test Suite. test_machine# pkg install pkg:/system/test/zfstest Note, the framework will be installed automatically, as the OS Unit Test Suite depends on it. 2. Running the OS Unit Test Suite The pre-requisites for running the OS Unit Test Suite are: - A non-root user with the ability to sudo(1M) to root without a password or the root user must run the test. Once the pre-requisites are satisfied, simply run the ostest script: test_machine$ /opt/os-tests/bin/ostest 3. Test results While the OS Unit Test Suite is running, one informational line is printed at the end of each test, and a results summary is printed at the end of the run. The results summary includes the location of the complete logs, which is of the form /var/tmp/test_results/<ISO 8601 date>.