21.2. 安装GeoMesa Lambda

备注

以下示例要求在环境中设置版本:

$ export TAG="4.0.2"
$ export VERSION="2.12-${TAG}" # note: 2.12 is the Scala build version

21.2.1. 从二进制分发安装

GeoMesa Lambda构件可以下载,也可以从源代码构建。最简单的入门方法是从下载最新的二进制版本 GitHub.

下载并将其解压到方便的位置:

# download and unpackage the most recent distribution:
$ wget "https://github.com/locationtech/geomesa/releases/download/geomesa-${TAG}/geomesa-lambda_${VERSION}-bin.tar.gz"
$ tar xvf geomesa-lambda_${VERSION}-bin.tar.gz
$ cd geomesa-lambda_${VERSION}

21.2.2. 从源开始构建

也可以从源代码构建GeoMesa Lambda。有关详细信息,请参阅上的说明 GitHub 。本章剩余的说明假定使用二进制GeoMesa Lambda分布。如果您是从源代码构建的,则在 target 目录号 geomesa-lambda/geomesa-lambda

21.2.3. 安装Acumulo分布式运行时库

Lambda数据存储需要安装Acumulo数据存储分布式运行时。看见 安装Acumulo分布式运行时库

21.2.4. 设置Lambda命令行工具

GeoMesa附带一组命令行工具,位于 geomesa-lambda_${VERSION}/bin/ 二进制分布的。

21.2.4.1. 配置类路径

GeoMesa需要在类路径上安装Acumulo、Hadoop和Kafka罐子。默认情况下,它们不捆绑在一起,因为它们应该与目标系统上安装的版本相匹配。

如果环境变量 ACCUMULO_HOMEHADOOP_HOMEKAFKA_HOME ,则GeoMesa将从这些位置加载适当的JAR和配置文件,不需要进一步的配置。否则,在您第一次调用这些工具时,系统将提示您下载适当的JAR。环境变量可以在 conf/*-env.sh 和依赖项版本可以在 conf/dependencies.sh

为了运行映射/还原作业,Hadoop *-site.xml Hadoop安装中的配置文件必须位于类路径中。如果 HADOOP_HOME 未设置,则将它们复制到 geomesa-lamdba_${VERSION}/conf

GeoMesa还提供了使用环境变量将其他JAR添加到类路径的功能 GEOMESA_EXTRA_CLASSPATHS 。GeoMesa会将此环境变量的内容添加到计算的类路径中,从而使其在类路径中具有最高的优先级。用户可以使用冒号提供JAR文件或单个文件的目录 (: )作为分隔符。这些条目还将添加到map-create libjars变量中。

备注

看见 日志记录配置 了解有关配置SLF4J实现的信息。

由于许可限制,必须单独安装形状文件支持的从属项。使用以下命令执行此操作:

$ ./bin/install-shapefile-support.sh

测试调用GeoMesa工具的命令:

$ geomesa-lambda

输出应如下所示::

Usage: geomesa-lambda [command] [command options]
  Commands:
  ...

备注

GeoMesa Acumulo命令行工具可以针对已持久保存到Acumulo的要素使用。看见 设置Acumulo命令行工具 有关Acumulo命令行工具的详细信息。

21.2.5. 在Geoserver中安装GeoMesa Lambda

警告

看见 Geoserver版本 以确保Geoserver与您的GeoMesa版本兼容。

21.2.5.1. 安装Geoserver

如第节所述 GeoMesa和Geoserver ,GeoMesa实现了一个 GeoTools -兼容数据存储。这使得将GeoMesa用作中的数据存储成为可能 GeoServer 。Geoserver的网站包括 installation instructions for GeoServer

安装Geoserver后,如果您计划使用GeoMesa进程,则可以安装WPS插件。Geoserver WPS插件必须与Geoserver实例的版本匹配。Geoserver网站包含下载和安装说明 the WPS plugin

备注

如果使用Tomcat作为Web服务器,则很可能需要传递一些自定义选项:

export CATALINA_OPTS="-Xmx8g -XX:MaxPermSize=512M -Duser.timezone=UTC \
-server -Djava.awt.headless=true"

的价值 -Xmx 应该在您的系统允许的范围内尽可能大。确保重新启动Tomcat以使更改生效。

21.2.5.2. 安装GeoMesa Lambda数据存储

要安装GeoMesa数据存储,请提取 geomesa-lambda-gs-plugin_${VERSION}-install.tar.gz 文件放入 geomesa-lambda_${VERSION}/dist/gs-plugins/ 在二进制分布中或 geomesa-lambda/geomesa-lambda-gs-plugin/target/ 放入您的Geoserver的 lib 目录:

$ tar -xzvf \
  geomesa-lambda_${VERSION}/dist/gs-plugins/geomesa-lambda-gs-plugin_${VERSION}-install.tar.gz \
  -C /path/to/geoserver/webapps/geoserver/WEB-INF/lib

接下来,安装Acumulo、Hadoop和Kafka的罐子。默认情况下,将从Maven Central下载JAR。您可以通过设置环境变量来覆盖此设置 GEOMESA_MAVEN_URL 。如果您没有互联网连接,您可以手动下载JAR。

编辑文件 geomesa-lambda_${VERSION}/conf/dependencies.sh 要设置Acumulo、Hadoop和Kafka的版本以匹配目标环境,然后运行脚本:

$ ./bin/install-dependencies.sh /path/to/geoserver/webapps/geoserver/WEB-INF/lib

安装JAR后重新启动Geoserver。

21.2.5.3. GeoMesa工艺

GeoMesa提供了一些WPS进程,例如 geomesa:Density 它被用来生成热图。要使用这些进程,请安装Geoserver WPS插件,如中所述 GeoMesa过程

21.2.6. 升级

要在GeoMesa的次要版本之间升级,所有GeoMesa组件的版本 must 火柴。这意味着 geomesa-distributed-runtime Acumulo平板电脑服务器上安装的JAR must 与的版本匹配 geomesa-plugin 安装在 WEB-INF/lib Geoserver目录。

看见 升级指南 有关在不同版本之间升级的更多详细信息。