openjdk-systemtest

This repository contains the test cases which can be run against an OpenJDK with Hotspot or OpenJDK with Eclipse OpenJ9 based java implementation.

The tests all run under the STF System Test Framework.

Quick start (Unix)
Quick start (Windows)
More documentation

Quick start (Unix)

This quick start is for people who want to clone and build the project. To set up a development environment for creating new test cases, refer to this document.

Before running the build for the first time make sure GNU make, ant and wget are on your PATH.

wget is only required for the make configure step, which only needs to be done once.

Either copy, paste and execute this script which runs the command below, or run the commands yourself.

# 1. Create a directory for the git clone
mkdir -p $HOME/git

# 2. Clone the STF repository
cd $HOME/git
git clone git@github.com:AdoptOpenJDK/stf.git stf

# 3. Clone the openjdk-systemtest repository
cd $HOME/git
git clone git@github.com:AdoptOpenJDK/openjdk-systemtest.git openjdk-systemtest

# 4. Set JAVA_HOME to a Java 8 or later Java

export JAVA_HOME=<java-home>

# 5.Install the prereqs
# This requires wget to be on the PATH
cd $HOME/git/openjdk-systemtest/openjdk.build
make configure

# 6. Build
cd $HOME/git/openjdk-systemtest/openjdk.build
make

# 7. Run the tests (takes about an hour, depending on the test machine)
cd $HOME/git/openjdk-systemtest/openjdk.build
make test
echo See /tmp/stf to view the test results

Quick Start (Windows)

This quick start is for people who want to clone and build the project. To set up a development environment for creating new test cases, refer to this document.

Before running the build for the first time make sure GNU make, ant and wget are on your PATH.

wget is only required for the make configure step, which only needs to be done once.

Either copy, paste and execute this script which runs the command below, or run the commands yourself.

REM 1. Create a directory for the git clones
mkdir c:\%USERPROFILE%\git

REM 2. Clone the STF repository
cd c:\%USERPROFILE%\git
git clone git@github.com:AdoptOpenJDK/stf.git stf

REM 3. Clone the test cases repository
cd c:\%USERPROFILE%\git
git clone git@github.com:AdoptOpenJDK/openjdk-systemtest.git openjdk-systemtest

REM 4. Set JAVA_HOME to a Java 8 or later Java
SET JAVA_HOME=<java-home>

REM 5. Get the test case prereqs
cd C:\%USERPROFILE%\git\openjdk-systemtest\openjdk.build
make configure

REM 6. Build
cd C:\%USERPROFILE%\git\openjdk-systemtest\openjdk.build
make

REM 7. Run the tests (takes about an hour, depending on the test machine)
cd C:\%USERPROFILE%\git\openjdk-systemtest\openjdk.build
make test
echo See c:\stf_temp to view the test results