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_HOME
, HADOOP_HOME
和 KAFKA_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目录。
看见 升级指南 有关在不同版本之间升级的更多详细信息。