{"componentChunkName":"component---src-templates-tutorial-js","path":"/zh/tutorial/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）赋予数据库权限，执行：

    \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

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

    \n

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

    \n
    3. \n
  3. \n

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

    \n

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

    \n
    4. \n
  4. \n

    如何使用https协议？

    \n

    答：iManager中支持Keycloak与iManager使用https服务协议，请执行以下步骤：

    \n

    （1）进入iManager安装目录（即执行iManager启动命令的目录）并找到values.yml文件，在当前目录下输入命令打开配置：

    \n
    sudo vi values.yml
    \n

    （2）若Keycloak需使用https服务协议，将变量“deploy_keycloak_service_protocol”的值改为“https”;若iManager需使用https服务协议，将变量“deploy_imanager_service_protocol”的值改为“https”（iManager使用https协议时，Keycloak必须为https协议）。

    \n

    （3）保存设置，并重启iManager:

    \n
    sudo ./startup.sh
    \n
    5. \n
  5. \n

    如何替换iManager for K8s自带的安全证书？

    \n

    答：iManager for K8s的安全证书有两种，一种是安全中心（Keycloak）使用的安全证书，另一种是访问入口域名使用的安全证书。请参照以下步骤替换两种证书：

    \n

    替换安全中心（Keycloak）的安全证书

    \n

    （1）在安装Kubernetes Master节点机器中执行以下命令，找到安全证书挂载目录（下面命令中的<namespace>为iManager所在的命名空间，默认为supermap。如有改动，请替换为您的命名空间名称）：

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

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

    \n
    \n

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

    \n
    \n

    （3）登录iManager，在基础服务中找到Keycloak服务并重新部署。

    \n

    替换访问入口的安全证书

    \n

    （1）在安装Kubernetes Master节点机器中执行以下命令，找到安全证书挂载目录（下面命令中的<namespace>为iManager所在的命令空间，默认为supermap。如有改动，请替换为您的命名空间名称）：

    \n
    kubectl -n <namespace> describe pvc pvc-imanager-dashboard-ui | grep Volume: | awk -F ' ' '{print $2}' | xargs kubectl describe pv
    \n

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

    \n
    \n

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

    \n
    \n

    （3）登录iManager，在基础服务中找到imanager-dashboard-ui服务并重新部署。

    \n
    6. \n
  6. \n

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

    \n

    答：配置镜像拉取Secret时，需在Kubernetes中iManager所在命名空间创建与Secret同名的资源。如果开启服务网格（Istio），需在istio-system命名空间下创建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 <supermap>
    \n
    \n

    注意：

    \n
      \n
    1. 输入的内容中，带有尖括号”<>“的需根据您的实际环境替换（替换后去掉尖括号）。\n<image-pull-secret>为您的Secret名称；\n<"172.16.17.11:5002">为您的镜像仓库地址；\n<admin>为镜像仓库用户名;\n<adminpassword>为镜像仓库密码；\n<supermap>为iManager所在命名空间（在istio-system或kube-system下创建Secret同名资源时，<supermap>替换为“istio-system”或“kube-system”）。
      2. \n
    2. 如果命名空间istio-system不存在，在Kubernetes Master节点机器输入“kubectl create ns istio-system”命令进行创建。
      3. \n
    \n
    \n
    7. \n
  7. \n

    修改iManager的配置文件values.yaml后，重启iManager出现报错“Error: UPGRADE FAILED: cannot patch “pv-nfs-grafana” with kind StorageClass: StorageClass.storage.k8s.io “pv-nfs-grafana” is invalid …”， 怎么办？

    \n

    答：该错误产生的原因是K8s patch操作不支持对存储类的提供者进行更新。此报错不影响产品正常使用，可忽略。

    \n
    8. \n
  8. \n

    Kubernetes证书到期了，如何更新？

    \n

    答：Kubernetes证书有效期为1年，过期后需更新证书。请参照以下步骤更新Kubernetes证书：

    \n

    （1）在安装Kubernetes的Master节点机器，进入etc目录，备份Kubernetes原始文件：

    \n
    cd /etc\ncp -r kubernetes kubernetes.bak
    \n

    （2）新建配置文件kubeadm.yaml:

    \n
    vi kubeadm.yaml
    \n

    （3）配置kubeadm.yaml（下面命令中的“10.10.129.29”为Kubernetes Master节点IP，请根据您的实际环境替换）：

    \n
    kind: MasterConfiguration\napiVersion: kubeadm.k8s.io/v1beta1\nkubernetesVersion: v1.14.0\napi:\n advertiseAddress: 10.10.129.29
    \n

    （4）使用配置文件重新签发证书：

    \n
    kubeadm init phase certs all --config=kubeadm.yaml
    \n

    （5）重新生成配置文件：

    \n
    kubeadm init phase kubeconfig all --config kubeadm.yaml
    \n

    （6）重启kube-apiserver、kube-controller-manager、kube-scheduler、etcd四个容器，使证书生效：

    \n
    docker ps |grep -E 'k8s_kube-apiserver|k8s_kube-controller-manager|k8s_kube-scheduler|k8s_etcd_etcd' | awk -F ' ' '{print $1}' |xargs docker restart
    \n

    （7）查看证书是否生效：

    \n
    openssl x509 -in /etc/kubernetes/pki/apiserver.crt -noout -text |grep ' Not '
    \n

    （8）查看Work节点的工作状态（使用kubectl get nodes命令），如果Work节点的状态为‘NotReady’，执行以下命令重新生成Work节点的配置文件：

    \n
    mv /var/lib/kubelet/pki /var/lib/kubelet/pki.bak\nsystemctl daemon-reload && systemctl restart kubelet
    \n

    （9）再次查看Work节点的工作状态，如果Work节点的状态仍然为‘NotReady’，把Master节点的/etc/kubernetes/pki/ca.crt文件复制到相应Work节点的相同目录下，并再次重启kubelet（使用systemctl restart kubelet命令重启kubelet，重启后需等待三分钟）。

    \n
    9. \n
  9. \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

    使用以下命令在对应节点上创建目录(路径换成自己设置的具体地址)：

    \n
    mkdir -p /opt/imanager-data/datanode-data
    \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
    10. \n
  10. \n

    系统运行过程中出现系统没有响应，检查系统日志后发现错误“echo 0 > /proc/sys/kernel/hungtasktimeout_secs” disables this message.”，如何解决？

    \n

    答: 这是因为在系统运行过程中负载飙升，文件系统脏数据缓存无法在指定时间内写入磁盘，导致系统挂起。这种情况一般在内存较大时出现，解决办法如下：

    \n

    （1）编辑 /etc/sysctl.conf 文件。设置脏数据处理时间以及写入超时时间：

    \n
    # 脏数据到达系统百分比开始处理\nvm.dirty_background_ratio=5\n# 脏数据到达系统百分比时，不得不处理\nvm.dirty_ratio=10\n# 脏数据写入超时时间，默认 120s，0 表示不限制\nkernel.hung_task_timeout_secs=0
    \n

    （2）强制重启。系统挂起情况下，重启机器可能失败，因此需要强制重启：

    \n
    reboot -n -f
    \n
    11. \n
  11. \n

    在Kubernetes服务器集群中，某台服务器出现故障，导致该服务器上的服务不可用，如何应对？

    \n

    答：如果您的Kubernetes集群由三台或三台以上的服务器组成（含Master节点服务器），当某Worker节点服务器出现故障时，在该服务器中运行的服务会自动迁移至其他Worker节点服务器，自动迁移时长根据您的环境有所不同，大概在20分钟左右。如果您的Kubernetes集群只有两台服务器，当Worker节点服务器出现故障后，请参考以下步骤手动恢复服务：

    \n

    （1）在Master节点服务器中，查看服务器名称：

    \n
    kubectl get nodes
    \n

    （2）修改Master节点服务器名称。使用如下命令修改：

    \n
    hostnamectl set-hostname <newhostname>
    \n
    \n

    备注：
    \n命令中的<newhostname>为您的Master节点服务器新名称，可自定义。

    \n
    \n

    （3）进入/etc/kubernetes/manifests目录：

    \n
    cd /etc/kubernetes/manifests
    \n

    （4）编辑etcd.yaml文件，将文件中包含Master节点服务器旧名称的内容改为新设定的名称（共有两处，如下图）。执行以下命名进入文件编辑页面：

    \n
    vi etcd.yaml
    \n

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

    \n

    （7）修改kube-system命名空间下的kubeadm-config ConfigMap，将其中的Master节点服务器的旧名称改为新名称（有一处需要更改，如下图）：

    \n
    kubectl -n kube-system edit configmap kubeadm-config
    \n

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

    \n

    （8）为服务器生成新证书，替换旧证书。执行如下操作：

    \n
    cd /etc/kubernetes/pki/\nmkdir -p ~/tmp/BACKUP_etc_kubernetes_pki/etcd/\nmv apiserver.crt apiserver-etcd-client.key apiserver-kubelet-client.crt front-proxy-ca.crt front-proxy-client.crt front-proxy-client.key front-proxy-ca.key apiserver-kubelet-client.key apiserver.key apiserver-etcd-client.crt ~/tmp/BACKUP_etc_kubernetes_pki/.\nmv etcd/healthcheck-client.* etcd/peer.* etcd/server.* ~/tmp/BACKUP_etc_kubernetes_pki/etcd/\nkubeadm init phase certs all\n\ncd /etc/kubernetes\nmkdir -p ~/tmp/BACKUP_etc_kubernetes\nmv admin.conf controller-manager.conf kubelet.conf scheduler.conf ~/tmp/BACKUP_etc_kubernetes/.\nkubeadm init phase kubeconfig all\n\nmkdir -p ~/tmp/BACKUP_home_.kube\ncp -r ~/.kube/* ~/tmp/BACKUP_home_.kube/.\ncp -i /etc/kubernetes/admin.conf $HOME/.kube/config
    \n

    （9）应用步骤（6）中修改过的Worker节点服务器配置文件：

    \n
    kubectl apply -f node.yaml
    \n

    （10）移除原Worker节点服务器：

    \n
    kubectl delete node <old-nodeName>
    \n

    （11）重启kubelet和docker服务：

    \n
    systemctl daemon-reload && systemctl restart kubelet && systemctl restart doker
    \n
    12. \n
","frontmatter":{"title":"教程","next":null,"prev":null},"fields":{"path":"content/tutorial/FAQ.zh.md","slug":"/zh/tutorial/FAQ/","langKey":"zh"}}},"pageContext":{"slug":"/zh/tutorial/FAQ/"}}}