安装iManager

安装入口

通过 SuperMap iManager 产品包安装的部署中心访问,提供了可视化安装向导,来快速安装iManager或GIS云套件两种产品供您选择。

成功安装或启用 SuperMap iManager 部署中心后访问http://<ip>:31111,进入部署中心界面。

其中<ip>为 Kubernetes Master 节点的 ip;

31111为部署中心默认端口,如果修改了values.yaml中deploy_imanager_deployment_center_port的值,此处需替换为实际端口。

deploymentcenter

安装产品

注意事项:

  1. 如果您使用的环境已经部署过许可中心,则账户密码必须和上一次保持一致,请谨慎设置!如果业务需要二次修改许可中心账户密码,则请先卸载已部署的iManager,清空Kubernetes节点上的 /opt/bslicense/data 目录,重新部署iManager,在部署过程中完成许可中心账户密码的设置,并在部署完成后前往许可中心重新导入许可文件。
  2. 如果您想要重新安装SuperMap iManager,需要先将旧的环境卸载。
  1. 部署中心页面单击开始部署按钮,选择产品。选择SuperMap iManager for Kubernetes,单击下一步按钮。

selectproduct

  1. 配置环境依赖项。基本配置项中包括Kubernetes配置存储配置镜像配置,您可以根据实际情况按需填写或修改默认值。高级选项中您可以进行Kubernetes节点亲和性容忍度的配置,便于控制Pod如何在集群中进行调度,以满足您的资源需求和运行约束。配置完成后,单击下一步按钮。以下详细介绍配置参数:

2.1 基本配置

  • Kubernetes配置:您可以分别配置K8s Master节点的URL地址启用/不开启服务网格。如果Kubernetes环境为1.26及以上版本,暂不支持服务网格相关功能。

    Kubernetes Server地址默认填入https://kubernetes.default.svc,通常保持默认即可;如果由阿里云等公有云提供K8s环境,需填写实际K8s主节点的URL,您可使用命令“kubectl cluster-info”查看K8s集群信息获取,例如,https://192.168.17.110:6443

  • 存储配置:提供NFS ServerStorageClass两种方式来存储iManager数据。

    • NFS Server:您需要在K8s的Node节点机器中安装NFS Client。NFS Server地址需填写您的NFS Server地址,支持填写IP或域名。NFS Server提供挂载的路径默认是根路径(/),请根据您安装的NFS情况来填写,如果使用SuperMap提供的NFS离线安装包安装NFS,则此处地址填写为:/opt/nfs_data。
    • StorageClass:支持填写Ceph存储或Longhorn存储对应的StorageClass名称。
  • 镜像配置:您可以填写iManager镜像仓库相关的配置,来拉取部署iManager所需镜像。

    镜像仓库地址默认为阿里云仓库registry.cn-beijing.aliyuncs.com,使用外网时推荐该地址;如果您使用内网,仓库配置为<ip>:5000<ip>是镜像仓库所在机器的IP。

    镜像仓库命名空间默认为supermap,也可以自定义。

    镜像拉取策略提供IfNotPresentAlwaysNever 3种方式,分别表示“如果本地有可用镜像,使用本地镜像,否则从镜像仓库拉取”、“总是从镜像仓库拉取最新镜像”、“不从镜像仓库拉取镜像”,默认选择IfNotPresent。

    镜像拉取的密钥名称用于拉取私有镜像时的身份认证,可填写image-pull-secret,如果您配置的是私有仓库,请参见常见问题解答(教程->附录->常见问题解答->问题7)。

2.2 高级选项

  • 节点亲和性配置:您可以在节点调度模式为强制性调度和偏好性调度下分别配置。

    强制性调度确保Pod必须在满足节点亲和性规则的节点上调度。标签设置中,您可以设置标签键(key)、操作符(operator)和标签值(values)。操作符可选择“In”(匹配标签键的值必须是提供的列表中的一个)、“NotIn”(匹配标签键的值不能是提供的列表中的任何一个)、“Exists”(匹配标签键必须存在,无论其值是什么)、“DoesNotExist”(匹配标签键必须不存在)、“Gt”(匹配标签键的值必须大于提供的值)或“Lt”(匹配标签键的值必须小于提供的值)。此外,您可以新增标签。

    偏好性调度允许Pod在尽可能地满足节点亲和性规则的情况下进行调度,但不是必须的。您可以设置标签键(key)、操作符(operator)、标签值(values)和权重(weight),支持配置多个标签值并用“;”分隔。此外,您可以新增标签,也可添加多组偏好性设置。

  • 节点容忍度配置:通过设置节点的容忍度,使Pod可以在具有特定污点的节点上调度。

    您可以设置标签键(key)、操作符(operator)、标签值(values)和策略(effect)。操作符可选择“Equal”(相等)或“Exists”(存在),策略中可选择“NoSchedule”(不可调度)、“PreferNoSchedule”(偏好不调度)或“NoExecute”(移除不符规则的Pod)。此外,您可以新增标签。

