10.1. Installing GeoMesa Bigtable¶
10.1.1. Installing the Binary Distribution¶
GeoMesa Bigtable artifacts are available for download or can be built from source. The easiest way to get started is to download the most recent binary version (2.0.2) from GitHub.
Extract it somewhere convenient:
# download and unpackage the most recent distribution:
$ wget "https://github.com/locationtech/geomesa/releases/download/geomesa_2.11-$VERSION/geomesa-bigtable-dist_2.11-$VERSION-bin.tar.gz"
$ tar xvf geomesa-bigtable-dist_2.11-$VERSION-bin.tar.gz
$ cd geomesa-bigtable-dist_2.11-$VERSION
$ ls
bin conf dist docs examples lib LICENSE.txt logs
To run the command-line tools, the configuration file hbase-site.xml
must be on the classpath. This can
be accomplished by placing the file in the conf
folder. For more information, see Connecting to Cloud Bigtable.
10.1.2. Installing GeoMesa Bigtable in GeoServer¶
The HBase GeoServer plugin is bundled by default in a GeoMesa binary distribution. To install, extract
dist/gs-plugins/target/geomesa-bigtable-gs-plugin_2.11-$VERSION-install.tar.gz
into GeoServer’s WEB-INF/lib
directory. This distribution does not include HBase or Hadoop JARs - the following JARs
should be copied into GeoServer’s WEB-INF/lib
directory. For convenience, the script bin/install-hadoop-hbase.sh
will download them from Maven Central.
- hbase-annotations-1.3.1.jar
- hbase-client-1.3.1.jar
- hbase-common-1.3.1.jar
- hbase-hadoop2-compat-1.3.1.jar
- hbase-hadoop-compat-1.3.1.jar
- hbase-prefix-tree-1.3.1.jar
- hbase-procedure-1.3.1.jar
- hbase-protocol-1.3.1.jar
- hbase-server-1.3.1.jar
- commons-configuration-1.6.jar
- hadoop-annotations-2.5.2.jar
- hadoop-auth-2.5.2.jar
- hadoop-client-2.5.2.jar
- hadoop-common-2.5.2.jar
- hadoop-hdfs-2.5.2.jar
(Note the versions may vary depending on your installation.)
The Bigtable data store requires the configuration file hbase-site.xml
to be on the classpath. This can
be accomplished by placing the file in geoserver/WEB-INF/classes
(you should make the directory if it
doesn’t exist). For more information, see Connecting to Cloud Bigtable.
Restart GeoServer after the JARs are installed.
10.1.2.1. Jackson Version¶
Warning
Some GeoMesa functions (in particular Arrow conversion) requires jackson-core-2.6.x
. Some versions
of GeoServer ship with an older version, jackson-core-2.5.0.jar
. After installing the GeoMesa
GeoServer plugin, be sure to delete the older JAR from GeoServer’s WEB-INF/lib
folder.