iServer服务迁移

使用说明

GIS云套件支持将SuperMap iServer中已发布的服务迁移至GIS云套件中，并对其进行统一的容器化管理和运维。迁移过程主要依赖于提取并适配iServer的服务配置文件。

服务配置本身不包含GIS数据文件。在开始迁移配置前，您必须手动将服务所依赖的数据文件（如工作空间、UDB数据源、本地缓存等）上传或迁移至GIS云套件环境（如文件管理器），并随后在配置文件中将数据源路径更新为GIS云套件中的新路径。

准备工作:

  1. 拥有源SuperMap iServer服务器的访问权限，以获取配置文件。
  2. 明确待迁移服务所使用的所有数据源及其本地存储路径。
  3. （关键步骤）已通过GIS云套件的文件管理器或其它方式，将所需数据文件完整上传至云套件目标存储位置，并记录新路径。文件管理器的使用方法请参见文件管理->文件管理器。
  4. 在GIS云套件中，已规划或创建好用于承载迁移服务的服务节点，并确认其具备相应许可。

操作步骤

步骤一：提取并整合服务配置

此步骤在源iServer服务器上操作，目的是生成一份完整的服务描述文件。

  1. 在SuperMap iServer安装目录中，进入子文件夹：webapps/iserver/WEB-INF。

  2. 找到并打开iserver-services-interfaces.xml文件。

  3. 复制该文件中<application>节点下的全部内容。

  4. 在同一目录下，找到并打开iserver-services.xml文件。

  5. 将步骤3复制的内容，粘贴至iserver-services.xml文件的<application>节点下，保存此文件。此文件现在包含了迁移所需的核心配置。

步骤二：修改配置文件中的数据路径

（关键适配操作）由于数据已手动迁移至新环境，必须更新配置以指向新位置。

  1. 使用文本编辑器打开整合后的iserver-services.xml文件。

  2. 在文件中找到所有<provider>节点，特别是其下的<config>子节点。

  3. 定位并修改其中定义数据路径的关键参数，主要是<workspacePath>（工作空间路径）和<outputPath>（输出路径）等。

    • 原始本地路径示例：D:\MapData\World.sxwu 或 /home/iserver/data/Jingjin.sxwu
    • 修改为云套件内路径示例：./data/World.sxwu （假设数据已上传至文件管理器的/data目录下）

    请根据您实际的数据上传位置，仔细修改所有相关路径。修改后请保存文件。

步骤三：在GIS云套件中发布服务

此步骤将在GIS云套件中基于修改后的配置，创建新的服务实例。

  1. 登录GIS云套件，进入iManager首页->系统管理，点击服务管理->服务实例->发布服务。

  2. 在发布页面，找到并启用高级选项。

  3. 将步骤二中修改完毕的iserver-services.xml文件的全部内容复制，粘贴至高级选项的输入框中。

  4. 点击下一步。

  5. 指定服务节点：

    • 选择已有（推荐）：将服务实例发布到已有的、具备许可权限的服务节点。
    • 新增服务节点：创建新的服务节点。输入节点名称，系统将根据服务类型提示许可分配。

  6. 点击发布。

结果验证与管理：

发布成功后，您可以在服务实例列表中看到迁移的服务。

  • 点击服务实例的地址链接，验证服务可正常访问并出图。
  • 点击服务实例名称进入详情页，检查数据源状态等信息。
  • 迁移后的服务即纳入GIS云套件统一管理，可进行授权、刷新、节点调度等操作。
注意事项：
  • 数据迁移：务必在修改配置和发布前，完成所有数据文件的手动上传，这是迁移成功的先决条件。
  • 路径准确匹配：配置文件中修改后的路径，必须与数据文件在GIS云套件环境中的实际存放路径完全一致。建议使用相对路径以增强兼容性。
  • 许可一致性：确保GIS云套件服务节点拥有的许可级别，不低于原iServer服务所需级别。
  • 复杂服务检查：对于聚合服务、含特殊依赖的服务，迁移后需重点验证其所有功能是否正常。

相关主题

发布服务

服务实例管理

文件管理器