configureenvoption

  1. 配置产品。基本配置项中包括Ingress配置访问入口配置数据库配置,您可以根据实际情况按需填写或修改默认值。高级选项中您可以自行选择启用/不开启多种服务能力,包括:告警服务、多项监控服务日志收割服务等,并支持您配置外部的许可中心和用户中心等服务。配置完成后,单击下一步按钮。

3.1 基本配置

  • Ingress配置:启用Ingress控制器后您可以进行域名设置,将提供ClusterIPLoadBalancer两种服务类型,默认选择ClusterIP,如果由阿里云等公有云提供K8s环境则选择LoadBalancer。域名映射的Kubernetes节点IP,如果您选择ClusterIP类型或需要配置访问入口域名时时必填,选择LoadBalancer类型时选填,默认使用第一个K8s节点IP。
  • 访问入口配置:启用Ingress控制器后您才可使用入口域名,支持自行按需修改外部访问iManager服务的IP,建议填写K8s Master节点IP(或代理IP)/云厂商弹性公网IP,您还可以指定HTTPHTTPS访问协议并配置其外部端口等,具体请参见基础服务管理(教程->基础服务->服务管理->“配置”处)。
  • 数据库配置:您可以启用配置外部数据库,如果不开启则默认使用系统提供的PostgreSQL数据库。

3.2 高级选项

系统时区处填写系统时区目录(/usr/share/zoneinfo/)下时区文件的相对路径,您可以按需修改,例如:America/New_York,通常默认保持Asia/Shanghai。

您可以按需选择是否开启告警服务命令行和查看容器日志服务系统监控服务(Prometheus)日志收割服务。其中,系统监控服务和日志收割服务提供多个子功能服务。开启系统监控服务时支持设置节点监控服务端口,端口默认为9101,设置时请确保不与iManager固定端口和默认端口冲突。此外,您可以按需选用及配置外部服务。

如果iManager许可中心、网关的Redis、用户中心Keycloak及其数据库需要配置为外部的服务,您可以分别按需开启配置外部许可中心服务配置外部Redis服务配置外部用户中心(Keycloak服务)以及配置外部Keycloak数据库。配置时,请填写外部服务准确的主机名、端口、账号密码等信息。

configureimanageroption

  1. 创建管理员账户。填写管理员管理员账户密码确认密码后,单击下一步按钮。

createadminaccount

  1. 确认部署。在系统正式部署前,您可以返回前面步骤再次进行确认或修改信息,确认后单击一键部署按钮。

confirmdeploy

在系统部署过程中,您可以通过进度条掌握实时部署状态。最终部署结果中可能会有部分服务启动失败和部署失败:

  • 部署成功但部分服务启动失败:“部署”界面将提醒您及时关注,可以进入iManager界面中的“基础服务”列表下找到对应的服务并尝试重新部署。
  • 部署失败:您可以选择卸载重装或到前面配置步骤返回修改,重新配置后再尝试部署。

配置许可

安装好 iManager 之后,还需要导入许可才能使用。这里以导入试用许可为例。

  1. 首先去 SuperMap 官网申请试用许可或购买正式许可

  2. 访问 iManager 页面,在没有许可的情况下会自动跳转到许可中心(Web版)页面,点击激活更新,参照操作流程导入许可

activatelic

  1. 导入成功之后,在许可状态可以看见许可信息

licensestatus1

许可配置完成之后,在部署中心界面点击访问地址处的链接,就可以正常使用 iManager。

deployimanagerinfo

卸载产品

SuperMap iManager部署中心提供了两种卸载产品的模式,您可以根据实际需求来进行卸载产品。

  • 无痕卸载

    选择无痕模式,将停止iManager服务并删除所有已创建的站点和数据。

  • 卸载但保留数据

    选择保留数据模式,将停止iManager服务但保留站点中的数据和配置项,之后可按需一键恢复部署,并修改各配置项(“存储配置”和“管理员账户”除外)。

卸载过程中您可以通过卸载进度条掌握实时的卸载状态,同时了解当前正在执行的卸载步骤。

uninstallprogress

卸载完成后部署界面将回到“待安装”状态,此时您可以重新进行安装,部署一个崭新的iManager环境。