0
点赞
收藏
分享

微信扫一扫

在GeoServer中使用插件在S3中添加Geotiff数据源

boom莎卡拉卡 2021-09-21 阅读 82

  GeoServer是一种开源的、支持ocg协议的地图服务软件,支持跨源数据图层的发布,底层依赖的其实是geotools的实现。GeoServer中原本就支持GeoTiff格式数据的图层发布,但功能比较局限,主要是它只支持本地tiff的发布。在GeoServer的官网中有一款插件,可以实现对Amazon S3协议中的tiff进行加载、发布。本文介绍的就是如何使用该款插件。

  1. GeoServer安装
      GeoServer的安装有多种方式,常用的有两种:war包和exe应用程序。如果使用war包,需要自己部署tomcat;应用程序则比较傻瓜式,且比较稳定,但只能在windows系统中使用。本文使用的是应用程序安装包,GeoServer版本为2.15.0。安装方法官网基本都有介绍,这里略去不提。
  2. s3-geotiff插件安装
      这个插件比较神奇,它目前(2019.03.25)还不是正式发布的插件,而是Community modules中的一项,根据官网所言,这些模块不是官方发布的,同时也是实验性的作品。可能多多少少会有些bug,不过我想基本功能应该可以使用。
      适合最新版本的s3-geotiff插件在这个目录里,旧版本的应该能在其上层目录中找到,下载适合自己的版本就好。由于我用的GeoServer是目前最新版本(2.15.0),因此我下载了community-latest目录里的2.16-SNAPSHOT版本。
      下载下来是一个zip压缩包,里边全是jar包。假设GeoServer的安装目录是GEOSERVER_HOME,那么只要把这些jar包全部复制到以下目录即可:
GEOSERVER_HOME/webapps/geoserver/WEB_INF/lib

 如果使用的是war包安装法,那么把GEOSERVER_HOME替换成tomcat的根目录就行。

  1. 使用插件
      jar包复制完后插件就已经安装好了,现在,如果启动GeoServer,在浏览器打开localhost:8080/geoserver,然后点进数据存储->添加新的数据存储,可以看见多了这么一个东西:


      这就说明插件已经安装成功了。但现在能加载的数据源有限,应该只限于amazon s3上的公共数据,而私有数据,以及其他基于s3协议实现的文件系统(比如Minio)里的数据,还无法访问,仔细翻阅官网的说明文档,还需要进行一些配置才能使用。
      所以,现在先把服务关掉,等配置完再重启把~
  2. Obs配置
      基于项目原因,我这边使用的是华为云Obs文件存储服务,它是基于S3协议实现的,理论上可以通过该插件读取。且我还需要读取私有数据,因此得指定ak、sk、endpoint等参数。
      首先需要自己新建一个配置文件,在里面对以上参数进行指定,大致如下:
obs.s3.endpoint=obs.cn-north-1.myhwclouds.com
obs.s3.user=你的sk
obs.s3.password=你的sk

  每一行最前面的obs可以替换成任何你喜欢的字母,比如prefix,这与最终选择数据源时填写的路径有关。
  然后,就是要想办法让这个文件生效,偏偏这点在官网里没有说明。但是,在没有指定配置文件的情况下点击s3插件,后台会报出这么一个提示:

Properties are missing! The system property 's3.properties.location' should be set and contain the path to the s3.properties file.

  也就是说,需要有一个环境变量s3.properties.location,其值为我们刚刚创建的那个配置文件的路径。这样就好办了,大概可以直接在系统环境变量里把这东西加进去(我自己没试过),我这边是修改了geoserver启动时的批处理命令startup.bat。exe安装目录下的startup.bat原本大概是这样的:

for /f "delims=" %%i in ('dir /b/s "%~dp0..\webapps\geoserver\WEB-INF\lib\marlin*.jar"') do set MARLIN_JAR=%%i
if not "%MARLIN_JAR%" == "" set MARLIN_ENABLER=-Xbootclasspath/a:"%MARLIN_JAR%" -Dsun.java2d.renderer=org.marlin.pisces.MarlinRenderingEngine

call "MyJavaHome" %MARLIN_ENABLER% -DGEOSERVER_DATA_DIR="MyGeoServerDataDirectory" -Xmx512m -DSTOP.PORT=8079 -DSTOP.KEY=geoserver -Djetty.base="MyGeoServerHome" -Djetty.logs="MyGeoServerHome\logs" -jar "MyGeoServerHome\start.jar" --module=http jetty.port=8080

  在命令的最后面加上一条-Ds3.properties.location="MyS3PropertiesPath"即可:

for /f "delims=" %%i in ('dir /b/s "%~dp0..\webapps\geoserver\WEB-INF\lib\marlin*.jar"') do set MARLIN_JAR=%%i
if not "%MARLIN_JAR%" == "" set MARLIN_ENABLER=-Xbootclasspath/a:"%MARLIN_JAR%" -Dsun.java2d.renderer=org.marlin.pisces.MarlinRenderingEngine

call "MyJavaHome" %MARLIN_ENABLER% -DGEOSERVER_DATA_DIR="MyGeoServerDataDirectory" -Xmx512m -DSTOP.PORT=8079 -DSTOP.KEY=geoserver -Djetty.base="MyGeoServerHome" -Djetty.logs="MyGeoServerHome\logs" -jar "MyGeoServerHome\start.jar" --module=http jetty.port=8080 -Ds3.properties.location="MyS3PropertiesPath"

  批处理命令中的路径都要用双引号括起来。如果用的是war包安装,据说需要修改TOMCAT_HOME/bin目录下的catalina.bat文件,在里面添加一条set CATALINA_OPTS="MyS3PropertiesPath",虽然我自己还是没试过就是了(跑)。

  1. 发布图层
      这样一来配置就完成了,重新启动GeoServer,点进新增的S3GeoTiff里,长这样:



      其他都随意,就是那个连接参数需要注意一下。官网里说填写格式是这样的:

prefix://bucket/key?useAnon=true&awsRegion=CN_NORTH_1

  prefix就是配置文件里每一行的头一个单词,在我的配置文件中就是obs,这个是用来与默认的s3区分,告诉GeoServer不要去亚马逊s3去找,而是去我们自己定义的endpoint域名下去找,也可以是Minio的http://ip:port模式。useAnon这个参数好像是指定是否要使用用户的认证参数,不用的话就是用默认的连接证书,由于我们需要访问私有数据,因此该参数应该设置为true。后面的awsRegion根据情况设置即可,我的Obs地区是CN_NORTH_1,不设置的话默认好像是US_EAST_1。这里比较恶心的是,region要全用大写字母,且用下划线做连接符,比如不能按照一般的写成cn-north-1形式。这也是我根据后台报错和查看源码得出来的结果(希望正式发布能把这个问题改改掉)。
  组织好自己的URL后填进去,保存->发布->预览一气呵成,结果如下:


  最后再吐槽一下,这个插件一次只能选择单个tiff文件为对象,不能选择多个或一个文件夹(和原生的GeoTiff加载一样),用着还是不那么方便。有机会的话可以试着改改它的代码,有机会的话。

举报

相关推荐

0 条评论