GIS云套件

服务实例管理

GIS云套件支持对服务实例进行管理，包括查看服务实例详情、对服务实例批量授权、编辑服务实例配置、指定服务实例运行的服务节点等。以下将分别对服务列表页面与服务详情页面的管理功能进行介绍：

服务列表页面

点击左侧导航栏服务管理->服务实例进入服务实例列表页面，如下图所示：

服务实例过滤功能，可通过数据源类型、服务实例所在服务节点、服务实例类型、服务状态、服务实例关键字筛选所需服务实例。点击重置清空筛选项。

重点功能包括：

• 发布服务：点击进行服务发布，具体发布步骤请参见发布服务。

• 批量授权：批量设置服务实例的访问权限。

  • 匿名用户可访问：不设置访问权限，所有访客均可访问服务实例。
  • 所有登录用户可访问：GIS云套件中的用户，登录后可访问服务实例。
  • 指定角色可访问：授权可访问的角色，关联该角色的用户登录后可访问服务实例。

  备注：

  1. 访问权限的详细介绍请参见SuperMap iServer帮助文档。
  2. GIS云套件中用户与角色的介绍请参见安全。

• 刷新：批量刷新服务实例。当数据源发生变化时，需要同步更新服务实例，可通过刷新功能完成，更新过程中服务不会中断。
• 删除：批量删除选中的服务实例（单击服务列表左侧小方框可选中/取消服务实例）。

服务实例列表中的具体功能包括：

• 名称：服务实例名称，点击进入服务详情页面。点击名称右侧的小图标，可查看该实例所在服务节点，并对服务节点进行伸缩操作。
• 别名：自定义服务实例别名。
• 地址：服务实例地址，点击浏览iServer REST服务。
• 副本数：服务实例副本数量，可通过指定服务节点增加或减少。

• 状态：服务实例的状态，包括正常、异常和未检测三种状态。针对状态异常的服务实例，提供了异常自动告警和自动修复的能力。

  • 异常自动告警：默认情况下，每间隔30s进行一次异常检测，当服务实例连续检测出2次及以上的异常，就会触发自动告警机制，将告警信息发送到iManager报警历史页面；
  • 异常自动修复：默认情况下，每间隔30s进行一次异常检测，当服务实例连续检测出2次及以上的异常，将自动尝试重构该服务实例；当服务实例连续检测出8次及以上的异常，将自动尝试对该服务实例所在的服务节点进行重启。

  备注：

  1. 服务实例自动告警与修复的相关参数支持设置，具体请前往iManager站点管理>GIS云套件站点>ispeco-dashboard-api服务>编辑，参数说明如下：

     SERVICE_INSTANCE_REBUILD_ENABLED：是否开启服务实例检测异常后的自动修复机制，默认值为true；

     SERVICE_INSTANCE_ABNORMAL_THRESHOLD：设置当服务实例连续检测出多少次异常时，自动尝试服务实例的重构，默认值为2（次）；

     SERVICE_NODE_REBUILD_ENABLED：是否开启服务实例检测异常后对该服务实例所在的服务节点的自动重启机制，默认值为true；

     SERVICE_NODE_INSTANCE_ABNORMAL_THRESHOLD：设置当服务实例连续检测出多少次异常时，自动尝试对该服务实例所在的服务节点进行重启，默认值为8（次），可按需设置，建议设置值不少于8次；

     SERVICE_INSTANCE_ABNORMAL_ALERT_ENABLED：是否开启服务实例检测异常后的自动告警机制，默认值为true；

     SERVICE_INSTANCE_ABNORMAL_ALERT_THRESHOLD：设置当服务实例连续检测出多少次异常时，自动发送异常告警信息，默认值为2（次）；

     SERVICE_INSTANCE_STATUS_UPDATE_PERIOD：设置服务实例异常检测的间隔时间，默认值为30（秒）。

• 授权：设置服务实例的访问权限。

• 操作：

  • 指定服务节点：将服务实例调度到任意一个或多个（选择多个服务节点）服务节点上运行；也可新增服务节点，将服务实例调度到新的服务节点上，按需为服务节点分配许可（具体可参见服务节点创建中选择许可类型部分的介绍）。
  • 编辑：编辑服务实例配置。
  • 刷新：刷新服务实例。当数据源发生变化时，需要同步更新服务实例，可通过刷新功能完成，更新过程中服务不会中断。也可在服务节点的编排文件中加入环境变量，实现自动刷新，具体方法请参见附录->常见问题解答->问题13。
  • 清除缓存：清除该服务实例的地图缓存。注意：针对发布的REST-地图服务且数据源不是瓦片类型的服务实例，才具备此功能。
  • 删除：删除服务实例。

