Running Tests


Before running tests, ensure all steps in the have been performed.

Running Tests By Type

Tests are broken up into five types - unit, integration, distributed, acceptance, and upgrade. They can be executed using the following commands from the Geode repository root directory:

  • Unit tests: generally test a single class and run quickly
    ./gradlew test
  • Integration tests: involve inter-operation of components or subsystems
    ./gradlew integrationTest
  • Distributed tests: involve multiple members of a distributed system.
    ./gradlew distributedTest
  • Acceptance tests: test Geode from end user perspective
    ./gradlew acceptanceTest
  • Upgrade tests: test compatibility between versions of Geode and rolling upgrades
    ./gradlew upgradeTest

Running Individual Tests

To run an individual test, you can either

  1. Run the test in your IDE
  2. Run from terminal by specifying the sub-project and test type:
    ./gradlew project:testType --tests testName
    For example:
    ./gradlew geode-core:test --tests ArrayUtilsTest
    ./gradlew geode-core:distributedTest --tests ConnectionPoolDUnitTest

Running Tests By Category

To run a specific category of tests (eg: GfshTest):
./gradlew project:testType -PtestCategory=fullyQualifiedTestClassName
For example:
./gradlew geode-core:distributedTest -PtestCategory=org.apache.geode.test.junit.categories.GfshTest

Available categories can be found in the geode-junit/src/main/java/org/apache/geode/test/junit/categories in the Geode repository.

Viewing Test Results

Test results can be viewed by navigating to build/reports/combined in the Geode repository, then opening the index.html file in your browser.