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

常见问题解答

\n
    \n
  1. \n

    Oracle数据库与SuperMap iDesktop连接不上，如何解决？

    \n

    答：出现上述情况，请在Oracle中创建并使用新的数据库。具体步骤如下：

    \n

    （1）在iManager页面点击数据库->Oracle->名称（您的数据库名称）->oracle->命令行进入Oracle命令行；

    \n

    （2）在目录 u01/app/oracle/oradata 下创建“supermapshapefile”文件夹，执行（如果您已有文件夹，请跳过该步骤）：

    \n
    mkdir -p /u01/app/oracle/oradata/supermapshapefile
    \n

    （3）将“supermapshapefile”文件夹的拥有者改为oracle，执行：

    \n
    chown oracle /u01/app/oracle/oradata/supermapshapefile
    \n

    （4）进入Oracle，执行：

    \n
    sqlplus / as sysdba
    \n

    （5）输入Oracle用户密码，用户密码请在iManager页面点击数据库->Oracle->名称（您的数据库名称）->账户查看；

    \n

    （6）创建空间表，大小为200M（可根据实际情况设置），执行：

    \n
    create tablespace supermaptbs datafile '/u01/app/oracle/oradata/supermapshapefile/data.dbf' size 200M;
    \n

    （7）创建空间表新用户，账号：supermapuser（可自由设置），密码：supermap123（可自由设置），执行：

    \n
    create user supermapuser identified by supermap123 default tablespace supermaptbs;
    \n

    （8）给新用户赋予权限，执行：

    \n
    grant connect,resource to supermapuser;\ngrant dba to supermapuser;
    \n
    2. \n
  2. \n

    使用内置Spark集群进行分布式分析时，Spark-worker节点出现时而离线时而假死现象，怎么办？

    \n

    答：在分布式分析过程中，由于资源占用较大，导致响应变慢，Spark-master节点接收不到Spark-worker节点的心跳汇报，误以为Spark-worker节点出现故障，出现上述现象。请参照以下步骤延长心跳汇报时间：

    \n

    （1）点击左侧导航栏计算资源池->Spark集群->控制台->spark-master->命令行进入Spark-master容器操作界面；

    \n

    （2）进入spark-env.sh文件所在目录：

    \n
    cd spark/conf
    \n

    （3）打开spark-env.sh文件：

    \n
    vi spark-env.sh
    \n

    （4）在文件内新增心跳汇报间隔时间（默认180秒，可根据需求设置，例子中为1800秒）

    \n
    export SPARK_MASTER_OPTS=\"-Dspark.worker.timeout=1800\"
    \n

    （5）保存并退出spark-env.sh文件；

    \n

    （6）在Spark集群控制台界面重新部署Spark-master节点与Spark-worker节点。

    \n
    3. \n
  3. \n

    发布地图服务后，地图显示字体为什么和制图所用字体不同？

    \n

    答：因为承载该地图服务的服务节点没有制图时使用的字体。请参照以下步骤添加字体：

    \n

    （1）点击主页导航栏文件管理，在文件管理器的system/fonts文件夹上传所需字体文件；

    \n

    （2）重新部署承载地图服务的服务节点。

    \n
    4. \n
  4. \n

    在重新部署/调整规格后，又立马进行重新部署/调整规格操作，导致分配许可失败，如何解决？

    \n

    答：在重新部署/调整规格后，请确保本次操作对应的容器在许可中心中分配许可成功后，再进行下一次的重新部署/调整规格操作。

    \n
    5. \n
  5. \n

    查看实时监控统计图时，图表中没有数据或数据生成的时间与实际时间不符，如何解决？

    \n

    答：查看实时监控统计图时，请确保您的本地机器与Kubernetes节点机器设置的时间一致。

    \n
    6. \n
  6. \n

    使用内置环境（如内置Spark集群、Kafka集群等）时，禁用后再次开启，环境不能使用，如何解决？

    \n

    答：内置环境禁用后再次开启，服务的端口号会发生变化，请更新相关端口配置。

    \n
    7. \n
  7. \n

    在K3S环境下安装GIS云套件，进度条长时间不变，怎么办？

    \n

    答：通过命令kubectl -n kube-system get pod查看pod状态，如果pod状态不是running或completed，可能是防火墙导致K3S集群内部不能通信。可以通过以下命令关闭防火墙：

    \n
    systemctl stop firewalld\nsystemctl disable firewalld
    \n

    关闭防火墙一段时间后，通过命令kubectl get pod --all-namespaces查看pod状态，如果pod状态仍然异常，则与防火墙无关，请排查其他原因。

    \n
    8. \n
  8. \n

    如何替换GIS云套件自带的安全证书？

    \n

    答：GIS云套件的安全证书有两种，一种是安全中心（Keycloak）使用的安全证书，另一种是访问入口域名使用的安全证书。替换时又有两种情况，一种是配置了访问入口域名或安全中心域名；一种是没有配置域名。请参照以下步骤替换两种证书：

    \n

    替换安全中心（Keycloak）的安全证书——未配置域名

    \n

    （1）在安装Kubernetes Master节点机器中执行以下命令，找到安全证书挂载目录（下面命令中的icloud-native-<id>为GIS云套件所在的命令空间，请替换为实际的命名空间名称）：

    \n
    kubectl -n icloud-native-<id> describe pvc pvc-keycloak-certificate-<id> | grep Volume: | awk -F ' ' '{print $2}' | xargs kubectl describe pv
    \n

    （2）将您的安全证书文件存放至步骤（1）查到的挂载目录中；

    \n
    \n

    注意：
    \n安全证书文件包括证书和私钥，需要将证书文件重命名为tls.crt，将私钥文件重命名为tsl.key。

    \n
    \n

    （3）登录iManager，在GIS云套件服务列表中找到Keycloak服务并重新部署。

    \n

    替换安全中心（Keycloak）的安全证书——已配置域名

    \n

    （1）将安全中心域名对应的证书文件复制到Kubernetes Master节点机器；

    \n

    （2）执行以下命令（命令中的<id>是创建GIS云套件时命名空间ID；<certificateFile>是安全中心域名对应的证书文件；<privateFile>是证书对应的私钥文件。均需用实际值替换）：

    \n
    kubectl -n icloud-native-<id> delete secret keycloak-ingress-tls\nkubectl -n icloud-native-<id> create secret tls keycloak-ingress-tls --cert='<certificateFile>' --key='<privateFile>'
    \n

    （3）访问安全中心域名即可生效。

    \n

    替换访问入口的安全证书——未配置域名

    \n

    （1）在安装Kubernetes Master节点机器中执行以下命令，找到安全证书挂载目录（下面命令中的icloud-native-<id>为GIS云套件所在的命令空间，请替换为实际的命名空间名称）：

    \n
    kubectl -n icloud-native-<id> describe pvc pvc-gateway-certificate-<id> | grep Volume: | awk -F ' ' '{print $2}' | xargs kubectl describe pv
    \n

    （2）将您的安全证书文件存放至步骤（1）查到的挂载目录中；

    \n
    \n

    注意：
    \n安全证书文件需命名为certificate.keystore。

    \n
    \n

    （3）执行以下命令，修改访问入口的证书配置：

    \n
    kubectl -n icloud-native-<id> edit deploy iserver-gateway
    \n

    在文件中找到icn_ext_param_server_ssl_keyStorePassword配置，把下方的value对应的值修改为证书密码。输入:wq退出编辑窗口，访问入口会自动重新部署。

    \n

    替换访问入口的安全证书——已配置域名

    \n

    （1）将访问入口域名对应的证书文件复制到Kubernetes Master节点机器；

    \n

    （2）执行以下命令（命令中的<id>是创建GIS云套件时命名空间ID；<certificateFile>是访问入口域名对应的证书文件；<privateFile>是证书对应的私钥文件。均需用实际值替换）：

    \n
    kubectl -n icloud-native-<id> delete secret gateway-ingress-tls\nkubectl -n icloud-native-<id> create secret tls gateway-ingress-tls --cert='<certificateFile>' --key='<privateFile>'
    \n

    （3）使用域名访问即可生效。

    \n
    9. \n
  9. \n

    使用GIS云套件包部署的GIS云套件环境，未配置NFS Server或StorageClass，重启后数据丢失怎么办？

    \n

    答：重启后出现下述类似情况，如分布式分析服务无访问地址、内置存储资源（内置PostGIS、PostgreSQL等）无数据。请禁用环境后再次开启。

    \n
    10. \n
  10. \n

    更新Gisapplication（或iPortal）镜像后，iPortal（或Gisapplication）部分功能不能正常使用，怎么办？

    \n

    答：单独更新Gisapplication（或iPortal）可能会出现配置跟代码不兼容的情况。请同时更新iPortal与Gisapplication。

    \n
    11. \n
  11. \n

    当Keycloak服务报错“io.undertow.util.ParameterLimitException: UT000047: The number of parameters exceeded the maximum of 1000”，如何解决？

    \n

    答：此错误是因为您的服务实例数量过多，导致向Keycloak提交请求的表单字段超过默认最大限制1000，需提高字段上限。请参考以下步骤解决：

    \n

    （1）登录Kubernetes管理页面；

    \n

    （2）在您的GIS云套件命名空间中点击部署，找到keycloak；

    \n

    （3）对keycloak进行编辑（打开右侧操作，点击查看/编辑 YAML）；

    \n

    （4）在spec->template->spec->containers->env中添加环境变量UNDERTOW_MAX_PARAMETERS，设置值大于报错中的限制值，例如：

    \n
    {\n   \"name\": \"UNDERTOW_MAX_PARAMETERS\",\n   \"value\": \"1500\"\n},
    \n
    12. \n
  12. \n

    配置镜像拉取Secret时，如何在命名空间下创建与Secret同名资源？

    \n

    答：配置镜像拉取Secret时，需在Kubernetes中GIS云套件所在命名空间创建与Secret同名的资源。如果开启metrics server服务，需在kube-system命名空间下创建Secret同名资源。请在Kubernetes Master机器中，输入如下命令创建Secret同名资源：

    \n
    kubectl create secret docker-registry <image-pull-secret> --docker-server=<"172.16.17.11:5002"> --docker-username=<admin> --docker-password=<adminpassword> -n <giscloudsuite>
    \n
    \n

    注意：

    \n

    输入的内容中，带有尖括号”<>“的需根据您的实际环境替换（替换后去掉尖括号）:\n<image-pull-secret>为您的Secret名称；\n<"172.16.17.11:5002">为您的镜像仓库地址；\n<admin>为镜像仓库用户名;\n<adminpassword>为镜像仓库密码；\n<giscloudsuite>为GIS云套件所在命名空间（在kube-system下创建Secret同名资源时，<giscloudsuite>替换为“kube-system”）。

    \n
    \n
    13. \n
  13. \n

    如何配置服务实例自动刷新？

    \n

    答：服务实例刷新是指在数据源发生变化时，同步更新服务实例。配置自动刷新后，每隔一段时间系统会自动更新服务实例。请按以下步骤在服务节点的编排中配置自动刷新：

    \n

    （1）查看服务实例所在服务节点（可在GIS云套件管理页面，点击服务管理->服务实例，进入服务实例详情页面，查看所在服务节点）；

    \n

    （2）登录Kubernetes管理页面，在您的GIS云套件命名空间中点击部署，找到服务节点对应的名称；

    \n

    （3）对服务节点进行编辑（打开右侧操作，点击查看/编辑 YAML）；

    \n

    （4）在spec->template->spec->containers->env中添加环境变量REFRESH_DATASOURCE与CHECK_DATASOURCE_CONNECTION_INTERVAL。REFRESH_DATASOURCE为开启自动刷新，CHECK_DATASOURCE_CONNECTION_INTERVAL为自动刷新间隔。例如，开启自动刷新并设置刷新间隔为1小时：

    \n
    {\n   \"name\": \"REFRESH_DATASOURCE\",\n   \"value\": \"true\"\n},\n{\n   \"name\": \"CHECK_DATASOURCE_CONNECTION_INTERVAL\",\n   \"value\": \"3600\"\n},
    \n

    （5）点击更新，等待重新部署后生效。

    \n
    14. \n
  14. \n

    阿里云Kubernete集群无法通过本地连接GIS云套件内置HBase，如何解决？

    \n

    答：请参考以下步骤解决。

    \n

    （1）确认阿里云Kubernetes集群EIP绑定的Work节点，通过以下命令确认Work节点在Kubernetes集群中的名称：

    \n
    kubectl get nodes
    \n

    （2）更新服务，执行以下命令：

    \n
    kubectl -n <namespace> patch deployment/nginx-ingress-controller -p "\napiVersion: apps/v1\nkind: Deployment\nmetadata:\n  name: nginx-ingress-controller\nspec:\n  template:\n    spec:\n      nodeName: <nodeName>\n"
    \n

    （3）等待服务启动。

    \n
    \n

    注意：
    \n请将步骤（2）中的<namespace>和<nodeName>替换为您环境中的实际值。

    \n
      \n
    1. <namespace>为部署iManager（GIS云套件）时指定的命名空间名称。iManager默认命名空间为supermap，GIS云套件默认命名空间为giscloudsuite。
      2. \n
    2. <nodeName>为EIP绑定的work节点在Kubernetes集群中的名称。
      3. \n
    \n
    \n
    15. \n
  15. \n

    内置HBase环境如何使用本地存储？

    \n

    答：经测试，挂载NFS会影响Hbase的读写性能，可以通过以下方式进行优化：

    \n

    （1）修改配置（values.yaml）文件中deploy_disable_hbase_nfs_volume的值为true

    \n
    deploy_disable_hbase_nfs_volume: true
    \n

    （2）根据编排创建PV：参考 hbase-datanode-local-volume.yaml 文件，根据实际情况进行修改：

    \n
    apiVersion: v1\nkind: PersistentVolume\nmetadata:\n  labels:\n    type: icloud-native\n  name: icloud-native-hbase-datanode-volume-0  #修改点1\nspec:\n  storageClassName: local-volume-storage-class\n  capacity:\n    storage: 10Ti\n  accessModes:\n    - ReadWriteMany\n  local:\n    path: /opt/imanager-data/datanode-data  #修改点2\n  persistentVolumeReclaimPolicy: Delete\n  nodeAffinity:\n    required:\n      nodeSelectorTerms:\n        - matchExpressions:\n          - key: kubernetes.io/hostname\n            operator: In\n            values:\n              - node1   # 修改点3
    \n

    需要修改的内容涉及上图中标记处的3个地方：

    \n\n

    （3）修改后通过编排创建PV（在Kubernetes master节点执行以下命令）:

    \n
    kubectl apply -f hbase-datanode-local-volume.yaml
    \n
    \n

    备注：

    \n
      \n
    1. HBase环境中的dataNode有几个副本就要创建几个PV,默认需要3个；如果自己伸缩了，请创建对应数目的PV；
      2. \n
    2. PV可以创建在任意Kubernetes节点上（通过修改点3指定），推荐均匀分布在不同的节点上；
      3. \n
    3. PV既可以在开启/伸缩HBase之前创建，也可以在开启/伸缩HBase之后创建。
      4. \n
    \n
    \n
    16. \n
","frontmatter":{"title":"GIS云套件","next":null,"prev":null},"fields":{"path":"content/microservices/FAQ.zh.md","slug":"/zh/microservices/FAQ/","langKey":"zh"}}},"pageContext":{"slug":"/zh/microservices/FAQ/"}}}