服务实例详情页面

点击服务列表中服务实例名称进入服务实例详情页面，如下图所示：

服务实例详情页显示了服务实例的名称、地址、创建时间、服务类型、数据源类型以及数据源信息，数据源类型是数据库型工作空间（Oracle工作空间、PostgreSQL工作空间、DM工作空间）或MongoDB瓦片、HBase服务、PostGIS服务时，可批量修改服务实例的数据源配置，点击别名处的按钮可为服务实例设置别名。

以数据源是PostgreSQL工作空间的服务实例为例，还可进行如下操作：

• 服务配置：更改服务实例配置。

  • 是否允许编辑：若允许编辑，则访问者可更改服务配置。
  • 是否启用地图瓦片缓存：启用后将自动切分为地图瓦片。
  • 是否启用矢量瓦片缓存：启用后将自动切分为矢量瓦片。
• 所在节点：查看承载服务实例运行的服务节点。
• 服务授权：设置服务实例的访问权限。

在上图红色方框内，可点击修改数据源配置进入修改数据源配置对话框。如下图所示，勾选应用到该数据源的所有服务实例可对数据源配置类型相同的服务实例进行批量修改，并可查看被应用的服务实例列表，点击确定完成修改。

影像服务管理

在服务列表中，点击属于影像服务的实例名称，进入数据源是影像服务的服务实例详情页面。 除了上述在“服务实例详情页面”部分的功能以外，影像服务还提供了影像查询与检索能力，并支持对查询结果进行浏览，点击影像检索处的地址即可查询。详细介绍请参考SuperMap iServer在线帮助（请参见[开始->使用iServer->使用影像服务->通过REST服务接口查询和检索影像]）。

以存储影像集合的数据源是文件型数据源(UDBX)为例，具体可进行如下操作：

