Running Ozone Acceptance and Unit Tests

It is a good idea to run the Ozone Acceptance and Unit tests before committing your patch. The whole process takes around 20 minutes, including the time taken to build the Ozone tarball.

1. Ensure you have the following tools installed on your development machine.
   1. Docker
   2. jq. On MacOS, this can be installed with homebrew using brew install jq
   3. Robot Framework. On MacOS, this can be installed using brew install robot-framework


2. Build an Ozone tarball with:
   1. mvn clean install package -Phdds -DskipTests=true -Dmaven.javadoc.skip=true -DskipShade -Pdist –Dtar
      
      
3. Run the Tests.
   1. Acceptance Tests. This will launch docker containers, run tests, and create a report in the same directory named report.html. Open the report file in a browser and if the page background is green, we are good.
      
      1. cd hadoop-ozone/acceptance-test/
      2. bash
      3. ./dev-support/bin/robot-all.sh
   2. HDDS Unit Tests. 
      1. cd hadoop-hdds
      2. mvn test
   3. Ozone Unit Tests. 
      1. cd hadoop-ozone
      2. mvn test

Look at the results and then commit the patch.

Troubleshooting

If the acceptance tests fail, retry the above steps running on a clean branch (without your changes). If they continue to fail then it is likely that docker containers did not start correctly. You should see error messages on the terminal.

Also try out the following:

1. Ensure that the directory ./hadoop-dist/target/compose/ozone/ exists in your source tree after the build completes.
2. Go to ./hadoop-dist/target/compose/ozone/ and run 'docker-compose up'.
3. Ensure that Ozone services start up correctly in the docker containers.
4. If this step fails, check that the file .env exists and has a line like the following (the exact version may be different).
   1. HDDS_VERSION=0.2.1-SNAPSHOT

These steps were originally compiled by Anu Engineer (Apache ID aengineer).