Building and Installing the Open HA Cluster Automated Test Suite
The majority of Open High Availability (Open HA) Cluster code is released under the Common Development and Distribution License (CDDL) Version 1.0.
Source based on existing open source projects will continue to be available under their current licenses. Some binary components are covered under the OpenSolaris™ Binary License, and some are covered under other open source licenses. Specific download pages provide license information associated with the available component pieces.
The following procedures explain how to build and install the Open HA Cluster automated test suite:
How to Build the Test Harness
This directory tree contains the open-source version of the test harness. For more information or for complete documentation, refer to the documentation listed in How to Run Tests.
To build from source, you need a system that is installed with the following software:
- Solaris Express Community Edition Build 86 DVD (1 segment) or DVD (2 segments)
- Sun Studio 11 Compilers
- Test Environment Toolkit (TET) (TET tarball)
- Common Test Infrastructure (CTI) for TET (CTI for TET tarball). To install CTI for TET, follow the procedures in the Building CTI for TET page.
You then need to download and install the source archive.
- Download and extract the Open HA Cluster Automated Test Suites (ohacts-src-DATE.tar.bz2).
$ **bzcat ///path///ohacts-src-//DATE//.tar.bz2 | tar xf -**
- Create the defines.mk file from the defines.template file.
$ **cd ohacts/src; cp defines.template defines.mk** $ **vi defines.mk**
- In the defines.mk file, change the following values:
11* CTI_PROTO = <cti_proto-path>
Replace <cti_proto-path> with the full path to the CTI for TET binaries, for example, ./bin, ./lib, and ./contrib.
11* PATH = /opt/SUNWspro/bin:/bin:/usr/ccs/bin:/usr/bin:/usr/sbin:/bin:/sbin:.
Insert the path to your compiler in the path. - save and exit the file.
- In the defines.mk file, change the following values:
- Build the SUNWscts package.
$ **make package**
How to Install the Package
Install the SUNWscts package by running the following command:
$ **pkgadd -d ///path///ohacts/packages///Sol_VER/ARCH// SUNWscts**
How to Run Tests
- For data services, follow the procedures in the Open HA Cluster Automated Test Suite User's Guide (PDF).
- For geo-clusters, follow the procedures at Running Tests on Open HA Cluster, Geographic Edition (HTML).
defines.template File
The following example shows the contents of the defines.template file, which you copy and modify for your environment. The contents of the defines.template file might vary from this example, depending on the version of the test suites that you are using.
# # 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 "@(#)defines.template 1.24 08/06/04 SMI" # # Replace <cti_proto-path> with the full path to the CTI for TET root directory. # # For more details: <cti_for_tet>/src/tools/tet/contrib/ctitools/README CTI_PROTO = <cti_proto-path> # Make sure you have The Sun Studio Compilers in your PATH parameter. # Replace /opt/SUNWspro/bin to your compiler. This example assumes the # Sun Studio Compilers path is /opt/SUNWspro : PATH = /opt/SUNWspro/bin:/bin:/usr/ccs/bin:/usr/bin:/usr/sbin:/bin:/sbin:.