actiWATE: Installation Guide

TOC

printable version

Installing actiWATE Framework

Section Contents

• System Requirements
  
• Installing Framework
  
• Upgrading Framework from a previous version
  
• Package contents
  
• How to run samples
  
• Uninstalling Framework
  

System Requirements

1. OS/Platform

   Framework written on Java and thus supports virtually any platform supported by Java Technology, including Windows, Linux, Solaris.

2. Java

   Framework requires Java 2 SDK 1.4 or higher which may be obtained at http://java.sun.com/downloads/index.html

Installing Framework

Download Framework zip archive from http://www.actiwate.com/ and unpack it in the directory you like. The directory actiWATE-<version> will be created, where <version> is the version of actiWATE Framework.

Upgrading Framework from previous version

Download Framework zip archive from http://www.actiwate.com/ and unpack it in the directory you like. The directory actiWATE-<version> will be created, where <version> is the version of actiWATE Framework.

If you modified or added any files in previous installation of actiWATE Framework (for example, modified or created new samples or shell scripts), then you can copy them to new installation.

If you copied actiWATE JAR files from previous version to any of your projects you need to update them from a newer version.

Package contents

• docs - documentation bundled with Framework package
• lib - Framework itself and libraries used by Framework
• samples - samples demonstrating how to write tests with Framework

How to run samples

Framework samples are placed in the directory 'samples'. In order to run samples you will need an active internet connection, because all samples are executed against live site at http://www.actiwate.com/samples/.
Please verify that you have JAVA_HOME environment variable pointing to directory where JDK is installed.

1. Running samples from Ant
   
   You should have an Apache Ant installed (Apache Ant can be obtained at http://ant.apache.org/).
   After installing Ant copy file junit.jar from Framework lib directory into ANT_HOME/lib, where ANT_HOME is a directory where you installed Ant.

   Note: in order to invoke Ant from command prompt you should include path to ANT_HOME/bin directory in your PATH environment variable. Also, it may require to set ANT_HOME environment variable to the directory where you've installed Ant.

   Now to run samples simply type in samples directory:
   

   > ant

2. Running samples from command prompt (for Windows)
   
   Under Windows OS type in samples directory:
   

   > runSamples.cmd

3. Running samples from command prompt (for Unix)
   
   Under Unix OS type in samples directory:
   

   > sh runSamples.sh

Uninstalling Framework

There are no special instructions for Framework uninstalling. You can simply remove the directory where you unpack zip archive.