{"componentChunkName":"component---src-templates-guides-js","path":"/zh/guides/InstalliManager/","result":{"data":{"markdownRemark":{"html":"

安装iManager

\n

用于在 kubernetes 环境下快速部署 iManager。指南中提供两种iManager的部署方式，常规Linux命令与Helm命令，部署时任选一种。

\n

本文档所需文件均可在以下百度网盘中下载：

\n\n

前提条件

\n
    \n
  1. \n

    已有 kubernetes 环境，版本1.9及以上，且Kubernetes node节点机器与master节点机器设置的时间一致（误差30秒以内）

    \n
    \n

    如果没有kubernetes环境，请参考《kubernetes离线安装指南-CentOS篇》或《kubernetes离线安装指南-Ubuntu18.04篇》进行安装。

    \n
    \n
    2. \n
  2. \n

    部署iManager for Kubernetes需要的资源：

    \n\n
    3. \n
  3. \n

    已经下载了 supermap-imanager-for-kubernetes-10.1.4-linux-x64.tar.gz 文件

    \n\n
    4. \n
  4. \n

    NFS Server离线安装包准备（根据使用的操作系统下载对应版本的NFS Server离线安装包, 如果使用已有的 NFS Server 则忽略该步）

    \n\n
    5. \n
  5. \n

    镜像包准备（如果可以访问阿里云仓库，则忽略该步）

    \n\n
    6. \n
  6. 选择Helm部署时，需有Helm环境(可以执行helm命令)
    7. \n
\n

NFS Server安装

\n
\n

此处以CentOS系统为例，Ubuntu系统安装方法类似。如果已有 NFS 服务器，可以跳过此步

\n
\n\n

镜像仓库安装

\n
\n

镜像仓库安装之前，运行sudo docker version，确保Docker已成功安装，如果可以访问阿里云仓库，可以跳过此步

\n
\n
    \n
  1. \n

    将镜像包放置在机器（可以是安装了Docker的任意机器）的任意目录，如：/home/，使用以下命令解压（若实际包名与示例中的包名不一致，在执行命令时请替换为实际包名）：

    \n
    tar -zxf supermap-imanager-for-kubernetes-registry-all-10.1.4-linux-x64.tar.gz
    \n
    2. \n
  2. \n

    进入解压后目录

    \n
    cd supermap-imanager-docker-images
    \n
    3. \n
  3. \n

    在当前目录执行以下命令，进行安装镜像库

    \n
    sudo chmod +x startup.sh  && sudo ./startup.sh
    \n
    4. \n
  4. \n

    验证镜像仓库安装是否成功

    \n
    sudo docker pull <ip>:5000/supermap/tiny-tools:3.12
    \n
    \n

    其中<ip>为所在主机IP ，如果结果无error，则启动成功。\n如果是在ARM环境下部署，请将镜像tag“3.12”更改为“1.0-arm”。

    \n
    \n
    5. \n
\n

iManager安装与使用

\n
\n

计算机需要开放values.yaml文件中的“deployimanagerport”（默认值31100）对应的端口，以及6443、9100、2049（使用NFS存储时开放）端口。如果您是使用阿里云ECS服务器，您需要将以上端口添加到安全组规则中。除此以外，还需要确保 3307 和 9183 端口不被占用。

\n
\n

以下所有命令均以管理员权限执行

\n
    \n
  1. \n

    将iManager安装包supermap-imanager-for-kubernetes-10.1.4-linux-x64.tar.gz放置在Kubernetes master节点所在主机的任意目录，使用以下命令解压（若实际包名与示例中的包名不一致，在执行命令时请替换为实际包名）：

    \n
    tar -zxf supermap-imanager-for-kubernetes-10.1.4-linux-x64.tar.gz
    \n
    2. \n
  2. \n

    进入解压后得到的 supermap-imanager-for-kubernetes 文件夹，执行：

    \n
    sudo  vi values.yaml
    \n

    根据实际情况修改 values.yaml 文件:

    \n
    \n

    注意：

    \n
      \n
    1. 符号”:“后面需留一个空格。
      2. \n
    2. values.yaml文件只能在启动iManager前设置，如需再次修改，请修改完后重新执行安装脚本./startup.sh。文件带有默认值，修改时直接修改值即可，不需要移除任何配置。Helm命令更新配置，在supermap-imanager-for-kubernetes文件夹中执行“helm upgrade imanager ../supermap-imanager-for-kubernetes -n supermap”。
      3. \n
    3. “必填”项需要根据实际情况填写或修改；“选填”项可以不修改，若“选填”项中有默认值，请保持默认值，不能删除。
      4. \n
    \n
    \n
     # 必填，iManager镜像仓库的地址，用于拉取部署iManager所需镜像。默认为阿里云仓库（外网使用时推荐该地址）：registry.cn-beijing.aliyuncs.com；\n # 内网仓库配置为<ip>:5000，<ip>为镜像仓库所在机器的IP（镜像仓库安装方法参照前文）。\n deploy_registry: registry.cn-beijing.aliyuncs.com\n\n # 必填，外部访问Kubernetes时用的IP，可以是任意一台Kubernetes节点机器外部可访问的IP,例如，192.168.17.110。\n deploy_kubernetes_public_ip:\n\n # 必填，iManager管理员账户名，用于登录iManager，默认为admin，请自行更改。\n deploy_imanager_user_name: admin\n\n # 必填,iManager管理员密码，用于登录iManager，默认为admin，请自行更改。\n deploy_imanager_password: admin\n\n # 必填(deploy_storage_class_name的值非空时选填)，您的NFS Server地址，NFS Server用于存储iManager数据，可以是IP或者域名，例如: 192.168.17.150。NFS Server 安装方法请参照前文。\n # 使用NFS Server存储时，需在Kubernetes的Node节点机器中安装NFS Client。\n deploy_nfs_server:\n\n # 必填，NFS Server提供挂载的路径，默认根路径（/）。实际请根据自己安装的NFS情况来填写，如果使用SuperMap提供的NFS离线安装包安装NFS，则此处地址填写为：/opt/nfs_data。\n deploy_nfs_path: /\n\n # 选填，Kubernetes主节点URL，默认使用https://kubernetes.default.svc，通常保持默认即可；\n # 如果是阿里云等公有云环境，此变量必填，可通过kubectl cluster-info命令获取， 例如，https://192.168.17.110:6443。\n deploy_kubernetes_master_url: https://kubernetes.default.svc\n\n # 选填，iManager创建的GIS云套件配置域名时必填，GIS云套件域名映射的Kubernetes节点IP（即域名在DNS服务器上配置指向的IP）。默认使用第一个Kubernetes节点IP。\n deploy_domain_ip:\n\n # 选填, 您的StorageClass名称，用于存储iManager数据。StorageClass与NFS Server均用于iManager数据存储，如果和NFS Server(deploy_nfs_server)同时存在，优先使用NFS Server作为iManager数据存储。\n deploy_storage_class_name:\n\n # 选填，iManager服务部署到kubernetes的命名空间，可保持默认值supermap，或根据实际需求自定义；\n # 使用Helm命令部署时需单独创建命名空间。\n deploy_namespace: supermap\n\n # 选填，镜像拉取策略，取值范围：[Always|Never|IfNotPresent]。默认为IfNotPresent；\n # Always：总是从镜像仓库拉取最新镜像；\n # Never：使用本地镜像，不从镜像仓库拉取镜像；\n # IfNotPresent：如果本地有可用镜像，使用本地镜像，否则从镜像仓库拉取。\n deploy_image_pull_policy: IfNotPresent\n\n # 选填，镜像拉取Secret，用于拉取私有镜像时进行身份认证。例如：image-pull-secret。配置Secret前，需在Kubernetes命名空间下创建与Secret同名的资源，详情请参见教程->附录->常见问题解答->问题6。\n deploy_image_pull_secret:\n\n # 选填，镜像仓库中存储镜像的命名空间名称，默认为supermap，支持用户自定义。\n deploy_image_namespace: supermap\n\n # 选填，iManager服务类型，取值范围：[NodePort|LoadBalancer]，通常保持默认即可；\n # 如果是阿里云等公有云环境这里填LoadBalancer。\n deploy_service_type: NodePort\n\n # 选填，iManager服务协议，取值范围：[https|http]，默认http。\n deploy_imanager_service_protocol: http\n\n # 选填，是否禁用iManager日志功能，取值范围：[true|false]。默认为false；\n # true：禁用日志功能；\n # false：开启日志功能。\n deploy_disable_log: false\n\n # 选填，是否禁用iManager告警功能，取值范围：[true|false]。默认为false；\n # true：禁用告警功能；\n # false：开启告警功能。\n deploy_disable_alert: false\n\n # 选填，iManager中单个服务的CPU分配，默认为2核。\n deploy_cpu_limit: 2\n\n # 选填，iManager中单个服务的Memory分配，不能小于4Gi，默认为4Gi。\n deploy_memory_limit: 4Gi\n\n # 选填，指定iManagaer创建的iServer镜像tag。\n deploy_iserver_tag: 10.1.4\n\n # 选填，指定iManager创建的iPortal镜像tag。\n deploy_iportal_tag: 10.1.4\n\n # 选填，指定iManager创建的iDesktop镜像tag。\n deploy_idesktop_tag: 10.1.2\n\n # 选填，指定iManager中iserver_gisapplication的镜像tag。\n deploy_gis_app_tag: 10.1.4\n\n # 选填，指定iManager中使用GIS镜像的tag。\n deploy_image_tag: 10.1.4\n\n # 选填，iManager端口，自定义范围：30000-32767，不包括31234，默认31100。如果自定义端口，注意不要与其他变量的端口相同。\n deploy_imanager_port: 31100\n\n # 选填，许可中心是否禁用本地存储，取值范围：[true|false]。默认为false。为true时，必须配置deploy_nfs_server或default_storage_class_name；\n # true：许可中心不使用本地存储；\n # false：许可中心使用本地存储。\n deploy_disable_bslicense_local_volume: false\n\n # 选填，用于HBase性能优化，取值范围：[true|false]，默认false【如您没有使用HBase的需求，可以不做修改；如您需要优化内置HBase性能，请将该值设为true，详见教程->附录->常见问题解答->问题9】。\n deploy_disable_hbase_nfs_volume: false\n\n # 选填，企业微信接收消息token，使用微信告警功能时必填。企业微信告警配置请参见SuperMap iManager在线帮助文档。\n deploy_weixin_token:\n\n # 选填，企业微信的企业ID，使用微信告警功能时必填。\n deploy_weixin_corp_id:\n\n # 选填，企业微信接收消息EncodingAESKey，使用微信告警功能时必填。\n deploy_weixin_encoding_aes_key:\n\n # 选填，企业微信接收消息的部门id，使用微信告警功能时必填。\n deploy_weixin_to_party:\n\n # 选填，企业微信接收消息的应用id，使用微信告警功能时必填。\n deploy_weixin_agent_id:\n\n # 选填，企业微信接收消息的应用secret，使用微信告警功能时必填。\n deploy_weixin_api_secret:\n\n # 选填，钉钉接收消息的webhook，使用钉钉告警功能时必填。钉钉告警配置请参见SuperMap iManager在线帮助文档。\n deploy_dingtalk_webhook:\n\n # 选填，钉钉接收消息的secret，使用钉钉告警功能时必填。\n deploy_dingtalk_secret:\n\n # 选填，设置系统时区。填写系统时区目录（/usr/share/zoneinfo/）下时区文件的相对路径，如Asia/Shanghai、America/New_York，默认为Asia/Shanghai。\n deploy_timezone: Asia/Shanghai\n\n # 选填，是否禁用metrics_server服务，metrics_server用于Kubernetes资源监控，取值范围：[true|false]。默认false；\n # true：禁用metrics_server服务；\n # false：开启metrics_server服务。\n deploy_disable_metrics_server: false\n\n # 选填，是否开启服务网格(Istio)功能，取值范围：[true|false]。默认true。ARM环境下不支持Istio功能，没有该参数；\n # true：开启服务网格功能；\n # false：禁用服务网格功能。\n deploy_istio_enabled: true\n\n # 选填，是否开启服务网格(Istio)中的ingressgateway（入口网关）和egressgateway（出口网关），取值范围：[true|false]。默认true。该变量只有当deploy_istio_enabled为true时生效；\n # true：开启ingressgateway和egressgateway；\n # false：禁用ingressgateway和egressgateway。\n deploy_istio_enable_ingress_egress: true\n\n # 选填，是否开启服务网格(Istio)中的Kiali和Tracing服务，这两个服务用于服务追踪，取值范围：[true|false]。默认true。该变量只有当deploy_istio_enabled为true时生效；\n # true：开启Kiali和Tracing服务；\n # false：禁用Kiali和Tracing服务。\n deploy_istio_enable_kiali_tracing: true\n\n # 选填，服务网格(Istio)中ingressgateway的服务类型，取值范围：[NodePort|LoadBalancer]，通常保持默认即可。该变量只有当deploy_istio_enabled和deploy_istio_enable_ingress_egress同时为true时生效；\n # 如果是阿里云等公有云环境，这里填LoadBalancer。\n deploy_istio_ingress_service_nodetype: NodePort
    \n

    修改完成后保存并退出：敲击键盘Esc键，命令行输入“:wq”后敲击回车键。

    \n
    3. \n
  3. \n

    安装 iManager（以下命令均在supermap-imanager-for-kubernetes文件夹中执行）

    \n

    安装iManager时，可选择常规Linux命令安装，或Helm命令安装，任选其一。

    \n

    常规Linux命令安装

    \n
    sudo chmod +x startup.sh && ./startup.sh
    \n

    Helm命令安装

    \n

    3.1 创建命令空间supermap(可以自定义,需同步修改下文中的命名空间)

    \n
    kubectl create ns supermap
    \n

    3.2 安装iManager

    \n
    helm install imanager ../supermap-imanager-for-kubernetes -n supermap
    \n

    3.3 查看iManager是否安装成功

    \n
    helm list -n supermap
    \n

    \n \n \n \n \n \n \n \n \n \n

    \n
    \n

    执行完命令后的进度条仅供参考，实际服务启动情况请参见kubernetes 的 dashboard 界面
    \n安装完成后，可以通过 http://<ip>:31100 访问 iManager 页面 ,如果deploy_imanager_service_protocol的值为https,就通过: https://<ip>:31100 访问 iManager 页面 . <ip>: 为 kubernetes Master 节点的 ip.

    \n
    \n

    登录账号参见 values.yaml 文件中配置的iManager管理员账户信息

    \n
    4. \n
  4. \n

    配置许可

    \n

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

    \n

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

    \n

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

    \n

    \n \n \n \n \n \n \n \n \n \n

    \n

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

    \n

    \n \n \n \n \n \n \n \n \n \n

    \n

    安装完成之后就可以正常使用 iManager

    \n
    5. \n
\n

附录

\n

1.删除iManager环境

\n

运行 shutdown.sh 文件可以删除 iManager 环境：

\n
chmod +x shutdown.sh && ./shutdown.sh
\n

如需彻底删除iManager，即删除iManager创建的相关环境等，请增加-v参数：

\n
chmod +x shutdown.sh && ./shutdown.sh -v
\n

使用Helm命令安装的iManager，删除命令（使用该命令，命名空间与用户创建的环境不会被删除）：

\n
helm uninstall imanager -n supermap
\n

2.短信告警服务

\n

iManager提供短信告警服务，详情请参见教程->报警服务->短信告警进行配置。

","frontmatter":{"title":"入门","next":null,"prev":null},"fields":{"path":"content/guides/InstalliManager.zh.md","slug":"/zh/guides/InstalliManager/","langKey":"zh"}}},"pageContext":{"slug":"/zh/guides/InstalliManager/"}}}