Home | History | Annotate | Download | only in smf
      1 #
      2 # CDDL HEADER START
      3 #
      4 # The contents of this file are subject to the terms of the
      5 # Common Development and Distribution License (the "License").
      6 # You may not use this file except in compliance with the License.
      7 #
      8 # You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
      9 # or http://www.opensolaris.org/os/licensing.
     10 # See the License for the specific language governing permissions
     11 # and limitations under the License.
     12 #
     13 # When distributing Covered Code, include this CDDL HEADER in each
     14 # file and include the License file at usr/src/OPENSOLARIS.LICENSE.
     15 # If applicable, add the following below this CDDL HEADER, with the
     16 # fields enclosed by brackets "[]" replaced with your own identifying
     17 # information: Portions Copyright [yyyy] [name of copyright owner]
     18 #
     19 # CDDL HEADER END
     20 #
     21 
     22 #
     23 # Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
     24 # Use is subject to license terms.
     25 # 
     26 # ident	"@(#)README	1.2	08/10/28 SMI"
     27 #
     28 
     29 The SMF Test Suite Gate README - May 23, 2008
     30 
     31 ================================================================================
     32 
     33 1. Building & Installation
     34 
     35 1.1 Installing from Packages
     36 
     37    o In the majority of cases, the test suite can be installed from packages. The
     38      package is called SUNWstc-smf and installs into "/opt" by default. Installation is
     39      via the standard Solaris package installation tool pkgadd(1m). To install
     40      SUNWstc-smf simply enter the following command line:
     41 
     42 	% sudo pkgadd -d <package location>  SUNWstc-smf
     43 
     44      Where <package location> refers to the path containing the SUNWstc-smf 
     45      package directory.
     46 
     47   o It is recommended that you install the packages from scratch,
     48     rather than on top of an existing installation.  Thus, if an old
     49     version of the tests is installed:
     50 
     51         % sudo pkgrm SUNWstc-smf
     52 
     53 1.2 Uninstalling the Test Suite Package
     54 
     55   o Prior to uninstalling the SUNWstc-smf package, you may want to run stf_unconfigure
     56     from the top level directory. Typically this will be "/opt/SUNWstc-smf". Unconfiguring
     57     the suite is recommended if you have previous run the suite in local zone mode. For
     58     more detail on how to unconfigure the suite see section 3.1.
     59 
     60   o To uninstall the package use the standard Solaris package installation tool pkgrm(1m)
     61     as follows:
     62 
     63         % sudo pkgrm SUNWstc-smf
     64 
     65 1.3 Building the Test Suite (optional)
     66 
     67   o This method uses the standard STF techniques to create a
     68     Solaris package, which will be installed under the base
     69     directory "/opt/SUNWstc-smf".
     70  
     71     Briefly, this build and installation is performed as follows:
     72 
     73 	# set path to STF bin directory
     74 	% PATH=<path-to-STF>/bin/`uname -p`:$PATH
     75 	% export PATH
     76 
     77 	# if not using teamware, define CODEMGR_WS
     78 	% CODEMGR_WS=<path-to-workspace>
     79 	% export CODEMGR_WS
     80 
     81 	% cd ${CODEMGR_WS}/src/suites/smf
     82 	% stf_build package
     83 	% cd ${CODEMGR_WS}/packages/`uname -p`
     84 	% sudo pkgadd -d `pwd` SUNWstc-smf
     85 
     86   o It is recommended that you install the packages from scratch,
     87     rather than on top of an existing installation.  Thus, if an old
     88     version of the tests is installed:
     89 
     90 	% sudo pkgrm SUNWstc-smf
     91 
     92 1.4 Required system version
     93 
     94   o Beginning with version 1.7 of the test suite, snv_102 or greater is 
     95     required to successfully build and pass all tests in this test suite.
     96 
     97 ================================================================================
     98 
     99 2. Running the tests
    100 
    101 2.1 Configuring and running the tests
    102 
    103 2.1.1 Configure the tests
    104 
    105   o Configuration of the test suite is completed with the stf_configure
    106     command.
    107  
    108 	% cd /opt/SUNWstc-smf; stf_configure
    109 
    110   o For stf_configure options refer to the STF User's Guide.
    111 
    112 2.1.2 Run the tests
    113 
    114   o To execute all of the modes on current system platform:
    115 
    116 	% cd /opt/SUNWstc-smf; stf_execute
    117 
    118   o To execute in a specific mode:
    119 
    120 	% stf_execute -m <mode>
    121 
    122   o To execute only test cases in a specific directory:
    123 
    124 	% cd /opt/SUNWstc-smf/<test directory>; stf_execute
    125 
    126   o For other stf_execute options, refer to the STF User's Guide.
    127 
    128 ================================================================================
    129 
    130 3.1 Unconfigure the suite.
    131 
    132   o Use the STF unconfigure tool.        
    133 
    134         % cd /opt/SUNWstc-smf; stf_unconfigure  
    135 
    136 ================================================================================
    137