openj9-systemtest

This repository contains the test cases which can be run against the OpenJ9 java implmentation but not OpenJDK.

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. Clone the openj9-systemtest repository
cd $HOME/git
git clone git@github.com/eclipse/openj9/openj9-systemtest.git openj9-systemtest

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

export JAVA_HOME=<java-home>

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

# 7. Build
cd $HOME/git/openj9-systemtest/openj9.build
make

# 8. Run the tests (the tests take some time to run (many minutes))
cd $HOME/git/openj9-systemtest/openj9.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 openjdk-systemtest repository
cd c:\%USERPROFILE%\git
git clone git@github.com/AdoptOpenJDK/openjdk-systemtest.git openjdk-systemtest

REM 4. Clone the openj9-systemtest repository
cd c:\%USERPROFILE%\git
git clone git@github.com/eclipse/openj9/openj9-systemtest.git openj9-systemtest

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

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

REM 7. Build
cd C:\%USERPROFILE%\git\openj9-systemtest\openj9.build
make

REM 8. Run the tests (takes a long time (many minutes))
cd C:\%USERPROFILE%\git\openj9-systemtest\openj9.build
make test
echo See c:\stf_temp to view the test results