The odf-test-env archive contains a simple test environment for ODF. It contains all components to run a simple ODF installation, namely
The test environment is available on Linux and Windows.
Make sure that
If you are running on Linux you can download and install the latest ODF test environment by downloading the script download-install-odf-testenv.sh
from here.
If you call the script with no parameters, it will download, install and start the latest version of the test env. The default unpack directory is ~/odf-test-env
.
You can get the latest version of the test environment from the Jenkins here.
To start the test environment on Linux, run the script odftestenv.sh start
. The script will start four background processes (Zookeeper, Kafka, Atlas, Jetty). To stop the test env, use the script odftestenv.sh stop
.
To start the test environment on Windows, run the script start-odf-testenv.bat
. This will open four command windows (Zookeeper, Kafka, Atlas, Jetty) with respective window titles. To stop the test environment close all these windows. Note that the HADOOP_HOME
environment variable needs to be set on Windows as described in the build documentation.
Once the servers are up and running you will reach the ODF console at https://localhost:58081/odf-web-0.1.0-SNAPSHOT.
Note: The test environment scripts clean the Zookeeper and Kafka data before it starts. This means in particular that the configuration will be reset every time you restart it!
Have fun!
On Linux, the odftestenv.sh
script has these additional options
cleanconfig
: Restart the test env with a clean configuration and clean Kafka topicscleanmetadata
: Restart with empty metadatacleanall
: Both cleanconfig
and cleanmetadata
.Once started you can hot-deploy a new version of the ODF war file simply by copying it to the odfjettybase/webapps
folder even while the test environment's Jetty instance is running. Note that it may take a couple of seconds before the new app is available.
If you have the ODF build set up you may want to use the deploy-odf-war.bat/.sh
for this. You must edit the environment variable ODF_GIT_DIR
in this script first to point to your local build directory.