Skip to main content
Version: Next

Running Tests in Apache Ambari

This guide explains how to run different types of tests in Apache Ambari. For the official test configuration, you can refer to the Ambari Jenkinsfile.

Java Tests​

Running All Java Tests​

To run all Java tests for the Ambari Server:

mvn -am test -pl ambari-server \
    -DskipPythonTests \
    -Dmaven.test.failure.ignore \
    -Dmaven.artifact.threads=10 \
    -Drat.skip \
    -DskipAdminWebTests=true

Running Specific Java Tests​

To run a specific Java test class:

mvn -am test -pl ambari-server \
    -DskipPythonTests \
    -Dmaven.test.failure.ignore \
    -Dmaven.artifact.threads=10 \
    -Drat.skip \
    -DskipAdminWebTests=true \
    -Dtest=AmbariServerTest

To run a specific test method within a test class:

mvn -am test -pl ambari-server \
    -DskipPythonTests \
    -Dmaven.test.failure.ignore \
    -Dmaven.artifact.threads=10 \
    -Drat.skip \
    -DskipAdminWebTests=true \
    -Dtest=AmbariServerTest#testMethodName

Test Parameters Explained​

  • -am: Also build dependencies
  • -pl ambari-server: Only build the ambari-server module
  • -DskipPythonTests: Skip Python tests
  • -Dmaven.test.failure.ignore: Continue the build even if tests fail
  • -Dmaven.artifact.threads=10: Use 10 threads for parallel artifact resolution
  • -Drat.skip: Skip Apache RAT (Release Audit Tool) checks
  • -DskipAdminWebTests: Skip admin web interface tests
  • -Dtest: Specify which test class or method to run

Python Tests​

Running All Python Tests​

To run all Python tests:

mvn test -pl ambari-server \
    -DskipJavaTests \
    -Dpython.test.mask="*_test.py" \
    -Dpython.test.skip.pattern="agent_perf.py"

Running Specific Python Tests​

To run a specific Python test file:

mvn test -pl ambari-server \
    -DskipJavaTests \
    -Dpython.test.mask="test_file_name.py"

Python Test Parameters Explained​

  • -DskipJavaTests: Skip Java tests
  • -Dpython.test.mask: Pattern to match test files to run
  • -Dpython.test.skip.pattern: Pattern to match test files to skip

Integration Tests​

Running Integration Tests​

To run integration tests:

mvn verify -pl ambari-server \
    -P integration-tests \
    -DskipPythonTests \
    -DskipJavaTests

Integration Test Parameters​

  • -P integration-tests: Activate the integration-tests profile
  • -DskipPythonTests: Skip Python tests
  • -DskipJavaTests: Skip Java tests

Test Reports​

Test reports can be found in the following locations after test execution:

Java Test Reports​

  • Unit Tests: ambari-server/target/surefire-reports/
  • Integration Tests: ambari-server/target/failsafe-reports/

Python Test Reports​

  • Test Results: ambari-server/target/python-test-results/
  • Coverage Reports: ambari-server/target/python-coverage/
tip

When debugging test failures, check these report directories for detailed test execution logs and stack traces.

Running Tests in Apache Ambari Metrics

1. Install Prequisites​

Ambari Metrics requires a few more prerequisite for unit testing.

yum install -y krb5-devel
pip3 install distro kerberos

Java Tests​

Running All Java Tests​

To run all Java tests for the Ambari Metrics:

mvn test \
    -DskipPythonTests \
    -Dmaven.test.failure.ignore \
    -Dmaven.artifact.threads=10 \
    -Drat.skip

All Tests (Python and Java)​

To run all Java tests for the Ambari Metrics:

mvn test \
    -Dmaven.test.failure.ignore \
    -Dmaven.artifact.threads=10 \
    -Drat.skip