#
# 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 2009 Sun Microsystems, Inc.  All rights reserved.
# Use is subject to license terms.
# 
# pragma ident	"@(#)README	1.4	09/06/09 SMI" 
#

The SMF Test Suite README


CONTENTS

1. Building & Installation
      1.1 Installing from Packages
      1.2 Uninstalling the Test Suite Package
      1.3 Building the Test Suite (optional)
      1.4 System Requirements
2. Running the tests
      2.1 Configuring and running the tests
3. Unconfigure the suite
4. Special requirements 
      4.1 Zones Test



================================================================================

1. Building & Installation

1.1 Installing from Packages

   o In the majority of cases, the test suite can be installed from
     packages.  The package is called SUNWstc-os-smf and its default
     installation directory is /opt/SUNWstc-os-smf.  Installation is via
     the standard Solaris package installation tool pkgadd(1m).

     To install SUNWstc-os-smf simply enter the following command line:

         % sudo pkgadd -d <package location>  SUNWstc-os-smf

     Where <package location> refers to the path containing the
     SUNWstc-os-smf package directory.

   o It is recommended that you install the packages from scratch, rather
     than on top of an existing installation.  Thus, if an old version of
     the tests is installed:

         % sudo pkgrm SUNWstc-os-smf

1.2 Uninstalling the Test Suite Package

   o Prior to uninstalling the SUNWstc-os-smf package, you may want to
     run stf_unconfigure from the top level directory.  Typically, this
     will be "/opt/SUNWstc-os-smf".  Unconfiguring the test suite is
     recommended if you have previously run the suite, and especially so,
     if you have run the test suite in non-global zones.  For more detail
     on how to unconfigure the suite see section 3.1.

   o To uninstall the package, use the standard Solaris package removal
     tool pkgrm(1m) as follows:

         % sudo pkgrm SUNWstc-os-smf

1.3 Building the Test Suite (optional)

   o This method uses the standard STF techniques to create a Solaris
     package, which will be installed under the base directory
     "/opt/SUNWstc-os-smf".
 
     Briefly, this build and installation is performed as follows:

         # set path to STF bin directory
         % PATH=<path-to-STF>/bin/`uname -p`:$PATH
         % export PATH

         # WS_ROOT is the root of the STC workspace containing the
         # SMF test suite source code
         #
         % cd <WS_ROOT>/usr/src/suites/smf
         % stf_build package
         % cd <WS_ROOT>/packages/`uname -p`
         % sudo pkgadd -d `pwd` SUNWstc-os-smf

   o It is recommended that you install the packages from scratch, rather
     than on top of an existing installation.  Thus, if an old version of
     the tests is installed:

         % sudo pkgrm SUNWstc-os-smf

1.4 System Requirements

   o Beginning with version 1.7 of this test suite, snv_102 or greater is
     required to successfully build and execute all tests.

================================================================================

2. Running the tests

2.1 Configuring and running the tests

2.1.1 Configure the tests

   o Configuration of the test suite is completed with the stf_configure
     command.
 
         % cd /opt/SUNWstc-os-smf; stf_configure

  o For stf_configure options refer to the STF User's Guide.

2.1.2 Run the tests

   o To execute all of the modes on current system platform:

         % cd /opt/SUNWstc-os-smf; stf_execute

   o To execute in a specific mode:

         % stf_execute -m <mode>

   o To execute only test cases in a specific directory:

         % cd /opt/SUNWstc-os-smf/<test directory>; stf_execute

   o For other stf_execute options, refer to the STF User's Guide.

================================================================================

3. Unconfigure the suite.

   o Use the STF unconfigure tool.

         % cd /opt/SUNWstc-os-smf; stf_unconfigure  

================================================================================

4. Special Requirements

4.1 Zones test
   o  This suite includes a zones test to verify SMF services are properly 
      handled in non-global zones.  The test requires the Solaris package
      management scripts (pkgadd, pkgrm etc) and will not work with the IPS 
      packaging mechanism.

Indexes created Mon Nov 23 13:58:57 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.