Clone the Clowder source to your local machine:
Docker Compose Setup
After you checkout the Clowder source, simply run the following command to bring up the Clowder stack under Docker Compose:
No Docker Compose? No Problem!
If you do not have the docker-compose binary natively installed, you can create an alias to run Compose under Docker instead:
You should then be able to run the same command to bring up the Clowder stack:
Developer Environment Setup
- Install JetBrains Toolbox
- Install IntelliJ
- Import Clowder SBT project into IntelliJ - you should be automatically prompted to install SBT / Scala support
- Create a "Play 2.0 App" Run Configuration
- Download JNotify and edit your Run Configuration to add it to your path - your JVM arguments should include -Djava.library.path=path/to/jnotify
To compile Clowder you will need to have at least version 1.7 of JAVA. Version 1.8 will work as well.
On Windows and Mac, the JNotify library is required and not included with Java 1.8 64bit - this will result in degraded (e.g. extremely sluggish navigation) performance when debugging your developer instance.
The following message will display in the development console in IntelliJ if playframework is unable to locate JNotify in this case:
Cannot load the JNotify native library (no jnotify_64bit in java.library.path) Play will check file changes for each request, so expect degraded reloading performace.
JNotify Documentation can be found here: http://jnotify.sourceforge.net/
Download JNotify here: https://sourceforge.net/projects/jnotify/files/
Simply paste jnotify_64bit.dll to the path\to\jdk1.8\bin folder.
Mac OS X
Create a new folder called "jnotify" in the "lib" directory: e.g. /Library/Java/JavaVirtualMachines/jdk1.8.0_77.jdk/Contents/Home/lib/jnotify
Next, paste jnotify-0.94.jar, libjnotify.so, and libjnotify.jnilib to the path/to/jdk1.8/lib/jnotify folder.
Finally, add the following argument (adjusted with your correct path) to the JVM arguments in your Run Configuration for Clowder in IntelliJ:
Builds too slow? Increase -Xmx
In IntelliJ, often the default memory constraints are too low for Scala projects.
From the top menu, choose Help → Edit Custom VM Options and find the
This is your JVM's maximum memory heap size, which defaulted to 750MB for me.
Upping this value will decrease the amount of garbage collection necessary during build, and can therefore increase your overall build speed.
There are still a few things missing before Clowder will run properly
MongoDB: docker run -it -d --name=mongo -v $(pwd)/mongo:/data/db -p 27017:27017 mongo:3.4
For RabbitMQ plugin (extractors): docker run -itd --name=rabbit -p 5672:5672 -p 15672:15672 rabbitmq:management-alpine
For Elasticsearch plugin (search indexing): docker run -itd --name=elasticsearch -p 9200:9200 -p 9300:9300 elasticsearch:2
For ToolManager plugin (analysis environments): docker run -itd --name=toolserver -p 8082:8082 clowder/toolserver
For pyCSW plugin (?): docker build -t clowder:pycsw . && docker run -it -d --name pycsw -p 80:8000 clowder/pycsw
For Geoserver plugin (QGIS analysis): ??
docker run -it --rm --net=host -e RABBITMQ_URI="amqp://guest:guest@localhost/%2f" -e REGISTRATION_ENDPOINTS="http://188.8.131.52:9000/api/extractors?key=r1ek3rs" -v $(pwd):/home/clowder clowder/extractors-image-metadata