Docker files for local development setup and attempt to fix encoding issues for SHP ingestion reported https://github.com/AtlasOfLivingAustralia/biocache-store/issues/353

Author: djtfmartin

README.md

@@ -1,4 +1,57 @@
 ###    [![Build Status](https://travis-ci.org/AtlasOfLivingAustralia/spatial-service.svg?branch=master)](https://travis-ci.org/AtlasOfLivingAustralia/spatial-service)
 
 # spatial-service
-This is the replacement for layers-service, analysis-service components of ALA.
+
+This component provides the bulk of the spatial web services for the Atlas' spatial portal that make use of spatial 
+data in Shape or Grid format.
+
+It includes:
+ 
+* A management console Ingestion of Shape and Grid files
+* TODO complete list....
+
+# Architecture
+
+* Grails 3 web application ran in the tomcat 7 or as standalone executable jar
+* Open JDK 8
+* PostGIS database (9.6 or above)
+* Geoserver
+
+# Installation
+
+There are ansible scripts for this applications (and other ALA tools) 
+in the ala-install project. 
+The ansible playbook for the spatial-service is here
+
+You can also run this application locally by following the instructions on its wiki page.
+
+# Running it locally
+
+Here are some instructions for running spatial-service locally for development.
+The assumption here is that you are trying to run spatial-service in an IDE such as IntelliJ
+
+
+There is a docker-compose YML file that can be used to run postgres & geoserver
+ locally for local development purposes. To use, run:
+
+```
+docker-compose -f geoserver-postgis.yml up -d
+```
+
+And to shutdown:
+
+```
+docker-compose -f geoserver-postgis.yml kill
+```
+
+There is also a requirement for have GDAL installed locally. This can be done with HomeBrew on Mac OSX
+
+```
+brew install gdal
+```
+
+Note: On Mac OSX, GGDAL tools are installed here `/usr/local/bin/`. You can use the `gdal.dir` configuration property to specify the location if different.
+
+
+
+

build.gradle

@@ -12,7 +12,7 @@ buildscript {
     }
 }
 
-version "0.3"
+version "0.3.1-SNAPSHOT"
 group "au.org.ala"
 
 apply plugin:"eclipse"
@@ -39,7 +39,7 @@ dependencies {
     compile "org.springframework:spring-test:4.3.9.RELEASE"
     compile "org.grails:grails-core"
     compile "org.springframework.boot:spring-boot-starter-actuator"
-    compile "org.springframework.boot:spring-boot-starter-tomcat"
+    provided "org.springframework.boot:spring-boot-starter-tomcat"
     compile "org.grails:grails-web-boot"
     compile "org.grails:grails-logging"
     compile "org.grails:grails-plugin-rest"

env/geoserver/.envgeoserver

@@ -0,0 +1,16 @@
+USERNAME=admin
+PASS=geoserver
+GEOSERVER_URL=http://localhost:8080/geoserver
+GEOSERVER_DATA_DIR=/data/geoserver_data_dir
+GEOWEBCACHE_CACHE_DIR=/data/geoserver_data_dir/gwc
+GEOSERVER_LOG_LOCATION=/data/geoserver_data_dir/logs/geoserver.log
+FOOTPRINTS_DATA_DIR=/data/geoserver_data_dir/footprints_dir
+RELINQUISH_LOG4J_CONTROL=true
+ENABLE_JSONP=true
+MAX_FILTER_RULES=20
+OPTIMIZE_LINE_WIDTH=false
+LAYERS_DB_HOST=postgis
+LAYERS_DB_PORT=5432
+LAYERS_DB_NAME=layersdb
+LAYERS_DB_USERNAME=layers
+LAYERS_DB_PASSWORD=layers