• 影像集合：影像服务发布后，需要再通过添加影像集合的方式，为服务添加影像数据。

  a. 基础配置：可以对已有的影像服务通过添加影像集合的方式追加影像数据，还可以按需启用自动追加能力，监控影像数据目录并自动追加新增影像。详细介绍请参考SuperMap iServer在线帮助（请参见[开始->使用iServer->使用影像服务->添加影像集合]）。

  

  • 集合ID：用来在服务中唯一标识该影像集合。集合ID可以包含中文、英文字符、数字。
  • 标题：影像集合的标题，简短说明集合特征。
  • 卫星类型：影像集合所属卫星类型，可用来说明卫星信息。
  • 坐标参考（EPSG编码）：集合的坐标系，该集合下不同坐标系的影像都将动态投影为集合坐标系，坐标系通过EPSG编码指定，如：4326表示WGS 1984地理坐标系。集合的坐标参考默认值为：4326，即WGS 1984地理坐标系。如果“添加影像数据方式”为“已有镶嵌数据集”，该参数无效，集合的坐标系等于已有镶嵌数据集的坐标系。
  • 添加影像数据方式：集合中影像数据的来源，例如，影像来源于“影像数据目录”，表示将指定文件目录下的影像文件添加到集合。
  • 影像目录地址：指定影像数据目录的路径，支持本地路径和共享目录路径。
  • 文件类型：添加到集合中的影像文件类型，勾选对应的文件类型即可，支持多选。
  • 搜索子文件夹中的文件：开启后，支持添加影像目录中子文件夹中的影像。
  • 添加影像进程数：执行添加影像任务的进程数，默认为4。需要依据影像文件数量和机器资源合理设置。

  

  • 启用自动追加：开启后，监控目录下的新增影像文件将自动添加到集合。“存储影像集合的数据源”是UDBX类型时不支持自动追加。
  • 监控目录列表：监控的影像数据目录路径，输入后添加。通常与“影像数据目录”保持一致，也可设置其他目录。
  • 间隔时间：从自动追加触发器启动时间点开始，间隔多长时间触发一次自动追加影像操作。

  

  根据需要还可配置集合其他参数：

  • 影像集合的关键字：便于查询检索影像集合。
  • 数据使用许可协议：影像数据使用许可协议，应添加指向许可证文本的URL。
  • 允许编辑：开启，表示集合允许添加和删除影像。
  • 允许下载数据：开启，表示允许下载集合中的影像。
  • 数据提供者信息：配置数据提供者详细信息，可以通过“添加数据提供者信息”添加多个数据提供者。

  b. 风格配置：影像显示风格支持在集合中进行配置，集合中所有影像显示风格相同，影像集合静默切片和动态出图都将使用集合所配置的风格。

  

  • 是否应用风格模板：开启/关闭风格模板。开启后，可导入本地影像风格模板。
  • 影像风格模板：点击“导入风格模板文件”，上传本地影像图层属性模板（.xml）文件。

  在“影像显示风格”区域，设置影像显示风格参数：

  • 显示方式：支持两种：单波段拉伸显示，只显示某一个指定波段；波段组合显示，指定三个波段分布对应 R、G、B颜色通道组合显示。
  • 波段组合方式：若是单波段拉伸显示，输入一个波段号；若是波段组合显示，指定 R、G、B颜色通道分布对应的波段号，例如：R1,G2,B3 表示 1.2.3波段组合显示。
  • 拉伸方式：拉伸设置对单波段拉伸显示和波段组合显示都适用。
  • 插值方式：影像显示时使用的插值算法。
  • 亮度：影像显示的亮度。数值范围为-100到100，增加亮度为正，降低亮度为负。
  • 对比度：影像显示的对比度。数值范围为-100到100，增加对比度为正，降低对比度为负。
  • 无值透明：无值是否透明显示，若勾选，表示透明显示无值。
  • 无值：影像的无值。影像为多波段时，指定R、G、B颜色通道对应波段的无值。
  • 背景值透明：背景值是否透明显示，若勾选，表示透明显示背景值。
  • 背景值：影像的背景值。影像为多波段时，指定R、G、B颜色通道对应波段的无值。
  • 高程数据类型：影像显示使用的高程数据类型。

  c. 瓦片配置：支持配置启用影像服务动态缓存和影像静默切片方案。详细介绍请参考SuperMap iServer在线帮助（请参见[开始->使用iServer->使用影像服务->配置影像服务动态缓存/配置影像服务静默切片]）。

  

  • 启用动态缓存：启用动态缓存生效后，浏览该集合的影像数据时，将缓存动态生成的瓦片，再次浏览影像时，将复用缓存目录下的瓦片，提高响应效率；若没有开启该项，将不会缓存动态生成的瓦片。

  配置影像集合的瓦片方案，设置相关参数如下：

  • 瓦片访问层级范围：限制前端可请求的瓦片层级范围，若请求超出此范围，将访问不到瓦片。
  • 瓦片格式：瓦片的图片类型。
  • 瓦片大小：256*256像素尺寸。
  • DPI：96 dpi。
  • 瓦片是否背景透明：开启，表示瓦片背景透明。

  配置静默切片执行，设置相关参数如下：

  • 执行方式：静默切片有两种执行方式。立即执行，保存配置后立刻在后台执行切片操作；计划任务，保存配置后切片操作在每天指定的时间段内执行。
  • 切片层级范围：程序将对指定范围的层级生成瓦片。静默切片采用一种影像地图高效生成瓦片方案，优先生成“切片层级范围”中最大层级的瓦片，在基于此瓦片结果生成其他层级瓦片。
  • 切片进程数：后台执行切片任务的进程数，建议根据机器配置和机器空闲资源合理设置。

  d. 影像优化：优化影像服务管理，提升服务性能和质量。支持创建影像金字塔、计算统计数据、创建影像概视图。详细介绍请参考SuperMap iServer在线帮助（请参见[开始->使用iServer->使用影像服务->优化影像数据]）。

• 后台任务：后台任务列表显示了影像服务的任务ID、集合ID、创建时间、结束时间、任务类型、进度和操作。在任务类型和进度处可点击对后台任务进行筛选，任务类型包括：静默切片、计算统计数据、创建影像金字塔、创建影像集合等；进度包括：成功、执行中、异常。在操作处，点击详细信息可查看影像任务日志。

• 服务配置：更改服务实例配置。

  • 是否允许编辑：若允许编辑，则访问者可更改服务配置。
  • 是否允许下载：若允许下载，则访问者可下载影像集合中的影像文件。
  • 存储影像集合的数据源：可指定影像集合存储在UDBX文件型数据源和PostGIS、PostgreSQL数据库型数据源。
  • 数据源文件路径：指定数据源文件的位置。
  • 瓦片存储类型：指定瓦片的存储类型，包括：原始、紧凑以及MongoDB。
  • 瓦片存储路径：指定缓存瓦片的存储位置。

• 所在节点：查看承载影像服务实例运行的服务节点。
• 服务授权：设置影像服务实例的访问权限。