xref: /test/ohacts/src

#
# 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 src/CDDL.txt
# 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 src/CDDL.txt.
# 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.22	08/06/04 SMI"
#

This directory tree contains the open-source version of the Open HA Cluster
Automated Test Suite. For more information or full documentation, refer to the 
Open HA Cluster Automated Test Suite User's Guide, 
and for most up-to-date build instructions, which is available at:

  http://www.opensolaris.org/os/community/ha-clusters/ohac/Documentation/Tests/.


For quick build and installation instructions, see below.


BUILDING THE TEST HARNESS
-------------------------

To build from source you will need a system installed with:

  . Solaris Express Community Edition.
  . The Sun Studio Compilers (included in Solaris Express Community Edition).

  
You will also need to download and build the CTI for TET from the OpenSolaris 
Test Community at:

  http://www.opensolaris.org/os/community/testing/testsuites/ctifortet/


1. Extract the archive ohacts-src-DATE.tar.bz2 into the current directory.
   $ bzcat /<path>/ohacts-src-DATE.tar.bz2 | tar xf -
  
2. Copy the ohacts/src/defines.template file to create the src/defines.mk file.
   $ cd ohacts/src; cp defines.template defines.mk

3. Open the new ohacts/src/defines.mk file for editing.
   $ vi defines.mk
  
4. Change the values of the following variables:

   - For CTI_PROTO, replace <cti_proto_path> with the full path to the CTI for 
     TET root directory where ./bin, ./lib, and ./contrib are located.

   - For PATH, replace <compiler-path> with the path to your compiler.

   When done, save and exit the file.

5. Build the SUNWscts package.
   $ make package


INSTALLING THE PACKAGE
----------------------
   Install the SUNWscts package by running the following command:
   $ pkgadd -d <path>/ohacts/packages/Sol_xx/<arch> SUNWscts


RUNNING TESTS
-------------
   Please refer to 
     "Open HA Cluster Automated Test Suite User's Guide".