GeoWave 0.8.4
About
GeoWave is an open source set of software that:
- Adds multi-dimensional indexing capability to Apache Accumulo
- Adds support for geographic objects and geospatial operators to Apache Accumulo
- Contains a GeoServer plugin to allow geospatial data in Accumulo to be shared and visualized via OGC standard services
- Provides Map-Reduce input and output formats for distributed processing and analysis of geospatial data
Basically, GeoWave attempts to do for Accumulo as PostGIS does for PostgreSQL.
See GeoWave io page for more detailed documentatation, quickstart, examples, etc.
NGA is submitting GeoWave to Google's Summer of Code 2015 for students to build on and improve.
Screenshots
See Screenshots for more information.
Origin
GeoWave was developed at the National Geospatial-Intelligence Agency (NGA) in collaboration with RadiantBlue Technologies and Booz Allen Hamilton. The government has "unlimited rights" and is releasing this software to increase the impact of government investments by providing developers with the opportunity to take things in new directions. The software use, modification, and distribution rights are stipulated within the Apache 2.0 license.
Pull Requests
All pull request contributions to this project will be released under the Apache 2.0 license.
Software source code previously released under an open source license and then modified by NGA staff is considered a "joint work" (see 17 USC � 101); it is partially copyrighted, partially public domain, and as a whole is protected by the copyrights of the non-government authors and must be released according to the terms of the original open source license.
##In the News### Federal IT Innovation Depends On Being Open, Information Week, 7/24/2014 mentions GeoWave.
Ultra Quickstart
Dependencies: Software and Versions
This ultra quickstart assumes you have Apache Maven, Git, and Java (>= 1.7) installed on your system and on the path.
To view the data (via standard OGC services) a GeoServer instance >= 2.5 is required due to GEOT-4587.
GeoServer 2.5.2 with Geotools 11.2 the most tested version.
Apache Accumulo version 1.5 or greater is required. 1.5.0, 1.5.1, and 1.6.0 have all been tested.
Apache Hadoop versions 1.x and 2.x should all work. The software has specifically been run on Cloudera CDH4 and Hortonworks Data Platform 2.1.
MapReduce 1 with the new API (org.apache.hadoop.mapreduce.*) is used. Testing is underway against YARN / MR2 and seems to be positive, but well, it's still underway.
Java Advanced Imaging and Java Image I/O are also both required to be installed on the GeoServer instance(s) as well as on the Accumulo nodes. The Accumulo support is only required for certain functions (distributed rendering) - so this may be skipped in some cases.
Building: Maven!
Since GeoWave isn't currently in maven central we will build and install a local copy
$ git clone git@github.com:ngageoint/geowave.git
$ cd geowave && mvn install
Deploy: GeoServer
First we need to build the geoserver plugin - from the geowave root directory:
$ cd geowave-deploy
$ mvn package -P geotools-container-singlejar
let's assume you have geoserver deployed in a tomcat container in /opt/tomcat
$ cp target/geowave-deploy-0.8.4-geoserver-singlejar.jar /opt/tomcat/webapps/geoserver/WEB-INF/lib/
and re-start tomcat
Deploy: Accumulo
This should be very familiar by now; from the geowave root directory:
$ cd geowave-deploy
$ mvn package -P accumulo-container-singlejar
This distributable needs to be in the Accumulo classpath on every tablet server.
See: Installation Page for more information about deployment.
GeoWave System Integration Test
The geowave-test module will run end-to-end integration testing on either a configured Accumulo instance or a temporary MiniAccumuloCluster. It will ingest both point and line features spatially and temporally from shapefiles and test that spatial and spatial-temporal queries match expected results.
A specific Accumulo instance can be configured either directly within this pom.xml or as Java options -DzookeeperUrl=<zookeeperUrl> -Dinstance=<instance> -Dusername=<username> -Dpassword=<password>
If any of these configuration parameters are left unspecified the default integration test will use a MiniAccumuloCluster created within a temporary directory. For this to work on Windows, make sure Cygwin is installed and a "CYGPATH" environment variable must reference the <CYGWIN_HOME>/bin/cygpath.exe file.
Supported Versions
The Travis CI test matrix will test all combinations of the following releases using Oracle JDK7:
Accumulo: 1.5.1 and 1.6.0
Hadoop: 2.0.0-cdh4.7.0, 2.3.0-cdh5.0.3, and 1.2.0.23*
GeoTools/GeoServer: 11.2/2.5.2
* Accumulo 1.5.1 and Hadoop 1.2.0.23 is the one exception that is not tested and has been found to fail starting the MiniAccumuloCluster in the integration test
Ingest Data
Coming Soon! With useful details!
(basically run geowave-ingest::mil.nga.giat.geowave.ingest.IngestMain with the geowave-types module included in the classpath - geowave-ingest uses SPI to discover supported formats and geowave-types provides a set of basic formats)
View in GeoServer
Coming Soon! With screenshots as well!
(basically add a GeoWave data store through the add datastore menu and configure the layer like normal)