#
# CDDL HEADER START
#
# The contents of this file are subject to the terms of the
# Common Development and Distribution License (the "License").
# You may not use this file except in compliance with the License.
#
# You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
# or http://www.opensolaris.org/os/licensing.
# See the License for the specific language governing permissions
# and limitations under the License.
#
# When distributing Covered Code, include this CDDL HEADER in each
# file and include the License file at usr/src/OPENSOLARIS.LICENSE.
# If applicable, add the following below this CDDL HEADER, with the
# fields enclosed by brackets "[]" replaced with your own identifying
# information: Portions Copyright [yyyy] [name of copyright owner]
#
# CDDL HEADER END
#

#
# Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
#
# ident	"@(#)README	1.5	08/07/16 SMI"
#

DESCRIPTION
===========
SDTS means Storage Driver Test Suite. It automates most of storage
HBA driver function testing and SMP expander driver function testing.

PREREQUISITES
============
1. A spare disk is required for this test suite to run.
2. The test harness package SUNWcti-tetlite is required to be installed.
You can find the package on OpenSolaris Test Consolidation:
http://www.opensolaris.org/os/community/testing/testsuites/ctifortet/
3. To test SMP expander function, you need to download the binary of "lsiutil"
from LSI's website. Otherwise, you can not test SMP expander function and
you can ignore the section to install lsiutil binary.

CTI-TET PACKAGE INSTALLATION
===========================
As root do the following:
1. get SUNWstc-tetlite
2. pkgadd -d . SUNWstc-tetlite

LSIUTIL BINARY INSTALLATION
============================
To run SMP test cases, you must copy lsiutil binary to testing platform.
You can download the following archives from LSI's website.
Here is the web link:
For x86 platform:
http://www.lsi.com/support/downloads/hbas/sas/software_drivers/other/SAS_Solaris_8-9_x86.zip 

For sparc platform:
http://www.lsi.com/support/downloads/hbas/sas/software_drivers/other/SAS_Solaris_8-9_sparc.zip 

After download the archive, run the following commands to install the
binary, following is an example of x86 platform.
1. unzip SAS_Solaris_8-9_x86.zip
2. uncompress itmpt_XXXX_i386.tar.Z
3. tar xvpf itmpt_XXXX_i386.tar
4. cd install/ITImpt/reloc/usr/bin
5. cp -rfp lsiutil /usr/bin

TEST SUITE INSTALLATION
=======================

I: Based on SDTS package
1. get sdts package SUNWstc-sdts
2. pkgadd -d . SUNWstc-sdts

II: Based on SDTS source code
1. get SDTS source code and put it in /export/home/
2. export TET_ROOT=/opt/SUNWstc-tetlite
3. export CTI_ROOT=/opt/SUNWstc-tetlite/contrib/ctitools
4. export TET_SUITE_ROOT=/export/home/sdts/src/suites/storage
5. cd $TET_SUITE_ROOT/sdts
6. /usr/ccs/bin/make

TEST SUITE CONFIGURATION
========================
As root do the following steps:
1. Set the following environment variables

Using SDTS package:
	export TET_ROOT=/opt/SUNWstc-tetlite
	export CTI_ROOT=$TET_ROOT/contrib/ctitools
	export PATH=$PATH:$CTI_ROOT/bin
	export TET_SUITE_ROOT=/opt/SUNWstc-sdts

Using SDTS source code:
	export TET_ROOT=/opt/SUNWstc-tetlite
	export CTI_ROOT=$TET_ROOT/contrib/ctitools
	export PATH=$PATH:$CTI_ROOT/bin
	export TET_SUITE_ROOT=/export/home/sdts/src/suites/storage

2. To configure the test suite 
Assuming that the sdts test disk is c2t1d0, running the following command 
creates the test_config file.

# run_test -v disk=c2t1d0 sdts configure

Note: the disk name must be in the form of cxtxdx or cxdx.
Warning: the execution of this test suite will destroy all data on the
disk. Make sure the test disk doesn't have any data you don't want to lose.

Another variable that can be set in the configuration line:

debug		- [ TRUE || FALSE ] default FALSE

Following is an example to enable debug:
# run_test -v disk=c1t1d0 -v debug=TRUE sdts configure 

TEST SUITE EXECUTION
====================
The test suite must be executed as root.

If not already done, from the configuration phase, do the following to 
set the environmental variables:

Using SDTS package:
	export TET_ROOT=/opt/SUNWstc-tetlite
	export CTI_ROOT=$TET_ROOT/contrib/ctitools
	export PATH=$PATH:$CTI_ROOT/bin
	export TET_SUITE_ROOT=/opt/SUNWstc-sdts

Using SDTS source code:
	export TET_ROOT=/opt/SUNWstc-tetlite
	export CTI_ROOT=$TET_ROOT/contrib/ctitools
	export PATH=$PATH:$CTI_ROOT/bin
	export TET_SUITE_ROOT=/export/home/sdts/src/suites/storage

To run the test suite do the following:

# run_test sdts

Note: The command above will not run SMP function test.

To run all the test purposes you should run following command:

# run_test sdts diskcmd

To execute individual scenarios (fdisk format newfs vtoc):

# run_test sdts <scenario>

# run_test sdts fdisk

To execute a Test Purpose within a scenario:

run_test sdts diskcmd/<test case dir>:<test purpose number>

# run_test sdts diskcmd/fdisk:1

Test case directories are fdisk, format, newfs, and vtoc.

To run the SMP expander function test:

# run_test sdts smp

Note: You can define customized test scenarios by adding entries to 
the test scenario file: $TET_SUITE_ROOT/sdts/tet_scen.

For how to edit the test scenario file, refer to the TET user guide at: 
http://tetworks.opengroup.org/tet/

TEST SUITE UNCONFIGURATION
==========================

# run_test sdts unconfigure

Indexes created Mon Nov 23 21:45:23 UTC 2009

Terms of Use | Privacy | Trademarks | Copyright Policy | Site Guidelines | Help
Your use of this web site or any of its content or software indicates your agreement to be bound by these Terms of Use.
Copyright © 1995-2008 Sun Microsystems, Inc.