Skip to content
Nimisha Gupta edited this page Jun 5, 2017 · 15 revisions

Quick-Start:

Instructions to get and build the source code

  1. Clone the repository

    git clone https://github.com/strandls/openimadis

  2. If you already have cloned the openimadis repository, pull the updates before building

    git pull

  3. Download and install Tomcat7

  4. Download and install Gradle on the system where you need to build.

  5. Ensure jdk7 is installed, and JAVA_HOME is set correctly. If there are multiple java on the system the jdk to be used for building can be specified in [Gradle Build Environment (https://docs.gradle.org/current/userguide/build_environment.html). Make sure CATALINA_HOME is set correctly in your Environment. Set it to Tomcat7 bin directory. A sample configuration:

export JAVA_HOME=/cygdrive/c/Program\ Files/Java/jdk1.7.0_79

export JRE_HOME=/cygdrive/c/Program\ Files/Java/jdk1.7.0_79

export PATH=$PATH:/cygdrive/c/openImaDis/gradle-2.14.1/bin

export CATALINA_HOME=C:\\openImaDis\\apache-tomcat-7.0.70\\

  1. Run shell script buildServerBundle.sh (present in the root directory) to create server bundle.

  2. After successful execution of the script, ServerBundle is created in REPOSITORY_ROOT/build/distributions

  3. Follow instructions here to deploy the server.

Default build uses 5.1.5 version of bioformats. If you wish to use another version of bioformats library

  1. Download bio-formats jar you wish to use.

  2. The downloaded bio-formats jar needs to be updated with format readers for openImaDis. A helper script to updated the bio-formats jar can be found at REPOSITORY_ROOT/scripts/loci_tools/updateLociToolsJar.sh

  3. Run the script with the path of loci_tools.jar (bio-formats jar) as input.

  4. This will update the input loci_tools.jar with the format readers for openImaDis. Kindly make backup of loci_tools.jar if you want to keep the original file for future use.

  5. Update the path of loci_tools.jar in dependencies section of REPOSITORY_ROOT/icore/build.gradle with the actual path of the updated loci_tools.jar

  6. Also, update copyUploadServiceLibs section of REPOSITORY_ROOT/iclient/build.gradle with the actual path of the updated loci_tools.jar