产品安装

下载与安装

本节以 CentOS 系统为例介绍 SuperMap ImageX Server 的安装过程，Ubuntu 系统安装方法类似，安装流程需要以具有执行权限的用户进行。

说明：

本页中的 <ip>，表示 Kubernetes Master 节点对外可访问的实际 IPv4 地址，通常形如 192.168.x.x、10.x.x.x 或 172.16-31.x.x。

可在 Master 节点执行 ip addr 或 hostname -I 查询；如果已在 values.yaml 中配置 kubernetes_public_ip，则访问时优先使用该地址。不可填写 localhost、127.0.0.1 或 0.0.0.0。

获取安装包

您可以从 SuperMap 技术资源中心获取安装 SuperMap ImageX Server for Kubernetes 安装包，将下载的 ZIP 文件解压，可得到 supermap-imagex-enterprise-for-kubernetes-*-linux-x64.tar.gz文件

执行如下命令进行解压：

tar -zxf supermap-imagex-enterprise-for-kubernetes-*-linux-x64.tar.gz

编辑values.yaml

SuperMap ImageX Server for Kubernetes 基于 values.yaml 文件中的配置进行安装部署，因此请先根据需要修改 values.yaml。

进入 supermap-imagex-enterprise-for-kubernetes-*-linux-x64 文件夹，然后执行如下命令开始编辑 values.yaml 文件：

vi values.yaml

注意：

编辑文件时可参考以下规范：

填写各参数时，参数后的":"与值之间需键入一个空格。
values.yaml 文件只能在启动 SuperMap ImageX Server for Kubernetes 前设置。如果在启动后需要修改文件内容，请在修改完后再次执行安装脚本./startup.sh。

values.yaml 详细参数说明

# 必填，ImageX Server镜像仓库的地址，用于拉取部署ImageX Server所需镜像。默认为阿里云仓库（外网使用时推荐该地址）：registry.cn-beijing.aliyuncs.com。
# 内网仓库配置为您导入imagex-enterprise镜像时的所填仓库地址，如<ip>:5000，<ip>为镜像仓库所在机器的IP。
registry: registry.cn-beijing.aliyuncs.com

# 必填，用于外部访问Kubernetes服务的IP，可以是任意一台Kubernetes节点机器外部可访问的 IP，例如，192.168.17.110。
kubernetes_public_ip:

# 选填，ImageX Server系统管理员账户名，用于登录ImageX Server，拥有整个服务器的超级管理权限，默认为 supermap，建议执行安装脚本前进行更改。
username: supermap

# 必填，多机部署时，如果不配置storage_class_name，此处必填，您的NFS Server 地址，用于存储ImageX Server数据，可以是IP或者域名，例如: 192.168.17.150。
# 使用NFS Server存储时，需在Kubernetes的Node节点机器中安装NFS Client。
nfs_server: 192.168.17.150

# 必填，NFS Server提供挂载的路径，默认根路径：/。请根据自己安装的NFS Server实际情况来填写路径，如果使用SuperMap提供的NFS离线安装包安装NFS Server，则此处地址填写为：/opt/nfs_data；如果不配置NFS Server，默认使用hostPath数据卷，位于本地/opt/giscloudsuite目录。
nfs_path: /opt/nfs_data

# 选填，ImageX Server服务协议，取值范围：[https|http]，默认http。
protocols: http

# 选填，ImageX Server开启HTTP协议的UI访问入口端口，自定义范围：30000-32767，不包括 31234，默认32222。如果自定义端口，注意不要与其他配置项的端口相同。
http_port: 32222

# 选填，ImageX Server开启HTTPS协议的UI访问入口端口，自定义范围：30000-32767，不包括 31234，默认32223。如果自定义端口，注意不要与其他配置项的端口相同。
https_port: 32223

# 选填，ImageX Server配置域名时必填，ImageX Server域名映射的Kubernetes节点IP（即域名在DNS服务器上配置指向的IP）。默认使用第一个Kubernetes节点IP。
domain_ip:

# 选填，配置ImageX Server访问入口的域名，例如，imagex.iservergateway.com。不配置使用IP加端口访问。
gateway_domain:

# 选填，ImageX Server访问入口域名对应的证书路径，只有配置了ImageX Server域名（gateway_domain），该配置项才会生效。证书应当与values.yaml存放于同一目录下，填写时使用相对路径，比如：gateway/tls.crt。
gateway_certificate_path:

# 选填，ImageX Server访问入口域名对应证书的私钥路径，只有配置了ImageX Server域名（gateway_domain），该配置项才会生效。私钥应当与values.yaml存放于同一目录下，填写时使用相对路径，比如:gateway/tls.key。
gateway_private_key_path:

# 禁用ImageX Server内置用户中心时必填，自定义范围：30000-32767，不包括31234。自定义端口时注意不要与其他配置项的端口相同。
cloudsuite_keycloak_port:

备注：

系统默认使用的密码是 Supermap@1997 ，请及时修改。
长期使用同一密码是密码被破解的主要原因。在安全性要求极高的环境中，默认的管理员密码，应自行修改并定期更新。
如果密码过于简单，则可能被恶意用户解密和暴力破译，窃取重要信息及盗用资源，存在安全风险。更新密码时请尽量设置得复杂。
values-internal.yaml 中为一些内部配置项，请在支持人员的指导下修改。

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

安装产品

SuperMap ImageX Server for Kubernetes 提供 Linux 和 Helm 两种命令安装方式，任选一种即可。

使用 Linux 命令安装

常规 Linux 命令安装。（如果出现 Kubernetes cluster unreachable，请参考常见问题解答)

chmod +x startup.sh && ./startup.sh

使用 Helm 命令安装

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

创建命令空间 giscloudsuite (可以自定义,需同步修改下文中的命名空间)
```
kubectl create ns giscloudsuite
```

依次执行以下命令安装 SuperMap ImageX Server

chmod +x ./helm 
./helm install giscloudsuite . -n giscloudsuite

查看 ImageX Server 是否安装成功
```
./helm list -n giscloudsuite
```

执行完命令后的进度条仅供参考，实际服务启动情况请参见 kubernetes 的 dashboard 界面。

使用产品

安装完成后，可以通过 http://<ip>:32222 访问 ImageX Server 页面，通过 http://<ip>:32222/manager/license/center/ 访问许可中心（Web版）页面。

其中，<ip> 为 Kubernetes Master 节点对外可访问的实际 IPv4 地址，通常形如 192.168.x.x。

如果 protocols 的值为 https ，则通过https://<ip>:32222 和 https://<ip>:32222/manager/license/center/ 访问。

登录账号参见 values.yaml 文件中配置的 ImageX Server 系统管理员账户信息，默认密码为 Supermap@1997，如有修改据实填写。

安装验证

执行安装命令后，相关服务启动过程中无持续报错；如使用 Helm 安装，可通过 ./helm list -n giscloudsuite 查看发布状态。
可正常访问 ImageX Server 页面和许可中心页面。
使用 values.yaml 中配置的系统管理员账号可以正常登录。
如配置了 HTTPS 或自定义端口，请按实际配置的协议和端口访问，并确认访问地址与 values.yaml 中的配置一致。