Skip to content

Latest commit

 

History

History
62 lines (39 loc) · 1.82 KB

RUN.md

File metadata and controls

62 lines (39 loc) · 1.82 KB
Raw

Run Open Data Kit Hamsterball Client

Here's how you get Open Data Kit Hamsterball client up and running locally.

Prerequisites

It is assumed you have working knowledge of Git, Maven, and Tomcat.

First, install ODK Hamster Web Service

ODK Hamster Web Service installation instructions are here.

Second, check out source code.

git clone git@github.com:benetech/odk-hamsterball-java.git

Third, compile the code

From the odk-hamsterball-java directory, run:

mvn clean install -DskipTests

If you'd rather run unit tests:

mvn clean install

The first unit tests are in progress so there may not be much difference between the two commands.

Fourth, run the code

The code runs by default at port 8090, so that you can run it on the same server as odk-hamster, which uses port 8080 by default. You may want to disable any other services you're running that are using port 8090 at this time.

Start the web client:

java -jar target/*.jar

Optionally, if you must run on another port, add the following line to odk-hamsterball-java/src/main/resources/application-default.properties where 9009 is a port you know to be free.

server.port=9009

You're running!

The service will be launched by default at http://localhost:8090. There should be a login page. The default login information is username: admin, password: aggregate.

What's next?

Do you want to run this web service inside a Docker container? Read the Docker container instructions.

Do you want to see this project in Eclipse? Read the IDE instructions.