升级现有版本

警告

请注意，某些升级是不可逆的，这意味着可能会更改数据目录，使其不再与较旧版本的geoserver兼容。参见 在版本之间迁移数据目录 了解更多详细信息。

一般的geoserver升级过程如下：

  1. 备份当前数据目录。这可能只需要将目录复制到其他位置。

  2. 确保当前数据目录在应用程序外部（不在应用程序文件结构内部）。

    检查Geoserver服务器状态页以仔细检查数据目录位置。

  3. 请记下您已安装的所有扩展。

    • 地球伺服器 About ‣ Server Status 页面提供了一个 Modules 列出已安装模块的标签。

    • 一些扩展包括多个模块，例如，WPS扩展如下所示 gs-wps-core 和 gs-web-wps 。

  4. 卸载旧版本并安装新版本。

    • 下载 maintenance 用于更新现有安装的版本

    • 下载 stable 在准备升级时发布

  5. 请务必下载并安装以前安装时使用的每个扩展。

  6. 确保新安装继续指向先前版本使用的相同数据目录。

有关升级特定版本的说明

WCS ArcGRID输出格式移除

Geoserver 2.24.0中已删除WCS的ArcGRID输出格式。如果您一直在使用此格式，则需要切换到其他基于文本的格式，例如GML Coverage，或者可以通过安装 WCS GDAL 社区模块，并使用如下配置(请适应您的系统)：

<ToolConfiguration>
  <executable>gdal_translate</executable>
  <environment>
    <variable name="GDAL_DATA" value="/usr/local/share/gdal" />
  </environment>
  <formats>
    <Format>
      <toolFormat>AAIGrid</toolFormat>
      <geoserverFormat>ArcGrid</geoserverFormat>
      <fileExtension>.asc</fileExtension>
      <singleFile>true</singleFile>
      <mimeType>application/arcgrid</mimeType>
    </Format>
  </formats>
</ToolConfiguration>

磁盘配额HSQL数据库使用率(Geoserver 2.24及更高版本)

从Geoserver 2.24开始，H2数据库支持将被用于切片缓存/磁盘配额存储的HSQL数据库所取代。

  • H2“磁盘配额存储类型”和“目标数据库类型”下的选项被替换为HSQL。

  • 默认存储类型将是进程内HSQL。

  • 选择进程内H2的现有安装将自动迁移到进程内HSQL。旧的H2数据库文件将保留在 gwc/diskquota_page_store_h2/ 在数据目录下。您可以删除这些内容，也可以保留它们以备降级之用。

  • 重要提示：选择了外部H2数据库的现有安装不会自动迁移。除非您使用依赖于h2的插件/扩展，否则您将在启动时收到错误消息，并且磁盘配额将被禁用。但Geoserver的其他功能将继续运行。您可以转到磁盘配额页面并配置外部HSQL数据库或切换到进程内HSQL。如果您想继续使用H2作为进程内/外部数据库，您可以添加H2存储插件或任何其他依赖于H2的扩展或插件。

  • 具有h2依赖关系的扩展/插件的Geoserver安装仍将在“磁盘配额存储类型”和“目标数据库类型”下具有h2选项。

远程请求控制(Geoserver 2.24及更高版本)

从Geoserver 2.24开始，已在Geoserver中添加并默认启用远程请求控制。此功能允许管理员控制允许向Geoserver发出哪些远程请求。默认情况下，不包括授权，因此Geoserver将拒绝来自用户交互的远程请求。特别是，以下使用案例会受到影响：

  • 具有远程获取样式的WMS操作 (sld 参数)和引用远程图标的样式(通常是数据目录之外的图标)。提醒一下，当找不到远程图标时，Geoserver将退回到默认图标，即带有黑色边框的灰色方块。

  • 带有请求中提供的动态远程WFS引用的WMS“要素描述” (REMOTE_OWS_TYPE 和 REMOTE_OWS_URL 参数)。

  • 通过GET或POST请求进行的WPS远程输入(例如，远程GeoJSON文件源)。

可以使用配置安全联系的位置列表 URL检查 佩奇。

Log4J升级(Geoserver 2.21及更高版本)

从Geoserver 2.21开始，Geoserver使用的日志记录系统已从Log4J 1.2升级到Log4J 2。

  • Geoserver现在使用 xml 内置日志记录配置文件的文件(以前 properties 使用了文件)。

  • 内置的日志记录配置文件通过 xml 文件：

    DEFAULT_LOGGING.xml
    DEFAULT_LOGGING.properties.bak

  • 以前版本的备份 properties 文件在升级过程中创建。如果您以前对内置配置文件进行了任何定制，则这些备份文件可在定制XML文件时用作参考。

  • Log4J 2确实具有读取Log4j 1.2属性文件的能力，尽管并非所有功能都受支持。

    任何习惯 properties 您创建的文件将继续可用。

  • 如有必要，您可以通过恢复到不同的文件名来恢复对内置日志记录配置文件执行的自定义。要从恢复自定义，请执行以下操作 PRODUCTION_LOGGING.properties.bak 将文件重命名为 PRODUCTION_LOGGING.properties.bak 至 CUSTOM_LOGGING.properties 。

  • 如果您从未打算自定义内置的日志记录配置文件，那么 UPDATE_BUILT_IN_LOGGING_PROFILES=true 系统属性将始终确保您获得我们最新的推荐。

JTS类型绑定（GeoServer 2.14及更高版本）

从GeoServer 2.14开始，由 REST 使用不同包名称的FeatureType和结构化覆盖请求 (org.locationtech 而不是 com.vividsolutions 对于几何类型绑定，由于升级到JTS（Java拓扑套件）1.16.0。例如：

之前：：

...
<attribute>
  <name>geom</name>
  <minOccurs>0</minOccurs>
  <maxOccurs>1</maxOccurs>
  <nillable>true</nillable>
  <binding>com.vividsolutions.jts.geom.Point</binding>
</attribute>
...

之后：：

...
<attribute>
  <name>geom</name>
  <minOccurs>0</minOccurs>
  <maxOccurs>1</maxOccurs>
  <nillable>true</nillable>
  <binding>org.locationtech.jts.geom.Point</binding>
</attribute>
...

任何依赖此绑定信息的REST客户机都应该更新以支持新名称。

geojson编码（geoserver 2.6及更高版本）

从Geoserver 2.6开始，WFS服务生成的GeoJSON不再对CRS使用非标准编码。若要出于兼容性目的重新启用此行为，请设置 GEOSERVER_GEOJSON_LEGACY_CRS=true 作为系统属性、上下文参数或环境变量。

Previous: 码头集装箱
Next: 入门