入门

可视化安装iManager

用于在Kubernetes环境下，通过SuperMap iManager部署中心提供的安装向导快速部署iManager。

安装产品

注意：

如果您之前已通过部署中心安装过SuperMap iManager，并需要一个新的iManager环境，请先在部署中心->部署界面一键卸载再重新安装。

再次安装时将保留您上次的配置选项，以便您快速完成相应配置。

如果您使用的环境已经部署过许可中心，则账户密码必须和上一次保持一致，请谨慎设置！如果业务需要二次修改许可中心账户密码，则请先卸载已部署的iManager，清空kubernetes节点上的 /opt/bslicense/data 目录，重新部署iManager，在部署过程中完成许可中心账户密码的设置，并在部署完成后前往许可中心重新导入许可文件。

启动SuperMap iManager部署中心并访问，进入部署界面，点击开始部署。
选择产品，选择SuperMap iManager for Kubernetes，单击下一步按钮。
配置环境依赖项，基本配置项中包括Kubernetes配置、存储配置、镜像配置，您可以根据实际情况按需填写或修改默认值。高级选项中您可以进行Kubernetes节点亲和性和容忍度的配置，便于控制Pod如何在集群中进行调度，以满足您的资源需求和运行约束。配置完成后，单击下一步按钮。

3.1 基本配置

Kubernetes配置：您可以分别配置K8s Master节点的URL地址和启用/不开启服务网格。

Kubernetes Server地址默认填入https://kubernetes.default.svc，通常保持默认即可；如果由阿里云等公有云提供K8s环境，需填写实际K8s主节点的URL，您可使用命令“kubectl cluster-info”查看K8s集群信息获取，例如，https://192.168.17.110:6443。
存储配置：提供NFS Server和StorageClass两种方式来存储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，也可以自定义。

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

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

3.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）。此外，您可以新增标签。

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

4.1 基本配置

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

4.2 高级选项

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

您可以按需选择是否开启告警服务、命令行和查看容器日志服务、系统监控服务（Prometheus)、日志收割服务。其中，系统监控服务和日志收割服务提供多个子功能服务，您可以按需选用及配置外部服务。

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

创建管理员账户，填写管理员用户名及密码后，单击下一步按钮。
确认部署，在系统正式部署前，您可以返回前面步骤再次进行确认或修改信息，确认后单击一键部署按钮。

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

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

查看部署信息

在SuperMap iManager安装完成后，在部署中心->部署界面您可以查看产品名称、产品简介、产品版本、部署时间、访问地址，点击“访问地址”处即可跳转到iManager登录界面，还可以一键卸载当前已部署的iManager。

进入部署中心->关于界面，您也可以了解已完成部署的iManager的版本等信息。

注：

如果您忘记了管理员密码，可以重置密码。

如果配置的访问入口由于内外网环境等原因，无法访问，您可以重置访问入口，重置后的访问入口将采用“IP+端口”的形式，后续可以在iManager入口配置中进行修改。

SuperMap iManager部署完成后，建议您停用部署中心，需卸载或重置密码时可再次启用。停用/启用方法见部署中心->停用/启用部署中心。

配置许可

安装完成SuperMap iManager之后，还需要导入许可才能使用。这里以导入试用许可为例。

首先前往SuperMap官网申请试用许可或购买正式许可。

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

导入成功之后，在许可状态您就可以看到许可信息。

此时您就可以正常使用iManager。